Xws(8X) 																   Xws(8X)

Name
       Xws - X server for RISC machines

Syntax
       Xws [ options ]

Description
       The command starts the X server.  The command supports the following hardware configurations:

	  DECstation/DECsystem 3100 Single Screen Color Workstations
	  DECstation/DECsystem 3100 Single Screen Monochrome Workstations
	  DECstation/DECsystem 5000 Single Screen Color Workstations
	  DECstation/DECsystem 5000 Single Screen Monochrome Workstations
	  DECstation/DECsystem 5000 Multiscreen Color Workstations
	  DECstation/DECsystem 5000 Multiscreen Monochrome Workstations

       The  command  that executes the server is specified together with its command line options in the file and, therefore, is automatically run
       when your system is started in multiuser mode.  Optionally, you can create an file containing device-dependent command line options  (sepa-
       rated by spaces) and use it to start the server.  Command line options specified in the file override those specified in the file.

       Start the server in bug compatibility mode (with the bc option) to remain bug-for-bug compatible with previous releases of the server.

Options
       The  following  options	are  device  independent.  These options are available on all workstation hardware platforms running X11 Release 4
       servers.

       -a num		   Sets the mouse acceleration value to the specified number of pixels.  The default is 4.

       -auth string	   Selects a file containing authorization records.  Hosts listed in the file are allowed to access to the  server's  dis-
			   play.  By default, no authorization file is used.

       bc		   Enables bug compatibility with previous releases.

       -bs		   Disables Backing Store. Backing Store is disabled if you specify the -bs option on the command line.

       -c		   Turns off key clicking.

       c num		   Sets the key click volume to the specified number (0-100).  The default is 20.

       -co string	   Selects a color database.  The default is

       -f num		   Sets the bell volume to the specified number (0-100).  The default is 50.

       -fc string	   Sets the default cursor font.  The default is

       -fd num		   Sets the font size in dots per inch.  Acceptable values are 75 and 100.

       -fn string	   Sets the default text font.	The default is

       -fp string	   Sets the default font directory path.  The default font directory paths are:

       +fp path[,path...]  Prepends the specified font paths to the default path.

       fp+ path[,path...]  Appends the specified font paths to the default path.

       -help		   Displays the command usage message.

       -I		   Directs the server to ignore all remaining command line arguments.

       -ld num		   Limits data space to num Kbytes.

       -ls num		   Limits stack space to num Kbytes.

       -logo		   Enables the X logo screen saver.

       logo		   Disables the X logo screen saver.

       -p seconds	   Determines how long to wait before changing the background pattern of the screen saver.  The default is 10 seconds.

       -r		   Turns off automatic repetition of keyboard key characters.

       r		   Turns on automatic repetition of keyboard key characters.  The default is on.

       -s seconds	   Sets the screen-saver timeout value to the specified number of seconds.  The default is 10.

       -su		   Disables Save-Unders.

       -t num		   Sets  the mouse threshold in pixels.  The mouse will accelerate only if the threshold is exceeded.  The default thresh-
			   old is 4.

       -to seconds	   Specifies the number of seconds for the server to wait before declaring a session connection timed out.

       ttyxx		   Specifies the terminal on which the server is to start.  The Wttyxx is a valid command line option, but it  is  ignored
			   by the WXws server.

       v		   Specifies that a blank screen is used for the screen saver.	This is the default screen saver.

       -v		   Specifies that a pattern (noblank) screen is used for the screen saver.

       -wm		   Enables the use of Backing Store with WhenMapped calls.

       -x string	   Loads the file string containing an X extension.

       :num		   On a multihead system, specifies the head on which the server is run (0 or 1).  The default is 0.

       -broadcast	   Enables X Display Manager Control Protocol (XDMCP) and sends broadcast query packets over the network.

       -displayID display-id
			   For XDMCP, identifies manufacturer's display ID for display

       -indirect hostname  Enables XDMCP and sends indirect query packets to the specified host.

       -once		   Terminates the server after one session.

       -port num	   Specifies the UDP port number that will receive messages.

       -query hostname	   Enables XDMCP and sends query packets to the specified host.

       -XDMCP_class display-class
			   Specifies an additional display qualifier used in resource management by XDMCP.

       The  following  are  device-dependent,  vendor-specific options.  When the server is run on multiscreen capable platforms, selected device-
       dependent options take an optional screen-specification argument.  Omitting the screen-specification argument defines the parameter for all
       available screens.

       -btn num 	   Specifies  the  number of buttons on the pointer device.  The default is three for a mouse device and four for a tablet
			   device.

       -bp[screen]  color  Sets the color of black pixels for the screen.  The color argument can be a named color from the database or  a  number
			   sign (#) followed by a hexidecimal number.

       -class[screen]  visual class
			   Sets the visual class for the root window of the screen.  Possible values are and

       -dpi[screen]  num   Sets the dots per inch for the x and y coordinates.

       -dpix[screen]  num  Sets the dots per inch for the x coordinates.

       -dpiy[screen]  num  Sets the dots per inch for the y coordinates.

       -edge_bottomscr1 scr2
			   Attaches the bottom edge of the screen specified by scr1 to the screen specified by scr2.

       -edge_leftscr1 scr2 Attaches the left edge of the screen specified by scr1 to the screen specified by scr2.

       -edge_rightscr1 scr2
			   Attaches the right edge of the screen specified by scr1 to the screen specified by scr2.

       -edge_topscr1 scr2  Attaches the top edge of the screen specified by scr1 to the screen specified by scr2.

       -wp[screen]  color  Sets the color of white pixels for the screen.  The syntax for color is the same as for the argument to the -bp option.

       -tb n		   Opens  for  graphics  tablet  communications.  The two free serial ports on the DECstation correspond to and A graphics
			   tablet must be connected through one of these two ports.

       -pcm n		   Opens for Protocol Control Module (PCM) communications.  The two free serial ports on the DECstation correspond to  and
			   Dial boxes and button boxes must be connected through these two ports.

Restrictions
       If  options  not  listed in this reference page are used, the server may fail. Using invalid options for the X server in the file may cause
       the workstation to behave as if the X server is hung.

       Multiscreen configurations can contain either two- or three-color frame buffer display devices or monochrome frame buffer display devices.

       Color and monochrome frame buffer display devices cannot be installed in the same workstation.  Only homogeneous installations are allowed.

       To connect two screens, two command line options must be issued.  Attaching two screens using only one argument produces a  one-way  mouse-
       travel path.  You can create a wrap-around mouse path by attaching noncontiguous screen edges.  The arguments are disabled on single screen
       systems.

       Nonsensical screen connections are not allowed; the top edge of a particular screen must be connected  with  the  bottom  edge  of  another
       screen,	and  the right edge of a particular screen must be connected with the left edge of another screen.  Left and right edges cannot be
       connected to top or bottom edges.

Examples
       The following example specifies that screen has a resolution of 100x100 dots per inch and screen has a resolution of 75x70 dots per inch:
       Xws -dpi0 100 -dpix1 75 -dpiy1 70

       If no screen is specified, the value specified is used for all screens.	If the screen resolution  is  not  specified  using  command  line
       options, a default value based on pixel dimensions and screen size is calculated for each screen.

       The  following  example	specifies  that  black pixels on screen have the hexadecimal value 3a009e005c0 prefixed with a number sign (#) and
       white pixels on screen are color "wheat" from the X rgb color database.
       Xws -bp1 #3a009e005c0 -wp1 wheat
       For monochrome display devices, values of 0 and 1 are the only valid pixel colors.

       To specify the default visual class of a root window on a particular screen, append the screen number (0, 1, or	2)  to	the  command  line
       option.	Possible visual classes are: StaticGray, StaticColor, PseudoColor, GrayScale, and TrueColor.  The following example specifies that
       the screen root window is a TrueColor visual, and the screen root window is a PseudoColor visual.
       Xws -class0 TrueColor -class1 PseudoColor

       The following example attaches screen above screen and screen to the right of screen (an L-shaped configuration):
       Xws -edge_top0 1 -edge_bottom1 0 -edge_right0 2 -edge_left2 0

       The following example is identical to the default state (a horizontal line) with the addition of a wraparound from screen to screen
       Xws -edge_left0 2 -edge_right0 1 -edge_left1 0 -edge_right1 2 
       -edge_left2 1 -edge_right2 0

Files
See Also
       X(1X)
       X Window System: The Complete Reference to Xlib, X Protocol, ICCCM, XLFD, by Robert W. Scheifler and James Gettys, Second Edition,  Digital
       Press, 1990
       OSF/MOTIF Programmer's Guide and OSF/MOTIF Reference Guide, Open Software Foundation, Prentice-Hall, 1990

								       RISC								   Xws(8X)