SYNOPSIS

alock [-h] [-v] [-bg type:opts] [-cursor type:opts] [-auth type:opts]

DESCRIPTION

alock locks the X server till the user enters a 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. Its just for locking the current X session.

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>

RESOURCES

alock - Webpages

Algorithms

Other Lockers

COPYING

Copyright © 2005 - 2006 Mathias Gumz. Free use of this software is granted under the terms of the MIT. See LICENSE provided in the distribution.