os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- Change the title of the /etc/group section. This talks about more

Browse source 
than just /etc/group.
- Update the example of a missing user/group that caused breakage
  during builds, to mention the recent smmsp troubles.
- Add a note (by Martin Heinen) that mentions mergemaster's -p option
  for prebuildworld merges of files in /etc.

PR:		docs/36773
Submitted by:	gshapiro, Martin Heinen <martin@sumuk.de>
This commit is contained in:
Giorgos Keramidas 2002-05-12 00:51:24 +00:00
parent c6eba1369b
commit 432cca737d
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=13043
1 changed files with 19 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

26
en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml
View file

@ -683,7 +683,7 @@ subscribe cvs-all</programlisting>
</sect2>
<sect2>
<title>Update <filename>/etc/group</filename></title>
<title>Update the files of <filename>/etc</filename></title>
<para>The <filename>/etc</filename> directory contains a large part
of your system's configuration information, as well as scripts
@ -697,13 +697,13 @@ subscribe cvs-all</programlisting>
<para>There have been occasions when the installation part of
<quote>make world</quote> 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.</para>
users or groups did not exist. This caused problems when upgrading.</para>
<para>The most recent example of this is when the <quote/ppp/ group
(later renamed <quote/network/) was added. Users had the
installation process fail for them when parts of the
<filename>ppp</filename> subsystem were installed using a
non-existent (for them) group name.</para>
<para>A recent example of this is when the
<username>smmsp</username> user was added. Users had the
installation process fail for them when
<command>mtree</command> was trying to create
<filename>/var/spool/clientmqueue</filename>.</para>
<para>The solution is to examine
<filename>/usr/src/etc/group</filename> and compare its list of
@ -713,6 +713,18 @@ subscribe cvs-all</programlisting>
the same GID but a different name to those in
<filename>/usr/src/etc/group</filename>.</para>
<para>Since 4.6-RELEASE you can run &man.mergemaster.8; in
pre-buildworld mode by providing the <option>-p</option> option.
This will compare only those files that are essential for the success
of <maketarget>buildworld</maketarget> or
<maketarget>installworld</maketarget>. If your old version of
<command>mergemaster</command> does not support <option>-p</option>,
use the new version in the source tree when running for the first
time:</para>
<screen>&prompt.root; <userinput>cd /usr/src/usr.sbin/mergemaster</userinput>
&prompt.root; <userinput>./mergemaster.sh -p</userinput></screen>
<tip>
<para>If you are feeling particularly paranoid, you can check your
system to see which files are owned by the group you are