[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. 

20080322:
        The default umask was changed to 022.
        
        /usr/X11R6 paths were removed from several config files.

        .mkshrc files are now installed for root.

20080316:
        FIx a problem with gif0 tunnels and neighbors with IPV6.

20080312:
        Add lndir from X.org.  This aides in the porting of MirPorts.

        New OS versions were added to the mapage code (groff)

20080310:
        Correct a buffer overflow in ppp.

20080308:
        Remove /usr/X11R6 from manpath config.

20080307:
        Atheros driver no longer has several options set
        which corrects building in tinderbox on all three platforms.

        Added a new macro to sx.h which returns true if the current
        thread holds an exclusive lock on a specifix sx.

        Removed OS/2's HPFS file system.   It's not maintained and
        I don't know anyone using OS/2 or ecomstation these days.
        My copy is in the closet collecting dust.

20080306:
        Synced tinderbox with FreeBSD.  Modified it for MidnightBSD.
        Developers can now use it to check src builds.

20080303:
        Add mksh to /etc/shells, made some adjustments to options
        for mksh builds per suggestion upstream.

        USB HID table updated with modern hardware list.

        Updated BSD family true (we're not in there yet)

        iso3166 file updated and import of tzdata2007k for 
        new time zones.

        Updated mksh to latest version R33.

20080228:
        Remplaced the random IP id generation code with a new
        version by Amit Klein.

20080221:
        Sendfile write only permissions fix.

        Removed some HPFS and PC98 code.

        iso639 file sycned with DragonFly.

20080128:
        Changed NTP configuration so that ips aren't cached
        so multiple servers are used.

        Fix an issue with fork() in libpthread.

20080121:
        Add virtualization detection to set the HZ rate
        according to a VM present.  VMWare and Parallels
        should work better like this.

        Change to full x11 install in sysinstall.  Add
        xorg 7 support.

20080115:
        Fix the handling of PTY's.  CVE-2008-0216

20080105:
        mport delete code added, USE_MPORT_TOOLS knob aded.

20080101:
        Happy New Year

20071123:
        Update sendmail to 8.14.2

20071120:
        Update system compiler to gcc 3.4.6.

20071023:
        Updated mksh to R31d.

20070911:
        Updated mksh to version R31b.

        Fixed stderr output in libpthread.  Previously it was
        written to stdout.

20070831:
        Added dot.mkshrc file to support the recent change to 
        mksh from OpenBSD's ksh derived from pdksh.  

        Added new firewall configuration.  ipfw is enabled by default
        with a "desktop" configuration.  Consult /etc/rc.firewall
        or ipfw show to see the ruleset used.  You can disable
        ipfw by setting firewall_enable="NO" in /etc/rc.conf This
        change only effects IPv4.  IPv6 does not have a firewall
        enabled by default.

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