summaryrefslogtreecommitdiff
path: root/i3lock.1
diff options
context:
space:
mode:
authorVincent Bernat <bernat@luffy.cx>2013-08-26 23:39:38 +0200
committerMichael Stapelberg <michael@stapelberg.de>2013-08-31 20:41:12 +0200
commit5627a111746e96119e6789d8f8f47168b3a8c41d (patch)
treec29ffe1f6ebc10287daec4ba56bc47c324a18df0 /i3lock.1
parent3e136769beae3ef13ce492d341dbf3ff32c87ec9 (diff)
Add `-e` option to not validate empty password.
When the XF86ScreenSaver key is used to put a laptop to sleep (or to trigger the screensaver), the key may "bounce" on resume. This is annoying as i3lock will try to validate several empty passwords and wait several seconds before accepting a legit password. Some users may want to validate an empty password: PAM may rely on other sources to unlock the screen, like the presence of a token or the proximity of some Bluetooth device. Hence, we don't forbid this possibility and provide an command-line option for users not willing to validate empty passwords.
Diffstat (limited to 'i3lock.1')
-rw-r--r--i3lock.110
1 files changed, 10 insertions, 0 deletions
diff --git a/i3lock.1 b/i3lock.1
index 8bc00f5..9c349b1 100644
--- a/i3lock.1
+++ b/i3lock.1
@@ -27,6 +27,7 @@ i3lock \- improved screen locker
.RB [\|\-p
.IR pointer\|]
.RB [\|\-u\|]
+.RB [\|\-e\|]
.SH DESCRIPTION
.B i3lock
@@ -100,6 +101,15 @@ does not hide your Mousepointer. If you specify "win",
displays a hardcoded Windows-Pointer (thus enabling you to fuck with your
friends by using a Screenshot of a Windows-Desktop as a locking-screen).
+.TP
+.B \-e, \-\-ignore-empty-password
+When an empty password is provided by the user, do not validate
+it. Without this option, the empty password will be provided to PAM
+and, if invalid, the user will have to wait a few seconds before
+another try. This can be useful if the XF86ScreenSaver key is used to
+put a laptop to sleep and bounce on resume or if you happen to wake up
+your computer with the enter key.
+
.SH SEE ALSO
.IR xautolock(1)
\- use i3lock as your screen saver