xref: /freebsd/UPDATING (revision 7c0435b93397740dfc0a916712ce03421b08d08a)
157199806SWarner LoshUpdating Information for FreeBSD current users
253dfde79SWarner Losh
3e72fd46aSWarner LoshThis file is maintained and copyrighted by M. Warner Losh
49698f2c0SWarner Losh<imp@village.org>.  See end of file for further details.  For commonly
59698f2c0SWarner Loshdone items, please see the COMMON ITEMS: section later in the file.
6e72fd46aSWarner Losh
72c724730SWarner LoshItems affecting the ports and packages system can be found in
82c724730SWarner Losh/usr/ports/UPDATING.  Please read that file before running
94f638121SWarner Loshportupgrade.
102c724730SWarner Losh
1199b22782SKen SmithNOTE TO PEOPLE WHO THINK THAT FreeBSD 7.x IS SLOW:
1299b22782SKen Smith	FreeBSD 7.x has many debugging features turned on, in
1369f7bcf3SWarner Losh	both the kernel and userland.  These features attempt to detect
1469f7bcf3SWarner Losh	incorrect use of system primitives, and encourage loud failure
1569f7bcf3SWarner Losh	through extra sanity checking and fail stop semantics.  They
1669f7bcf3SWarner Losh	also substantially impact system performance.  If you want to
1769f7bcf3SWarner Losh	do performance measurement, benchmarking, and optimization,
1869f7bcf3SWarner Losh	you'll want to turn them off.  This includes various WITNESS-
1969f7bcf3SWarner Losh	related kernel options, INVARIANTS, malloc debugging flags
2069f7bcf3SWarner Losh	in userland, and various verbose features in the kernel.  Many
2169f7bcf3SWarner Losh	developers choose to disable these features on build machines
22a19f8ddaSDavid E. O'Brien	to maximize performance.
237c0435b9SKip Macy20061110:
247c0435b9SKip Macy	The MUTEX_PROFILING option has been renamed to LOCK_PROFILING.
257c0435b9SKip Macy	The lockmgr object layout has been changed as a result of having
267c0435b9SKip Macy	a lock_object embedded in it. As a consequence all file system
277c0435b9SKip Macy	kernel modules must be re-compiled. The mutex profiling man page
287c0435b9SKip Macy	has not yet been updated to reflect this change.
29c1f61aa9SDavid E. O'Brien
30013d6d8cSJohn Birrell20061026:
318460a577SJohn Birrell	KSE in the kernel has now been made optional and turned on by
32013d6d8cSJohn Birrell	default. Use 'nooption KSE' in your kernel config to turn it
33013d6d8cSJohn Birrell	off. All kernel modules *must* be recompiled after this change.
34013d6d8cSJohn Birrell	There-after, modules from a KSE kernel should be compatible with
35013d6d8cSJohn Birrell	modules from a NOKSE kernel due to the temporary padding fields
36013d6d8cSJohn Birrell	added to 'struct proc'.
378460a577SJohn Birrell
3813b3ebf1SBruce M Simpson20060929:
3913b3ebf1SBruce M Simpson	mrouted and its utilities have been removed from the base system.
4013b3ebf1SBruce M Simpson
41014a1a84SRuslan Ermilov20060927:
42014a1a84SRuslan Ermilov	Some ioctl(2) command codes have changed.  Full backward ABI
43014a1a84SRuslan Ermilov	compatibility is provided if the "options COMPAT_FREEBSD6" is
44014a1a84SRuslan Ermilov	present in the kernel configuration file.  Make sure to add
45014a1a84SRuslan Ermilov	this option to your kernel config file, or recompile X.Org
46014a1a84SRuslan Ermilov	and the rest of ports; otherwise they may refuse to work.
47014a1a84SRuslan Ermilov
48481544f3SBruce M Simpson20060924:
49481544f3SBruce M Simpson	tcpslice has been removed from the base system.
50481544f3SBruce M Simpson
5160206edeSRuslan Ermilov20060913:
5260206edeSRuslan Ermilov	The sizes of struct tcpcb (and struct xtcpcb) have changed due to
5360206edeSRuslan Ermilov	the rewrite of TCP syncookies.  Tools like netstat, sockstat, and
5460206edeSRuslan Ermilov	systat needs to be rebuilt.
5560206edeSRuslan Ermilov
5650bdd720SSam Leffler20060903:
5750bdd720SSam Leffler	libpcap updated to v0.9.4 and tcpdump to v3.9.4
5850bdd720SSam Leffler
593b4109aaSJulian Elischer20060816:
603b4109aaSJulian Elischer	The IPFIREWALL_FORWARD_EXTENDED option is gone and the behaviour
615f738ae6SMaxim Konovalov	for IPFIREWALL_FORWARD is now as it was before when it was first
623b4109aaSJulian Elischer	committed and for years after. The behaviour is now ON.
633b4109aaSJulian Elischer
64c8450a54SJung-uk Kim20060725:
65c8450a54SJung-uk Kim	enigma(1)/crypt(1) utility has been changed on 64 bit architectures.
66c8450a54SJung-uk Kim	Now it can decrypt files created from different architectures.
67c8450a54SJung-uk Kim	Unfortunately, it is no longer able to decrypt a cipher text
68c8450a54SJung-uk Kim	generated with an older version on 64 bit architectures.
69c8450a54SJung-uk Kim	If you have such a file, you need old utility to decrypt it.
70c8450a54SJung-uk Kim
715d0c7501SThomas Wintergerst20060709:
725d0c7501SThomas Wintergerst 	The interface version of the i4b kernel part has changed. So
735d0c7501SThomas Wintergerst 	after updating the kernel sources and compiling a new kernel,
745d0c7501SThomas Wintergerst 	the i4b user space tools in "/usr/src/usr.sbin/i4b" must also
755d0c7501SThomas Wintergerst 	be rebuilt, and vice versa.
765d0c7501SThomas Wintergerst
7744a8277bSRink Springer20060627:
7844a8277bSRink Springer	The XBOX kernel now defaults to the nfe(4) driver instead of
7944a8277bSRink Springer	the nve(4) driver. Please update your configuration
8044a8277bSRink Springer	accordingly.
8144a8277bSRink Springer
82647ef1a9SMarius Strobl20060514:
83647ef1a9SMarius Strobl	The i386-only lnc(4) driver for the AMD Am7900 LANCE and Am79C9xx
84647ef1a9SMarius Strobl	PCnet family of NICs has been removed. The new le(4) driver serves
85647ef1a9SMarius Strobl	as an equivalent but cross-platform replacement with the pcn(4)
86647ef1a9SMarius Strobl	driver still providing performance-optimized support for the subset
87647ef1a9SMarius Strobl	of AMD Am79C971 PCnet-FAST and greater chips as before.
88647ef1a9SMarius Strobl
899f8d2f6cSGiorgos Keramidas20060511:
909f8d2f6cSGiorgos Keramidas	The machdep.* sysctls and the adjkerntz utility have been
919f8d2f6cSGiorgos Keramidas	modified a bit.  The new adjkerntz utility uses the new
929f8d2f6cSGiorgos Keramidas	sysctl names and sysctlbyname() calls, so it may be impossible
939f8d2f6cSGiorgos Keramidas	to run an old /sbin/adjkerntz utility in single-user mode
949f8d2f6cSGiorgos Keramidas	with a new kernel.  Replace the `adjkerntz -i' step before
959f8d2f6cSGiorgos Keramidas	`make installworld' with:
969f8d2f6cSGiorgos Keramidas
979f8d2f6cSGiorgos Keramidas	    /usr/obj/usr/src/sbin/adjkerntz/adjkerntz -i
989f8d2f6cSGiorgos Keramidas
999f8d2f6cSGiorgos Keramidas	and proceed as usual with the rest of the installworld-stage
1009f8d2f6cSGiorgos Keramidas	steps.  Otherwise, you risk installing binaries with their
1019f8d2f6cSGiorgos Keramidas	timestamp set several hours in the future, especially if
1029f8d2f6cSGiorgos Keramidas	you are running with local time set to GMT+X hours.
1039f8d2f6cSGiorgos Keramidas
104a0a9755eSMax Laier20060412:
105a0a9755eSMax Laier	The ip6fw utility has been removed.  The behavior provided by
106a0a9755eSMax Laier	ip6fw has been in ipfw2 for a good while and the rc.d scripts
1074919094eSChristian Brueffer	have been updated to deal with it.  There are some rules that
108a0a9755eSMax Laier	might not migrate cleanly.  Use rc.firewall6 as a template to
109a0a9755eSMax Laier	rewrite rules.
110a0a9755eSMax Laier
111ff6a2d00SMarcel Moolenaar20060428:
112ff6a2d00SMarcel Moolenaar	The puc(4) driver has been overhauled. The ebus(4) and sbus(4)
113ff6a2d00SMarcel Moolenaar	attachments have been removed. Make sure to configure scc(4)
114ff6a2d00SMarcel Moolenaar	on sparc64. Note also that by default puc(4) will use uart(4)
115ff6a2d00SMarcel Moolenaar	and not sio(4) for serial ports because interrupt handling has
116ff6a2d00SMarcel Moolenaar	been optimized for multi-port serial cards and only uart(4)
117ff6a2d00SMarcel Moolenaar	implements the interface to support it.
118ff6a2d00SMarcel Moolenaar
119ff6a2d00SMarcel Moolenaar20060330:
120ff6a2d00SMarcel Moolenaar	The scc(4) driver replaces puc(4) for Serial Communications
121ff6a2d00SMarcel Moolenaar	Controllers (SCCs) like the Siemens SAB82532 and the Zilog
122ff6a2d00SMarcel Moolenaar	Z8530. On sparc64, it is advised to add scc(4) to the kernel
123ff6a2d00SMarcel Moolenaar	configuration to make sure that the serial ports remain
124ff6a2d00SMarcel Moolenaar	functional.
125ff6a2d00SMarcel Moolenaar
126c60fab8cSRuslan Ermilov20060317:
127c60fab8cSRuslan Ermilov	Most world/kernel related NO_* build options changed names.
128c60fab8cSRuslan Ermilov	New knobs have common prefixes WITHOUT_*/WITH_* (modelled
129c60fab8cSRuslan Ermilov	after FreeBSD ports) and should be set in /etc/src.conf
130c60fab8cSRuslan Ermilov	(the src.conf(5) manpage is provided).  Full backwards
131c60fab8cSRuslan Ermilov	compatibility is maintained for the time being though it's
132c60fab8cSRuslan Ermilov	highly recommended to start moving old options out of the
133c60fab8cSRuslan Ermilov	system-wide /etc/make.conf file into the new /etc/src.conf
134c60fab8cSRuslan Ermilov	while also properly renaming them.  More conversions will
135c60fab8cSRuslan Ermilov	likely follow.  Posting to current@:
136c60fab8cSRuslan Ermilov
137c60fab8cSRuslan Ermilov	http://lists.freebsd.org/pipermail/freebsd-current/2006-March/061725.html
138c60fab8cSRuslan Ermilov
1398d96e455SYaroslav Tykhiy20060305:
1408d96e455SYaroslav Tykhiy	The NETSMBCRYPTO kernel option has been retired because its
1418d96e455SYaroslav Tykhiy	functionality is always included in NETSMB and smbfs.ko now.
1428d96e455SYaroslav Tykhiy
143375ce679SYaroslav Tykhiy20060303:
144375ce679SYaroslav Tykhiy	The TDFX_LINUX kernel option was retired and replaced by the
14505ab391fSYaroslav Tykhiy	tdfx_linux device.  The latter can be loaded as the 3dfx_linux.ko
14605ab391fSYaroslav Tykhiy	kernel module.  Loading it alone should suffice to get 3dfx support
14705ab391fSYaroslav Tykhiy	for Linux apps because it will pull in 3dfx.ko and linux.ko through
14805ab391fSYaroslav Tykhiy	its dependencies.
149375ce679SYaroslav Tykhiy
15019dc3462SWarner Losh20060204:
15119dc3462SWarner Losh	The 'audit' group was added to support the new auditing functionality
15219dc3462SWarner Losh	in the base system.  Be sure to follow the directions for updating,
15319dc3462SWarner Losh	including the requirement to run mergemaster -p.
15419dc3462SWarner Losh
155dc422d87SYaroslav Tykhiy20060201:
156dc422d87SYaroslav Tykhiy	The kernel ABI to file system modules was changed on i386.
157dc422d87SYaroslav Tykhiy	Please make sure that your kernel and modules are in sync.
158dc422d87SYaroslav Tykhiy
159347daa0fSJulian Elischer20060118:
160347daa0fSJulian Elischer	This actually occured some time ago, but installing the kernel
161347daa0fSJulian Elischer	now also installs a bunch of symbol files for the kernel modules.
1626aa6311fSPav Lucistnik	This increases the size of /boot/kernel to about 67Mbytes. You
163347daa0fSJulian Elischer	will need twice this if you will eventually back this up to kernel.old
164347daa0fSJulian Elischer	on your next install.
165347daa0fSJulian Elischer	If you have a shortage of room in your root partition, you should add
166347daa0fSJulian Elischer	-DINSTALL_NODEBUG to your make arguments or add INSTALL_NODEBUG="yes"
167347daa0fSJulian Elischer	to your /etc/make.conf.
168347daa0fSJulian Elischer
169cc61a0b1SJason Evans20060113:
170cc61a0b1SJason Evans	libc's malloc implementation has been replaced.  This change has the
171cc61a0b1SJason Evans	potential to uncover application bugs that previously went unnoticed.
172cc61a0b1SJason Evans	See the malloc(3) manual page for more details.
173cc61a0b1SJason Evans
1747f4faad8SGleb Smirnoff20060112:
1757f4faad8SGleb Smirnoff	The generic netgraph(4) cookie has been changed. If you upgrade
1767f4faad8SGleb Smirnoff	kernel passing this point, you also need to upgrade userland
1777f4faad8SGleb Smirnoff	and netgraph(4) utilities like ports/net/mpd or ports/net/mpd4.
1787f4faad8SGleb Smirnoff
1796bed9d9eSJohn Baldwin20060106:
18090482dafSJohn Baldwin	si(4)'s device files now contain the unit number.
18190482dafSJohn Baldwin	Uses of {cua,tty}A[0-9a-f] should be replaced by {cua,tty}A0[0-9a-f].
18290482dafSJohn Baldwin
18390482dafSJohn Baldwin20060106:
1846bed9d9eSJohn Baldwin	The kernel ABI was mostly destroyed due to a change in the size
1856bed9d9eSJohn Baldwin	of struct lock_object which is nested in other structures such
1866bed9d9eSJohn Baldwin	as mutexes which are nested in all sorts of other structures.
1876bed9d9eSJohn Baldwin	Make sure your kernel and modules are in sync.
1886bed9d9eSJohn Baldwin
18952a16db3SAlexander Leidinger20051231:
19052a16db3SAlexander Leidinger	The page coloring algorithm in the VM subsystem was converted
19152a16db3SAlexander Leidinger	from tuning with kernel options to autotuning. Please remove
19252a16db3SAlexander Leidinger	any PQ_* option except PQ_NOOPT from your kernel config.
19352a16db3SAlexander Leidinger
1946dba929aSSam Leffler20051211:
1956dba929aSSam Leffler	The net80211-related tools in the tools/tools/ath directory
1966dba929aSSam Leffler	have been moved to tools/tools/net80211 and renamed with a
1976dba929aSSam Leffler	"wlan" prefix.  Scripts that use them should be adjusted
1986dba929aSSam Leffler	accordingly.
1996dba929aSSam Leffler
200a0cdeaecSDoug Barton20051202:
201a0cdeaecSDoug Barton	Scripts in the local_startup directories (as defined in
202a0cdeaecSDoug Barton	/etc/defaults/rc.conf) that have the new rc.d semantics will
203a0cdeaecSDoug Barton	now be run as part of the base system rcorder. If there are
204a0cdeaecSDoug Barton	errors or problems with one of these local scripts, it could
205a0cdeaecSDoug Barton	cause boot problems. If you encounter such problems, boot in
206a0cdeaecSDoug Barton	single user mode, remove that script from the */rc.d directory.
207a0cdeaecSDoug Barton	Please report the problem to the port's maintainer, and the
208a0cdeaecSDoug Barton	freebsd-ports@freebsd.org mailing list.
209a0cdeaecSDoug Barton
210b090e4ceSGleb Smirnoff20051129:
211a358ddbbSCraig Rodrigues	The nodev mount option was deprecated in RELENG_6 (where it
212a358ddbbSCraig Rodrigues	was a no-op), and is now unsupported.  If you have nodev or dev listed
213a358ddbbSCraig Rodrigues	in /etc/fstab, remove it, otherwise it will result in a mount error.
214a358ddbbSCraig Rodrigues
215a358ddbbSCraig Rodrigues20051129:
216b090e4ceSGleb Smirnoff	ABI between ipfw(4) and ipfw(8) has been changed. You need
217b090e4ceSGleb Smirnoff	to rebuild ipfw(8) when rebuilding kernel.
218b090e4ceSGleb Smirnoff
219d6b4b3b3SDavid E. O'Brien20051108:
220d6b4b3b3SDavid E. O'Brien	rp(4)'s device files now contain the unit number.
221d6b4b3b3SDavid E. O'Brien	Uses of {cua,tty}R[0-9a-f] should be replaced by {cua,tty}R0[0-9a-f].
222d6b4b3b3SDavid E. O'Brien
223a52364d5SYaroslav Tykhiy20051029:
224a52364d5SYaroslav Tykhiy	/etc/rc.d/ppp-user has been renamed to /etc/rc.d/ppp.
225a52364d5SYaroslav Tykhiy	Its /etc/rc.conf.d configuration file has been `ppp' from
226a52364d5SYaroslav Tykhiy	the beginning, and hence there is no need to touch it.
227a52364d5SYaroslav Tykhiy
228fc18f73dSYaroslav Tykhiy20051014:
229fc18f73dSYaroslav Tykhiy	Now most modules get their build-time options from the kernel
230fc18f73dSYaroslav Tykhiy	configuration file.  A few modules still have fixed options
231fc18f73dSYaroslav Tykhiy	due to their non-conformant implementation, but they will be
232fc18f73dSYaroslav Tykhiy	corrected eventually.  You may need to review the options of
233fc18f73dSYaroslav Tykhiy	the modules in use, explicitly specify the non-default options
234fc18f73dSYaroslav Tykhiy	in the kernel configuration file, and rebuild the kernel and
235fc18f73dSYaroslav Tykhiy	modules afterwards.
236fc18f73dSYaroslav Tykhiy
237114d09d8SGleb Smirnoff20051001:
238114d09d8SGleb Smirnoff	kern.polling.enable sysctl MIB is now deprecated. Use ifconfig(8)
239114d09d8SGleb Smirnoff	to turn polling(4) on your interfaces.
240114d09d8SGleb Smirnoff
241b6de9e91SMax Laier20050927:
242b6de9e91SMax Laier	The old bridge(4) implementation was retired.  The new
243b6de9e91SMax Laier	if_bridge(4) serves as a full functional replacement.
244b6de9e91SMax Laier
245bb518265SHajimu UMEMOTO20050722:
246bb518265SHajimu UMEMOTO	The ai_addrlen of a struct addrinfo was changed to a socklen_t
247bb518265SHajimu UMEMOTO	to conform to POSIX-2001.  This change broke an ABI
248bb518265SHajimu UMEMOTO	compatibility on 64 bit architecture.  You have to recompile
249bb518265SHajimu UMEMOTO	userland programs that use getaddrinfo(3) on 64 bit
250bb518265SHajimu UMEMOTO	architecture.
251bb518265SHajimu UMEMOTO
25299b22782SKen Smith20050711:
25399b22782SKen Smith	RELENG_6 branched here.
25499b22782SKen Smith
2557657f595SBrooks Davis20050629:
2567657f595SBrooks Davis	The pccard_ifconfig rc.conf variable has been removed and a new
2577657f595SBrooks Davis	variable, ifconfig_DEFAULT has been introduced.  Unlike
2587657f595SBrooks Davis	pccard_ifconfig, ifconfig_DEFAULT applies to ALL interfaces that
2597657f595SBrooks Davis	do not have ifconfig_ifn entries rather than just those in
2607657f595SBrooks Davis	removable_interfaces.
2617657f595SBrooks Davis
262d33db00cSDag-Erling Smørgrav20050616:
263d33db00cSDag-Erling Smørgrav	Some previous versions of PAM have permitted the use of
264d33db00cSDag-Erling Smørgrav	non-absolute paths in /etc/pam.conf or /etc/pam.d/* when referring
265d33db00cSDag-Erling Smørgrav	to third party PAM modules in /usr/local/lib.  A change has been
266d33db00cSDag-Erling Smørgrav	made to require the use of absolute paths in order to avoid
267d33db00cSDag-Erling Smørgrav	ambiguity and dependence on library path configuration, which may
268d33db00cSDag-Erling Smørgrav	affect existing configurations.
269d33db00cSDag-Erling Smørgrav
270ad0fdce5SBrooks Davis20050610:
271ad0fdce5SBrooks Davis	Major changes to network interface API.  All drivers must be
272ad0fdce5SBrooks Davis	recompiled.  Drivers not in the base system will need to be
273ad0fdce5SBrooks Davis	updated to the new APIs.
274ad0fdce5SBrooks Davis
275038164a1SGarance A Drosehn20050609:
276038164a1SGarance A Drosehn	Changes were made to kinfo_proc in sys/user.h.  Please recompile
277038164a1SGarance A Drosehn	userland, or commands like `fstat', `pkill', `ps', `top' and `w'
278038164a1SGarance A Drosehn	will not behave correctly.
279038164a1SGarance A Drosehn
28031f91694SJoseph Koshy	The API and ABI for hwpmc(4) have changed with the addition
28131f91694SJoseph Koshy	of sampling support.  Please recompile lib/libpmc(3) and
28231f91694SJoseph Koshy	usr.sbin/{pmcstat,pmccontrol}.
28331f91694SJoseph Koshy
284a8d23252SBrooks Davis20050606:
285a8d23252SBrooks Davis	The OpenBSD dhclient was imported in place of the ISC dhclient
286a8d23252SBrooks Davis	and the network interface configuration scripts were updated
287a8d23252SBrooks Davis	accordingly.  If you use DHCP to configure your interfaces, you
288a8d23252SBrooks Davis	must now run devd.  Also, DNS updating was lost so you will need
289a8d23252SBrooks Davis	to find a workaround if you use this feature.
290a8d23252SBrooks Davis
29119dc3462SWarner Losh	The '_dhcp' user was added to support the OpenBSD dhclient.  Be
29219dc3462SWarner Losh	sure to run mergemaster -p (like you are supposed to do every time
29319dc3462SWarner Losh	anyway).
29419dc3462SWarner Losh
295dfa58a49SAndrew Thompson20050605:
296dfa58a49SAndrew Thompson	if_bridge was added to the tree. This has changed struct ifnet.
297dfa58a49SAndrew Thompson	Please recompile userland and all network related modules.
298dfa58a49SAndrew Thompson
2992554b2d1SHajimu UMEMOTO20050603:
3002554b2d1SHajimu UMEMOTO	The n_net of a struct netent was changed to an uint32_t, and
3012554b2d1SHajimu UMEMOTO	1st argument of getnetbyaddr() was changed to an uint32_t, to
3021d6a063bSHajimu UMEMOTO	conform to POSIX-2001.  These changes broke an ABI
3030fe9e21bSHajimu UMEMOTO	compatibility on 64 bit architecture.  With these changes,
3040fe9e21bSHajimu UMEMOTO	shlib major of libpcap was bumped.  You have to recompile
3050fe9e21bSHajimu UMEMOTO	userland programs that use getnetbyaddr(3), getnetbyname(3),
3060fe9e21bSHajimu UMEMOTO	getnetent(3) and/or libpcap on 64 bit architecture.
3072554b2d1SHajimu UMEMOTO
3080a4c2543SGarance A Drosehn20050528:
3090a4c2543SGarance A Drosehn	Kernel parsing of extra options on '#!' first lines of shell
3100a4c2543SGarance A Drosehn	scripts has changed.  Lines with multiple options likely will
3110a4c2543SGarance A Drosehn	fail after this date.  For full details, please see
3120a4c2543SGarance A Drosehn		http://people.freebsd.org/~gad/Updating-20050528.txt
3130a4c2543SGarance A Drosehn
3146441fe95SMax Laier20050503:
3156441fe95SMax Laier	The packet filter (pf) code has been updated to OpenBSD 3.7
3166441fe95SMax Laier	Please note the changed anchor syntax and the fact that
3176441fe95SMax Laier	authpf(8) now needs a mounted fdescfs(5) to function.
3186441fe95SMax Laier
319cfdb76e5SScott Long20050415:
320cfdb76e5SScott Long	The NO_MIXED_MODE kernel option has been removed from the i386
321cfdb76e5SScott Long	amd64 platforms as its use has been superceded by the new local
322cfdb76e5SScott Long	APIC timer code.  Any kernel config files containing this option
323cfdb76e5SScott Long	should be updated.
324cfdb76e5SScott Long
3254bb8b8beSRuslan Ermilov20050227:
3264bb8b8beSRuslan Ermilov	The on-disk format of LC_CTYPE files was changed to be machine
3274bb8b8beSRuslan Ermilov	independent.  Please make sure NOT to use NO_CLEAN buildworld
32865f1be68SGleb Smirnoff	when crossing this point. Crossing this point also requires
32965f1be68SGleb Smirnoff	recompile or reinstall of all locale depended packages.
3304bb8b8beSRuslan Ermilov
331bc9d2991SBrooks Davis20050225:
332bc9d2991SBrooks Davis	The ifi_epoch member of struct if_data has been changed to
333bc9d2991SBrooks Davis	contain the uptime at which the interface was created or the
334bc9d2991SBrooks Davis	statistics zeroed rather then the wall clock time because
335bc9d2991SBrooks Davis	wallclock time may go backwards.  This should have no impact
336bc9d2991SBrooks Davis	unless an snmp implementation is using this value (I know of
337bc9d2991SBrooks Davis	none at this point.)
338bc9d2991SBrooks Davis
339915a554bSNate Lawson20050224:
340915a554bSNate Lawson	The acpi_perf and acpi_throttle drivers are now part of the
341915a554bSNate Lawson	acpi(4) main module.  They are no longer built separately.
342915a554bSNate Lawson
34310d6bd76SNate Lawson20050223:
34490dc539bSMaxim Sobolev	The layout of struct image_params has changed. You have to
34590dc539bSMaxim Sobolev	recompile all compatibility modules (linux, svr4, etc) for use
34690dc539bSMaxim Sobolev	with the new kernel.
34790dc539bSMaxim Sobolev
34890dc539bSMaxim Sobolev20050223:
34910d6bd76SNate Lawson	The p4tcc driver has been merged into cpufreq(4).  This makes
35010d6bd76SNate Lawson	"options CPU_ENABLE_TCC" obsolete.  Please load cpufreq.ko or
35110d6bd76SNate Lawson	compile in "device cpufreq" to restore this functionality.
35210d6bd76SNate Lawson
353aea80a64SXin LI20050220:
354aea80a64SXin LI	The responsibility of recomputing the file system summary of
355aea80a64SXin LI	a SoftUpdates-enabled dirty volume has been transferred to the
356aea80a64SXin LI	background fsck.  A rebuild of fsck(8) utility is recommended
357aea80a64SXin LI	if you have updated the kernel.
358aea80a64SXin LI
359aea80a64SXin LI	To get the old behavior (recompute file system summary at mount
360aea80a64SXin LI	time), you can set vfs.ffs.compute_summary_at_mount=1 before
361aea80a64SXin LI	mounting the new volume.
362aea80a64SXin LI
363da71ab85SGleb Smirnoff20050206:
364398dd94cSNate Lawson	The cpufreq import is complete.  As part of this, the sysctls for
365915a554bSNate Lawson	acpi(4) throttling have been removed.  The power_profile script
366398dd94cSNate Lawson	has been updated, so you can use performance/economy_cpu_freq in
367915a554bSNate Lawson	rc.conf(5) to set AC on/offline cpu frequencies.
368398dd94cSNate Lawson
369398dd94cSNate Lawson20050206:
370da71ab85SGleb Smirnoff	NG_VERSION has been increased. Recompiling kernel (or ng_socket.ko)
371da71ab85SGleb Smirnoff	requires recompiling libnetgraph and userland netgraph utilities.
3725ddd0622SBrooks Davis
3735ddd0622SBrooks Davis20050114:
3745ddd0622SBrooks Davis	Support for abbreviated forms of a number of ipfw options is
3755ddd0622SBrooks Davis	now deprecated.  Warnings are printed to stderr indicating the
3765ddd0622SBrooks Davis	correct full form when a match occurs.  Some abbreviations may
3775ddd0622SBrooks Davis	be supported at a later date based on user feedback.  To be
3785ddd0622SBrooks Davis	considered for support, abbreviations must be in use prior to
3795ddd0622SBrooks Davis	this commit and unlikely to be confused with current key words.
3805ddd0622SBrooks Davis
381b521988eSRuslan Ermilov20041221:
382b521988eSRuslan Ermilov	By a popular demand, a lot of NOFOO options were renamed
383b521988eSRuslan Ermilov	to NO_FOO (see bsd.compat.mk for a full list).  The old
384b521988eSRuslan Ermilov	spellings are still supported, but will cause annoying
385b521988eSRuslan Ermilov	warnings on stderr.  Make sure you upgrade properly (see
386b521988eSRuslan Ermilov	the COMMON ITEMS: section later in this file).
387b521988eSRuslan Ermilov
38887c9e370SSam Leffler20041219:
38987c9e370SSam Leffler	Auto-loading of ancillary wlan modules such as wlan_wep has
39087c9e370SSam Leffler	been temporarily disabled; you need to statically configure
39187c9e370SSam Leffler	the modules you need into your kernel or explicitly load them
39287c9e370SSam Leffler	prior to use.  Specifically, if you intend to use WEP encryption
39387c9e370SSam Leffler	with an 802.11 device load/configure wlan_wep; if you want to
39487c9e370SSam Leffler	use WPA with the ath driver load/configure wlan_tkip, wlan_ccmp,
39587c9e370SSam Leffler	and wlan_xauth as required.
39687c9e370SSam Leffler
39771c1c49aSBrian Somers20041213:
39871c1c49aSBrian Somers	The behaviour of ppp(8) has changed slightly.  If lqr is enabled
39971c1c49aSBrian Somers	(``enable lqr''), older versions would revert to LCP ECHO mode on
40071c1c49aSBrian Somers	negotiation failure.  Now, ``enable echo'' is required for this
40171c1c49aSBrian Somers	behaviour.  The ppp version number has been bumped to 3.4.2 to
40271c1c49aSBrian Somers	reflect the change.
40371c1c49aSBrian Somers
40488046524SSam Leffler20041201:
40588046524SSam Leffler	The wlan support has been updated to split the crypto support
40688046524SSam Leffler	into separate modules.  For static WEP you must configure the
40788046524SSam Leffler	wlan_wep module in your system or build and install the module
40888046524SSam Leffler	in place where it can be loaded (the kernel will auto-load
40988046524SSam Leffler	the module when a wep key is configured).
41088046524SSam Leffler
41188046524SSam Leffler20041201:
41288046524SSam Leffler	The ath driver has been updated to split the tx rate control
41388046524SSam Leffler	algorithm into a separate module.  You need to include either
41488046524SSam Leffler	ath_rate_onoe or ath_rate_amrr when configuring the kernel.
41588046524SSam Leffler
41681adddf3SJohn Baldwin20041116:
41781adddf3SJohn Baldwin	Support for systems with an 80386 CPU has been removed.  Please
41881adddf3SJohn Baldwin	use FreeBSD 5.x or earlier on systems with an 80386.
41981adddf3SJohn Baldwin
42042ba1c57SPoul-Henning Kamp20041110:
42142ba1c57SPoul-Henning Kamp	We have had a hack which would mount the root filesystem
42242ba1c57SPoul-Henning Kamp	R/W if the device were named 'md*'.  As part of the vnode
42342ba1c57SPoul-Henning Kamp	work I'm doing I have had to remove this hack.  People
42442ba1c57SPoul-Henning Kamp	building systems which use preloaded MD root filesystems
42542ba1c57SPoul-Henning Kamp	may need to insert a "/sbin/mount -u -o rw /dev/md0 /" in
42642ba1c57SPoul-Henning Kamp	their /etc/rc scripts.
42742ba1c57SPoul-Henning Kamp
428dcb5d8f8SRuslan Ermilov20041104:
429dcb5d8f8SRuslan Ermilov	FreeBSD 5.3 shipped here.
430dcb5d8f8SRuslan Ermilov
431c94c54e4SAndre Oppermann20041102:
432c94c54e4SAndre Oppermann	The size of struct tcpcb has changed again due to the removal
433c94c54e4SAndre Oppermann	of RFC1644 T/TCP.  You have to recompile userland programs that
434c94c54e4SAndre Oppermann	read kmem for tcp sockets directly (netstat, sockstat, etc.)
435c94c54e4SAndre Oppermann
436cd109b0dSAndre Oppermann20041022:
437cd109b0dSAndre Oppermann	The size of struct tcpcb has changed.  You have to recompile
438cd109b0dSAndre Oppermann	userland programs that read kmem for tcp sockets directly
439cd109b0dSAndre Oppermann	(netstat, sockstat, etc.)
440cd109b0dSAndre Oppermann
441b2723608SWarner Losh20041016:
442b2723608SWarner Losh	RELENG_5 branched here.  For older entries, please see updating
443b2723608SWarner Losh	in the RELENG_5 branch.
44457199806SWarner Losh
445dc0dbf5cSWarner LoshCOMMON ITEMS:
446dc0dbf5cSWarner Losh
447a24eff53SWarner Losh	General Notes
448a24eff53SWarner Losh	-------------
449a24eff53SWarner Losh	Avoid using make -j when upgrading.  From time to time in the
450a24eff53SWarner Losh	past there have been problems using -j with buildworld and/or
451a24eff53SWarner Losh	installworld.  This is especially true when upgrading between
452a24eff53SWarner Losh	"distant" versions (eg one that cross a major release boundary
453a24eff53SWarner Losh	or several minor releases, or when several months have passed
454a24eff53SWarner Losh	on the -current branch).
455a24eff53SWarner Losh
4565780f3baSWarner Losh	Sometimes, obscure build problems are the result of environment
4575780f3baSWarner Losh	poisoning.  This can happen because the make utility reads its
4585780f3baSWarner Losh	environment when searching for values for global variables.
4595780f3baSWarner Losh	To run your build attempts in an "environmental clean room",
4605780f3baSWarner Losh	prefix all make commands with 'env -i '.  See the env(1) manual
4615780f3baSWarner Losh	page for more details.
4625780f3baSWarner Losh
463081ff8acSDoug Barton	When upgrading from one major version to another it is generally
464081ff8acSDoug Barton	best to upgrade to the latest code in the currently installed branch
465081ff8acSDoug Barton	first, then do an upgrade to the new branch. This is the best-tested
466081ff8acSDoug Barton	upgrade path, and has the highest probability of being successful.
467081ff8acSDoug Barton	Please try this approach before reporting problems with a major
468081ff8acSDoug Barton	version upgrade.
469081ff8acSDoug Barton
470dc0dbf5cSWarner Losh	To build a kernel
471dc0dbf5cSWarner Losh	-----------------
472ba01eb20SWarner Losh	If you are updating from a prior version of FreeBSD (even one just
4731cf0ef11SDavid E. O'Brien	a few days old), you should follow this procedure.  It is the most
4741cf0ef11SDavid E. O'Brien	failsafe as it uses a /usr/obj tree with a fresh mini-buildworld,
4751cf0ef11SDavid E. O'Brien
4761cf0ef11SDavid E. O'Brien	make kernel-toolchain
477282e0f01SRuslan Ermilov	make -DALWAYS_CHECK_MAKE buildkernel KERNCONF=YOUR_KERNEL_HERE
478282e0f01SRuslan Ermilov	make -DALWAYS_CHECK_MAKE installkernel KERNCONF=YOUR_KERNEL_HERE
479dc0dbf5cSWarner Losh
4802e937dd6SAlexander Leidinger	To test a kernel once
4812e937dd6SAlexander Leidinger	---------------------
4822e937dd6SAlexander Leidinger	If you just want to boot a kernel once (because you are not sure
4832e937dd6SAlexander Leidinger	if it works, or if you want to boot a known bad kernel to provide
4842e937dd6SAlexander Leidinger	debugging information) run
4852e937dd6SAlexander Leidinger	make installkernel KERNCONF=YOUR_KERNEL_HERE KODIR=/boot/testkernel
4862e937dd6SAlexander Leidinger	nextboot -k testkernel
4872e937dd6SAlexander Leidinger
488ba01eb20SWarner Losh	To just build a kernel when you know that it won't mess you up
489ba01eb20SWarner Losh	--------------------------------------------------------------
4900fbd2da9SKen Smith	This assumes you are already running a 5.X system.  Replace
4910fbd2da9SKen Smith	${arch} with the architecture of your machine (e.g. "i386",
4920fbd2da9SKen Smith	"alpha", "amd64", "ia64", "pc98", "sparc64", etc).
4930fbd2da9SKen Smith
4940fbd2da9SKen Smith	cd src/sys/${arch}/conf
49547d0d01fSWarner Losh	config KERNEL_NAME_HERE
4960fbd2da9SKen Smith	cd ../compile/KERNEL_NAME_HERE
497ba01eb20SWarner Losh	make depend
498ba01eb20SWarner Losh	make
499ba01eb20SWarner Losh	make install
500ba01eb20SWarner Losh
501ba01eb20SWarner Losh	If this fails, go to the "To build a kernel" section.
502ba01eb20SWarner Losh
503ba01eb20SWarner Losh	To rebuild everything and install it on the current system.
504ba01eb20SWarner Losh	-----------------------------------------------------------
50563cb445eSWarner Losh	# Note: sometimes if you are running current you gotta do more than
50663cb445eSWarner Losh	# is listed here if you are upgrading from a really old current.
50763cb445eSWarner Losh
508f643de42SWarner Losh	<make sure you have good level 0 dumps>
50963cb445eSWarner Losh	make buildworld
5106586253aSWarner Losh	make kernel KERNCONF=YOUR_KERNEL_HERE
51163cb445eSWarner Losh							[1]
51263cb445eSWarner Losh	<reboot in single user>				[3]
51363cb445eSWarner Losh	mergemaster -p					[5]
51463cb445eSWarner Losh	make installworld
515e2a36081SAlexander Leidinger	make delete-old
51663cb445eSWarner Losh	mergemaster					[4]
51763cb445eSWarner Losh	<reboot>
51863cb445eSWarner Losh
519759f0aefSWarner Losh
520f27b1fceSJoseph Koshy	To cross-install current onto a separate partition
521f27b1fceSJoseph Koshy	--------------------------------------------------
522f27b1fceSJoseph Koshy	# In this approach we use a separate partition to hold
523f27b1fceSJoseph Koshy	# current's root, 'usr', and 'var' directories.   A partition
524f27b1fceSJoseph Koshy	# holding "/", "/usr" and "/var" should be about 2GB in
525f27b1fceSJoseph Koshy	# size.
526f27b1fceSJoseph Koshy
527f27b1fceSJoseph Koshy	<make sure you have good level 0 dumps>
528f27b1fceSJoseph Koshy	<boot into -stable>
529f27b1fceSJoseph Koshy	make buildworld
5303ecf3bddSRuslan Ermilov	make buildkernel KERNCONF=YOUR_KERNEL_HERE
531f27b1fceSJoseph Koshy	<maybe newfs current's root partition>
532f27b1fceSJoseph Koshy	<mount current's root partition on directory ${CURRENT_ROOT}>
533f27b1fceSJoseph Koshy	make installworld DESTDIR=${CURRENT_ROOT}
5342d5cde04SRuslan Ermilov	make distribution DESTDIR=${CURRENT_ROOT} # if newfs'd
5353ecf3bddSRuslan Ermilov	make installkernel KERNCONF=YOUR_KERNEL_HERE DESTDIR=${CURRENT_ROOT}
536f27b1fceSJoseph Koshy	cp /etc/fstab ${CURRENT_ROOT}/etc/fstab 		   # if newfs'd
537f27b1fceSJoseph Koshy	<edit ${CURRENT_ROOT}/etc/fstab to mount "/" from the correct partition>
538f27b1fceSJoseph Koshy	<reboot into current>
539f27b1fceSJoseph Koshy	<do a "native" rebuild/install as described in the previous section>
5406586253aSWarner Losh	<maybe install compatibility libraries from src/lib/compat>
541f27b1fceSJoseph Koshy 	<reboot>
542f27b1fceSJoseph Koshy
543f27b1fceSJoseph Koshy
5448ce4cbbfSWarner Losh	To upgrade in-place from 5.x-stable to current
545f27b1fceSJoseph Koshy	----------------------------------------------
546f643de42SWarner Losh	<make sure you have good level 0 dumps>
54721c075eaSWarner Losh	make buildworld					[9]
548e5dc5f61SWarner Losh	make kernel KERNCONF=YOUR_KERNEL_HERE		[8]
549fc8c157fSWarner Losh							[1]
550fc8c157fSWarner Losh	<reboot in single user>				[3]
551835284beSWarner Losh	mergemaster -p					[5]
552ba26da8eSWarner Losh	make installworld
553e2a36081SAlexander Leidinger	make delete-old
554802fc49dSBrian Feldman	mergemaster -i					[4]
555ba26da8eSWarner Losh	<reboot>
556ba26da8eSWarner Losh
557fdb9f54dSWarner Losh	Make sure that you've read the UPDATING file to understand the
558fdb9f54dSWarner Losh	tweaks to various things you need.  At this point in the life
559fdb9f54dSWarner Losh	cycle of current, things change often and you are on your own
560fdb9f54dSWarner Losh	to cope.  The defaults can also change, so please read ALL of
561fdb9f54dSWarner Losh	the UPDATING entries.
562ba26da8eSWarner Losh
5631dece4a9SWarner Losh	Also, if you are tracking -current, you must be subscribed to
5641dece4a9SWarner Losh	freebsd-current@freebsd.org.  Make sure that before you update
5651dece4a9SWarner Losh	your sources that you have read and understood all the recent
5661dece4a9SWarner Losh	messages there.  If in doubt, please track -stable which has
5671dece4a9SWarner Losh	much fewer pitfalls.
5681dece4a9SWarner Losh
569134d2e86SWarner Losh	[1] If you have third party modules, such as vmware, you
570134d2e86SWarner Losh	should disable them at this point so they don't crash your
571134d2e86SWarner Losh	system on reboot.
572134d2e86SWarner Losh
573ee6e1fc3SWarner Losh	[3] From the bootblocks, boot -s, and then do
574ee6e1fc3SWarner Losh		fsck -p
575ee6e1fc3SWarner Losh		mount -u /
576ee6e1fc3SWarner Losh		mount -a
5776586253aSWarner Losh		cd src
57847d0d01fSWarner Losh		adjkerntz -i		# if CMOS is wall time
579f6a0ef01SWarner Losh	Also, when doing a major release upgrade, it is required that
580f6a0ef01SWarner Losh	you boot into single user mode to do the installworld.
581ee6e1fc3SWarner Losh
582a6cd4f9dSWarner Losh	[4] Note: This step is non-optional.  Failure to do this step
583a6cd4f9dSWarner Losh	can result in a significant reduction in the functionality of the
584a6cd4f9dSWarner Losh	system.  Attempting to do it by hand is not recommended and those
585a6cd4f9dSWarner Losh	that pursue this avenue should read this file carefully, as well
586a6cd4f9dSWarner Losh	as the archives of freebsd-current and freebsd-hackers mailing lists
587a6cd4f9dSWarner Losh	for potential gotchas.
588a6cd4f9dSWarner Losh
589835284beSWarner Losh	[5] Usually this step is a noop.  However, from time to time
590835284beSWarner Losh	you may need to do this if you get unknown user in the following
591835284beSWarner Losh	step.  It never hurts to do it all the time.  You may need to
592835284beSWarner Losh	install a new mergemaster (cd src/usr.sbin/mergemaster && make
593835284beSWarner Losh	install) after the buildworld before this step if you last updated
594835284beSWarner Losh	from current before 20020224 or from -stable before 20020408.
595835284beSWarner Losh
596c74fe6afSWarner Losh	[8] In order to have a kernel that can run the 4.x binaries
597c74fe6afSWarner Losh	needed to do an installworld, you must include the COMPAT_FREEBSD4
598c74fe6afSWarner Losh	option in your kernel.  Failure to do so may leave you with a system
59965f1be68SGleb Smirnoff	that is hard to boot to recover. A similar kernel option COMPAT_FREEBSD5
60065f1be68SGleb Smirnoff	is required to run the 5.x binaries on more recent kernels.
601c74fe6afSWarner Losh
602e5dc5f61SWarner Losh	Make sure that you merge any new devices from GENERIC since the
603e5dc5f61SWarner Losh	last time you updated your kernel config file.
604e5dc5f61SWarner Losh
60521c075eaSWarner Losh	[9] When checking out sources, you must include the -P flag to have
606e5dc5f61SWarner Losh	cvs prune empty directories.
607e5dc5f61SWarner Losh
608e5dc5f61SWarner Losh	If CPUTYPE is defined in your /etc/make.conf, make sure to use the
609e5dc5f61SWarner Losh	"?=" instead of the "=" assignment operator, so that buildworld can
610e5dc5f61SWarner Losh	override the CPUTYPE if it needs to.
611e5dc5f61SWarner Losh
612e5dc5f61SWarner Losh	MAKEOBJDIRPREFIX must be defined in an environment variable, and
613e5dc5f61SWarner Losh	not on the command line, or in /etc/make.conf.  buildworld will
614e5dc5f61SWarner Losh	warn if it is improperly defined.
615dc0dbf5cSWarner LoshFORMAT:
616dc0dbf5cSWarner Losh
617f699bbbbSMark OvensThis file contains a list, in reverse chronological order, of major
6181fc1a0dcSWarner Loshbreakages in tracking -current.  Not all things will be listed here,
6198ce4cbbfSWarner Loshand it only starts on October 16, 2004.  Updating files can found in
620f8ab1dd6SWarner Loshprevious releases if your system is older than this.
6211fc1a0dcSWarner Losh
622e72fd46aSWarner LoshCopyright information:
623e72fd46aSWarner Losh
6248ce4cbbfSWarner LoshCopyright 1998-2005 M. Warner Losh.  All Rights Reserved.
625e72fd46aSWarner Losh
626772730c7SWarner LoshRedistribution, publication, translation and use, with or without
627772730c7SWarner Loshmodification, in full or in part, in any form or format of this
6289698f2c0SWarner Loshdocument are permitted without further permission from the author.
629e72fd46aSWarner Losh
630e72fd46aSWarner LoshTHIS DOCUMENT IS PROVIDED BY WARNER LOSH ``AS IS'' AND ANY EXPRESS OR
631e72fd46aSWarner LoshIMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
632e72fd46aSWarner LoshWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
633e72fd46aSWarner LoshDISCLAIMED.  IN NO EVENT SHALL WARNER LOSH BE LIABLE FOR ANY DIRECT,
634e72fd46aSWarner LoshINDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
635e72fd46aSWarner Losh(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
636e72fd46aSWarner LoshSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
637e72fd46aSWarner LoshHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
638e72fd46aSWarner LoshSTRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
639e72fd46aSWarner LoshIN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
640e72fd46aSWarner LoshPOSSIBILITY OF SUCH DAMAGE.
641e72fd46aSWarner Losh
642e72fd46aSWarner LoshIf you find this document useful, and you want to, you may buy the
643e72fd46aSWarner Loshauthor a beer.
644e72fd46aSWarner Losh
64522306abcSWarner LoshContact Warner Losh if you have any questions about your use of
646772730c7SWarner Loshthis document.
647772730c7SWarner Losh
64897d92980SPeter Wemm$FreeBSD$
649