# faillock(8) - man - phpman

> **TLDR:** Display and modify authentication failure record files.
>
- List login failures of the current user:
  `faillock`
- Reset the failure records of the current user:
  `faillock --reset`
- List login failures of all users:
  `sudo faillock`
- List login failures of the specified user:
  `sudo faillock --user {{user}}`
- Reset the failure records of the specified user:
  `sudo faillock --user {{user}} --reset`

*Source: tldr-pages*

---

[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
       **--dir** _/path/to/tally-directory_
           The directory where the user files with the failure records are kept. The default is
           /var/run/faillock.

       **--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/faillock/8/markdown), [**pam**(8)](https://www.chedong.com/phpMan.php/man/pam/8/markdown)

## AUTHOR
       faillock was written by Tomas Mraz.



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