4 XScreenSaver(1) XScreenSaver(1)
8 xscreensaver - graphics hack and screen locker, launched
11 S
\bSY
\bYN
\bNO
\bOP
\bPS
\bSI
\bIS
\bS
12 x
\bxs
\bsc
\bcr
\bre
\bee
\ben
\bns
\bsa
\bav
\bve
\ber
\br [-display _
\bh_
\bo_
\bs_
\bt_
\b:_
\bd_
\bi_
\bs_
\bp_
\bl_
\ba_
\by_
\b._
\bs_
\bc_
\br_
\be_
\be_
\bn] [-timeout _
\bi_
\bn_
\bt]
13 [-cycle _
\bi_
\bn_
\bt] [-lock-mode] [-no-lock-mode] [-lock-timeout
14 _
\bi_
\bn_
\bt] [-visual _
\bv_
\bi_
\bs_
\bu_
\ba_
\bl] [-install] [-no-install] [-verbose]
15 [-silent] [-timestamp] [-capture-stderr] [-no-cap-
16 ture-stderr] [-splash] [-no-splash] [-nice _
\bi_
\bn_
\bt]
17 [-mit-extension] [-no-mit-extension] [-sgi-extension]
18 [-no-sgi-extension] [-xidle-extension] [-no-xidle-exten-
19 sion] [-proc-interrupts] [-no-proc-interrupts] [-xrm
20 _
\br_
\be_
\bs_
\bo_
\bu_
\br_
\bc_
\be_
\bs]
22 D
\bDE
\bES
\bSC
\bCR
\bRI
\bIP
\bPT
\bTI
\bIO
\bON
\bN
23 The _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br program waits until the keyboard and
24 mouse have been idle for a period, and then runs a graph-
25 ics demo chosen at random. It turns off as soon as there
26 is any mouse or keyboard activity.
28 This program can lock your terminal in order to prevent
29 others from using it, though its default mode of operation
30 is merely to display pretty pictures on your screen when
33 The benefit that this program has over the combination of
34 the x
\bxl
\blo
\boc
\bck
\bk(1) and x
\bxa
\bau
\but
\bto
\bol
\blo
\boc
\bck
\bk(1) programs is the ease with
35 which new graphics hacks can be installed. You don't need
36 to recompile (or even re-run) this program to add a new
39 G
\bGE
\bET
\bTT
\bTI
\bIN
\bNG
\bG S
\bST
\bTA
\bAR
\bRT
\bTE
\bED
\bD
40 For the impatient, try this:
45 The x
\bxs
\bsc
\bcr
\bre
\bee
\ben
\bns
\bsa
\bav
\bve
\ber
\br-
\b-d
\bde
\bem
\bmo
\bo(1) program should pop up a dialog
46 box that lets you experiment with the xscreensaver set-
47 tings and graphics modes.
49 N
\bNo
\bot
\bte
\be:
\b: unlike x
\bxl
\blo
\boc
\bck
\bk(1), xscreensaver has a client-server
50 model: the _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br program is a daemon that runs in
51 the background; it is controlled by the foreground
52 x
\bxs
\bsc
\bcr
\bre
\bee
\ben
\bns
\bsa
\bav
\bve
\ber
\br-
\b-d
\bde
\bem
\bmo
\bo(1) and x
\bxs
\bsc
\bcr
\bre
\bee
\ben
\bns
\bsa
\bav
\bve
\ber
\br-
\b-c
\bco
\bom
\bmm
\bma
\ban
\bnd
\bd(1) programs.
54 C
\bCO
\bON
\bNF
\bFI
\bIG
\bGU
\bUR
\bRA
\bAT
\bTI
\bIO
\bON
\bN
55 Options to _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br are specified in one of two
56 places: in a _
\b._
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br file in your home directory; or
57 in the X resource database. If the _
\b._
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br file
58 exists, it overrides any settings in the resource
64 X Version 11 20-Jun-99 (3.15) 1
70 XScreenSaver(1) XScreenSaver(1)
73 The syntax of the _
\b._
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br file is similar to that of
74 the _
\b._
\bX_
\bd_
\be_
\bf_
\ba_
\bu_
\bl_
\bt_
\bs file; for example, to set the _
\bt_
\bi_
\bm_
\be_
\bo_
\bu_
\bt
75 paramter in the _
\b._
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br file, you would write the
80 whereas, in the _
\b._
\bX_
\bd_
\be_
\bf_
\ba_
\bu_
\bl_
\bt_
\bs file, you would write
82 xscreensaver.timeout: 5
84 If you change a setting in the _
\b._
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br file while
85 xscreensaver is already running, it will notice this, and
86 reload the file. (The file will be reloaded the next time
87 the screen saver needs to take some action, such as blank-
88 ing or unblanking the screen, or picking a new graphics
91 If you change a setting in your X resource database, or if
92 you want xscreensaver to notice your changes immediately
93 instead of the next time it wakes up, then you will need
94 to tell the running xscreensaver process to re-initialize
97 xscreensaver-command -restart
99 Note that if you changed the _
\b._
\bX_
\bd_
\be_
\bf_
\ba_
\bu_
\bl_
\bt_
\bs file, you might
100 also need to run x
\bxr
\brd
\bdb
\bb(1):
104 If you want to set the system-wide defaults, then make
105 your edits to the xscreensaver app-defaults file, which
106 should have been installed when xscreensaver itself was
107 installed. The app-defaults file will usually be named
108 /usr/lib/X11/app-defaults/XScreenSaver, but different sys-
109 tems might keep it in a different place (for example,
110 /usr/openwin/lib/app-defaults/XScreenSaver on Solaris.)
112 When settings are changed in the Preferences dialog box
113 (see above) the current settings will be written to the
114 _
\b._
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br file. (The _
\b._
\bX_
\bd_
\be_
\bf_
\ba_
\bu_
\bl_
\bt_
\bs file and the app-
115 defaults file will never be written by xscreensaver
119 t
\bti
\bim
\bme
\beo
\bou
\but
\bt (class T
\bTi
\bim
\bme
\be)
120 The screensaver will activate (blank the screen)
121 after the keyboard and mouse have been idle for
122 this many minutes. Default 10 minutes.
124 c
\bcy
\byc
\bcl
\ble
\be (class T
\bTi
\bim
\bme
\be)
125 After the screensaver has been running for this
126 many minutes, the currently running graphics-hack
130 X Version 11 20-Jun-99 (3.15) 2
136 XScreenSaver(1) XScreenSaver(1)
139 sub-process will be killed (with S
\bSI
\bIG
\bGT
\bTE
\bER
\bRM
\bM), and a
140 new one started. If this is 0, then the graphics
141 hack will never be changed: only one demo will run
142 until the screensaver is deactivated by user
143 activity. Default 10 minutes.
145 l
\blo
\boc
\bck
\bk (class B
\bBo
\boo
\bol
\ble
\bea
\ban
\bn)
146 Enable locking: before the screensaver will turn
147 off, it will require you to type the password of
148 the logged-in user (really, the person who ran
149 xscreensaver), or the root password. (N
\bNo
\bot
\bte
\be:
\b: this
150 doesn't work if the screensaver is launched by
151 x
\bxd
\bdm
\bm(1) because it can't know the user-id of the
152 logged-in user. See the ``_
\bU_
\bs_
\bi_
\bn_
\bg _
\bX_
\bD_
\bM_
\b(_
\b1_
\b)'' section,
155 l
\blo
\boc
\bck
\bkT
\bTi
\bim
\bme
\beo
\bou
\but
\bt (class T
\bTi
\bim
\bme
\be)
156 If locking is enabled, this controls the length of
157 the ``grace period'' between when the screensaver
158 activates, and when the screen becomes locked.
159 For example, if this is 5, and _
\b-_
\bt_
\bi_
\bm_
\be_
\bo_
\bu_
\bt is 10,
160 then after 10 minutes, the screen would blank. If
161 there was user activity at 12 minutes, no password
162 would be required to un-blank the screen. But, if
163 there was user activity at 15 minutes or later
164 (that is, _
\b-_
\bl_
\bo_
\bc_
\bk_
\b-_
\bt_
\bi_
\bm_
\be_
\bo_
\bu_
\bt minutes after activation)
165 then a password would be required. The default is
166 0, meaning that if locking is enabled, then a
167 password will be required as soon as the screen
170 p
\bpa
\bas
\bss
\bsw
\bwd
\bdT
\bTi
\bim
\bme
\beo
\bou
\but
\bt (class T
\bTi
\bim
\bme
\be)
171 If the screen is locked, then this is how many
172 seconds the password dialog box should be left on
173 the screen before giving up (default 30 seconds.)
174 This should not be too large: the X server is
175 grabbed for the duration that the password dialog
176 box is up (for security purposes) and leaving the
177 server grabbed for too long can cause problems.
179 v
\bvi
\bis
\bsu
\bua
\bal
\blI
\bID
\bD (class V
\bVi
\bis
\bsu
\bua
\bal
\blI
\bID
\bD)
180 Specify which X visual to use by default. (Note
181 carefully that this resource is called v
\bvi
\bis
\bsu
\bua
\bal
\blI
\bID
\bD,
182 not merely v
\bvi
\bis
\bsu
\bua
\bal
\bl; if you set the v
\bvi
\bis
\bsu
\bua
\bal
\bl resource
183 instead, things will malfunction in obscure ways
184 for obscure reasons.)
186 Legal values for the V
\bVi
\bis
\bsu
\bua
\bal
\blI
\bID
\bD resource are:
188 d
\bde
\bef
\bfa
\bau
\bul
\blt
\bt Use the screen's default visual (the
189 visual of the root window.) This is the
192 b
\bbe
\bes
\bst
\bt Use the visual which supports the most
196 X Version 11 20-Jun-99 (3.15) 3
202 XScreenSaver(1) XScreenSaver(1)
205 colors. Note, however, that the visual
206 with the most colors might be a TrueColor
207 visual, which does not support colormap
208 animation. Some programs have more inter-
209 esting behavior when run on PseudoColor
210 visuals than on TrueColor.
212 m
\bmo
\bon
\bno
\bo Use a monochrome visual, if there is one.
214 g
\bgr
\bra
\bay
\by Use a grayscale or staticgray visual, if
215 there is one and it has more than one
216 plane (that is, it's not monochrome.)
218 c
\bco
\bol
\blo
\bor
\br Use the best of the color visuals, if
221 G
\bGL
\bL Use the visual that is best for OpenGL
222 programs. (OpenGL programs have somewhat
223 different requirements than other X pro-
226 _
\bc_
\bl_
\ba_
\bs_
\bs where _
\bc_
\bl_
\ba_
\bs_
\bs is one of S
\bSt
\bta
\bat
\bti
\bic
\bcG
\bGr
\bra
\bay
\by, S
\bSt
\bta
\bat
\bti
\bic
\bc-
\b-
227 C
\bCo
\bol
\blo
\bor
\br, T
\bTr
\bru
\bue
\beC
\bCo
\bol
\blo
\bor
\br, G
\bGr
\bra
\bay
\byS
\bSc
\bca
\bal
\ble
\be, P
\bPs
\bse
\beu
\bud
\bdo
\boC
\bCo
\bol
\blo
\bor
\br,
228 or D
\bDi
\bir
\bre
\bec
\bct
\btC
\bCo
\bol
\blo
\bor
\br. Selects the deepest
229 visual of the given class.
231 _
\bn_
\bu_
\bm_
\bb_
\be_
\br where _
\bn_
\bu_
\bm_
\bb_
\be_
\br (decimal or hex) is inter-
232 preted as a visual id number, as reported
233 by the x
\bxd
\bdp
\bpy
\byi
\bin
\bnf
\bfo
\bo(1) program; in this way
234 you can have finer control over exactly
235 which visual gets used, for example, to
236 select a shallower one than would other-
237 wise have been chosen.
239 Note that this option specifies only the _
\bd_
\be_
\bf_
\ba_
\bu_
\bl_
\bt
240 visual that will be used: the visual used may be
241 overridden on a program-by-program basis. See the
242 description of the p
\bpr
\bro
\bog
\bgr
\bra
\bam
\bms
\bs resource, below.
244 i
\bin
\bns
\bst
\bta
\bal
\bll
\blC
\bCo
\bol
\blo
\bor
\brm
\bma
\bap
\bp (class B
\bBo
\boo
\bol
\ble
\bea
\ban
\bn)
245 Install a private colormap while the screensaver
246 is active, so that the graphics hacks can get as
247 many colors as possible. This is the default.
248 (This only applies when the screen's default
249 visual is being used, since non-default visuals
250 get their own colormaps automatically.) This can
251 also be overridden on a per-hack basis: see the
252 discussion of the d
\bde
\bef
\bfa
\bau
\bul
\blt
\bt-
\b-n
\bn name in the section
253 about the p
\bpr
\bro
\bog
\bgr
\bra
\bam
\bms
\bs resource.
255 v
\bve
\ber
\brb
\bbo
\bos
\bse
\be (class B
\bBo
\boo
\bol
\ble
\bea
\ban
\bn)
256 Whether to print diagnostics. Default false.
262 X Version 11 20-Jun-99 (3.15) 4
268 XScreenSaver(1) XScreenSaver(1)
271 t
\bti
\bim
\bme
\bes
\bst
\bta
\bam
\bmp
\bp (class B
\bBo
\boo
\bol
\ble
\bea
\ban
\bn)
272 Whether to print the time of day along with any
273 other diagnostic messages. Default false.
275 s
\bsp
\bpl
\bla
\bas
\bsh
\bh (class B
\bBo
\boo
\bol
\ble
\bea
\ban
\bn)
276 Whether to display a splash screen at startup.
279 s
\bsp
\bpl
\bla
\bas
\bsh
\bhD
\bDu
\bur
\bra
\bat
\bti
\bio
\bon
\bn (class T
\bTi
\bim
\bme
\be)
280 How long the splash screen should remain visible;
283 h
\bhe
\bel
\blp
\bpU
\bUR
\bRL
\bL (class U
\bUR
\bRL
\bL)
284 The splash screen has a _
\bH_
\be_
\bl_
\bp button on it. When
285 you press it, it will display the web page indi-
286 cated here in your web browser.
288 l
\blo
\boa
\bad
\bdU
\bUR
\bRL
\bL (class L
\bLo
\boa
\bad
\bdU
\bUR
\bRL
\bL)
289 This is the shell command used to load a URL into
290 your web browser. The default setting will load
291 it into Netscape if it is already running, other-
292 wise, will launch a new Netscape looking at the
293 _
\bh_
\be_
\bl_
\bp_
\bU_
\bR_
\bL.
295 d
\bde
\bem
\bmo
\boC
\bCo
\bom
\bmm
\bma
\ban
\bnd
\bd (class D
\bDe
\bem
\bmo
\boC
\bCo
\bom
\bmm
\bma
\ban
\bnd
\bd)
296 This is the shell command run when the _
\bD_
\be_
\bm_
\bo button
297 on the splash window is pressed. It defaults to
298 _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br_
\b-_
\bd_
\be_
\bm_
\bo.
300 p
\bpr
\bre
\bef
\bfs
\bsC
\bCo
\bom
\bmm
\bma
\ban
\bnd
\bd (class P
\bPr
\bre
\bef
\bfs
\bsC
\bCo
\bom
\bmm
\bma
\ban
\bnd
\bd)
301 This is the shell command run when the _
\bP_
\br_
\be_
\bf_
\bs but-
302 ton on the splash window is pressed. It defaults
303 to _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br_
\b-_
\bd_
\be_
\bm_
\bo _
\b-_
\bp_
\br_
\be_
\bf_
\bs.
305 n
\bni
\bic
\bce
\be (class N
\bNi
\bic
\bce
\be)
306 The sub-processes created by _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br will be
307 ``niced'' to this level, so that they are given
308 lower priority than other processes on the system,
309 and don't increase the load unnecessarily. The
312 (Higher numbers mean lower priority; see n
\bni
\bic
\bce
\be(1)
315 f
\bfa
\bad
\bde
\be (class B
\bBo
\boo
\bol
\ble
\bea
\ban
\bn)
316 If this is true, then when the screensaver acti-
317 vates, the current contents of the screen will
318 fade to black instead of simply winking out. This
319 only works on displays with writable colormaps,
320 that is, if the screen's default visual is a Pseu-
321 doColor visual. A fade will also be done when
322 switching graphics hacks (when the _
\bc_
\by_
\bc_
\bl_
\be timer
323 expires.) Default: true.
328 X Version 11 20-Jun-99 (3.15) 5
334 XScreenSaver(1) XScreenSaver(1)
337 u
\bun
\bnf
\bfa
\bad
\bde
\be (class B
\bBo
\boo
\bol
\ble
\bea
\ban
\bn)
338 If this is true, then when the screensaver deacti-
339 vates, the original contents of the screen will
340 fade in from black instead of appearing immedi-
341 ately. This only works on displays with writable
342 colormaps, and if _
\bf_
\ba_
\bd_
\be is true as well. Default
345 f
\bfa
\bad
\bde
\beS
\bSe
\bec
\bco
\bon
\bnd
\bds
\bs (class T
\bTi
\bim
\bme
\be)
346 If _
\bf_
\ba_
\bd_
\be is true, this is how long the fade will be
347 in seconds (default 3 seconds.)
349 f
\bfa
\bad
\bde
\beT
\bTi
\bic
\bck
\bks
\bs (class I
\bIn
\bnt
\bte
\beg
\bge
\ber
\br)
350 If _
\bf_
\ba_
\bd_
\be is true, this is how many times a second
351 the colormap will be changed to effect a fade.
352 Higher numbers yield smoother fades, but may make
353 the fades take longer than the specified _
\bf_
\ba_
\bd_
\be_
\bS_
\be_
\bc_
\b-
354 _
\bo_
\bn_
\bd_
\bs if your server isn't fast enough to keep up.
357 c
\bca
\bap
\bpt
\btu
\bur
\bre
\beS
\bSt
\btd
\bde
\ber
\brr
\br (class B
\bBo
\boo
\bol
\ble
\bea
\ban
\bn)
358 Whether _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br should redirect its stdout
359 and stderr streams to the window itself. Since
360 its nature is to take over the screen, you would
361 not normally see error messages generated by
362 xscreensaver or the sub-programs it runs; this
363 resource will cause the output of all relevant
364 programs to be drawn on the screensaver window
365 itself, as well as being written to the control-
366 ling terminal of the screensaver driver process.
369 f
\bfo
\bon
\bnt
\bt (class F
\bFo
\bon
\bnt
\bt)
370 The font used for the stdout/stderr text, if c
\bca
\bap
\bp-
\b-
371 t
\btu
\bur
\bre
\beS
\bSt
\btd
\bde
\ber
\brr
\br is true. Default
372 *
\b*-
\b-m
\bme
\bed
\bdi
\biu
\bum
\bm-
\b-r
\br-
\b-*
\b*-
\b-1
\b14
\b40
\b0-
\b-*
\b*-
\b-m
\bm-
\b-*
\b* (a 14 point fixed-width
375 p
\bpr
\bro
\bog
\bgr
\bra
\bam
\bms
\bs (class P
\bPr
\bro
\bog
\bgr
\bra
\bam
\bms
\bs)
376 The graphics hacks which _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br runs when
377 the user is idle. The value of this resource is a
378 string, one _
\bs_
\bh-syntax command per line. Each line
379 must contain exactly one command: no semicolons,
382 When the screensaver starts up, one of these is
383 selected at random, and run. After the _
\bc_
\by_
\bc_
\bl_
\be
384 period expires, it is killed, and another is
387 If the value of this resource is empty, then no
388 programs will be run; the screen will simply be
394 X Version 11 20-Jun-99 (3.15) 6
400 XScreenSaver(1) XScreenSaver(1)
403 If the display has multiple screens, then a dif-
404 ferent program will be run for each screen. (All
405 screens are blanked and unblanked simultaniously.)
407 Note that you must escape the newlines; here is an
408 example of how you might set this in your
409 _
\b~_
\b/_
\b._
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br file:
414 ico -r -faces -sleep 1 -obj ico \n\
415 xdaliclock -builtin2 -root \n\
416 xv -root -rmode 5 image.gif -quit \n
418 Make sure your $
\b$P
\bPA
\bAT
\bTH
\bH environment variable is set
419 up correctly _
\bb_
\be_
\bf_
\bo_
\br_
\be xscreensaver is launched, or
420 it won't be able to find the programs listed in
421 the _
\bp_
\br_
\bo_
\bg_
\br_
\ba_
\bm_
\bs resource.
423 To use a program as a screensaver, two things are
424 required: that that program draw on the root win-
425 dow (or be able to be configured to draw on the
426 root window); and that that program understand
427 ``virtual root'' windows, as used by virtual win-
428 dow managers such as t
\btv
\bvt
\btw
\bwm
\bm(1). (Generally, this
429 is accomplished by just including the _
\b"_
\bv_
\br_
\bo_
\bo_
\bt_
\b._
\bh_
\b"
430 header file in the program's source.)
432 If there are some programs that you want to run
433 only when using a color display, and others that
434 you want to run only when using a monochrome dis-
435 play, you can specify that like this:
437 mono: mono-program -root \n\
438 color: color-program -root \n\
440 More generally, you can specify the kind of visual
441 that should be used for the window on which the
442 program will be drawing. For example, if one pro-
443 gram works best if it has a colormap, but another
444 works best if it has a 24-bit visual, both can be
447 PseudoColor: cmap-program -root \n\
448 TrueColor: 24bit-program -root \n\
450 In addition to the symbolic visual names described
451 above (in the discussion of the _
\bv_
\bi_
\bs_
\bu_
\ba_
\bl_
\bI_
\bD resource)
452 one other visual name is supported in the _
\bp_
\br_
\bo_
\bg_
\br_
\ba_
\bm_
\bs
455 d
\bde
\bef
\bfa
\bau
\bul
\blt
\bt-
\b-n
\bn
456 This is like d
\bde
\bef
\bfa
\bau
\bul
\blt
\bt, but also requests the
460 X Version 11 20-Jun-99 (3.15) 7
466 XScreenSaver(1) XScreenSaver(1)
469 use of the default colormap, instead of a
470 private colormap. (That is, it behaves as if
471 the _
\b-_
\bn_
\bo_
\b-_
\bi_
\bn_
\bs_
\bt_
\ba_
\bl_
\bl command-line option was spec-
472 ified, but only for this particular hack.)
473 This is provided because some third-party
474 programs that draw on the root window
475 (notably: x
\bxv
\bv(1), and x
\bxe
\bea
\bar
\brt
\bth
\bh(1)) make assump-
476 tions about the visual and colormap of the
477 root window: assumptions which xscreensaver
480 If you specify a particular visual for a program,
481 and that visual does not exist on the screen, then
482 that program will not be chosen to run. This
483 means that on displays with multiple screens of
484 different depths, you can arrange for appropriate
485 hacks to be run on each. For example, if one
486 screen is color and the other is monochrome, hacks
487 that look good in mono can be run on one, and
488 hacks that only look good in color will show up on
492 Normally you won't need to change the following resources:
495 p
\bpo
\boi
\bin
\bnt
\bte
\ber
\brP
\bPo
\bol
\bll
\blT
\bTi
\bim
\bme
\be (class T
\bTi
\bim
\bme
\be)
496 When server extensions are not in use, this con-
497 trols how frequently _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br checks to see if
498 the mouse position or buttons have changed.
501 w
\bwi
\bin
\bnd
\bdo
\bow
\bwC
\bCr
\bre
\bea
\bat
\bti
\bio
\bon
\bnT
\bTi
\bim
\bme
\beo
\bou
\but
\bt (class T
\bTi
\bim
\bme
\be)
502 When server extensions are not in use, this con-
503 trols the delay between when windows are created
504 and when _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br selects events on them.
507 i
\bin
\bni
\bit
\bti
\bia
\bal
\blD
\bDe
\bel
\bla
\bay
\by (class T
\bTi
\bim
\bme
\be)
508 When server extensions are not in use, _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\b-
509 _
\bs_
\ba_
\bv_
\be_
\br will wait this many seconds before selecting
510 events on existing windows, under the assumption
511 that _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br is started during your login
512 procedure, and the window state may be in flux.
513 Default 0. (This used to default to 30, but that
514 was back in the days when slow machines and X ter-
515 minals were more common...)
517 s
\bsg
\bgi
\biS
\bSa
\bav
\bve
\ber
\brE
\bEx
\bxt
\bte
\ben
\bns
\bsi
\bio
\bon
\bn (class B
\bBo
\boo
\bol
\ble
\bea
\ban
\bn)
518 There are a number of different X server exten-
519 sions which can make xscreensaver's job easier.
520 The next few resources specify whether these
521 extensions should be utilized if they are avail-
526 X Version 11 20-Jun-99 (3.15) 8
532 XScreenSaver(1) XScreenSaver(1)
535 This resource controls whether the SGI
536 S
\bSC
\bCR
\bRE
\bEE
\bEN
\bN_
\b_S
\bSA
\bAV
\bVE
\bER
\bR server extension will be used to
537 decide whether the user is idle. This is the
538 default if _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br has been compiled with
539 support for this extension (which is the default
540 on SGI systems.). If it is available, the
541 S
\bSC
\bCR
\bRE
\bEE
\bEN
\bN_
\b_S
\bSA
\bAV
\bVE
\bER
\bR method is faster and more reliable
542 than what will be done otherwise, so use it if you
543 can. (This extension is only available on Silicon
544 Graphics systems, unfortunately.)
546 m
\bmi
\bit
\btS
\bSa
\bav
\bve
\ber
\brE
\bEx
\bxt
\bte
\ben
\bns
\bsi
\bio
\bon
\bn (class B
\bBo
\boo
\bol
\ble
\bea
\ban
\bn)
547 This resource controls whether the
548 M
\bMI
\bIT
\bT-
\b-S
\bSC
\bCR
\bRE
\bEE
\bEN
\bN-
\b-S
\bSA
\bAV
\bVE
\bER
\bR server extension will be used to
549 decide whether the user is idle. However, the
550 default for this resource is _
\bf_
\ba_
\bl_
\bs_
\be, because even
551 if this extension is available, it is flaky (and
552 it also makes the f
\bfa
\bad
\bde
\be option not work properly.)
553 Use of this extension is not recommended.
555 x
\bxi
\bid
\bdl
\ble
\beE
\bEx
\bxt
\bte
\ben
\bns
\bsi
\bio
\bon
\bn (class B
\bBo
\boo
\bol
\ble
\bea
\ban
\bn)
556 This resource controls whether the X
\bXI
\bID
\bDL
\bLE
\bE server
557 extension will be used to decide whether the user
558 is idle. This is the default if _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br has
559 been compiled with support for this extension.
560 (This extension is only available for X11R4 and
561 X11R5 systems, unfortunately.)
563 p
\bpr
\bro
\boc
\bcI
\bIn
\bnt
\bte
\ber
\brr
\bru
\bup
\bpt
\bts
\bs (class B
\bBo
\boo
\bol
\ble
\bea
\ban
\bn)
564 This resource controls whether the /
\b/p
\bpr
\bro
\boc
\bc/
\b/i
\bin
\bnt
\bte
\ber
\br-
\b-
565 r
\bru
\bup
\bpt
\bts
\bs file should be consulted to decide whether
566 the user is idle. This is the default if _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\b-
567 _
\bs_
\ba_
\bv_
\be_
\br has been compiled on a system which supports
568 this mechanism (i.e., Linux systems.)
570 The benefit to doing this is that _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br can
571 note that the user is active even when the X con-
572 sole is not the active one: if the user is typing
573 in another virtual console, xscreensaver will
574 notice that and will fail to activate. For exam-
575 ple, if you're playing Quake in VGA-mode, xscreen-
576 saver won't wake up in the middle of your game and
577 start competing for CPU.
579 The drawback to doing this is that perhaps you
580 _
\br_
\be_
\ba_
\bl_
\bl_
\by _
\bd_
\bo want idleness on the X console to cause
581 the X display to lock, even if there is activity
582 on other virtual consoles. If you want that, then
583 set this option to False. (Or just lock the X
586 The default value for this resource is True, on
587 systems where it works.
592 X Version 11 20-Jun-99 (3.15) 9
598 XScreenSaver(1) XScreenSaver(1)
601 o
\bov
\bve
\ber
\brl
\bla
\bay
\byS
\bSt
\btd
\bde
\ber
\brr
\br (class B
\bBo
\boo
\bol
\ble
\bea
\ban
\bn)
602 If c
\bca
\bap
\bpt
\btu
\bur
\bre
\beS
\bSt
\btd
\bde
\ber
\brr
\br is True, and your server supports
603 ``overlay'' visuals, then the text will be written
604 into one of the higher layers instead of into the
605 same layer as the running screenhack. Set this to
606 False to disable that (though you shouldn't need
609 o
\bov
\bve
\ber
\brl
\bla
\bay
\byT
\bTe
\bex
\bxt
\btF
\bFo
\bor
\bre
\beg
\bgr
\bro
\bou
\bun
\bnd
\bd (class F
\bFo
\bor
\bre
\beg
\bgr
\bro
\bou
\bun
\bnd
\bd)
610 The foreground color used for the stdout/stderr
611 text, if c
\bca
\bap
\bpt
\btu
\bur
\bre
\beS
\bSt
\btd
\bde
\ber
\brr
\br is true. Default: Yellow.
613 o
\bov
\bve
\ber
\brl
\bla
\bay
\byT
\bTe
\bex
\bxt
\btB
\bBa
\bac
\bck
\bkg
\bgr
\bro
\bou
\bun
\bnd
\bd (class B
\bBa
\bac
\bck
\bkg
\bgr
\bro
\bou
\bun
\bnd
\bd)
614 The background color used for the stdout/stderr
615 text, if c
\bca
\bap
\bpt
\btu
\bur
\bre
\beS
\bSt
\btd
\bde
\ber
\brr
\br is true. Default: Black.
617 b
\bbo
\bou
\bur
\brn
\bne
\beS
\bSh
\bhe
\bel
\bll
\bl (class B
\bBo
\bou
\bur
\brn
\bne
\beS
\bSh
\bhe
\bel
\bll
\bl)
618 The pathname of the shell that _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br uses
619 to start subprocesses. This must be whatever your
620 local variant of /
\b/b
\bbi
\bin
\bn/
\b/s
\bsh
\bh is: in particular, it
621 must not be c
\bcs
\bsh
\bh.
623 C
\bCO
\bOM
\bMM
\bMA
\bAN
\bND
\bD-
\b-L
\bLI
\bIN
\bNE
\bE O
\bOP
\bPT
\bTI
\bIO
\bON
\bNS
\bS
624 _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br also accepts the following command line
625 options. Except for the _
\b-_
\bd_
\bi_
\bs_
\bp_
\bl_
\ba_
\by option, these command-
626 line options are all simply shorthand for the X resources
627 described in the _
\bC_
\bo_
\bn_
\bf_
\bi_
\bg_
\bu_
\br_
\ba_
\bt_
\bi_
\bo_
\bn section, above.
629 -
\b-d
\bdi
\bis
\bsp
\bpl
\bla
\bay
\by _
\bh_
\bo_
\bs_
\bt_
\b:_
\bd_
\bi_
\bs_
\bp_
\bl_
\ba_
\by_
\b._
\bs_
\bc_
\br_
\be_
\be_
\bn
630 The X display to use. For displays with multiple
631 screens, XScreenSaver will manage all screens on
632 the display simultaniously; the _
\bs_
\bc_
\br_
\be_
\be_
\bn argument
633 (the ``default'' screen) says which screen should
634 be used for dialog boxes (the password window,
635 _
\bD_
\be_
\bm_
\bo _
\bM_
\bo_
\bd_
\be, etc.)
637 -
\b-t
\bti
\bim
\bme
\beo
\bou
\but
\bt _
\bm_
\bi_
\bn_
\bu_
\bt_
\be_
\bs
638 Same as the _
\bt_
\bi_
\bm_
\be_
\bo_
\bu_
\bt resource.
640 -
\b-c
\bcy
\byc
\bcl
\ble
\be _
\bm_
\bi_
\bn_
\bu_
\bt_
\be_
\bs
641 Same as the _
\bc_
\by_
\bc_
\bl_
\be resource.
643 -
\b-l
\blo
\boc
\bck
\bk-
\b-m
\bmo
\bod
\bde
\be
644 Same as setting the _
\bl_
\bo_
\bc_
\bk resource to _
\bt_
\br_
\bu_
\be.
646 -
\b-n
\bno
\bo-
\b-l
\blo
\boc
\bck
\bk-
\b-m
\bmo
\bod
\bde
\be
647 Same as setting the _
\bl_
\bo_
\bc_
\bk resource to _
\bf_
\ba_
\bl_
\bs_
\be.
649 -
\b-l
\blo
\boc
\bck
\bk-
\b-t
\bti
\bim
\bme
\beo
\bou
\but
\bt _
\bm_
\bi_
\bn_
\bu_
\bt_
\be_
\bs
650 Same as the _
\bl_
\bo_
\bc_
\bk_
\bT_
\bi_
\bm_
\be_
\bo_
\bu_
\bt resource.
652 -
\b-v
\bvi
\bis
\bsu
\bua
\bal
\bl _
\bv_
\bi_
\bs_
\bu_
\ba_
\bl
653 Same as the _
\bv_
\bi_
\bs_
\bu_
\ba_
\bl_
\bI_
\bD resource.
658 X Version 11 20-Jun-99 (3.15) 10
664 XScreenSaver(1) XScreenSaver(1)
667 -
\b-i
\bin
\bns
\bst
\bta
\bal
\bll
\bl
668 Same as setting the _
\bi_
\bn_
\bs_
\bt_
\ba_
\bl_
\bl_
\bC_
\bo_
\bl_
\bo_
\br_
\bm_
\ba_
\bp resource to
671 -
\b-n
\bno
\bo-
\b-i
\bin
\bns
\bst
\bta
\bal
\bll
\bl
672 Same as setting the _
\bi_
\bn_
\bs_
\bt_
\ba_
\bl_
\bl_
\bC_
\bo_
\bl_
\bo_
\br_
\bm_
\ba_
\bp resource to
673 _
\bf_
\ba_
\bl_
\bs_
\be.
675 -
\b-v
\bve
\ber
\brb
\bbo
\bos
\bse
\be
676 Same as setting the _
\bv_
\be_
\br_
\bb_
\bo_
\bs_
\be resource to _
\bt_
\br_
\bu_
\be.
678 -
\b-s
\bsi
\bil
\ble
\ben
\bnt
\bt Same as setting the _
\bv_
\be_
\br_
\bb_
\bo_
\bs_
\be resource to _
\bf_
\ba_
\bl_
\bs_
\be.
680 -
\b-t
\bti
\bim
\bme
\bes
\bst
\bta
\bam
\bmp
\bp
681 Same as setting the _
\bt_
\bi_
\bm_
\be_
\bs_
\bt_
\ba_
\bm_
\bp resource to _
\bt_
\br_
\bu_
\be.
683 -
\b-c
\bca
\bap
\bpt
\btu
\bur
\bre
\be-
\b-s
\bst
\btd
\bde
\ber
\brr
\br
684 Same as setting the _
\bc_
\ba_
\bp_
\bt_
\bu_
\br_
\be_
\bS_
\bt_
\bd_
\be_
\br_
\br resource to
687 -
\b-n
\bno
\bo-
\b-c
\bca
\bap
\bpt
\btu
\bur
\bre
\be-
\b-s
\bst
\btd
\bde
\ber
\brr
\br
688 Same as setting the _
\bc_
\ba_
\bp_
\bt_
\bu_
\br_
\be_
\bS_
\bt_
\bd_
\be_
\br_
\br resource to
689 _
\bf_
\ba_
\bl_
\bs_
\be.
691 -
\b-s
\bsp
\bpl
\bla
\bas
\bsh
\bh Same as setting the _
\bs_
\bp_
\bl_
\ba_
\bs_
\bh resource to _
\bt_
\br_
\bu_
\be.
693 -
\b-n
\bno
\bo-
\b-s
\bsp
\bpl
\bla
\bas
\bsh
\bh
694 Same as setting the _
\bs_
\bp_
\bl_
\ba_
\bs_
\bh resource to _
\bf_
\ba_
\bl_
\bs_
\be.
696 -
\b-n
\bni
\bic
\bce
\be _
\bi_
\bn_
\bt_
\be_
\bg_
\be_
\br
697 Same as the _
\bn_
\bi_
\bc_
\be resource.
699 -
\b-s
\bsg
\bgi
\bi-
\b-e
\bex
\bxt
\bte
\ben
\bns
\bsi
\bio
\bon
\bn
700 Same as setting the _
\bs_
\bg_
\bi_
\bS_
\ba_
\bv_
\be_
\br_
\bE_
\bx_
\bt_
\be_
\bn_
\bs_
\bi_
\bo_
\bn resource to
703 -
\b-n
\bno
\bo-
\b-s
\bsg
\bgi
\bi-
\b-e
\bex
\bxt
\bte
\ben
\bns
\bsi
\bio
\bon
\bn
704 Same as setting the _
\bs_
\bg_
\bi_
\bS_
\ba_
\bv_
\be_
\br_
\bE_
\bx_
\bt_
\be_
\bn_
\bs_
\bi_
\bo_
\bn resource to
705 _
\bf_
\ba_
\bl_
\bs_
\be.
707 -
\b-m
\bmi
\bit
\bt-
\b-e
\bex
\bxt
\bte
\ben
\bns
\bsi
\bio
\bon
\bn
708 Same as setting the _
\bm_
\bi_
\bt_
\bS_
\ba_
\bv_
\be_
\br_
\bE_
\bx_
\bt_
\be_
\bn_
\bs_
\bi_
\bo_
\bn resource to
711 -
\b-n
\bno
\bo-
\b-m
\bmi
\bit
\bt-
\b-e
\bex
\bxt
\bte
\ben
\bns
\bsi
\bio
\bon
\bn
712 Same as setting the _
\bm_
\bi_
\bt_
\bS_
\ba_
\bv_
\be_
\br_
\bE_
\bx_
\bt_
\be_
\bn_
\bs_
\bi_
\bo_
\bn resource to
713 _
\bf_
\ba_
\bl_
\bs_
\be.
715 -
\b-x
\bxi
\bid
\bdl
\ble
\be-
\b-e
\bex
\bxt
\bte
\ben
\bns
\bsi
\bio
\bon
\bn
716 Same as setting the _
\bx_
\bi_
\bd_
\bl_
\be_
\bE_
\bx_
\bt_
\be_
\bn_
\bs_
\bi_
\bo_
\bn resource to
719 -
\b-n
\bno
\bo-
\b-x
\bxi
\bid
\bdl
\ble
\be-
\b-e
\bex
\bxt
\bte
\ben
\bns
\bsi
\bio
\bon
\bn
720 Same as setting the _
\bx_
\bi_
\bd_
\bl_
\be_
\bE_
\bx_
\bt_
\be_
\bn_
\bs_
\bi_
\bo_
\bn resource to
724 X Version 11 20-Jun-99 (3.15) 11
730 XScreenSaver(1) XScreenSaver(1)
733 _
\bf_
\ba_
\bl_
\bs_
\be.
735 -
\b-p
\bpr
\bro
\boc
\bc-
\b-i
\bin
\bnt
\bte
\ber
\brr
\bru
\bup
\bpt
\bts
\bs
736 Same as setting the _
\bp_
\br_
\bo_
\bc_
\bI_
\bn_
\bt_
\be_
\br_
\br_
\bu_
\bp_
\bt_
\bs resource to
739 -
\b-n
\bno
\bo-
\b-p
\bpr
\bro
\boc
\bc-
\b-i
\bin
\bnt
\bte
\ber
\brr
\bru
\bup
\bpt
\bts
\bs
740 Same as setting the _
\bp_
\br_
\bo_
\bc_
\bI_
\bn_
\bt_
\be_
\br_
\br_
\bu_
\bp_
\bt_
\bs resource to
741 _
\bf_
\ba_
\bl_
\bs_
\be.
743 -
\b-x
\bxr
\brm
\bm _
\br_
\be_
\bs_
\bo_
\bu_
\br_
\bc_
\be_
\b-_
\bs_
\bp_
\be_
\bc_
\bi_
\bf_
\bi_
\bc_
\ba_
\bt_
\bi_
\bo_
\bn
744 As with all other Xt programs, you can specify X
745 resources on the command-line using the _
\b-_
\bx_
\br_
\bm argu-
746 ment. Most of the interesting resources have com-
747 mand-line equivalents, however.
749 H
\bHO
\bOW
\bW I
\bIT
\bT W
\bWO
\bOR
\bRK
\bKS
\bS
750 When it is time to activate the screensaver, a full-screen
751 black window is created on each screen of the display.
752 Each window is created in such a way that, to any subse-
753 quently-created programs, it will appear to be a ``virtual
754 root'' window. Because of this, any program which draws
755 on the root window (and which understands virtual roots)
756 can be used as a screensaver.
758 When the user becomes active again, the screensaver win-
759 dows are unmapped, and the running subprocesses are killed
760 by sending them S
\bSI
\bIG
\bGT
\bTE
\bER
\bRM
\bM. This is also how the subpro-
761 cesses are killed when the screensaver decides that it's
762 time to run a different demo: the old one is killed and a
765 Before launching a subprocess, _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br stores an
766 appropriate value for $
\b$D
\bDI
\bIS
\bSP
\bPL
\bLA
\bAY
\bY in the environment that the
767 child will recieve. (This is so that if you start
768 _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br with a _
\b-_
\bd_
\bi_
\bs_
\bp_
\bl_
\ba_
\by argument, the programs which
769 _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br launches will draw on the same display; and
770 so that the child will end up drawing on the appropriate
771 screen of a multi-headed display.)
773 When the screensaver turns off, or is killed, care is
774 taken to restore the ``real'' virtual root window if there
775 is one. Because of this, it is important that you not
776 kill the screensaver process with _
\bk_
\bi_
\bl_
\bl _
\b-_
\b9 if you are run-
777 ning a virtual-root window manager. If you kill it with
778 -9, you may need to restart your window manager to repair
779 the damage. This isn't an issue if you aren't running a
780 virtual-root window manager.
782 For all the gory details, see the commentary at the top of
785 You can control a running screensaver process by using the
786 x
\bxs
\bsc
\bcr
\bre
\bee
\ben
\bns
\bsa
\bav
\bve
\ber
\br-
\b-c
\bco
\bom
\bmm
\bma
\ban
\bnd
\bd(1) program (which see.)
790 X Version 11 20-Jun-99 (3.15) 12
796 XScreenSaver(1) XScreenSaver(1)
799 P
\bPO
\bOW
\bWE
\bER
\bR M
\bMA
\bAN
\bNA
\bAG
\bGE
\bEM
\bME
\bEN
\bNT
\bT
800 Modern X servers contain support to power down the monitor
801 after an idle period. If the monitor has powered down,
802 then _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br will notice this, and will not waste CPU
803 by drawing graphics demos on a black screen. An attempt
804 will also be made to explicitly power the monitor back up
805 as soon as user activity is detected.
807 If your X server supports power management, then x
\bxs
\bse
\bet
\bt(1)
808 will accept a d
\bdp
\bpm
\bms
\bs option. So, if you wanted _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br
809 to activate after 5 minutes, but you wanted your monitor
810 to power down after one hour (3600 seconds) you would do
815 See the man page for the x
\bxs
\bse
\bet
\bt(1) program for details.
816 (Note that power management requires both software support
817 in the X server, and hardware support in the monitor
820 U
\bUS
\bSI
\bIN
\bNG
\bG X
\bXD
\bDM
\bM(
\b(1
\b1)
\b)
821 You can run _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br from your x
\bxd
\bdm
\bm(1) session, so that
822 the screensaver will run even when nobody is logged in on
825 The trick to using xscreensaver with _
\bx_
\bd_
\bm is this: keep in
826 mind the two very different states in which xscreensaver
829 1
\b1:
\b: N
\bNo
\bob
\bbo
\bod
\bdy
\by l
\blo
\bog
\bgg
\bge
\bed
\bd i
\bin
\bn.
\b.
831 If you're thinking of running xscreensaver from XDM
832 at all, then it's probably because you want graph-
833 ics demos to be running on the console when nobody
834 is logged in there. In this case, xscreensaver
835 will function only as a screen saver, not a screen
836 locker: it doesn't make sense for xscreensaver to
837 lock the screen, since nobody is logged in yet!
838 The only thing on the screen is the XDM login
841 2
\b2:
\b: S
\bSo
\bom
\bme
\beb
\bbo
\bod
\bdy
\by l
\blo
\bog
\bgg
\bge
\bed
\bd i
\bin
\bn.
\b.
843 Once someone has logged in through the XDM login
844 window, the situation is very different. For exam-
845 ple: now it makes sense to lock the screen (and
846 prompt for the logged in user's password); and now
847 xscreensaver should consult that user's _
\b~_
\b/_
\b._
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\b-
848 _
\bs_
\ba_
\bv_
\be_
\br file; and so on.
850 The difference between these two states comes down to a
851 question of, which user is the _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br process run-
852 ning as? For the first state, it doesn't matter. If you
856 X Version 11 20-Jun-99 (3.15) 13
862 XScreenSaver(1) XScreenSaver(1)
865 start _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br in the usual XDM way, then xscreensaver
866 will probably end up running as root, which is fine for
867 the first case (the ``nobody logged in'' case.)
869 However, once someone is logged in, running as root is no
870 longer fine: because xscreensaver will be consulting
871 root's _
\b._
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br file instead of that of the logged in
872 user, and won't be prompting for the logged in user's
873 password, and so on. (This is not a security problem,
874 it's just not what you want.)
876 So, once someone has logged in, you want xscreensaver to
877 be running as that user. The way to accomplish this is to
878 kill the old xscreensaver process and start a new one (as
881 The simplest way to accomplish all of this is as follows:
883 1
\b1:
\b: L
\bLa
\bau
\bun
\bnc
\bch
\bh x
\bxs
\bsc
\bcr
\bre
\bee
\ben
\bns
\bsa
\bav
\bve
\ber
\br b
\bbe
\bef
\bfo
\bor
\bre
\be a
\ban
\bny
\byo
\bon
\bne
\be l
\blo
\bog
\bgs
\bs i
\bin
\bn.
\b.
885 To the file _
\b/_
\bu_
\bs_
\br_
\b/_
\bl_
\bi_
\bb_
\b/_
\bX_
\b1_
\b1_
\b/_
\bx_
\bd_
\bm_
\b/_
\bX_
\bs_
\be_
\bt_
\bu_
\bp, add the lines
887 xscreensaver-command -exit
890 This will run xscreensaver as root, over the XDM
891 login window. Moving the mouse will cause the
892 screen to un-blank, and allow the user to type
893 their password at XDM to log in.
895 2
\b2:
\b: R
\bRe
\bes
\bst
\bta
\bar
\brt
\bt x
\bxs
\bsc
\bcr
\bre
\bee
\ben
\bns
\bsa
\bav
\bve
\ber
\br w
\bwh
\bhe
\ben
\bn s
\bso
\bom
\bme
\beo
\bon
\bne
\be l
\blo
\bog
\bgs
\bs i
\bin
\bn.
\b.
897 Near the top of the file _
\b/_
\bu_
\bs_
\br_
\b/_
\bl_
\bi_
\bb_
\b/_
\bX_
\b1_
\b1_
\b/_
\bx_
\bd_
\bm_
\b/_
\bX_
\bs_
\be_
\bs_
\bs_
\bi_
\bo_
\bn,
898 add those same lines:
900 xscreensaver-command -exit
903 When someone logs in, this will kill off the exist-
904 ing (root) xscreensaver process, and start a new
905 one, running as the user who has just logged in.
906 If the user's .xscreensaver file requests locking,
907 they'll get it. They will also get their own
908 choice of timeouts, and graphics demos, and so on.
910 Alternately, each user could just put those lines
911 in their personal _
\b~_
\b/_
\b._
\bx_
\bs_
\be_
\bs_
\bs_
\bi_
\bo_
\bn files.
913 Make sure you have $
\b$P
\bPA
\bAT
\bTH
\bH set up correctly in the _
\bX_
\bs_
\be_
\bt_
\bu_
\bp
914 and _
\bX_
\bs_
\be_
\bs_
\bs_
\bi_
\bo_
\bn scripts, or _
\bx_
\bd_
\bm won't be able to find
915 _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br, and/or _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br won't be able to find
918 (If your system does not seem to be executing the _
\bX_
\bs_
\be_
\bt_
\bu_
\bp
922 X Version 11 20-Jun-99 (3.15) 14
928 XScreenSaver(1) XScreenSaver(1)
931 file, you may need to configure it to do so: the tradi-
932 tional way to do this is to make that file the value of
933 the _
\bD_
\bi_
\bs_
\bp_
\bl_
\ba_
\by_
\bM_
\ba_
\bn_
\ba_
\bg_
\be_
\br_
\b*_
\bs_
\be_
\bt_
\bu_
\bp resource in the
934 _
\b/_
\bu_
\bs_
\br_
\b/_
\bl_
\bi_
\bb_
\b/_
\bX_
\b1_
\b1_
\b/_
\bx_
\bd_
\bm_
\b/_
\bx_
\bd_
\bm_
\b-_
\bc_
\bo_
\bn_
\bf_
\bi_
\bg file. See the man page for
935 x
\bxd
\bdm
\bm(1) for more details.)
937 It is safe to run _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br as root (as _
\bx_
\bd_
\bm is likely
938 to do.) If run as root, _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br changes its effec-
939 tive user and group ids to something safe (like _
\b"_
\bn_
\bo_
\bb_
\bo_
\bd_
\by_
\b")
940 before connecting to the X server or launching user-speci-
943 An unfortunate side effect of this (important) security
944 precaution is that it may conflict with cookie-based
947 If you get "connection refused" errors when running
948 _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br from _
\bx_
\bd_
\bm, then this probably means that you
949 have x
\bxa
\bau
\but
\bth
\bh(1) or some other security mechanism turned on.
950 One way around this is to add "
\b"x
\bxh
\bho
\bos
\bst
\bt +
\b+l
\blo
\boc
\bca
\bal
\blh
\bho
\bos
\bst
\bt"
\b" to
951 _
\bX_
\bs_
\be_
\bt_
\bu_
\bp, just before _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br is launched.
953 Note that this will give access to the X server to anyone
954 capable of logging in to the local machine, so in some
955 environments, this might not be appropriate. If turning
956 off file-system-based access control is not acceptable,
957 then running _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br from the _
\bX_
\bs_
\be_
\bt_
\bu_
\bp file might not
958 be possible, and xscreensaver will only work when running
959 as a normal, unprivileged user.
961 For more information on the X server's access control
962 mechanisms, see the man pages for X
\bX(1), X
\bXs
\bse
\bec
\bcu
\bur
\bri
\bit
\bty
\by(1),
963 x
\bxa
\bau
\but
\bth
\bh(1), and x
\bxh
\bho
\bos
\bst
\bt(1).
965 U
\bUS
\bSI
\bIN
\bNG
\bG C
\bCD
\bDE
\bE (
\b(C
\bCO
\bOM
\bMM
\bMO
\bON
\bN D
\bDE
\bES
\bSK
\bKT
\bTO
\bOP
\bP E
\bEN
\bNV
\bVI
\bIR
\bRO
\bON
\bNM
\bME
\bEN
\bNT
\bT)
\b)
966 The easiest way to use _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br on a system with CDE
967 is to simply switch off the built-in CDE screensaver, and
968 use _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br instead; and second, to tell the front
969 panel to run x
\bxs
\bsc
\bcr
\bre
\bee
\ben
\bns
\bsa
\bav
\bve
\ber
\br-
\b-c
\bco
\bom
\bmm
\bma
\ban
\bnd
\bd(1) with the _
\b-_
\bl_
\bo_
\bc_
\bk option
970 when the _
\bL_
\bo_
\bc_
\bk icon is clicked.
972 To accomplish this involves five steps:
974 1
\b1:
\b: S
\bSw
\bwi
\bit
\btc
\bch
\bh o
\bof
\bff
\bf C
\bCD
\bDE
\bE'
\b's
\bs l
\blo
\boc
\bck
\bke
\ber
\br
975 Do this by turning off ``_
\bS_
\bc_
\br_
\be_
\be_
\bn _
\bS_
\ba_
\bv_
\be_
\br _
\ba_
\bn_
\bd _
\bS_
\bc_
\br_
\be_
\be_
\bn
976 _
\bL_
\bo_
\bc_
\bk'' in the Screen section of the Style Manager.
978 2
\b2:
\b: E
\bEd
\bdi
\bit
\bt s
\bse
\bes
\bss
\bsi
\bio
\bon
\bne
\bet
\btc
\bc
979 Edit the file _
\b~_
\b/_
\b._
\bd_
\bt_
\b/_
\bs_
\be_
\bs_
\bs_
\bi_
\bo_
\bn_
\bs_
\b/_
\bs_
\be_
\bs_
\bs_
\bi_
\bo_
\bn_
\be_
\bt_
\bc and add to
984 This will cause _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br to be launched when
988 X Version 11 20-Jun-99 (3.15) 15
994 XScreenSaver(1) XScreenSaver(1)
997 you log in. (As always, make sure that xscreen-
998 saver and the graphics demos are on your $
\b$P
\bPA
\bAT
\bTH
\bH; the
999 path needs to be set in _
\b._
\bc_
\bs_
\bh_
\br_
\bc and/or _
\b._
\bd_
\bt_
\bp_
\br_
\bo_
\bf_
\bi_
\bl_
\be,
1000 not _
\b._
\bl_
\bo_
\bg_
\bi_
\bn.)
1002 3
\b3:
\b: C
\bCr
\bre
\bea
\bat
\bte
\be X
\bXS
\bSc
\bcr
\bre
\bee
\ben
\bnS
\bSa
\bav
\bve
\ber
\br.
\b.d
\bdt
\bt
1003 Create a file called _
\b~_
\b/_
\b._
\bd_
\bt_
\b/_
\bt_
\by_
\bp_
\be_
\bs_
\b/_
\bX_
\bS_
\bc_
\br_
\be_
\be_
\bn_
\bS_
\ba_
\bv_
\be_
\br_
\b._
\bd_
\bt
1004 with the following contents:
1010 EXEC_STRING xscreensaver-command -lock
1012 WINDOW_TYPE NO_STDIO
1015 This defines a ``lock'' command for the CDE front
1016 panel, that knows how to talk to _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br.
1018 4
\b4:
\b: C
\bCr
\bre
\bea
\bat
\bte
\be L
\bLo
\boc
\bck
\bk.
\b.f
\bfp
\bp
1019 Create a file called _
\b~_
\b/_
\b._
\bd_
\bt_
\b/_
\bt_
\by_
\bp_
\be_
\bs_
\b/_
\bL_
\bo_
\bc_
\bk_
\b._
\bf_
\bp with the
1025 CONTAINER_NAME Switch
1026 CONTAINER_TYPE SWITCH
1030 PUSH_ACTION XScreenSaver
1031 HELP_TOPIC FPOnItemLock
1035 This associates the CDE front panel ``Lock'' icon
1036 with the lock command we just defined in step 3.
1038 5
\b5:
\b: R
\bRe
\bes
\bst
\bta
\bar
\brt
\bt
1039 Select ``_
\bR_
\be_
\bs_
\bt_
\ba_
\br_
\bt _
\bW_
\bo_
\br_
\bk_
\bs_
\bp_
\ba_
\bc_
\be _
\bM_
\ba_
\bn_
\ba_
\bg_
\be_
\br'' from the popup
1040 menu to make your changes take effect. If things
1041 seem not to be working, check the file _
\b~_
\b/_
\b._
\bd_
\bt_
\b/_
\be_
\br_
\br_
\bo_
\br_
\b-
1042 _
\bl_
\bo_
\bg for error messages.
1044 U
\bUS
\bSI
\bIN
\bNG
\bG H
\bHP
\bP V
\bVU
\bUE
\bE (
\b(V
\bVI
\bIS
\bSU
\bUA
\bAL
\bL U
\bUS
\bSE
\bER
\bR E
\bEN
\bNV
\bVI
\bIR
\bRO
\bON
\bNM
\bME
\bEN
\bNT
\bT)
\b)
1045 Since CDE is a descendant of VUE, the instructions for
1046 using xscreensaver under VUE are similar to the above:
1048 1
\b1:
\b: S
\bSw
\bwi
\bit
\btc
\bch
\bh o
\bof
\bff
\bf V
\bVU
\bUE
\bE'
\b's
\bs l
\blo
\boc
\bck
\bke
\ber
\br
1049 Open the ``_
\bS_
\bt_
\by_
\bl_
\be _
\bM_
\ba_
\bn_
\ba_
\bg_
\be_
\br'' and select ``_
\bS_
\bc_
\br_
\be_
\be_
\bn.''
1050 Turn off ``_
\bS_
\bc_
\br_
\be_
\be_
\bn _
\bS_
\ba_
\bv_
\be_
\br _
\ba_
\bn_
\bd _
\bS_
\bc_
\br_
\be_
\be_
\bn _
\bL_
\bo_
\bc_
\bk'' option.
1054 X Version 11 20-Jun-99 (3.15) 16
1060 XScreenSaver(1) XScreenSaver(1)
1063 2
\b2:
\b: M
\bMa
\bak
\bke
\be s
\bsu
\bur
\bre
\be y
\byo
\bou
\bu h
\bha
\bav
\bve
\be a
\ba S
\bSe
\bes
\bss
\bsi
\bio
\bon
\bn
1064 Next, go to the Style Manager's, ``_
\bS_
\bt_
\ba_
\br_
\bt_
\bu_
\bp'' page.
1065 Click on ``_
\bS_
\be_
\bt _
\bH_
\bo_
\bm_
\be _
\bS_
\be_
\bs_
\bs_
\bi_
\bo_
\bn'' to create a session,
1066 then on ``_
\bR_
\be_
\bt_
\bu_
\br_
\bn _
\bt_
\bo _
\bH_
\bo_
\bm_
\be _
\bS_
\be_
\bs_
\bs_
\bi_
\bo_
\bn'' to select this
1067 session each time you log in.
1069 3
\b3:
\b: E
\bEd
\bdi
\bit
\bt v
\bvu
\bue
\be.
\b.s
\bse
\bes
\bss
\bsi
\bio
\bon
\bn
1070 Edit the file _
\b~_
\b/_
\b._
\bv_
\bu_
\be_
\b/_
\bs_
\be_
\bs_
\bs_
\bi_
\bo_
\bn_
\bs_
\b/_
\bh_
\bo_
\bm_
\be_
\b/_
\bv_
\bu_
\be_
\b._
\bs_
\be_
\bs_
\bs_
\bi_
\bo_
\bn and
1073 vuesmcmd -screen 0 -cmd "xscreensaver"
1075 This will cause _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br to be launched when
1076 you log in. (As always, make sure that xscreen-
1077 saver and the graphics demos are on your $
\b$P
\bPA
\bAT
\bTH
\bH; the
1078 path needs to be set in _
\b._
\bc_
\bs_
\bh_
\br_
\bc and/or _
\b._
\bp_
\br_
\bo_
\bf_
\bi_
\bl_
\be, not
1079 _
\b._
\bl_
\bo_
\bg_
\bi_
\bn.)
1081 3
\b3:
\b: E
\bEd
\bdi
\bit
\bt v
\bvu
\bue
\bew
\bwm
\bmr
\brc
\bc
1082 Edit the file _
\b~_
\b/_
\b._
\bv_
\bu_
\be_
\b/_
\bv_
\bu_
\be_
\bw_
\bm_
\br_
\bc and add (or change)
1089 PUSH_ACTION f.exec "xscreensaver-command -lock"
1093 This associates the VUE front panel ``Lock'' icon
1094 with the xscreensaver lock command.
1097 A
\bAD
\bDD
\bDI
\bIN
\bNG
\bG T
\bTO
\bO M
\bME
\bEN
\bNU
\bUS
\bS
1098 The x
\bxs
\bsc
\bcr
\bre
\bee
\ben
\bns
\bsa
\bav
\bve
\ber
\br-
\b-c
\bco
\bom
\bmm
\bma
\ban
\bnd
\bd(1) program is a perfect candidate
1099 for something to add to your window manager's popup menus.
1100 If you use m
\bmw
\bwm
\bm(1), 4
\b4D
\bDw
\bwm
\bm(1), t
\btw
\bwm
\bm(1), or (probably) any of
1101 _
\bt_
\bw_
\bm's many descendants, you can do it like this:
1103 1
\b1.
\b. C
\bCr
\bre
\bea
\bat
\bte
\be ~
\b~/
\b/.
\b.m
\bmw
\bwm
\bmr
\brc
\bc (
\b(o
\bor
\br ~
\b~/
\b/.
\b.t
\btw
\bwm
\bmr
\brc
\bc o
\bor
\br .
\b..
\b..
\b.)
\b)
1104 If you don't have a _
\b~_
\b/_
\b._
\bm_
\bw_
\bm_
\br_
\bc file (or, on SGIs, a
1105 _
\b~_
\b/_
\b._
\b4_
\bD_
\bw_
\bm_
\br_
\bc file; or, with twm, a _
\b~_
\b/_
\b._
\bt_
\bw_
\bm_
\br_
\bc file) then
1106 create one by making a copy of the _
\b/_
\bu_
\bs_
\br_
\b/_
\bl_
\bi_
\bb_
\b/_
\bX_
\b1_
\b1_
\b/_
\bs_
\by_
\bs_
\b-
1107 _
\bt_
\be_
\bm_
\b._
\bm_
\bw_
\bm_
\br_
\bc file (or _
\b/_
\bu_
\bs_
\br_
\b/_
\bl_
\bi_
\bb_
\b/_
\bX_
\b1_
\b1_
\b/_
\bt_
\bw_
\bm_
\b/_
\bs_
\by_
\bs_
\bt_
\be_
\bm_
\b._
\bt_
\bw_
\bm_
\br_
\bc, and
1110 2
\b2.
\b. A
\bAd
\bdd
\bd a
\ba m
\bme
\ben
\bnu
\bu d
\bde
\bef
\bfi
\bin
\bni
\bit
\bti
\bio
\bon
\bn.
\b.
1111 Something like this:
1115 "Blank Screen Now" !"sleep 3; xscreensaver-command -activate"
1116 "Lock Screen Now" !"sleep 3; xscreensaver-command -lock"
1120 X Version 11 20-Jun-99 (3.15) 17
1126 XScreenSaver(1) XScreenSaver(1)
1129 "Screen Saver Demo" !"xscreensaver-demo"
1130 "Screen Saver Preferences" !"xscreensaver-demo -prefs"
1131 "Reinitialize Screen Saver" !"xscreensaver-command -restart"
1132 "Kill Screen Saver" !"xscreensaver-command -exit"
1133 "Launch Screen Saver" !"xscreensaver &"
1137 3
\b3.
\b. A
\bAd
\bdd
\bd t
\bth
\bhe
\be m
\bme
\ben
\bnu
\bu
1138 For m
\bmw
\bwm
\bm(1) and 4
\b4D
\bDw
\bwm
\bm(1), find the section of the file
1139 that says _
\bM_
\be_
\bn_
\bu _
\bD_
\be_
\bf_
\ba_
\bu_
\bl_
\bt_
\bR_
\bo_
\bo_
\bt_
\bM_
\be_
\bn_
\bu. For t
\btw
\bwm
\bm(1), it will
1140 probably be _
\bm_
\be_
\bn_
\bu _
\b"_
\bd_
\be_
\bf_
\bo_
\bp_
\bs_
\b". If you add a line somewhere
1141 in that menu definition that reads
1143 "XScreenSaver" f.menu XScreenSaver
1145 then this will add an XScreenSaver sub-menu to your
1146 default root-window popup menu. Alternately, you could
1147 just put the xscreensaver menu items directly into the
1150 Other window managers are guaranteed to do things gratu-
1151 itously differently.
1154 Bugs? There are no bugs. Ok, well, maybe. If you find
1155 one, please let me know. http://www.jwz.org/xscreen-
1156 saver/bugs.html explains how to construct the most useful
1159 L
\bLo
\boc
\bck
\bki
\bin
\bng
\bg a
\ban
\bnd
\bd X
\bXD
\bDM
\bM
1160 If xscreensaver has been launched from x
\bxd
\bdm
\bm(1)
1161 before anyone has logged in, you will need to kill
1162 and then restart the xscreensaver daemon after you
1163 have logged in, or you will be confused by the
1164 results. (For example, locking won't work, and
1165 your _
\b~_
\b/_
\b._
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br file will be ignored.)
1167 When you are logged in, you want the _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br
1168 daemon to be running under _
\by_
\bo_
\bu_
\br user id, not as
1169 root or some other user.
1171 If it has already been started by _
\bx_
\bd_
\bm, you can
1172 kill it by sending it the e
\bex
\bxi
\bit
\bt command, and then
1173 re-launching it as you, by putting something like
1174 the following in your personal X startup script:
1176 xscreensaver-command -exit
1179 The ``_
\bU_
\bs_
\bi_
\bn_
\bg _
\bX_
\bD_
\bM_
\b(_
\b1_
\b)'' section, above, goes into
1180 more detail, and explains how to configure the
1181 system to do this for all users automatically.
1186 X Version 11 20-Jun-99 (3.15) 18
1192 XScreenSaver(1) XScreenSaver(1)
1195 L
\bLo
\boc
\bck
\bki
\bin
\bng
\bg a
\ban
\bnd
\bd r
\bro
\boo
\bot
\bt l
\blo
\bog
\bgi
\bin
\bns
\bs
1196 In order for it to be safe for xscreensaver to be
1197 launched by _
\bx_
\bd_
\bm, certain precautions had to be
1198 taken, among them that xscreensaver never runs as
1199 _
\br_
\bo_
\bo_
\bt. In particular, if it is launched as root
1200 (as _
\bx_
\bd_
\bm is likely to do), xscreensaver will dis-
1201 avow its privileges, and switch itself to a safe
1202 user id (such as _
\bn_
\bo_
\bb_
\bo_
\bd_
\by.)
1204 An implication of this is that if you log in as
1205 _
\br_
\bo_
\bo_
\bt on the console, xscreensaver will refuse to
1206 lock the screen (because it can't tell the differ-
1207 ence between _
\br_
\bo_
\bo_
\bt being logged in on the console,
1208 and a normal user being logged in on the console
1209 but xscreensaver having been launched by the
1210 x
\bxd
\bdm
\bm(1) _
\bX_
\bs_
\be_
\bt_
\bu_
\bp file.)
1212 The solution to this is simple: you shouldn't be
1213 logging in on the console as _
\br_
\bo_
\bo_
\bt in the first
1214 place! (What, are you crazy or something?)
1216 Proper Unix hygiene dictates that you should log
1217 in as yourself, and s
\bsu
\bu(1) to _
\br_
\bo_
\bo_
\bt as necessary.
1218 People who spend their day logged in as _
\br_
\bo_
\bo_
\bt are
1219 just begging for disaster.
1221 X
\bXA
\bAU
\bUT
\bTH
\bH a
\ban
\bnd
\bd X
\bXD
\bDM
\bM
1222 For xscreensaver to work when launched by x
\bxd
\bdm
\bm(1),
1223 programs running on the local machine as user
1224 _
\b"_
\bn_
\bo_
\bb_
\bo_
\bd_
\by_
\b" must be able to connect to the X server.
1225 This means that if you want to run xscreensaver on
1226 the console while nobody is logged in, you may
1227 need to disable cookie-based access control (and
1228 allow all users who can log in to the local
1229 machine to connect to the display.)
1231 You should be sure that this is an acceptable
1232 thing to do in your environment before doing it.
1233 See the ``_
\bU_
\bs_
\bi_
\bn_
\bg _
\bX_
\bD_
\bM_
\b(_
\b1_
\b)'' section, above, for more
1236 If anyone has suggestions on how xscreensaver
1237 could be made to work with x
\bxd
\bdm
\bm(1) without first
1238 turning off _
\b._
\bX_
\ba_
\bu_
\bt_
\bh_
\bo_
\br_
\bi_
\bt_
\by-based access control,
1241 P
\bPa
\bas
\bss
\bsw
\bwo
\bor
\brd
\bds
\bs
1242 If you get an error message at startup like
1243 ``couldn't get password of _
\bu_
\bs_
\be_
\br'' then this proba-
1244 bly means that you're on a system in which the
1245 g
\bge
\bet
\btp
\bpw
\bwe
\ben
\bnt
\bt(3) library routine can only be effec-
1246 tively used by root. If this is the case, then
1247 _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br must be installed as setuid to root
1248 in order for locking to work. Care has been taken
1252 X Version 11 20-Jun-99 (3.15) 19
1258 XScreenSaver(1) XScreenSaver(1)
1261 to make this a safe thing to do.
1263 It also may mean that your system uses shadow
1264 passwords instead of the standard g
\bge
\bet
\btp
\bpw
\bwe
\ben
\bnt
\bt(3)
1265 interface; in that case, you may need to change
1266 some options with _
\bc_
\bo_
\bn_
\bf_
\bi_
\bg_
\bu_
\br_
\be and recompile.
1268 If you change your password after xscreensaver has
1269 been launched, it will continue using your old
1270 password to unlock the screen until xscreensaver
1271 is restarted. So, after you change your password,
1274 xscreensaver-command -restart
1276 to make _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br notice.
1278 P
\bPA
\bAM
\bM P
\bPa
\bas
\bss
\bsw
\bwo
\bor
\brd
\bds
\bs
1279 If your system uses PAM (Pluggable Authentication
1280 Modules), then in order for xscreensaver to use
1281 PAM properly, PAM must be told about xscreensaver.
1282 The xscreensaver installation process should
1283 update the PAM data (on Linux, by creating the
1284 file _
\b/_
\be_
\bt_
\bc_
\b/_
\bp_
\ba_
\bm_
\b._
\bd_
\b/_
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br for you, and on
1285 Solaris, by telling you what lines to add to the
1286 _
\b/_
\be_
\bt_
\bc_
\b/_
\bp_
\ba_
\bm_
\b._
\bc_
\bo_
\bn_
\bf file.)
1288 If the PAM configuration files do not know about
1289 xscreensaver, then you _
\bm_
\bi_
\bg_
\bh_
\bt be in a situation
1290 where xscreensaver will refuse to ever unlock the
1293 This is a design flaw in PAM (there is no way for
1294 a client to tell the difference between PAM
1295 responding ``I have never heard of your module,''
1296 and responding, ``you typed the wrong password.'')
1297 As far as I can tell, there is no way for xscreen-
1298 saver to automatically work around this, or detect
1299 the problem in advance, so if you have PAM, make
1300 sure it is configured correctly!
1302 C
\bCo
\bol
\blo
\bor
\brm
\bma
\bap
\bp l
\blo
\bos
\bss
\bsa
\bag
\bge
\be:
\b: T
\bTW
\bWM
\bM
1303 The i
\bin
\bns
\bst
\bta
\bal
\bll
\blC
\bCo
\bol
\blo
\bor
\brm
\bma
\bap
\bp option doesn't work very well
1304 with the t
\btw
\bwm
\bm(1) window manager and its descen-
1307 There is a race condition between the screensaver
1308 and this window manager, which can result in the
1309 screensaver's colormap not getting installed prop-
1310 erly, meaning the graphics hacks will appear in
1311 essentially random colors. (If the screen goes
1312 white instead of black, this is probably why.)
1314 The m
\bmw
\bwm
\bm(1) and o
\bol
\blw
\bwm
\bm(1) window managers don't have
1318 X Version 11 20-Jun-99 (3.15) 20
1324 XScreenSaver(1) XScreenSaver(1)
1327 this problem. The race condition exists because X
1328 (really, ICCCM) does not provide a way for an
1329 OverrideRedirect window to have its own colormap,
1330 short of grabbing the server (which is neither a
1331 good idea, nor really possible with the current
1332 design.) What happens is that, as soon as
1333 xscreensaver installs its colormap, t
\btw
\bwm
\bm responds
1334 to the resultant C
\bCo
\bol
\blo
\bor
\brm
\bma
\bap
\bpN
\bNo
\bot
\bti
\bif
\bfy
\by event by re-
1335 instaling the default colormap. Apparently, t
\btw
\bwm
\bm
1336 doesn't _
\ba_
\bl_
\bw_
\ba_
\by_
\bs do this; it seems to do it regu-
1337 larly if the screensaver is activated from a menu
1338 item, but seems to not do it if the screensaver
1339 comes on of its own volition, or is activated from
1342 A
\bAt
\btt
\bte
\ben
\bnt
\bti
\bio
\bon
\bn,
\b, w
\bwi
\bin
\bnd
\bdo
\bow
\bw m
\bma
\ban
\bna
\bag
\bge
\ber
\br a
\bau
\but
\bth
\bho
\bor
\brs
\bs!
\b!
1343 You should only call X
\bXI
\bIn
\bns
\bst
\bta
\bal
\bll
\blC
\bCo
\bol
\blo
\bor
\brm
\bma
\bap
\bp(3) in
1344 response to user events. That is, it is
1345 appropriate to install a colormap in response
1346 to F
\bFo
\boc
\bcu
\bus
\bsI
\bIn
\bn, F
\bFo
\boc
\bcu
\bus
\bsO
\bOu
\but
\bt, E
\bEn
\bnt
\bte
\ber
\brN
\bNo
\bot
\bti
\bif
\bfy
\by, and
1347 L
\bLe
\bea
\bav
\bve
\beN
\bNo
\bot
\bti
\bif
\bfy
\by events; but it is not appropriate
1348 to call it in response to C
\bCo
\bol
\blo
\bor
\brm
\bma
\bap
\bpN
\bNo
\bot
\bti
\bif
\bfy
\by
1349 events. If you install colormaps in response
1350 to _
\ba_
\bp_
\bp_
\bl_
\bi_
\bc_
\ba_
\bt_
\bi_
\bo_
\bn actions as well as in response
1351 to _
\bu_
\bs_
\be_
\br actions, then you create the situation
1352 where it is impossible for override-redirect
1353 applications (such as xscreensaver) to display
1354 their windows in the proper colors.
1356 C
\bCo
\bol
\blo
\bor
\brm
\bma
\bap
\bp l
\blo
\bos
\bss
\bsa
\bag
\bge
\be:
\b: X
\bXV
\bV,
\b, X
\bXA
\bAn
\bni
\bim
\bm,
\b, X
\bXE
\bEa
\bar
\brt
\bth
\bh
1357 Some programs don't operate properly on visuals
1358 other than the default one, or with colormaps
1359 other than the default one. See the discussion of
1360 the magic "default-n" visual name in the descrip-
1361 tion of the p
\bpr
\bro
\bog
\bgr
\bra
\bam
\bms
\bs resource in the _
\bC_
\bo_
\bn_
\bf_
\bi_
\bg_
\bu_
\br_
\ba_
\bt_
\bi_
\bo_
\bn
1362 section. When programs only work with the default
1363 colormap, you need to use a syntax like this:
1365 default-n: xv -root image-1.gif -quit \n\
1366 default-n: xearth -nostars -wait 0 \n\
1368 It would also work to turn off the i
\bin
\bns
\bst
\bta
\bal
\bll
\blC
\bCo
\bol
\blo
\bor
\brm
\bma
\bap
\bp
1369 option altogether, but that would deny extra col-
1370 ors to those programs that _
\bc_
\ba_
\bn take advantage of
1373 M
\bMa
\bac
\bch
\bhi
\bin
\bne
\be L
\bLo
\boa
\bad
\bd
1374 Although this program ``nices'' the subprocesses
1375 that it starts, graphics-intensive subprograms can
1376 still overload the machine by causing the X server
1377 process itself (which is not ``niced'') to suck a
1378 lot of cycles. Care should be taken to slow down
1379 programs intended for use as screensavers by
1380 inserting strategic calls to s
\bsl
\ble
\bee
\bep
\bp(3) or u
\bus
\bsl
\ble
\bee
\bep
\bp(3)
1384 X Version 11 20-Jun-99 (3.15) 21
1390 XScreenSaver(1) XScreenSaver(1)
1393 (or making liberal use of any _
\b-_
\bd_
\be_
\bl_
\ba_
\by options which
1394 the programs may provide.)
1396 Note that the OpenGL-based graphics demos are real
1397 pigs on machines that don't have texture hardware.
1399 Also, an active screensaver will cause your X
1400 server to be pretty much permanently swapped in;
1401 but the same is true of any program that draws
1402 periodically, like x
\bxc
\bcl
\blo
\boc
\bck
\bk(1) or x
\bxl
\blo
\boa
\bad
\bd(1).
1404 L
\bLa
\bat
\bte
\ben
\bnc
\bcy
\by a
\ban
\bnd
\bd R
\bRe
\bes
\bsp
\bpo
\bon
\bns
\bsi
\biv
\bve
\ben
\bne
\bes
\bss
\bs
1405 If the subprocess is drawing too quickly and the
1406 connection to the X server is a slow one (such as
1407 an X terminal running over a phone line) then the
1408 screensaver might not turn off right away when the
1409 user becomes active again (the i
\bic
\bco
\bo(1) demo has
1410 this problem if being run in full-speed mode).
1411 This can be alleviated by inserting strategic
1412 calls to X
\bXS
\bSy
\byn
\bnc
\bc(3) in code intended for use as a
1413 screensaver. This prevents too much graphics
1414 activity from being buffered up.
1416 X
\bXF
\bFr
\bre
\bee
\be8
\b86
\b6'
\b's
\bs M
\bMa
\bag
\bgi
\bic
\bc K
\bKe
\bey
\bys
\bst
\btr
\bro
\bok
\bke
\bes
\bs
1417 The XFree86 X server traps certain magic
1418 keystrokes before client programs ever see them.
1419 Two that are of note are Ctrl+Alt+Backspace, which
1420 causes the X server to exit; and Ctrl+Alt+F_
\bn,
1421 which switches virtual consoles. The X server
1422 will respond to these keystrokes even if xscreen-
1423 saver has the screen locked. Depending on your
1424 setup, you might consider this a problem.
1426 Unfortunately, there is no way for xscreensaver
1427 itself to override the interpretation of these
1428 keys. If you want to disable Ctrl+Alt+Backspace
1429 globally, you need to set the _
\bD_
\bo_
\bn_
\bt_
\bZ_
\ba_
\bp flag in your
1430 _
\b/_
\be_
\bt_
\bc_
\b/_
\bX_
\b1_
\b1_
\b/_
\bX_
\bF_
\b8_
\b6_
\bC_
\bo_
\bn_
\bf_
\bi_
\bg file. See the X
\bXF
\bF8
\b86
\b6C
\bCo
\bon
\bnf
\bfi
\big
\bg(5)
1433 There is no way (as far as I can tell) to disable
1434 the VT-switching keystrokes.
1436 Some Linux systems come with a VT_LOCKSWITCH
1437 ioctl, that one could theoretically use to prevent
1438 VT-switching while the screen is locked; but
1439 unfortunately, this ioctl can only be used by
1440 root, which means that xscreensaver can't use it
1441 (since xscreensaver disavows its privileges
1442 shortly after startup, for security reasons.)
1444 Any suggestions for other solutions to this prob-
1450 X Version 11 20-Jun-99 (3.15) 22
1456 XScreenSaver(1) XScreenSaver(1)
1459 X
\bXV
\bVi
\bie
\bew
\bw C
\bCl
\bli
\bie
\ben
\bnt
\bts
\bs
1460 Apparently there are some problems with XView pro-
1461 grams getting confused and thinking that the
1462 screensaver window is the real root window even
1463 when the screensaver is not active: ClientMessages
1464 intended for the window manager are sent to the
1465 screensaver window instead. This could be solved
1466 by making xscreensaver forward all unrecognised
1467 ClientMessages to the real root window, but there
1468 may be other problems as well. If anyone has any
1469 insight on the cause of this problem, please let
1470 me know. (XView is an X11 toolkit that implements
1471 the (quite abominable) Sun OpenLook look-and-
1474 M
\bMI
\bIT
\bT E
\bEx
\bxt
\bte
\ben
\bns
\bsi
\bio
\bon
\bn a
\ban
\bnd
\bd F
\bFa
\bad
\bdi
\bin
\bng
\bg
1475 The M
\bMI
\bIT
\bT-
\b-S
\bSC
\bCR
\bRE
\bEE
\bEN
\bN-
\b-S
\bSA
\bAV
\bVE
\bER
\bR extension is junk. Don't use
1478 When using the M
\bMI
\bIT
\bT-
\b-S
\bSC
\bCR
\bRE
\bEE
\bEN
\bN-
\b-S
\bSA
\bAV
\bVE
\bER
\bR extension in con-
1479 junction with the f
\bfa
\bad
\bde
\be option, you'll notice an
1480 unattractive flicker just before the fade begins.
1481 This is because the server maps a black window
1482 just before it tells the _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br process to
1483 activate. The _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br process immediately
1484 unmaps that window, but this results in a flicker.
1485 I haven't figured a way to get around this; it
1486 seems to be a fundamental property of the (mis-)
1487 design of this server extension.
1489 It sure would be nice if someone would implement
1490 the S
\bSG
\bGI
\bI S
\bSC
\bCR
\bRE
\bEE
\bEN
\bN_
\b_S
\bSA
\bAV
\bVE
\bER
\bR extension in XFree86; it's
1491 dead simple, and works far better than the
1492 overengineered and broken M
\bMI
\bIT
\bT-
\b-S
\bSC
\bCR
\bRE
\bEE
\bEN
\bN-
\b-S
\bSA
\bAV
\bVE
\bER
\bR exten-
1495 S
\bSG
\bGI
\bI P
\bPo
\bow
\bwe
\ber
\br S
\bSa
\bav
\bve
\ber
\br
1496 If you're running Irix 6.3, you might find that
1497 your monitor is powering down after an hour or two
1498 even if you've told it not to. This is fixed by
1499 SGI patches 2447 and 2537.
1501 If you're running Irix 6.5, this bug is back. I
1504 M
\bMe
\bes
\bsa
\baG
\bGL
\bL a
\ban
\bnd
\bd V
\bVo
\boo
\bod
\bdo
\boo
\bo C
\bCa
\bar
\brd
\bds
\bs
1505 If you have a 3Dfx/Voodoo card, the default set-
1506 tings for xscreensaver will run the GL-based
1507 graphics demos in such a way that they will not
1508 take advantage of the 3D acceleration hardware.
1509 The solution is to change the p
\bpr
\bro
\bog
\bgr
\bra
\bam
\bms
\bs entries for
1516 X Version 11 20-Jun-99 (3.15) 23
1522 XScreenSaver(1) XScreenSaver(1)
1525 the GL hacks from this:
1531 MESA_GLX_FX=fullscreen gears \n\
1533 That is, make sure that $
\b$M
\bME
\bES
\bSA
\bA_
\b_G
\bGL
\bLX
\bX_
\b_F
\bFX
\bX is set to
1534 _
\bf_
\bu_
\bl_
\bl_
\bs_
\bc_
\br_
\be_
\be_
\bn, and don't tell the program to draw on
1535 the root window. This may seem strange, but the
1536 setup used by Mesa and these kinds of cards _
\bi_
\bs
1539 For those who don't know, these cards work by sit-
1540 ting between your normal video card and the moni-
1541 tor, and seizing control of the monitor when it's
1542 time to do 3D. But this means that accelerated 3D
1543 only happens in full-screen mode (you can't do it
1544 in a window, and you can't see the output of 3D
1545 and 2D programs simultaniously), and that 3D will
1546 probably drive your monitor at a lower resolution,
1547 as well. It's bizarre.
1549 If you find that GL programs only work properly
1550 when run as root, and not as normal users, then
1551 the problem is that your _
\b/_
\bd_
\be_
\bv_
\b/_
\b3_
\bd_
\bf_
\bx file is not
1552 configured properly. Check the Linux 3Dfx FAQ.
1554 K
\bKe
\bey
\byb
\bbo
\boa
\bar
\brd
\bd L
\bLE
\bED
\bDs
\bs
1555 If _
\bp_
\br_
\bo_
\bc_
\bI_
\bn_
\bt_
\be_
\br_
\br_
\bu_
\bp_
\bt_
\bs is on (which is the default on
1556 Linux systems) and you're using some program that
1557 toggles the state of your keyboard LEDs, xscreen-
1558 saver won't work right: turning those LEDs on or
1559 off causes a keyboard interrupt, which xscreen-
1560 saver will interpret as user activity. So if
1561 you're using such a program, set the _
\bp_
\br_
\bo_
\bc_
\bI_
\bn_
\bt_
\be_
\br_
\b-
1562 _
\br_
\bu_
\bp_
\bt_
\bs resource to False.
1564 E
\bEx
\bxt
\bte
\ben
\bns
\bsi
\bio
\bon
\bns
\bs
1565 If you are not making use of one of the server
1566 extensions (X
\bXI
\bID
\bDL
\bLE
\bE, S
\bSG
\bGI
\bI S
\bSC
\bCR
\bRE
\bEE
\bEN
\bN_
\b_S
\bSA
\bAV
\bVE
\bER
\bR, or M
\bMI
\bIT
\bT-
\b-
1567 S
\bSC
\bCR
\bRE
\bEE
\bEN
\bN-
\b-S
\bSA
\bAV
\bVE
\bER
\bR), then it is possible, in rare situa-
1568 tions, for _
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br to interfere with event
1569 propagation and make another X program malfunc-
1570 tion. For this to occur, that other application
1571 would need to _
\bn_
\bo_
\bt select K
\bKe
\bey
\byP
\bPr
\bre
\bes
\bss
\bs events on its
1572 non-leaf windows within the first 30 seconds of
1573 their existence, but then select for them later.
1574 In this case, that client _
\bm_
\bi_
\bg_
\bh_
\bt fail to receive
1575 those events. This isn't very likely, since pro-
1576 grams generally select a constant set of events
1577 immediately after creating their windows and then
1578 don't change them, but this is the reason that
1582 X Version 11 20-Jun-99 (3.15) 24
1588 XScreenSaver(1) XScreenSaver(1)
1591 it's a good idea to install and use one of the
1592 server extensions instead, to work around this
1593 shortcoming in the X protocol.
1595 In all these years, I've not heard of even a sin-
1596 gle case of this happening, but it is theoreti-
1597 cally possible, so I'm mentioning it for complete-
1600 R
\bRe
\bed
\bd H
\bHo
\bot
\bt L
\bLa
\bav
\bva
\ba
1601 There need to be a lot more graphics hacks. In
1602 particular, there should be a simulation of a
1605 E
\bEN
\bNV
\bVI
\bIR
\bRO
\bON
\bNM
\bME
\bEN
\bNT
\bT
1606 D
\bDI
\bIS
\bSP
\bPL
\bLA
\bAY
\bY to get the default host and display number, and to
1607 inform the sub-programs of the screen on which to
1610 P
\bPA
\bAT
\bTH
\bH to find the sub-programs to run.
1612 H
\bHO
\bOM
\bME
\bE for the directory in which to read and write the
1613 _
\b._
\bx_
\bs_
\bc_
\br_
\be_
\be_
\bn_
\bs_
\ba_
\bv_
\be_
\br file.
1615 X
\bXE
\bEN
\bNV
\bVI
\bIR
\bRO
\bON
\bNM
\bME
\bEN
\bNT
\bT
1616 to get the name of a resource file that overrides
1617 the global resources stored in the RESOURCE_MAN-
1620 U
\bUP
\bPG
\bGR
\bRA
\bAD
\bDE
\bES
\bS
1621 The latest version can always be found at
1622 http://www.jwz.org/xscreensaver/
1624 S
\bSE
\bEE
\bE A
\bAL
\bLS
\bSO
\bO
1625 X
\bX(1), x
\bxs
\bsc
\bcr
\bre
\bee
\ben
\bns
\bsa
\bav
\bve
\ber
\br-
\b-d
\bde
\bem
\bmo
\bo(1), x
\bxs
\bsc
\bcr
\bre
\bee
\ben
\bns
\bsa
\bav
\bve
\ber
\br-
\b-c
\bco
\bom
\bmm
\bma
\ban
\bnd
\bd(1),
1626 x
\bxd
\bdm
\bm(1), x
\bxs
\bse
\bet
\bt(1), X
\bXs
\bse
\bec
\bcu
\bur
\bri
\bit
\bty
\by(1), x
\bxa
\bau
\but
\bth
\bh(1), x
\bxh
\bho
\bos
\bst
\bt(1).
1627 a
\ban
\bnt
\bt(1), a
\bat
\btl
\bla
\ban
\bnt
\bti
\bis
\bs(1), a
\bat
\btt
\btr
\bra
\bac
\bct
\bti
\bio
\bon
\bn(1), b
\bbl
\bli
\bit
\bts
\bsp
\bpi
\bin
\bn(1),
1628 b
\bbo
\bou
\bub
\bbo
\bou
\bul
\ble
\be(1), b
\bbr
\bra
\bai
\bid
\bd(1), b
\bbs
\bso
\bod
\bd(1), b
\bbu
\bub
\bbb
\bbl
\ble
\be3
\b3d
\bd(1), b
\bbu
\bub
\bbb
\bbl
\ble
\bes
\bs(1),
1629 c
\bca
\bag
\bge
\be(1), c
\bco
\bom
\bmp
\bpa
\bas
\bss
\bs(1), c
\bco
\bor
\bra
\bal
\bl(1), c
\bcr
\bri
\bit
\bti
\bic
\bca
\bal
\bl(1), c
\bcr
\bry
\bys
\bst
\bta
\bal
\bl(1),
1630 c
\bcy
\byn
\bno
\bos
\bsu
\bur
\bre
\be(1), d
\bde
\bec
\bca
\bay
\bys
\bsc
\bcr
\bre
\bee
\ben
\bn(1), d
\bde
\bec
\bco
\bo(1), d
\bde
\bel
\blu
\bux
\bxe
\be(1), d
\bde
\bem
\bmo
\bon
\bn(1),
1631 d
\bdi
\bis
\bsc
\bcr
\bre
\bet
\bte
\be(1), d
\bdi
\bis
\bst
\bto
\bor
\brt
\bt(1), d
\bdr
\bri
\bif
\bft
\bt(1), e
\bep
\bpi
\bic
\bcy
\byc
\bcl
\ble
\be(1), f
\bfa
\bad
\bde
\be-
\b-
1632 p
\bpl
\blo
\bot
\bt(1), f
\bfl
\bla
\bag
\bg(1), f
\bfl
\bla
\bam
\bme
\be(1), f
\bfl
\blo
\bow
\bw(1), f
\bfo
\bor
\bre
\bes
\bst
\bt(1), g
\bga
\bal
\bla
\bax
\bxy
\by(1),
1633 g
\bge
\bea
\bar
\brs
\bs(1), g
\bgl
\blp
\bpl
\bla
\ban
\bne
\bet
\bt(1), g
\bgo
\boo
\bop
\bp(1), g
\bgr
\bra
\bav
\bv(1), g
\bgr
\bre
\bey
\byn
\bne
\bet
\bti
\bic
\bc(1),
1634 h
\bha
\bal
\blo
\bo(1), h
\bhe
\bel
\bli
\bix
\bx(1), h
\bho
\bop
\bpa
\bal
\blo
\bon
\bng
\bg(1), h
\bhy
\byp
\bpe
\ber
\brc
\bcu
\bub
\bbe
\be(1), i
\bif
\bfs
\bs(1),
1635 i
\bim
\bms
\bsm
\bma
\bap
\bp(1), i
\bin
\bnt
\bte
\ber
\brf
\bfe
\ber
\bre
\ben
\bnc
\bce
\be(1), j
\bji
\big
\bgs
\bsa
\baw
\bw(1), j
\bju
\bul
\bli
\bia
\ba(1), k
\bka
\bal
\ble
\bei
\bi-
\b-
1636 d
\bde
\bes
\bsc
\bco
\bop
\bpe
\be(1), k
\bku
\bum
\bmp
\bpp
\bpa
\ba(1), l
\bla
\bam
\bme
\ben
\bnt
\bt(1), l
\bla
\bas
\bse
\ber
\br(1), l
\bli
\big
\bgh
\bht
\btn
\bni
\bin
\bng
\bg(1),
1637 l
\bli
\bis
\bsa
\ba(1), l
\bli
\bis
\bss
\bsi
\bie
\be(1), l
\blm
\bmo
\bor
\brp
\bph
\bh(1), l
\blo
\boo
\bop
\bp(1), m
\bma
\baz
\bze
\be(1), m
\bmo
\boe
\be-
\b-
1638 b
\bbi
\biu
\bus
\bs(1), m
\bmo
\boi
\bir
\bre
\be(1), m
\bmo
\boi
\bir
\bre
\be2
\b2(1), m
\bmo
\bor
\brp
\bph
\bh3
\b3d
\bd(1), m
\bmo
\bou
\bun
\bnt
\bta
\bai
\bin
\bn(1),
1639 m
\bmu
\bun
\bnc
\bch
\bh(1), n
\bno
\bos
\bse
\beg
\bgu
\buy
\by(1), p
\bpe
\bed
\bda
\bal
\bl(1), p
\bpe
\ben
\bne
\bet
\btr
\bra
\bat
\bte
\be(1), p
\bpe
\ben
\bnr
\bro
\bos
\bse
\be(1),
1640 p
\bpe
\bet
\btr
\bri
\bi(1), p
\bph
\bho
\bos
\bsp
\bph
\bho
\bor
\br(1), p
\bpi
\bip
\bpe
\bes
\bs(1), p
\bpu
\bul
\bls
\bsa
\bar
\br(1), p
\bpy
\byr
\bro
\bo(1),
1641 q
\bqi
\bix
\bx(1), r
\brd
\bd-
\b-b
\bbo
\bom
\bmb
\bb(1), r
\bro
\boc
\bck
\bks
\bs(1), r
\bro
\bor
\brs
\bsc
\bch
\bha
\bac
\bch
\bh(1), r
\bro
\bot
\bto
\bor
\br(1),
1642 r
\bru
\bub
\bbi
\bik
\bk(1), s
\bsi
\bie
\ber
\brp
\bpi
\bin
\bns
\bsk
\bki
\bi(1), s
\bsl
\bli
\bid
\bde
\bes
\bsc
\bcr
\bre
\bee
\ben
\bn(1), s
\bsl
\bli
\bip
\bp(1),
1643 s
\bso
\bon
\bna
\bar
\br(1), s
\bsp
\bph
\bhe
\ber
\bre
\be(1), s
\bsp
\bpi
\bir
\bra
\bal
\bl(1), s
\bsp
\bpo
\bot
\btl
\bli
\big
\bgh
\bht
\bt(1), s
\bsp
\bpr
\bro
\boi
\bin
\bn-
\b-
1644 g
\bgi
\bie
\bes
\bs(1), s
\bsq
\bqu
\bui
\bir
\bra
\bal
\bl(1), s
\bst
\bta
\bai
\bir
\brs
\bs(1), s
\bst
\bta
\bar
\brf
\bfi
\bis
\bsh
\bh(1), s
\bst
\btr
\bra
\ban
\bng
\bge
\be(1),
1648 X Version 11 20-Jun-99 (3.15) 25
1654 XScreenSaver(1) XScreenSaver(1)
1657 s
\bsu
\bup
\bpe
\ber
\brq
\bqu
\bua
\bad
\bdr
\bri
\bic
\bcs
\bs(1), s
\bsw
\bwi
\bir
\brl
\bl(1), t
\bt3
\b3d
\bd(1), t
\btr
\bri
\bia
\ban
\bng
\bgl
\ble
\be(1),
1658 t
\btr
\bru
\buc
\bch
\bhe
\bet
\bt(1), v
\bvi
\bin
\bne
\bes
\bs(1), w
\bwa
\ban
\bnd
\bde
\ber
\br(1), w
\bwo
\bor
\brm
\bm(1), x
\bxf
\bfl
\bla
\bam
\bme
\be(1),
1659 x
\bxj
\bja
\bac
\bck
\bk(1), x
\bxl
\bly
\bya
\bap
\bp(1), x
\bxm
\bma
\bat
\btr
\bri
\bix
\bx(1), x
\bxr
\bro
\bog
\bge
\ber
\br(1), b
\bbo
\bon
\bng
\bgo
\bo(1),
1660 i
\bic
\bco
\bo(1), x
\bxa
\bao
\bos
\bs(1), x
\bxb
\bbo
\bou
\bun
\bnc
\bce
\beb
\bbi
\bit
\bts
\bs(1), x
\bxc
\bct
\bth
\bhu
\bug
\bgh
\bha
\ba(1), x
\bxd
\bda
\bal
\bli
\bi-
\b-
1661 c
\bcl
\blo
\boc
\bck
\bk(1), x
\bxf
\bfi
\bis
\bsh
\bht
\bta
\ban
\bnk
\bk(1), x
\bxm
\bmo
\bou
\bun
\bnt
\bta
\bai
\bin
\bns
\bs(1), x
\bxs
\bsp
\bpl
\bli
\bin
\bne
\bef
\bfu
\bun
\bn(1),
1662 x
\bxs
\bsw
\bwa
\bar
\brm
\bm(1), x
\bxt
\bta
\bac
\bcy
\by(1), x
\bxv
\bv(1), x
\bxw
\bwa
\bav
\bve
\be(1).
1664 C
\bCO
\bOP
\bPY
\bYR
\bRI
\bIG
\bGH
\bHT
\bT
1665 Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997,
1666 1998, 1999 by Jamie Zawinski. Permission to use, copy,
1667 modify, distribute, and sell this software and its docu-
1668 mentation for any purpose is hereby granted without fee,
1669 provided that the above copyright notice appear in all
1670 copies and that both that copyright notice and this per-
1671 mission notice appear in supporting documentation. No
1672 representations are made about the suitability of this
1673 software for any purpose. It is provided "as is" without
1674 express or implied warranty.
1676 A
\bAU
\bUT
\bTH
\bHO
\bOR
\bR
1677 Jamie Zawinski <jwz@jwz.org>. Written in late 1991; first
1678 posted to comp.sources.x on 13-Aug-1992.
1680 Please let me know if you find any bugs or make any
1683 A
\bAC
\bCK
\bKN
\bNO
\bOW
\bWL
\bLE
\bED
\bDG
\bGE
\bEM
\bME
\bEN
\bNT
\bTS
\bS
1684 Thanks to the many people who have contributed graphics
1685 demos to the package.
1687 Thanks to David Wojtowicz for implementing _
\bl_
\bo_
\bc_
\bk_
\bT_
\bi_
\bm_
\be_
\bo_
\bu_
\bt.
1689 Thanks to Martin Kraemer for adding support for shadow
1690 passwords and locking-disabled diagnostics.
1692 Thanks to Patrick Moreau for the VMS port.
1694 Thanks to Mark Bowyer for figuring out how to hook it up
1697 Thanks to Nat Lanza for the Kerberos support.
1699 Thanks to Bill Nottingham for the initial PAM support.
1701 And thanks to Jon A. Christopher for implementing the
1702 Athena dialog support, back in the days before Lesstif or
1703 Gtk were viable alternatives to Motif.
1714 X Version 11 20-Jun-99 (3.15) 26