Bug#300268: [Pkg-shadow-devel] Bug#300268: /usr/share/man/man5/passwd.5.gz contains inaccurate information

[Tomasz Kłoczko]

  This message is in MIME format.  The first part should be readable text,
  while the remaining parts are likely unreadable without MIME-aware tools.

--568760595-1096432268-1111178609=:30561
Content-Type: TEXT/PLAIN; charset=ISO-8859-2
Content-Transfer-Encoding: QUOTED-PRINTABLE

On Fri, 18 Mar 2005, Mike Brodbelt wrote:

> Package: passwd
> Version: 1:4.0.3-31sarge1
> Severity: minor
>=20
>=20
> "man 5 passwd" produces documentation that is not entirely accurate. The
> second paragraph contains the following text:-
>=20
> "The encryped password consists of 13 characters
> from  the  64  character  alphabet a thru z, A thru Z, 0 thru 9,
> . and /.  Refer to crypt(3) for details on how this string is
> interpreted."
>=20
> This information is clearly incorrect when the system is set to use MD5
> passwords, which is increasingly the case. There's also a typo in
> "encrypted".

Thanks for report.
English isn't my native language so it will be good if someone will verify
below patch before I'll commit this to shadow CVS tree.

Any volunteers on update non-english passwd(5) ? (pl is mine :o)

$ ls -1 */passwd.5
cs/passwd.5
fr/passwd.5
it/passwd.5
ja/passwd.5
ko/passwd.5
pl/passwd.5
ru/passwd.5

--- passwd.5    11 Dec 2004 20:05:01 -0000      1.13
+++ passwd.5    18 Mar 2005 20:25:48 -0000
@@ -48,9 +48,13 @@
 .PP
 The password field may not be filled if shadow passwords have been enabled=
=2E
 If shadow passwords are being used, the encrypted password will be found i=
n
-\fI/etc/shadow\fR. The encrypted password consists of 13 characters from t=
he
-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.
+\fI/etc/shadow\fR. The encrypted password consists of characters from the
+64 character alphabet a thru z, A thru Z, 0 thru 9, \. and /. Optionaly it
+can start with "$" character. This mean encrypted password was generated
+using another (not DES) algorithm. For example if it start with "$1$" it m=
eans
+MD5-based algorithm was used.
+.PP
+Refer to \fBcrypt\fR(3) for details on how this string is interpreted.
 .PP
 The comment field is used by various system utilities, such as
 \fBfinger\fR(1). Three additional values may be present in the comment (EN=
D)


kloczek
--=20
-----------------------------------------------------------
*Ludzie nie maj=B1 problem=F3w, tylko sobie sami je stwarzaj=B1*
-----------------------------------------------------------
Tomasz K=B3oczko, sys adm @zie.pg.gda.pl|*e-mail: kloczek@rudy.mif.pg.gda.p=
l*
--568760595-1096432268-1111178609=:30561--