New in version 2.3.
| parameter | required | default | choices | comments |
|---|---|---|---|---|
| config_source | no | Specify a configuration source to use rather than the default path. See man gconftool-2(1) | ||
| direct | no |
| Access the config database directly, bypassing server. If direct is specified then the config_source must be specified as well. See man gconftool-2(1) | |
| key | yes | A GConf preference key is an element in the GConf repository that corresponds to an application preference. See man gconftool-2(1) | ||
| state | yes |
| The action to take upon the key/value. | |
| value | no | Preference keys typically have simple values such as strings, integers, or lists of strings and integers. This is ignored if the state is "get". See man gconftool-2(1) | ||
| value_type | no |
| The type of value being set. This is ignored if the state is "get". |
- name: Change the widget font to "Serif 12"
gconftool2:
key: "/desktop/gnome/interface/font_name"
value_type: "string"
value: "Serif 12"
Common return values are documented here Return Values, the following are the fields unique to this module:
| name | description | returned | type | sample |
|---|---|---|---|---|
| value_type | The type of the value that was changed | success | string | string |
| key | The key specified in the module parameters | success | string | /desktop/gnome/interface/font_name |
| value | The value of the preference key after executing the module | success | string | Serif 12 |
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.
© 2012–2017 Michael DeHaan
© 2017 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/gconftool2_module.html