xset(1) xset(1)
NAME
xset - user preference and font path-setting utility for X
SYNOPSIS
xset [-display display] [[-]bc]
[[-+]fp[-+=] path[,path[,...]]] [fp default] [fp rehash]
[m[ouse] [accel_mult[/accel_div] [threshold]]] [m[ouse] default]
[p pixel color]
[s [length [period]]] [s blank/noblank]
[s expose/noexpose] [s on/off] [s default] [q]
DESCRIPTION
This program is used to set various user preference and system
options of an X display, including the X server's font path.
It can also be used to show the current X server settings.
When used with any of the fp options, which adjust the font
path, xset adjusts the list of fonts available to the X server
accordingly. If the affected font directories also contain
font aliases, then these aliases are added, removed, or re-
read as appropriate.
Options
-display display
This option specifies the server to use; see X(1).
bc The bc option controls bug compatibility mode in the
server, if possible; a preceding dash(-) disables the
mode, otherwise the mode is enabled. Various pre-R4
clients pass illegal values in some protocol requests,
and pre-R4 servers did not correctly generate errors
in these cases. Such clients, when run against an R4
server, will terminate abnormally or otherwise fail to
operate correctly. Bug compatibility mode explicitly
reintroduces certain bugs into the X server, so that
many such clients can still be run. This mode should
be used with care; new application development should
be done with this mode disabled. The server must
support the MIT-SUNDRY-NONSTANDARD protocol extension
in order for this option to work.
fp= path, . . .
The fp= sets the font path to the directories given in
the path argument; the previous font path is no longer
in effect. Font directories are interpreted by the
server, not by the client, and are server-dependent.
Copyright 1994 Novell, Inc. Page 1
xset(1) xset(1)
The fonts.dir file in each directory, created by
mkfontdir, contains the font index for that directory
and is used to map font names as used by X clients to
font files in the directory; directories that do not
contain font indexes will be ignored by the server.
The fonts.alias file in each directory, which is
optional, can be edited by a systems administrator to
provide shorter and easier-to-use names for the most
commonly needed fonts. The use of fp= causes the
server to re-read the font indexes and fonts.alias
files in the specified font path, as it would do with
the use of fp rehash.
fp default
The default argument causes the font path to be reset
to the server's default; the default font path in
UnixWare is specified in the
/usr/X/defaults/Xwinconfig file. The use of fp
default causes the server to re-read the font indexes
and fonts.alias files in the now default font path, as
it would do with the use of fp rehash.
fp rehash
The rehash argument causes the server to reread the
font indexes and fonts.alias files in the current font
path. This is needed when new fonts or aliases have
been added to, removed from, or modified in a font
directory in the current font path, and after running
mkfontdir to recreate the font indexes in each such
modified font directory. (The font path is rehashed
automatically after a directory has been added to or
removed from the font path, or when the font path is
reset with fp default.)
-fp or fp-
The -fp and fp- options remove elements from the
current font path; they must be followed by a comma-
separated list of directories. The use of either of
these options causes the server to re-read the font
indexes and fonts.alias files in the now shortened
font path, as it would do with the use of fp rehash.
+fp or fp+
This +fp and fp+ options prepend and append elements
to the current font path, respectively; they must be
followed by a comma-separated list of directories.
Copyright 1994 Novell, Inc. Page 2
xset(1) xset(1)
The use of either of these options causes the server
to re-read the font indexes and fonts.alias files in
the now lengthened font path, as it would do with the
use of fp rehash.
m The m option controls the mouse parameters. The
parameters for the mouse are acceleration and
threshold. The acceleration can be specified as an
integer, or as a simple fraction. The mouse, or
whatever pointer the machine is connected to, will go
acceleration times as fast when it travels more than
threshold pixels in a short time. This way, the mouse
can be used for precise alignment when it is moved
slowly, yet it can be set to travel across the screen
in a flick of the wrist when desired. One or both
parameters for the m option can be omitted, but if
only one is given, it will be interpreted as the
acceleration. If no parameters or the flag default is
used, the system defaults will be set.
p The p option controls pixel color values. The
parameters are the color map entry number in decimal,
and a color specification. The root background colors
may be changed on some servers by altering the entries
for BlackPixel and WhitePixel. Although these are
often 0 and 1, they need not be. Also, a server may
choose to allocate those colors privately, in which
case an error will be generated. The map entry must
not be a read-only color, or an error will result.
s The s option lets you set the screen saver parameters.
This option accepts up to two numerical parameters, a
blank/noblank flag, an expose/noexpose flag, an on/off
flag, or the default flag. If no parameters or the
default flag is used, the system will be set to its
default screen saver characteristics. The on/off
flags simply turn the screen saver functions on or
off. The blank flag sets the preference to blank the
video (if the hardware can do so) rather than display
a background pattern, while noblank sets the
preference to display a pattern rather than blank the
video. The expose flag sets the preference to allow
window exposures (the server can freely discard window
contents), while noexpose sets the preference to
disable screen saver unless the server can regenerate
the screens without causing exposure events. The
Copyright 1994 Novell, Inc. Page 3
xset(1) xset(1)
length and period parameters for the screen saver
function determines how long the server must be
inactive for screen saving to activate, and the period
to change the background pattern to avoid burn in.
The arguments are specified in seconds. If only one
numerical parameter is given, it will be used for the
length.
q The q option gives you information on the current
settings. For example, the directories of the current
font path are shown.
These settings will be reset to default values when you re-
start the X server (this occurs each time you log off your
UnixWare desktop).
Note that in UnixWare, some vanilla X11R5 options for xset are
not supported. These unsupported options are b (bell
control), c (key click control), led (keyboard LED control),
and r (autorepeat control).
EXAMPLES
Let's assume that the system administrator has added to your
system a new bitmapped fonts directory /usr/X/lib/fonts/new
and run mkfontdir on it. To add it to the beginning of the
font path, she would ensure that the command
xset +fp /usr/X/lib/fonts/new
is part of your login processing or the new X server
configuration.
The UnixWare Desktop starts with the local font server in the
default font path. To remove the local font server from the
X server's font path and include one running on the machine
remote1 instead, use the commands:
xset fp- tcp/`uname -n`:7000
xset fp+ tcp/remote1:7000
As a final example, a user without owner or root permissions
wants to establish a couple of font aliases, using names he
can remember. He creates a dummy fonts directory, myfonts, in
his home directory, and a fonts.alias file in that, following
the format used by the system font alias files in
/usr/X/lib/fonts. To make the aliases known to the X server,
Copyright 1994 Novell, Inc. Page 4
xset(1) xset(1)
he must create a dummy index for the directory (all font
directories must contain a fonts.dir file), and use xset to
add the directory to the X font path:
echo 0 > $HOME/myfonts/fonts.dir
cp new-alias-file $HOME/myfonts/fonts.alias
xset fp+ $HOME/myfonts
This directory, with only his personal font aliases, is now
part of the font path. This can all be done without owner or
root permissions.
REFERENCES
X(1), fs(1), fsfpreset(1M), mkfontdir(1), xdpyinfo(1),
xmodmap(1), xrdb(1), xsetroot(1)
FILES
${XWINHOME:=/usr/X/}defaults/Xwinconfig
NOTICES
In the default configuration for UnixWare 2.0, the default
font path defined in /usr/X/defaults/Xwinconfig does not
include the directory containing the Type 1 fonts (Type 1
scalable outline fonts are rendered in UnixWare by Adobe Type
Manager (ATM). The directory containing these fonts is
defined in the ``catalogue'' of the font server, fs, where the
ATM rasterization of Type 1 fonts is done. The font server
process is started when the machine is booted, and the font
server is added as an entry to the X server font path when the
X server is started (when the graphical login process is
started, or when the desktop is started).
In UnixWare, the variations in the option fp for modifying the
font path (fp+, +fp, fp-, -fp, fp=) are not allowed to place
duplicate entries in the font path. No directory will be
placed into the font path more than once.
In UnixWare, the xset command must be run in the virtual
terminal in which the X server is running to take effect, or,
if it is executed from another virtual terminal or a remote
terminal, it will not take effect until the virtual terminal
in which the X server is running has been made active. If
xset is run when the X server is not running, it has no
effect.
Copyright 1994 Novell, Inc. Page 5
xset(1) xset(1)
The Integrity Check menu item of the Actions menu button in
the Fonts client of the Preferences folder of the UnixWare
Desktop is the desktop method of invoking xset fp rehash. The
Integrity Check activity includes running mkfontscale and
mkfontdir on the font directories, and using fsfpreset(1M) to
reset the font server catalog.
Copyright 1994 Novell, Inc. Page 6