# faillock - Tool for displaying and modifying the authentication f... - man(8) - [phpMan]

[_FAILLOCK_(8)](https://www.chedong.com/phpMan.php/man/FAILLOCK/8/markdown)                               Linux-PAM Manual                               [_FAILLOCK_(8)](https://www.chedong.com/phpMan.php/man/FAILLOCK/8/markdown)

## NAME
       faillock - Tool for displaying and modifying the authentication failure record files

## SYNOPSIS


       **faillock **[--dir _/path/to/tally-directory_] [--user _username_] [--reset]

## DESCRIPTION
       The _pam_faillock.so_ module maintains a list of failed authentication attempts per user during
       a specified interval and locks the account in case there were more than _deny_ consecutive
       failed authentications. It stores the failure records into per-user files in the tally
       directory.

       The **faillock **command is an application which can be used to examine and modify the contents
       of the tally files. It can display the recent failed authentication attempts of the _username_
       or clear the tally files of all or individual _usernames_.

## OPTIONS
       --conf /path/to/config-file
           The file where the configuration is located. The default is /etc/security/faillock.conf.

       --dir /path/to/tally-directory
           The directory where the user files with the failure records are kept.

           The priority to set this option is to use the value provided from the command line. If
           this isn't provided, then the value from the configuration file is used. Finally, if
           neither of them has been provided, then /var/run/faillock is used.

       --user username
           The user whose failure records should be displayed or cleared.

### --reset
           Instead of displaying the user's failure records, clear them.

## FILES
       /var/run/faillock/*
           the files logging the authentication failures for users

## SEE ALSO
       [**pam_faillock**(8)](https://www.chedong.com/phpMan.php/man/pamfaillock/8/markdown), [**pam**(8)](https://www.chedong.com/phpMan.php/man/pam/8/markdown)

## AUTHOR
       faillock was written by Tomas Mraz.

Linux-PAM                                    05/07/2023                                  [_FAILLOCK_(8)](https://www.chedong.com/phpMan.php/man/FAILLOCK/8/markdown)