NAME
alock - locks the local X display until the correct password is
entered.
SYNOPSIS
alock [-h] [-v] [-bg type:opts] [-cursor type:opts] [-auth
type:opts]
DESCRIPTION
alock locks the X server until the user enters the correct
password at the keyboard. If the authentification was successful, the X
server is unlocked and the user can continue to work.
alock does not provide fancy animations like xlock
and xscreensaver and never will. It´s just for locking the
current X session.
When alock is started it just waits for the first keypress.
This first keypress is to indicate that the user now wants to type in the
password. A colored frame is drawn around the screen and the user can now
type in his password. If it was typed in incorrectly, the colored frame
turns red and the user has to wait a certain timeout.
OPTIONS
-h
Print a short help
-v
Print the version number
-auth type:options
Define the type of the authentification, depends strongly
on how alock was built:
•list - Displays a list of available types
•passwd - Tries to authentificate against the
users system-password. On systems using shadow alock needs the
suid-flag set.
•pam - Tries to authentificate against the users
system-password using the pam-login-module.
•md5 - alock creates a md5-hash from the entered
passphrase and compares it with the hash provided
•hash=<hash> - use <hash> as
reference
•file=<filename> - use content of
<filename> as reference
•sha1 - alock creates a sha1-hash from the entered
passphrase and compares it with the hash provided
•hash=<hash> - use <hash> as
reference
•file=<filename> - use <filename> as
reference
•sha256 - alock creates a sha256-hash from the
entered passphrase and compares it with the hash provided
•hash=<hash> - use <hash> as
reference
•file=<filename> - use <filename> as
reference
•sha384 - alock creates a sha384-hash from the
entered passphrase and compares it with the hash provided
•hash=<hash> - use <hash> as
reference
•file=<filename> - use <filename> as
reference
•sha512 - alock creates a sha512-hash from the
entered passphrase and compares it with the hash provided
•hash=<hash> - use <hash> as
reference
•file=<filename> - use <filename> as
reference
•wpool - alock creates a whirlpool-hash from the
entered passphrase and compares it with the hash provided
•hash=<hash> - use <hash> as
reference
•file=<filename> - use <filename> as
reference
-bg type:options
Define the type of alock should handle the background:
•list - Displays a list of available types
•none - You can see everything like it is
•blank - Fill the background with color
•color=<color> - Use <color>
•shade - Dims content of the screen and recolors
it.
•shade=<perc> - Valid from 1 to 99
•color=<color> - Use <color>
•image - Use the image <filename> and puts
it as the background
•file=<filename>
•center
•scale
•tile
•color=<color> - Use <color>
•shade=<perc> - Valid from 1 to 99
-cursor type:options
Define the look-a-like of the cursor/mouse pointer:
•list - Displays a list of available types
•theme - Use the given internal cursor
•list - Display all possible themes
•name=<name>
•bg=<color> - Use forground-color
•fg=<color> - Use background-color
•glyph - Use the given glyph of the
"cursor"-font
•list - Display all possible glyph-names
•name=<name>
•bg=<color>
•fg=<color>
•xcursor - Use the given <filename> in
xcursor-format
•file=<filename>
•image - Use the given <filename>
•file=<filename>
•none - No change to the current cursor
AUTHOR
Written by Mathias Gumz <akira at fluxbox dot org> Based
upon xtrlock
MD5
Code taken from OpenBSD, which took it from public domain.
Original author was Colin Plumb.
SHA1
Code based upon public domain code, originally written by Steve
Reid <steve@edmweb.com[1]>
SHA2
Code based upon OpenBSD code, originally public domain and written
by Aaron D. Gifford <me@aarongifford.com[2]>.
Whirlpool
Based upon public domain, originally written by
Paulo S. L. M. Barreto <pbarreto@scopus.com.br[3]>
Vincent Rijmen <vincent.rijmen@esat.kuleuven.ac.be[4]>
RESOURCES
alock - Webpages :: - Home[5] - Issue
Tracker[6]
Algorithms :: - whirlpool hash[7] - sha based
hashfunctions[8] - md5[9]
Other Lockers :: - xlockmore[10] - xscreensaver[11]
- xtrlock[12] - vlock[13] - lockvc[13]
COPYING
Copyright © 2005 - 2009 Mathias Gumz. Free use of this
software is granted under the terms of the MIT. See LICENSE provided in the
distribution.
NOTES
- 1.
- steve@edmweb.com
mailto:steve@edmweb.com
- 2.
- me@aarongifford.com
mailto:me@aarongifford.com
- 3.
- pbarreto@scopus.com.br
mailto:pbarreto@scopus.com.br
- 4.
- vincent.rijmen@esat.kuleuven.ac.be
mailto:vincent.rijmen@esat.kuleuven.ac.be
- 5.
- Home
http://darkshed.net
- 6.
- Issue Tracker
http://code.google.com/p/alock/issues/list
- 7.
- whirlpool hash
http://en.wikipedia.org/wiki/WHIRLPOOL
- 8.
- sha based hashfunctions
http://en.wikipedia.org/wiki/SHA_hash_functions
- 9.
- md5
http://en.wikipedia.org/wiki/Md5
- 10.
- xlockmore
http://www.tux.org/~bagleyd/xlockmore.html
- 11.
- xscreensaver
http://www.jwz.org/xscreensaver/
- 12.
- xtrlock
ftp://ftp.debian.org/debian/dists/stable/main/source/x11/
- 13.
- vlock
ftp://ftp.ibiblio.org/pub/Linux/utils/console/
