LinuxCommandLibrary

faillock

Display and modify authentication failure record files.

TLDR

List login failures of all users

$ sudo faillock
copy


List login failures of the specified user
$ sudo faillock --user [user]
copy


Reset the failure records of the specified user
$ sudo faillock --user [user] --reset
copy

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 isnt 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 users failure records, clear them.

FILES

/var/run/faillock/*

the files logging the authentication failures for users

SEE ALSO

pam_faillock(8), pam(8)

AUTHOR

faillock was written by Tomas Mraz.

Copied to clipboard