UPDATING revision 54568
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.
5
619991213:
7	Soren updated the ata driver.  Please update to at least this
8	version before submitting bug reports.
9
1019991210:
11	The ata driver has become the primary ata/ide/atapi driver in
12	the kernel.  The wd driver is obsolete.  You should upgrade your
13	machine to the new ata driver.  You will need to follow the
14	directions for updating the devices in the 19991205 entry.  You
15	will need to update all occurances of wd to ad in your config files
16	(/etc/rc.conf, /etc/fstab, etc).  A compatibility device exists
17	for wd for the time being, but once you have determined that
18	ata is working for you, transition to the new ad devices.
19
2019991205:
21	Block devices are going away.  You will need to update your /dev
22	tree with a fresh copy of MAKEDEV for things to always work in 
23	the future.  fsck is unable to cope with dirty file systems
24	after this change, so it may work for you or it may not.
25
26	MAKEDEV should be copied from src/etc/MAKEDEV to /dev before
27	starting the following:
28
29		For N in the list of disks
30			MAKEDEV N			# eg ad0
31			for M in the list of slices
32				MAKEDEV NsMa		# eg ad0s1a
33
34	*** All uses of block devices must be converted to char devices.
35	*** Likely the only thing impacted is dumpdev in /etc/rc.conf
36
3719991204:
38	The dc interface has replaced al, ax, dm, pn and mx.  The former
39	have been removed.
40
4119991204:
42	Support for the old 'sd' device names has been removed in
43	favor of 'da'.  Please update your /etc/fstab, /etc/rc.conf
44	and any other places you might have sd names cached.
45	Generally these changes are as simple as s=/dev/sd=/dev/da=g,
46	but be careful to make sure that things are really that
47	simple.  You may also need to create /dev entries for the da
48	devices as well.
49
50	MAKEDEV should be copied from src/etc/MAKEDEV to /dev before
51	starting the following:
52
53		For N in the list of da disks on your system
54			MAKEDEV daN
55			for M in the list of slices
56				MAKEDEV daNsMa
5719991203:
58	BAD144 support has been removed.  Cope or replace the hardware.
59
6019991129:
61	ALPHA users take note.  All klds will need to be recompiled for
62	kernels build after this date.  It is a good time to update since
63	pal.s will be going away soon.
64
6519991126:
66	MFS_ROOT and MFS_ROOT_SIZE are gone, replaced by MD_ROOT and
67	MD_ROOT_SIZE options in the md driver.  md driver now deals with
68	the hacks.  You should add md driver to kerneles that have
69	MFS_ROOT, et al.  See GENERIC or LINT for details.
70
7119991125:
72	The ep changed a while ago and can no longer be used with hard
73	wired addresses in the config file.
74
7519991122:
76	The bridge drivers for sound cards have been committed.  Please
77	see LINT for instructions for your card, if it still works at
78	all.
79
8019991113:
81	Gcc 2.95.2 is now the default compiler.
82
8319991015:
84	PCCARD has been updated to attach pcic to the isa bus.  Therefore
85	you will need to modify kernel config files that have pcic/card
86	in them as follows:
87		controller	pcic0	at isa?
88		controller	pcic1	at isa?
89		controller	card0
90
9119990929:
92	The sigset_t datatype has been changed from an integral type
93	to a compound type and can hold 128 signals. Syscalls directly
94	or indirectly using the new sigset_t have been added as to
95	maintain compatibility with existing binaries. A new kernel must
96	be made and installed and booted with before a make world can
97	be done.
98
9919990919:
100	New jail syscall format requires recompilation of jail(8) with
101	fresh headers installed (or a make world will do it for you).
102
10319990914:
104	Matt Dillon checked in many vm related things and sent a heads up
105	to -current urging caution and to report vm problems to him.
106	As of the 19th, no killer problems have been reported, but you
107	have been warned.
108
10919990908:
110	The new miibus has been added to the system.  If you are using
111	the dm, rl, sf, sis, ste, tl, wb or xl drivers, you need to
112	add "controller miibus0" to your config file.
113
11419990905:
115	/var/cron/log has been moved to /var/log/cron to get all the
116	log files in one place.
117
11819990831:
119	tn3270 has been removed from the base system and added as a port.
120
12119990830:
122	User-visible TCP timers are now expressed in units of 1ms, instead
123	of 500ms, so if you've customized any timer values under
124	``net.inet.tcp'', multiply them by 500 to preserve TCP's behavior.
125
12619990828:
127	RCS Id tags changed to FreeBSD.  This will cause huge cvsup
128	updates.
129
13019990821:
131	On 28-May-1999 libreadline was upgraded from readline-2.2 to
132	readline-4.0.  At that time the shared library major version
133	number was bumped from "3" to "4".  It has been deemed that
134	the interface change between readline-2.2 and readline-4.0 was
135	not sufficient to warrant the version number bump.
136
137	Thus I have reverted it back to "3".  You will need to perform
138	the below immediately before your next ``make world'':
139	    cd /usr/lib
140	    ls -l libreadline.so.4
141	        (if you have /usr/lib/libreadline.so.4)
142	    mv libreadline.so.4 libreadline.so.3
143	    rm -f libreadline.so
144	    ln -s libreadline.so.3 libreadline.so
145
14619990801:
147	Changes to the pccardd kernel interface require that you recompile
148	pccardd for new kernel.
149
15019980725:
151	The ipfw interface to the kernel has changed.  You will need to
152	recompile ipfw programs for the new kernel.
153
15419990715:
155	The bpfilter device has been renamed to bpf.  You will need to 
156	change your config files in order to enable this in newer kernels.
157
15819990704:
159	src/contrib/sys/softupdates is moving to
160	src/sys/contrib/softupdates.  Update your symbolic links/etc.
161
16219990702:
163	Major changes have been made to vinum and its interface.  See
164	the man page (vinum(8)) for details.  Look at the concat,
165	mirror and stripe commands, as well as the SIMPLIFIED
166	CONFIGURATION section.
167
16819990628:
169	Newsyslog.conf has had a minor, but potentially dangerous,
170	change to its username/group syntax.  The old syntax was
171	user.group, while the new syntax is user:group.
172
17319990627:
174	Inetd wrapping default has changed.  Please see the updated
175	man page for details.
176
17719990623:
178	Compaq Smart Raid driver committed as ida.
179
18019990622:
181	The second phase of syscons cleanup has happened.  Some
182	functionality has been made optional.  For details, see
183        http://www.freebsd.org/~yokota/sc_update-June.txt
184	Everyone will need to re-config(8) their kernels, but old
185	binaries will work with the new kernel.
186
18719990620:
188	IPFW uid/gid-based filtering support has been committed. This
189	breaks binary compatibility with previous copies of
190	ipfw(8). Any utilities using the ioctl()s of ipfw (especially
191	ipfw(8)) need to be recompiled with the newest headers
192	installed.
193
19419990618:
195	Inetd now wraps all stream-based services, including internals.
196	Syslog "severity" options are honoured. Installed syslog.conf
197	and hosts.allow should be checked.
198
19919990509:
200	Most of the problems with newbus have been corrected, but
201	it is still current and evolving.
202
203	libcam's ABI has changed.  You must recompile the world and
204	any ports that use it.
205
20619990427:
207	Massive changes to SMP went into the tree that should speed
208	things up.  However, if you experience problems with SMP 
209	machines, you can back off to the PRE_SMP_VMSHARE tag in the
210	CVS repository (or run an MP kernel).
211
21219990420:
213	Pccardd and the pccard bus in general seem to be broken or
214	most people.  Soren has patches to make it better for some,
215	but not all people.  Work is underway to make it better for
216	all people.
217
21819990416:
219	new bus changes integrated into -current.  Many problems were
220	initially reported, but most have been fixed.  You'll need a
221	new config and to tweak your kernel config file the way that
222	GENERIC was tweaked.  Keep a copy of your old kernel when
223	upgrading in case your new kernel doesn't work (and report the
224	breakage to current@freebsd.org).
225
226	As of 19990421 the remaining problems/quirks are
227
228	o sio no longer supports pnp nor pccard.  This will be corrected,
229	  but the new pccard code needs to be completed.
230	o Some of the sound drivers broke for some people.  It seems
231	  inconsistant as to who/what/when/where things broke.
232	o Duplicate device entries in your config do not work.  Previously
233	  they were silently ignored.  psm0 seems to be the most common
234	  duplicate choice, although some reports have come in from people
235	  that wired their scsi disk entries.
236	o You must move the keyboard and mouse attachments from the
237	  isa bus to the atkbdc bus.  See GENERIC for details.
238	o Machines with multiple host-pci bridges (Intel 450NX) will not
239	  probe the second pci bus.
240	o Some probe ordering may have changed, so device naming may change
241	  with the new kernel.  If you have multiple devices, please double
242	  check to make sure they didn't move.  This is especially true
243	  for cards on different buses.
244	o The bus attachment for vga0 is always isa0 and never pci0 when
245	  it is in fact a pci card.  It is safe to ignore this.
246	o The format of the boot messages has changed (and is not
247	  guaranteed to be constant for a while) so you may see this
248	  in some shell scripts that diff dmesg from day to day as well
249	  as scripts that parse dmesg output.
250
25119990414:
252	cc -aout sometimes has problems compiling with -g, remove -g
253	from those compilation units affected until this is corrected.
254
255	cc -aout has problems with producing some threaded libraries,
256	so make world -DWANT_AOUT is not functional at this time.
257
258	Since make world for a.out isn't functional, you cannot do
259	make aout-to-elf from a pre-egcs a.out system.  To work around
260	this problem, make aout-to-elf using 3.1-stable first (or a
261	pre egcs -current) and then a simple make world will take you
262	the rest of the way with a -current source base.
263
26419990413:
265	Make -j works again for make world.  As always, use it with
266	care, and be sure to try a make world w/o -j before reporting
267	problems (that is, know if the problem exists w/o -j before
268	reporting the problem with -j).
269
27019990413:
271	Note cc -aout, which had been broken since the conversion to
272	egcs, now supposedly works.  If you have rebuilt things like
273	XFree86 a.out libraries, you should rebuild them again or
274	progams that use them, including netscape, will fail to work.
275
27619990409:
277	NOTE: New c++ compiler cannot be used with c++ binaries from
278	the old compiler and vice versa.
279
28019990408:
281	In recent days egcs has been imported into the tree.  A number
282	of problems have been discussed in -current.  Here is a highlight
283	of a few of the more common ones.  With the exception of make
284	-j n, they have been claimed to have been fixed.
285
286	c++ is broken after make world: This is correct.  Because we
287	changed compilers two make worlds are necessary to get C++
288	working again.  The code generated by the old compiler and new
289	compiler are not compatible, so things wind up being
290	undefined.
291
292	cpp is broken in make world:  There was a window where cpp
293	would be built incorrectly.  The fix for this is
294		cd src/gnu/usr.bin/cc
295		make clean
296		make all
297		make install
298	and this should correct your problems.  See the -current
299	archives for a version of this that does moer cleaning.
300
301	Make -j n doesn't work.  Work contiunes to make this work,
302	I've seen no reports of success as of April 7th.
303
30419990329:
305	Previously, one would define "NOAOUT" to keep from building
306	the legacy a.out bits.  Now one would define "WANT_AOUT" to
307	build them.
308
30919990316:
310	The name of the old wd.c and atapi.c based CDROM driver has
311	been changed back to wcd. So update your config file to use
312	"device wcd" instead of "device acd".
313
31419990314:
315	For those of you using the VN device as a loadable module,
316	please be aware that the new VN device has been committed to
317	-4.x and cannot yet be used as a loadable module.  This will
318	be fixed in the future.
319	
32019990309:
321	New loader.rc mechanism.  Please see src/sys/boot/README for
322	details.
323
32419990225:
325	struct proc size changed.  Recompile kernel and the
326	usual suspects.  Make world if in doubt.
327
32819990214:
329	The nlpt driver has changed names back to be the lpt driver.
330	See ppbus(4) or http://www.freebsd.org/~nsouch/ppbus.html
331	for proper configuration details.
332
33319990210:
334	The 'lpt' driver is now obsolete.  Replace it with the 'nlpt'
335	driver and 'ppbus' controller combination.
336
33719990209:
338	New devstat API requires recompilation of libdevstat, systat,
339	iostat, vmstat and rpc.rstatd.  A new kernel is also required.
340	make world + building a kernel should do all of this.  Any
341	ports that use devstat need to be recompiled as well.
342
34319990125:
344	Linux threads options has gone away (they are now standard in
345	the FreeBSD kernel).  A recompile of all libkvm using programs
346	is in order (or better yet a make world).
347
34819990122:
349	On or about this date there was a small window when the boot
350	blocks had some minor problems which seemed to force one to
351	edit /etc/fstab.  This has been corrected, if you are seeing this
352	problem, please rebuild and reinstall your boot blocks.
353
35419990121:
355	Vinum has changed.  The "vinum read" command has changed.  For
356	updates, please see
357
358http://www.freebsd.org/cgi/getmsg.cgi?fetch=800363+0+current/freebsd-current
359
360	for details.  
361
362	Matt Dillon committed a boatload of VM changes, for
363	information please see
364
365http://www.freebsd.org/cgi/getmsg.cgi?fetch=886676+0+current/freebsd-current
366	or
367http://www.freebsd.org/cgi/getmsg.cgi?fetch=827400+0+current/freebsd-current
368
369	for details.  These changes will likely not impact anybody,
370	but large chagnes to the VM need at least a heads up.
371
37219990120:
373	Stable branch created.  You might want to consider using this
374	branch.  It is tagged with RELENG_3.
375
37619990119:
377	More work on the syscons driver has been committed.  Since
378	files moved around, you will need to reconfigure your kernel,
379	and make clean; make depend before rebuilding the kernel.  No
380	config file changes are needed.
381
38219990111:
383	New keyboard and video card drivers are introduced as the first
384	stage of console driver reorganization.  You are required to
385	update the kernel configuration file and rebuild the kernel.
386	kbdcontrol, vidcontrol, and screen savers also need recompilation.
387	The instruction can be found in
388
389		http://www.freebsd.org/~yokota/sc_update.txt
390
391	It has notes on splash screen too.
392
39319990106:
394	Robert Nordier was kind enough to make this page to enable people to
395	install the new bootblocks:
396
397		http://www.freebsd.org/~rnordier/boot.txt
398
399	When updating to ELF, make sure that you have updated your
400	/etc/rc files which have different ldconfig invocations for
401	elf and aout.  Otherwise things like X will stop working with
402	messages about being unable to find library files.  The
403	mergemaster utility in ports/sysutils/mergemaster helps to
404	keep critical files like this in sync, and its use is
405	recommended.
406
40719990104:
408	Information about ELF day (see 19981230) can be found in
409
410		http://www.freebsd.org/~peter/elfday.html
411
412	about the upcoming change, its motivations and instructions
413	for doing the upgrade.
414
41519981230:
416	You should install new bootblocks now.  The ELF kernel will
417	become default soon.  In addition, you'll need to upgrade
418	your userland programs to ELF before then as well.  Use
419	make aout-to-elf to upgrade your userland programs (old
420	a.out programs in, for example, /usr/local/bin will
421	continue to work, even after the upgrade).  See src/Makefile
422	for more details.
423
42419981224:
425	The old wcd driver has been deleted from the kernel.  The
426	driver that replaces it is named acd.  You'll need to change
427	this in your configuration files.
428
429	Failure to do this will result in "ATAPI CD-ROMs not
430	configured" at boot time.
431
432	The floppy tape driver (ft) has been removed from the kernel,
433	with no replacement driver.
434
43519981202:
436	New groups from 19981201 commented out of mtree, so they
437	aren't strictly needed, but still a good idea to have.
438
43919981201:
440	New user/group added: bind.  From src/etc/master.passwd and
441	src/etc/group:
442		% grep <newstuff> /usr/src/etc/group 
443		bind:*:53:
444		% grep <newstuff> /usr/src/etc/master.passwd 
445		tty:*:4:65533::0:0:Tty Sandbox:/:/sbin/nologin
446		kmem:*:5:65533::0:0:KMem Sandbox:/:/sbin/nologin
447		bind:*:53:53::0:0:Bind Sandbox:/:/sbin/nologin
448
44919981118:
450	PAM integrated into the tree.   Requires new /etc/pam.conf file
451	to silence warnings from authentication programs (login, etc).
452	See src/etc/pam.conf for a sample.
453
454This file contains a list, in reverse chronologocal order, of major
455breakages in tracking -current.  Not all things will be listed here,
456and it only starts on November 18, 1998.  If you have an earlier
457version of FreeBSD, you are on your own to get to November 18, 1998.
458
459Please filter your entries through Warner (imp@village.org) so that
460the style, formatting, etc of this file can be maintained.
461
462$FreeBSD: head/UPDATING 54568 1999-12-13 17:55:23Z imp $
463