UPDATING revision 54154
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
619991205:
7	/dev needs updating, copy MAKEDEV from src/etc to /dev and
8	run it to recreate all diskdevices.
9
1019991126:
11	MFS_ROOT and MFS_ROOT_SIZE are gone, replaced by MD_ROOT and
12	MD_ROOT_SIZE options in the md driver.  md driver now deals with
13	the hacks.  You should add md driver to kerneles that have
14	MFS_ROOT, et al.  See GENERIC or LINT for details.
15
1619991125:
17	The ep changed a while ago and can no longer be used with hard
18	wired addresses in the config file.
19
2019991113:
21	Gcc 2.95.2 is now the default compiler.
22
2319991015:
24	PCCARD has been updated to attach pcic to the isa bus.  Therefore
25	you will need to modify kernel config files that have pcic/card
26	in them as follows:
27		controller	pcic0	at isa?
28		controller	pcic1	at isa?
29		controller	card0
30
3119990929:
32	The sigset_t datatype has been changed from an integral type
33	to a compound type and can hold 128 signals. Syscalls directly
34	or indirectly using the new sigset_t have been added as to
35	maintain compatibility with existing binaries. A new kernel must
36	be made and installed and booted with before a make world can
37	be done.
38
3919990919:
40	New jail syscall format requires recompilation of jail(8) with
41	fresh headers installed (or a make world will do it for you).
42
4319990914:
44	Matt Dillon checked in many vm related things and sent a heads up
45	to -current urging caution and to report vm problems to him.
46	As of the 19th, no killer problems have been reported, but you
47	have been warned.
48
4919990908:
50	The new miibus has been added to the system.  If you are using
51	the dm, rl, sf, sis, ste, tl, wb or xl drivers, you need to
52	add "controller miibus0" to your config file.
53
5419990905:
55	/var/cron/log has been moved to /var/log/cron to get all the
56	log files in one place.
57
5819990831:
59	tn3270 has been removed from the base system and added as a port.
60
6119990830:
62	User-visible TCP timers are now expressed in units of 1ms, instead
63	of 500ms, so if you've customized any timer values under
64	``net.inet.tcp'', multiply them by 500 to preserve TCP's behavior.
65
6619990828:
67	RCS Id tags changed to FreeBSD.  This will cause huge cvsup
68	updates.
69
7019990821:
71	On 28-May-1999 libreadline was upgraded from readline-2.2 to
72	readline-4.0.  At that time the shared library major version
73	number was bumped from "3" to "4".  It has been deemed that
74	the interface change between readline-2.2 and readline-4.0 was
75	not sufficient to warrant the version number bump.
76
77	Thus I have reverted it back to "3".  You will need to perform
78	the below immediately before your next ``make world'':
79	    cd /usr/lib
80	    ls -l libreadline.so.4
81	        (if you have /usr/lib/libreadline.so.4)
82	    mv libreadline.so.4 libreadline.so.3
83	    rm -f libreadline.so
84	    ln -s libreadline.so.3 libreadline.so
85
8619990801:
87	Changes to the pccardd kernel interface require that you recompile
88	pccardd for new kernel.
89
9019980725:
91	The ipfw interface to the kernel has changed.  You will need to
92	recompile ipfw programs for the new kernel.
93
9419990715:
95	The bpfilter device has been renamed to bpf.  You will need to 
96	change your config files in order to enable this in newer kernels.
97
9819990704:
99	src/contrib/sys/softupdates is moving to
100	src/sys/contrib/softupdates.  Update your symbolic links/etc.
101
10219990702:
103	Major changes have been made to vinum and its interface.  See
104	the man page (vinum(8)) for details.  Look at the concat,
105	mirror and stripe commands, as well as the SIMPLIFIED
106	CONFIGURATION section.
107
10819990628:
109	Newsyslog.conf has had a minor, but potentially dangerous,
110	change to its username/group syntax.  The old syntax was
111	user.group, while the new syntax is user:group.
112
11319990627:
114	Inetd wrapping default has changed.  Please see the updated
115	man page for details.
116
11719990623:
118	Compaq Smart Raid driver committed as ida.
119
12019990622:
121	The second phase of syscons cleanup has happened.  Some
122	functionality has been made optional.  For details, see
123        http://www.freebsd.org/~yokota/sc_update-June.txt
124	Everyone will need to re-config(8) their kernels, but old
125	binaries will work with the new kernel.
126
12719990620:
128	IPFW uid/gid-based filtering support has been committed. This
129	breaks binary compatibility with previous copies of
130	ipfw(8). Any utilities using the ioctl()s of ipfw (especially
131	ipfw(8)) need to be recompiled with the newest headers
132	installed.
133
13419990618:
135	Inetd now wraps all stream-based services, including internals.
136	Syslog "severity" options are honoured. Installed syslog.conf
137	and hosts.allow should be checked.
138
13919990509:
140	Most of the problems with newbus have been corrected, but
141	it is still current and evolving.
142
143	libcam's ABI has changed.  You must recompile the world and
144	any ports that use it.
145
14619990427:
147	Massive changes to SMP went into the tree that should speed
148	things up.  However, if you experience problems with SMP 
149	machines, you can back off to the PRE_SMP_VMSHARE tag in the
150	CVS repository (or run an MP kernel).
151
15219990420:
153	Pccardd and the pccard bus in general seem to be broken or
154	most people.  Soren has patches to make it better for some,
155	but not all people.  Work is underway to make it better for
156	all people.
157
15819990416:
159	new bus changes integrated into -current.  Many problems were
160	initially reported, but most have been fixed.  You'll need a
161	new config and to tweak your kernel config file the way that
162	GENERIC was tweaked.  Keep a copy of your old kernel when
163	upgrading in case your new kernel doesn't work (and report the
164	breakage to current@freebsd.org).
165
166	As of 19990421 the remaining problems/quirks are
167
168	o sio no longer supports pnp nor pccard.  This will be corrected,
169	  but the new pccard code needs to be completed.
170	o Some of the sound drivers broke for some people.  It seems
171	  inconsistant as to who/what/when/where things broke.
172	o Duplicate device entries in your config do not work.  Previously
173	  they were silently ignored.  psm0 seems to be the most common
174	  duplicate choice, although some reports have come in from people
175	  that wired their scsi disk entries.
176	o You must move the keyboard and mouse attachments from the
177	  isa bus to the atkbdc bus.  See GENERIC for details.
178	o Machines with multiple host-pci bridges (Intel 450NX) will not
179	  probe the second pci bus.
180	o Some probe ordering may have changed, so device naming may change
181	  with the new kernel.  If you have multiple devices, please double
182	  check to make sure they didn't move.  This is especially true
183	  for cards on different buses.
184	o The bus attachment for vga0 is always isa0 and never pci0 when
185	  it is in fact a pci card.  It is safe to ignore this.
186	o The format of the boot messages has changed (and is not
187	  guaranteed to be constant for a while) so you may see this
188	  in some shell scripts that diff dmesg from day to day as well
189	  as scripts that parse dmesg output.
190
19119990414:
192	cc -aout sometimes has problems compiling with -g, remove -g
193	from those compilation units affected until this is corrected.
194
195	cc -aout has problems with producing some threaded libraries,
196	so make world -DWANT_AOUT is not functional at this time.
197
198	Since make world for a.out isn't functional, you cannot do
199	make aout-to-elf from a pre-egcs a.out system.  To work around
200	this problem, make aout-to-elf using 3.1-stable first (or a
201	pre egcs -current) and then a simple make world will take you
202	the rest of the way with a -current source base.
203
20419990413:
205	Make -j works again for make world.  As always, use it with
206	care, and be sure to try a make world w/o -j before reporting
207	problems (that is, know if the problem exists w/o -j before
208	reporting the problem with -j).
209
21019990413:
211	Note cc -aout, which had been broken since the conversion to
212	egcs, now supposedly works.  If you have rebuilt things like
213	XFree86 a.out libraries, you should rebuild them again or
214	progams that use them, including netscape, will fail to work.
215
21619990409:
217	NOTE: New c++ compiler cannot be used with c++ binaries from
218	the old compiler and vice versa.
219
22019990408:
221	In recent days egcs has been imported into the tree.  A number
222	of problems have been discussed in -current.  Here is a highlight
223	of a few of the more common ones.  With the exception of make
224	-j n, they have been claimed to have been fixed.
225
226	c++ is broken after make world: This is correct.  Because we
227	changed compilers two make worlds are necessary to get C++
228	working again.  The code generated by the old compiler and new
229	compiler are not compatible, so things wind up being
230	undefined.
231
232	cpp is broken in make world:  There was a window where cpp
233	would be built incorrectly.  The fix for this is
234		cd src/gnu/usr.bin/cc
235		make clean
236		make all
237		make install
238	and this should correct your problems.  See the -current
239	archives for a version of this that does moer cleaning.
240
241	Make -j n doesn't work.  Work contiunes to make this work,
242	I've seen no reports of success as of April 7th.
243
24419990329:
245	Previously, one would define "NOAOUT" to keep from building
246	the legacy a.out bits.  Now one would define "WANT_AOUT" to
247	build them.
248
24919990316:
250	The name of the old wd.c and atapi.c based CDROM driver has
251	been changed back to wcd. So update your config file to use
252	"device wcd" instead of "device acd".
253
25419990314:
255	For those of you using the VN device as a loadable module,
256	please be aware that the new VN device has been committed to
257	-4.x and cannot yet be used as a loadable module.  This will
258	be fixed in the future.
259	
26019990309:
261	New loader.rc mechanism.  Please see src/sys/boot/README for
262	details.
263
26419990225:
265	struct proc size changed.  Recompile kernel and the
266	usual suspects.  Make world if in doubt.
267
26819990214:
269	The nlpt driver has changed names back to be the lpt driver.
270	See ppbus(4) or http://www.freebsd.org/~nsouch/ppbus.html
271	for proper configuration details.
272
27319990210:
274	The 'lpt' driver is now obsolete.  Replace it with the 'nlpt'
275	driver and 'ppbus' controller combination.
276
27719990209:
278	New devstat API requires recompilation of libdevstat, systat,
279	iostat, vmstat and rpc.rstatd.  A new kernel is also required.
280	make world + building a kernel should do all of this.  Any
281	ports that use devstat need to be recompiled as well.
282
28319990125:
284	Linux threads options has gone away (they are now standard in
285	the FreeBSD kernel).  A recompile of all libkvm using programs
286	is in order (or better yet a make world).
287
28819990122:
289	On or about this date there was a small window when the boot
290	blocks had some minor problems which seemed to force one to
291	edit /etc/fstab.  This has been corrected, if you are seeing this
292	problem, please rebuild and reinstall your boot blocks.
293
29419990121:
295	Vinum has changed.  The "vinum read" command has changed.  For
296	updates, please see
297
298http://www.freebsd.org/cgi/getmsg.cgi?fetch=800363+0+current/freebsd-current
299
300	for details.  
301
302	Matt Dillon committed a boatload of VM changes, for
303	information please see
304
305http://www.freebsd.org/cgi/getmsg.cgi?fetch=886676+0+current/freebsd-current
306	or
307http://www.freebsd.org/cgi/getmsg.cgi?fetch=827400+0+current/freebsd-current
308
309	for details.  These changes will likely not impact anybody,
310	but large chagnes to the VM need at least a heads up.
311
31219990120:
313	Stable branch created.  You might want to consider using this
314	branch.  It is tagged with RELENG_3.
315
31619990119:
317	More work on the syscons driver has been committed.  Since
318	files moved around, you will need to reconfigure your kernel,
319	and make clean; make depend before rebuilding the kernel.  No
320	config file changes are needed.
321
32219990111:
323	New keyboard and video card drivers are introduced as the first
324	stage of console driver reorganization.  You are required to
325	update the kernel configuration file and rebuild the kernel.
326	kbdcontrol, vidcontrol, and screen savers also need recompilation.
327	The instruction can be found in
328
329		http://www.freebsd.org/~yokota/sc_update.txt
330
331	It has notes on splash screen too.
332
33319990106:
334	Robert Nordier was kind enough to make this page to enable people to
335	install the new bootblocks:
336
337		http://www.freebsd.org/~rnordier/boot.txt
338
339	When updating to ELF, make sure that you have updated your
340	/etc/rc files which have different ldconfig invocations for
341	elf and aout.  Otherwise things like X will stop working with
342	messages about being unable to find library files.  The
343	mergemaster utility in ports/sysutils/mergemaster helps to
344	keep critical files like this in sync, and its use is
345	recommended.
346
34719990104:
348	Information about ELF day (see 19981230) can be found in
349
350		http://www.freebsd.org/~peter/elfday.html
351
352	about the upcoming change, its motivations and instructions
353	for doing the upgrade.
354
35519981230:
356	You should install new bootblocks now.  The ELF kernel will
357	become default soon.  In addition, you'll need to upgrade
358	your userland programs to ELF before then as well.  Use
359	make aout-to-elf to upgrade your userland programs (old
360	a.out programs in, for example, /usr/local/bin will
361	continue to work, even after the upgrade).  See src/Makefile
362	for more details.
363
36419981224:
365	The old wcd driver has been deleted from the kernel.  The
366	driver that replaces it is named acd.  You'll need to change
367	this in your configuration files.
368
369	Failure to do this will result in "ATAPI CD-ROMs not
370	configured" at boot time.
371
372	The floppy tape driver (ft) has been removed from the kernel,
373	with no replacement driver.
374
37519981202:
376	New groups from 19981201 commented out of mtree, so they
377	aren't strictly needed, but still a good idea to have.
378
37919981201:
380	New user/group added: bind.  From src/etc/master.passwd and
381	src/etc/group:
382		% grep <newstuff> /usr/src/etc/group 
383		bind:*:53:
384		% grep <newstuff> /usr/src/etc/master.passwd 
385		tty:*:4:65533::0:0:Tty Sandbox:/:/sbin/nologin
386		kmem:*:5:65533::0:0:KMem Sandbox:/:/sbin/nologin
387		bind:*:53:53::0:0:Bind Sandbox:/:/sbin/nologin
388
38919981118:
390	PAM integrated into the tree.   Requires new /etc/pam.conf file
391	to silence warnings from authentication programs (login, etc).
392	See src/etc/pam.conf for a sample.
393
394This file contains a list, in reverse chronologocal order, of major
395breakages in tracking -current.  Not all things will be listed here,
396and it only starts on November 18, 1998.  If you have an earlier
397version of FreeBSD, you are on your own to get to November 18, 1998.
398
399Please filter your entries through Warner (imp@village.org) so that
400the style, formatting, etc of this file can be maintained.
401
402$FreeBSD: head/UPDATING 54154 1999-12-05 18:55:53Z phk $
403