Xsight(X) X Version 11 (11 July 1990) Xsight(X)
NAME
Xsight - server for 80386-based computers running the UNIX
operating system.
SYNOPSIS
Xsight [:displayno] [option ... ]
DESCRIPTION
This is an X11 display server (Release 3) for 80386-based
computers running the UNIX operating system. It is most
often started with the startx startup file. To shut down
the server, press SYS REQ. On some keyboards, this is ALT-
SYS REQ.
OPTIONS
:displayno
Sets the display number of the server. For example,
Xsight :1 allows clients with DISPLAY=servername:1 to
establish connections. The default displayno is 0.
-d [[[vendor.]model.]class.]mode
Specifies your graphics adapter and its video mode
(resolution). The file /usr/lib/grafinfo/grafinfo.def
contains the system-wide default string that is used
when the -d option is not specified. See the operating
system documentation for details on supported graphics
adapters and how to add new adapters. Some examples of
setting the display type or resolution with the -d
option are:
Xsight -d 640x480
Xsight -d COMPAQ.PLASMA.CGA.640X400
Xsight -d Genoa.SuperVGA.VGA.640x350
Xsight -d Genoa.SuperVGA.VGA+.800x600
Xsight -d Hercules.Hercules.Hercules.720x350
Xsight -d IBM.STD.EGA.640x350
Xsight -d IBM.STD.VGA.640X350
Xsight -d V7.Deluxe.EGA.640x350
Xsight -d V7.Deluxe.VGA.640x480
Xsight -d vga.640x480
-h[elp]
Prints options and exits.
-s widthxheight
Sets the size of your root window, for VGA and EGA
only. The default is the same as your graphic adapter's
resolution. The size you set must be at least as large
as your real screen. The real screen scrolls over the
root window following the mouse cursor. The width must
be a multiple of 16. The width multiplied by the height
must be less than or equal to 524,288. For example:
Page 1 (printed 7/3/90)
Xsight(X) X Version 11 (11 July 1990) Xsight(X)
Xsight -s 1024x512
-analog
Specifies an analog VGA monitor. The default is off.
-fc font
Sets the cursor font. The default is cursor. Use this
only if you have a special purpose cursor font.
-fn font
Sets the default text font. The default is fixed.
Fonts are found in /usr/lib/X11/fonts. Most, however,
are special purpose fonts. To display them, use the xfd
client.
-fp path
Sets the font search path. The default is
/usr/lib/X11/fonts. Use this option only if the fonts
file was renamed or installed in a different directory.
-fr file
Sets the RGB database file. The default is
/usr/lib/X11/rgb.
Use this option only if you have renamed the rgb file or
moved it to a different directory.
-logo
Turns on the logo screen-saver. This places the X logo
on your screen if you do not use your screen for 10
minutes. Note that the -v option overrides this option.
-nologo
Turns off the logo screen-saver. The -v option
overrides this option.
-p n
Specifies how often (in seconds) to change the screen-
saver pattern.
-save n
Activates the screen-saver after n seconds of non-use.
The default is 600. This is to reduce wear on your
screen. If you use this option with the -logo option,
the X logo moves around the screen according to -p
option you specify.
-v on
Specifies video blanking for screen-saver. The default
is on. This blanks out your screen after 10 minutes of
non-use. This option overrides the -logo and -nologo
Page 2 (printed 7/3/90)
Xsight(X) X Version 11 (11 July 1990) Xsight(X)
options.
-v off
Specifies screen-saver without video blanking. Instead,
the root window pattern and X logo cover the screen.
The pattern shifts periodically as specified with the -p
option.
-nice n
Alters the priority of the server process by adding n to
the value of the current nice. n is from -40 to 40. By
default, the server process is assigned the value of
-40. The lower the value, the higher the scheduling
priority.
COLORS
You can display up to 16 colors simultaneously since most
supported graphics adapters have four planes of video
memory.
Depending on your graphics adapter and monitor, there are
two palettes (ranges of colors):
+ EGA (or VGA with digital RGB monitor) 64-color palette
+ VGA with analog RGB monitor
If you have an EGA display, a palette of 64 colors is
available to your clients.
If you have a VGA display, a palette of 262,144 colors is
available only if you use the -analog option. Otherwise,
the server assumes the VGA to be an EGA with a palette of 64
colors.
If you have a supported graphics adapter other than EGA or
VGA, you have two colors.
The RGB database files, rgb.map and rgb.dat, are compiled
from the file rgb.txt. Each line of the rgb.txt file
consists of three color values and a color name. The color
values are decimal numbers from 0 to 255 for the red, green,
and blue components of the color. A typical line looks like
this:
35 35 142 Navy Blue
This entry defines Navy Blue as consisting of 35/255ths of
the maximum possible intensity of red, 35/255ths of the
maximum possible intensity of green, and 142/255ths of the
maximum possible intensity of blue. The server is case-
insensitive when searching for color names, so "navy blue" or
Page 3 (printed 7/3/90)
Xsight(X) X Version 11 (11 July 1990) Xsight(X)
"Navy BLUE" finds the entry above, for example.
Remember that the precision of different adapters varies.
For example, on an EGA adapter all values from 0 through 63
display at the same intensity. Likewise, 64 through 127 are
the same, 128 through 191 are the same, and 192 through 255
are the same.
SCREEN-SWITCHING
The server supports screen-switching between 10 or 12
screens, depending on the number of function keys on your
keyboard. The sequence is ALT-Fn where n is 1 through 10 or
1 through 12.
You can redefine the switch-screen key sequence using the
switchkey program. One of these conditions must be met: (1)
you must be at the console; or (2) the DISPLAY environment
variable must be set and at least one server must be
running. The syntax of the switchkey program is:
switchkey -[cas]
c stands for the CTRL key, a stands for the ALT key, and s
stands for the SHIFT KEY. Specify the key sequence you want
with switchkey and you can then use that key sequence with
any function key. For example, to specify that you want to
use CTRL and SHIFT along with a function key, type:
switchkey -cs
Then, you switch screens by pressing CTRL-SHIFT-Fn.
To use only function keys without CTRL, ALT, or SHIFT, use
switchkey with only a hyphen and no arguments:
switchkey -
xswkey is another program that can be used in place of
switchkey. The syntax is identical.
ENVIRONMENT
XENVIRONMENT points to a file with your default resources.
DISPLAY specifies that clients open windows on your display.
See X(X).
XFONTS specifies the default font path.
XSIGHT specifies command-line options.
XSTARTUP specifies a command that the server invokes before
Page 4 (printed 7/3/90)
Xsight(X) X Version 11 (11 July 1990) Xsight(X)
it starts.
SECURITY
The server uses an access-control list for deciding whether
or not to accept connections from clients. This list
initially consists of the host on which the server is
running as well as any computers listed in the /etc/Xn.hosts
file, where n is the server's display number. Each line of
the file should contain an Internet host name (for example,
expo.lcs.mit.edu). There should be no leading or trailing
spaces on any lines. For example:
joesworkstation
corporate.company.com
You can add or remove hosts from this list and enable or
disable access control using xhost. For example:
% xhost +janesworkstation
janesworkstation being added to access control list
% xhost +
all hosts being allowed (access control disabled)
% xhost -
all hosts being restricted (access control enabled)
% xhost
access control enabled (only the following hosts are allowed)
joesworkstation
janesworkstation
corporate.company.com
Unlike some window systems, X does not have any notion of
window operation permissions or place any restrictions on
what a client can do; if a program can connect to a display,
it has full run of the screen.
SIGNALS
The server attaches special meaning to the following
signals:
SIGHUP
Causes the server to close all existing connections,
free all resources, and restore all defaults. It is
sent by the display manager whenever the user's main
application (usually an xterm or window manager) exits
to force the server to clean up and prepare for the
next user.
SIGTERM
Causes the server to exit cleanly.
Page 5 (printed 7/3/90)
Xsight(X) X Version 11 (11 July 1990) Xsight(X)
FONTS
Fonts are usually stored as individual files in directories.
The font path controls the list of directories where the
server looks when trying to open a font. Although most
sites may choose to have the server start up with the
appropriate font path (using the -fp option mentioned
above), you can use the xset program to override it.
The default font path for the server is:
/usr/lib/X11/fonts/misc
It contains several miscellaneous fonts that are useful on
all systems. It contains a very small family of fixed-width
fonts (6x10, 6x12, 6x13, 8x13, 8x13bold, and 9x15) and the
cursor font. It also has font-name aliases for the commonly
used fonts, fixed and variable.
You create font databases by running mkfontdir in the
directory containing the compiled versions of the fonts
(that is, the .snf files). Whenever you add fonts to a
directory, run mkfontdir so the server can find the new
fonts. The server cannot find any fonts in the directory if
you do not run mkfontdir.
FILES
System-wide default for graphics adapter and mode (-d
option):
usr/lib/grafinfo/grafinfo.def
grafinfo files:
/usr/lib/grafinfo/vendor/model.xgi
Initial access control list:
/etc/X*.hosts
Font directories:
/usr/lib/X11/fonts/misc
/usr/lib/X11/fonts/75dpi
/usr/lib/X11/fonts/100dpi
Color database:
/usr/lib/X11/rgb.txt
Error log file:
/usr/adm/X*msgs
Page 6 (printed 7/3/90)
Xsight(X) X Version 11 (11 July 1990) Xsight(X)
LIMITATIONS
If you kill the server in some way other than shutting it
down with the SYS REQ key, you may not be able to type on
the console. To remedy this, run the cleanscreen program
by typing cleanscreen at the operating system prompt from a
terminal. If you kill the server in some way other than
with the SYS-REQ key and you cannot log in as root, type
CTRL-D after running the cleanscreen program.
Up to eight servers can run simultaneously.
Keyboard click and autorepeat, bell volume, and LEDs are not
settable.
Page 7 (printed 7/3/90)