[Pkg-shadow-devel] Bug#328113: man page improvements for passwd.5

[Greg Wooledge]

Package: passwd
Version: 1:4.0.3-30
Severity: wishlist
Tags: patch


This probably needs to go upstream, but I'm not even sure who's in charge
of this documentation, if *anyone* at all is....  Nor am I sure who's in
charge of arranging the translations, etc.

-- System Information:
Debian Release: 3.1
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.4.31
Locale: LANG=en_US.ISO8859-1, LC_CTYPE=en_US.ISO8859-1 (charmap=ISO-8859-1)

Versions of packages passwd depends on:
ii  libc6                         2.3.5-6    GNU C Library: Shared libraries an
ii  libpam-modules                0.76-22    Pluggable Authentication Modules f
ii  libpam0g                      0.76-22    Pluggable Authentication Modules l
ii  login                         1:4.0.3-30 System login tools

passwd recommends no packages.

-- debconf information excluded
-------------- next part --------------
33,34c33,35
< contains various pieces of information for each user account.
< Included is
---
> contains one line for each user account, with seven fields delimited
> by colons (`:').
> These fields are
48c49
< User command interpreter
---
> Optional user command interpreter
50,58c51,61
< The password field may not be filled if shadow passwords
< have been enabled.
< If shadow passwords are being used, the encrypted password will
< be found in \fI/etc/shadow\fR.
< The encryped password consists of 13 characters from the
< 64 character alphabet
< a thru z, A thru Z, 0 thru 9, \. and /.
< Refer to \fBcrypt\fR(3) for details on how this string is
< interpreted.
---
> The encrypted password field may be blank, in which case no password is
> required to authenticate as the specified login name.
> (However, some applications which read the \fBpasswd\fR file may decide
> not to permit \fIany\fR access at all if the \fIpassword\fR field is
> blank.)
> If the \fIpassword\fR field is a lower-case `x', then the encrypted
> password is actually stored in the \fBshadow\fR(5) file instead; there
> \fBmust\fR be a corresponding line in the \fBshadow\fR file, or else
> the user account is invalid.
> If the \fIpassword\fR field is any other string, then it will be treated
> as an encrypted password, as specified by \fBcrypt\fR(3).
89c92
< \fBLogin\fR uses this information to set the value of
---
> The \fBlogin\fR(1) program uses this information to set the value of
95c98
< \fBLogin\fR uses this information to set the value of the
---
> The \fBlogin\fR(1) program uses this information to set the value of the
99a103,104
> .br
> /etc/shadow \- optional encrypted password file
103a109,110
> .BR getent (1),
> .BR getpwnam (3),