Subject: misc/31125: pwhash(1) not referenced in important manpages
To: None <,,>
From: None <>
List: netbsd-bugs
Date: 09/02/2005 17:18:01
>Number:         31125
>Category:       misc
>Synopsis:       pwhash(1) not referenced in important manpages
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Fri Sep 02 17:18:01 +0000 2005
>Originator:     Stefan Schumacher
>Release:        2.0.2 / 3.0_BETA
NetBSD 2.0.2 NetBSD 2.0.2 (WIELAND) #3: Sat Aug 27 19:15:03 CEST 2005 i386

Several man pages about "password issues" like passwd(5), passwd.conf(5), pwd_mkdb(8), vipw(8), useradd(8), chpass(1), crypt(3) don't refer to pwhash(1). 

This is bad, since useradd(8) requires a password to be an already encrypted hash and it's hard to find pwhash(1).
Read the specified man pages.
Add pwhash(1) to the "see also" section of regarding man pages 

and IMHO a short description of pwhash(1) should be added to the "-p" switch of man useradd, sth. like: 

"-p password   
specifies an already-encrypted password for the new user. Encrypted password hashes can be generated with pwhash(1). This password can then be changed by using the chpass(1) utility."