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
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