xset man page on BSDOS

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDOS logo
[printable version]



XSET(1)							XSET(1)

NAME
       xset - user preference utility for X

SYNOPSIS
       xset  [-display display] [-b] [b on/off] [b [volume [pitch
       [duration]]]  [[-]bc]  [-c]  [c	on/off]	  [c	[volume]]
       [[+-]dpms]  [dpms  standby  [ suspend [ off]]] [dpms force
       standby/suspend/off] [[-+]fp[-+=]  path[,path[,...]]]  [fp
       default] [fp  rehash]  [[-]led	[integer]]  [led  on/off]
       [m[ouse] [accel_mult[/accel_div]	 [threshold]]]	[m[ouse]
       default] [p  pixel  color] [[-]r [keycode]] [r on/off] [r
       rate delay [rate]] [s [length [period]]] [s blank/noblank]
       [s expose/noexpose] [s on/off] [s default] [s activate] [s
       reset] [q]

DESCRIPTION
       This program  is used  to  set	various user  preference
       options of the display.

OPTIONS
       -display display
	       This option specifies the server to use; see X(1).

       b       The 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  parameter  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  characteris-
	       tics.   The  X server will set the characteristics
	       of the bell as closely as it  can  to  the  user's
	       specifications.

       bc      The  bc	option controls bug compatibility mode in
	       the server, if possible; a preceding dash(-)  dis-
	       ables  the  mode,  otherwise  the mode is enabled.
	       Various pre-R4 clients pass illegal values in some
	       protocol requests, and pre-R4 servers did not cor-
	       rectly  generate errors	in  these  cases.   Such
	       clients, when run against an R4 server, will ter-
	       minate 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

X Version 11		Release 6.4				1

XSET(1)							XSET(1)

	       development  should  be	done  with this mode dis-
	       abled.  The server must	support the  MIT-SUNDRY-
	       NONSTANDARD  protocol  extension in order for this
	       option to work.

       c       The c option controls key click. This option  can
	       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  dis-
	       abled.	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.

       -dpms   The -dpms option disables DPMS (Energy Star)  fea-
	       tures.

       +dpms   The  +dpms  option enables DPMS (Energy Star) fea-
	       tures.

       dpms flags...
	       The dpms option	allows	the  DPMS  (Energy  Star)
	       parameters  to  be set.	The option can take up to
	       three numerical values, or the `force'  flag  fol-
	       lowed  by  a DPMS state. The `force' flags forces
	       the server to immediately switch to the DPMS state
	       specified.    The   DPMS state	can  be	 one  of
	       `standby', `suspend', or `off'.	When	numerical
	       values  are  given, they set the inactivity period
	       (in units of seconds) before the three  modes  are
	       activated.   The first	value  given  is  for the
	       `standby' mode, the second is  for  the	`suspend'
	       mode,  and  the third is for the `off' mode.  Set-
	       ting these values implicitly enables the DPMS fea-
	       tures.	A  value  of  zero  disables a particular
	       mode.

       fp= path,...
	       The fp= sets the font path to the entries given in
	       the path argument.  The entries are interpreted by
	       the server, not by the client.  Typically they are
	       directory  names or  font  server  names, but the
	       interpretation is server-dependent.

       fp default
	       The default argument causes the font  path  to  be
	       reset to the server's default.

       fp rehash
	       The  rehash  argument  resets the font path to its
	       current value, causing the server  to  reread  the
	       font  databases in the current font path.  This is

X Version 11		Release 6.4				2

XSET(1)							XSET(1)

	       generally only used when adding	new  fonts  to	a
	       font  directory (after running mkfontdir to recre-
	       ate 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 entries.

       +fp or fp+
	       This +fp and fp+ options prepend and  append  ele-
	       ments  to  the  current	font  path, respectively.
	       They must be followed by a comma-separated list of
	       entries.

       led     The  led 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 pre-
	       ceding dash(-) or an 'on/off' flag.  If no parame-
	       ter 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 preced-
	       ing 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.

       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 trav-
	       els more than `threshold' pixels in a short  time.
	       This way, the mouse can be used for precise align-
	       ment 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 sys-
	       tem defaults will be set.

       p       The p option controls  pixel  color  values.   The
	       parameters are the color map entry number in deci-
	       mal,  and  a  color   specification.    The   root

X Version 11		Release 6.4				3

XSET(1)							XSET(1)

	       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.

       r       The  r  option controls the autorepeat.	If a pre-
	       ceding dash or the 'off' flag is used,  autorepeat
	       will  be disabled.   If no parameters or the 'on'
	       flag is used, autorepeat will be enabled.   If	a
	       specific keycode	 is  specified	as  a parameter,
	       autorepeat for that keycode  is	enabled or  dis-
	       abled.	If  the server supports the XFree86-Misc
	       extension, or the XKB extension, then a	parameter
	       of  'rate'  is  accepted and should be followed by
	       zero, one or two numeric values. The first  speci-
	       fies  the  delay before autorepeat starts and the
	       second specifies the repeat  rate.   In	the  case
	       that  the  server  supports the XKB extension, the
	       delay is the number of milliseconds before autore-
	       peat starts, and the rate is the number of repeats
	       per second.  If the rate or delay is not given, it
	       will be set to the default value.

       s       The 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,   an
	       'activate/reset' 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 'acti-
	       vate' flag forces activation of screen saver  even
	       if  the	screen	saver  had  been turned off.  The
	       'reset' flag forces deactivation of  screen  saver
	       if  it is active.  The 'blank' flag sets the pref-
	       erence 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
	       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

X Version 11		Release 6.4				4

XSET(1)							XSET(1)

	       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.

       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)

AUTHOR
       Bob Scheifler, MIT Laboratory for Computer Science
       David Krikorian, MIT Project Athena (X11 version)
       XFree86-Misc support added by David Dawes and Joe Moss

X Version 11		Release 6.4				5

[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server BSDOS

List of man pages available for BSDOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net