git.hungrycats.org Git - xscreensaver/blob - driver/xscreensaver-command.c

   1 /* xscreensaver-command, Copyright (c) 1991-1999
   2  *  by Jamie Zawinski <jwz@jwz.org>
   3  *
   4  * Permission to use, copy, modify, distribute, and sell this software and its
   5  * documentation for any purpose is hereby granted without fee, provided that
   6  * the above copyright notice appear in all copies and that both that
   7  * copyright notice and this permission notice appear in supporting
   8  * documentation.  No representations are made about the suitability of this
   9  * software for any purpose.  It is provided "as is" without express or
  10  * implied warranty.
  11  */
  12
  13 #ifdef HAVE_CONFIG_H
  14 # include "config.h"
  15 #endif
  16
  17 #include <stdio.h>
  18 #include <stdlib.h>
  19 #include <sys/time.h>
  20 #include <sys/types.h>
  21
  22 #ifdef HAVE_UNISTD_H
  23 # include <unistd.h>
  24 #endif
  25
  26 #include <X11/Xproto.h>         /* for CARD32 */
  27 #include <X11/Xlib.h>
  28 #include <X11/Xatom.h>
  29 #include <X11/Xutil.h>          /* for XGetClassHint() */
  30 #include <X11/Xos.h>
  31
  32 #include <X11/Intrinsic.h>      /* only needed to get through xscreensaver.h */
  33
  34 #include "remote.h"
  35 #include "version.h"
  36
  37 #ifdef _VROOT_H_
  38 ERROR! you must not include vroot.h in this file
  39 #endif
  40
  41 char *progname;
  42
  43 Atom XA_VROOT;
  44 Atom XA_SCREENSAVER, XA_SCREENSAVER_VERSION, XA_SCREENSAVER_RESPONSE;
  45 Atom XA_SCREENSAVER_ID, XA_SCREENSAVER_TIME, XA_SELECT, XA_DEMO;
  46 static Atom XA_ACTIVATE, XA_DEACTIVATE, XA_CYCLE, XA_NEXT, XA_PREV, XA_EXIT;
  47 static Atom XA_RESTART, XA_PREFS, XA_LOCK;
  48
  49 static char *screensaver_version;
  50 static char *usage = "\n\
  51 usage: %s -<option>\n\
  52 \n\
  53   This program provides external control of a running xscreensaver process.\n\
  54   Version %s, copyright (c) 1991-1999 Jamie Zawinski <jwz@jwz.org>.\n\
  55 \n\
  56   The xscreensaver program is a daemon that runs in the background.\n\
  57   You control a running xscreensaver process by sending it messages\n\
  58   with this program, xscreensaver-command.  See the man pages for\n\
  59   details.  These are the arguments understood by xscreensaver-command:\n\
  60 \n\
  61   -demo         Ask the xscreensaver process to enter interactive demo mode.\n\
  62 \n\
  63   -prefs        Ask the xscreensaver process to bring up the preferences\n\
  64                 panel.\n\
  65 \n\
  66   -activate     Turn on the screensaver (blank the screen), as if the user\n\
  67                 had been idle for long enough.\n\
  68 \n\
  69   -deactivate   Turns off the screensaver (un-blank the screen), as if user\n\
  70                 activity had been detected.\n\
  71 \n\
  72   -cycle        If the screensaver is active (the screen is blanked), then\n\
  73                 stop the current graphics demo and run a new one (chosen\n\
  74                 randomly.)\n\
  75 \n\
  76   -next         Like either -activate or -cycle, depending on which is more\n\
  77                 appropriate, except that the graphics hack that will be run\n\
  78                 is the next one in the list, instead of a randomly-chosen\n\
  79                 one.  In other words, repeatedly executing -next will cause\n\
  80                 the xscreensaver process to invoke each graphics demo\n\
  81                 sequentially.  (Though using the -demo option is probably\n\
  82                 an easier way to accomplish that.)\n\
  83 \n\
  84   -prev         Like -next, but goes in the other direction.\n\
  85 \n\
  86   -select <N>   Like -activate, but runs the Nth element in the list of\n\
  87                 hacks.  By knowing what is in the `programs' list, and in\n\
  88                 what order, you can use this to activate the screensaver\n\
  89                 with a particular graphics demo.  (The first element in the\n\
  90                 list is numbered 1, not 0.)\n\
  91 \n\
  92   -exit         Causes the xscreensaver process to exit gracefully.  This is\n\
  93                 roughly the same as killing the process with `kill', but it\n\
  94                 is easier, since you don't need to first figure out the pid.\n\
  95                 (Note that one must *never* kill xscreensaver with -9!)\n\
  96 \n\
  97   -restart      Causes the screensaver process to exit and then restart with\n\
  98                 the same command line arguments as last time.  Do this after\n\
  99                 you've changed your X resource settings, to cause\n\
 100                 xscreensaver to notice the changes.\n\
 101 \n\
 102   -lock         Tells the running xscreensaver process to lock the screen\n\
 103                 immediately.  This is like -activate, but forces locking as\n\
 104                 well, even if locking is not the default.\n\
 105 \n\
 106   -version      Prints the version of xscreensaver that is currently running\n\
 107                 on the display -- that is, the actual version number of the\n\
 108                 running xscreensaver background process, rather than the\n\
 109                 version number of xscreensaver-command.\n\
 110 \n\
 111   -time         Prints the time at which the screensaver last activated or\n\
 112                 deactivated (roughly, how long the user has been idle or\n\
 113                 non-idle -- but not quite, since it only tells you when the\n\
 114                 screen became blanked or un-blanked.)\n\
 115 \n\
 116   See the man page for more details.\n\
 117   For updates, check http://www.jwz.org/xscreensaver/\n\
 118 \n";
 119
 120 #define USAGE() do { \
 121  fprintf (stderr, usage, progname, screensaver_version); exit (1); \
 122  } while(0)
 123
 124 int
 125 main (int argc, char **argv)
 126 {
 127   Display *dpy;
 128   int i;
 129   char *dpyname = 0;
 130   Atom *cmd = 0;
 131   long arg = 0L;
 132
 133   progname = argv[0];
 134   screensaver_version = (char *) malloc (5);
 135   memcpy (screensaver_version, screensaver_id + 17, 4);
 136   screensaver_version [4] = 0;
 137
 138   for (i = 1; i < argc; i++)
 139     {
 140       const char *s = argv [i];
 141       int L;
 142       if (s[0] == '-' && s[1] == '-') s++;
 143       L = strlen (s);
 144       if (L < 2) USAGE ();
 145       if (!strncmp (s, "-display", L))          dpyname = argv [++i];
 146       else if (cmd) USAGE();
 147       else if (!strncmp (s, "-activate", L))   cmd = &XA_ACTIVATE;
 148       else if (!strncmp (s, "-deactivate", L)) cmd = &XA_DEACTIVATE;
 149       else if (!strncmp (s, "-cycle", L))      cmd = &XA_CYCLE;
 150       else if (!strncmp (s, "-next", L))       cmd = &XA_NEXT;
 151       else if (!strncmp (s, "-prev", L))       cmd = &XA_PREV;
 152       else if (!strncmp (s, "-select", L))     cmd = &XA_SELECT;
 153       else if (!strncmp (s, "-exit", L))       cmd = &XA_EXIT;
 154       else if (!strncmp (s, "-restart", L))    cmd = &XA_RESTART;
 155       else if (!strncmp (s, "-demo", L))       cmd = &XA_DEMO;
 156       else if (!strncmp (s, "-preferences",L)) cmd = &XA_PREFS;
 157       else if (!strncmp (s, "-prefs",L))       cmd = &XA_PREFS;
 158       else if (!strncmp (s, "-lock", L))       cmd = &XA_LOCK;
 159       else if (!strncmp (s, "-version", L))    cmd = &XA_SCREENSAVER_VERSION;
 160       else if (!strncmp (s, "-time", L))       cmd = &XA_SCREENSAVER_TIME;
 161       else USAGE ();
 162
 163       if (cmd == &XA_SELECT || cmd == &XA_DEMO)
 164         {
 165           long a;
 166           char c;
 167           if (i+1 < argc && (1 == sscanf(argv[i+1], " %ld %c", &a, &c)))
 168             {
 169               arg = a;
 170               i++;
 171             }
 172         }
 173     }
 174
 175   if (!cmd)
 176     USAGE ();
 177
 178   if (arg < 0)
 179     /* no command may have a negative argument. */
 180     USAGE();
 181   else if (arg == 0)
 182     {
 183       /* SELECT must have a non-zero argument. */
 184       if (cmd == &XA_SELECT)
 185         USAGE();
 186     }
 187   else /* arg > 0 */
 188     {
 189       /* no command other than SELECT and DEMO may have a non-zero argument. */
 190       if (cmd != &XA_DEMO && cmd != &XA_SELECT)
 191         USAGE();
 192     }
 193
 194
 195
 196   /* For backward compatibility: -demo with no arguments used to send a
 197      "DEMO 0" ClientMessage to the xscreensaver process, which brought up
 198      the built-in demo mode dialog.  Now that the demo mode dialog is no
 199      longer built in, we bring it up by just running the "xscreensaver-demo"
 200      program.
 201
 202      Note that "-DEMO <n>" still sends a ClientMessage.
 203    */
 204   if (cmd == &XA_PREFS ||
 205       (cmd == &XA_DEMO && arg == 0))
 206     {
 207       char buf [512];
 208       char *new_argv[] = { "xscreensaver-demo", 0, 0, 0, 0, 0 };
 209       int ac = 1;
 210
 211       if (dpyname)
 212         {
 213           new_argv[ac++] = "-display";
 214           new_argv[ac++] = dpyname;
 215         }
 216
 217       if (cmd == &XA_PREFS)
 218         new_argv[ac++] = "-prefs";
 219
 220       fflush(stdout);
 221       fflush(stderr);
 222       execvp (new_argv[0], new_argv);   /* shouldn't return */
 223
 224       sprintf (buf, "%s: could not exec %s", progname, new_argv[0]);
 225       perror(buf);
 226       fflush(stdout);
 227       fflush(stderr);
 228       exit (-1);
 229     }
 230
 231
 232
 233   if (!dpyname) dpyname = (char *) getenv ("DISPLAY");
 234   dpy = XOpenDisplay (dpyname);
 235   if (!dpy)
 236     {
 237       fprintf (stderr, "%s: can't open display %s\n", progname,
 238                (dpyname ? dpyname : "(null)"));
 239       exit (1);
 240     }
 241
 242   XA_VROOT = XInternAtom (dpy, "__SWM_VROOT", False);
 243   XA_SCREENSAVER = XInternAtom (dpy, "SCREENSAVER", False);
 244   XA_SCREENSAVER_ID = XInternAtom (dpy, "_SCREENSAVER_ID", False);
 245   XA_SCREENSAVER_VERSION = XInternAtom (dpy, "_SCREENSAVER_VERSION",False);
 246   XA_SCREENSAVER_TIME = XInternAtom (dpy, "_SCREENSAVER_TIME", False);
 247   XA_SCREENSAVER_RESPONSE = XInternAtom (dpy, "_SCREENSAVER_RESPONSE", False);
 248   XA_ACTIVATE = XInternAtom (dpy, "ACTIVATE", False);
 249   XA_DEACTIVATE = XInternAtom (dpy, "DEACTIVATE", False);
 250   XA_RESTART = XInternAtom (dpy, "RESTART", False);
 251   XA_CYCLE = XInternAtom (dpy, "CYCLE", False);
 252   XA_NEXT = XInternAtom (dpy, "NEXT", False);
 253   XA_PREV = XInternAtom (dpy, "PREV", False);
 254   XA_SELECT = XInternAtom (dpy, "SELECT", False);
 255   XA_EXIT = XInternAtom (dpy, "EXIT", False);
 256   XA_DEMO = XInternAtom (dpy, "DEMO", False);
 257   XA_PREFS = XInternAtom (dpy, "PREFS", False);
 258   XA_LOCK = XInternAtom (dpy, "LOCK", False);
 259
 260   XSync (dpy, 0);
 261
 262   if (*cmd == XA_ACTIVATE || *cmd == XA_LOCK ||
 263       *cmd == XA_NEXT || *cmd == XA_PREV || *cmd == XA_SELECT)
 264     /* People never guess that KeyRelease deactivates the screen saver too,
 265        so if we're issuing an activation command, wait a second. */
 266     sleep (1);
 267
 268   i = xscreensaver_command (dpy, *cmd, arg, True);
 269   if (i < 0) exit (i);
 270   else exit (0);
 271 }