dxpause(1X) dxpause(1X)
NAME
dxpause - locks (pauses) an X display
SYNOPSIS
dxpause [-autopause] [-time n] [-wait]
OPTIONS
If the -autopause option is set, when the display is unlocked, dxpause does not exit but instead becomes an icon. In this case, dxpause
automatically locks the display when the X server goes into screensaver mode if the X Screensaver extension is present in the X server.
De-iconifying dxpause also causes the display to be locked. The -time option only has meaning if the -autopause option is also set. The
-time n option sets the autolock timeout period to n minutes. The default period is whatever the X server's screensaver timeout is set to,
and the latter defaults to 5 minutes. The -wait option only has meaning if the -autopause option is also set, and causes dxpause to start
in the iconified state rather than immediately locking the display.
Without any of these options set, dxpause locks the display immediately when invoked and exits when the display is unlocked.
DESCRIPTION
The dxpause program must be invoked explicitly by users (typically those running the generic X display manager rather than CDE). The
dxpause program places a blank screen over the workstation screen and displays a dialog box that prompts for the password of the person
whose session was paused. When you enter the correct password, the blank screen is removed and the session resumes.
In the file, the following resources are used by the dxpause program: The first name for lines that apply only to the Pause task should be
labeled DXpause. When this resource is True, dxpause executes an XGrabServer library call, thereby inhibiting all processing of requests
or close downs on any other connection. Although this action absolutely insures that no information is displayed "through" the pause
screen, it also effectively suspends other tasks that need to output information to their windows. When this resource is False, the pro-
tective pause screen is raised to the top of the display stack 20 times per second, thus re-covering any other window that might have been
displayed. Tasks that need to output to their own windows will not be suspended. The default is False. When this resource is True,
dxpause behaves as if it were run with the -autopause option. See the OPTIONS section, above. The default is False. When this resource is
set to a numeric value n, dxpause behaves as if it were run with the -time n option. See the OPTIONS section, above. This resource only has
meaning if the autoPause resource is set, or if dxpause is started with the -autopause option. The value n defaults to whatever the X
server's screensaver timeout is set to, and the latter defaults to 5 minutes. When this resource is True, dxpause behaves as if it were
run with the -wait option. See the OPTIONS section, above. This resource only has meaning if the autoPause resource is set, or if dxpause
is started with the -autopause option. The default is False.
FILES
SEE ALSO
X(1X)
dxpause(1X)