.TH xset "" "" "X Utility"
.PC "Set preferences for the display"
\fBxset [\-b] [\-b on/off] [\-b [\fIvolume\fB [\fIpitch\fB [\fIduration\^\fB]\^]\^] [[\-]bc] [\-c] [\-c on/off] [\-c [\fIvolume\^\fB]\^]
	[\-display \fIdisplay\^\fB] [[\-+]fp[\-+] \fIdirectory\^\fB[,\fIdirectory\^\fB[, ...]]] [\-fp default] [\-fp rehash]
	[[\-]led [\fIinteger\^\fB]] [\^led on/off] [\-mouse [\fIaccel_mult\^\fB[/\fIaccel_div\^\fB] [\fIthreshold\^\fB]\^]\^]
	[\-mouse default] [\-P [\fIperiod\^\fB]\^]\^] [\-p \fIpixel color\^\fB] [\-q] [[\-]r] [\-r on/off] [\-s [\fIlength\fB]\^]
	[\-s blank/noblank] [\-s expose/noexpose] [\-s on/off] [\-s default]\fR
.PP
.HS
.SH Options:
.IC "\fB[\-]b [\fIvolume [\fIpitch \fB[\fIduration\^\fB]\^]\^]\fR"
Set the volume on the bell, both pitch and duration
.IC \fB[\-]bc\fR
Set the bug-compatibility mode in the server, if possible
.IC "\fB[\-]c [\fIvalue\^\fB]\fR"
Control key click
.IC "\fB\-display \fIserver\^\fR"
Set the configuration of display
.I server
.IC "\fBfp= \fIdirectory,...\^\fB]\fR"
Set the font path:
the X server searches each
.I directory
for fonts
.IC "\fBfp default\fR"
Set the font path to the server's default
.IC "fp rehash\fR"
Tell the server to re-read the font data bases in the current font path
.IC "\fB\-fp \fIdirectory\fB[, \fI... ]\fR"
Remove each
.I directory
from the font path
.IC "\fB+fp \fIdirectory\^\fB[,\fIdirectory\^\fB, ...]\^]\fR"
Add each
.I directory
to the font path
.IC "\fB[\-]led [\fIvalue\^\fB]\fR"
Toggle the keyboard LEDs
.IC "\fBm [\fIacceleration \fB[threshold\^\fB]\^]\fR"
Sets mouse values
.IC "\fBp [\fIentry \fB[\fIcolor\^\fB]\^]\fR"
Set the pixel color values
.IC \fB[\-]r\fR
Control the autorepeat
.IC "\fBs [\fItime\^]fB] [\fIcycle\^\fB] [blank|noblank] [expose|noexpose] [on|off] [default]\fR"
Set screen-saver parameters
.IC \fBq\fR
Print information on the current settings
.HE
The X utility
.B xset
lets you set options for the display.
It recognizes the following command-line options:
.IP "\fB[\-]b [\fIvolume [\fIpitch \fB[\fIduration\^\fB]\^]\^]\fR"
Set the volume on the bell, both pitch and duration.
This option accepts up to three numerical parameters,
a preceding hyphen `-',
or an
.B on/off
flag.
If the command line gives no parameters or the flag
.BR on ,
.B xset
uses the system defaults.
If the command includes a hypen or or the flag
.BR off ,
.B xset
turns the bell off.
.I volume
gives the volume of the bell, as a percent of its maximum volume.
.I pitch
gives the bell's pitch, in hertz.
.I duration
gives the bell's the duration, in milliseconds.
Not all hardware can vary the bell's characteristics.
The X server sets the characteristics
of the bell as closely as it can, but it may not be able to set them
exactly to your specifications.
.IP \fB[\-]bc\fR
Set the bug-compatibility mode in the server, if possible.
A hyphen `-' disables the mode; otherwise, the mode is enabled.
This option explicitly reintroduces certain bugs into the
X server, so that X can run many clients that compensated for bugs in
releases that preceded release 4.
Use this mode with care:
new applications should be developed with it disabled.
For this option to work, the server must support the protocol extension
.BR MIT-SUNDRY-NONSTANDARD .
.IP "\fB[\-]c [\fIvalue\^\fB]\fR"
Control key-click.
A hyphen or an
.B off
flag disables this option, which turns off the key-click.
.I value
sets the volume of the keyclick, from zero to 100;
the X server sets the volume to the nearest level that the hardware
can support.
.IP "\fB\-display \fIserver\^\fR"
Set the configuration of display
.IR server .
.IP "\fBfp=\fIdirectory\^\fB[,...]\fR"
Set the font path:
the X server searches each
.I directory
for fonts.
The server ignores each
.I directory
that does not contain a data base created by
.BR mkfontdir .
.IP "\fBfp default\fR"
Set the font path to the server's default.
.IP "\fBfp rehash\fR"
Re-read the font data bases in the current font path.
Use this only after you have added new fonts to a font directory and have run
.B mkfontdir
to add the fonts to that directory's font data base.
.IP "\fB\-fp \fIdirectory\fB[, \fI... ]\fR"
.IS "\fBfp\- \fIdirectory\fB[, \fI... ]\fR"
Remove each
.I directory
from the font path.
.IP "\fB+fp \fIdirectory\^\fB[,\fIdirectory\^\fB, ...]\^]\fR"
.IS "\fBfp+ \fIdirectory\^\fB[,\fIdirectory\^\fB, ...]\^]\fR"
Append each
.I directory
to, respectively,
the beginning or end of the font path.
.IP "\fB[\-]led [\fIvalue\^\fB]\fR"
Toggle the keyboard LEDs, that is, the little lights that indicate whether the
.BR "NumLock" ,
.BR "CapsLock" ,
and
.B "ScrollLock"
keys are set.
If no
.I value
is set or the flag
.B on
is set,
turn on all LEDs.
If a preceding hyphen or the flag
.B off
is set, turn off all LEDs.
Setting
.I value
to between one and three 
turns the corresponding LED on or off,
depending on whether this is preceded by a hyphen.
Different
.IR value s
may refer to different LEDs on different hardware.
.IP "\fBm [\fIacceleration \fB[threshold\^\fB]\^]\fR"
.IS "\fBm default\fR"
This option sets mouse values.
.I acceleration
sets the mouse-acceleration:
it can be an integer or a simple fraction.
The mouse goes
.I acceleration
times as fast when it travels more than
.I threshold
pixels in a short time.
This way, the mouse can be used for precise alignment when it is moved slowly,
yet can be set to travel across the screen in a flick of the wrist when desired.
Using the flag
.B default
or omitting all arguments sets the mouse parameters to the system's default.
.IP "\fBp [\fIentry \fB[\fIcolor\^\fB]\^]\fR"
Set the pixel color values.
.I entry
gives color map's entry number, in decimal;
.I color
gives a color specification.
On some servers, you can change the background color on the root window
by altering the entries for resources
.B BlackPixel
and
.BR WhitePixel .
Although these are often zero and one, 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.
.IP \fB[\-]r\fR
Control the autorepeat.
If a hyphen precedes this option, or if it is followed by the flag
.BR off ,
.B xset
turns autorepeat off.
.B xset
enables autorepeat if this option is followed by the flag
.BR on ,
or is followed by no flags at all.
.IP "\fBs [\fItime\^]fB] [\fIcycle\^\fB] [blank|noblank] [expose|noexpose] [on|off] [default]\fR"
Set screen-saver parameters, as follows:
.RS
.IP \fItime\fR
Wait
.I time
seconds before activating the screen saver.
.IS \fIcycle\fR
Modify the screen-saver's pattern after
.I cycle
seconds, to prevent the screen from burning in.
.IP \fBblank\fR
If the screen-saver option is set, blank the screen.
.IP \fBnoblank\fR
If the screen-saver option is set, display a pattern of some sort.
.IP \fBexpose\fR
Allow window exposures.
.IP \fBnoexpose\fR
Disable the screen saver
unless the server can regenerate the screens without causing exposure events.
.IP \fBon\fR
Turn on the screen saver.
.IP \fBoff\fR
Turn off the screen saver.
.IP \fBdefault\fR
Return parameters to their default values.
.RE
.IP \fBq\fR
Print information on the current settings.
.PP
The X server resets these values to their defaults after you log out.
.SH Example
The following gives example output of the command
.BR "xset q" :
.DM
	Keyboard Control:
	  auto repeat:  on    key click percent:  0    LED mask:  00000000
	  auto repeating keys:  0000000000000000
	                        0000000000000000
	                        0000000000000000
	                        0000000000000000
	  bell percent:  50    bell pitch:  400    bell duration:  100
	Pointer Control:
	  acceleration:  2/1    threshold:  4
	Screen Saver:
	  prefer blanking:  yes    allow exposures:  yes
	  timeout:  600    cycle:  600
	Colors:
	  default colormap:  0x21    BlackPixel:  0    WhitePixel:  1
	Font Path:
	  /usr/X11/lib/fonts/misc/,/usr/X11/lib/fonts/75dpi/
	Bug Mode: compatibility mode is disabled
.DE
.SH "See Also"
.B
X,
xmodmap,
X utilities,
xrdb,
xsetroot
.R
.SH Notes
Copyright \(co 1988, Massachusetts Institute of Technology.
.PP
.II "Scheifler, Bob"
.II "Krikorian, David"
.B xset
was written by Bob Scheifler of the MIT Laboratory for Computer Science,
and David Krikorian of MIT Project Athena.
