From owner-freebsd-doc Fri Sep 20 12:20: 5 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5B6E337B638 for ; Fri, 20 Sep 2002 12:20:04 -0700 (PDT) Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id DFC5C43E42 for ; Fri, 20 Sep 2002 12:20:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.6/8.12.6) with ESMTP id g8KJK3Co054280 for ; Fri, 20 Sep 2002 12:20:03 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.6/8.12.6/Submit) id g8KJK3gX054279; Fri, 20 Sep 2002 12:20:03 -0700 (PDT) Date: Fri, 20 Sep 2002 12:20:03 -0700 (PDT) Message-Id: <200209201920.g8KJK3gX054279@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org Cc: From: swear@attbi.com (Gary W. Swearingen) Subject: Re: docs/43112: man 5 passwd not correct Reply-To: swear@attbi.com (Gary W. Swearingen) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/43112; it has been noted by GNATS. From: swear@attbi.com (Gary W. Swearingen) To: Nicolas Rachinsky 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 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. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message