PAM_ABL(1)
=========
:man source: GNU
:man manual: User Commands
:author: Chris Tasma

NAME
----

pam_abl - query or purge the databases used by the pam_abl module.

SYNOPSIS
--------

pam_abl [OPTION] [CONFIG]

DESCRIPTION
-----------

Performs maintenance on the databases used by the pam_abl (auto blacklist)
module. CONFIG is the name of the pam_abl config file (default:
/etc/security/pam_abl.conf). The config file is read to discover the names of
the pam_abl databases and the rules that control purging of old data from them.

OPTIONS
-------

*-h, --help*::
       See this message.

*-p, --purge*::
       Purge databases according to purge rules in config.

*-r, --relative*::
       Display times relative to now.

*-v, --verbose*::
       Verbose output.

*--okuser*='USER'::
       Unblock USER.   (Shell wildcards may be used in USER and HOST)

*--okhost*='HOST'::
       Unblock HOST.

EXAMPLES
--------

Obtain a list of failed hosts and users:
*********
$ pam_abl
*********

Obtain a full list of failures listing times relative to now:
********************************************
$ pam_abl -rv $ pam_abl --relative --verbose
********************************************

Purge old data:
******************************
$ pam_abl -p $ pam_abl --purge
******************************

Unblock all example.com, somewhere.com hosts:
***********************************************************************
$ pam_abl -v --okhost=\*.example.com --okhost=*.somewhere.com
***********************************************************************

AUTHORS
-------

Andy Armstrong <andy@hexten.net>

Maintained by Chris Tasma <pam-abl@deksai.com>


REPORTING BUGS
--------------
Report bugs to <pam-abl@deksai.com>

SEE ALSO
--------
pam_abl.conf(5), pam_abl(8)
