Documentation

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
  • yes
  • 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
  • get
  • present
  • absent
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
  • int
  • bool
  • float
  • string
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
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


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.