


     XSET(1)                        AIX                        XSET(1)



     NAME
          xset - user preference utility for X

     SYNOPSIS
          xxxxsssseeeetttt [-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]

     DESCRIPTION
          This program is used to set various user preference options
          of the display.

     OPTIONS
          ----ddddiiiissssppppllllaaaayyyy _d_i_s_p_l_a_y
                  This option specifies the server to use; see _X(_1).

          bbbb       The bbbb option 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.

          bbbbcccc      The bbbbcccc option 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 to operate correctly.  Bug compati-
                  bility 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.

          cccc       The cccc option controls key click.  This option can


     Rev. Release 5                                             Page 1






     XSET(1)                        AIX                        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.

          ffffpppp==== _p_a_t_h,...
                  The ffffpppp==== sets 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.

          ffffpppp ddddeeeeffffaaaauuuulllltttt
                  The ddddeeeeffffaaaauuuulllltttt argument causes the font path to be
                  reset to the server's default.

          ffffpppp rrrreeeehhhhaaaasssshhhh
                  The rrrreeeehhhhaaaasssshhh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).

          ----ffffpppp or ffffpppp----
                  The ----ffffpppp and ffffpppp---- options remove elements from the
                  current font path.  They must be followed by a
                  comma-separated list of directories.

          ++++ffffpppp or ffffpppp++++
                  This ++++ffffpppp and ffffpppp++++ options prepend and append elements
                  to the current font path, respectively.  They must
                  be followed by a comma-separated list of direc-
                  tories.

          lllleeeedddd     The lllleeeedddd option 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.



     Rev. Release 5                                             Page 2






     XSET(1)                        AIX                        XSET(1)



          mmmm       The mmm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mmm option 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.

          pppp       The pppp option 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.

          rrrr       The rrrr option 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.

          ssss       The ssss option 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
                  to activate, and the period to change the background


     Rev. Release 5                                             Page 3






     XSET(1)                        AIX                        XSET(1)



                  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.

          qqqq       The qqqq option 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.

     SEE ALSO
          X(1), Xserver(1), xmodmap(1), xrdb(1), xsetroot(1)

     COPYRIGHT
          Copyright 1988, Massachusetts Institute of Technology.
          See _X(_1) for a full statement of rights and permissions.

     AUTHOR
          Bob Scheifler, MIT Laboratory for Computer Science
          David Krikorian, MIT Project Athena (X11 version)
































     Rev. Release 5                                             Page 4