Xwst3d(8X) — RISC

Name

Xwst3d − 3D X server for RISC machines

Syntax

Xwst3d [ options ]

Description

The Xwst3d command starts the X server. The Xwst3d X server is based on X11R4 and supports the following hardware configuration:

DECstation 5000 Series Single Screen 3D Color Workstations

The command that executes the server is specified together with its command line options in the /etc/ttys file and, therefore, is automatically run when your system is started in multiuser mode. Optionally, you can create an /etc/screens file containing device-dependent command line options (separated by spaces) and use it to start the server. Command line options specified in the /etc/ttys file override those specified in the /etc/screens 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 numSets the mouse acceleration value to the specified number of pixels. The default is 4.

−auth stringSelects 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.

bcEnables bug compatibility with previous releases.

−bsDisables Backing Store. Backing Store is disabled if you specify the −bs option on the command line. On systems with limited memory (16Mb or less) disabling backing store may improve performance.

−cTurns off key clicking.

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

−co stringSelects a color database. The default is /usr/lib/X11/rgb.txt.

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

−fc stringSets the default cursor font. The default is cursor.

−fd numSets the font size in dots per inch. Acceptable values are 75 and 100.

−fn stringSets the default text font. The default is fixed.

−fp stringSets the default font directory path. The default font directory paths are: /usr/lib/X11/fonts/decwin/100dpi/
/usr/lib/X11/fonts/misc/
/usr/lib/X11/fonts/100dpi/
/usr/lib/X11/fonts/local/100dpi/
/usr/lib/X11/fonts/apps/100dpi/
/usr/lib/X11/fonts/private/100dpi/

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

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

−helpDisplays the Xwst3d command usage message.

−IDirects the server to ignore all remaining command line arguments.

−ld numLimits data space to num Kbytes.

−ls numLimits stack space to num Kbytes.

−logoEnables the X logo screen saver.

logoDisables the X logo screen saver.

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

−rTurns off automatic repetition of keyboard key characters.

rTurns on automatic repetition of keyboard key characters. The default is on.

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

−suDisables Save-Unders. On systems with limited memory (16Mb or less) disabling Save-Unders may improve performance.

−t numSets the mouse threshold in pixels. The mouse will accelerate only if the threshold is exceeded. The default threshold is 4.

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

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

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

−vSpecifies that a pattern (noblank) screen is used for the screen saver.

−wmEnables the use of Backing Store with WhenMapped calls.

−x stringLoads the file string containing an X extension.

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

−broadcastEnables 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 hostnameEnables XDMCP and sends indirect query packets to the specified host.

−onceTerminates the server after one session.

−port numSpecifies the UDP port number that will receive messages.

−query hostnameEnables 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.

−btn numSpecifies the number of buttons on the pointer device. The default is three for a mouse device and four for a tablet device.

−bp colorSets the color of black pixels for the screen. The color argument can be a named color from the rgb database or a number sign (#) followed by a hexidecimal number.

−class visual classSets the visual class for the root window of the screen. Possible values are StaticGray, StaticColor, PseudoColor, GrayScale, DirectColor (24-plane displays only) and TrueColor. The default is TrueColor with 24-plane PXG options, PseudoColor otherwise.

−dpi numSets the dots per inch for the x and y coordinates. The default for both x and y is 95.

−dpix numSets the dots per inch for the x coordinate.

−dpiy numSets the dots per inch for the y coordinate.

−wp colorSets the color of white pixels for the screen. The syntax for color is the same as for the argument to the −bp option.

−tb nOpens /dev/tty0n for graphics tablet communications. The two free serial ports on the DECstation correspond to /dev/tty00 and /dev/tty01. A graphics tablet must be connected through one of these two ports.

−pcm nOpens /dev/tty0n for Protocol Control Module (PCM) communications. The two free serial ports on the DECstation correspond to /dev/tty00 and /dev/tty01. 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 /etc/ttys file may cause the workstation to behave as if the X server is hung.

This server supports only a single PXG or PXG-turbo graphics option. Multiscreen configurations are not supported.

Examples

The following example specifies that screen 0 has a resolution of 100x100 dots per inch:

Xwst3d -dpi0 100 -dpix1 75

If no screen is 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 have the hexadecimal value 3a009e005c0 prefixed with a number sign (#) and white pixels are color "wheat" from the X rgb color database.

Xwst3d -bp #3a009e005c0 -wp wheat

To specify the default visual class of a root window, use the -class command line option. Possible visual classes are: StaticGray, StaticColor, PseudoColor, GrayScale, and TrueColor. The following example specifies that the root window is a PseudoColor visual.

Xwst3d -class PseudoColor

Files

~/.Xdefaults
/etc/ttys
/etc/screens
/usr/lib/ucode/ds5k200.ucode (PXG microcode)

Museum

Related Articles