community.general.xfconf_info module – Retrieve XFCE4 configurations

Note

This module is part of the community.general collection (version 8.6.8).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

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

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

New in community.general 3.5.0

Synopsis

  • This module allows retrieving Xfce 4 configurations with the help of xfconf-query.

Aliases: system.xfconf_info

Parameters

Parameter

Comments

channel

string

A Xfconf preference channel is a top-level tree key, inside of the Xfconf repository that corresponds to the location for which all application properties/keys are stored.

If not provided, the module will list all available channels.

property

string

A Xfce preference key is an element in the Xfconf repository that corresponds to an application preference.

If provided, then channel is required.

If not provided and a channel is provided, then the module will list all available properties in that channel.

Attributes

Attribute

Support

Description

check_mode

Support: full

added in community.general 3.3.0

This action does not modify state.

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: N/A

This action does not modify state.

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Notes

Note

  • See man xfconf-query(1) for more details.

Examples

- name: Get list of all available channels
  community.general.xfconf_info: {}
  register: result

- name: Get list of all properties in a specific channel
  community.general.xfconf_info:
    channel: xsettings
  register: result

- name: Retrieve the DPI value
  community.general.xfconf_info:
    channel: xsettings
    property: /Xft/DPI
  register: result

- name: Get workspace names (4)
  community.general.xfconf_info:
    channel: xfwm4
    property: /general/workspace_names
  register: result

Return Values

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

Key

Description

channels

list / elements=string

List of available channels.

Returned when the module receives no parameter at all.

Returned: success

Sample: ["xfce4-desktop", "displays", "xsettings", "xfwm4"]

is_array

boolean

Flag indicating whether the property is an array or not.

Returned: success

properties

list / elements=string

List of available properties for a specific channel.

Returned by passing only the channel parameter to the module.

Returned: success

Sample: ["/Gdk/WindowScalingFactor", "/Gtk/ButtonImages", "/Gtk/CursorThemeSize", "/Gtk/DecorationLayout", "/Gtk/FontName", "/Gtk/MenuImages", "/Gtk/MonospaceFontName", "/Net/DoubleClickTime", "/Net/IconThemeName", "/Net/ThemeName", "/Xft/Antialias", "/Xft/Hinting", "/Xft/HintStyle", "/Xft/RGBA"]

value

string

The value of the property. Empty if the property is of array type.

Returned: success

Sample: "Monospace 10"

value_array

list / elements=string

The array value of the property. Empty if the property is not of array type.

Returned: success

Sample: ["Main", "Work", "Tmp"]

Authors

  • Alexei Znamensky (@russoz)