]> granicus.if.org Git - shadow/blob - man/login.defs.5.xml
* src/faillog.c, src/chage.c, src/newusers.c, src/su.c: The getopt
[shadow] / man / login.defs.5.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3    Copyright (c) 1991 - 1993, Julianne Frances Haugh
4    Copyright (c) 1991 - 1993, Chip Rosenthal
5    Copyright (c) 2007 - 2009, Nicolas François
6    All rights reserved.
7   
8    Redistribution and use in source and binary forms, with or without
9    modification, are permitted provided that the following conditions
10    are met:
11    1. Redistributions of source code must retain the above copyright
12       notice, this list of conditions and the following disclaimer.
13    2. Redistributions in binary form must reproduce the above copyright
14       notice, this list of conditions and the following disclaimer in the
15       documentation and/or other materials provided with the distribution.
16    3. The name of the copyright holders or contributors may not be used to
17       endorse or promote products derived from this software without
18       specific prior written permission.
19   
20    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21    ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22    LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
23    PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT
24    HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25    SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26    LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
30    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31 -->
32 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.5//EN" 
33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
34 <!ENTITY CHFN_AUTH             SYSTEM "login.defs.d/CHFN_AUTH.xml">
35 <!ENTITY CHFN_RESTRICT         SYSTEM "login.defs.d/CHFN_RESTRICT.xml">
36 <!ENTITY CHSH_AUTH             SYSTEM "login.defs.d/CHSH_AUTH.xml">
37 <!ENTITY CONSOLE               SYSTEM "login.defs.d/CONSOLE.xml">
38 <!ENTITY CONSOLE_GROUPS        SYSTEM "login.defs.d/CONSOLE_GROUPS.xml">
39 <!ENTITY CREATE_HOME           SYSTEM "login.defs.d/CREATE_HOME.xml">
40 <!ENTITY DEFAULT_HOME          SYSTEM "login.defs.d/DEFAULT_HOME.xml">
41 <!ENTITY ENCRYPT_METHOD        SYSTEM "login.defs.d/ENCRYPT_METHOD.xml">
42 <!ENTITY ENV_HZ                SYSTEM "login.defs.d/ENV_HZ.xml">
43 <!ENTITY ENV_PATH              SYSTEM "login.defs.d/ENV_PATH.xml">
44 <!ENTITY ENV_SUPATH            SYSTEM "login.defs.d/ENV_SUPATH.xml">
45 <!ENTITY ENV_TZ                SYSTEM "login.defs.d/ENV_TZ.xml">
46 <!ENTITY ENVIRON_FILE          SYSTEM "login.defs.d/ENVIRON_FILE.xml">
47 <!ENTITY ERASECHAR             SYSTEM "login.defs.d/ERASECHAR.xml">
48 <!ENTITY FAIL_DELAY            SYSTEM "login.defs.d/FAIL_DELAY.xml">
49 <!ENTITY FAILLOG_ENAB          SYSTEM "login.defs.d/FAILLOG_ENAB.xml">
50 <!ENTITY FAKE_SHELL            SYSTEM "login.defs.d/FAKE_SHELL.xml">
51 <!ENTITY FTMP_FILE             SYSTEM "login.defs.d/FTMP_FILE.xml">
52 <!ENTITY GID_MAX               SYSTEM "login.defs.d/GID_MAX.xml">
53 <!ENTITY HUSHLOGIN_FILE        SYSTEM "login.defs.d/HUSHLOGIN_FILE.xml">
54 <!ENTITY ISSUE_FILE            SYSTEM "login.defs.d/ISSUE_FILE.xml">
55 <!ENTITY KILLCHAR              SYSTEM "login.defs.d/KILLCHAR.xml">
56 <!ENTITY LASTLOG_ENAB          SYSTEM "login.defs.d/LASTLOG_ENAB.xml">
57 <!ENTITY LOG_OK_LOGINS         SYSTEM "login.defs.d/LOG_OK_LOGINS.xml">
58 <!ENTITY LOG_UNKFAIL_ENAB      SYSTEM "login.defs.d/LOG_UNKFAIL_ENAB.xml">
59 <!ENTITY LOGIN_RETRIES         SYSTEM "login.defs.d/LOGIN_RETRIES.xml">
60 <!ENTITY LOGIN_STRING          SYSTEM "login.defs.d/LOGIN_STRING.xml">
61 <!ENTITY LOGIN_TIMEOUT         SYSTEM "login.defs.d/LOGIN_TIMEOUT.xml">
62 <!ENTITY MAIL_CHECK_ENAB       SYSTEM "login.defs.d/MAIL_CHECK_ENAB.xml">
63 <!ENTITY MAIL_DIR              SYSTEM "login.defs.d/MAIL_DIR.xml">
64 <!ENTITY MAX_MEMBERS_PER_GROUP SYSTEM "login.defs.d/MAX_MEMBERS_PER_GROUP.xml">
65 <!ENTITY MD5_CRYPT_ENAB        SYSTEM "login.defs.d/MD5_CRYPT_ENAB.xml">
66 <!ENTITY MOTD_FILE             SYSTEM "login.defs.d/MOTD_FILE.xml">
67 <!ENTITY NOLOGINS_FILE         SYSTEM "login.defs.d/NOLOGINS_FILE.xml">
68 <!ENTITY OBSCURE_CHECKS_ENAB   SYSTEM "login.defs.d/OBSCURE_CHECKS_ENAB.xml">
69 <!ENTITY PASS_ALWAYS_WARN      SYSTEM "login.defs.d/PASS_ALWAYS_WARN.xml">
70 <!ENTITY PASS_CHANGE_TRIES     SYSTEM "login.defs.d/PASS_CHANGE_TRIES.xml">
71 <!ENTITY PASS_MAX_LEN          SYSTEM "login.defs.d/PASS_MAX_LEN.xml">
72 <!ENTITY PASS_MAX_DAYS         SYSTEM "login.defs.d/PASS_MAX_DAYS.xml">
73 <!ENTITY PASS_MIN_DAYS         SYSTEM "login.defs.d/PASS_MIN_DAYS.xml">
74 <!ENTITY PASS_WARN_AGE         SYSTEM "login.defs.d/PASS_WARN_AGE.xml">
75 <!ENTITY PORTTIME_CHECKS_ENAB  SYSTEM "login.defs.d/PORTTIME_CHECKS_ENAB.xml">
76 <!ENTITY QUOTAS_ENAB           SYSTEM "login.defs.d/QUOTAS_ENAB.xml">
77 <!ENTITY SHA_CRYPT_MIN_ROUNDS  SYSTEM "login.defs.d/SHA_CRYPT_MIN_ROUNDS.xml">
78 <!ENTITY SULOG_FILE            SYSTEM "login.defs.d/SULOG_FILE.xml">
79 <!ENTITY SU_NAME               SYSTEM "login.defs.d/SU_NAME.xml">
80 <!ENTITY SU_WHEEL_ONLY         SYSTEM "login.defs.d/SU_WHEEL_ONLY.xml">
81 <!ENTITY SYS_GID_MAX           SYSTEM "login.defs.d/SYS_GID_MAX.xml">
82 <!ENTITY SYSLOG_SG_ENAB        SYSTEM "login.defs.d/SYSLOG_SG_ENAB.xml">
83 <!ENTITY SYSLOG_SU_ENAB        SYSTEM "login.defs.d/SYSLOG_SU_ENAB.xml">
84 <!ENTITY SYS_UID_MAX           SYSTEM "login.defs.d/SYS_UID_MAX.xml">
85 <!ENTITY TCB_AUTH_GROUP        SYSTEM "login.defs.d/TCB_AUTH_GROUP.xml">
86 <!ENTITY TCB_SYMLINKS          SYSTEM "login.defs.d/TCB_SYMLINKS.xml">
87 <!ENTITY TTYGROUP              SYSTEM "login.defs.d/TTYGROUP.xml">
88 <!ENTITY TTYTYPE_FILE          SYSTEM "login.defs.d/TTYTYPE_FILE.xml">
89 <!ENTITY UID_MAX               SYSTEM "login.defs.d/UID_MAX.xml">
90 <!ENTITY ULIMIT                SYSTEM "login.defs.d/ULIMIT.xml">
91 <!ENTITY UMASK                 SYSTEM "login.defs.d/UMASK.xml">
92 <!ENTITY USERDEL_CMD           SYSTEM "login.defs.d/USERDEL_CMD.xml">
93 <!ENTITY USERGROUPS_ENAB       SYSTEM "login.defs.d/USERGROUPS_ENAB.xml">
94 <!ENTITY USE_TCB               SYSTEM "login.defs.d/USE_TCB.xml">
95 <!-- SHADOW-CONFIG-HERE -->
96 ]>
97
98 <refentry id='login.defs.5'>
99   <!--  $Id$ -->
100   <refmeta>
101     <refentrytitle>login.defs</refentrytitle>
102     <manvolnum>5</manvolnum>
103     <refmiscinfo class="sectdesc">File Formats and Conversions</refmiscinfo>
104     <refmiscinfo class="source">shadow-utils</refmiscinfo>
105     <refmiscinfo class="version">&SHADOW_UTILS_VERSION;</refmiscinfo>
106   </refmeta>
107   <refnamediv id='name'>
108     <refname>login.defs</refname>
109     <refpurpose>shadow password suite configuration</refpurpose>
110   </refnamediv>
111
112   <refsect1 id='description'>
113     <title>DESCRIPTION</title>
114     <para>
115       The <filename>/etc/login.defs</filename> file defines the
116       site-specific configuration for the shadow password suite. This file
117       is required. Absence of this file will not prevent system operation,
118       but will probably result in undesirable operation.
119     </para>
120
121     <para>
122       This file is a readable text file, each line of the file describing
123       one configuration parameter. The lines consist of a configuration name
124       and value, separated by whitespace. Blank lines and comment lines are
125       ignored. Comments are introduced with a "#" pound sign and the pound
126       sign must be the first non-white character of the line.
127     </para>
128
129     <para>
130       Parameter values may be of four types: strings, booleans, numbers, and
131       long numbers. A string is comprised of any printable characters. A
132       boolean should be either the value <replaceable>yes</replaceable> or
133       <replaceable>no</replaceable>. An undefined boolean
134       parameter or one with a value other than these will be given a
135       <replaceable>no</replaceable>
136       value. Numbers (both regular and long) may be either decimal values,
137       octal values (precede the value with <replaceable>0</replaceable>) or
138       hexadecimal values
139       (precede the value with <replaceable>0x</replaceable>).
140       The maximum value of the regular and
141       long numeric parameters is machine-dependent.
142     </para>
143
144     <para>The following configuration items are provided:</para>
145
146     <variablelist remap='IP'>
147       &CHFN_AUTH;
148       &CHFN_RESTRICT;
149       &CHSH_AUTH;
150       &CONSOLE;
151       &CONSOLE_GROUPS;
152       &CREATE_HOME;
153       &DEFAULT_HOME;
154       &ENCRYPT_METHOD;
155       &ENV_HZ;
156       &ENV_PATH;
157       &ENV_SUPATH;
158       &ENV_TZ;
159       &ENVIRON_FILE;
160       &ERASECHAR;
161       &FAIL_DELAY;
162       &FAILLOG_ENAB;
163       &FAKE_SHELL;
164       &FTMP_FILE;
165       &GID_MAX; <!-- documents also GID_MIN -->
166       &HUSHLOGIN_FILE;
167       &ISSUE_FILE;
168       &KILLCHAR;
169       &LASTLOG_ENAB;
170       &LOG_OK_LOGINS;
171       &LOG_UNKFAIL_ENAB;
172       &LOGIN_RETRIES;
173       &LOGIN_STRING;
174       &LOGIN_TIMEOUT;
175       &MAIL_CHECK_ENAB;
176       &MAIL_DIR;
177       &MAX_MEMBERS_PER_GROUP;
178       &MD5_CRYPT_ENAB;
179       &MOTD_FILE;
180       &NOLOGINS_FILE;
181       &OBSCURE_CHECKS_ENAB;
182       &PASS_ALWAYS_WARN;
183       &PASS_CHANGE_TRIES;
184       &PASS_MAX_DAYS;
185       &PASS_MIN_DAYS;
186       &PASS_WARN_AGE;
187       <para> 
188         <option>PASS_MAX_DAYS</option>, <option>PASS_MIN_DAYS</option> and
189         <option>PASS_WARN_AGE</option> are only used at the
190         time of account creation. Any changes to these settings won't affect
191         existing accounts.
192       </para>
193       &PASS_MAX_LEN; <!-- documents also PASS_MIN_LEN -->
194       &PORTTIME_CHECKS_ENAB;
195       &QUOTAS_ENAB;
196       &SHA_CRYPT_MIN_ROUNDS; <!-- documents also SHA_CRYPT_MAX_ROUNDS -->
197       &SULOG_FILE;
198       &SU_NAME;
199       &SU_WHEEL_ONLY;
200       &SYS_GID_MAX; <!-- documents also SYS_GID_MIN -->
201       &SYS_UID_MAX; <!-- documents also SYS_UID_MIN -->
202       &SYSLOG_SG_ENAB;
203       &SYSLOG_SU_ENAB;
204       &TCB_AUTH_GROUP;
205       &TCB_SYMLINKS;
206       &TTYGROUP;
207       &TTYTYPE_FILE;
208       &UID_MAX; <!-- documents also UID_MIN -->
209       &ULIMIT;
210       &UMASK;
211       &USERDEL_CMD;
212       &USERGROUPS_ENAB;
213       &USE_TCB;
214     </variablelist>
215   </refsect1>
216
217   <refsect1 id='cross_references'>
218     <title>CROSS REFERENCES</title>
219     <para>
220       The following cross references show which programs in the shadow
221       password suite use which parameters.
222     </para>
223     <!-- .na -->
224     <variablelist remap='IP'>
225       <varlistentry condition="tcb">
226         <term>chage</term>
227         <listitem>
228           <para>USE_TCB</para>
229         </listitem>
230       </varlistentry>
231       <varlistentry>
232         <term>chfn</term>
233         <listitem>
234           <para>
235             <phrase condition="no_pam">CHFN_AUTH</phrase>
236             CHFN_RESTRICT
237             <phrase condition="no_pam">LOGIN_STRING</phrase>
238           </para>
239         </listitem>
240       </varlistentry>
241       <varlistentry>
242         <term>chgpasswd</term>
243         <listitem>
244           <para>
245             ENCRYPT_METHOD MAX_MEMBERS_PER_GROUP MD5_CRYPT_ENAB
246             <phrase condition="sha_crypt">SHA_CRYPT_MAX_ROUNDS
247             SHA_CRYPT_MIN_ROUNDS</phrase>
248           </para>
249         </listitem>
250       </varlistentry>
251       <varlistentry>
252         <term>chpasswd</term>
253         <listitem>
254           <para>
255             <phrase condition="no_pam">ENCRYPT_METHOD
256             MD5_CRYPT_ENAB </phrase>
257             <phrase condition="sha_crypt">SHA_CRYPT_MAX_ROUNDS
258             SHA_CRYPT_MIN_ROUNDS</phrase>
259           </para>
260         </listitem>
261       </varlistentry>
262       <varlistentry condition="no_pam">
263         <term>chsh</term>
264         <listitem>
265           <para>
266             CHSH_AUTH LOGIN_STRING
267           </para>
268         </listitem>
269       </varlistentry>
270       <!-- expiry: no variables (CONSOLE_GROUPS linked, but not used) -->
271       <!-- faillog: no variables -->
272       <varlistentry>
273         <term>gpasswd</term>
274         <listitem>
275           <para>
276             ENCRYPT_METHOD MAX_MEMBERS_PER_GROUP MD5_CRYPT_ENAB
277             <phrase condition="sha_crypt">SHA_CRYPT_MAX_ROUNDS
278             SHA_CRYPT_MIN_ROUNDS</phrase>
279           </para>
280         </listitem>
281       </varlistentry>
282       <varlistentry>
283         <term>groupadd</term>
284         <listitem>
285           <para>
286             GID_MAX GID_MIN MAX_MEMBERS_PER_GROUP
287             SYS_GID_MAX SYS_GID_MIN
288           </para>
289         </listitem>
290       </varlistentry>
291       <varlistentry>
292         <term>groupdel</term>
293         <listitem>
294           <para>MAX_MEMBERS_PER_GROUP</para>
295         </listitem>
296       </varlistentry>
297       <varlistentry>
298         <term>groupmems</term>
299         <listitem>
300           <para>MAX_MEMBERS_PER_GROUP</para>
301         </listitem>
302       </varlistentry>
303       <varlistentry>
304         <term>groupmod</term>
305         <listitem>
306           <para>MAX_MEMBERS_PER_GROUP</para>
307         </listitem>
308       </varlistentry>
309       <!-- groups: no variables -->
310       <varlistentry>
311         <term>grpck</term>
312         <listitem>
313           <para>MAX_MEMBERS_PER_GROUP</para>
314         </listitem>
315       </varlistentry>
316       <varlistentry>
317         <term>grpconv</term>
318         <listitem>
319           <para>MAX_MEMBERS_PER_GROUP</para>
320         </listitem>
321       </varlistentry>
322       <varlistentry>
323         <term>grpunconv</term>
324         <listitem>
325           <para>MAX_MEMBERS_PER_GROUP</para>
326         </listitem>
327       </varlistentry>
328       <!-- id: no variables -->
329       <!-- lastlog: no variables -->
330       <varlistentry>
331         <term>login</term>
332         <listitem>
333           <para>
334             <phrase condition="no_pam">CONSOLE</phrase>
335             CONSOLE_GROUPS DEFAULT_HOME
336             <phrase condition="no_pam">ENV_HZ ENV_PATH ENV_SUPATH
337             ENV_TZ ENVIRON_FILE</phrase>
338             ERASECHAR FAIL_DELAY
339             <phrase condition="no_pam">FAILLOG_ENAB</phrase>
340             FAKE_SHELL
341             <phrase condition="no_pam">FTMP_FILE</phrase>
342             HUSHLOGIN_FILE
343             <phrase condition="no_pam">ISSUE_FILE</phrase>
344             KILLCHAR
345             <phrase condition="no_pam">LASTLOG_ENAB</phrase>
346             LOGIN_RETRIES
347             <phrase condition="no_pam">LOGIN_STRING</phrase>
348             LOGIN_TIMEOUT LOG_OK_LOGINS LOG_UNKFAIL_ENAB
349             <phrase condition="no_pam">MAIL_CHECK_ENAB MAIL_DIR MAIL_FILE
350             MOTD_FILE NOLOGINS_FILE PORTTIME_CHECKS_ENAB
351             QUOTAS_ENAB</phrase>
352             TTYGROUP TTYPERM TTYTYPE_FILE
353             <phrase condition="no_pam">ULIMIT UMASK</phrase>
354             USERGROUPS_ENAB
355           </para>
356         </listitem>
357       </varlistentry>
358       <!-- logoutd: no variables -->
359       <varlistentry>
360         <term>newgrp / sg</term>
361         <listitem>
362           <para>
363             SYSLOG_SG_ENAB
364           </para>
365         </listitem>
366       </varlistentry>
367       <varlistentry>
368         <term>newusers</term>
369         <listitem>
370           <para>
371             ENCRYPT_METHOD
372             GID_MAX GID_MIN
373             MAX_MEMBERS_PER_GROUP MD5_CRYPT_ENAB
374             PASS_MAX_DAYS PASS_MIN_DAYS PASS_WARN_AGE
375             <phrase condition="sha_crypt">SHA_CRYPT_MAX_ROUNDS
376             SHA_CRYPT_MIN_ROUNDS</phrase>
377             SYS_GID_MAX SYS_GID_MIN SYS_UID_MAX SYS_UID_MIN UID_MAX UID_MIN
378             UMASK
379           </para>
380         </listitem>
381       </varlistentry>
382       <!-- nologin: no variables -->
383       <varlistentry condition="no_pam">
384         <term>passwd</term>
385         <listitem>
386           <para>
387             ENCRYPT_METHOD MD5_CRYPT_ENAB OBSCURE_CHECKS_ENAB
388             PASS_ALWAYS_WARN PASS_CHANGE_TRIES PASS_MAX_LEN PASS_MIN_LEN
389             <phrase condition="sha_crypt">SHA_CRYPT_MAX_ROUNDS
390             SHA_CRYPT_MIN_ROUNDS</phrase>
391           </para>
392         </listitem>
393       </varlistentry>
394       <varlistentry>
395         <term>pwck</term>
396         <listitem>
397           <para>
398             PASS_MAX_DAYS PASS_MIN_DAYS PASS_WARN_AGE
399             <phrase condition="tcb">TCB_AUTH_GROUP TCB_SYMLINKS USE_TCB</phrase>
400           </para>
401         </listitem>
402       </varlistentry>
403       <varlistentry>
404         <term>pwconv</term>
405         <listitem>
406           <para>
407             PASS_MAX_DAYS PASS_MIN_DAYS PASS_WARN_AGE
408             <phrase condition="tcb">USE_TCB</phrase>
409           </para>
410         </listitem>
411       </varlistentry>
412       <varlistentry condition="tcb">
413         <term>pwunconv</term>
414         <listitem>
415           <para>
416             <phrase condition="tcb">USE_TCB</phrase>
417           </para>
418         </listitem>
419       </varlistentry>
420       <varlistentry>
421         <term>su</term>
422         <listitem>
423           <para>
424             <phrase condition="no_pam">CONSOLE</phrase>
425             CONSOLE_GROUPS DEFAULT_HOME
426             <phrase condition="no_pam">ENV_HZ ENVIRON_FILE</phrase>
427             ENV_PATH ENV_SUPATH
428             <phrase condition="no_pam">ENV_TZ LOGIN_STRING MAIL_CHECK_ENAB
429             MAIL_DIR MAIL_FILE QUOTAS_ENAB</phrase>
430             SULOG_FILE SU_NAME
431             <phrase condition="no_pam">SU_WHEEL_ONLY</phrase>
432             SYSLOG_SU_ENAB
433             <phrase condition="no_pam">USERGROUPS_ENAB</phrase>
434           </para>
435         </listitem>
436       </varlistentry>
437       <varlistentry>
438         <term>sulogin</term>
439         <listitem>
440           <para>
441             ENV_HZ
442             <phrase condition="no_pam">ENV_TZ</phrase>
443           </para>
444         </listitem>
445       </varlistentry>
446       <varlistentry>
447         <term>useradd</term>
448         <listitem>
449           <para>
450             CREATE_HOME
451             GID_MAX GID_MIN
452             MAIL_DIR MAX_MEMBERS_PER_GROUP
453             PASS_MAX_DAYS PASS_MIN_DAYS PASS_WARN_AGE
454             SYS_GID_MAX SYS_GID_MIN SYS_UID_MAX SYS_UID_MIN UID_MAX UID_MIN
455             UMASK
456             <phrase condition="tcb">TCB_AUTH_GROUP TCB_SYMLINK USE_TCB</phrase>
457           </para>
458         </listitem>
459       </varlistentry>
460       <varlistentry>
461         <term>userdel</term>
462         <listitem>
463           <para>
464             MAIL_DIR MAIL_FILE MAX_MEMBERS_PER_GROUP USERDEL_CMD
465             USERGROUPS_ENAB
466             <phrase condition="tcb">TCB_SYMLINKS USE_TCB</phrase>
467           </para>
468         </listitem>
469       </varlistentry>
470       <varlistentry>
471         <term>usermod</term>
472         <listitem>
473           <para>
474             MAIL_DIR MAIL_FILE MAX_MEMBERS_PER_GROUP
475             <phrase condition="tcb">TCB_SYMLINKS USE_TCB</phrase>
476           </para>
477         </listitem>
478       </varlistentry>
479       <varlistentry condition="tcb">
480         <term>vipw</term>
481         <listitem>
482           <para>
483             <phrase condition="tcb">USE_TCB</phrase>
484           </para>
485         </listitem>
486       </varlistentry>
487     </variablelist>
488   </refsect1>
489
490   <refsect1 id='bugs' condition="pam">
491     <title>BUGS</title>
492     <para>
493       Much of the functionality that used to be provided by the shadow
494       password suite is now handled by PAM. Thus,
495       <filename>/etc/login.defs</filename> is no longer used by <citerefentry>
496       <refentrytitle>passwd</refentrytitle><manvolnum>1</manvolnum>
497       </citerefentry>, or less used by <citerefentry>
498       <refentrytitle>login</refentrytitle><manvolnum>1</manvolnum>
499       </citerefentry>, and <citerefentry>
500       <refentrytitle>su</refentrytitle><manvolnum>1</manvolnum>
501       </citerefentry>. Please refer to the corresponding PAM configuration
502       files instead.
503     </para>
504   </refsect1>
505
506   <refsect1 id='see_also'>
507     <title>SEE ALSO</title>
508     <para>
509       <citerefentry>
510         <refentrytitle>login</refentrytitle><manvolnum>1</manvolnum>
511       </citerefentry>,
512       <citerefentry>
513         <refentrytitle>passwd</refentrytitle><manvolnum>1</manvolnum>
514       </citerefentry>,
515       <citerefentry>
516         <refentrytitle>su</refentrytitle><manvolnum>1</manvolnum>
517       </citerefentry>,
518       <citerefentry>
519         <refentrytitle>passwd</refentrytitle><manvolnum>5</manvolnum>
520       </citerefentry>,
521       <citerefentry>
522         <refentrytitle>shadow</refentrytitle><manvolnum>5</manvolnum>
523       </citerefentry>,
524       <citerefentry>
525         <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
526       </citerefentry>.
527     </para>
528   </refsect1>
529 </refentry>