X11START(1) X Version 11 X11START(1)
Release 5
NAME [Toc] [Back]
x11start - start the X11 window system
SYNOPSIS [Toc] [Back]
x11start [options]
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
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
+ creates a command to load resources from the appropriate resource
file using xrdb (see xrdb(1)) (This command is not executed
immediately 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.)
+ 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/contrib/lib/X11/sys.x11start
options are the xinit options exactly as specified on the
x11start command line (see Options below).
Hewlett-Packard Company - 1 - HP-UX 9.0 August 1992
X11START(1) X Version 11 X11START(1)
Release 5
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
previously 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.
Customized files that exist (with the appropriate permissions)
will be used by the x11start components in place of the default
files.
Options [Toc] [Back]
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 [Toc] [Back]
The following examples illustrate how x11start can be used to control
the server and/or interact with the client script.
Hewlett-Packard Company - 2 - HP-UX 9.0 August 1992
X11START(1) X Version 11 X11START(1)
Release 5
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 [Toc] [Back]
DISPLAY
PATH
XSERVERRC
doxrgb
FILES [Toc] [Back]
/usr/contrib/lib/X11/sys.Xdefaults
/usr/contrib/lib/X11/sys.x11start
$HOME/.Xdefaults
$HOME/.x11start
$HOME/.xserverrc
ORIGIN [Toc] [Back]
HP
SEE ALSO [Toc] [Back]
X(1), xinit(1), hpterm(1), mwm(1), xrdb(1)
Hewlett-Packard Company - 3 - HP-UX 9.0 August 1992 [ Back ] |
