[ViewVC] Annotation of: src/trunk/UPDATING

Updating Information for MidnightBSD users

Items affecting the mports and packages system can be found in
/usr/mports/UPDATING. 

20070814:
        Removed GNU tar source.  We've been using BSD tar 
        for awhile.

20070806:
        Finished removing umapfs and autofs from the tree.

20070804:
        BIND and Tcpdump have been patched for recent vulnerabilities.

        We switched to BSD cpio (pax).

20070719:
        Imported cpdup from DragonFly as /bin/cpdup

20070716:
        Update GNU cpio to 2.8. 

20070410:
        cvs was updated to 1.12.13.  cvsbug was removed.
        cvs now behaves similarly to DragonFly's cvs with
        most of their local changes.  

20070409:
        RELENG_0_1 was created. More aggresive changes will
        continue here.

20070406:
        Back out propolice.  propolice caused several problems
        with our threading libraries libthr and libpthread.  
        curthread was often NULL after the patch and many
        multithreaded applications would crash.  We plan to 
        work on either bringing in gcc 4.1 or developing a new
        patch which also corrects our threading issues later.

        It is more important to have a stable system for our
        mport work and other projects at this time.

        This is not a clean removal.  It is recommended that you
        have a recently SNAP CD handy.  You can either reinstall
        or perform a make buildworld and make buildkernel and 
        make installkernel.  Reboot on the cd and copy the contents
        of /bin, /sbin, /lib, /libexec, and /usr/bin, /usr/sbin,
        /usr/lib, and /usr/libexec to the respective directories on
        your disk.  Then you should be able to boot into single user
        mode and run make installworld.  You will need to run
        chflags noschg on some of the files if you can't overwrite
        them. 

        You will get __guard missing errors since we had to remove
        this from libc.

        You will need to rebuild any ports built while propolice was
        installed.

20070401:
        Importing propolice into MidnightBSD. Propolice is going to
        provide us with much greater security and stability in the
        long run. If upgrading from a pre-propolice system, please
        follow the these instructions:

        cd /usr/src/lib/libc && make obj && make && make install
        cd /usr/src/gnu/usr.bin/cc && make obj && make && make install
        cd /usr/src/lib/libpthread && make obj && make && make install
        cd /usr/src/lib/libthr && make obj && make && make install
        buildworld and kernel

        It is adviced that any mports which were installed and/or built
        prior to the propolice update also be updated. If any errors
        or issue are encounted, please contact security@midnightbsd.org
        and we will be sure to investigate and come up with an expeditious
        fix.

20070314:
        Remove send-pr from src.

        Switch to NetBSD's gzip.

        Bump MBSD minor revision.

20070313:
        Imported OpenSSH 4.6p1.

        Imported FreeBSD's libarchive and updated tar to work with it.

        Disabled debug statements cluttering up /var/log/messages for
        the tcp autobuf patch applied previously.

20070312:
        Synced several audio changes from FreeBSD 6.1. Removed the 
        BSD Daemon files from src/share.  

20070308:
        Added mfi which supports LSI Logic MegaRAID SAS devices including
        the Dell perc5i.

20070206:
        Imported OpenBSD's sudo into source. Please install
        /usr/src/usr.bin/sudo/lib first before building.

        Those who install from a snapshot after this date
        will not be effected.

20070119:
        Added audit group.  Be sure to add audit to your /etc/group file
        before installing world.

        hostapd was updated to 0.4.8.

        An accidental commit in usr.sbin/bluetooth/hccontrol was fixed to
        unbreak world.

        wpa_supplicant was updated.

        For stability and compatibility reasons, it was decided that MidnightBSD
        sync with FreeBSD 6.1 Release.  Nearly every change between the original
        fork date of February 24, 2006 and the release of FreeBSD 6.1 in May
        2006 will be merged.  Beyond this, MidnightBSD will be a "real" fork and
        will not sync every little change with FreeBSD.

