X11START(1)X11START(1)NAMEx11start - start the X11 window system
SYNOPSISx11start [options]
DESCRIPTION
NOTE: Beginning with the next release of HP-UX, x11start and its compo‐
nents (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 Envi‐
ronment User's Guide and the vuelogin man page for information on vuel‐
ogin.
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 per‐
forms the following start-up tasks:
· PATH environment variable set-up appropriate for the X environment
· X server start-up
· selected client(s) start-up from a specific client file
· general user resource loading from a specific resource file
Components
x11start encompasses the following components:
· the /usr/contrib/bin/X11/x11start script
· the /usr/contrib/bin/X11/xinit program
· the default client script, /usr/contrib/lib/X11/sys.x11start
· the default resouce file, /usr/contrib/lib/X11/sys.Xdefaults
The x11start script
· 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 vari‐
able, doxrdb which is normally executed via the client script after
the server has been started up.)
· 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
· execs xinit as follows (see xinit(1)):
xinit clientscript options
where
clientscript
is $HOME/.x11start or /usr/con‐
trib/lib/X11/sys.x11start
options are the xinit options exactly as specified on the
x11start command line (see Options below).
The xinit program
· starts the server with the server arguments specified in options
· runs the client script, passing it the client arguments specified
in options
· 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
· executes the environment variable, $doxrdb which was setup previ‐
ously by x11start to load the appropriate resource file to the
server
· runs both mwm and hpterm with all client arguments specified in
options
· 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
· sets the default Foreground, Background and BorderColor resources
· 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 argu‐
ments.
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 ALSOX(1), xinit(1), hpterm(1), mwm(1), xrdb(1)X Version 11 Release 5 X11START(1)