[0m


XSET(1)             UNIX Programmer's Manual		  XSET(1)



[1mNAME
     [0mxset - user preference utility for X

[1mSYNOPSIS
     xset [0m[-display _d_i_s_p_l_a_y] [-b] [b on/off] [b [_v_o_l_u_m_e [_p_i_t_c_h
     [_d_u_r_a_t_i_o_n]]] [[-]bc] [-c] [c on/off] [c [_v_o_l_u_m_e]] [[-+]fp[-
     +=] _p_a_t_h[,_p_a_t_h[,...]]] [fp default] [fp rehash] [[-]led
     [_i_n_t_e_g_e_r]] [led on/off] [m[ouse] [_a_c_c_e_l__m_u_l_t[/_a_c_c_e_l__d_i_v]
     [_t_h_r_e_s_h_o_l_d]]] [m[ouse] default] [p _p_i_x_e_l _c_o_l_o_r] [[-]r] [r
     on/off] [s [_l_e_n_g_t_h [_p_e_r_i_o_d]]] [s blank/noblank] [s
     expose/noexpose] [s on/off] [s default] [q]

[1mDESCRIPTION
     [0mThis program is used to set various user preference options
     of the display.

[1mOPTIONS
     -display [0m_d_i_s_p_l_a_y
	     This option specifies the server to use; see _X(_1).

     [1mb	     [0mThe [1mb [0moption controls bell volume, pitch and dura-
	     tion.  This option accepts up to three numerical
	     parameters, a preceding dash(-), or a 'on/off' flag.
	     If no parameters are given, or the 'on' flag is
	     used, the system defaults will be used.  If the dash
	     or 'off' are given, the bell will be turned off.  If
	     only one numerical parameter is given, the bell
	     volume will be set to that value, as a percentage of
	     its maximum.  Likewise, the second numerical parame-
	     ter specifies the bell pitch, in hertz, and the
	     third numerical parameter specifies the duration in
	     milliseconds.  Note that not all hardware can vary
	     the bell characteristics.	The X server will set the
	     characteristics of the bell as closely as it can to
	     the user's specifications.

     [1mbc      [0mThe [1mbc [0moption controls _b_u_g _c_o_m_p_a_t_i_b_i_l_i_t_y 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 gen-
	     erate errors in these cases.  Such clients, when run
	     against an R4 server, will terminate abnormally or
	     otherwise fail 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.

     [1mc	     [0mThe [1mc [0moption controls key click.  This option can



Printed 20/11/92	    Release 4				1






XSET(1)             UNIX Programmer's Manual		  XSET(1)



	     take an optional value, a preceding dash(-), or an
	     'on/off' flag.  If no parameter or the 'on' flag is
	     given, the system defaults will be used. If the dash
	     or 'off' flag is used, keyclick will be disabled.
	     If a value from 0 to 100 is given, it is used to
	     indicate volume, as a percentage of the maximum.
	     The X server will set the volume to the nearest
	     value that the hardware can support.

     [1mfp= [0m_p_a_t_h,...
	     The [1mfp= [0msets the font path to the directories given
	     in the path argument.  The directories are inter-
	     preted by the server, not by the client, and are
	     server-dependent.	Directories that do not contain
	     font databases created by _m_k_f_o_n_t_d_i_r will be ignored
	     by the server.

     [1mfp [0m_d_e_f_a_u_l_t
	     The _d_e_f_a_u_l_t argument causes the font path to be
	     reset to the server's default.

     [1mfp [0m_r_e_h_a_s_h
	     The _r_e_h_a_s_h argument causes the server to reread the
	     font databases in the current font path.  This is
	     generally only used when adding new fonts to a font
	     directory (after running _m_k_f_o_n_t_d_i_r to recreate the
	     font database).

     [1m-fp [0mor [1mfp-
	     [0mThe [1m-fp [0mand [1mfp- [0moptions remove elements from the
	     current font path.  They must be followed by a
	     comma-separated list of directories.

     [1m+fp [0mor [1mfp+
	     [0mThis [1m+fp [0mand [1mfp+ [0moptions prepend and append elements
	     to the current font path, respectively.  They must
	     be followed by a comma-separated list of direc-
	     tories.

     [1mled     [0mThe [1mled [0moption controls the keyboard LEDs.  This
	     controls the turning on or off of one or all of the
	     LEDs.  It accepts an optional integer, a preceding
	     dash(-) or an 'on/off' flag.  If no parameter or the
	     'on' flag is given, all LEDs are turned on.  If a
	     preceding dash or the flag 'off' is given, all LEDs
	     are turned off.  If a value between 1 and 32 is
	     given, that LED will be turned on or off depending
	     on the existence of a preceding dash.  A common LED
	     which can be controlled is the ``Caps Lock'' LED.
	     ``xset led 3'' would turn led #3 on.  ``xset -led
	     3'' would turn it off.  The particular LED values
	     may refer to different LEDs on different hardware.



Printed 20/11/92	    Release 4				2






XSET(1)             UNIX Programmer's Manual		  XSET(1)



     [1mm	     [0mThe [1mm [0moption 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 [1mm [0moption can be omit-
	     ted, but if only one is given, it will be inter-
	     preted as the acceleration.  If no parameters or the
	     flag 'default' is used, the system defaults will be
	     set.

     [1mp	     [0mThe [1mp [0moption controls pixel color values.	The
	     parameters are the color map entry number in
	     decimal, and a color specification.  The root back-
	     ground 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.

     [1mr	     [0mThe [1mr [0moption controls the autorepeat.  If a preced-
	     ing dash or the 'off' flag is used, autorepeat will
	     be disabled.  If no parameters or the 'on' flag is
	     used, autorepeat will be enabled.

     [1ms	     [0mThe [1ms [0moption lets you set the screen saver parame-
	     ters.  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 prefer-
	     ence 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 caus-
	     ing exposure events.  The length and period parame-
	     ters for the screen saver function determines how
	     long the server must be inactive for screen saving



Printed 20/11/92	    Release 4				3






XSET(1)             UNIX Programmer's Manual		  XSET(1)



	     to activate, and the period to change the background
	     pattern to avoid burn in.	The arguments are speci-
	     fied in seconds.  If only one numerical parameter is
	     given, it will be used for the length.

     [1mq	     [0mThe [1mq [0moption gives you information on the current
	     settings.

     These settings will be reset to default values when you log
     out.

     Note that not all X implementations are guaranteed to honor
     all of these options.

[1mSEE ALSO
     [0mX(1), Xserver(1), xmodmap(1), xrdb(1), xsetroot(1)

[1mCOPYRIGHT
     [0mCopyright 1988, Massachusetts Institute of Technology.
     See _X(_1) for a full statement of rights and permissions.

[1mAUTHOR
     [0mBob Scheifler, MIT Laboratory for Computer Science
     David Krikorian, MIT Project Athena (X11 version)































Printed 20/11/92	    Release 4				4



[0m