summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKaleb Keithley <kaleb@freedesktop.org>2003-11-14 15:54:55 +0000
committerKaleb Keithley <kaleb@freedesktop.org>2003-11-14 15:54:55 +0000
commitba9612df0697182f5c4ebd5852da1e4da479101e (patch)
treefe455160405b222225caaf4870221acacb7022a4
R6.6 is the Xorg base-lineXORG-MAIN
-rw-r--r--xset.c1233
-rw-r--r--xset.man214
2 files changed, 1447 insertions, 0 deletions
diff --git a/xset.c b/xset.c
new file mode 100644
index 0000000..0297fd4
--- /dev/null
+++ b/xset.c
@@ -0,0 +1,1233 @@
+/*
+ * $Xorg: xset.c,v 1.6 2001/02/09 02:05:58 xorgcvs Exp $
+ */
+
+/*
+
+Copyright 1985, 1998 The Open Group
+
+Permission to use, copy, modify, distribute, and sell this software 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.
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
+AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+Except as contained in this notice, the name of The Open Group shall not be
+used in advertising or otherwise to promote the sale, use or other dealings
+in this Software without prior written authorization from The Open Group.
+
+*/
+
+#include <stdio.h>
+#include <ctype.h>
+
+#include <X11/Xos.h>
+#include <X11/Xfuncs.h>
+#include <X11/Xlib.h>
+#include <X11/keysym.h>
+#include <X11/Xproto.h>
+#include <X11/Xutil.h>
+#include <X11/Xmu/Error.h>
+#ifdef MITMISC
+#include <X11/extensions/MITMisc.h>
+#endif
+#ifdef DPMSExtension
+#include <X11/extensions/dpms.h>
+#ifdef WIN32
+#define BOOL wBOOL
+#ifdef Status
+#undef Status
+#define Status wStatus
+#endif
+#include <windows.h>
+#ifdef Status
+#undef Status
+#define Status int
+#endif
+#undef BOOL
+#endif
+#if defined(SVR4) && defined(sun)
+#include <sys/syscall.h>
+#endif
+#endif /* DPMSExtension */
+
+#define ON 1
+#define OFF 0
+
+#define SERVER_DEFAULT (-1)
+#define DONT_CHANGE -2
+
+#define DEFAULT_ON (-50)
+#define DEFAULT_TIMEOUT (-600)
+
+#define ALL -1
+#define TIMEOUT 1
+#define INTERVAL 2
+#define PREFER_BLANK 3
+#define ALLOW_EXP 4
+
+#define nextarg(i, argv) \
+ argv[i]; \
+ if (i >= argc) \
+ break; \
+
+char *progName;
+
+int error_status = 0;
+
+int local_xerror();
+
+main(argc, argv)
+int argc;
+char **argv;
+{
+register char *arg;
+register int i;
+int percent;
+int acc_num, acc_denom, threshold;
+#ifdef DPMSExtension
+int standby_timeout, suspend_timeout, off_timeout;
+#endif
+int key, auto_repeat_mode;
+XKeyboardControl values;
+#define MAX_PIXEL_COUNT 512
+unsigned long pixels[MAX_PIXEL_COUNT];
+caddr_t colors[MAX_PIXEL_COUNT];
+int numpixels = 0;
+char *disp = NULL;
+Display *dpy;
+Bool hasargs = False;
+
+progName = argv[0];
+for (i = 1; i < argc; i++) {
+ arg = argv[i];
+ if (strcmp (arg, "-display") == 0 || strcmp (arg, "-d") == 0) {
+ if (++i >= argc) usage ("missing argument to -display", NULL);
+ disp = argv[i];
+ } else {
+ hasargs = True;
+ }
+}
+if (!hasargs) {
+ usage (NULL, NULL); /* replace with window interface */
+}
+
+dpy = XOpenDisplay(disp); /* Open display and check for success */
+if (dpy == NULL) {
+ fprintf(stderr, "%s: unable to open display \"%s\"\n",
+ argv[0], XDisplayName (disp));
+ exit(1);
+}
+XSetErrorHandler (local_xerror);
+for (i = 1; i < argc; ) {
+ arg = argv[i++];
+ if (strcmp (arg, "-display") == 0 || strcmp (arg, "-d") == 0) {
+ ++i; /* already dealt with */
+ continue;
+ } else if (*arg == '-' && *(arg + 1) == 'c'){ /* Does arg start with "-c"? */
+ set_click(dpy, 0); /* If so, turn click off and */
+ }
+ else if (*arg == 'c') { /* Well, does it start with "c", then? */
+ percent = SERVER_DEFAULT; /* Default click volume. */
+ if (i >= argc) {
+ set_click (dpy, percent); /* set click to default */
+ break;
+ }
+ arg = nextarg(i, argv);
+ if (strcmp(arg, "on") == 0) { /* Let click be default. */
+ percent = DEFAULT_ON;
+ i++;
+ }
+ else if (strcmp(arg, "off") == 0) {
+ percent = 0; /* Turn it off. */
+ i++;
+ }
+ else if (is_number(arg, 100)) {
+ percent = atoi(arg); /* Set to spec. volume */
+ i++;
+ }
+ set_click(dpy, percent);
+ }
+ else if (strcmp(arg, "-b") == 0) {
+ set_bell_vol(dpy, 0); /* Then turn off bell. */
+ }
+ else if (strcmp(arg, "b") == 0) {
+ percent = SERVER_DEFAULT; /* Set bell to default. */
+ if (i >= argc) {
+ set_bell_vol (dpy, percent); /* set bell to default */
+ set_bell_pitch(dpy,percent); /* set pitch to default */
+ set_bell_dur(dpy,percent); /* set duration to default */
+ break;
+ }
+ arg = nextarg(i, argv);
+ if (strcmp(arg, "on") == 0) { /* Let it stay that way. */
+ set_bell_vol(dpy, DEFAULT_ON); /* set bell on */
+ set_bell_pitch(dpy,percent); /* set pitch to default */
+ set_bell_dur(dpy,percent); /* set duration to default */
+ i++;
+ }
+ else if (strcmp(arg, "off") == 0) {
+ percent = 0; /* Turn the bell off. */
+ set_bell_vol(dpy, percent);
+ i++;
+ }
+ else if (is_number(arg, 100)) { /* If volume is given: */
+ percent = atoi(arg); /* set bell appropriately.*/
+ set_bell_vol(dpy, percent);
+ i++;
+ arg = nextarg(i, argv);
+
+ if (is_number(arg, 32767)) { /* If pitch is given: */
+ set_bell_pitch(dpy, atoi(arg)); /* set the bell. */
+ i++;
+
+ arg = nextarg(i, argv);
+ if (is_number(arg, 32767)) { /* If duration is given: */
+ set_bell_dur(dpy, atoi(arg)); /* set the bell. */
+ i++;
+ }
+ }
+ }
+ else
+ set_bell_vol (dpy, percent); /* set bell to default */
+ }
+#ifdef MITMISC
+ else if (strcmp(arg, "bc") == 0) {
+ int dummy;
+ if (XMITMiscQueryExtension(dpy, &dummy, &dummy))
+ XMITMiscSetBugMode(dpy, True);
+ else
+ fprintf(stderr, "server does not have extension for bc option\n");
+ }
+ else if (strcmp(arg, "-bc") == 0) {
+ int dummy;
+ if (XMITMiscQueryExtension(dpy, &dummy, &dummy))
+ XMITMiscSetBugMode(dpy, False);
+ else
+ fprintf(stderr, "server does not have extension for -bc option\n");
+ }
+#endif
+ else if (strcmp(arg, "fp") == 0) { /* set font path */
+ if (i >= argc) {
+ arg = "default";
+ } else {
+ arg = nextarg(i, argv);
+ }
+ set_font_path(dpy, arg, 1, 0, 0); /* special argument */
+ i++;
+ }
+ else if (strcmp(arg, "fp=") == 0) { /* unconditionally set */
+ if (i >= argc) {
+ usage ("missing fp= argument", NULL);
+ } else {
+ arg = nextarg(i, argv);
+ }
+ set_font_path(dpy, arg, 0, 0, 0); /* not special, set */
+ i++;
+ }
+ else if (strcmp(arg, "+fp") == 0) { /* set font path */
+ if (i >= argc) usage ("missing +fp argument", NULL);
+ arg = nextarg(i, argv);
+ set_font_path(dpy, arg, 0, 1, 0); /* not special, prepend */
+ i++;
+ }
+ else if (strcmp(arg, "fp+") == 0) { /* set font path */
+ if (i >= argc) usage ("missing fp+ argument", NULL);
+ arg = nextarg(i, argv);
+ set_font_path(dpy, arg, 0, 0, 1); /* not special, append */
+ i++;
+ }
+ else if (strcmp(arg, "-fp") == 0) { /* set font path */
+ if (i >= argc) usage ("missing -fp argument", NULL);
+ arg = nextarg(i, argv);
+ set_font_path(dpy, arg, 0, -1, 0); /* not special, preremove */
+ i++;
+ }
+ else if (strcmp(arg, "fp-") == 0) { /* set font path */
+ if (i >= argc) usage ("missing fp- argument", NULL);
+ arg = nextarg(i, argv);
+ set_font_path(dpy, arg, 0, 0, -1); /* not special, postremove */
+ i++;
+ }
+ else if (strcmp(arg, "-led") == 0) { /* Turn off one or all LEDs */
+ values.led_mode = OFF;
+ values.led = ALL; /* None specified */
+ if (i >= argc) {
+ set_led(dpy, values.led, values.led_mode);
+ break;
+ }
+ arg = nextarg(i, argv);
+ if (is_number(arg, 32) && atoi(arg) > 0) {
+ values.led = atoi(arg);
+ i++;
+ }
+ set_led(dpy, values.led, values.led_mode);
+ }
+ else if (strcmp(arg, "led") == 0) { /* Turn on one or all LEDs */
+ values.led_mode = ON;
+ values.led = ALL;
+ if (i >= argc) {
+ set_led (dpy, values.led, values.led_mode); /* set led to def */
+ break;
+ }
+ arg = nextarg(i, argv);
+ if (strcmp(arg, "on") == 0) {
+ i++;
+ }
+ else if (strcmp(arg, "off") == 0) { /* ...except in this case. */
+ values.led_mode = OFF;
+ i++;
+ }
+ else if (is_number(arg, 32) && atoi(arg) > 0) {
+ values.led = atoi(arg);
+ i++;
+ }
+ set_led(dpy, values.led, values.led_mode);
+ }
+/* Set pointer (mouse) settings: Acceleration and Threshold. */
+ else if (strcmp(arg, "m") == 0 || strcmp(arg, "mouse") == 0) {
+ acc_num = SERVER_DEFAULT; /* restore server defaults */
+ acc_denom = SERVER_DEFAULT;
+ threshold = SERVER_DEFAULT;
+ if (i >= argc){
+ set_mouse(dpy, acc_num, acc_denom, threshold);
+ break;
+ }
+ arg = argv[i];
+ if (strcmp(arg, "default") == 0) {
+ i++;
+ }
+ else if (*arg >= '0' && *arg <= '9') {
+ acc_denom = 1;
+ sscanf(arg, "%d/%d", &acc_num, &acc_denom);
+ i++;
+ if (i >= argc) {
+ set_mouse(dpy, acc_num, acc_denom, threshold);
+ break;
+ }
+ arg = argv[i];
+ if (*arg >= '0' && *arg <= '9') {
+ threshold = atoi(arg); /* Set threshold as user specified. */
+ i++;
+ }
+ }
+ set_mouse(dpy, acc_num, acc_denom, threshold);
+ }
+#ifdef DPMSExtension
+ else if (strcmp(arg, "+dpms") == 0) { /* turn on DPMS */
+ int dummy;
+ if (DPMSQueryExtension(dpy, &dummy, &dummy))
+ DPMSEnable(dpy);
+ else
+ fprintf(stderr, "server does not have extension for +dpms option\n");
+ }
+ else if (strcmp(arg, "-dpms") == 0) { /* shut off DPMS */
+ int dummy;
+ if (DPMSQueryExtension(dpy, &dummy, &dummy))
+ DPMSDisable(dpy);
+ else
+ fprintf(stderr, "server does not have extension for -dpms option\n");
+
+ }
+ else if (strcmp(arg, "dpms") == 0) { /* tune DPMS */
+ int dummy;
+ if (DPMSQueryExtension(dpy, &dummy, &dummy))
+ {
+ DPMSGetTimeouts(dpy, &standby_timeout, &suspend_timeout,
+ &off_timeout);
+ if (i >= argc) {
+ DPMSEnable(dpy);
+ break;
+ }
+ arg = argv[i];
+ if (*arg >= '0' && *arg <= '9') {
+ sscanf(arg, "%d", &standby_timeout);
+ i++;
+ arg = argv[i];
+ if ((arg)&&(*arg >= '0' && *arg <= '9')) {
+ sscanf(arg, "%d", &suspend_timeout);
+ i++;
+ arg = argv[i];
+ if ((arg)&&(*arg >= '0' && *arg <= '9')) {
+ sscanf(arg, "%d", &off_timeout);
+ i++;
+ arg = argv[i];
+ }
+ }
+ if ((suspend_timeout != 0)&&(standby_timeout > suspend_timeout))
+ {
+ fprintf(stderr, "illegal combination of values\n");
+ fprintf(stderr, " standby time of %d is greater than suspend time of %d\n", standby_timeout, suspend_timeout);
+ exit(0);
+ }
+ if ((off_timeout != 0)&&(suspend_timeout > off_timeout))
+ {
+ fprintf(stderr, "illegal combination of values\n");
+ fprintf(stderr, " suspend time of %d is greater than off time of %d\n", suspend_timeout, off_timeout);
+ exit(0);
+ }
+ if ((suspend_timeout == 0)&&(off_timeout != 0)&&
+ (standby_timeout > off_timeout))
+ {
+ fprintf(stderr, "illegal combination of values\n");
+ fprintf(stderr, " standby time of %d is greater than off time of %d\n", standby_timeout, off_timeout);
+ exit(0);
+ }
+ DPMSEnable(dpy);
+ DPMSSetTimeouts(dpy, standby_timeout, suspend_timeout, off_timeout);
+ }
+ else if (i+1 < argc && strcmp(arg, "force") == 0) {
+ i++;
+ arg = argv[i];
+ /*
+ * The calls to usleep below are necessary to delay the actual
+ * DPMS mode setting briefly. Without them, it's likely that the
+ * mode will be set between the Down and Up key transitions, in
+ * which case the Up transition may immediately turn the display
+ * back on.
+ *
+ * On OS/2, use _sleep2()
+ */
+#ifdef SVR4
+# ifdef sun
+/* Anything to avoid linking with -lposix4 */
+# define Usleep(us) { \
+ struct ts { \
+ long tv_sec; \
+ long tv_nsec; \
+ } req; \
+ req.tv_sec = 0; \
+ req.tv_nsec = (us) * 1000;\
+ syscall(SYS_nanosleep, &req, NULL); \
+ }
+# endif
+# ifdef sgi
+# define Usleep(us) sginap((us) / 1000)
+# endif
+#endif
+#ifdef hpux
+# ifdef _XPG4_EXTENDED
+# define Usleep(us) usleep((us))
+# endif
+#endif
+#ifdef __EMX__
+# define Usleep(us) _sleep2((us / 1000 > 0) ? us / 1000 : 1)
+#endif
+#ifdef WIN32
+# define Usleep(us) Sleep(us)
+#endif
+#ifndef Usleep
+# if defined(SYSV) || defined(SVR4)
+# define Usleep(us) sleep((us / 1000000 > 0) ? us / 1000000 : 1)
+# else
+# define Usleep(us) usleep((us))
+# endif
+#endif
+ if (strcmp(arg, "on") == 0) {
+ DPMSEnable(dpy);
+ DPMSForceLevel(dpy, DPMSModeOn);
+ i++;
+ }
+ else if (strcmp(arg, "standby") == 0) {
+ DPMSEnable(dpy);
+ Usleep(100000);
+ DPMSForceLevel(dpy, DPMSModeStandby);
+ i++;
+ }
+ else if (strcmp(arg, "suspend") == 0) {
+ DPMSEnable(dpy);
+ Usleep(100000);
+ DPMSForceLevel(dpy, DPMSModeSuspend);
+ i++;
+ }
+ else if (strcmp(arg, "off") == 0) {
+ DPMSEnable(dpy);
+ Usleep(100000);
+ DPMSForceLevel(dpy, DPMSModeOff);
+ i++;
+ }
+ else {
+ fprintf(stderr, "bad parameter %s\n", arg);
+ i++;
+ }
+ }
+ }
+ else {
+ fprintf(stderr, "server does not have extension for dpms option\n");
+ }
+}
+#endif /* DPMSExtension */
+ else if (strcmp(arg, "s") == 0) {
+ if (i >= argc) {
+ set_saver(dpy, ALL, 0); /* Set everything to default */
+ break;
+ }
+ arg = argv[i];
+ if (strcmp(arg, "blank") == 0) { /* Alter blanking preference. */
+ set_saver(dpy, PREFER_BLANK, PreferBlanking);
+ i++;
+ }
+ else if (strcmp(arg, "noblank") == 0) { /* Ditto. */
+ set_saver(dpy, PREFER_BLANK, DontPreferBlanking);
+ i++;
+ }
+ else if (strcmp(arg, "expose") == 0) { /* Alter exposure preference. */
+ set_saver(dpy, ALLOW_EXP, AllowExposures);
+ i++;
+ }
+ else if (strcmp(arg, "noexpose") == 0) { /* Ditto. */
+ set_saver(dpy, ALLOW_EXP, DontAllowExposures);
+ i++;
+ }
+ else if (strcmp(arg, "off") == 0) {
+ set_saver(dpy, TIMEOUT, 0); /* Turn off screen saver. */
+ i++;
+ if (i >= argc)
+ break;
+ arg = argv[i];
+ if (strcmp(arg, "off") == 0) {
+ set_saver(dpy, INTERVAL, 0);
+ i++;
+ }
+ }
+ else if (strcmp(arg, "default") == 0) { /* Leave as default. */
+ set_saver(dpy, ALL, SERVER_DEFAULT);
+ i++;
+ }
+ else if (strcmp(arg, "on") == 0) { /* Turn on. */
+ set_saver(dpy, ALL, DEFAULT_TIMEOUT);
+ i++;
+ }
+ else if (strcmp(arg, "activate") == 0) { /* force it active */
+ XActivateScreenSaver(dpy);
+ i++;
+ }
+ else if (strcmp(arg, "reset") == 0) { /* force it inactive */
+ XResetScreenSaver(dpy);
+ i++;
+ }
+ else if (*arg >= '0' && *arg <= '9') { /* Set as user wishes. */
+ set_saver(dpy, TIMEOUT, atoi(arg));
+ i++;
+ if (i >= argc)
+ break;
+ arg = argv[i];
+ if (*arg >= '0' && *arg <= '9') {
+ set_saver(dpy, INTERVAL, atoi(arg));
+ i++;
+ }
+ }
+ }
+ else if (strcmp(arg, "-r") == 0) { /* Turn off one or all autorepeats */
+ auto_repeat_mode = OFF;
+ key = ALL; /* None specified */
+ arg = argv[i];
+ if (i < argc)
+ if (is_number(arg, 255)) {
+ key = atoi(arg);
+ i++;
+ }
+ set_repeat(dpy, key, auto_repeat_mode);
+ }
+ else if (strcmp(arg, "r") == 0) { /* Turn on one or all autorepeats */
+ auto_repeat_mode = ON;
+ key = ALL; /* None specified */
+ arg = argv[i];
+ if (i < argc)
+ if (strcmp(arg, "on") == 0) {
+ i++;
+ }
+ else if (strcmp(arg, "off") == 0) { /* ...except in this case. */
+ auto_repeat_mode = OFF;
+ i++;
+ }
+ else if (is_number(arg, 255)) {
+ key = atoi(arg);
+ i++;
+ }
+ set_repeat(dpy, key, auto_repeat_mode);
+ }
+ else if (strcmp(arg, "p") == 0) {
+ if (i + 1 >= argc)
+ usage ("missing argument to p", NULL);
+ arg = argv[i];
+ if (numpixels >= MAX_PIXEL_COUNT)
+ usage ("more than %d pixels specified", MAX_PIXEL_COUNT);
+ if (*arg >= '0' && *arg <= '9')
+ pixels[numpixels] = atoi(arg);
+ else
+ usage ("invalid pixel number %s", arg);
+ i++;
+ colors[numpixels] = argv[i];
+ i++;
+ numpixels++;
+ }
+ else if (strcmp(arg, "-k") == 0) {
+ set_lock(dpy, OFF);
+ }
+ else if (strcmp(arg, "k") == 0) {
+ set_lock(dpy, ON);
+ }
+ else if (strcmp(arg, "q") == 0 || strcmp(arg, "-q") == 0) {
+ query(dpy);
+ }
+ else
+ usage ("unknown option %s", arg);
+}
+
+if (numpixels)
+ set_pixels(dpy, pixels, colors, numpixels);
+
+XCloseDisplay (dpy);
+
+exit(error_status); /* Done. We can go home now. */
+}
+
+
+is_number(arg, maximum)
+ char *arg;
+ int maximum;
+{
+ register char *p;
+
+ if (arg[0] == '-' && arg[1] == '1' && arg[2] == '\0')
+ return(1);
+ for (p=arg; isdigit(*p); p++);
+ if (*p || atoi(arg) > maximum)
+ return(0);
+ return(1);
+}
+
+/* These next few functions do the real work (xsetting things).
+ */
+set_click(dpy, percent)
+Display *dpy;
+int percent;
+{
+XKeyboardControl values;
+XKeyboardState kbstate;
+values.key_click_percent = percent;
+if (percent == DEFAULT_ON)
+ values.key_click_percent = SERVER_DEFAULT;
+XChangeKeyboardControl(dpy, KBKeyClickPercent, &values);
+if (percent == DEFAULT_ON) {
+ XGetKeyboardControl(dpy, &kbstate);
+ if (!kbstate.key_click_percent) {
+ values.key_click_percent = -percent;
+ XChangeKeyboardControl(dpy, KBKeyClickPercent, &values);
+ }
+}
+return;
+}
+
+set_bell_vol(dpy, percent)
+Display *dpy;
+int percent;
+{
+XKeyboardControl values;
+XKeyboardState kbstate;
+values.bell_percent = percent;
+if (percent == DEFAULT_ON)
+ values.bell_percent = SERVER_DEFAULT;
+XChangeKeyboardControl(dpy, KBBellPercent, &values);
+if (percent == DEFAULT_ON) {
+ XGetKeyboardControl(dpy, &kbstate);
+ if (!kbstate.bell_percent) {
+ values.bell_percent = -percent;
+ XChangeKeyboardControl(dpy, KBBellPercent, &values);
+ }
+}
+return;
+}
+
+set_bell_pitch(dpy, pitch)
+Display *dpy;
+int pitch;
+{
+XKeyboardControl values;
+values.bell_pitch = pitch;
+XChangeKeyboardControl(dpy, KBBellPitch, &values);
+return;
+}
+
+set_bell_dur(dpy, duration)
+Display *dpy;
+int duration;
+{
+XKeyboardControl values;
+values.bell_duration = duration;
+XChangeKeyboardControl(dpy, KBBellDuration, &values);
+return;
+}
+
+/*
+ * Set, add, or subtract the path according to before and after flags:
+ *
+ * before after action
+ *
+ * 0 0 FontPath := path
+ * -1 0 FontPath := current - path
+ * 0 -1 FontPath := current - path
+ * 1 0 FontPath := path + current
+ * 0 1 FontPath := current + path
+ */
+
+set_font_path(dpy, path, special, before, after)
+ Display *dpy;
+ char *path;
+ int special, before, after;
+{
+ char **directoryList = NULL; int ndirs = 0;
+ char **currentList = NULL; int ncurrent = 0;
+
+ if (special) {
+ if (strcmp (path, "default") == 0) {
+ XSetFontPath (dpy, NULL, 0);
+ return;
+ }
+ if (strcmp (path, "rehash") == 0) {
+ currentList = XGetFontPath (dpy, &ncurrent);
+ if (!currentList) {
+ fprintf (stderr, "%s: unable to get current font path.\n",
+ progName);
+ return;
+ }
+ XSetFontPath (dpy, currentList, ncurrent);
+ XFreeFontPath (currentList);
+ return;
+ }
+ /*
+ * for now, fall though and process keyword and directory list for
+ * compatibility with previous versions.
+ */
+ }
+
+ /*
+ * parse the path list. If before or after is non-zero, we'll need
+ * the current value.
+ */
+
+ if (before != 0 || after != 0) {
+ currentList = XGetFontPath (dpy, &ncurrent);
+ if (!currentList) {
+ fprintf (stderr, "%s: unable to get old font path.\n",
+ progName);
+ before = after = 0;
+ }
+ }
+
+ {
+ /* count the number of directories in path */
+ register char *cp = path;
+
+ ndirs = 1;
+ while ((cp = strchr(cp, ',')) != NULL) {
+ ndirs++;
+ cp++;
+ }
+ }
+
+ directoryList = (char **) malloc (ndirs*sizeof (char *));
+ if (!directoryList) error ("out of memory for font path directory list");
+
+ {
+ /* mung the path and set directoryList pointers */
+ int i = 0;
+ char *cp = path;
+
+ directoryList[i++] = cp;
+ while ((cp = strchr(cp, ',')) != NULL) {
+ directoryList[i++] = cp + 1;
+ *cp++ = '\0';
+ }
+ if (i != ndirs) {
+ fprintf (stderr,
+ "%s: internal error, only parsed %d of %d directories.\n",
+ progName, i, ndirs);
+ exit (1);
+ }
+ }
+
+ /*
+ * now we have have parsed the input path, so we can set it
+ */
+
+ if (before == 0 && after == 0) {
+ XSetFontPath (dpy, directoryList, ndirs);
+ }
+
+ /* if adding to list, build a superset */
+ if (before > 0 || after > 0) {
+ int nnew = ndirs + ncurrent;
+ char **newList = (char **) malloc (nnew * sizeof (char *));
+
+ if (!newList) error ("out of memory");
+ if (before > 0) { /* new + current */
+ memmove( (char *) newList, (char *) directoryList,
+ (unsigned) (ndirs*sizeof (char *)));
+ memmove( (char *) (newList + ndirs), (char *) currentList,
+ (unsigned) (ncurrent*sizeof (char *)));
+ XSetFontPath (dpy, newList, nnew);
+ } else if (after > 0) {
+ memmove( (char *) newList, (char *) currentList,
+ (unsigned) (ncurrent*sizeof (char *)));
+ memmove( (char *) (newList + ncurrent), (char *) directoryList,
+ (unsigned) (ndirs*sizeof (char *)));
+ XSetFontPath (dpy, newList, nnew);
+ }
+ free ((char *) newList);
+ }
+
+ /* if deleting from list, build one the same size */
+ if (before < 0 || after < 0) {
+ int i, j;
+ int nnew = 0;
+ char **newList = (char **) malloc (ncurrent * sizeof (char *));
+
+ if (!newList) error ("out of memory");
+ for (i = 0; i < ncurrent; i++) {
+ for (j = 0; j < ndirs; j++) {
+ if (strcmp (currentList[i], directoryList[j]) == 0)
+ break;
+ }
+ /* if we ran out, then insert into new list */
+ if (j == ndirs) newList[nnew++] = currentList[i];
+ }
+ if (nnew == ncurrent) {
+ fprintf (stderr,
+ "%s: warning, no entries deleted from font path.\n",
+ progName);
+ }
+ XSetFontPath (dpy, newList, nnew);
+ free ((char *) newList);
+ }
+
+ if (directoryList) free ((char *) directoryList);
+ if (currentList) XFreeFontPath (currentList);
+
+ return;
+}
+
+
+set_led(dpy, led, led_mode)
+Display *dpy;
+int led, led_mode;
+{
+ XKeyboardControl values;
+ values.led_mode = led_mode;
+ if (led != ALL) {
+ values.led = led;
+ XChangeKeyboardControl(dpy, KBLed | KBLedMode, &values);
+ }
+ else {
+ XChangeKeyboardControl(dpy, KBLedMode, &values);
+ }
+ return;
+}
+
+set_mouse(dpy, acc_num, acc_denom, threshold)
+Display *dpy;
+int acc_num, acc_denom, threshold;
+{
+int do_accel = True, do_threshold = True;
+
+if (acc_num == DONT_CHANGE) /* what an incredible crock... */
+ do_accel = False;
+if (threshold == DONT_CHANGE)
+ do_threshold = False;
+if (acc_num < 0) /* shouldn't happen */
+ acc_num = SERVER_DEFAULT;
+if (acc_denom <= 0) /* prevent divide by zero */
+ acc_denom = SERVER_DEFAULT;
+if (threshold < 0) threshold = SERVER_DEFAULT;
+XChangePointerControl(dpy, do_accel, do_threshold, acc_num,
+ acc_denom, threshold);
+return;
+}
+
+set_saver(dpy, mask, value)
+Display *dpy;
+int mask, value;
+{
+ int timeout, interval, prefer_blank, allow_exp;
+ XGetScreenSaver(dpy, &timeout, &interval, &prefer_blank,
+ &allow_exp);
+ if (mask == TIMEOUT) timeout = value;
+ if (mask == INTERVAL) interval = value;
+ if (mask == PREFER_BLANK) prefer_blank = value;
+ if (mask == ALLOW_EXP) allow_exp = value;
+ if (mask == ALL) {
+ timeout = SERVER_DEFAULT;
+ interval = SERVER_DEFAULT;
+ prefer_blank = DefaultBlanking;
+ allow_exp = DefaultExposures;
+ }
+ XSetScreenSaver(dpy, timeout, interval, prefer_blank,
+ allow_exp);
+ if (mask == ALL && value == DEFAULT_TIMEOUT) {
+ XGetScreenSaver(dpy, &timeout, &interval, &prefer_blank, &allow_exp);
+ if (!timeout)
+ XSetScreenSaver(dpy, -DEFAULT_TIMEOUT, interval, prefer_blank,
+ allow_exp);
+ }
+ return;
+}
+
+set_repeat(dpy, key, auto_repeat_mode)
+Display *dpy;
+int key, auto_repeat_mode;
+{
+ XKeyboardControl values;
+ values.auto_repeat_mode = auto_repeat_mode;
+ if (key != ALL) {
+ values.key = key;
+ XChangeKeyboardControl(dpy, KBKey | KBAutoRepeatMode, &values);
+ }
+ else {
+ XChangeKeyboardControl(dpy, KBAutoRepeatMode, &values);
+ }
+ return;
+}
+
+set_pixels(dpy, pixels, colors, numpixels)
+Display *dpy;
+unsigned long *pixels;
+caddr_t *colors;
+int numpixels;
+{
+ XColor def;
+ int scr = DefaultScreen (dpy);
+ Visual *visual = DefaultVisual (dpy, scr);
+ Colormap cmap = DefaultColormap (dpy, scr);
+ unsigned long max_cells = DisplayCells(dpy, scr);
+ XVisualInfo viproto, *vip;
+ int nvisuals = 0;
+ char *visual_type = NULL;
+ int i;
+
+ viproto.visualid = XVisualIDFromVisual (visual);
+ vip = XGetVisualInfo (dpy, VisualIDMask, &viproto, &nvisuals);
+ if (!vip) {
+ fprintf (stderr, "%s: Can't get visual for visualID 0x%x\n",
+ progName, viproto.visualid);
+ return;
+ }
+
+ switch (vip->class) {
+ case GrayScale:
+ case PseudoColor:
+ break;
+ case TrueColor:
+ visual_type = "TrueColor";
+ /* fall through */
+ case DirectColor:
+ max_cells *= max_cells * max_cells;
+ break;
+ case StaticGray:
+ visual_type = "StaticGray";
+ break;
+ case StaticColor:
+ visual_type = "StaticColor";
+ break;
+ default:
+ fprintf (stderr, "%s: unknown visual class type %d\n",
+ progName, vip->class);
+ numpixels = 0;
+ }
+
+ if (visual_type) {
+ fprintf (stderr, "%s: cannot set pixel values in read-only %s visuals\n",
+ progName, visual_type);
+ } else {
+ for (i = 0; i < numpixels; i++) {
+ def.pixel = pixels[i];
+ if (def.pixel >= max_cells)
+ fprintf(stderr,
+ "%s: pixel value %ld out of colormap range 0 through %ld\n",
+ progName, def.pixel, max_cells - 1);
+ else {
+ if (XParseColor (dpy, cmap, colors[i], &def))
+ XStoreColor(dpy, cmap, &def);
+ else
+ fprintf (stderr, "%s: invalid color \"%s\"\n", progName, colors[i]);
+ }
+ }
+ }
+
+ XFree ((char *) vip);
+
+ return;
+}
+
+set_lock(dpy, onoff)
+Display *dpy;
+Bool onoff;
+{
+ XModifierKeymap *mods;
+ mods = XGetModifierMapping(dpy);
+
+ if (onoff)
+ mods = XInsertModifiermapEntry(mods, XK_Caps_Lock, LockMapIndex);
+ else
+ mods = XDeleteModifiermapEntry(mods, XK_Caps_Lock, LockMapIndex);
+ XSetModifierMapping(dpy, mods);
+ return;
+}
+
+char *on_or_off (val, onval, onstr, offval, offstr, buf)
+ int val, onval, offval;
+ char *onstr, *offstr;
+ char buf[];
+{
+ if (val == onval)
+ return onstr;
+ else if (val == offval)
+ return offstr;
+
+ buf[0] = '\0';
+ sprintf (buf, "<%d>", val);
+ return buf;
+}
+
+
+/* This is the information-getting function for telling the user what the
+ * current "xsettings" are.
+ */
+query(dpy)
+Display *dpy;
+{
+int scr = DefaultScreen (dpy);
+XKeyboardState values;
+int acc_num, acc_denom, threshold;
+int timeout, interval, prefer_blank, allow_exp;
+char **font_path; int npaths;
+int i, j;
+char buf[20]; /* big enough for 16 bit number */
+
+XGetKeyboardControl(dpy, &values);
+XGetPointerControl(dpy, &acc_num, &acc_denom, &threshold);
+XGetScreenSaver(dpy, &timeout, &interval, &prefer_blank, &allow_exp);
+font_path = XGetFontPath(dpy, &npaths);
+
+printf ("Keyboard Control:\n");
+printf (" auto repeat: %s key click percent: %d LED mask: %08lx\n",
+ on_or_off (values.global_auto_repeat,
+ AutoRepeatModeOn, "on", AutoRepeatModeOff, "off", buf),
+ values.key_click_percent, values.led_mask);
+printf (" auto repeating keys: ");
+for (i = 0; i < 4; i++) {
+ if (i) printf (" ");
+ for (j = 0; j < 8; j++) {
+ printf ("%02x", (unsigned char)values.auto_repeats[i*8 + j]);
+ }
+ printf ("\n");
+}
+printf (" bell percent: %d bell pitch: %d bell duration: %d\n",
+ values.bell_percent, values.bell_pitch, values.bell_duration);
+
+printf ("Pointer Control:\n");
+printf (" acceleration: %d/%d threshold: %d\n",
+ acc_num, acc_denom, threshold);
+
+printf ("Screen Saver:\n");
+printf (" prefer blanking: %s ",
+ on_or_off (prefer_blank, PreferBlanking, "yes",
+ DontPreferBlanking, "no", buf));
+printf ("allow exposures: %s\n",
+ on_or_off (allow_exp, AllowExposures, "yes",
+ DontAllowExposures, "no", buf));
+printf (" timeout: %d cycle: %d\n", timeout, interval);
+
+printf ("Colors:\n");
+printf (" default colormap: 0x%lx BlackPixel: %d WhitePixel: %d\n",
+ DefaultColormap (dpy, scr),
+ BlackPixel (dpy, scr), WhitePixel (dpy, scr));
+
+printf ("Font Path:\n");
+if (npaths) {
+ printf( " %s", *font_path++ );
+ for( --npaths; npaths; npaths-- )
+ printf( ",%s", *font_path++ );
+ printf( "\n" );
+} else {
+ printf (" (empty)\n");
+}
+
+#ifdef MITMISC
+{
+ int dummy;
+ if (XMITMiscQueryExtension(dpy, &dummy, &dummy)) {
+ if (XMITMiscGetBugMode(dpy))
+ printf ("Bug Mode: compatibility mode is enabled\n");
+ else
+ printf ("Bug Mode: compatibility mode is disabled\n");
+ }
+}
+#endif
+#ifdef DPMSExtension
+{
+
+ int dummy;
+ CARD16 standby, suspend, off;
+ BOOL onoff;
+ CARD16 state;
+
+ printf("DPMS (Energy Star):\n");
+ if (DPMSQueryExtension(dpy, &dummy, &dummy)) {
+ if (DPMSCapable(dpy)) {
+ DPMSGetTimeouts(dpy, &standby, &suspend, &off);
+ printf (" Standby: %d Suspend: %d Off: %d\n",
+ standby, suspend, off);
+ DPMSInfo(dpy, &state, &onoff);
+ if (onoff) {
+ printf(" DPMS is enabled\n");
+ switch (state) {
+ case DPMSModeOn:
+ printf(" Monitor is on\n");
+ break;
+ case DPMSModeStandby:
+ printf(" Monitor is in standby\n");
+ break;
+ case DPMSModeSuspend:
+ printf(" Monitor is in suspend\n");
+ break;
+ case DPMSModeOff:
+ printf(" Monitor is off\n");
+ break;
+ default:
+ printf(" Unrecognized response from server\n");
+ }
+ }
+ else
+ printf(" DPMS is disabled\n");
+ }
+ else
+ printf (" Display is not capable of DPMS\n");
+ }
+ else {
+ printf (" Server does not have the DPMS Extension\n");
+ }
+}
+#endif
+
+return;
+}
+
+
+/* This is the usage function */
+
+usage (fmt, arg)
+ char *fmt;
+ char *arg;
+{
+ if (fmt) {
+ fprintf (stderr, "%s: ", progName);
+ fprintf (stderr, fmt, arg);
+ fprintf (stderr, "\n\n");
+ }
+
+ fprintf (stderr, "usage: %s [-display host:dpy] option ...\n", progName);
+ fprintf (stderr, " To turn bell off:\n");
+ fprintf (stderr, "\t-b b off b 0\n");
+ fprintf (stderr, " To set bell volume, pitch and duration:\n");
+ fprintf (stderr, "\t b [vol [pitch [dur]]] b on\n");
+#ifdef MITMISC
+ fprintf (stderr, " To disable bug compatibility mode:\n");
+ fprintf (stderr, "\t-bc\n");
+ fprintf (stderr, " To enable bug compatibility mode:\n");
+ fprintf (stderr, "\tbc\n");
+#endif
+ fprintf (stderr, " To turn keyclick off:\n");
+ fprintf (stderr, "\t-c c off c 0\n");
+ fprintf (stderr, " To set keyclick volume:\n");
+ fprintf (stderr, "\t c [0-100] c on\n");
+#ifdef DPMSExtension
+ fprintf (stderr, " To control Energy Star (DPMS) features:\n");
+ fprintf (stderr, "\t-dpms Energy Star features off\n");
+ fprintf (stderr, "\t+dpms Energy Star features on\n");
+ fprintf (stderr, "\t dpms [standby [suspend [off]]] \n");
+ fprintf (stderr, "\t force standby \n");
+ fprintf (stderr, "\t force suspend \n");
+ fprintf (stderr, "\t force off \n");
+ fprintf (stderr, "\t (also implicitly enables DPMS features) \n");
+ fprintf (stderr, "\t a timeout value of zero disables the mode \n");
+#endif
+ fprintf (stderr, " To set the font path:\n" );
+ fprintf (stderr, "\t fp= path[,path...]\n" );
+ fprintf (stderr, " To restore the default font path:\n");
+ fprintf (stderr, "\t fp default\n");
+ fprintf (stderr, " To have the server reread font databases:\n");
+ fprintf (stderr, "\t fp rehash\n");
+ fprintf (stderr, " To remove elements from font path:\n");
+ fprintf (stderr, "\t-fp path[,path...] fp- path[,path...]\n");
+ fprintf (stderr, " To prepend or append elements to font path:\n");
+ fprintf (stderr, "\t+fp path[,path...] fp+ path[,path...]\n");
+ fprintf (stderr, " To set LED states off or on:\n");
+ fprintf (stderr, "\t-led [1-32] led off\n");
+ fprintf (stderr, "\t led [1-32] led on\n");
+ fprintf (stderr, " To set mouse acceleration and threshold:\n");
+ fprintf (stderr, "\t m [acc_mult[/acc_div] [thr]] m default\n");
+ fprintf (stderr, " To set pixel colors:\n");
+ fprintf (stderr, "\t p pixel_value color_name\n");
+ fprintf (stderr, " To turn auto-repeat off or on:\n");
+ fprintf (stderr, "\t-r [keycode] r off\n");
+ fprintf (stderr, "\t r [keycode] r on\n");
+ fprintf (stderr, " For screen-saver control:\n");
+ fprintf (stderr, "\t s [timeout [cycle]] s default s on\n");
+ fprintf (stderr, "\t s blank s noblank s off\n");
+ fprintf (stderr, "\t s expose s noexpose\n");
+ fprintf (stderr, "\t s activate s reset\n");
+ fprintf (stderr, " For status information: q\n");
+ exit(0);
+}
+
+error( message )
+ char *message;
+{
+ fprintf( stderr, "%s: %s\n", progName, message );
+ exit( 1 );
+}
+
+
+int local_xerror (dpy, rep)
+ Display *dpy;
+ XErrorEvent *rep;
+{
+ if (rep->request_code == X_SetFontPath && rep->error_code == BadValue) {
+ fprintf(stderr,
+ "%s: bad font path element (#%d), possible causes are:\n",
+ progName, rep->resourceid);
+ fprintf(stderr," Directory does not exist or has wrong permissions\n");
+ fprintf(stderr," Directory missing fonts.dir\n");
+ fprintf(stderr," Incorrect font server address or syntax\n");
+ } else if (rep->request_code == X_StoreColors) {
+ switch (rep->error_code) {
+ case BadAccess:
+ fprintf(stderr,
+ "%s: pixel not allocated read/write\n", progName);
+ break;
+ case BadValue:
+ fprintf(stderr,
+ "%s: cannot store in pixel 0x%lx, invalid pixel number\n",
+ progName, rep->resourceid);
+ break;
+ default:
+ XmuPrintDefaultErrorMessage (dpy, rep, stderr);
+ }
+ } else
+ XmuPrintDefaultErrorMessage (dpy, rep, stderr);
+
+ error_status = -1;
+
+ return (0);
+}
diff --git a/xset.man b/xset.man
new file mode 100644
index 0000000..c92de27
--- /dev/null
+++ b/xset.man
@@ -0,0 +1,214 @@
+.\" $Xorg: xset.man,v 1.4 2001/02/09 02:05:59 xorgcvs Exp $
+.\" Copyright 1988, 1998 The Open Group
+.\"
+.\" Permission to use, copy, modify, distribute, and sell this software 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.
+.\"
+.\" The above copyright notice and this permission notice shall be included
+.\" in all copies or substantial portions of the Software.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
+.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+.\" OTHER DEALINGS IN THE SOFTWARE.
+.\"
+.\" Except as contained in this notice, the name of The Open Group shall
+.\" not be used in advertising or otherwise to promote the sale, use or
+.\" other dealings in this Software without prior written authorization
+.\" from The Open Group.
+.TH XSET 1 "Release 6.4" "X Version 11"
+.SH NAME
+xset - user preference utility for X
+.SH SYNOPSIS
+.B xset
+[-display \fIdisplay\fP]
+[-b] [b on/off] [b [\fIvolume\fP [\fIpitch\fP [\fIduration\fP]]]
+[[-]bc]
+[-c] [c on/off] [c [\fIvolume\fP]]
+[[-+]fp[-+=] \fIpath\fP[,\fIpath\fP[,...]]] [fp default] [fp rehash]
+[[-]led [\fIinteger\fP]] [led on/off]
+[m[ouse] [\fIaccel_mult\fP[/\fIaccel_div\fP] [\fIthreshold\fP]]] [m[ouse] default]
+[p \fIpixel\fP \fIcolor\fP]
+[[-]r [keycode]] [r on/off]
+[s [\fIlength\fP [\fIperiod\fP]]] [s blank/noblank]
+[s expose/noexpose] [s on/off] [s default] [s activate] [s reset]
+[q]
+.SH DESCRIPTION
+This program is used to set various user preference options of the display.
+.SH OPTIONS
+.PP
+.TP 8
+.B \-display \fIdisplay\fP
+This option specifies the server to use; see \fIX(1)\fP.
+.PP
+.TP 8
+.B b
+The \fBb\fP option controls bell volume, pitch and duration.
+This option accepts up to three numerical parameters, a preceding
+dash(-), or a 'on/off' flag. If no parameters are
+given, or the 'on' flag is used, the system defaults will be used.
+If the dash or 'off' are given, the bell will be turned
+off.
+If only one numerical parameter is given, the
+bell volume will be set to that value, as a percentage of its maximum.
+Likewise, the second numerical
+parameter specifies the bell pitch, in hertz, and
+the third numerical parameter
+specifies the duration in milliseconds. Note that not
+all hardware can vary the bell characteristics. The X server will set
+the characteristics of the bell as closely as it can to the user's
+specifications.
+.PP
+.TP 8
+.B bc
+The \fBbc\fP option controls \fIbug compatibility\fP mode in the server,
+if possible; a preceding dash(-) disables the mode, otherwise the mode
+is enabled. Various pre-R4 clients pass illegal values in some
+protocol requests, and pre-R4 servers did not correctly generate
+errors in these cases. Such clients, when run against an R4 server,
+will terminate abnormally or otherwise fail to operate correctly.
+Bug compatibility mode explicitly reintroduces certain bugs into the
+X server, so that many such clients can still be run. This mode should be
+used with care; new application development should be done with this mode
+disabled. The server must support the MIT-SUNDRY-NONSTANDARD
+protocol extension in order for this option to work.
+.TP 8
+.B c
+The \fBc\fP option controls key click.
+This option can take an optional value, a preceding dash(-),
+or an 'on/off' flag.
+If no parameter or the 'on' flag is given, the system defaults
+will be used. If the dash or 'off' flag is used, keyclick will be
+disabled.
+If a value from 0 to 100 is given, it is used to
+indicate volume, as a percentage of the maximum.
+The X server will set
+the volume to the nearest value that the hardware can support.
+.PP
+.TP 8
+.B fp= \fIpath,...\fP
+The \fBfp=\fP sets the font path to the entries given in the path argument.
+The entries are interpreted by the server, not by the client.
+Typically they are directory names or font server names, but the
+interpretation is server-dependent.
+.TP 8
+.B fp \fBdefault\fP
+The \fBdefault\fP argument causes the font path to be reset to the server's
+default.
+.TP 8
+.B fp \fBrehash\fP
+The \fBrehash\fP argument resets the font path to its current value,
+causing the server to reread the font databases in
+the current font path. This is generally only used when adding new fonts to
+a font directory (after running \fImkfontdir\fP to recreate the font database).
+.PP
+.TP 8
+.B "\-fp \fRor\fP fp\-"
+The \fB\-fp\fP and \fBfp\-\fP options remove elements from the current
+font path. They must be followed by a comma-separated list of entries.
+.PP
+.TP 8
+.B "\+fp \fRor\fP fp\+"
+This \fB\+fp\fP and \fBfp\+\fP options prepend and append elements to the
+current font path, respectively. They must be followed by a comma-separated
+list of entries.
+.PP
+.TP 8
+.B led
+The \fBled\fP option controls the keyboard LEDs.
+This controls the turning on or off of one or all of the LEDs.
+It accepts an optional integer, a preceding dash(-) or an 'on/off' flag.
+If no parameter or the 'on' flag is given, all LEDs are turned on.
+If a preceding dash or the flag 'off' is given, all LEDs are turned off.
+If a value between 1 and 32 is given, that LED will be turned on or off
+depending on the existence of a preceding dash.
+A common LED which can be controlled is the ``Caps Lock'' LED. ``xset
+led 3'' would turn led #3 on. ``xset -led 3'' would turn it off.
+The particular LED values may refer to different LEDs on different
+hardware.
+.PP
+.TP 8
+.B m
+The \fBm\fP option controls the mouse parameters.
+The parameters for the mouse are `acceleration' and `threshold'.
+The acceleration can be specified as an integer, or as a simple
+fraction.
+The mouse, or whatever pointer the machine is connected to,
+will go `acceleration' times as fast when it travels more than `threshold'
+pixels in a short time. This way, the mouse can be used for precise
+alignment when it is moved slowly, yet it can be set to travel across
+the screen in a flick of the wrist when desired. One or both
+parameters for the
+.B m
+option can be omitted, but if only one is
+given, it will be interpreted as the acceleration.
+If no parameters or the flag 'default' is used, the system defaults will
+be set.
+.PP
+.TP 8
+.B p
+The \fBp\fP option controls pixel color values.
+The parameters are the color map entry number in decimal,
+and a color specification. The root background colors may be changed
+on some servers by altering the entries for BlackPixel and WhitePixel.
+Although these are often 0 and 1, they need not be. Also, a server may
+choose to allocate those colors privately, in which case an error will
+be generated. The map entry must not be a read-only color,
+or an error will result.
+.PP
+.TP 8
+.B r
+The \fBr\fP option controls the autorepeat.
+If a preceding dash or the 'off' flag is used, autorepeat will be disabled.
+If no parameters or the 'on' flag is used, autorepeat will be enabled.
+If a specific keycode is specified as a parameter, autorepeat for that
+keycode is enabled or disabled.
+.PP
+.TP 8
+.B s
+The \fBs\fP option lets you set the screen saver parameters.
+This option accepts up to two numerical parameters, a 'blank/noblank'
+flag, an 'expose/noexpose' flag, an 'on/off' flag, an 'activate/reset' flag,
+or the 'default' flag.
+If no parameters or the 'default' flag is used, the system will be set
+to its default screen saver characteristics.
+The 'on/off' flags simply turn the screen saver functions on or off.
+The 'activate' flag forces activation of screen saver even if the screen
+saver had been turned off.
+The 'reset' flag forces deactivation of screen saver if it is active.
+The 'blank' flag sets the
+preference to blank the video (if the hardware can do so) rather than
+display a background pattern, while 'noblank' sets the
+preference to display a pattern rather than blank the video.
+The 'expose' flag sets the
+preference to allow window exposures (the server can freely discard
+window contents), while 'noexpose' sets the preference to disable
+screen saver unless the server can regenerate the screens without
+causing exposure events.
+The length and period
+parameters for the screen saver function determines how long the
+server must be inactive for screen saving to activate, and the period
+to change the background pattern to avoid burn in.
+The arguments are specified in seconds.
+If only one numerical parameter is given, it will be used for the length.
+.PP
+.TP 8
+.B q
+The \fBq\fP option gives you information on the current settings.
+.PP
+These settings will be reset to default values when you log out.
+.PP
+Note that not all X implementations are guaranteed to honor all of these
+options.
+.SH "SEE ALSO"
+X(1), Xserver(1), xmodmap(1), xrdb(1), xsetroot(1)
+.SH AUTHOR
+Bob Scheifler, MIT Laboratory for Computer Science
+.br
+David Krikorian, MIT Project Athena (X11 version)