Initialize Tizen 2.3
[external/shadow-utils.git] / man / sv / faillog.8
1 '\" t
2 .\"     Title: faillog
3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4 .\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
5 .\"      Date: 24-07-2009
6 .\"    Manual: Systemhanteringskommandon
7 .\"    Source: Systemhanteringskommandon
8 .\"  Language: Swedish
9 .\"
10 .TH "FAILLOG" "8" "24-07-2009" "Systemhanteringskommandon" "Systemhanteringskommandon"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
15 .nh
16 .\" disable justification (adjust text to left margin only)
17 .ad l
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
21 .SH "NAMN"
22 faillog \- display faillog records or set login failure limits
23 .SH "SYNOPSIS"
24 .HP \w'\fBfaillog\fR\ 'u
25 \fBfaillog\fR [\fIflaggor\fR]
26 .SH "BESKRIVNING"
27 .PP
28
29 \fBfaillog\fR
30 displays the contents of the failure log database (/var/log/faillog)\&. It can also set the failure counters and limits\&. When
31 \fBfaillog\fR
32 is run without arguments, it only displays the faillog records of the users who had a login failure\&.
33 .SH "FLAGGOR"
34 .PP
35 Flaggorna som g\(:aller f\(:or kommandot
36 \fBfaillog\fR
37 \(:ar:
38 .PP
39 \fB\-a\fR, \fB\-\-all\fR
40 .RS 4
41 Display (or act on) faillog records for all users having an entry in the
42 faillog
43 database\&.
44 .RE
45 .PP
46 \fB\-h\fR, \fB\-\-help\fR
47 .RS 4
48 Visa hj\(:alpmeddelande och avsluta\&.
49 .RE
50 .PP
51 \fB\-l\fR, \fB\-\-lock\-time\fR\fISEK\fR
52 .RS 4
53 Lock account for
54 \fISEC\fR
55 seconds after failed login\&.
56 .sp
57 Write access to
58 /var/log/faillog
59 is required for this option\&.
60 .RE
61 .PP
62 \fB\-m\fR, \fB\-\-maximum\fR\fIMAX\fR
63 .RS 4
64 Set the maximum number of login failures after the account is disabled to
65 \fIMAX\fR\&.
66 .sp
67 Selecting a
68 \fIMAX\fR
69 value of 0 has the effect of not placing a limit on the number of failed logins\&.
70 .sp
71 The maximum failure count should always be 0 for
72 \fIroot\fR
73 to prevent a denial of services attack against the system\&.
74 .sp
75 Write access to
76 /var/log/faillog
77 is required for this option\&.
78 .RE
79 .PP
80 \fB\-r\fR, \fB\-\-reset\fR
81 .RS 4
82 Reset the counters of login failures\&.
83 .sp
84 Write access to
85 /var/log/faillog
86 is required for this option\&.
87 .RE
88 .PP
89 \fB\-t\fR, \fB\-\-time\fR\fIDAGAR\fR
90 .RS 4
91 Display faillog records more recent than
92 \fIDAYS\fR\&.
93 .RE
94 .PP
95 \fB\-u\fR, \fB\-\-user\fR \fILOGIN\fR|\fIRANGE\fR
96 .RS 4
97 Display faillog record or maintains failure counters and limits (if used with
98 \fB\-l\fR,
99 \fB\-m\fR
100 or
101 \fB\-r\fR
102 options) only for the specified user(s)\&.
103 .sp
104 The users can be specified by a login name, a numerical user ID, or a
105 \fIRANGE\fR
106 of users\&. This
107 \fIRANGE\fR
108 of users can be specified with a min and max values (\fIUID_MIN\-UID_MAX\fR), a max value (\fI\-UID_MAX\fR), or a min value (\fIUID_MIN\-\fR)\&.
109 .RE
110 .PP
111 When none of the
112 \fB\-l\fR,
113 \fB\-m\fR, or
114 \fB\-r\fR
115 options are used,
116 \fBfaillog\fR
117 displays the faillog record of the specified user(s)\&.
118 .PP
119 NOTE: in display mode, only the records of users which currently exist in the system are displayed\&. In the other modes (when the
120 \fB\-l\fR,
121 \fB\-m\fR, or
122 \fB\-r\fR
123 options are used), the records of the user, or the range of users, or all the users that may have an entry in the faillog database will be changed\&. This is useful to reset records of users that have been deleted or set a policy in advance for a range of users\&.
124 .SH "T\(:ANK P\(oA"
125 .PP
126
127 \fBfaillog\fR
128 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
129 \fB\-u\fR
130 flag, or print out all users with the
131 \fB\-a\fR
132 flag\&.
133 .SH "FILER"
134 .PP
135 /var/log/faillog
136 .RS 4
137 Failure logging file\&.
138 .RE
139 .SH "SE OCKS\(oA"
140 .PP
141 \fBlogin\fR(1),
142 \fBfaillog\fR(5)\&.