gconftool2 - Edit GNOME Configurations
New in version 2.3.
Synopsis
- This module allows for the manipulation of GNOME 2 Configuration via gconftool-2. Please see the gconftool-2(1) man pages for more details.
Options
| 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".
|
Examples
- name: Change the widget font to "Serif 12"
gconftool2:
key: "/desktop/gnome/interface/font_name"
value_type: "string"
value: "Serif 12"
Return Values
Common return values are documented here Return Values, the following are the fields unique to this module:
| name | description | returned | type | sample |
|---|---|---|---|---|
| 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 |
| value_type |
The type of the value that was changed
|
success | string | string |
Status
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–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/gconftool2_module.html