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)