Xfce Wiki

Sub domains
 

This is an old revision of the document!


Advanced

Files and Environment Variables

Xfce now uses the Basedir Specification as defined on Freedesktop.org to locate its data and configuration files. This means that file locations will be specified as a path relative to the directories described in the specification.

${XDG_CONFIG_HOME}
The first base directory to look for configuration files. By default this is set to ~/.config/.
${XDG_CONFIG_DIRS}
A list of system directories that contain configuration data. By default the panel will look in ${sysconfdir}/xdg/ and /etc/xdg/. The value of ${sysconfdir} depends on how the program was build and will often be /etc/ for binary packages.
${XDG_CACHE_HOME}
Specifies the root for all user-specific cache data. If this environment variable is unset, it defaults to ~/.cache.
${XDG_CONFIG_DIRS}/autostart/
This is the location where the list of applications that should be automatically run on login is stored. Each autostarted application is represented by a .desktop file (see the Desktop Entry Specification for details).
Prior to Xfce 4.3, the list of autostarted applications was stored in ~/Desktop/Autostart, which contained scripts and symbolic links to applications. If you run xfce4-session 4.8.2 or above for the first time, it will automatically migrate the autostart items from the old location to the standard location and place a LOCATION-CHANGED.txt file in the old directory, that describes the location change.
${XDG_CONFIG_DIRS}/xfce4-session/xfce4-session.rc
This is the location of the configuration file that includes the various settings for xfce4-session, which can be changed from the settings dialog.
${XDG_CONFIG_DIRS}/xfce4-session/xfce4-splash.rc
This is the location of the configuration file that includes the configuration for the splash screen, which can be changed from the settings dialog.
${XDG_CACHE_HOME}/sessions/
The directory where xfce4-session and xfwm4 store the session data to.
${sysconfdir}/xdg/xfce4/kiosk/kioskrc
Kiosk mode configuration file. See next section for an explanation.

Kiosk Mode

The session manager offers support for the Kiosk Mode, that helps to prevent users from making changes to their session settings. To use it you have to edit or create the file ${sysconfdir}/xdg/xfce4/kiosk/kioskrc.

The way to explain the format of this file is by using an example. The xfce4-session section of your kioskrc might look like this:

[xfce4-session]
CustomizeSplash=ALL
CustomizeChooser=ALL
CustomizeLogout=ALL
CustomizeCompatibility=%wheel
Shutdown=%wheel
CustomizeSecurity=NONE

This allows all users to change their splash, chooser and logout settings, but allows only users in the group wheel to customize the compatibility settings and shutdown the system. No one will be allowed to adjust the security settings.

The session manager supports the following KIOSK capabilities:

CustomizeSplash
Whether or not the user is allowed to customize the splash screen.
CustomizeChooser
Whether or not the user is allowed to customize the session chooser settings.
CustomizeLogout
Whether or not the user is allowed to customize the logout settings.
CustomizeCompatibility
Whether or not the user is allowed to customize the compatibility settings (KDE/Gnome compat)
CustomizeSecurity
Whether or not the user is allowed to customize the security settings. This is one of the most IMPORTANT settings, since it prevents users (actually libICE) from binding to a TCP port.
Shutdown
Whether or not the user is allowed to shutdown (reboot or poweroff) the system. If a user lacks this capability the reboot and poweroff options in the shutdown dialog will be greyed out.