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.
This module is community maintained without core committer oversight.
For more information on what this means please read Module Support
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.