20061231:
        Updated COPYRIGHT for 2007.

        Updated and bumped libutil after importing NetBSD efun(3) functions.

        Added MidnightBSD_version and bumped the FreeBSD version as we've
        synced all commits between the fork and that version.  It is now safe
        to assume MidnightBSD is compatible with FreeBSD RELENG_6 from
        Feb 26, 2006.

        Added spell(1) and deroff(1) from NetBSD.  Also added additional
        dict files to work with it. /usr/share/dict/american, 
        /usr/share/dict/british and /usr/share/dict/special/math

        Numerous man page and bug fixes.

20061226:
        Setup /usr/share/examples/cvsup SUPfiles for the new
        MidnightBSD CVSup server. 

        Fix a bug in burncd where it would continue forever while
        erasing CDRW media.

        Add csup to /usr/bin.  csup is a CVSup replacement written
        in C. 

        Fixed a bug with bsnmpd build from Oct 30.  

        Corrected some race conditions and fixed a few bugs in
        geom.  Imported changes from FreeBSD RELENG_6.

20061225:
        Fixed a typo in src/lib/libc/sparc64/fpu/fpu_implode.c
        that caused long double to long and long long 
        conversion of negative numbers to always result in -1.

20061221:
        Fixed acpi_battery.c to not report an ERROR if no
        batteries are present.

        Performed some minor updates on the RL and RE NIC drivers.
        RL should no longer panic when trying to print errors.

        Corrected a bug with TTY.

20061218:
        Corrected a bug with libpthread where newly created suspended
        threads don't get scheduled.

20061206:
        Fixed a typo with the firewire security patch.

20061129:
        Minor cleanups to utilities in bin.

        Fixed msdos file system short file name behavior to match
        FreeBSD.

20061031:
        Updated man pages in section 7.

20061030:
        Updated sys/dev/drm to support intel 915 and radeon 
        r300 cards properly.  

        Synced snmpd with FreeBSD-stable.

        Fixed a bug in rm which could cause data loss.  

20061027:
        Added Intel ICH8 and nForce 5 support to ATA. cam, mpt,
        random, kbdmux, atkbd, and usb were updated.  Changes
        to clearing registers on SSE enabled processors (i386)
        commited.  

        lukemftpd updated.  

        openssh rc script was altered which effects initial
        seeding.  

20061014:
        Workaround for em driver problem on shared IRQ.

        Started removal of alpha support.

20061013:
        ATA driver was updated.  USB/USB1/USB2 types added.

20061010: 
        OpenSSH was updated to 4.4p1.   

20060909:
        OpenNTPD was added to MidnightBSD.  Run make delete-old to remove
        the old ntpd daemon.

        cat has a new option -D which allows you to timestamp output
        on a per line basis.

        The kernel has a keyboard mux which allows you to have multiple
        keyboard connected simultaneously.  USB keyboard support was also
        improved with this patch.

        The Intel em driver was updated.  Network performance was greatly
        increased on many systems.  Additional models are supported.

        The ATA driver was patched to fix a potential deadlock.

        Bind was patched to fix a potential denial of service condition.

