shadow/man/faillog.8

.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "FAILLOG" 8 "" "" ""
.SH NAME
faillog \- display faillog records or set login failure limits
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 8
\fBfaillog\fR [\fIoptions\fR]
.ad
.hy

.SH "DESCRIPTION"

.PP
 \fBfaillog\fR formats the contents of the failure log from \fI/var/log/faillog\fR database\&. It also can be used for maintains failure counters and limits\&. Run \fBfaillog\fR without arguments display only list of user faillog records who have ever had a login failure\&.

.SH "OPTIONS"

.PP
The options which apply to the \fBfaillog\fR command are:

.TP
\fB\-a\fR, \fB\-\-all\fR
Display faillog records for all users\&.

.TP
\fB\-h\fR, \fB\-\-help\fR
Display help message and exit\&.

.TP
\fB\-l\fR, \fB\-\-lock\-time\fR \fISEC\fR
Lock accout to \fISEC\fR seconds after failed login\&.

.TP
\fB\-m\fR, \fB\-\-maximum\fR \fIMAX\fR
Set maiximum number of login failures after the account is disabled to \fIMAX\fR\&. Selecting \fIMAX\fR 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 \fIroot\fR to prevent a denial of services attack against the system\&.

.TP
\fB\-r\fR, \fB\-\-reset\fR
Reset the counters of login failures or one recor if used with \-u \fILOGIN\fR option\&. Write access to \fI/var/log/faillog\fR is required for this option\&.

.TP
\fB\-t\fR, \fB\-\-time\fR \fIDAYS\fR
Display faillog records more recent than \fIDAYS\fR\&. The \fB\-t\fR flag overrides the use of \fB\-u\fR\&.

.TP
\fB\-u\fR, \fB\-\-user\fR \fILOGIN\fR
Display faillog record or maintains failure counters and limits (if used with \fB\-l\fR, \fB\-m\fR or \fB\-r\fR options) only for user with \fILOGIN\fR\&.

.SH "CAVEATS"

.PP
\fBfaillog\fR only prints out users with no successful login since the last failure\&. To print out a user who has had a successful login since their last failure, you must explicitly request the user with the \fB\-u\fR flag, or print out all users with the \fB\-a\fR flag\&.

.SH "FILES"

.TP
\fI/var/log/faillog\fR
failure logging file
.SH "SEE ALSO"

.PP
\fBlogin\fR(1), \fBfaillog\fR(5) 

.SH "AUTHOR"

.PP
Julianne Frances Haugh (jockgrrl@ix\&.netcom\&.com)