xtrlock(1x)

xtrlock1x

Lock x display until password supplied, leaving windows visible

Usage

xtrlock [-b] [-f]

Overview

xtrlock locks the X server till the user enters their password at the keyboard.

While xtrlock is running, the mouse and keyboard are grabbed and the mouse cursor becomes a padlock. Output displayed by X programs, and windows put up by new X clients, continue to be visible, and any new output is displayed normally.

The mouse and keyboard are returned when the user types their password, followed by Enter or Newline. If an incorrect password is entered the bell is sounded. Pressing Backspace or Delete erases one character of a password partially typed; pressing Escape or Clear clears anything that has been entered.

If too many attempts are made in too short a time further keystrokes generate bells and are otherwise ignored until a timeout has expired.

The X server screen saver continues to operate normally; if it comes into operation the display may be restored by the usual means of touching a key (Shift, for example) or the mouse.

Options

-b

blank the screen as well as displaying the padlock

-f

fork after locking is complete, and return success from the parent process

X resources, configuration

None.

Releases

15 releases since Debian 1.1 (Buzz); the text changed 3 times.

  1. 1.1–3.0
  2. 3.1–7
  3. 8
  4. 9–10

-b since Debian 8 (Jessie); -f since Debian 9 (Stretch).

Bugs

Additional input devices other than the keyboard and mouse are not disabled.

The timeouts, bitmaps and mouse cursor colour cannot be modifed.

Author

Ian Jackson <[email protected]>

From xtrlock 2.8+deb10u1+b1 in Debian 10 (Buster). Parsed by carta from the page's man source.