20060817:
        ksh has been added to the base system.  If you previously had
        the port installed, it will be overwritten on the next buildworld.


        To build a kernel
        -----------------
        If you are updating from a prior version of MidnightBSD (even one just
        a few days old), you should follow this procedure. With a
        /usr/obj tree with a fresh buildworld,
        make -DALWAYS_CHECK_MAKE buildkernel KERNCONF=YOUR_KERNEL_HERE
        make -DALWAYS_CHECK_MAKE installkernel KERNCONF=YOUR_KERNEL_HERE

        To test a kernel once
        ---------------------
        If you just want to boot a kernel once (because you are not sure
        if it works, or if you want to boot a known bad kernel to provide
        debugging information) run
        make installkernel KERNCONF=YOUR_KERNEL_HERE KODIR=/boot/testkernel
        nextboot -k testkernel

        To just build a kernel when you know that it won't mess you up
        --------------------------------------------------------------
        This assumes you are already running a 6.X system.  Replace
        ${arch} with the architecture of your machine (e.g. "i386",
        "amd64", "ia64", "pc98", "sparc64", etc).

        cd src/sys/${arch}/conf
        config KERNEL_NAME_HERE
        cd ../compile/KERNEL_NAME_HERE
        make depend
        make
        make install

        If this fails, go to the "To build a kernel" section.

        To rebuild everything and install it on the current system.
        -----------------------------------------------------------
        # Note: sometimes if you are running current you gotta do more than
        # is listed here if you are upgrading from a really old current.

        <make sure you have good level 0 dumps>
        make buildworld
        make kernel KERNCONF=YOUR_KERNEL_HERE
                                                        [1]
        <reboot in single user>                         [3]
        mergemaster -p                                  [5]
        make installworld
        make delete-old
        mergemaster                                     [4]
        <reboot>


        To cross-install current onto a separate partition
        --------------------------------------------------
        # In this approach we use a separate partition to hold
        # current's root, 'usr', and 'var' directories.   A partition
        # holding "/", "/usr" and "/var" should be about 2GB in
        # size.

        <make sure you have good level 0 dumps>
        <boot into -stable>
        make buildworld
        make buildkernel KERNCONF=YOUR_KERNEL_HERE
        <maybe newfs current's root partition>
        <mount current's root partition on directory ${CURRENT_ROOT}>
        make installworld DESTDIR=${CURRENT_ROOT}
        cd src/etc; make distribution DESTDIR=${CURRENT_ROOT} # if newfs'd
        make installkernel KERNCONF=YOUR_KERNEL_HERE DESTDIR=${CURRENT_ROOT}
        cp /etc/fstab ${CURRENT_ROOT}/etc/fstab                    # if newfs'd
        <edit ${CURRENT_ROOT}/etc/fstab to mount "/" from the correct partition>
        <reboot into current>
        <do a "native" rebuild/install as described in the previous section>
        <maybe install compatibility libraries from src/lib/compat>
        <reboot>


        To upgrade in-place from 5.x-stable or higher to 6.x-stable
        -----------------------------------------------------------
        <make sure you have good level 0 dumps>
        make buildworld                                 [9]
        make kernel KERNCONF=YOUR_KERNEL_HERE           [8]
                                                        [1]
        <reboot in single user>                         [3]
        mergemaster -p                                  [5]
        make installworld
        make delete-old
        mergemaster -i                                  [4]
        <reboot>

        Make sure that you've read the UPDATING file to understand the
        tweaks to various things you need.  At this point in the life
        cycle of current, things change often and you are on your own
        to cope.  The defaults can also change, so please read ALL of
        the UPDATING entries.

        Also, if you are tracking -current, you must be subscribed to
        freebsd-current@freebsd.org.  Make sure that before you update
        your sources that you have read and understood all the recent
        messages there.  If in doubt, please track -stable which has
        much fewer pitfalls.

        [1] If you have third party modules, such as vmware, you
        should disable them at this point so they don't crash your
        system on reboot.

        [3] From the bootblocks, boot -s, and then do
                fsck -p
                mount -u /
                mount -a
                cd src
                adjkerntz -i            # if CMOS is wall time
        Also, when doing a major release upgrade, it is required that
        you boot into single user mode to do the installworld.

        [4] Note: This step is non-optional.  Failure to do this step
        can result in a significant reduction in the functionality of the
        system.  Attempting to do it by hand is not recommended and those
        that pursue this avenue should read this file carefully, as well
        as the archives of freebsd-current and freebsd-hackers mailing lists
        for potential gotchas.

        [5] Usually this step is a noop.  However, from time to time
        you may need to do this if you get unknown user in the following
        step.  It never hurts to do it all the time.

        [8] In order to have a kernel that can run the 5.x binaries
        needed to do an installworld, you must include the COMPAT_FREEBSD5
        option in your kernel.  Failure to do so may leave you with a system
        that is hard to boot to recover. A similar kernel option COMPAT_FREEBSD5
        is required to run the 5.x binaries on more recent kernels.

        Make sure that you merge any new devices from GENERIC since the
        last time you updated your kernel config file.

        [9] When checking out sources, you must include the -P flag to have
        cvs prune empty directories.

        If CPUTYPE is defined in your /etc/make.conf, make sure to use the
        "?=" instead of the "=" assignment operator, so that buildworld can
        override the CPUTYPE if it needs to.

        MAKEOBJDIRPREFIX must be defined in an environment variable, and
        not on the command line, or in /etc/make.conf.  buildworld will
        warn if it is improperly defined.

