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)