ansible.builtin.gconftool2 (v2.9.27) — module

Edit GNOME Configurations

| "added in version" 2.3 of ansible.builtin"

Authors: Kenneth D. Evensen (@kevensen)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.9.27

Description

This module allows for the manipulation of GNOME 2 Configuration via gconftool-2. Please see the gconftool-2(1) man pages for more details.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Change the widget font to "Serif 12"
  gconftool2:
    key: "/desktop/gnome/interface/font_name"
    value_type: "string"
    value: "Serif 12"

Inputs

    
key:
    description:
    - A GConf preference key is an element in the GConf repository that corresponds to
      an application preference. See man gconftool-2(1)
    required: true

state:
    choices:
    - absent
    - get
    - present
    description:
    - The action to take upon the key/value.
    required: true

value:
    description:
    - 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)

direct:
    default: 'no'
    description:
    - 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)
    type: bool

value_type:
    choices:
    - bool
    - float
    - int
    - string
    description:
    - The type of value being set. This is ignored if the state is "get".

config_source:
    description:
    - Specify a configuration source to use rather than the default path. See man gconftool-2(1)

Outputs

key:
  description: The key specified in the module parameters
  returned: success
  sample: /desktop/gnome/interface/font_name
  type: str
value:
  description: The value of the preference key after executing the module
  returned: success
  sample: Serif 12
  type: str
value_type:
  description: The type of the value that was changed
  returned: success
  sample: string
  type: str