Xfce Wiki

Sub domains
 

xfconf - Configuration Storage System

Introduction

Xfconf is a hierarchical (tree-like) configuration system where the immediate child nodes of the root are called “channels”. All settings beneath the channel nodes are called “properties.”

Valid channel and property names are composed of the ASCII US-English uppercase characters A-Z, lowercase characters a-z, numerals 0-9, the dash (-), and underscore (_). No other characters are allowed for channel names. The less than (<) and greater than (>) characters (aka “angle brackets”) are also allowed in property names, but not in channel names.

Property names are referenced by their “full path” underneath their channel, for example: “/main/history-window/last-accessed”. Of course, when querying a particular property, the channel must be specified separately as well.

Both channel and property names are case-insensitive. For example, the following four all refer to the same property:

  • Channel: ExampleApp, property: /main/history-window/last-accessed
  • Channel: EXAMPLEAPP, property: /main/history-window/last-accessed
  • Channel: ExampleApp, property: /Main/History-Window/Last-Accessed
  • Channel: exampleapp, property: /MAIN/history-window/last-accessed

Back to Top


Accessing Configuration Data

Settings stored in Xfconf can be accessed in numerous ways:

  • From within applications of Settings Manager. Most of the time, settings stored in Xfconf and configuration options presented in the GUI are tightly coupled. It means that any action of the GUI settings is automatically and immediately propagated to the configuration system and vice-versa. See also: Settings Daemon.
  • From Command Line Interface (CLI) using xfconf-query.
  • From GUI. Settings, which are not exposed in configuration dialogs, can be browsed and manipulated using Settings Editor.
  • If everything else fails, settings can be edited manually. Xfconf stores all its data in XML files, which can be edited when Xfconf is not running. Be very careful when using this option, as it is easy to make the file unparseable or inconsistent.

Back to Top


Kiosk Mode

System administrators can lock certain values or entire channels to prevent users from changing them. In this case, the administrator may provide default values that will be used regardless of what may appear in a user-writable configuration file. If the sysadmin does not wish to provide values, but only wants to lock a channel/property, the application's default fallback value will be used instead.

Locking a channel or property is as simple as creating a configuration file and setting either (and only either) the “locked” or “unlocked” attribute on <channel> or <property> elements that should be restricted. This configuration file should be placed in a system location that is read by the daemon (see “File locations” above).

Both the “locked” and “unlocked” attributes take a semicolon-separated list of system user and group names. User names should be entered as-is, and group names should be entered with an “@” symbol prepended to the group name.

The “locked” attribute specifies users and groups who may not modify the property. The “unlocked” attribute specifies users and groups who may modify the property, with other users locked out. Only one of the two attributes may be specified for a particular channel or property. If both are present, the “unlocked” attribute is used, and the “locked” attribute is ignored.

Note that <channel> locking locks all properties under that channel, but <property> locking locks only the property with the “locked” or “unlocked” attribute; none of the sub-properties are locked unless they also contain a “locked” or “unlocked” attribute.

See Xfce-Session Kiosk Mode for specific parameter used in configuring kiosk mode.

Back to Top


Latest Release

  • xfconf 4.19.0 released (2023/04/17 12:57)
    xfconf 4.19.0 is now available for download from
    
      https://archive.xfce.org/src/xfce/xfconf/4.19/xfconf-4.19.0.tar.bz2
      https://archive.xfce.org/src/xfce/xfconf/4.19/xfconf-4.19.0.tar.bz2?sha1
      https://archive.xfce.org/src/xfce/xfconf/4.19/xfconf-4.19.0.tar.bz2?sha256
    
    
    What is xfconf?
    ===============
    
    Xfconf is a flexible, easy-to-use configuration management system.
    
    Website:
      https://docs.xfce.org/xfce/xfconf/start
    
    
    Release notes for 4.19.0
    ========================
    [Please note that this is a development release.]
    
    - Update copyright year
    - build: Use m4_defined min versions and cleanup
    - build: Use XDT_CHECK_PACKAGE_BINARY
    - build: Use XDT_VERSION_INIT and get rid of configure.ac.in
    - build: Switch from intltool to gettext
    - xfconfd: Lower warning level
    - docs: Fix xfconf_channel_get() transfer annotation
    - Update bug report address
    - docs: Fix unused declarations warning
    - docs: Properly enable GI docs
    - xfconfd: Fix check for "/" when building property name
    - xfconfd: Make xml backend case sensitive for channel names
    - Translation Updates:
      Albanian, Armenian (Armenia), Basque, Belarusian, Bulgarian, Catalan,
      Chinese (China), Chinese (Hong Kong), Chinese (Taiwan), Croatian,
      Czech, Danish, Dutch, Eastern Armenian, English (Australia), English
      (Canada), English (United Kingdom), Finnish, French, Galician,
      German, Greek, Hebrew, Hindi, Hungarian, Icelandic, Indonesian,
      Italian, Japanese, Kazakh, Korean, Lithuanian, Malay, Norwegian
      Bokmål, Occitan (post 1500), Polish, Portuguese, Portuguese
      (Brazil), Romanian, Russian, Serbian, Slovak, Slovenian, Spanish,
      Swedish, Thai, Turkish, Ukrainian

Previous Releases

Back to Top


Source Code Repository

Reporting Bugs