File: pam_debuginfo.8.xml

package info (click to toggle)
account-utils 1.0.1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 836 kB
  • sloc: ansic: 8,789; xml: 1,584; sh: 77; makefile: 10
file content (124 lines) | stat: -rw-r--r-- 3,561 bytes parent folder | download
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
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_debuginfo">
  <refmeta>
    <refentrytitle>pam_debuginfo</refentrytitle>
    <manvolnum>8</manvolnum>
    <refmiscinfo class="source">account-utils %version%</refmiscinfo>
    <refmiscinfo class="manual">pam_debuginfo</refmiscinfo>
  </refmeta>

  <refnamediv>
    <refname>pam_debuginfo</refname>
    <refpurpose>PAM module logging information for debugging</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis sepchar=" ">
      <command>pam_debuginfo.so</command>
      <arg choice="opt" rep="norepeat">
        ...
      </arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>DESCRIPTION</title>
    <para>
      This is a PAM module which logs a lot of useful information for
      debugging. It logs the following information:
    </para>
    <itemizedlist>
      <listitem><para>Service name</para></listitem>
      <listitem><para>PAM type</para></listitem>
      <listitem><para>PAM flags</para></listitem>
      <listitem><para>UID</para></listitem>
      <listitem><para>EUID</para></listitem>
      <listitem><para>PAM items</para></listitem>
      <listitem><para>SELinux status</para></listitem>
      <listitem><para>NoNewPrivs status</para></listitem>
    </itemizedlist>
  </refsect1>

  <refsect1>
    <title>OPTIONS</title>
    <variablelist>
      <varlistentry>
        <term>
          <option>loglevel=</option><replaceable>level</replaceable>
        </term>
        <listitem>
          <para>
            Define with which
            <citerefentry>
              <refentrytitle>syslog</refentrytitle><manvolnum>3</manvolnum>
            </citerefentry>
	    level the information should be printed. Valid values are debug,
	    info, notice, warning, error, critical, alert and emerg.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>MODULE TYPES PROVIDED</title>
    <para>
      All module types (<option>account</option>, <option>auth</option>,
      <option>password</option>, <option>session</option>) are provided.
    </para>
  </refsect1>

  <refsect1>
    <title>RETURN VALUES</title>
    <para>
      <variablelist>
        <varlistentry>
          <term>PAM_IGNORE</term>
          <listitem>
            <para>
              Returned by all service types.
            </para>
          </listitem>
        </varlistentry>
      </variablelist>
    </para>
  </refsect1>

  <refsect1>
    <title>EXAMPLES</title>
    <para>
      Add the following line to e.g. <filename>/etc/pam.d/login</filename> to
      log all information via
      <citerefentry>
        <refentrytitle>syslog</refentrytitle><manvolnum>8</manvolnum>
      </citerefentry>:
    </para>
    <programlisting>
      auth     optional  pam_debuginfo.so
      account  optional  pam_debuginfo.so
      password optional  pam_debuginfo.so
      session  optional  pam_debuginfo.so
    </programlisting>
  </refsect1>

  <refsect1>
    <title>SEE ALSO</title>
    <para>
      <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>
    <title>AUTHOR</title>
    <para>
      pam_debuginfo was written by Thorsten Kukuk &lt;kukuk@suse.com&gt;.
    </para>
  </refsect1>
</refentry>