community.general.xfconf_info module – Retrieve XFCE4 configurations

Note

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

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.

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)