From nicolas@dauerreden.de  Fri Sep 20 08:02:33 2002
Return-Path: <nicolas@dauerreden.de>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 635DC37B401
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 20 Sep 2002 08:02:33 -0700 (PDT)
Received: from mailout11.sul.t-online.com (mailout11.sul.t-online.com [194.25.134.85])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 66B1443E65
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 20 Sep 2002 08:02:32 -0700 (PDT)
	(envelope-from nicolas@dauerreden.de)
Received: from fwd11.sul.t-online.de 
	by mailout11.sul.t-online.com with smtp 
	id 17sPIb-0003V1-03; Fri, 20 Sep 2002 17:02:29 +0200
Received: from pc5.abc (520067998749-0001@[217.233.97.240]) by fmrl11.sul.t-online.com
	with esmtp id 17sPIS-1cdto0C; Fri, 20 Sep 2002 17:02:20 +0200
Received: from pc5.abc (localhost.abc [127.0.0.1])
	by pc5.abc (8.12.3/8.12.3) with ESMTP id g8KF2JVX096321
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 20 Sep 2002 17:02:19 +0200 (CEST)
	(envelope-from nicolas@pc5.abc)
Received: (from nicolas@localhost)
	by pc5.abc (8.12.3/8.12.3/Submit) id g8KF2Jo2096320;
	Fri, 20 Sep 2002 17:02:19 +0200 (CEST)
Message-Id: <200209201502.g8KF2Jo2096320@pc5.abc>
Date: Fri, 20 Sep 2002 17:02:19 +0200 (CEST)
From: Nicolas Rachinsky <nicolas@dauerreden.de>
Reply-To: Nicolas Rachinsky <nicolas@dauerreden.de>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: man 5 passwd not correct
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         43112
>Category:       docs
>Synopsis:       man 5 passwd not correct
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Sep 20 08:10:02 PDT 2002
>Closed-Date:    Fri Sep 20 13:47:15 PDT 2002
>Last-Modified:  Fri Sep 20 13:47:15 PDT 2002
>Originator:     Nicolas Rachinsky
>Release:        FreeBSD 4.6.2-RELEASE i386
>Organization:
>Environment:
System: FreeBSD pc5.abc 4.6.2-RELEASE FreeBSD 4.6.2-RELEASE #2: Tue Aug 27 11:51:55 CEST 2002 root@:/usr/src/sys/compile/PC5 i386


	
>Description:

The man page for passwd(5) does not correctly describe the format
of /etc/passwd. There is no master.passwd(5).

>How-To-Repeat:
read "man 5 passwd" and compare it with the actual format of
/etc/passwd.

Try "man 5 master.passwd"

>Fix:


Index: Makefile
===================================================================
RCS file: /usr/cvs-freebsd/src/share/man/man5/Makefile,v
retrieving revision 1.27.2.7
diff -u -r1.27.2.7 Makefile
--- Makefile	2 Apr 2002 09:19:30 -0000	1.27.2.7
+++ Makefile	20 Sep 2002 10:34:18 -0000
@@ -15,5 +15,6 @@
 MLINKS+=hosts.equiv.5 rhosts.5
 MLINKS+=resolver.5 resolv.conf.5
 MLINKS+=utmp.5 lastlog.5 utmp.5 wtmp.5
+MLINKS+=passwd.5 master.passwd.5 
 
 .include <bsd.prog.mk>
Index: passwd.5
===================================================================
RCS file: /usr/cvs-freebsd/src/share/man/man5/passwd.5,v
retrieving revision 1.26.2.5
diff -u -r1.26.2.5 passwd.5
--- passwd.5	1 Feb 2002 15:51:18 -0000	1.26.2.5
+++ passwd.5	20 Sep 2002 14:57:42 -0000
@@ -36,13 +36,14 @@
 .Dt PASSWD 5
 .Os
 .Sh NAME
-.Nm passwd
-.Nd format of the password file
+.Nm passwd , 
+.Nm master.passwd
+.Nd format of the password files
 .Sh DESCRIPTION
 The
 .Nm
 files are files consisting of newline separated records, one per user,
-containing ten colon
+containing seven or ten colon
 .Pq Ql \&:
 separated fields.  These fields are as
 follows:
@@ -71,6 +72,14 @@
 .It shell
 User's login shell.
 .El
