unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



dxpause(1X)							  dxpause(1X)



NAME

  dxpause - locks (pauses) an X	display

SYNOPSIS

  dxpause [-autopause] [-time n] [-wait]

OPTIONS

  -autopause
      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.

  -time	n
      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.

  -wait
      The -wait	option only has	meaning	if the -autopause option is also set,
      and causes dxpause to start in the iconified state rather	than immedi-
      ately 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 .Xdefaults file, the following	resources are used by the dxpause
  program:

  DXpause
      The first	name for lines that apply only to the Pause task should	be
      labeled DXpause.

  grabServer
      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 effec-
      tively suspends other tasks that need to output information to their
      windows.	When this resource is False, the protective 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.

  autoPause
      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.

  pauseSaver
      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.

  wait
      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

  ~/.Xdefaults

SEE ALSO

  X(1X)