--- /dev/null
+
+
+
+XScreenSaver(1) XScreenSaver(1)
+
+
+N\bNA\bAM\bME\bE
+ xscreensaver-command - control a running xscreensaver pro-
+ cess
+
+S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
+ x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br-\b-c\bco\bom\bmm\bma\ban\bnd\bd [-help] [-demo] [-activate] [-deacti-
+ vate] [-lock] [-cycle] [-next] [-prev] [-exit] [-restart]
+ [-version] [-time]
+
+D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
+ The _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br_\b-_\bc_\bo_\bm_\bm_\ba_\bn_\bd program controls a running
+ _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br process by sending it client-messages.
+
+O\bOP\bPT\bTI\bIO\bON\bNS\bS
+ _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br_\b-_\bc_\bo_\bm_\bm_\ba_\bn_\bd accepts the following options:
+
+ -\b-h\bhe\bel\blp\bp Prints a brief summary of command-line options.
+
+ -\b-d\bde\bem\bmo\bo Cause the screensaver to enter its interactive
+ demo mode, in which one can experiment with the
+ various graphics hacks available. See x\bxs\bsc\bcr\bre\bee\ben\bn-\b-
+ s\bsa\bav\bve\ber\br(1) for details.
+
+ -\b-a\bac\bct\bti\biv\bva\bat\bte\be
+ Tell the screensaver to turn on immediately (that
+ is, pretend that the user been idle for long
+ enough.) It will turn off as soon as there is any
+ user activity, as usual.
+
+ It is useful to run this from a menu; you may wish
+ to run it as
+
+ sleep 5 ; xscreensaver-command -activate
+
+ to be sure that you have time to remove your hand
+ from the mouse before the screensaver comes on.
+
+ -\b-d\bde\bea\bac\bct\bti\biv\bva\bat\bte\be
+ Tell the screensaver to turn off, as if there had
+ been user activity. If locking is enabled, then
+ the screensaver will prompt for a password as
+ usual.
+
+ -\b-l\blo\boc\bck\bk Like _\b-_\ba_\bc_\bt_\bi_\bv_\ba_\bt_\be, but a password will be required
+ before the screensaver turns off, even if the
+ screensaver's _\bl_\bo_\bc_\bk resource is false. The display
+ will be locked immediately even if the screen-
+ saver's _\bl_\bo_\bc_\bk_\bT_\bi_\bm_\be_\bo_\bu_\bt resource is non-zero.
+
+ -\b-c\bcy\byc\bcl\ble\be Tell the screensaver to change which graphics hack
+ it is running, just as if the ``cycle'' timer had
+ expired. A new hack will be chosen randomly.
+
+ -\b-n\bne\bex\bxt\bt This is like either _\b-_\ba_\bc_\bt_\bi_\bv_\ba_\bt_\be or _\b-_\bc_\by_\bc_\bl_\be, depending
+
+
+
+X Version 11 31-May-97 1
+
+
+
+
+
+XScreenSaver(1) XScreenSaver(1)
+
+
+ on which is more appropriate, except that the
+ screenhack that will be run is the next one in the
+ list of programs, instead of a randomly-chosen
+ one. Repeatedly executing this will cycle through
+ each hack in turn (though using the _\b-_\bd_\be_\bm_\bo option
+ is probably an easier way to accomplish that.)
+
+ -\b-p\bpr\bre\bev\bv This is like _\b-_\bn_\be_\bx_\bt, but cycles in the other direc-
+ tion.
+
+ -\b-e\bex\bxi\bit\bt Causes the screensaver process to exit gracefully.
+ This is a safer and easier way to kill the screen-
+ saver than by using _\bk_\bi_\bl_\bl.
+
+ W\bWa\bar\brn\bni\bin\bng\bg:\b: never use _\bk_\bi_\bl_\bl _\b-_\b9 with _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br while
+ the screensaver is active. If you are using a
+ virtual root window manager, that can leave things
+ in an inconsistent state, and you may need to
+ restart your window manager to repair the damage.
+
+ -\b-r\bre\bes\bst\bta\bar\brt\bt
+ Causes the screensaver process to exit and then
+ restart with the same command line arguments.
+ This is a good way of causing the screensaver to
+ re-read the resource database.
+
+ If the screensaver is run from _\bx_\bd_\bm_\b(_\b1_\b) (that is, it
+ is already running before you log in) then you may
+ want to issue the ``restart'' command from one of
+ your startup scripts, so that the screensaver gets
+ your resource settings instead of the default
+ ones.
+
+ -\b-v\bve\ber\brs\bsi\bio\bon\bn
+ Print (on stdout) the version number of the
+ xscreensaver program that is running on $DISPLAY.
+ (To see the version number of _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br_\b-_\bc_\bo_\bm_\bm_\ba_\bn_\bd
+ itself, use the _\b-_\bh_\be_\bl_\bp option.)
+
+ -\b-t\bti\bim\bme\be This option prints on stdout the time at which the
+ screensaver last activated (blanked the screen) or
+ deactivated (restored the screen.) Note that the
+ activation-time is not the last time at which the
+ user was active, but is some time later (it is the
+ time at which either: xscreensaver decided that
+ the user has been idle long enough; or, the user
+ explicitly activated the screensaver or locker.)
+
+E\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
+ D\bDI\bIS\bSP\bPL\bLA\bAY\bY to get the host and display number of the screen
+ whose saver is to be manipulated.
+
+ P\bPA\bAT\bTH\bH to find the executable to restart (for the
+ _\b-_\br_\be_\bs_\bt_\ba_\br_\bt command). Note that this variable is
+
+
+
+X Version 11 31-May-97 2
+
+
+
+
+
+XScreenSaver(1) XScreenSaver(1)
+
+
+ consulted in the environment of the _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br
+ process, not the _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br_\b-_\bc_\bo_\bm_\bm_\ba_\bn_\bd process.
+
+S\bSE\bEE\bE A\bAL\bLS\bSO\bO
+ X\bX(1), x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br(1)
+
+B\bBU\bUG\bGS\bS
+ Some diagnostics are reported on the stderr of the
+ _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br process, not this process, so the caller of
+ _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br_\b-_\bc_\bo_\bm_\bm_\ba_\bn_\bd may not see the error messages.
+
+C\bCO\bOP\bPY\bYR\bRI\bIG\bGH\bHT\bT
+ Copyright (C) 1992, 1993, 1997 by Jamie Zawinski. Permis-
+ sion to use, copy, modify, distribute, and sell this soft-
+ ware and its documentation for any purpose is hereby
+ granted without fee, provided that the above copyright
+ notice appear in all copies and that both that copyright
+ notice and this permission notice appear in supporting
+ documentation. No representations are made about the
+ suitability of this software for any purpose. It is pro-
+ vided "as is" without express or implied warranty.
+
+A\bAU\bUT\bTH\bHO\bOR\bR
+ Jamie Zawinski <jwz@netscape.com>, 13-aug-92.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+X Version 11 31-May-97 3
+
+