UPDATING revision 62050
1Updating Information for FreeBSD current users
2
3This file is maintained by imp@village.org.  Please send new entries
4directly to him.  See end of file for further details.  For commonly
5done items, please see the end of the file.  Search for 'COMMON
6ITEMS:'
7
820000622:
9	The license on the softupdates is now a standard 2 clause
10	BSD license.  You may need to remove your symbolic links
11	that used to be required when updating.
12
1320000621:
14	Scott Flatman <sf@aracnet.com> sent in a decent writeup on
15	the config file update procedure.
16		http://people.freebsd.org/~imp/config-upd.html
17
1820000620:
19	Binutils 2.10 have hit the tree, or will shortly.  As soon
20	as they do, the problem noted in 20000522 will be resolved and
21	that workaround will no longer be required.
22
2320000615:
24	phk removed the compatibility creation of wd devices in the
25	ad driver.  If you haven't done so already, you must update
26	your fstab, etc to use the ad devices instead of the wd
27	devices.
28
29	In addition, you'll need to update your boot blocks to a
30	more modern version, if you haven't already done so.  Modern
31	here means 4.0 release or newer (although older releases
32	may work).
33
3420000612:
35	Peter took an axe to config(8).  Besure that you read his mail
36	on the topic before even thinking about updating.  You will
37	need to create a /boot/devices.hints or add a hints directive
38	to your config file to compile them in statically.  The format
39	of the config file has changed as well.  Please see LINT,
40	GENERIC or NEWCARD for examples of the new format.
41
42	More details to follow.  A better howto would be warmly
43	accepted by the author of UPDATING.
44
4520000522:
46	A new set of binutils went into the tree today.  Anybody
47	building a kernel after this point is advised that they need
48	to rebuild their binutils (or better yet do a
49	buildworld/installworld) before building a new kernel.
50
51	Due to bugs in binutils, using malloc options (eg /etc/malloc.conf
52	or MALLOC_OPTIONS env var) J will cause ld to dump core.  It
53	is recommended that you don't set this option until the problem
54	is resolved.
55
5620000513:
57	The ethernet drivers were all updated to clean up the BPF handling.
58
5920000510:
60	The problems with boot blocks on the alphas have been corrected.
61	This will require some care in updating alphas.  A new libstand
62	is requires for the boot blocks to build properly.
63
6420000503:
65	Recompile all kld modules.  Proper version dependency info
66	is now available.
67
6820000502:
69	Modules have been disconnected from the buildworld tree and 
70	connected to the kernel building instead.
71
722000427:
73	You may need to build gperf
74		cd /usr/src/gnu/usr.bin/gperf && make depend all install
75	when upgrading from 4.0 -> current.  The build system now uses
76	an option only in -current.
77
7820000417:
79	The method that we brand ELF binaries has changed to be more
80	acceptible to the binutils maintainers.  You will need to
81	rebrand your ELF binaries that aren't native.  One problem
82	binary is the Linux ldconfig.  After your make world, but
83	before you reboot, you'll neeed to issue:
84		brandelf -t Linux /compat/linux/sbin/ldconfig
85	if you have Linux compatibility enabled on your machine.
86
8720000320:
88	If you have really bad/marginal IDE drives, you may find they
89	don't work well.  Use pio mode instead.  The easiest way to
90	cope if you have a problem combination is to add:
91		/sbin/sysctl -w hw.atamodes=pio,pio,pio,pio
92	to the start of /etc/rc.conf.
93
9420000319:
95	The ISA and PCI compatability shims have been connected to the
96	options COMPAT_OLDISA and COMPAT_OLDPCI.  If you are using old
97	style PCI or ISA drivers (i.e. tx, voxware, etc.) you must
98	include the appropriate option in your kernel config.  Drivers
99	using the shims should be updated or they won't ship with
100	5.0-RELEASE, targeted for 2001.
101
10220000318:
103	We've entered the tradtional post release dumping party.
104	Large kernel changes are being committed and are in the
105	works.  It is important to keep the systems' klds and kernel
106	in sync as kernel interfaces and structures are changing.
107	Before reporting kernel panics, make sure that all modules
108	that you are loading are up to date.
109
11020000315:
111	If you are upgrading from an older version of FreeBSD, you
112	need to update your boot blocks as well.  'disklabel -B ad0'
113	will do the trick.  This isn't critical until you remove your
114	wd device entries in /dev, at which point your system will not
115	boot.
116
11720000315:
118	4.0 RELEASE shipped.  Please see the 4.0 UPDATING file for how
119	to upgrade to 4.0 from 3.x.
120
121COMMON ITEMS:
122
123	To build a kernel
124	-----------------
125	Update config, genassym and go:
126		config YOUR_KERNEL_HERE			[1]
127		cd ../../compile/YOUR_KERNEL_HERE
128		make depend && make
129		make install
130	[1] If upgrading, add -r won't hurt and sometimes helps.
131
132	To rebuild everything
133	---------------------
134	make world
135
136	To upgrade from 4.0-stable to current
137	-------------------------------------
138	make buildworld
139	make buildkernel KERNEL=YOUR_KERNEL_HERE
140	make installkernel KERNEL=YOUR_KERNEL_HERE
141	make installworld
142	<reboot>
143
144	Make sure that you've read the UPDATING file to understand
145	the tweaks to various things you need.  At this point in the
146	life cycloe of current, things change often and you are on
147	your own to cope.
148
149FORMAT:
150
151This file contains a list, in reverse chronologocal order, of major
152breakages in tracking -current.  Not all things will be listed here,
153and it only starts on March 15, 2000.  Updating files can found in
154previous releases if your system is older than this.
155
156Please filter your entries through Warner Losh (imp@village.org) so
157that the style, formatting, etc of this file can be maintained.
158
159$FreeBSD: head/UPDATING 62050 2000-06-25 08:26:38Z imp $
160