xset(X) X Version 11 (11 July 1990) xset(X)
NAME
xset - user-preference utility for X
SYNOPSIS
xset [options ...]
DESCRIPTION
This program sets various user preference options for the
display.
OPTIONS
-display display
Specifies the server.
b [-b] [b on/off] [b [volume
Controls bell volume, pitch and duration. This option
accepts up to three numerical parameters, a preceding
dash (-), or an on/off flag. If you specify no
parameters or the use the on flag, the system defaults
are used. If you specify the dash or off, the bell
turns off. If only one numerical parameter is given,
the bell volume is set to that value, as a percentage
of its maximum. Likewise, the second numerical
parameter specifies the bell pitch, in hertz, and the
third numerical parameter specifies the duration in
milliseconds. Volume control may not be supported on
some servers.
c [-c] [c on/off] [c [volume]]
Controls key click. This option can take an optional
value, a preceding dash (-), or an on/off flag. If you
specify no parameter or the on flag, xset uses the
system defaults. To disable key click, specify the
dash or off flag. If you specify a value from 0 to
100, it is used to indicate volume, as a percentage of
the maximum. Not all servers support key click. Those
that do will set the volume to the nearest value that
the hardware can support.
fp= [[-+]fp[-+=] path[,path[,...]]] [fp default] [fp
Sets the font path to the directories you specify in
the path argument. The directories are interpreted by
the server, not by the client, and are server-
dependent. The server ignores directories that do not
contain font databases created by mkfontdir.
fp default
Resets the font path to the server's default.
fp rehash
Causes the server to reread the font databases in the
current font path. Generally you use this option when
Page 1 (printed 7/3/90)
xset(X) X Version 11 (11 July 1990) xset(X)
adding new fonts to a font directory (after running
mkfontdir to recreate the font database).
-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.
+fp or fp+
The +fp and fp+ options add elements to the current
font path. They must be followed by a comma-separated
list of directories.
led [[-]led [integer]] [led on/off]
Controls the keyboard LEDs. This option also controls
turning on or off one or all of the LEDs. It accepts
an optional integer, a preceding dash(-) or an on/off
flag. To turn on the LEDs, specify no parameter or the
on flag. To turn off the LEDs, specify a preceding
dash or the off flag. If you specify a value between 1
and 32, that LED is turned on or off depending on the
existence of a preceding dash. A common LED that you
can control is the Caps Lock LED. To turn LED #3 on,
type:
xset led 3
To turn LED #3 off, type:
xset -led 3
The particular LED values may refer to different LEDs on
different hardware.
m [m[ouse] [acceleration [threshold]]] [m[ouse] default]
Controls the mouse parameters, acceleration and
threshold. The mouse, or whatever pointing device the
machine is connected to, will go acceleration times as
fast when it travels more than threshold pixels in a
short time. This way, you can use the mouse for
precise alignment when you move it slowly, and you can
also set it set to travel across the screen in a flick
of the wrist. You can omit one or both of these
parameters for the m option, but if you specify only
one it gets interpreted as the acceleration. If you
specify no parameters or the default flag, the system
defaults are set. Some servers do not support
threshold control.
p [p pixel color]
Controls pixel color values. The parameters are the
color map entry number pixel, (in decimal) and a color
Page 2 (printed 7/3/90)
xset(X) X Version 11 (11 July 1990) xset(X)
specification. You can change the root background
colors on some servers by altering the entries for
BlackPixel and WhitePixel. Although these are often 0
and 1, they need not be. The server may choose to
allocate those colors privately, in which case an error
is generated. The map entry must not be a read-only
color, or an error results.
r [[-]r] [r on/off]
Controls automatic repeat. If you use a preceding dash
or the off flag, autorepeat is disabled. To enable it,
use no parameters or the on flag. This option is not
supported on all servers.
s [s [length [period]]] [s blank/noblank]
[s expose/noexpose] [s on/off] [s default]
Sets 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. To set the default screen saver characteristics,
use no parameters or the default flag. The on/off
flags turn the screen saver functions on or off.
The blank flag sets the preference to blank out 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 out the video.
The expose flag sets the preference to allow window
exposures. The server can freely discard window
contents. The noexpose flag disables screen saver
unless the server can regenerate the screens without
causing exposure events.
The length parameter determines how long the server
must be inactive to activate screen saving. The period
parameter determines how often to change the background
pattern to avoid burn-in. You should specify the
arguments in seconds. If you specify only one
numerical parameter, it is used for the length.
q Gives you information on the current settings.
Ater you log out, these settings return to their default
values.
Note that not all X implementations are guaranteed to honor
all of these options.
SEE ALSO
X(X)
Xsight(X)
Page 3 (printed 7/3/90)
xset(X) X Version 11 (11 July 1990) xset(X)
xmodmap(X)
xrdb(X)
xsetroot(X)
COPYRIGHT
Copyright 1988, Massachusetts Institute of Technology.
See X(X) for a full statement of rights and permissions.
AUTHORS
Bob Scheifler, MIT Laboratory for Computer Science; David
Krikorian, MIT Project Athena (X11 version).
Page 4 (printed 7/3/90)