Copyright information:

Copyright 1998-2005 M. Warner Losh.  All Rights Reserved.

Redistribution, publication, translation and use, with or without
modification, in full or in part, in any form or format of this
document are permitted without further permission from the author.

THIS DOCUMENT IS PROVIDED BY WARNER LOSH ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED.  IN NO EVENT SHALL WARNER LOSH BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.

If you find this document useful, and you want to, you may buy the
author a beer.

Contact Warner Losh if you have any questions about your use of
this document.

$FreeBSD: src/UPDATING,v 1.416.2.18 2006/02/22 11:51:57 yar Exp $
$MidnightBSD: src/UPDATING,v 1.24 2007/08/06 04:45:21 laffer1 Exp $
Revision:	1192
Committed:	Tue Aug 14 04:28:13 2007 UTC (16 years, 9 months ago) by laffer1
File size:	13558 byte(s)
Log Message:	GNU tar be gone
#	User	Rev	Content
1	laffer1	169	Updating Information for MidnightBSD users
2	laffer1	2
3	laffer1	273	Items affecting the mports and packages system can be found in
4			/usr/mports/UPDATING.
5	laffer1	2
6	laffer1	1192	20070814:
7			Removed GNU tar source. We've been using BSD tar
8			for awhile.
9
10	laffer1	1143	20070806:
11			Finished removing umapfs and autofs from the tree.
12
13			20070804:
14			BIND and Tcpdump have been patched for recent vulnerabilities.
15
16			We switched to BSD cpio (pax).
17
18	laffer1	1060	20070719:
19			Imported cpdup from DragonFly as /bin/cpdup
20
21	laffer1	1055	20070716:
22			Update GNU cpio to 2.8.
23
24	laffer1	939	20070410:
25			cvs was updated to 1.12.13. cvsbug was removed.
26			cvs now behaves similarly to DragonFly's cvs with
27			most of their local changes.
28
29			20070409:
30			RELENG_0_1 was created. More aggresive changes will
31			continue here.
32
33	laffer1	906	20070406:
34			Back out propolice. propolice caused several problems
35			with our threading libraries libthr and libpthread.
36			curthread was often NULL after the patch and many
37			multithreaded applications would crash. We plan to
38			work on either bringing in gcc 4.1 or developing a new
39			patch which also corrects our threading issues later.
40
41			It is more important to have a stable system for our
42			mport work and other projects at this time.
43
44	laffer1	907	This is not a clean removal. It is recommended that you
45			have a recently SNAP CD handy. You can either reinstall
46			or perform a make buildworld and make buildkernel and
47			make installkernel. Reboot on the cd and copy the contents
48			of /bin, /sbin, /lib, /libexec, and /usr/bin, /usr/sbin,
49			/usr/lib, and /usr/libexec to the respective directories on
50			your disk. Then you should be able to boot into single user
51			mode and run make installworld. You will need to run
52			chflags noschg on some of the files if you can't overwrite
53			them.
54
55			You will get __guard missing errors since we had to remove
56			this from libc.
57
58			You will need to rebuild any ports built while propolice was
59			installed.
60
61	archite	886	20070401:
62			Importing propolice into MidnightBSD. Propolice is going to
63			provide us with much greater security and stability in the
64			long run. If upgrading from a pre-propolice system, please
65			follow the these instructions:
66
67			cd /usr/src/lib/libc && make obj && make && make install
68			cd /usr/src/gnu/usr.bin/cc && make obj && make && make install
69	laffer1	893	cd /usr/src/lib/libpthread && make obj && make && make install
70			cd /usr/src/lib/libthr && make obj && make && make install
71	archite	886	buildworld and kernel
72
73			It is adviced that any mports which were installed and/or built
74			prior to the propolice update also be updated. If any errors
75			or issue are encounted, please contact security@midnightbsd.org
76			and we will be sure to investigate and come up with an expeditious
77			fix.
78
79	laffer1	842	20070314:
80			Remove send-pr from src.
81
82			Switch to NetBSD's gzip.
83
84			Bump MBSD minor revision.
85
86	laffer1	832	20070313:
87			Imported OpenSSH 4.6p1.
88
89			Imported FreeBSD's libarchive and updated tar to work with it.
90
91			Disabled debug statements cluttering up /var/log/messages for
92			the tcp autobuf patch applied previously.
93
94	laffer1	807	20070312:
95			Synced several audio changes from FreeBSD 6.1. Removed the
96			BSD Daemon files from src/share.
97
98	laffer1	775	20070308:
99			Added mfi which supports LSI Logic MegaRAID SAS devices including
100			the Dell perc5i.
101
102	archite	726	20070206:
103			Imported OpenBSD's sudo into source. Please install
104			/usr/src/usr.bin/sudo/lib first before building.
105
106			Those who install from a snapshot after this date
107			will not be effected.
108
109	laffer1	708	20070119:
110			Added audit group. Be sure to add audit to your /etc/group file
111			before installing world.
112
113			hostapd was updated to 0.4.8.
114
115			An accidental commit in usr.sbin/bluetooth/hccontrol was fixed to
116			unbreak world.
117
118			wpa_supplicant was updated.
119
120	laffer1	775	For stability and compatibility reasons, it was decided that MidnightBSD
121			sync with FreeBSD 6.1 Release. Nearly every change between the original
122			fork date of February 24, 2006 and the release of FreeBSD 6.1 in May
123			2006 will be merged. Beyond this, MidnightBSD will be a "real" fork and
124			will not sync every little change with FreeBSD.
125	laffer1	708
126	laffer1	477	20061231:
127			Updated COPYRIGHT for 2007.
128
129			Updated and bumped libutil after importing NetBSD efun(3) functions.
130
131			Added MidnightBSD_version and bumped the FreeBSD version as we've
132			synced all commits between the fork and that version. It is now safe
133			to assume MidnightBSD is compatible with FreeBSD RELENG_6 from
134			Feb 26, 2006.
135
136			Added spell(1) and deroff(1) from NetBSD. Also added additional
137			dict files to work with it. /usr/share/dict/american,
138			/usr/share/dict/british and /usr/share/dict/special/math
139
140			Numerous man page and bug fixes.
141
142	laffer1	352	20061226:
143			Setup /usr/share/examples/cvsup SUPfiles for the new
144	laffer1	376	MidnightBSD CVSup server.
145	laffer1	352
146	laffer1	376	Fix a bug in burncd where it would continue forever while
147			erasing CDRW media.
148
149			Add csup to /usr/bin. csup is a CVSup replacement written
150			in C.
151
152			Fixed a bug with bsnmpd build from Oct 30.
153
154			Corrected some race conditions and fixed a few bugs in
155			geom. Imported changes from FreeBSD RELENG_6.
156
157	laffer1	352	20061225:
158			Fixed a typo in src/lib/libc/sparc64/fpu/fpu_implode.c
159			that caused long double to long and long long
160			conversion of negative numbers to always result in -1.
161
162			20061221:
163			Fixed acpi_battery.c to not report an ERROR if no
164			batteries are present.
165
166			Performed some minor updates on the RL and RE NIC drivers.
167			RL should no longer panic when trying to print errors.
168
169			Corrected a bug with TTY.
170
171			20061218:
172			Corrected a bug with libpthread where newly created suspended
173			threads don't get scheduled.
174
175			20061206:
176			Fixed a typo with the firewire security patch.
177
178			20061129:
179			Minor cleanups to utilities in bin.
180
181			Fixed msdos file system short file name behavior to match
182			FreeBSD.
183
184	laffer1	325	20061031:
185			Updated man pages in section 7.
186
187			20061030:
188			Updated sys/dev/drm to support intel 915 and radeon
189			r300 cards properly.
190
191			Synced snmpd with FreeBSD-stable.
192
193			Fixed a bug in rm which could cause data loss.
194
195	laffer1	305	20061027:
196			Added Intel ICH8 and nForce 5 support to ATA. cam, mpt,
197			random, kbdmux, atkbd, and usb were updated. Changes
198			to clearing registers on SSE enabled processors (i386)
199			commited.
200
201			lukemftpd updated.
202
203			openssh rc script was altered which effects initial
204			seeding.
205
206	laffer1	273	20061014:
207			Workaround for em driver problem on shared IRQ.
208
209			Started removal of alpha support.
210
211			20061013:
212			ATA driver was updated. USB/USB1/USB2 types added.
213
214			20061010:
215	laffer1	305	OpenSSH was updated to 4.4p1.
216	laffer1	273
217	laffer1	169	20060909:
218			OpenNTPD was added to MidnightBSD. Run make delete-old to remove
219			the old ntpd daemon.
220	laffer1	63
221	laffer1	169	cat has a new option -D which allows you to timestamp output
222			on a per line basis.
223	laffer1	5
224	laffer1	169	The kernel has a keyboard mux which allows you to have multiple
225			keyboard connected simultaneously. USB keyboard support was also
226			improved with this patch.
227	laffer1	5
228	laffer1	169	The Intel em driver was updated. Network performance was greatly
229			increased on many systems. Additional models are supported.
230	laffer1	5
231	laffer1	169	The ATA driver was patched to fix a potential deadlock.
232	laffer1	5
233	laffer1	169	Bind was patched to fix a potential denial of service condition.
234	laffer1	5
235	laffer1	169	20060817:
236			ksh has been added to the base system. If you previously had
237			the port installed, it will be overwritten on the next buildworld.
238	laffer1	5
239
240
241	laffer1	2	To build a kernel
242			-----------------
243	laffer1	169	If you are updating from a prior version of MidnightBSD (even one just
244	laffer1	2	a few days old), you should follow this procedure. With a
245			/usr/obj tree with a fresh buildworld,
246			make -DALWAYS_CHECK_MAKE buildkernel KERNCONF=YOUR_KERNEL_HERE
247			make -DALWAYS_CHECK_MAKE installkernel KERNCONF=YOUR_KERNEL_HERE
248
249			To test a kernel once
250			---------------------
251			If you just want to boot a kernel once (because you are not sure
252			if it works, or if you want to boot a known bad kernel to provide
253			debugging information) run
254			make installkernel KERNCONF=YOUR_KERNEL_HERE KODIR=/boot/testkernel
255			nextboot -k testkernel
256
257			To just build a kernel when you know that it won't mess you up
258			--------------------------------------------------------------
259			This assumes you are already running a 6.X system. Replace
260			${arch} with the architecture of your machine (e.g. "i386",
261	laffer1	273	"amd64", "ia64", "pc98", "sparc64", etc).
262	laffer1	2
263			cd src/sys/${arch}/conf
264			config KERNEL_NAME_HERE
265			cd ../compile/KERNEL_NAME_HERE
266			make depend
267			make
268			make install
269
270			If this fails, go to the "To build a kernel" section.
271
272			To rebuild everything and install it on the current system.
273			-----------------------------------------------------------
274			# Note: sometimes if you are running current you gotta do more than
275			# is listed here if you are upgrading from a really old current.
276
277			<make sure you have good level 0 dumps>
278			make buildworld
279			make kernel KERNCONF=YOUR_KERNEL_HERE
280			[1]
281			<reboot in single user> [3]
282			mergemaster -p [5]
283			make installworld
284	laffer1	5	make delete-old
285	laffer1	2	mergemaster [4]
286			<reboot>
287
288
289			To cross-install current onto a separate partition
290			--------------------------------------------------
291			# In this approach we use a separate partition to hold
292			# current's root, 'usr', and 'var' directories. A partition
293			# holding "/", "/usr" and "/var" should be about 2GB in
294			# size.
295
296			<make sure you have good level 0 dumps>
297			<boot into -stable>
298			make buildworld
299			make buildkernel KERNCONF=YOUR_KERNEL_HERE
300			<maybe newfs current's root partition>
301			<mount current's root partition on directory ${CURRENT_ROOT}>
302			make installworld DESTDIR=${CURRENT_ROOT}
303			cd src/etc; make distribution DESTDIR=${CURRENT_ROOT} # if newfs'd
304			make installkernel KERNCONF=YOUR_KERNEL_HERE DESTDIR=${CURRENT_ROOT}
305			cp /etc/fstab ${CURRENT_ROOT}/etc/fstab # if newfs'd
306			<edit ${CURRENT_ROOT}/etc/fstab to mount "/" from the correct partition>
307			<reboot into current>
308			<do a "native" rebuild/install as described in the previous section>
309			<maybe install compatibility libraries from src/lib/compat>
310			<reboot>
311
312
313			To upgrade in-place from 5.x-stable or higher to 6.x-stable
314			-----------------------------------------------------------
315			<make sure you have good level 0 dumps>
316			make buildworld [9]
317			make kernel KERNCONF=YOUR_KERNEL_HERE [8]
318			[1]
319			<reboot in single user> [3]
320			mergemaster -p [5]
321			make installworld
322	laffer1	5	make delete-old
323	laffer1	2	mergemaster -i [4]
324			<reboot>
325
326			Make sure that you've read the UPDATING file to understand the
327			tweaks to various things you need. At this point in the life
328			cycle of current, things change often and you are on your own
329			to cope. The defaults can also change, so please read ALL of
330			the UPDATING entries.
331
332			Also, if you are tracking -current, you must be subscribed to
333			freebsd-current@freebsd.org. Make sure that before you update
334			your sources that you have read and understood all the recent
335			messages there. If in doubt, please track -stable which has
336			much fewer pitfalls.
337
338			[1] If you have third party modules, such as vmware, you
339			should disable them at this point so they don't crash your
340			system on reboot.
341
342			[3] From the bootblocks, boot -s, and then do
343			fsck -p
344			mount -u /
345			mount -a
346			cd src
347			adjkerntz -i # if CMOS is wall time
348			Also, when doing a major release upgrade, it is required that
349			you boot into single user mode to do the installworld.
350
351			[4] Note: This step is non-optional. Failure to do this step
352			can result in a significant reduction in the functionality of the
353			system. Attempting to do it by hand is not recommended and those
354			that pursue this avenue should read this file carefully, as well
355			as the archives of freebsd-current and freebsd-hackers mailing lists
356			for potential gotchas.
357
358			[5] Usually this step is a noop. However, from time to time
359			you may need to do this if you get unknown user in the following
360			step. It never hurts to do it all the time.
361
362			[8] In order to have a kernel that can run the 5.x binaries
363			needed to do an installworld, you must include the COMPAT_FREEBSD5
364			option in your kernel. Failure to do so may leave you with a system
365			that is hard to boot to recover. A similar kernel option COMPAT_FREEBSD5
366			is required to run the 5.x binaries on more recent kernels.
367
368			Make sure that you merge any new devices from GENERIC since the
369			last time you updated your kernel config file.
370
371			[9] When checking out sources, you must include the -P flag to have
372			cvs prune empty directories.
373
374			If CPUTYPE is defined in your /etc/make.conf, make sure to use the
375			"?=" instead of the "=" assignment operator, so that buildworld can
376			override the CPUTYPE if it needs to.
377
378			MAKEOBJDIRPREFIX must be defined in an environment variable, and
379			not on the command line, or in /etc/make.conf. buildworld will
380			warn if it is improperly defined.
381
382			Copyright information:
383
384			Copyright 1998-2005 M. Warner Losh. All Rights Reserved.
385
386			Redistribution, publication, translation and use, with or without
387			modification, in full or in part, in any form or format of this
388			document are permitted without further permission from the author.
389
390			THIS DOCUMENT IS PROVIDED BY WARNER LOSH ``AS IS'' AND ANY EXPRESS OR
391			IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
392			WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
393			DISCLAIMED. IN NO EVENT SHALL WARNER LOSH BE LIABLE FOR ANY DIRECT,
394			INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
395			(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
396			SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
397			HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
398			STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
399			IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
400			POSSIBILITY OF SUCH DAMAGE.
401
402			If you find this document useful, and you want to, you may buy the
403			author a beer.
404
405			Contact Warner Losh if you have any questions about your use of
406			this document.
407
408	laffer1	5	$FreeBSD: src/UPDATING,v 1.416.2.18 2006/02/22 11:51:57 yar Exp $
409	laffer1	1192	$MidnightBSD: src/UPDATING,v 1.24 2007/08/06 04:45:21 laffer1 Exp $