← Back to branch summary

~ubuntu-branches/ubuntu/quantal/shadow/quantal

« back to all changes in this revision

Viewing changes to man/pwck.8.xml

  • Committer: Bazaar Package Importer
  • Author(s): Nicolas Valcárcel Scerpella (Canonical)
  • Date: 2009-11-07 04:55:18 UTC
  • mfrom: (1.1.8 upstream) (18.1.2 sid)
  • Revision ID: james.westby@ubuntu.com-20091107045518-qqclg1lhinz6zv1i
Tags: 1:4.1.4.2-1ubuntu1
https://launchpad.net/bugs/477299
* Merged with debian unstable. Remaning changes (LP: #477299):
  - Ubuntu specific:
    + debian/login.defs: use SHA512 by default for password crypt routine.
  - debian/patches/495_stdout-encrypted-password: chpasswd can report
    password hashes on stdout (Debian bug 505640).
  - Rework 495_stdout-encrypted-password to cope with chpasswd using PAM.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/pwck.8.xml
1
1
<?xml version="1.0" encoding="UTF-8"?>
2
2
<!--
3
3
   Copyright (c) 1992       , Julianne Frances Haugh
4
 
   Copyright (c) 2007 - 2008, Nicolas François
 
4
   Copyright (c) 2007 - 2009, Nicolas François
5
5
   All rights reserved.
6
6
  
7
7
   Redistribution and use in source and binary forms, with or without
35
35
<!ENTITY PASS_WARN_AGE         SYSTEM "login.defs.d/PASS_WARN_AGE.xml">
36
36
]>
37
37
<refentry id='pwck.8'>
38
 
  <!-- $Id: pwck.8.xml 2436 2008-10-11 12:59:02Z nekral-guest $ -->
 
38
  <!-- $Id: pwck.8.xml 3023 2009-06-20 13:02:33Z nekral-guest $ -->
39
39
  <refmeta>
40
40
    <refentrytitle>pwck</refentrytitle>
41
41
    <manvolnum>8</manvolnum>
70
70
        <arg choice='plain'>
71
71
          <replaceable>passwd</replaceable>
72
72
        </arg>
 
73
        <arg choice='opt'>
73
74
        <arg choice='plain'>
74
75
          <replaceable>shadow</replaceable>
75
76
        </arg>
 
77
        </arg>
76
78
      </arg>
77
79
    </cmdsynopsis>
78
80
  </refsynopsisdiv>
81
83
    <title>DESCRIPTION</title>
82
84
    <para>
83
85
      The <command>pwck</command> command verifies the integrity of the
84
 
      system authentication information. All entries in the
 
86
      users and authentication information. It checks that all entries in
85
87
      <filename>/etc/passwd</filename> and <filename>/etc/shadow</filename>
86
 
      are checked to see that the entry has the proper format and valid data
87
 
      in each field. The user is prompted to delete entries that are
 
88
      have the proper format and contain valid data.
 
89
      The user is prompted to delete entries that are
88
90
      improperly formatted or which have other uncorrectable errors.
89
91
    </para>
90
92
 
94
96
        <para>the correct number of fields</para>
95
97
      </listitem>
96
98
      <listitem>
97
 
        <para>a unique user name</para>
 
99
        <para>a unique and valid user name</para>
98
100
      </listitem>
99
101
      <listitem>
100
102
        <para>a valid user and group identifier</para>
111
113
    </itemizedlist>
112
114
 
113
115
    <para>
 
116
      <filename>shadow</filename> checks are enabled when a second file
 
117
      parameter is specified or when <filename>/etc/shadow</filename>
 
118
      exists on the system.
 
119
    </para>
 
120
    <para>
 
121
      These checks are the following:
 
122
    </para>
 
123
    <itemizedlist mark='bullet'>
 
124
      <listitem>
 
125
        <para>
 
126
          every passwd entry has a matching shadow entry, and every shadow
 
127
          entry has a matching passwd entry
 
128
        </para>
 
129
      </listitem>
 
130
      <listitem>
 
131
        <para>passwords are specified in the shadowed file</para>
 
132
      </listitem>
 
133
      <listitem>
 
134
        <para>shadow entries have the correct number of fields</para>
 
135
      </listitem>
 
136
      <listitem>
 
137
        <para>shadow entries are unique in shadow</para>
 
138
      </listitem>
 
139
      <listitem>
 
140
        <para>the last password changes are not in the future</para>
 
141
      </listitem>
 
142
    </itemizedlist>
 
143
 
 
144
    <para>
114
145
      The checks for correct number of fields and unique user name are
115
146
      fatal. If the entry has the wrong number of fields, the user will be
116
147
      prompted to delete the entire line. If the user does not answer
216
247
    </variablelist>
217
248
  </refsect1>
218
249
 
219
 
  <refsect1 id='see_also'>
220
 
    <title>SEE ALSO</title>
221
 
    <para>
222
 
      <citerefentry>
223
 
        <refentrytitle>group</refentrytitle><manvolnum>5</manvolnum>
224
 
      </citerefentry>,
225
 
      <citerefentry>
226
 
        <refentrytitle>grpck</refentrytitle><manvolnum>8</manvolnum>
227
 
      </citerefentry>,
228
 
      <citerefentry>
229
 
        <refentrytitle>passwd</refentrytitle><manvolnum>5</manvolnum>
230
 
      </citerefentry>,
231
 
      <citerefentry>
232
 
        <refentrytitle>shadow</refentrytitle><manvolnum>5</manvolnum>
233
 
      </citerefentry>,
234
 
      <citerefentry>
235
 
        <refentrytitle>usermod</refentrytitle><manvolnum>8</manvolnum>
236
 
      </citerefentry>.
237
 
    </para>
238
 
  </refsect1>
239
 
 
240
250
  <refsect1 id='exit_values'>
241
251
    <title>EXIT VALUES</title>
242
252
    <para>
287
297
      </variablelist>
288
298
    </para>
289
299
  </refsect1>
 
300
 
 
301
  <refsect1 id='see_also'>
 
302
    <title>SEE ALSO</title>
 
303
    <para>
 
304
      <citerefentry>
 
305
        <refentrytitle>group</refentrytitle><manvolnum>5</manvolnum>
 
306
      </citerefentry>,
 
307
      <citerefentry>
 
308
        <refentrytitle>grpck</refentrytitle><manvolnum>8</manvolnum>
 
309
      </citerefentry>,
 
310
      <citerefentry>
 
311
        <refentrytitle>passwd</refentrytitle><manvolnum>5</manvolnum>
 
312
      </citerefentry>,
 
313
      <citerefentry>
 
314
        <refentrytitle>shadow</refentrytitle><manvolnum>5</manvolnum>
 
315
      </citerefentry>,
 
316
      <citerefentry>
 
317
        <refentrytitle>usermod</refentrytitle><manvolnum>8</manvolnum>
 
318
      </citerefentry>.
 
319
    </para>
 
320
  </refsect1>
290
321
</refentry>