X11START(1) General Commands Manual X11START(1)
NAME
x11start - start the X11 window system
SYNOPSIS
x11start [options]
DESCRIPTION
NOTE: Beginning with the next release of HP-UX, x11start and its components (xinit, sys.x11start, and sys.Xdefaults) will not be supported.
vuelogin (an enhanced version of xdm) will perform all start-up tasks, regardless of whether or not HP-VUE is in use. See the HP Visual
Environment User's Guide and the vuelogin man page for information on vuelogin.
x11start is a shell script that provides a standarized method for starting up the X Window System server and selected X clients when the
Visual User Environment (HP-VUE) is not used. Specifically, it performs the following start-up tasks:
o PATH environment variable set-up appropriate for the X environment
o X server start-up
o selected client(s) start-up from a specific client file
o general user resource loading from a specific resource file
Components
x11start encompasses the following components:
o the /usr/contrib/bin/X11/x11start script
o the /usr/contrib/bin/X11/xinit program
o the default client script, /usr/contrib/lib/X11/sys.x11start
o the default resouce file, /usr/contrib/lib/X11/sys.Xdefaults
The x11start script
o creates a command to load resources from the appropriate resource file using xrdb (see xrdb(1)) (This command is not executed immedi-
ately but rather is assigned to the (exported) environment variable, doxrdb which is normally executed via the client script after the
server has been started up.)
o inserts /usr/bin/X11 ahead of /usr/bin in the PATH environment variable and appends /usr/vue/bin and /usr/contrib/bin/X11 to the end
o execs xinit as follows (see xinit(1)):
xinit clientscript options
where
clientscript
is $HOME/.x11start or /usr/contrib/lib/X11/sys.x11start
options are the xinit options exactly as specified on the x11start command line (see Options below).
The xinit program
o starts the server with the server arguments specified in options
o runs the client script, passing it the client arguments specified in options
o waits for either the server or client script to terminate and then terminates whatever remains running
The default client script, /usr/contrib/lib/X11/sys.x11start
o executes the environment variable, $doxrdb which was setup previously by x11start to load the appropriate resource file to the server
o runs both mwm and hpterm with all client arguments specified in options
o sleeps indefinitely so that the X Window System will not be shut down by xinit when all client script processes have terminated.
The default resource file, /usr/contrib/lib/X11/sys.Xdefaults
o sets the default Foreground, Background and BorderColor resources
o contains sample resources for a number of common clients.
Customized client and resource files
can be created by copying the default files to $HOME/.x11start and $HOME/.Xdefaults, respectively, and then customizing them. Custom-
ized files that exist (with the appropriate permissions) will be used by the x11start components in place of the default files.
Options
x11start options are the same as xinit options except that a client script cannot be specified.
Arguments preceeding a "--" (double dash), or all arguments if "--" is not specified, are passed on to the client script and can be
accessed as positional parameters within that script.
Arguments following a "--" that begins with a slash (/) or a period (.) identify the server. If a server is not explicity specified, xinit
determines the server from $DISPLAY if defined; otherwise from $XSERVERRC. If neither of these are defined, $HOME/.xserverrc is used if it
exists and is executable; otherwise X :0 is used.
Arguments following a "--" that don't begin with a slash or period are passed on to the appropriate server.
See xinit(1) for more details.
EXAMPLES
The following examples illustrate how x11start can be used to control the server and/or interact with the client script.
x11start This starts the default xinit server and executes the client script (either /usr/contrib/lib/X11/sys.x11start or
$HOME/.x11start) without passing arguments to either.
x11start -bg black -fn 24x36
This starts the default xinit server and executes the client script, passing it all of the arguments. If the default client
script is used, -bg black -fn 24x36 is be passed to both mwm and hpterm since both of their default command lines contain
"$@". If the default client script is used, the actual xinit command executed is:
xinit /usr/contrib/lib/X11/sys.x11start -bg black -fn 24x36
x11start -fg white -- :1
This starts the default server on display 1 and executes the client script with the arguments, -fg white. If the customized
client script is used, the xinit command line is:
xinit $HOME/.x11start -fg white -- :1
x11start -- Xhp -a2 -t 5
This starts the server, Xhp with the arguents, -a2 -t 5 and then executes the client script without any arguments.
ENVIRONMENT VARIABLES
DISPLAY
PATH
XSERVERRC
doxrgb
FILES
/usr/contrib/lib/X11/sys.Xdefaults
/usr/contrib/lib/X11/sys.x11start
$HOME/.Xdefaults
$HOME/.x11start
$HOME/.xserverrc
ORIGIN
HP
SEE ALSO
X(1), xinit(1), hpterm(1), mwm(1), xrdb(1)
X Version 11 Release 5 X11START(1)