Xws_R4(8X)Xws_R4(8X)NameXws_R4 - 2D X server for RISC machines
SyntaxXws_R4 [ options ]
Description
The command starts the X server. The X server is based on X11R4 and
can be run on the following systems and graphics options:
DECstation 2100/3100 monochrome (PMAX-MFB)
DECstation 2100/3100 color (PMAX-CFB)
DECstation 5000/25 baseboard graphics (PMAG-DV)
DECstation 5000/33 baseboard graphics (PMAG-DV)
CX (PMAG-BA)
HX (PMAGB-BA)
MX (PMAG-AA)
PX (PMAG-CA)
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 avail‐
able 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 pixels.
-auth string Selects a file containing authorization records.
Hosts listed in the file are allowed to access to
the server's display. 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.
On systems with limited memory (16Mb or less) dis‐
abling backing store may improve performance.
-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 dots per inch (dpi).
-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 char‐
acters. The default is on.
-s seconds Sets the screen-saver timeout value to the speci‐
fied number of seconds. The default is 10 seconds.
-su Disables Save-Unders. On systems with limited mem‐
ory (16Mb or less) disabling Save-Unders may
improve performance.
-t num Sets the mouse threshold in pixels. The mouse will
accelerate only if the threshold is exceeded. The
default threshold is 4 pixels.
-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 ttyxx is a valid command line option,
but it is ignored by the Xws_R4 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 speci‐
fied 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-depen‐
dent options take an optional screen-specification argument. Omitting
the screen-specification argument defines the parameter for all avail‐
able screens.
-btn num Specifies the number of buttons on the pointer
device. The default is 3 for a mouse device and 4
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 data‐
base or a number sign (#) followed by a hexadecimal
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) communica‐
tions. 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.
Supported color graphics display devices include the CX, PX, TX and HX.
Supported monochrome graphics options include the MX. The PXG and PXG-
turbo graphics options are not supported.
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 wraparound mouse path by attaching non‐
contiguous screen edges. The arguments are disabled on single screen
systems.
Nonsensical screen connections are not allowed; the top edge of a par‐
ticular 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_R4-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_R4-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, Pseudo‐
Color, GrayScale, and TrueColor. The following example specifies that
the screen root window is a TrueColor visual, and the screen root win‐
dow is a PseudoColor visual.
Xws_R4-class0 TrueColor -class1 PseudoColor
The following example attaches screen above screen and screen to the
right of screen (an L-shaped configuration):
Xws_R4-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_R4-edge_left0 2 -edge_right0 1 -edge_left1 0 -edge_right1 2 \
-edge_left2 1 -edge_right2 0
FilesSee AlsoX(1X)Xwst3d(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
RISC Xws_R4(8X)