aboutsummaryrefslogtreecommitdiff
path: root/slocko/slock.1
diff options
context:
space:
mode:
authorBradley Taunt <bt@btxx.org>2024-01-23 15:26:52 -0500
committerBradley Taunt <bt@btxx.org>2024-01-23 15:26:52 -0500
commit0043fe4dc9febc404226b0ff5fc911ea74bd1f38 (patch)
tree8c99fc9da003de0018a3ad94a995471cf82f3881 /slocko/slock.1
parentf56fc53c62d1a27c9fc61eaf5b1b6675ee89e79e (diff)
Update install script and include source suckless programs
Diffstat (limited to 'slocko/slock.1')
-rw-r--r--slocko/slock.139
1 files changed, 39 insertions, 0 deletions
diff --git a/slocko/slock.1 b/slocko/slock.1
new file mode 100644
index 0000000..82cdcd6
--- /dev/null
+++ b/slocko/slock.1
@@ -0,0 +1,39 @@
+.Dd 2016-08-23
+.Dt SLOCK 1
+.Sh NAME
+.Nm slock
+.Nd simple X screen locker
+.Sh SYNOPSIS
+.Nm
+.Op Fl v
+.Op Ar cmd Op Ar arg ...
+.Sh DESCRIPTION
+.Nm
+is a simple X screen locker. If provided,
+.Ar cmd Op Ar arg ...
+is executed after the screen has been locked.
+.Sh OPTIONS
+.Bl -tag -width Ds
+.It Fl v
+Print version information to stdout and exit.
+.El
+.Sh SECURITY CONSIDERATIONS
+To make sure a locked screen can not be bypassed by switching VTs
+or killing the X server with Ctrl+Alt+Backspace, it is recommended
+to disable both in
+.Xr xorg.conf 5
+for maximum security:
+.Bd -literal -offset left
+Section "ServerFlags"
+ Option "DontVTSwitch" "True"
+ Option "DontZap" "True"
+EndSection
+.Ed
+.Sh EXAMPLES
+$
+.Nm
+/usr/sbin/s2ram
+.Sh CUSTOMIZATION
+.Nm
+can be customized by creating a custom config.h from config.def.h and
+(re)compiling the source code. This keeps it fast, secure and simple.