XSESSION.CONF(5)

NAME
Xsession.conf -configuration file for Xsession.

DESCRIPTION
Xsession.conf is the (default) configuration file for the XDM script Xsession. On system with multiple X servers, there might be a configuration file per X server. The Xsession configuration file dedicated to an X server must be named Xsession.<XDISP>.conf and stored in same directory as script Xsession. <XDISP> is the X server display name, without field screennumber, and to XDM resource name format, that is, with underscores in place of dots and colons. For instance the value of XDISP for the X server display name :0 is _0. It is _1 in case of X server display name :0, and so on. When there is no configuration file dedicated to a given X server, Xsession loads the default configuration file : Xsession.conf. The default configuration file Xsession.conf can be used as a base configuration inside the configuration file dedicated to a given X server, like in example below :
  ---- Xsession._0.conf -----
  # Loads defaults
  #
  source ${SCRIPTDIR}/Xsession.conf

  # Disable sourcing of all profile scripts.
  #
  SOURCE_SYS_PROFILE=off
  SOURCE_USR_PROFILE=off

  SOURCE_SYS_XPROFILE=off
  SOURCE_USR_XPROFILE=off
  -------------------------
Below the variables defined in script Xsession that can be useful in Xsession configuration file :
    SCRIPTDIR - Absolute path to Xsession's directory XDISP - The X server display name, without field 'screennumber', and to XDM resource name format.

PROPERTIES

DISABLE_LOG = <on|yes|true|1|off|no|false|0>
    Defines whether or not logging of Xsession activity must be disabled. Default to off. Activity is logged in ~/xdm-xsession.${XDISP}.log

USR_XSESSION = <path>
    Full path to the user's X session. Default to ${HOME}/.xsession.

SYS_XSESSION = <path>
    Full path to the system's X session. Default to /etc/X11/xinit/xinitrc.

XINITRC_FILES_DIR = <path>
    The location of xinitrc.* session files. Default to /etc/X11/xinit.

SYS_XRESOURCES = <path>
    Full path to the system's X resources. Default to /etc/X11/xinit/.Xresources.

USR_XRESOURCES = <path>
    Full path to the user's X resources. Default to ${HOME}/.Xresources.

SYS_XMODMAP = <path>
    Full path to the system's X modmap. Default to /etc/X11/xinit/.Xmodmap.

USR_XMODMAP = <path>
    Full path to the user's X modmap. Default to ${HOME}/.Xmodmap.

LOAD_XRESOURCES_ON = (<session-name> ...)
    The name of the sessions for which Xsession must load the X resources (specified by SYS_XRESOURCES and USR_XRESOURCES) when available. Default to ( "failsafe" ) Most of the xinitrc scripts usually load the X resources automatically. Thus, this variable should only be used for those who don't. failsafe is a pseudo-session for which there is no xinitrc script.

LOAD_XMODMAP_ON = (<session-name> ...)
    The name of the sessions for which Xsession must load the X modmap (specified by SYS_XMODMAP and USR_XMODMAP) when available. Default to ( "failsafe" ) Most of the xinitrc scripts usually load the X modmap automatically. Thus, this variable should only be used for those who don't. failsafe is a pseudo-session for which there is no xinitrc script.

XSESSION_ERRFILE = ( <path> ... )

Defines the files in which (session) errors can be redirected. Errors are only redirected to one of the specified files, the 1st that met the following condition :
 umask 077 && cp /dev/null XSESSION_ERRFILE[i] 2>/dev/null
Errors are not redirected when this variable is not set, nor when the condition above is not met by any of the specified files. Default to :
  ( ${HOME}/.xsession-errors.${XDISP} \
    ${TMPDIR-/tmp}/xses-${USER}.${XDISP} \
    /tmp/xses-${USER}.${XDISP} )

SOURCE_SYS_PROFILE = <on|yes|true|1|off|no|false|0>
    Defines whether or not the system profile script /etc/profile must be "sourced" by Xsession, when present. Default to on.

SOURCE_USR_PROFILE = <on|yes|true|1|off|no|false|0>
    Defines whether or not the user profile script ~/.profile must be "sourced" by Xsession, when present. Default to on.

SOURCE_SYS_XPROFILE = <on|yes|true|1|off|no|false|0>
    Defines whether or not the system x-profile script /etc/xprofile must be "sourced" by Xsession, when present. Default to on.

SOURCE_USR_XPROFILE = <on|yes|true|1|off|no|false|0>
    Defines whether or not the user x-profile script ~/.xprofile must be "sourced" by Xsession, when present. Default to on.

FAILSAFE_TERM = <path>
    Defines the terminal emulator to execute when running failsafe mode. Default to /usr/bin/uxterm. The failsafe mode is ran when all possible sessions (ie. session passed in argument (if any), session selected from the buttons-bar sessions menu (if any), user's session, system's default session) failed to start.

FAILSAFE_TERM_GEOMETRY = <geometry>
    Defines the geometry of the terminal emulator specified by variable FAILSAFE_TERM. Default to 80x24+0+0. When this variable is not set, no geometry is passed to the terminal emulator.

SEE ALSO
Xsetup.conf(5), Xbuttons_bar.conf(5)

AUTHORS
Sébastien Ballet <slacker6896@gmail.com>