diff options
Diffstat (limited to 'modules/pam_lastlog/pam_lastlog.8.xml')
| -rw-r--r-- | modules/pam_lastlog/pam_lastlog.8.xml | 108 |
1 files changed, 66 insertions, 42 deletions
diff --git a/modules/pam_lastlog/pam_lastlog.8.xml b/modules/pam_lastlog/pam_lastlog.8.xml index 77da9dbc..7c15b93c 100644 --- a/modules/pam_lastlog/pam_lastlog.8.xml +++ b/modules/pam_lastlog/pam_lastlog.8.xml @@ -1,57 +1,57 @@ -<?xml version="1.0" encoding='UTF-8'?> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" - "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"> - -<refentry id="pam_lastlog"> +<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_lastlog"> <refmeta> <refentrytitle>pam_lastlog</refentrytitle> <manvolnum>8</manvolnum> - <refmiscinfo class="sectdesc">Linux-PAM Manual</refmiscinfo> + <refmiscinfo class="source">Linux-PAM</refmiscinfo> + <refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo> </refmeta> - <refnamediv id="pam_lastlog-name"> + <refnamediv xml:id="pam_lastlog-name"> <refname>pam_lastlog</refname> <refpurpose>PAM module to display date of last login and perform inactive account lock out</refpurpose> </refnamediv> <refsynopsisdiv> - <cmdsynopsis id="pam_lastlog-cmdsynopsis"> + <cmdsynopsis xml:id="pam_lastlog-cmdsynopsis" sepchar=" "> <command>pam_lastlog.so</command> - <arg choice="opt"> + <arg choice="opt" rep="norepeat"> debug </arg> - <arg choice="opt"> + <arg choice="opt" rep="norepeat"> silent </arg> - <arg choice="opt"> + <arg choice="opt" rep="norepeat"> never </arg> - <arg choice="opt"> + <arg choice="opt" rep="norepeat"> nodate </arg> - <arg choice="opt"> + <arg choice="opt" rep="norepeat"> nohost </arg> - <arg choice="opt"> + <arg choice="opt" rep="norepeat"> noterm </arg> - <arg choice="opt"> + <arg choice="opt" rep="norepeat"> nowtmp </arg> - <arg choice="opt"> + <arg choice="opt" rep="norepeat"> noupdate </arg> - <arg choice="opt"> + <arg choice="opt" rep="norepeat"> showfailed </arg> - <arg choice="opt"> + <arg choice="opt" rep="norepeat"> inactive=<days> </arg> + <arg choice="opt" rep="norepeat"> + unlimited + </arg> </cmdsynopsis> </refsynopsisdiv> - <refsect1 id="pam_lastlog-description"> + <refsect1 xml:id="pam_lastlog-description"> <title>DESCRIPTION</title> @@ -65,20 +65,28 @@ cases, this module is not necessary. </para> <para> + The module checks <option>LASTLOG_UID_MAX</option> option in + <filename>/etc/login.defs</filename> and does not update or display + last login records for users with UID higher than its value. + If the option is not present or its value is invalid, no user ID + limit is applied. + </para> + <para> If the module is called in the auth or account phase, the accounts that were not used recently enough will be disallowed to log in. The check is not performed for the root account so the root is never - locked out. + locked out. It is also not performed for users with UID higher + than the <option>LASTLOG_UID_MAX</option> value. </para> </refsect1> - <refsect1 id="pam_lastlog-options"> + <refsect1 xml:id="pam_lastlog-options"> <title>OPTIONS</title> <variablelist> <varlistentry> <term> - <option>debug</option> + debug </term> <listitem> <para> @@ -88,18 +96,19 @@ </varlistentry> <varlistentry> <term> - <option>silent</option> + silent </term> <listitem> <para> Don't inform the user about any previous login, just update the <filename>/var/log/lastlog</filename> file. + This option does not affect display of bad login attempts. </para> </listitem> </varlistentry> <varlistentry> <term> - <option>never</option> + never </term> <listitem> <para> @@ -112,7 +121,7 @@ </varlistentry> <varlistentry> <term> - <option>nodate</option> + nodate </term> <listitem> <para> @@ -122,7 +131,7 @@ </varlistentry> <varlistentry> <term> - <option>noterm</option> + noterm </term> <listitem> <para> @@ -133,7 +142,7 @@ </varlistentry> <varlistentry> <term> - <option>nohost</option> + nohost </term> <listitem> <para> @@ -144,7 +153,7 @@ </varlistentry> <varlistentry> <term> - <option>nowtmp</option> + nowtmp </term> <listitem> <para> @@ -154,7 +163,7 @@ </varlistentry> <varlistentry> <term> - <option>noupdate</option> + noupdate </term> <listitem> <para> @@ -164,7 +173,7 @@ </varlistentry> <varlistentry> <term> - <option>showfailed</option> + showfailed </term> <listitem> <para> @@ -176,7 +185,7 @@ </varlistentry> <varlistentry> <term> - <option>inactive=<days></option> + inactive=<days> </term> <listitem> <para> @@ -187,21 +196,33 @@ </para> </listitem> </varlistentry> + <varlistentry> + <term> + unlimited + </term> + <listitem> + <para> + If the <emphasis>fsize</emphasis> limit is set, this option can be + used to override it, preventing failures on systems with large UID + values that lead lastlog to become a huge sparse file. + </para> + </listitem> + </varlistentry> </variablelist> </refsect1> - <refsect1 id="pam_lastlog-types"> + <refsect1 xml:id="pam_lastlog-types"> <title>MODULE TYPES PROVIDED</title> <para> The <option>auth</option> and <option>account</option> module type - allows to lock out users which did not login recently enough. + allows one to lock out users who did not login recently enough. The <option>session</option> module type is provided for displaying the information about the last login and/or updating the lastlog and wtmp files. </para> </refsect1> - <refsect1 id='pam_lastlog-return_values'> + <refsect1 xml:id="pam_lastlog-return_values"> <title>RETURN VALUES</title> <para> <variablelist> @@ -258,11 +279,11 @@ </para> </refsect1> - <refsect1 id='pam_lastlog-examples'> + <refsect1 xml:id="pam_lastlog-examples"> <title>EXAMPLES</title> <para> Add the following line to <filename>/etc/pam.d/login</filename> to - display the last login time of an user: + display the last login time of a user: </para> <programlisting> session required pam_lastlog.so nowtmp @@ -276,11 +297,11 @@ </programlisting> </refsect1> - <refsect1 id="pam_lastlog-files"> + <refsect1 xml:id="pam_lastlog-files"> <title>FILES</title> <variablelist> <varlistentry> - <term><filename>/var/log/lastlog</filename></term> + <term>/var/log/lastlog</term> <listitem> <para>Lastlog logging file</para> </listitem> @@ -288,22 +309,25 @@ </variablelist> </refsect1> - <refsect1 id='pam_lastlog-see_also'> + <refsect1 xml:id="pam_lastlog-see_also"> <title>SEE ALSO</title> <para> <citerefentry> + <refentrytitle>limits.conf</refentrytitle><manvolnum>5</manvolnum> + </citerefentry>, + <citerefentry> <refentrytitle>pam.conf</refentrytitle><manvolnum>5</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>pam.d</refentrytitle><manvolnum>5</manvolnum> </citerefentry>, <citerefentry> - <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum> + <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum> </citerefentry> </para> </refsect1> - <refsect1 id='pam_lastlog-author'> + <refsect1 xml:id="pam_lastlog-author"> <title>AUTHOR</title> <para> pam_lastlog was written by Andrew G. Morgan <morgan@kernel.org>. @@ -313,4 +337,4 @@ </para> </refsect1> -</refentry> +</refentry>
\ No newline at end of file |