XSESSION                             SysV                             XSESSION



NAME
     xsession - start Xdm Session

SYNOPSIS
     /usr/X11/bin/xsession [-lo]

DESCRIPTION
     xsession is a korn-shell script file used to start the Xdomain server and
     initial X client programs from the Apollo Display Manager (DM).  This
     script is intended to be run from within a DM session or as part of a DM
     login sequence when no X server is running.  It will start the Xdomain
     server and execute /usr/X11/lib/xdm/Xsession (which will start HP VUE 1.1
     if installed).

     When X starts, the DM shell in which you issued the xsession command will
     be converted into an iconized "X" window.  This is the dmtox client.  The
     DM window will then disappear, leaving an X-shaped cursor on a plain
     background.  Then whatever X clients are started from
     /usr/X11/lib/xdm/Xsession will appear.  The default is for the mwm window
     manager and an xterm to start, but this can be modified by the presense
     of a ~/.Xsession file in your home directory, or by the installation of
     HP VUE 1.1 .

OPTIONS
     -lo  You can specify -lo
           to have xsession log you out of the DM when you terminate your X
          session.  Otherwise, xsession will kill the dmtox running in the
          background and return the shell into which you issued the xsession
          command to its starting position.

MODIFICATIONS
     At the beginning of xsession is a description of the font path used by
     Xdomain. The default behavior is not to specify a font path, so that
     Xdomain use its default path.  However, you may wish to switch to another
     font path.  To facilitate this, the xsession file contains the lines:

          # Configuration to use if minimal
          XFONTS='-fp /usr/X11/lib/fonts/misc/,/usr/X11/lib/fonts/75dpi/'

          # Needed if dmx is installed
          #XFONTS='-fp /usr/X11/lib/fonts/misc/,/usr/X11/lib/fonts/75dpi/,
          /usr/dmx/lib/fonts'

     Uncomment one of these to change the font path, or add a new path of your
     own.

     It is also possible to modify the

          XDISPLAY=:0

     line at the beginning of xsession, to cause xinit to use some other
     display.  For example, if you set XDISPLAY=' ' then xinit will set the
     display to hostname:0.0, where hostname is the name returned by
     gethostname(2).

USE IN A LOGIN SCRIPT
     To start xsession (and therefore the Xdomain server and xdm/Xsession)
     automatically when you log into the DM, place one of the following two
     lines:

          cp -n xsession /bin/ksh /usr/X11/bin/xsession

          cp -n xsession /bin/ksh /usr/X11/bin/xsession -lo

     into an appropriate place in your DM startup files, such as
          ~/user_data/startup_dm.xxx.

     To execute only on your node, consider instead using the following
     command (which must be on a single line, not broken as here):

          cp -n xsession /bin/ksh -c 'if [ $(/etc/hostname) = <NODE_NAME> ];
              then exec /usr/X11/bin/xsession; fi'; wc -a;


CONSTRAINTS
     Do not run this script when either Xapollo or Xdomain is already running.
     Run only one X server at a time.  Two X servers running at the same time
     conflict over resources, with unpredictable results.

GENERAL BACKGROUND
     You cannot start both the DM and Xdomain at boot time.  If you start the
     DM at boot time, you can subsequently start Xdomain at login or run time,
     but if you start Xdomain at boot time, you cannot subsequently start the
     DM.  The xsession script, and the companion hpvue2 script for HPVUE2.01,
     are provided to make it as easy as possible to start your Xdomain
     environment from the DM.

SEE ALSO
     X(1), Xdomain(1), Xserver(1), xinit(1), x11start(1), hpvue2(1)