1 /* dpms.c --- syncing the X Display Power Management values
2 * xscreensaver, Copyright (c) 2001-2011 Jamie Zawinski <jwz@jwz.org>
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
13 /* Display Power Management System (DPMS.)
15 On XFree86 systems, "man xset" reports:
17 -dpms The -dpms option disables DPMS (Energy Star) features.
18 +dpms The +dpms option enables DPMS (Energy Star) features.
21 The dpms option allows the DPMS (Energy Star)
22 parameters to be set. The option can take up to three
23 numerical values, or the `force' flag followed by a
24 DPMS state. The `force' flags forces the server to
25 immediately switch to the DPMS state specified. The
26 DPMS state can be one of `standby', `suspend', or
27 `off'. When numerical values are given, they set the
28 inactivity period before the three modes are activated.
29 The first value given is for the `standby' mode, the
30 second is for the `suspend' mode, and the third is for
31 the `off' mode. Setting these values implicitly
32 enables the DPMS features. A value of zero disables a
35 However, note that the implementation is more than a little bogus,
36 in that there is code in /usr/X11R6/lib/libXdpms.a to implement all
37 the usual server-extension-querying utilities -- but there are no
38 prototypes in any header file! Thus, the prototypes here. (The
39 stuff in X11/extensions/dpms.h and X11/extensions/dpmsstr.h define
40 the raw X protcol, they don't define the API to libXdpms.a.)
43 Library: ftp://ftp.x.org/pub/R6.4/xc/doc/specs/Xext/DPMSLib.ms
44 Protocol: ftp://ftp.x.org/pub/R6.4/xc/doc/specs/Xext/DPMS.ms
54 #ifdef HAVE_DPMS_EXTENSION /* almost the whole file */
56 # include <X11/Xproto.h>
57 # include <X11/extensions/dpms.h>
58 /*# include <X11/extensions/dpmsstr.h>*/
60 /* Why this crap is not in a header file somewhere, I have no idea. Losers!
62 extern Bool DPMSQueryExtension (Display *, int *event_ret, int *err_ret);
63 extern Status DPMSGetVersion (Display *, int *major_ret, int *minor_ret);
64 extern Bool DPMSCapable (Display *);
65 extern Status DPMSInfo (Display *, CARD16 *power_level, BOOL *state);
66 extern Status DPMSEnable (Display *dpy);
67 extern Status DPMSDisable (Display *dpy);
68 extern Status DPMSForceLevel (Display *, CARD16 level);
69 extern Status DPMSSetTimeouts (Display *, CARD16 standby, CARD16 suspend,
71 extern Bool DPMSGetTimeouts (Display *, CARD16 *standby,
72 CARD16 *suspend, CARD16 *off);
74 #endif /* HAVE_DPMS_EXTENSION */
77 /* This file doesn't need the Xt headers, so stub these types out... */
79 #define XtAppContext void*
80 #define XrmDatabase void*
81 #define XtIntervalId void*
82 #define XtPointer void*
85 #include "xscreensaver.h"
87 #ifdef HAVE_DPMS_EXTENSION
90 sync_server_dpms_settings (Display *dpy, Bool enabled_p,
91 int standby_secs, int suspend_secs, int off_secs,
94 int event = 0, error = 0;
95 BOOL o_enabled = False;
97 CARD16 o_standby = 0, o_suspend = 0, o_off = 0;
100 if (standby_secs == 0 && suspend_secs == 0 && off_secs == 0)
101 /* all zero implies "DPMS disabled" */
104 else if ((standby_secs != 0 && standby_secs < 10) ||
105 (suspend_secs != 0 && suspend_secs < 10) ||
106 (off_secs != 0 && off_secs < 10))
107 /* any negative, or any positive-and-less-than-10-seconds, is crazy. */
110 if (bogus_p) enabled_p = False;
112 /* X protocol sends these values in a CARD16, so truncate them to 16 bits.
113 This means that the maximum timeout is 18:12:15.
115 if (standby_secs > 0xFFFF) standby_secs = 0xFFFF;
116 if (suspend_secs > 0xFFFF) suspend_secs = 0xFFFF;
117 if (off_secs > 0xFFFF) off_secs = 0xFFFF;
119 if (! DPMSQueryExtension (dpy, &event, &error))
122 fprintf (stderr, "%s: XDPMS extension not supported.\n", blurb());
126 if (! DPMSCapable (dpy))
129 fprintf (stderr, "%s: DPMS not supported.\n", blurb());
133 if (! DPMSInfo (dpy, &o_power, &o_enabled))
136 fprintf (stderr, "%s: unable to get DPMS state.\n", blurb());
140 if (o_enabled != enabled_p)
142 if (! (enabled_p ? DPMSEnable (dpy) : DPMSDisable (dpy)))
145 fprintf (stderr, "%s: unable to set DPMS state.\n", blurb());
149 fprintf (stderr, "%s: turned DPMS %s.\n", blurb(),
150 enabled_p ? "on" : "off");
156 fprintf (stderr, "%s: not setting bogus DPMS timeouts: %d %d %d.\n",
157 blurb(), standby_secs, suspend_secs, off_secs);
161 if (!DPMSGetTimeouts (dpy, &o_standby, &o_suspend, &o_off))
164 fprintf (stderr, "%s: unable to get DPMS timeouts.\n", blurb());
168 if (o_standby != standby_secs ||
169 o_suspend != suspend_secs ||
172 if (!DPMSSetTimeouts (dpy, standby_secs, suspend_secs, off_secs))
175 fprintf (stderr, "%s: unable to set DPMS timeouts.\n", blurb());
179 fprintf (stderr, "%s: set DPMS timeouts: %d %d %d.\n", blurb(),
180 standby_secs, suspend_secs, off_secs);
185 monitor_powered_on_p (saver_info *si)
188 int event_number, error_number;
192 if (!DPMSQueryExtension(si->dpy, &event_number, &error_number))
193 /* Server doesn't know -- assume the monitor is on. */
196 else if (!DPMSCapable(si->dpy))
197 /* Server says the monitor doesn't do power management -- so it's on. */
202 DPMSInfo(si->dpy, &state, &onoff);
204 /* Server says DPMS is disabled -- so the monitor is on. */
208 case DPMSModeOn: result = True; break; /* really on */
209 case DPMSModeStandby: result = False; break; /* kinda off */
210 case DPMSModeSuspend: result = False; break; /* pretty off */
211 case DPMSModeOff: result = False; break; /* really off */
212 default: result = True; break; /* protocol error? */
220 monitor_power_on (saver_info *si, Bool on_p)
222 if ((!!on_p) != monitor_powered_on_p (si))
224 int event_number, error_number;
225 if (!DPMSQueryExtension(si->dpy, &event_number, &error_number) ||
226 !DPMSCapable(si->dpy))
228 if (si->prefs.verbose_p)
230 "%s: unable to power %s monitor: no DPMS extension.\n",
231 blurb(), (on_p ? "on" : "off"));
235 DPMSForceLevel(si->dpy, (on_p ? DPMSModeOn : DPMSModeOff));
236 XSync(si->dpy, False);
238 if ((!!on_p) != monitor_powered_on_p (si)) /* double-check */
240 "%s: DPMSForceLevel(dpy, %s) did not change monitor power state.\n",
242 (on_p ? "DPMSModeOn" : "DPMSModeOff"));
246 #else /* !HAVE_DPMS_EXTENSION */
249 sync_server_dpms_settings (Display *dpy, Bool enabled_p,
250 int standby_secs, int suspend_secs, int off_secs,
254 fprintf (stderr, "%s: DPMS support not compiled in.\n", blurb());
258 monitor_powered_on_p (saver_info *si)
264 monitor_power_on (saver_info *si, Bool on_p)
269 #endif /* !HAVE_DPMS_EXTENSION */