faillog

SYNOPSIS
       faillog [options]

DESCRIPTION
       faillog displays the contents of the failure log database
       (/var/log/faillog). It can also set the failure counters and limits.
       When faillog is run without arguments, it only displays the faillog
       records of the users who had a login failure.

OPTIONS
       The options which apply to the faillog command are:

       -a, --all
           Display (or act on) faillog records for all users having an entry
           in the faillog database.

       -h, --help
           Display help message and exit.

       -l, --lock-time SEC
           Lock account for SEC seconds after failed login.

           Write access to /var/log/faillog is required for this option.

       -m, --maximum MAX
           Set the maximum number of login failures after the account is
           disabled to MAX.

           Selecting a MAX value of 0 has the effect of not placing a limit on
           the number of failed logins.

           The maximum failure count should always be 0 for root to prevent a
           denial of services attack against the system.

           Write access to /var/log/faillog is required for this option.

       -r, --reset
           Reset the counters of login failures.

           Write access to /var/log/faillog is required for this option.

       -t, --time DAYS
           Display faillog records more recent than DAYS.

       -u, --user LOGIN|RANGE
           Display faillog record or maintains failure counters and limits (if
           used with -l, -m or -r options) only for the specified user(s).

           The users can be specified by a login name, a numerical user ID, or
           a RANGE of users. This RANGE of users can be specified with a min
           and max values (UID_MIN-UID_MAX), a max value (-UID_MAX), or a min
           value (UID_MIN-).

       failure. To print out a user who has had a successful login since their
       last failure, you must explicitly request the user with the -u flag, or
       print out all users with the -a flag.

FILES
       /var/log/faillog
           Failure logging file.

SEE ALSO
       login(1), faillog(5).



System Management Commands        01/26/2010                        FAILLOG(8)