community.general.gconftool2 – Edit GNOME Configurations

Note

This plugin is part of the community.general collection (version 2.0.1).

To install it use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.gconftool2.

Synopsis
Parameters
Examples
Return Values

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.

Parameters

Parameter	Choices/Defaults	Comments
config_source string		Specify a configuration source to use rather than the default path. See man gconftool-2(1)
direct boolean	no ← yes	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 string / required		A GConf preference key is an element in the GConf repository that corresponds to an application preference. See man gconftool-2(1)
state string / required	absent get present	The action to take upon the key/value.
value string		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 string	bool float int string	The type of value being set. This is ignored if the state is "get".

Examples

- name: Change the widget font to "Serif 12"
  community.general.gconftool2:
    key: "/desktop/gnome/interface/font_name"
    value_type: "string"
    value: "Serif 12"

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Returned	Description
key string	success	The key specified in the module parameters Sample: /desktop/gnome/interface/font_name
value string	success	The value of the preference key after executing the module Sample: Serif 12
value_type string	success	The type of the value that was changed Sample: string

Authors

Kenneth D. Evensen (@kevensen)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/gconftool2_module.html