Date: Fri, 3 Dec 2004 18:33:59 +0100 (CET) From: Jilles Tjoelker <jilles@stack.nl> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/74656: [PATCH] some improvements to man 5 passwd Message-ID: <20041203173359.00EB822822@snail.stack.nl> Resent-Message-ID: <200412031740.iB3HePYV035453@freefall.freebsd.org>
index | next in thread | raw e-mail
>Number: 74656
>Category: docs
>Synopsis: [PATCH] some improvements to man 5 passwd
>Confidential: no
>Severity: serious
>Priority: medium
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: change-request
>Submitter-Id: current-users
>Arrival-Date: Fri Dec 03 17:40:25 GMT 2004
>Closed-Date:
>Last-Modified:
>Originator: Jilles Tjoelker
>Release: FreeBSD 5.3-RELEASE i386
>Organization:
MCGV Stack
>Environment:
System: FreeBSD snail.stack.nl 5.3-RELEASE FreeBSD 5.3-RELEASE #3: Wed Nov 17 19:36:18 CET 2004 jilles@snail.stack.nl:/usr/obj/usr/src/sys/SNAIL i386
>Description:
- Note explicitly (again) that master.passwd and passwd should not be edited
manually
- Add reference to crypt(3) to description of "encrypted password"
- Add reference to pw(8) -- this method to change passwd and group did not
exist in 4.4BSD
- Remove "Class is currently not implemented" in COMPATIBILITY section
>How-To-Repeat:
man 5 passwd
>Fix:
patch included
--- passwd.5.patch begins here ---
--- src/share/man/man5/passwd.5.orig Thu Nov 11 21:28:50 2004
+++ src/share/man/man5/passwd.5 Fri Dec 3 18:27:36 2004
@@ -61,6 +61,9 @@
as controlled by
.Xr nsswitch.conf 5 .
.Pp
+To ensure consistency among the files, none of them should not be edited
+manually.
+.Pp
The
.Nm master.passwd
file is readable only by root, and consists of newline separated
@@ -126,7 +129,8 @@
.Pp
The password field is the
.Em encrypted
-form of the password.
+form of the password (see
+.Xr crypt 3 ) .
If the
.Ar password
field is empty, no password will be required to gain access to the
@@ -321,6 +325,7 @@
.Xr login.conf 5 ,
.Xr netgroup 5 ,
.Xr adduser 8 ,
+.Xr pw 8 ,
.Xr pwd_mkdb 8 ,
.Xr vipw 8 ,
.Xr yp 8
@@ -345,9 +350,8 @@
and
.Dq expire
are added, but are turned off by default.
-Class is currently not implemented, but change and expire are; to set them,
-use the current day in seconds from the epoch + whatever number of seconds
-of offset you want.
+To set them, use the current day in seconds from the epoch + whatever number
+of seconds of offset you want.
.Bd -literal -offset indent
BEGIN { FS = ":"}
{ print $1 ":" $2 ":" $3 ":" $4 "::0:0:" $5 ":" $6 ":" $7 }
--- passwd.5.patch ends here ---
>Release-Note:
>Audit-Trail:
>Unformatted:
help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20041203173359.00EB822822>