unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 X11START(1)			X Version 11			 X11START(1)
				  Release 5



 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<b class="man">+ PATH environment variable set-up appropriate for the X environment
	o<b class="man">+ X server start-up
	o<b class="man">+ selected client(s) start-up from a specific client file
	o<b class="man">+ general user resource loading from a specific resource file

    Components
      x11start encompasses the following components:

	o<b class="man">+ the /usr/contrib/bin/X11/x11start script
	o<b class="man">+ the /usr/contrib/bin/X11/xinit program
	o<b class="man">+ the default client script, /usr/contrib/lib/X11/sys.x11start
	o<b class="man">+ 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
      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.





 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
      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)






 Hewlett-Packard Company	    - 3 -	       HP-UX 9.0 August 1992