From owner-freebsd-doc Thu Apr 4 19:50: 9 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 3306437B41D for ; Thu, 4 Apr 2002 19:50:01 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g353o1D43079; Thu, 4 Apr 2002 19:50:01 -0800 (PST) (envelope-from gnats) Received: from horsey.gshapiro.net (horsey.gshapiro.net [209.220.147.178]) by hub.freebsd.org (Postfix) with ESMTP id 00ADD37B416 for ; Thu, 4 Apr 2002 19:44:58 -0800 (PST) Received: from horsey.gshapiro.net (gshapiro@localhost [127.0.0.1]) by horsey.gshapiro.net (8.12.3/8.12.3) with ESMTP id g353ivCD038206 (version=TLSv1/SSLv3 cipher=EDH-RSA-DES-CBC3-SHA bits=168 verify=NO) for ; Thu, 4 Apr 2002 19:44:57 -0800 (PST) Received: (from gshapiro@localhost) by horsey.gshapiro.net (8.12.3/8.12.3/Submit) id g353ivXL038205; Thu, 4 Apr 2002 19:44:57 -0800 (PST) Message-Id: <200204050344.g353ivXL038205@horsey.gshapiro.net> Date: Thu, 4 Apr 2002 19:44:57 -0800 (PST) From: Gregory Neil Shapiro To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/36773: Unclear/inconsistent instructions in Handbook section 19.4.3 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 >Number: 36773 >Category: docs >Synopsis: Unclear/inconsistent instructions in Handbook section 19.4.3 >Confidential: no >Severity: serious >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu Apr 04 19:50:01 PST 2002 >Closed-Date: >Last-Modified: >Originator: Gregory Neil Shapiro >Release: FreeBSD 4.5-STABLE i386 >Organization: >Environment: System: FreeBSD horsey.gshapiro.net 4.5-STABLE FreeBSD 4.5-STABLE #6: Fri Mar 1 21:45:03 PST 2002 gshapiro@horsey.gshapiro.net:/src/FreeBSD/RELENG_4/obj/src/sys/HORSEY i386 >Description: Here are excerpts and my commentary (indented) on section 19.4.3 of the handbook: 19.4.3 Update /etc/group : The title of the section is "Update /etc/group". However, the : section describes the need for certain usernames and groups to : exist for a make world to succeed. The title of the section is : misleading as it only mentions the group file. There have been occasions when the installation part of ``make world'' has expected certain usernames or groups to exist. When performing an upgrade it is likely that these groups did not exist. This caused problems when upgrading. : Not only ``make world'', but also ``make installworld'' : The first sentence says "usernames or groups". The second sentence : only mentions "groups". Missing usernames cause just as many : problems as missing groups. The most recent example of this is when the ``ppp'' group (later renamed ``network'') was added. Users had the installation process fail for them when parts of the ppp subsystem were installed using a non-existent (for them) group name. : The new most recent example is the ``smmsp'' username : and group, both of which are needed for mtree to create : /var/spool/clientmqueue/. The solution is to examine /usr/src/etc/group and compare its list of groups with your own. If there are any groups in the new file that are not in your file then copy them over. Similarly, you should rename any groups in /etc/group which have the same GID but a different name to those in /usr/src/etc/group. : You should also document merging /usr/src/etc/master.passwd using : vipw (so the database files are regenerated properly after the : users manually merge the new accounts). >How-To-Repeat: >Fix: See commentary above. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message