summaryrefslogtreecommitdiff
path: root/modules/pam_faildelay/pam_faildelay.8.xml
blob: c31b5076d4d55dd481d379fa9f272562bb007b40 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_faildelay">

  <refmeta>
    <refentrytitle>pam_faildelay</refentrytitle>
    <manvolnum>8</manvolnum>
    <refmiscinfo class="source">Linux-PAM</refmiscinfo>
    <refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
  </refmeta>

  <refnamediv xml:id="pam_faildelay-name">
    <refname>pam_faildelay</refname>
    <refpurpose>Change the delay on failure per-application</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis xml:id="pam_faildelay-cmdsynopsis" sepchar=" ">
      <command>pam_faildelay.so</command>
      <arg choice="opt" rep="norepeat">
        debug
      </arg>
      <arg choice="opt" rep="norepeat">
        delay=<replaceable>microseconds</replaceable>
      </arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1 xml:id="pam_faildelay-description">

    <title>DESCRIPTION</title>

    <para>
      pam_faildelay is a PAM module that can be used to set
      the delay on failure per-application.
    </para>
    <para>
      If no <option>delay</option> is given, pam_faildelay will
      use the value of FAIL_DELAY from <filename>/etc/login.defs</filename>.
    </para>
  </refsect1>

  <refsect1 xml:id="pam_faildelay-options">

    <title>OPTIONS</title>
    <variablelist>
      <varlistentry>
        <term>
          debug
        </term>
        <listitem>
          <para>
            Turns on debugging messages sent to syslog.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          delay=N
        </term>
        <listitem>
          <para>
	    Set the delay on failure to N microseconds.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1 xml:id="pam_faildelay-types">
    <title>MODULE TYPES PROVIDED</title>
    <para>
      Only the <option>auth</option> module type is provided.
    </para>
  </refsect1>

  <refsect1 xml:id="pam_faildelay-return_values">
    <title>RETURN VALUES</title>
    <variablelist>
      <varlistentry>
        <term>PAM_IGNORE</term>
        <listitem>
           <para>
            Delay was successful adjusted.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>PAM_SYSTEM_ERR</term>
        <listitem>
          <para>
            The specified delay was not valid.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1 xml:id="pam_faildelay-examples">
    <title>EXAMPLES</title>
    <para>
      The following example will set the delay on failure to
      10 seconds:
      <programlisting>
auth  optional  pam_faildelay.so  delay=10000000
      </programlisting>
    </para>
  </refsect1>

  <refsect1 xml:id="pam_faildelay-see_also">
    <title>SEE ALSO</title>
    <para>
      <citerefentry>
	<refentrytitle>pam_fail_delay</refentrytitle><manvolnum>3</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>
      </citerefentry>
    </para>
  </refsect1>

  <refsect1 xml:id="pam_faildelay-author">
    <title>AUTHOR</title>
      <para>
        pam_faildelay was written by Darren Tucker &lt;dtucker@zip.com.au&gt;.
      </para>
  </refsect1>

</refentry>