UPDATING revision 62702
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
820000704:
9	rc.shutdown and rc will now call the rc.d scripts with start
10	or stop.  This may cause some harmless warnings from older
11	rc.d scripts that haven't been updated.
12
1320000630:
14	The libfetch based version of fetch has gone into the tree.
15	Minor problems may result on some of the less popular sites,
16	which should be reported to des@freebsd.org.
17
1820000625:
19	From approximately this date forward, one must have the crypto
20	system installed in order to build the system and kernel.
21	While not technically strictly true, one should treat it as
22	required and grab the crypto bits.  If you are grabbing CVS
23	trees, src-all and cvs-crypto should be treated as if they
24	were required.  You should check with the latest collections
25	to make sure that these haven't changed.
26
2720000624:
28	Mark Murray just committed the first parts of a cleanup of
29	/dev/zero, et al.  This is also cleaning up /dev/random.
30	The entropy is disconnected, so DO NOT USE VERSIONS OF FREEBSD
31	-CURRENT FROM THIS POINT FORWARD for cryptographic services
32	until Mark can merge in the fixes to this work in progress.
33	openssh and openssl should not be used to generate keys from this
34	date to the completion of the work.
35
36	If you must operate at this reduced level of security, add '
37	options RANDOMDEV' to your kernel or modload the randomdev
38	module.  You may also need to copy a new MAKEDEV to /dev and
39	recreate the random and urandom devices.
40
4120000622:
42	The license on the softupdates is now a standard 2 clause
43	BSD license.  You may need to remove your symbolic links
44	that used to be required when updating.
45
4620000621:
47	Scott Flatman <sf@aracnet.com> sent in a decent writeup on
48	the config file update procedure.
49		http://people.freebsd.org/~imp/config-upd.html
50	NOTE: LINT is gone.  It has been replaced with NOTES.  NOTES
51	isn't buildable.
52
5320000620:
54	Binutils 2.10 have hit the tree, or will shortly.  As soon
55	as they do, the problem noted in 20000522 will be resolved and
56	that workaround will no longer be required.
57
5820000615:
59	phk removed the compatibility creation of wd devices in the
60	ad driver.  If you haven't done so already, you must update
61	your fstab, etc to use the ad devices instead of the wd
62	devices.
63
64	In addition, you'll need to update your boot blocks to a
65	more modern version, if you haven't already done so.  Modern
66	here means 4.0 release or newer (although older releases
67	may work).
68
6920000612:
70	Peter took an axe to config(8).  Besure that you read his mail
71	on the topic before even thinking about updating.  You will
72	need to create a /boot/devices.hints or add a hints directive
73	to your config file to compile them in statically.  The format
74	of the config file has changed as well.  Please see LINT,
75	GENERIC or NEWCARD for examples of the new format.
76
7720000522:
78	A new set of binutils went into the tree today.  Anybody
79	building a kernel after this point is advised that they need
80	to rebuild their binutils (or better yet do a
81	buildworld/installworld) before building a new kernel.
82
83	Due to bugs in binutils, using malloc options (eg /etc/malloc.conf
84	or MALLOC_OPTIONS env var) J will cause ld to dump core.  It
85	is recommended that you don't set this option until the problem
86	is resolved.
87
8820000513:
89	The ethernet drivers were all updated to clean up the BPF handling.
90
9120000510:
92	The problems with boot blocks on the alphas have been corrected.
93	This will require some care in updating alphas.  A new libstand
94	is requires for the boot blocks to build properly.
95
9620000503:
97	Recompile all kld modules.  Proper version dependency info
98	is now available.
99
10020000502:
101	Modules have been disconnected from the buildworld tree and 
102	connected to the kernel building instead.
103
1042000427:
105	You may need to build gperf
106		cd /usr/src/gnu/usr.bin/gperf && make depend all install
107	when upgrading from 4.0 -> current.  The build system now uses
108	an option only in -current.
109
11020000417:
111	The method that we brand ELF binaries has changed to be more
112	acceptible to the binutils maintainers.  You will need to
113	rebrand your ELF binaries that aren't native.  One problem
114	binary is the Linux ldconfig.  After your make world, but
115	before you reboot, you'll neeed to issue:
116		brandelf -t Linux /compat/linux/sbin/ldconfig
117	if you have Linux compatibility enabled on your machine.
118
11920000320:
120	If you have really bad/marginal IDE drives, you may find they
121	don't work well.  Use pio mode instead.  The easiest way to
122	cope if you have a problem combination is to add:
123		/sbin/sysctl -w hw.atamodes=pio,pio,pio,pio
124	to the start of /etc/rc.conf.
125
12620000319:
127	The ISA and PCI compatability shims have been connected to the
128	options COMPAT_OLDISA and COMPAT_OLDPCI.  If you are using old
129	style PCI or ISA drivers (i.e. tx, voxware, etc.) you must
130	include the appropriate option in your kernel config.  Drivers
131	using the shims should be updated or they won't ship with
132	5.0-RELEASE, targeted for 2001.
133
13420000318:
135	We've entered the tradtional post release dumping party.
136	Large kernel changes are being committed and are in the
137	works.  It is important to keep the systems' klds and kernel
138	in sync as kernel interfaces and structures are changing.
139	Before reporting kernel panics, make sure that all modules
140	that you are loading are up to date.
141
14220000315:
143	If you are upgrading from an older version of FreeBSD, you
144	need to update your boot blocks as well.  'disklabel -B ad0'
145	will do the trick.  This isn't critical until you remove your
146	wd device entries in /dev, at which point your system will not
147	boot.
148
14920000315:
150	4.0 RELEASE shipped.  Please see the 4.0 UPDATING file for how
151	to upgrade to 4.0 from 3.x.
152
153COMMON ITEMS:
154
155	To build a kernel
156	-----------------
157	Update config, genassym and go:
158		config YOUR_KERNEL_HERE			[1]
159		cd ../../compile/YOUR_KERNEL_HERE
160		make depend && make
161		make install
162	[1] If upgrading, add -r won't hurt and sometimes helps.
163
164	To rebuild everything
165	---------------------
166	make world
167
168	To upgrade from 4.0-stable to current
169	-------------------------------------
170	make buildworld
171	make buildkernel KERNEL=YOUR_KERNEL_HERE
172	make installkernel KERNEL=YOUR_KERNEL_HERE
173	make installworld
174	<reboot>
175
176	Make sure that you've read the UPDATING file to understand
177	the tweaks to various things you need.  At this point in the
178	life cycloe of current, things change often and you are on
179	your own to cope.
180
181FORMAT:
182
183This file contains a list, in reverse chronologocal order, of major
184breakages in tracking -current.  Not all things will be listed here,
185and it only starts on March 15, 2000.  Updating files can found in
186previous releases if your system is older than this.
187
188Please filter your entries through Warner Losh (imp@village.org) so
189that the style, formatting, etc of this file can be maintained.
190
191$FreeBSD: head/UPDATING 62702 2000-07-06 22:51:16Z imp $
192