Go to file
FRIGN 3bb868e408 Refactor main()
- Add arg.h and fix usage
	Given slock is suid we don't want to have half-measures in place to
	parse the arguments in case the code is changed in the future with
	somebody not paying enough attention.

	Also, fix the usage string output to be more consistent across the
	suckless toolbase and make it reflect the manpage entry.

- Comments
	Use proper block comments and add/change them where necessary
	to help in studying the code.

- Error messages
	Consistently prepend them with "slock:" and fix wording and
	do a proper cleanup before quitting (XCloseDisplay and free
	the locks), making the die() semantics consistent with st's.

- getpwuid() error reporting
	Properly present an error message if getpwuid() fails.

- fork() error reporting
	Properly present an error message if fork() fails. If we cannot
	close the connection within the fork context we abort the
	operation and report an error.

- execvp() error handling
	If execvp fails, we cannot call die() afterwards as this implies
	calling exit(). We must use _exit() to prevent the libc from
	doing now "illegal" cleanup-work.
2016-08-22 23:22:20 +02:00
LICENSE Update license year 2016-02-11 16:30:52 +01:00
Makefile clear passwords with explicit_bzero 2016-08-13 09:58:00 +02:00
README removed useless chars, prepared release 2008-07-29 19:08:18 +01:00
arg.h Refactor main() 2016-08-22 23:22:20 +02:00
config.def.h Clarify config.def.h 2016-02-14 01:33:18 +01:00
config.mk clear passwords with explicit_bzero 2016-08-13 09:58:00 +02:00
explicit_bzero.c clear passwords with explicit_bzero 2016-08-13 09:58:00 +02:00
slock.1 Revert "No need for usage()" 2016-02-15 14:25:17 +01:00
slock.c Refactor main() 2016-08-22 23:22:20 +02:00
util.h clear passwords with explicit_bzero 2016-08-13 09:58:00 +02:00

README

slock - simple screen locker
============================
simple screen locker utility for X. 


Requirements
------------
In order to build slock you need the Xlib header files.


Installation
------------
Edit config.mk to match your local setup (slock is installed into
the /usr/local namespace by default).

Afterwards enter the following command to build and install slock
(if necessary as root):

    make clean install


Running slock
-------------
Simply invoke the 'slock' command. To get out of it, enter your password.