X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=driver%2Fxscreensaver.h;h=4232c711a5f2d46da731e634832ccf91f3351134;hb=a1d41b2aa6e18bf9a49b914a99dda8232c5d7762;hp=6dba82a64bf5fa951d655efbf95150bf216c698b;hpb=f3e0240915ed9f9b3a61781f5c7002d587563fe0;p=xscreensaver diff --git a/driver/xscreensaver.h b/driver/xscreensaver.h index 6dba82a6..4232c711 100644 --- a/driver/xscreensaver.h +++ b/driver/xscreensaver.h @@ -1,4 +1,4 @@ -/* xscreensaver, Copyright (c) 1993-1997 Jamie Zawinski +/* xscreensaver, Copyright (c) 1993-2001 Jamie Zawinski * * Permission to use, copy, modify, distribute, and sell this software and its * documentation for any purpose is hereby granted without fee, provided that @@ -20,62 +20,27 @@ #include #include +#include "prefs.h" + extern char *progname; extern char *progclass; -typedef struct saver_preferences saver_preferences; typedef struct saver_info saver_info; typedef struct saver_screen_info saver_screen_info; - +typedef struct passwd_dialog_data passwd_dialog_data; +typedef struct splash_dialog_data splash_dialog_data; #undef countof #define countof(x) (sizeof((x))/sizeof((*x))) -/* This structure holds all the user-specified parameters, read from the - command line, the resource database, or entered through a dialog box. - */ -struct saver_preferences { - Bool verbose_p; - Bool lock_p; /* whether to lock as well as save */ - - Bool debug_p; - Bool fade_p; /* whether to fade to black */ - Bool unfade_p; /* whether to fade from black */ - int fade_seconds; /* how long that should take */ - int fade_ticks; /* how many ticks should be used */ - - Bool install_cmap_p; /* whether we should use our own colormap - when using the screen's default visual. */ - - char **screenhacks; /* the programs to run */ - int screenhacks_count; - - int nice_inferior; /* nice value for subprocs */ - - int initial_delay; /* how long to sleep after launch */ - Time timeout; /* how much idle time before activation */ - Time lock_timeout; /* how long after activation locking starts */ - Time cycle; /* how long each hack should run */ -#ifndef NO_LOCKING - Time passwd_timeout; /* how much time before pw dialog goes down */ -#endif - Time pointer_timeout; /* how often to check mouse position */ - Time notice_events_timeout; /* how long after window creation to select */ - Time watchdog_timeout; /* how often to re-raise and re-blank screen */ - - Bool use_xidle_extension; /* which extension to use, if possible */ - Bool use_mit_saver_extension; - Bool use_sgi_saver_extension; - - char *shell; /* where to find /bin/sh */ - -}; - - /* This structure holds all the data that applies to the program as a whole, or to the non-screen-specific parts of the display connection. + + The saver_preferences structure (prefs.h) holds all the user-specified + parameters, read from the command line, the resource database, or entered + through a dialog box. */ struct saver_info { char *version; @@ -85,18 +50,23 @@ struct saver_info { saver_screen_info *screens; saver_screen_info *default_screen; /* ...on which dialogs will appear. */ + /* ======================================================================= global connection info ======================================================================= */ XtAppContext app; Display *dpy; - XrmDatabase db; /* ======================================================================= server extension info ======================================================================= */ + Bool using_xidle_extension; /* which extension is being used. */ + Bool using_mit_saver_extension; /* Note that `p->use_*' is the *request*, */ + Bool using_sgi_saver_extension; /* and `si->using_*' is the *reality*. */ + Bool using_proc_interrupts; + # ifdef HAVE_MIT_SAVER_EXTENSION int mit_saver_ext_event_number; int mit_saver_ext_error_number; @@ -112,26 +82,58 @@ struct saver_info { ======================================================================= */ Bool screen_blanked_p; /* Whether the saver is currently active. */ + Window mouse_grab_window; /* Window holding our mouse grab */ + Window keyboard_grab_window; /* Window holding our keyboard grab */ + Bool fading_possible_p; /* Whether fading to/from black is possible. */ + Bool throttled_p; /* Whether we should temporarily just blank + the screen, not run hacks. */ + time_t blank_time; /* The time at which the screen was blanked + (if currently blanked) or unblanked (if + not blanked.) */ /* ======================================================================= - locking + locking and runtime privileges ======================================================================= */ - Bool locking_disabled_p; /* Sometimes locking is impossible. */ - char *nolock_reason; /* This is why. */ Bool locked_p; /* Whether the screen is currently locked. */ Bool dbox_up_p; /* Whether the demo-mode or passwd dialogs are currently visible */ + Bool locking_disabled_p; /* Sometimes locking is impossible. */ + char *nolock_reason; /* This is why. */ + + char *orig_uid; /* What uid/gid we had at startup, before + discarding privileges. */ + char *uid_message; /* Any diagnostics from our attempt to + discard privileges (printed only in + -verbose mode.) */ + Bool dangerous_uid_p; /* Set to true if we're running as a user id + which is known to not be a normal, non- + privileged user. */ + + Window passwd_dialog; /* The password dialog, if its up. */ + passwd_dialog_data *pw_data; /* Other info necessary to draw it. */ + + int unlock_failures; /* Counts failed login attempts while the + screen is locked. */ + + char *unlock_typeahead; /* If the screen is locked, and the user types + a character, we assume that it is the first + character of the password. It's stored here + for the password dialog to use to populate + itself. */ + /* ======================================================================= demoing ======================================================================= */ - Bool demo_mode_p; /* Whether demo-mode is active */ - char *demo_hack; /* The hack that has been selected from the - dialog box, which should be run next. */ + Bool demoing_p; /* Whether we are demoing a single hack + (without UI.) */ + + Window splash_dialog; /* The splash dialog, if its up. */ + splash_dialog_data *sp_data; /* Other info necessary to draw it. */ /* ======================================================================= @@ -145,16 +147,24 @@ struct saver_info { XtIntervalId check_pointer_timer_id; /* `prefs.pointer_timeout' */ time_t last_activity_time; /* Used only when no server exts. */ + time_t last_wall_clock_time; /* Used to detect laptop suspend. */ saver_screen_info *last_activity_screen; + Bool emergency_lock_p; /* Set when the wall clock has jumped + (presumably due to laptop suspend) and we + need to lock down right away instead of + waiting for the lock timer to go off. */ + /* ======================================================================= remote control ======================================================================= */ - int next_mode_p; /* Set to 1 if the NEXT ClientMessage has just - been received; set to 2 if PREV has just - been received. (#### This is nasty.) */ + int selection_mode; /* Set to -1 if the NEXT ClientMessage has just + been received; set to -2 if PREV has just + been received; set to N if SELECT or DEMO N + has been received. (This is kind of nasty.) + */ /* ======================================================================= subprocs @@ -185,10 +195,17 @@ struct saver_screen_info { destroy and recreate it on different visuals. */ Colormap cmap; /* The colormap that goes with the window. */ + Bool install_cmap_p; /* Whether this screen should have its own + colormap installed, for whichever of several + reasons. This is definitive (even a false + value here overrides prefs->install_cmap_p.) + */ Visual *current_visual; /* The visual of the window. */ - Visual *default_visual; /* visual to use when none other specified */ int current_depth; /* How deep the visual (and the window) are. */ + Visual *default_visual; /* visual to use when none other specified */ + Visual *best_gl_visual; /* visual to use for GL hacks */ + Window real_vroot; /* The original virtual-root window. */ Window real_vroot_value; /* What was in the __SWM_VROOT property. */ @@ -196,6 +213,13 @@ struct saver_screen_info { real root window. */ unsigned long black_pixel; /* Black, allocated from `cmap'. */ + int blank_vp_x, blank_vp_y; /* Where the virtual-scrolling viewport was + when the screen went blank. We need to + prevent the X server from letting the mouse + bump the edges to scroll while the screen + is locked, so we reset to this when it has + moved, and the lock dialog is up... */ + # ifdef HAVE_MIT_SAVER_EXTENSION Window server_mit_saver_window; # endif @@ -244,8 +268,8 @@ struct saver_screen_info { ======================================================================= */ extern void restore_real_vroot (saver_info *si); -extern void disable_builtin_screensaver (saver_info *si, Bool turn_off_p); -extern void ensure_no_screensaver_running (Display *, Screen *); +extern void disable_builtin_screensaver (saver_info *, Bool unblank_screen_p); +extern Bool ensure_no_screensaver_running (Display *, Screen *); #ifdef HAVE_MIT_SAVER_EXTENSION extern Bool query_mit_saver_extension (saver_info *); @@ -253,6 +277,16 @@ extern Bool query_mit_saver_extension (saver_info *); #ifdef HAVE_SGI_SAVER_EXTENSION extern Bool query_sgi_saver_extension (saver_info *); #endif +#ifdef HAVE_XIDLE_EXTENSION +extern Bool query_xidle_extension (saver_info *); +#endif +#ifdef HAVE_PROC_INTERRUPTS +extern Bool query_proc_interrupts_available (saver_info *, const char **why); +#endif + +/* Display Power Management System (DPMS) interface. */ +extern Bool monitor_powered_on_p (saver_info *si); +extern void monitor_power_on (saver_info *si); /* ======================================================================= @@ -263,10 +297,14 @@ extern void initialize_screensaver_window (saver_info *si); extern void raise_window (saver_info *si, Bool inhibit_fade, Bool between_hacks_p, Bool dont_clear); -extern void blank_screen (saver_info *si); +extern Bool blank_screen (saver_info *si); extern void unblank_screen (saver_info *si); -extern void grab_keyboard_and_mouse (Display *, Window, Cursor); -extern void ungrab_keyboard_and_mouse (Display *dpy); + +extern void get_screen_viewport (saver_screen_info *ssi, + int *x_ret, int *y_ret, + int *w_ret, int *h_ret, + Bool verbose_p); + /* ======================================================================= locking @@ -274,49 +312,65 @@ extern void ungrab_keyboard_and_mouse (Display *dpy); #ifndef NO_LOCKING extern Bool unlock_p (saver_info *si); -extern create_passwd_dialog (Widget, Visual *, Colormap); -extern Bool lock_init (int argc, char **argv); -extern Bool passwd_valid_p (const char *typed_passwd); -#endif +extern Bool lock_priv_init (int argc, char **argv, Bool verbose_p); +extern Bool lock_init (int argc, char **argv, Bool verbose_p); +extern Bool passwd_valid_p (const char *typed_passwd, Bool verbose_p); +#endif /* NO_LOCKING */ + +extern void set_locked_p (saver_info *si, Bool locked_p); +extern int move_mouse_grab (saver_info *si, Window to, Cursor cursor); + + +/* ======================================================================= + runtime privileges + ======================================================================= */ + +extern void hack_uid (saver_info *si); +extern void describe_uids (saver_info *si, FILE *out); /* ======================================================================= demoing ======================================================================= */ -#ifndef NO_DEMO_MODE -extern void demo_mode (saver_info *si); -extern void demo_mode_restart_process (saver_info *si); -extern create_demo_dialog (Widget, Visual *, Colormap); -extern create_resources_dialog (Widget, Visual *, Colormap); -#endif +extern void draw_shaded_rectangle (Display *dpy, Window window, + int x, int y, + int width, int height, + int thickness, + unsigned long top_color, + unsigned long bottom_color); +extern int string_width (XFontStruct *font, char *s); + +extern void make_splash_dialog (saver_info *si); +extern void handle_splash_event (saver_info *si, XEvent *e); -#if !defined(NO_LOCKING) || !defined(NO_DEMO_MODE) -extern void pop_up_dialog_box (Widget dialog, Widget form, int where); -extern void format_into_label (Widget label, const char *arg); -extern void steal_focus_and_colormap (Widget dialog); -#endif /* ======================================================================= timers ======================================================================= */ -extern void start_notice_events_timer (saver_info *, Window); +extern void start_notice_events_timer (saver_info *, Window, Bool verbose_p); extern void cycle_timer (XtPointer si, XtIntervalId *id); extern void activate_lock_timer (XtPointer si, XtIntervalId *id); extern void reset_watchdog_timer (saver_info *si, Bool on_p); extern void idle_timer (XtPointer si, XtIntervalId *id); extern void sleep_until_idle (saver_info *si, Bool until_idle_p); +extern void reset_timers (saver_info *si); /* ======================================================================= remote control ======================================================================= */ extern Bool handle_clientmessage (saver_info *, XEvent *, Bool); +extern void maybe_reload_init_file (saver_info *); /* ======================================================================= subprocs ======================================================================= */ +extern void block_sigchld (void); +extern void unblock_sigchld (void); +extern void hack_environment (saver_info *si); +extern void hack_subproc_environment (saver_screen_info *ssi); extern void init_sigchld (void); extern void spawn_screenhack (saver_info *si, Bool first_time_p); extern void kill_screenhack (saver_info *si); @@ -324,20 +378,9 @@ extern void suspend_screenhack (saver_info *si, Bool suspend_p); extern Bool screenhack_running_p (saver_info *si); extern void emergency_kill_subproc (saver_info *si); extern Bool select_visual (saver_screen_info *ssi, const char *visual_name); +extern void store_saver_status (saver_info *si); extern const char *signal_name (int signal); -/* ======================================================================= - subprocs security - ======================================================================= */ - -#ifdef NO_SETUID -# define hack_uid() -# define hack_uid_warn() -#else /* !NO_SETUID */ - extern void hack_uid (saver_info *si); - extern void hack_uid_warn (saver_info *si); -#endif /* NO_SETUID */ - /* ======================================================================= subprocs diagnostics ======================================================================= */ @@ -347,22 +390,28 @@ extern FILE *real_stdout; extern void initialize_stderr (saver_info *si); extern void reset_stderr (saver_screen_info *ssi); extern void clear_stderr (saver_screen_info *ssi); +extern void shutdown_stderr (saver_info *si); + /* ======================================================================= misc ======================================================================= */ +extern const char *blurb (void); extern void save_argv (int argc, char **argv); -extern void saver_exit (saver_info *si, int status); +extern void saver_exit (saver_info *si, int status, const char *core_reason); extern void restart_process (saver_info *si); extern int saver_ehandler (Display *dpy, XErrorEvent *error); extern int BadWindow_ehandler (Display *dpy, XErrorEvent *error); extern Bool window_exists_p (Display *dpy, Window window); extern char *timestring (void); +extern Bool display_is_on_console_p (saver_info *si); +extern Visual *get_best_gl_visual (saver_screen_info *ssi); extern Atom XA_VROOT, XA_XSETROOT_ID; -extern Atom XA_SCREENSAVER_VERSION, XA_SCREENSAVER_ID; -extern Atom XA_SCREENSAVER_TIME; +extern Atom XA_SCREENSAVER, XA_SCREENSAVER_VERSION, XA_SCREENSAVER_ID; +extern Atom XA_SCREENSAVER_STATUS, XA_LOCK, XA_BLANK; +extern Atom XA_DEMO, XA_PREFS; #endif /* __XSCREENSAVER_H__ */