From 97c26c1924b076ef23ebe4381558e8aa025712b2 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 16:54:37 +0200 Subject: Adding upstream version 1:4.13+dfsg1. Signed-off-by: Daniel Baumann --- man/faillog.8.xml | 242 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 242 insertions(+) create mode 100644 man/faillog.8.xml (limited to 'man/faillog.8.xml') diff --git a/man/faillog.8.xml b/man/faillog.8.xml new file mode 100644 index 0000000..effe43a --- /dev/null +++ b/man/faillog.8.xml @@ -0,0 +1,242 @@ + + + +]> + + + + + Julianne Frances + Haugh + Creation, 1989 + + + Thomas + Kłoczko + kloczek@pld.org.pl + shadow-utils maintainer, 2000 - 2007 + + + Nicolas + François + nicolas.francois@centraliens.net + shadow-utils maintainer, 2007 - now + + + + faillog + 8 + System Management Commands + shadow-utils + &SHADOW_UTILS_VERSION; + + + faillog + display faillog records or set login failure limits + + + + + faillog + + options + + + + + + DESCRIPTION + + faillog displays the contents of the failure log + database (/var/log/faillog). It can also + set the failure counters and limits. When + faillog is run without arguments, it only displays the + faillog records of the users who had a login failure. + + + + + OPTIONS + + The options which apply to the faillog command + are: + + + + , + + + Display (or act on) faillog records for all users having an + entry in the faillog database. + + + The range of users can be restricted with the + option. + + + In display mode, this is still restricted to existing users + but forces the display of the faillog entries even if they + are empty. + + + With the , , + , options, the users' + records are changed, even if the user does not exist on the + system. This is useful to reset records of users that have + been deleted or to set a policy in advance for a range of + users. + + + + + , + + Display help message and exit. + + + + + ,  SEC + + + + Lock account for SEC + seconds after failed login. + + + Write access to /var/log/faillog + is required for this option. + + + + + + ,  MAX + + + + Set the maximum number of login failures after the account is + disabled to MAX. + + + Selecting a + MAX 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 root + to prevent a denial of services attack against the system. + + + Write access to /var/log/faillog + is required for this option. + + + + + , + + + Reset the counters of login failures. + + + Write access to /var/log/faillog + is required for this option. + + + + + + ,  CHROOT_DIR + + + + Apply changes in the CHROOT_DIR + directory and use the configuration files from the + CHROOT_DIR directory. + Only absolute paths are supported. + + + + + ,  DAYS + + + + Display faillog records more recent than + DAYS. + + + + + + ,  LOGIN|RANGE + + + + Display faillog record or maintains failure counters and limits + (if used with , or + options) only for the specified user(s). + + + The users can be specified by a login name, a numerical user + ID, or a RANGE of users. This + RANGE of users can be specified + with a min and max values + (UID_MIN-UID_MAX), a max value + (-UID_MAX), or a min value + (UID_MIN-). + + + + + + + When none of the , , or + options are used, faillog + displays the faillog record of the specified user(s). + + + + + CAVEATS + + faillog 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 flag, or print out all users + with the flag. + + + + + FILES + + + /var/log/faillog + + Failure logging file. + + + + + + + SEE ALSO + + + login1 + , + + faillog5 + . + + + -- cgit v1.2.3