[0m


XSTART(1)	    UNIX Programmer's Manual		XSTART(1)



[1mNAME
     [0mXstart - start a suitable X server

[1mSYNOPSIS
     Xstart [0m[_s_e_r_v_e_r _a_r_g_u_m_e_n_t_s]

[1mDESCRIPTION
     [0m_X_s_t_a_r_t simply starts an X server with appropriate arguments
     for running under _x_d_m(1).	It may be used directly in the
     same was as _X_a_r_m(1) and with the same arguments, or it may
     be used indirectly as a result of typing [1mx [0mat the login
     prompt.  In either case the file /_e_t_c/_x_d_m/_X_c_o_n_f_i_g is read to
     find arguments to supply to the X server.	The server is
     started with the [1m-query[0m, [1m-once[0m, and [1m-authKeyFile [0marguments
     to cause it to contact _x_d_m.  These arguments are followed by
     any arguments specified in the /_e_t_c/_x_d_m/_X_c_o_n_f_i_g file and
     then any given on the command line.

     _X_d_m will prompt for a login name and user name and then
     start a normal X session.	At the end of the session the
     server will shut down and control will be returned to the
     terminal from which _X_s_t_a_r_t was started.

[1mFILE FORMAT
     [0mThe /_e_t_c/_x_d_m/_X_c_o_n_f_i_g file consists of any number of lines of
     keywords and values.  Each line should start with a keyword
     which may then be followed by a series of values.	Non-
     numeric values may be quoted (single or double quote charac-
     ters) and may contain the quote characters if they are pre-
     ceded by a \ character.  Characters may also be specified as
     octal values using the normal \nnn format, where each [1mn [0mis
     an octal digit.

     Any line which starts with a [1m# [0mcharacter is skipped.  The
     supported keywords are as follows:-

     AUTHOR		 Followed by the name of the author of
			 the file.  This argument is effectively
			 ignored.  It is provided to allow the
			 _x_a_d_m_i_n(1) program to detect a machine
			 generated file (in which case the author
			 will be [1m/etc/rc.X[0m).

     VDU-TYPE		 Followed by a single numeric argument
			 specifies a default for the monitor
			 type.	Normally _X_s_t_a_r_t obtains the moni-
			 tor type from the operating system.  If
			 this cannot be done the first [1mVDU-TYPE
			 [0mvalue in the file will be used.  This
			 keyword must precede all argument
			 specifications.




Printed 8/5/92	    Revision 1.4 of 22/07/90			1






XSTART(1)	    UNIX Programmer's Manual		XSTART(1)



     XSERVER		 The single argument is the name of the X
			 server to execute.  This defaults to
			 /_u_s_r/_b_i_n/_X_1_1/_X_a_r_m.

     MULTIPLE-SESSION	 This keyword takes no arguments.  It
			 causes the server to be run without the
			 [1m-once [0mflag so that it will not exit at
			 the end of the first session.

     XDM-HOST		 The single argument specifies the name
			 of the host for _X_a_r_m to contact (the
			 argument to the server [1m-query [0mflag).
			 This defaults to _l_o_o_p_b_a_c_k (the machine
			 on which _X_s_t_a_r_t is run).

     AUTHENTICATION	 The single argument is the name of the
			 authentication file.  This defaults to
			 /_e_t_c/_x_d_m/_X_k_e_y_s.  To make authentication
			 useful this file should be readable only
			 by the super-user.

     NOAUTHENTICATION	 This keyword switches off authentica-
			 tion.

     NODEFAULTS          This keyword prevents any of the follow-
			 ing vdu type specific arguments being
			 added to the server command line.

     The remaining keywords allow additional arguments to be
     specified for the server.	These are typically used to con-
     trol the number of screens which the server supports and the
     screen modes used.  The _X_s_t_a_r_t program does not check these
     arguments.

     ARGUMENTS		 The arguments are added to the server
			 command line.	The keyword may be given
			 multiple times.  The arguments consist
			 of everything following the keyword to
			 the end of the line.

     LOWRES-ARGUMENTS	 The arguments are added if the vdu type
			 is 0 (corresponding to a low resolution
			 monitor).

     MULTISCAN-ARGUMENTS The arguments are added if the vdu type
			 is 1 (corresponding to a multi-scan mon-
			 itor).

     HIGHRES-ARGUMENTS	 The arguments are added if the vdu type
			 is 2 (corresponding to a high reolution
			 black and white monitor).




Printed 8/5/92	    Revision 1.4 of 22/07/90			2






XSTART(1)	    UNIX Programmer's Manual		XSTART(1)



     VGA-ARGUMENTS	 The arguments are added if the vdu type
			 is 3 (corresponding to a VGA monitor).

     SUPERVGA-ARGUMENTS  The arguments are added if the vdu type
			 is 4 (corresponding to a Super VGA moni-
			 tor).

[1mNOTES
     [0mThe _X_s_t_a_r_t program is designed to be used as a login shell
     in the /_e_t_c/_p_a_s_s_w_d file.  When used as such it starts an X
     server according to the configuration information in
     /_e_t_c/_x_d_m/_X_c_o_n_f_i_g.	If that file does not exist (or is not
     readable) an X server will not be started - effectively use
     of X can be disabled by removing /_e_t_c/_x_d_m/_X_c_o_n_f_i_g.  When the
     X server is started in this way error messages from the
     server will appear on the login terminal.	If these appear
     while the X server is actually on display the border of the
     screen will flash until the terminal is selected (using the
     Break key).

     In normal use the /_e_t_c/_x_d_m/_X_c_o_n_f_i_g file is machine regen-
     erated during startup under the control of the /_e_t_c/_r_c._X
     script.  Editing the file will thus only have a temporary
     effect on the server configuration.  The /_e_t_c/_r_c._X script
     copies the contents of one of the files
     /_e_t_c/_x_d_m/_X_c_o_n_f_i_g.<_s_i_z_e>_M_b_y_t_e_s where [1m<size> [0mis replace by the
     amount of physical memory on the machine (4, 8, 12 or 16
     Mbytes).  This allows the X server to be appropriately con-
     figured for machines with less memory.  Editing any of these
     files will make a permanent change in the configuration for
     the relevant memory size.

     Removing /_e_t_c/_x_d_m/_X_c_o_n_f_i_g will prevent /_e_t_c/_r_c._X from
     recreating it (assuming /_e_t_c/_r_c._X has not been changed) and
     will thus prevent the X login.

     The different files and the support within the files for
     differing vdu types allow the default system to deal with
     any of the supported memory and screen configurations.  If
     (as is normally the case) a machine is to be permanently
     configured with a fixed amount of memory and a fixed screen
     type the /_e_t_c/_x_d_m/_X_c_o_n_f_i_g file itself can be edited to
     reflect the configuration; if the [1mAUTHOR [0mfield in the file
     is changed or removed /_e_t_c/_r_c._X will not modify the file.

[1mSEE ALSO
     [0m_x_a_d_m_i_n(1), _x_d_m(1), _X_a_r_m(1), _X_s_e_r_v_e_r(1)

[1mCOPYRIGHT
     [0mCopyright (c) 1990, Acorn Computers Ltd.





Printed 8/5/92	    Revision 1.4 of 22/07/90			3






XSTART(1)	    UNIX Programmer's Manual		XSTART(1)



[1mAUTHOR
     [0mJohn Bowler, Acorn Computers Ltd.





















































Printed 8/5/92	    Revision 1.4 of 22/07/90			4



[0m