+.Pp
+The fields 
+.Ar class , 
+.Ar change
+and 
+.Ar expire
+are not present in the file
+.Pa /etc/passwd .
 .Pp
 Lines whose first non-whitespace character is a pound-sign (#)
 are comments, and are ignored.  Blank lines which consist

>Release-Note:
>Audit-Trail:

From: Ceri Davies <setantae@submonkey.net>
To: Nicolas Rachinsky <nicolas@dauerreden.de>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/43112: man 5 passwd not correct
Date: Fri, 20 Sep 2002 16:31:57 +0100

 If you intend making changes, then it may be worth pointing out that
 /etc/passwd is not a configuration file and that people should not edit
 it.
 
 Ceri
 
 -- 
 you can't see when light's so strong
 you can't see when light is gone

From: Nicolas Rachinsky <nicolas@dauerreden.de>
To: Ceri Davies <setantae@submonkey.net>,
	FreeBSD-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/43112: man 5 passwd not correct
Date: Fri, 20 Sep 2002 17:35:11 +0200

 * Ceri Davies <setantae@submonkey.net> [2002-09-20 16:31 +0100]:
 > If you intend making changes, then it may be worth pointing out that
 > /etc/passwd is not a configuration file and that people should not edit
 > it.
 
 You think something like the first paragraph below YP/NIS?
 
 Nicolas

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Nicolas Rachinsky <nicolas@dauerreden.de>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/43112: man 5 passwd not correct
Date: Fri, 20 Sep 2002 20:41:44 +0300

 This seems to be an almost perfect duplicate of PR docs/27915 :-(

From: Ceri Davies <setantae@submonkey.net>
To: Nicolas Rachinsky <nicolas@dauerreden.de>
Cc: freebsd-doc@FreeBSD.org
Subject: Re: docs/43112: man 5 passwd not correct
Date: Fri, 20 Sep 2002 19:17:26 +0100

 On Fri, Sep 20, 2002 at 08:40:14AM -0700, Nicolas Rachinsky wrote:
 
 >  > If you intend making changes, then it may be worth pointing out that
 >  > /etc/passwd is not a configuration file and that people should not edit
 >  > it.
 >  
 >  You think something like the first paragraph below YP/NIS?
 
 Something along those lines would be nice, yes.
 
 Ceri
 
 
 To Unsubscribe: send mail to majordomo@FreeBSD.org
 with "unsubscribe freebsd-doc" in the body of the message

From: Nicolas Rachinsky <nicolas@dauerreden.de>
To: Giorgos Keramidas <keramida@FreeBSD.org>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/43112: man 5 passwd not correct
Date: Fri, 20 Sep 2002 20:24:00 +0200

 * Giorgos Keramidas <keramida@FreeBSD.org> [2002-09-20 20:41 +0300]:
 > This seems to be an almost perfect duplicate of PR docs/27915 :-(
 
 Sorry, I missed this PR (and didn't look at the 5.0-current manpage).
 
 Please close this PR.
 
 Nicolas

From: swear@attbi.com (Gary W. Swearingen)
To: Nicolas Rachinsky <nicolas@dauerreden.de>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/43112: man 5 passwd not correct
Date: 20 Sep 2002 12:16:24 -0700

 Nicolas Rachinsky <nicolas@dauerreden.de> writes:
 
 >  .Os
 >  .Sh NAME
 > -.Nm passwd
 > -.Nd format of the password file
 > +.Nm passwd , 
 > +.Nm master.passwd
 > +.Nd format of the password files
 
 Maybe also add pwd.db and spwd.db, since the page sorta gives their
 formats too; and they could use a "home".
 
 The page needs an introduction, especially if it's going to document two
 or more files.  How about replacing the first paragraph with something
 like this:
 
     These "password files" contain information about user (AKA login)
     accounts (and some do not hold passwords!).  Normally, changes are
     made first to the master.passwd file and then a program uses that in
     generating the other files which contain only public information or
     are in faster-access format or both.  (This may be done with an
     editor and pwd_mkdb(8) or with one of several programs like vipw(8),
     pw(8), or yp(8) which change all of the files.)
 
     This manual entry documents the format of master.passwd text file
     and the use of it's data; passwd is the same except without the
     "class", "change", and "expire" fields.  The .db files contain the
     same data in db(3)-format.  The fields are as follows:
 
 (and not making the PR-proposed changes after the "Name" section.)
 
 This intro duplicates some information found later in the page, so that
 could be edited out, if you want to take the time.
 
 
 I think the page should make specific recommendations about the
 permissions of the files, instead of just hinting about it, but that's a
 different PR, I suppose.
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Fri Sep 20 13:46:07 PDT 2002 
State-Changed-Why:  
Closed at submitter's request. 
This is a duplicate of docs/27915. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=43112 
>Unformatted:
