Xfce 4 Session Manager

Benedikt Meurer

Software developer
os-cillation
System development


This manual describes the xfce4-session package, version 4.8.3.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. The complete license text is available from the Free Software Foundation.

July 2005


Πίνακας Περιεχομένων

Introduction
Session Manager settings
General preferences
Advanced preferences
Customizing the Session Manager
Splash screen settings
Shutdown/reboot options
Advanced
Files and Environment Variables
Kiosk Mode
About xfce4-session

Introduction

xfce4-session is a session manager for Xfce 4. Its task is to save the state of your desktop (opened applications and their location) and restore it during a next startup. You can create several different sessions and choose one of them on startup.

xfce4-session provides session management for both X11R6 and legacy X11R5 protocols. If you don't need legacy session management support, you can disable it at compile time, giving --disable-legacy-sm to ./configure. Do NOT EVER run smproxy in session that is managed by xfce4-session, or weird things will happen. The included legacy session management does everything that smproxy would do, and besides that, it also supports multiscreen display.

Session Manager settings

General preferences

Σχήμα 1. xfce4-session general preferences

Shows the General tab of the xfce4-session settings dialog.

Display chooser on login

If set, the session manager will ask you to choose a session every time you log in to Xfce.

Automatically save session on logout

This option instructs the session manager to save the current session automatically when you log out. If you don't select this option you'll be prompted whether you want to save the current session on each logout.

Prompt on logout

This option disables the logout confirmation dialog. Whether the session will be saved or not depends on whether you enabled the automatic saving of sessions on logout or not.

Advanced preferences

Σχήμα 2. xfce4-session advanced preferences

Shows Advanced tab of the xfce4-session settings dialog.

Launch Gnome services on startup

Enable this option if you need the GNOME keyring daemon to be run on startup. This option also instructs xfce4-session to bring up the GNOME assistive technologies at startup (if enabled in the GNOME control center). See the GNOME documentation for more information on this topic.

Launch KDE services on startup

Enable this option if you plan to run KDE applications as part of your Xfce Desktop session. This will notably increase the startup time, but on the other hand, KDE applications will startup faster. Some KDE applications may not work at all if you don't enable this option.

Manage remote applications

Allow the session manager to manage applications running on remote hosts. Since this option may constitute a security risk, by listening to a TCP port on your system, do not enable it unless you know what you are doing.

System administrators may want to disable this option globally using the session managers KIOSK capabilities.

Customizing the Session Manager

You can customize the splash-screen that xfce4-session will use when you log in to Xfce 4. There is a dedicated dialog available from the Xfce 4 Settings Manager.

Splash screen settings

Σχήμα 3. Splash screen settings dialog

Shows the xfce4-session splash screen settings dialog.

On the left, the dialog shows a list of all installed engines. Select an engine, and you will see, if available, a preview and information about it. You can click on the Test button to see a demonstration of the selected splash screen engine.

xfce4-session provides three Splash themes engines by default. Their respective configuration options - if any - are available from the Configure button.

Shutdown/reboot options

xfce4-session supports shutting down your computer when you log out of your desktop session. To be able to shutdown the computer, you have to be listed in the systems sudoers file, in particular, you must be allowed to execute the command ${libdir}/xfce4/session/xfsm-shutdown-helper (/usr/sbin/xfsm-shutdown-helper on Debian GNU/Linux) as user root (where ${libdir} is the lib sub directory in the prefix you installed xfce4-session, for example /usr/local/lib/xfce4/session).

For example, lets say, you installed xfce4-session into /usr/local, your hostname is myhost and your user account is named myuser, then you would have to add the following line to your sudoers file (remember to use visudo to edit that file):

myuser myhost=/usr/local/lib/xfce4/session/xfsm-shutdown-helper

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 st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specification st.html" target="_top">Desktop Entry Specificat