xref: /freebsd/UPDATING (revision ce62079b6b3c8edb12882cf4e0400a5be9a587b7)
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
11c15e0967SKen SmithNOTE TO PEOPLE WHO THINK THAT FreeBSD 8.x IS SLOW:
12c15e0967SKen Smith	FreeBSD 8.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
226bea5c3cSTom Rhodes	to maximize performance.  (To disable malloc debugging, run
236bea5c3cSTom Rhodes	ln -s aj /etc/malloc.conf.)
24efc06131SSam Leffler
25c2c2a7c1SBjoern A. Zeeb20090601:
26529cb8e3SRobert Watson	The way we are storing and accessing `routing table' entries
27c2c2a7c1SBjoern A. Zeeb	has changed. Programs reading the FIB, like netstat, need to
28c2c2a7c1SBjoern A. Zeeb	be re-compiled.
29c2c2a7c1SBjoern A. Zeeb
30529cb8e3SRobert Watson20090601:
31529cb8e3SRobert Watson	A new netisr implementation has been added for FreeBSD 8.  Network
32529cb8e3SRobert Watson	file system modules, such as igmp, ipdivert, and others, should be
33529cb8e3SRobert Watson	rebuilt.
34529cb8e3SRobert Watson	Bump __FreeBSD_version to 800096.
35529cb8e3SRobert Watson
36ce62079bSDoug Barton20090531:
37ce62079bSDoug Barton	For those who use ipfw and especially pf, those two firewalls
38ce62079bSDoug Barton	are now started BEFORE the network is initialized (i.e., before
39ce62079bSDoug Barton	rc.d/netif). Please review your rules to make sure that your
40ce62079bSDoug Barton	interfaces will be properly described.
41ce62079bSDoug Barton
422a61ba47SEdward Tomasz Napierala20090530:
43faef64ccSAttilio Rao	Remove the tunable/sysctl debug.mpsafevfs as its initial purpose
44faef64ccSAttilio Rao	is no more valid.
45faef64ccSAttilio Rao
46faef64ccSAttilio Rao20090530:
472a61ba47SEdward Tomasz Napierala	Add VOP_ACCESSX(9).  File system modules need to be rebuilt.
482a61ba47SEdward Tomasz Napierala	Bump __FreeBSD_version to 800094.
492a61ba47SEdward Tomasz Napierala
50b89fed67SEdward Tomasz Napierala20090529:
512a5f2c1dSMaxim Konovalov	Add mnt_xflag field to 'struct mount'.  File system modules
52b89fed67SEdward Tomasz Napierala	need to be rebuilt.
53b89fed67SEdward Tomasz Napierala	Bump __FreeBSD_version to 800093.
54b89fed67SEdward Tomasz Napierala
551ae1c2a3SAttilio Rao20090528:
561ae1c2a3SAttilio Rao	The compiling option ADAPTIVE_SX has been retired while it has been
571ae1c2a3SAttilio Rao	introduced the option NO_ADAPTIVE_SX which handles the reversed logic.
581ae1c2a3SAttilio Rao	The KPI for sx_init_flags() changes as accepting flags:
591ae1c2a3SAttilio Rao	SX_ADAPTIVESPIN flag has been retired while the SX_NOADAPTIVE flag
601ae1c2a3SAttilio Rao	has been introduced in order to handle the reversed logic.
611ae1c2a3SAttilio Rao	Bump __FreeBSD_version to 800092.
621ae1c2a3SAttilio Rao
630304c731SJamie Gritton20090527:
640304c731SJamie Gritton	Add support for hierarchical jails.  Remove global securelevel.
650304c731SJamie Gritton	Bump __FreeBSD_version to 800091.
660304c731SJamie Gritton
67dfc79e89SEdwin Groothuis20090523:
6837f17770SMarko Zec	The layout of struct vnet_net has changed, therefore modules
6937f17770SMarko Zec	need to be rebuilt.
7037f17770SMarko Zec	Bump __FreeBSD_version to 800090.
7137f17770SMarko Zec
7237f17770SMarko Zec20090523:
73dfc79e89SEdwin Groothuis	The newly imported zic(8) produces a new format in the
74609e2d1bSEdwin Groothuis	output. Please run tzsetup(8) to install the newly created
75609e2d1bSEdwin Groothuis	data to /etc/localtime.
76dfc79e89SEdwin Groothuis
7723790ac0SSam Leffler20090520:
789360ae40SAndrew Thompson	The sysctl tree for the usb stack has renamed from hw.usb2.* to
799360ae40SAndrew Thompson	hw.usb.* and is now consistent again with previous releases.
809360ae40SAndrew Thompson
819360ae40SAndrew Thompson20090520:
8223790ac0SSam Leffler	802.11 monitor mode support was revised and driver api's
8323790ac0SSam Leffler	were changed.  Drivers dependent on net80211 now support
8423790ac0SSam Leffler	DLT_IEEE802_11_RADIO instead of DLT_IEEE802_11.  No
8523790ac0SSam Leffler	user-visible data structures were changed but applications
8623790ac0SSam Leffler	that use DLT_IEEE802_11 may require changes.
8723790ac0SSam Leffler	Bump __FreeBSD_version to 800088.
8823790ac0SSam Leffler
89f6dfe47aSMarko Zec20090430:
90f6dfe47aSMarko Zec	The layout of the following structs has changed: sysctl_oid,
91f6dfe47aSMarko Zec	socket, ifnet, inpcbinfo, tcpcb, syncache_head, vnet_inet,
92f6dfe47aSMarko Zec	vnet_inet6 and vnet_ipfw.  Most modules need to be rebuild or
93f6dfe47aSMarko Zec	panics may be experienced.  World rebuild is required for
94f6dfe47aSMarko Zec	correctly checking networking state from userland.
95f6dfe47aSMarko Zec	Bump __FreeBSD_version to 800085.
96f6dfe47aSMarko Zec
9733cde130SBruce M Simpson20090429:
9833cde130SBruce M Simpson	MLDv2 and Source-Specific Multicast (SSM) have been merged
9933cde130SBruce M Simpson	to the IPv6 stack. VIMAGE hooks are in but not yet used.
10033cde130SBruce M Simpson	The implementation of SSM within FreeBSD's IPv6 stack closely
10133cde130SBruce M Simpson	follows the IPv4 implementation.
10233cde130SBruce M Simpson
10333cde130SBruce M Simpson	For kernel developers:
10433cde130SBruce M Simpson
10533cde130SBruce M Simpson	* The most important changes are that the ip6_output() and
10633cde130SBruce M Simpson	  ip6_input() paths no longer take the IN6_MULTI_LOCK,
10733cde130SBruce M Simpson	  and this lock has been downgraded to a non-recursive mutex.
10833cde130SBruce M Simpson
10933cde130SBruce M Simpson	* As with the changes to the IPv4 stack to support SSM, filtering
11033cde130SBruce M Simpson	  of inbound multicast traffic must now be performed by transport
11133cde130SBruce M Simpson	  protocols within the IPv6 stack. This does not apply to TCP and
11233cde130SBruce M Simpson	  SCTP, however, it does apply to UDP in IPv6 and raw IPv6.
11333cde130SBruce M Simpson
11433cde130SBruce M Simpson	* The KPIs used by IPv6 multicast are similar to those used by
11533cde130SBruce M Simpson	  the IPv4 stack, with the following differences:
11633cde130SBruce M Simpson	   * im6o_mc_filter() is analogous to imo_multicast_filter().
11733cde130SBruce M Simpson	   * The legacy KAME entry points in6_joingroup and in6_leavegroup()
11833cde130SBruce M Simpson	     are shimmed to in6_mc_join() and in6_mc_leave() respectively.
11933cde130SBruce M Simpson	   * IN6_LOOKUP_MULTI() has been deprecated and removed.
12033cde130SBruce M Simpson	   * IPv6 relies on MLD for the DAD mechanism. KAME's internal KPIs
12133cde130SBruce M Simpson	     for MLDv1 have an additional 'timer' argument which is used to
12233cde130SBruce M Simpson	     jitter the initial membership report for the solicited-node
12333cde130SBruce M Simpson	     multicast membership on-link.
12433cde130SBruce M Simpson	   * This is not strictly needed for MLDv2, which already jitters
12533cde130SBruce M Simpson	     its report transmissions.  However, the 'timer' argument is
12633cde130SBruce M Simpson	     preserved in case MLDv1 is active on the interface.
12733cde130SBruce M Simpson
12833cde130SBruce M Simpson	* The KAME linked-list based IPv6 membership implementation has
12933cde130SBruce M Simpson	  been refactored to use a vector similar to that used by the IPv4
13033cde130SBruce M Simpson	  stack.
13133cde130SBruce M Simpson	  Code which maintains a list of its own multicast memberships
13233cde130SBruce M Simpson	  internally, e.g. carp, has been updated to reflect the new
13333cde130SBruce M Simpson	  semantics.
13433cde130SBruce M Simpson
13533cde130SBruce M Simpson	* There is a known Lock Order Reversal (LOR) due to in6_setscope()
13633cde130SBruce M Simpson	  acquiring the IF_AFDATA_LOCK and being called within ip6_output().
13733cde130SBruce M Simpson	  Whilst MLDv2 tries to avoid this otherwise benign LOR, it is an
13833cde130SBruce M Simpson	  implementation constraint which needs to be addressed in HEAD.
13933cde130SBruce M Simpson
14033cde130SBruce M Simpson	For application developers:
14133cde130SBruce M Simpson
14233cde130SBruce M Simpson	* The changes are broadly similar to those made for the IPv4
14333cde130SBruce M Simpson	  stack.
14433cde130SBruce M Simpson
14533cde130SBruce M Simpson	* The use of IPv4 and IPv6 multicast socket options on the same
14633cde130SBruce M Simpson	  socket, using mapped addresses, HAS NOT been tested or supported.
14733cde130SBruce M Simpson
14833cde130SBruce M Simpson	* There are a number of issues with the implementation of various
14933cde130SBruce M Simpson	  IPv6 multicast APIs which need to be resolved in the API surface
15033cde130SBruce M Simpson	  before the implementation is fully compatible with KAME userland
15133cde130SBruce M Simpson	  use, and these are mostly to do with interface index treatment.
15233cde130SBruce M Simpson
15333cde130SBruce M Simpson	* The literature available discusses the use of either the delta / ASM
15433cde130SBruce M Simpson	  API with setsockopt(2)/getsockopt(2), or the full-state / ASM API
15533cde130SBruce M Simpson	  using setsourcefilter(3)/getsourcefilter(3). For more information
15633cde130SBruce M Simpson	  please refer to RFC 3768, 'Socket Interface Extensions for
15733cde130SBruce M Simpson	  Multicast Source Filters'.
15833cde130SBruce M Simpson
15933cde130SBruce M Simpson	* Applications which use the published RFC 3678 APIs should be fine.
16033cde130SBruce M Simpson
16133cde130SBruce M Simpson	For systems administrators:
16233cde130SBruce M Simpson
16333cde130SBruce M Simpson	* The mtest(8) utility has been refactored to support IPv6, in
16433cde130SBruce M Simpson	  addition to IPv4. Interface addresses are no longer accepted
16533cde130SBruce M Simpson	  as arguments, their names must be used instead. The utility
16633cde130SBruce M Simpson	  will map the interface name to its first IPv4 address as
16733cde130SBruce M Simpson	  returned by getifaddrs(3).
16833cde130SBruce M Simpson
16933cde130SBruce M Simpson	* The ifmcstat(8) utility has also been updated to print the MLDv2
17033cde130SBruce M Simpson	  endpoint state and source filter lists via sysctl(3).
17133cde130SBruce M Simpson
17233cde130SBruce M Simpson	* The net.inet6.ip6.mcast.loop sysctl may be tuned to 0 to disable
17333cde130SBruce M Simpson	  loopback of IPv6 multicast datagrams by default; it defaults to 1
17433cde130SBruce M Simpson	  to preserve the existing behaviour. Disabling multicast loopback is
17533cde130SBruce M Simpson	  recommended for optimal system performance.
17633cde130SBruce M Simpson
17733cde130SBruce M Simpson	* The IPv6 MROUTING code has been changed to examine this sysctl
17833cde130SBruce M Simpson	  instead of attempting to perform a group lookup before looping
17933cde130SBruce M Simpson	  back forwarded datagrams.
18033cde130SBruce M Simpson
18133cde130SBruce M Simpson	Bump __FreeBSD_version to 800084.
18233cde130SBruce M Simpson
1838b8bf775SRobert Watson20090422:
184131cdffbSMaksim Yevmenkin	Implement low-level Bluetooth HCI API.
185131cdffbSMaksim Yevmenkin	Bump __FreeBSD_version to 800083.
186131cdffbSMaksim Yevmenkin
1878b8bf775SRobert Watson20090419:
1888b8bf775SRobert Watson	The layout of struct malloc_type, used by modules to register new
1898b8bf775SRobert Watson	memory allocation types, has changed.  Most modules will need to
1908b8bf775SRobert Watson	be rebuilt or panics may be experienced.
1918b8bf775SRobert Watson	Bump __FreeBSD_version to 800081.
1928b8bf775SRobert Watson
193de4ab55eSKip Macy20090415:
194773b573aSKip Macy	Anticipate overflowing inp_flags - add inp_flags2.
195773b573aSKip Macy	This changes most offsets in inpcb, so checking v4 connection
196773b573aSKip Macy	state will require a world rebuild.
197773b573aSKip Macy	Bump __FreeBSD_version to 800080.
198f146c211SXin LI
199773b573aSKip Macy20090415:
200de4ab55eSKip Macy	Add an llentry to struct route and struct route_in6. Modules
201de4ab55eSKip Macy	embedding a struct route will need to be recompiled.
202de4ab55eSKip Macy	Bump __FreeBSD_version to 800079.
203de4ab55eSKip Macy
204427ac07fSKip Macy20090414:
205427ac07fSKip Macy	The size of rt_metrics_lite and by extension rtentry has changed.
206427ac07fSKip Macy	Networking administration apps will need to be recompiled.
207427ac07fSKip Macy	The route command now supports show as an alias for get, weighting
208427ac07fSKip Macy	of routes, sticky and nostick flags to alter the behavior of stateful
209427ac07fSKip Macy	load balancing.
210427ac07fSKip Macy	Bump __FreeBSD_version to 800078.
2118713ec3dSRenato Botelho
21287437955SMaksim Yevmenkin20090408:
21387437955SMaksim Yevmenkin	Do not use Giant for kbdmux(4) locking. This is wrong and
21487437955SMaksim Yevmenkin	apparently causing more problems than it solves. This will
21587437955SMaksim Yevmenkin	re-open the issue where interrupt handlers may race with
21687437955SMaksim Yevmenkin	kbdmux(4) in polling mode. Typical symptoms include (but
21787437955SMaksim Yevmenkin	not limited to) duplicated and/or missing characters when
21887437955SMaksim Yevmenkin	low level console functions (such as gets) are used while
21987437955SMaksim Yevmenkin	interrupts are enabled (for example geli password prompt,
22087437955SMaksim Yevmenkin	mountroot prompt etc.). Disabling kbdmux(4) may help.
22187437955SMaksim Yevmenkin
2222f6a1858SMarko Zec20090407:
2232f6a1858SMarko Zec	The size of structs vnet_net, vnet_inet and vnet_ipfw has changed;
2242f6a1858SMarko Zec	kernel modules referencing any of the above need to be recompiled.
2252f6a1858SMarko Zec	Bump __FreeBSD_version to 800075.
2262f6a1858SMarko Zec
227781d043cSIvan Voras20090320:
228781d043cSIvan Voras	GEOM_PART has become the default partition slicer for storage devices,
229781d043cSIvan Voras	replacing GEOM_MBR, GEOM_BSD, GEOM_PC98 and GEOM_GPT slicers. It
2309a07b548SIvan Voras	introduces some changes:
2319a07b548SIvan Voras
2329a07b548SIvan Voras	MSDOS/EBR: the devices created from MSDOS extended partition entries
2339a07b548SIvan Voras	(EBR) can be named differently than with GEOM_MBR and are now symlinks
2349a07b548SIvan Voras	to devices with offset-based names. fstabs may need to be modified.
2359a07b548SIvan Voras
2369a07b548SIvan Voras	BSD: the "geometry does not match label" warning is harmless in most
2379a07b548SIvan Voras	cases but it points to problems in file system misalignment with
2389a07b548SIvan Voras	disk geometry. The "c" partition is now implicit, covers the whole
2399a07b548SIvan Voras	top-level drive and cannot be (mis)used by users.
2409a07b548SIvan Voras
2419a07b548SIvan Voras	General: Kernel dumps are now not allowed to be written to devices
2429a07b548SIvan Voras	whose partition types indicate they are meant to be used for file
2439a07b548SIvan Voras	systems (or, in case of MSDOS partitions, as something else than
2449a07b548SIvan Voras	the "386BSD" type).
2459a07b548SIvan Voras
2469a07b548SIvan Voras	Most of these changes date approximately from 200812.
247781d043cSIvan Voras
248443fc317SBruce M Simpson20090319:
2492b78d306SAndrew Thompson	The uscanner(4) driver has been removed from the kernel. This follows
2502b78d306SAndrew Thompson	Linux removing theirs in 2.6 and making libusb the default interface
2512b78d306SAndrew Thompson	(supported by sane).
2522b78d306SAndrew Thompson
2532b78d306SAndrew Thompson20090319:
254443fc317SBruce M Simpson	The multicast forwarding code has been cleaned up. netstat(1)
255443fc317SBruce M Simpson	only relies on KVM now for printing bandwidth upcall meters.
256443fc317SBruce M Simpson	The IPv4 and IPv6 modules are split into ip_mroute_mod and
257443fc317SBruce M Simpson	ip6_mroute_mod respectively. The config(5) options for statically
258443fc317SBruce M Simpson	compiling this code remain the same, i.e. 'options MROUTING'.
259443fc317SBruce M Simpson
2601df14375SRobert Watson20090315:
2611df14375SRobert Watson	Support for the IFF_NEEDSGIANT network interface flag has been
2621df14375SRobert Watson	removed, which means that non-MPSAFE network device drivers are no
2631df14375SRobert Watson	longer supported.  In particular, if_ar, if_sr, and network device
2641df14375SRobert Watson	drivers from the old (legacy) USB stack can no longer be built or
2651df14375SRobert Watson	used.
2661df14375SRobert Watson
267e667034dSRui Paulo20090313:
2687e06afcaSGabor Kovesdan	POSIX.1 Native Language Support (NLS) has been enabled in libc and
2697e06afcaSGabor Kovesdan	a bunch of new language catalog files have also been added.
2707e06afcaSGabor Kovesdan	This means that some common libc messages are now localized and
2717e06afcaSGabor Kovesdan	they depend on the LC_MESSAGES environmental variable.
2727e06afcaSGabor Kovesdan
2737e06afcaSGabor Kovesdan20090313:
274e667034dSRui Paulo	The k8temp(4) driver has been renamed to amdtemp(4) since
275e667034dSRui Paulo	support for K10 and K11 CPU families was added.
276e667034dSRui Paulo
277a091d2a5SAndrew Thompson20090309:
278d10910e6SBruce M Simpson	IGMPv3 and Source-Specific Multicast (SSM) have been merged
279d10910e6SBruce M Simpson	to the IPv4 stack. VIMAGE hooks are in but not yet used.
280d10910e6SBruce M Simpson
281d10910e6SBruce M Simpson	For kernel developers, the most important changes are that the
282d10910e6SBruce M Simpson	ip_output() and ip_input() paths no longer take the IN_MULTI_LOCK(),
283d10910e6SBruce M Simpson	and this lock has been downgraded to a non-recursive mutex.
284d10910e6SBruce M Simpson
285d10910e6SBruce M Simpson	Transport protocols (UDP, Raw IP) are now responsible for filtering
286d10910e6SBruce M Simpson	inbound multicast traffic according to group membership and source
287d10910e6SBruce M Simpson	filters. The imo_multicast_filter() KPI exists for this purpose.
288d10910e6SBruce M Simpson	Transports which do not use multicast (SCTP, TCP) already reject
289d10910e6SBruce M Simpson	multicast by default. Forwarding and receive performance may improve
290d10910e6SBruce M Simpson	as a mutex acquisition is no longer needed in the ip_input()
291d10910e6SBruce M Simpson	low-level input path.  in_addmulti() and in_delmulti() are shimmed
292d10910e6SBruce M Simpson	to new KPIs which exist to support SSM in-kernel.
293d10910e6SBruce M Simpson
294d10910e6SBruce M Simpson	For application developers, it is recommended that loopback of
295d10910e6SBruce M Simpson	multicast datagrams be disabled for best performance, as this
296d10910e6SBruce M Simpson	will still cause the lock to be taken for each looped-back
297d10910e6SBruce M Simpson	datagram transmission. The net.inet.ip.mcast.loop sysctl may
298d10910e6SBruce M Simpson	be tuned to 0 to disable loopback by default; it defaults to 1
299d10910e6SBruce M Simpson	to preserve the existing behaviour.
300d10910e6SBruce M Simpson
301d10910e6SBruce M Simpson	For systems administrators, to obtain best performance with
302d10910e6SBruce M Simpson	multicast reception and multiple groups, it is always recommended
303d10910e6SBruce M Simpson	that a card with a suitably precise hash filter is used. Hash
304d10910e6SBruce M Simpson	collisions will still result in the lock being taken within the
305d10910e6SBruce M Simpson	transport protocol input path to check group membership.
306d10910e6SBruce M Simpson
307d10910e6SBruce M Simpson	If deploying FreeBSD in an environment with IGMP snooping switches,
308d10910e6SBruce M Simpson	it is recommended that the net.inet.igmp.sendlocal sysctl remain
309d10910e6SBruce M Simpson	enabled; this forces 224.0.0.0/24 group membership to be announced
310d10910e6SBruce M Simpson	via IGMP.
311d10910e6SBruce M Simpson
312d10910e6SBruce M Simpson	The size of 'struct igmpstat' has changed; netstat needs to be
313d10910e6SBruce M Simpson	recompiled to reflect this.
314d10910e6SBruce M Simpson	Bump __FreeBSD_version to 800070.
315d10910e6SBruce M Simpson
316d10910e6SBruce M Simpson20090309:
317a091d2a5SAndrew Thompson	libusb20.so.1 is now installed as libusb.so.1 and the ports system
318a091d2a5SAndrew Thompson	updated to use it. This requires a buildworld/installworld in order to
319a091d2a5SAndrew Thompson	update the library and dependencies (usbconfig, etc). Its advisable to
320cb2fe9b1SStanislav Sedov	rebuild all ports which uses libusb. More specific directions are given
3210ee5826eSAndrew Thompson	in the ports collection UPDATING file. Any /etc/libmap.conf entries for
3223296f80dSAndrew Thompson	libusb are no longer required and can be removed.
323a091d2a5SAndrew Thompson
32465067cc8SKonstantin Belousov20090302:
3259f960e98SKonstantin Belousov	A workaround is committed to allow the creation of System V shared
3269f960e98SKonstantin Belousov	memory segment of size > 2 GB on the 64-bit architectures.
3279f960e98SKonstantin Belousov	Due to a limitation of the existing ABI, the shm_segsz member
32865067cc8SKonstantin Belousov	of the struct shmid_ds, returned by shmctl(IPC_STAT) call is
329813bb2c9SJoel Dahl	wrong for large segments. Note that limits must be explicitly
33065067cc8SKonstantin Belousov	raised to allow such segments to be created.
33165067cc8SKonstantin Belousov
332176273eaSRobert Watson20090301:
333176273eaSRobert Watson	The layout of struct ifnet has changed, requiring a rebuild of all
334176273eaSRobert Watson	network device driver modules.
335176273eaSRobert Watson
336a13a5664SAndrew Thompson20090227:
337a13a5664SAndrew Thompson	The /dev handling for the new USB stack has changed, a
338a13a5664SAndrew Thompson	buildworld/installworld is required for libusb20.
339a13a5664SAndrew Thompson
34071e9286cSAndrew Thompson20090223:
34171e9286cSAndrew Thompson	The new USB2 stack has now been permanently moved in and all kernel and
342200dcf9aSAndrew Thompson	module names reverted to their previous values (eg, usb, ehci, ohci,
3439c1e15b5SAndrew Thompson	ums, ...).  The old usb stack can be compiled in by prefixing the name
34471e9286cSAndrew Thompson	with the letter 'o', the old usb modules have been removed.
345a709c9a6SWarner Losh	Updating entry 20090216 for xorg and 20090215 for libmap may still
346a709c9a6SWarner Losh	apply.
34771e9286cSAndrew Thompson
348553bf6a4SMike Makonnen20090217:
349553bf6a4SMike Makonnen	The rc.conf(5) option if_up_delay has been renamed to
350553bf6a4SMike Makonnen	defaultroute_delay to better reflect its purpose. If you have
351553bf6a4SMike Makonnen	customized this setting in /etc/rc.conf you need to update it to
352553bf6a4SMike Makonnen	use the new name.
353553bf6a4SMike Makonnen
354bb71e4b6SAndrew Thompson20090216:
355bb71e4b6SAndrew Thompson	xorg 7.4 wants to configure its input devices via hald which does not
356bb71e4b6SAndrew Thompson	yet work with USB2. If the keyboard/mouse does not work in xorg then
357bb71e4b6SAndrew Thompson	add
358bb71e4b6SAndrew Thompson		Option "AllowEmptyInput" "off"
359bb71e4b6SAndrew Thompson	to your ServerLayout section.  This will cause X to use the configured
360cbb9c89eSMaxim Konovalov	kbd and mouse sections from your xorg.conf.
361bb71e4b6SAndrew Thompson
362e4edc14eSAndrew Thompson20090215:
363e4edc14eSAndrew Thompson	The GENERIC kernels for all architectures now default to the new USB2
364e4edc14eSAndrew Thompson	stack. No kernel config options or code have been removed so if a
365e4edc14eSAndrew Thompson	problem arises please report it and optionally revert to the old USB
366e4edc14eSAndrew Thompson	stack. If you are loading USB kernel modules or have a custom kernel
367e4edc14eSAndrew Thompson	that includes GENERIC then ensure that usb names are also changed over,
368cbb9c89eSMaxim Konovalov	eg uftdi -> usb2_serial_ftdi.
369e4edc14eSAndrew Thompson
370a709c9a6SWarner Losh	Older programs linked against the ports libusb 0.1 need to be
371a709c9a6SWarner Losh	redirected to the new stack's libusb20.  /etc/libmap.conf can
372a709c9a6SWarner Losh	be used for this:
373a709c9a6SWarner Losh		# Map old usb library to new one for usb2 stack
374a709c9a6SWarner Losh		libusb-0.1.so.8	libusb20.so.1
375a709c9a6SWarner Losh
37614943437SJohn Baldwin20090203:
37714943437SJohn Baldwin	The ichsmb(4) driver has been changed to require SMBus slave
37814943437SJohn Baldwin	addresses be left-justified (xxxxxxx0b) rather than right-justified.
37914943437SJohn Baldwin	All of the other SMBus controller drivers require left-justified
38014943437SJohn Baldwin	slave addresses, so this change makes all the drivers provide the
38114943437SJohn Baldwin	same interface.
38214943437SJohn Baldwin
38309f8c3ffSBjoern A. Zeeb20090201:
38409f8c3ffSBjoern A. Zeeb	INET6 statistics (struct ip6stat) was updated.
38509f8c3ffSBjoern A. Zeeb	netstat(1) needs to be recompiled.
38609f8c3ffSBjoern A. Zeeb
38774f91fb9SMaxim Sobolev20090119:
38874f91fb9SMaxim Sobolev	NTFS has been removed from GENERIC kernel on amd64 to match
38974f91fb9SMaxim Sobolev	GENERIC on i386. Should not cause any issues since mount_ntfs(8)
39074f91fb9SMaxim Sobolev	will load ntfs.ko module automatically when NTFS support is
39174f91fb9SMaxim Sobolev	actually needed, unless ntfs.ko is not installed or security
39274f91fb9SMaxim Sobolev	level prohibits loading kernel modules. If either is the case,
39374f91fb9SMaxim Sobolev	"options NTFS" has to be added into kernel config.
39474f91fb9SMaxim Sobolev
39524cb0f22SLawrence Stewart20090115:
39624cb0f22SLawrence Stewart	TCP Appropriate Byte Counting (RFC 3465) support added to kernel.
39724cb0f22SLawrence Stewart	New field in struct tcpcb breaks ABI, so bump __FreeBSD_version to
39824cb0f22SLawrence Stewart	800061. User space tools that rely on the size of struct tcpcb in
39924cb0f22SLawrence Stewart	tcp_var.h (e.g. sockstat) need to be recompiled.
40024cb0f22SLawrence Stewart
4015d55747eSAlexander Motin20081225:
4025d55747eSAlexander Motin	ng_tty(4) module updated to match the new TTY subsystem.
4035d55747eSAlexander Motin	Due to API change, user-level applications must be updated.
4045d55747eSAlexander Motin	New API support added to mpd5 CVS and expected to be present
4055d55747eSAlexander Motin	in next mpd5.3 release.
4065d55747eSAlexander Motin
407efc06131SSam Leffler20081219:
408a1c64cafSSam Leffler	With __FreeBSD_version 800060 the makefs tool is part of
409a1c64cafSSam Leffler	the base system (it was a port).
410efc06131SSam Leffler
411991f8615SKip Macy20081216:
412991f8615SKip Macy	The afdata and ifnet locks have been changed from mutexes to
413991f8615SKip Macy	rwlocks, network modules will need to be re-compiled.
4141d7e99caSJohn Baldwin
4156e6b3f7cSQing Li20081214:
4166e6b3f7cSQing Li	__FreeBSD_version 800059 incorporates the new arp-v2 rewrite.
4176e6b3f7cSQing Li	RTF_CLONING, RTF_LLINFO and RTF_WASCLONED flags are eliminated.
4186e6b3f7cSQing Li	The new code reduced struct rtentry{} by 16 bytes on 32-bit
4196e6b3f7cSQing Li	architecture and 40 bytes on 64-bit architecture. The userland
4206e6b3f7cSQing Li	applications "arp" and "ndp" have been updated accordingly.
4216e6b3f7cSQing Li	The output from "netstat -r" shows only routing entries and
4226e6b3f7cSQing Li	none of the L2 information.
4236e6b3f7cSQing Li
42433644623SSam Leffler20081130:
42533644623SSam Leffler	__FreeBSD_version 800057 marks the switchover from the
42633644623SSam Leffler	binary ath hal to source code. Users must add the line:
42733644623SSam Leffler
428c60b227cSSam Leffler	options	AH_SUPPORT_AR5416
42933644623SSam Leffler
43033644623SSam Leffler	to their kernel config files when specifying:
43133644623SSam Leffler
43233644623SSam Leffler	device	ath_hal
43333644623SSam Leffler
43433644623SSam Leffler	The ath_hal module no longer exists; the code is now compiled
43533644623SSam Leffler	together with the driver in the ath module.  It is now
43633644623SSam Leffler	possible to tailor chip support (i.e. reduce the set of chips
43733644623SSam Leffler	and thereby the code size); consult ath_hal(4) for details.
43833644623SSam Leffler
439db7f0b97SKip Macy20081121:
440db7f0b97SKip Macy	__FreeBSD_version 800054 adds memory barriers to
441db7f0b97SKip Macy	<machine/atomic.h>, new interfaces to ifnet to facilitate
442db7f0b97SKip Macy	multiple hardware transmit queues for cards that support
443db7f0b97SKip Macy	them, and a lock-less ring-buffer implementation to
444db7f0b97SKip Macy	enable drivers to more efficiently manage queueing of
445db7f0b97SKip Macy	packets.
446db7f0b97SKip Macy
447de2e1b35SXin LI20081117:
448de2e1b35SXin LI	A new version of ZFS (version 13) has been merged to -HEAD.
449de3a91a0SXin LI	This version has zpool attribute "listsnapshots" off by
450de3a91a0SXin LI	default, which means "zfs list" does not show snapshots,
451de2e1b35SXin LI	and is the same as Solaris behavior.
452de2e1b35SXin LI
45302d09f79SOleg Bulyzhin20081028:
45402d09f79SOleg Bulyzhin	dummynet(4) ABI has changed. ipfw(8) needs to be recompiled.
45502d09f79SOleg Bulyzhin
456e91c7c81SJoseph Koshy20081009:
457d8135f4aSNick Hibma	The uhci, ohci, ehci and slhci USB Host controller drivers have
458d8135f4aSNick Hibma	been put into separate modules. If you load the usb module
459d8135f4aSNick Hibma	separately through loader.conf you will need to load the
460d8135f4aSNick Hibma	appropriate *hci module as well. E.g. for a UHCI-based USB 2.0
461d8135f4aSNick Hibma	controller add the following to loader.conf:
462d8135f4aSNick Hibma
463d8135f4aSNick Hibma		uhci_load="YES"
464d8135f4aSNick Hibma		ehci_load="YES"
465d8135f4aSNick Hibma
466d8135f4aSNick Hibma20081009:
467e91c7c81SJoseph Koshy	The ABI used by the PMC toolset has changed.  Please keep
468e91c7c81SJoseph Koshy	userland (libpmc(3)) and the kernel module (hwpmc(4)) in
469e91c7c81SJoseph Koshy	sync.
470e91c7c81SJoseph Koshy
471bc093719SEd Schouten20080820:
472bc093719SEd Schouten	The TTY subsystem of the kernel has been replaced by a new
473bc093719SEd Schouten	implementation, which provides better scalability and an
474bc093719SEd Schouten	improved driver model. Most common drivers have been migrated to
475bc093719SEd Schouten	the new TTY subsystem, while others have not. The following
476bc093719SEd Schouten	drivers have not yet been ported to the new TTY layer:
477bc093719SEd Schouten
478bc093719SEd Schouten	PCI/ISA:
47966e7dc38SEd Schouten		cy, digi, rc, rp, sio
480bc093719SEd Schouten
481bc093719SEd Schouten	USB:
48266e7dc38SEd Schouten		ubser, ucycom
483bc093719SEd Schouten
484bc093719SEd Schouten	Line disciplines:
485bc093719SEd Schouten		ng_h4, ng_tty, ppp, sl, snp
486bc093719SEd Schouten
487bc093719SEd Schouten	Adding these drivers to your kernel configuration file shall
488bc093719SEd Schouten	cause compilation to fail.
489bc093719SEd Schouten
4909d965219SOllivier Robert20080818:
4919d965219SOllivier Robert	ntpd has been upgraded to 4.2.4p5.
4929d965219SOllivier Robert
493eaeb50d4SDag-Erling Smørgrav20080801:
494eaeb50d4SDag-Erling Smørgrav	OpenSSH has been upgraded to 5.1p1.
495eaeb50d4SDag-Erling Smørgrav
496eaeb50d4SDag-Erling Smørgrav	For many years, FreeBSD's version of OpenSSH preferred DSA
497eaeb50d4SDag-Erling Smørgrav	over RSA for host and user authentication keys.  With this
498eaeb50d4SDag-Erling Smørgrav	upgrade, we've switched to the vendor's default of RSA over
499eaeb50d4SDag-Erling Smørgrav	DSA.  This may cause upgraded clients to warn about unknown
500eaeb50d4SDag-Erling Smørgrav	host keys even for previously known hosts.  Users should
501eaeb50d4SDag-Erling Smørgrav	follow the usual procedure for verifying host keys before
502eaeb50d4SDag-Erling Smørgrav	accepting the RSA key.
503eaeb50d4SDag-Erling Smørgrav
504eaeb50d4SDag-Erling Smørgrav	This can be circumvented by setting the "HostKeyAlgorithms"
505eaeb50d4SDag-Erling Smørgrav	option to "ssh-dss,ssh-rsa" in ~/.ssh/config or on the ssh
506eaeb50d4SDag-Erling Smørgrav	command line.
507eaeb50d4SDag-Erling Smørgrav
508737d990aSXin LI	Please note that the sequence of keys offered for
509737d990aSXin LI	authentication has been changed as well.  You may want to
510737d990aSXin LI	specify IdentityFile in a different order to revert this
511737d990aSXin LI	behavior.
512737d990aSXin LI
513f4d811f0SEd Schouten20080713:
514f4d811f0SEd Schouten	The sio(4) driver has been removed from the i386 and amd64
515f4d811f0SEd Schouten	kernel configuration files. This means uart(4) is now the
516f4d811f0SEd Schouten	default serial port driver on those platforms as well.
517f4d811f0SEd Schouten
518f4d811f0SEd Schouten	To prevent collisions with the sio(4) driver, the uart(4) driver
519f4d811f0SEd Schouten	uses different names for its device nodes. This means the
520f4d811f0SEd Schouten	onboard serial port will now most likely be called "ttyu0"
521f4d811f0SEd Schouten	instead of "ttyd0". You may need to reconfigure applications to
522f4d811f0SEd Schouten	use the new device names.
523f4d811f0SEd Schouten
524db96ec0bSEd Schouten	When using the serial port as a boot console, be sure to update
525db96ec0bSEd Schouten	/boot/device.hints and /etc/ttys before booting the new kernel.
526db96ec0bSEd Schouten	If you forget to do so, you can still manually specify the hints
527db96ec0bSEd Schouten	at the loader prompt:
528db96ec0bSEd Schouten
529db96ec0bSEd Schouten		set hint.uart.0.at="isa"
530db96ec0bSEd Schouten		set hint.uart.0.port="0x3F8"
531db96ec0bSEd Schouten		set hint.uart.0.flags="0x10"
532db96ec0bSEd Schouten		set hint.uart.0.irq="4"
533db96ec0bSEd Schouten		boot -s
534db96ec0bSEd Schouten
535bdc03b37SMarcel Moolenaar20080609:
536bdc03b37SMarcel Moolenaar	The gpt(8) utility has been removed. Use gpart(8) to partition
537bdc03b37SMarcel Moolenaar	disks instead.
538bdc03b37SMarcel Moolenaar
53927f7c387SRoman Divacky20080603:
540a47444d5SRoman Divacky	The version that Linuxulator emulates was changed from 2.4.2
541a47444d5SRoman Divacky	to 2.6.16. If you experience any problems with Linux binaries
542a47444d5SRoman Divacky	please try to set sysctl compat.linux.osrelease to 2.4.2 and
543a47444d5SRoman Divacky	if it fixes the problem contact emulation mailing list.
544a47444d5SRoman Divacky
5452e598474SBjoern A. Zeeb20080525:
5462e598474SBjoern A. Zeeb	ISDN4BSD (I4B) was removed from the src tree. You may need to
5472e598474SBjoern A. Zeeb	update a your kernel configuration and remove relevant entries.
5482e598474SBjoern A. Zeeb
5494dcedde3SJulian Elischer20080509:
5504dcedde3SJulian Elischer	I have checked in code to support multiple routing tables.
551032e0bf8SMaxim Konovalov	See the man pages setfib(1) and setfib(2).
5524dcedde3SJulian Elischer	This is a hopefully backwards compatible version,
5534dcedde3SJulian Elischer	but to make use of it you need to compile your kernel
5544dcedde3SJulian Elischer	with options ROUTETABLES=2 (or more up to 16).
5554dcedde3SJulian Elischer
556de570baaSSam Leffler20080420:
557de570baaSSam Leffler	The 802.11 wireless support was redone to enable multi-bss
558de570baaSSam Leffler	operation on devices that are capable.  The underlying device
559de570baaSSam Leffler	is no longer used directly but instead wlanX devices are
560de570baaSSam Leffler	cloned with ifconfig.  This requires changes to rc.conf files.
5615318f840SWarner Losh	For example, change:
5625318f840SWarner Losh		ifconfig_ath0="WPA DHCP"
5635318f840SWarner Losh	to
5645318f840SWarner Losh		wlans_ath0=wlan0
5655318f840SWarner Losh		ifconfig_wlan0="WPA DHCP"
5660f95e625SWarner Losh	see rc.conf(5) for more details.  In addition, mergemaster of
5670f95e625SWarner Losh	/etc/rc.d is highly recommended.  Simultaneous update of userland
5680f95e625SWarner Losh	and kernel wouldn't hurt either.
569de570baaSSam Leffler
570de570baaSSam Leffler	As part of the multi-bss changes the wlan_scan_ap and wlan_scan_sta
571de570baaSSam Leffler	modules were merged into the base wlan module.  All references
572de570baaSSam Leffler	to these modules (e.g. in kernel config files) must be removed.
573de570baaSSam Leffler
574ff0af72cSJung-uk Kim20080408:
575ff0af72cSJung-uk Kim	psm(4) has gained write(2) support in native operation level.
576ff0af72cSJung-uk Kim	Arbitrary commands can be written to /dev/psm%d and status can
577ff0af72cSJung-uk Kim	be read back from it.  Therefore, an application is responsible
578ff0af72cSJung-uk Kim	for status validation and error recovery.  It is a no-op in
579ff0af72cSJung-uk Kim	other operation levels.
580ff0af72cSJung-uk Kim
581e4c67b94SJeff Roberson20080312:
582e4c67b94SJeff Roberson	Support for KSE threading has been removed from the kernel.  To
583e4c67b94SJeff Roberson	run legacy applications linked against KSE libmap.conf may
584e4c67b94SJeff Roberson	be used.  The following libmap.conf may be used to ensure
585e4c67b94SJeff Roberson	compatibility with any prior release:
586e4c67b94SJeff Roberson
587e4c67b94SJeff Roberson	libpthread.so.1 libthr.so.1
588e4c67b94SJeff Roberson	libpthread.so.2 libthr.so.2
589e4c67b94SJeff Roberson	libkse.so.3 libthr.so.3
590e4c67b94SJeff Roberson
5918775db6fSMarcel Moolenaar20080301:
5928775db6fSMarcel Moolenaar	The layout of struct vmspace has changed. This affects libkvm
5938775db6fSMarcel Moolenaar	and any executables that link against libkvm and use the
5948775db6fSMarcel Moolenaar	kvm_getprocs() function. In particular, but not exclusively,
5958775db6fSMarcel Moolenaar	it affects ps(1), fstat(1), pkill(1), systat(1), top(1) and w(1).
5968775db6fSMarcel Moolenaar	The effects are minimal, but it's advisable to upgrade world
5978775db6fSMarcel Moolenaar	nonetheless.
5988775db6fSMarcel Moolenaar
599df09ebc0SJack F Vogel20080229:
600df09ebc0SJack F Vogel	The latest em driver no longer has support in it for the
601df09ebc0SJack F Vogel	82575 adapter, this is now moved to the igb driver. The
602df09ebc0SJack F Vogel	split was done to make new features that are incompatible
603df09ebc0SJack F Vogel	with older hardware easier to do.
604df09ebc0SJack F Vogel
6051669d8afSAndrew Thompson20080220:
6061669d8afSAndrew Thompson	The new geom_lvm(4) geom class has been renamed to geom_linux_lvm(4),
6071669d8afSAndrew Thompson	likewise the kernel option is now GEOM_LINUX_LVM.
6081669d8afSAndrew Thompson
6092427fa19SKris Kennaway20080211:
6102427fa19SKris Kennaway	The default NFS mount mode has changed from UDP to TCP for
6112427fa19SKris Kennaway	increased reliability.  If you rely on (insecurely) NFS
6122427fa19SKris Kennaway	mounting across a firewall you may need to update your
6132427fa19SKris Kennaway	firewall rules.
6142427fa19SKris Kennaway
6155e9f6b73SSam Leffler20080208:
6165e9f6b73SSam Leffler	Belatedly note the addition of m_collapse for compacting
6175e9f6b73SSam Leffler	mbuf chains.
6185e9f6b73SSam Leffler
61948aaad5fSYaroslav Tykhiy20080126:
62048aaad5fSYaroslav Tykhiy	The fts(3) structures have been changed to use adequate
62148aaad5fSYaroslav Tykhiy	integer types for their members and so to be able to cope
62248aaad5fSYaroslav Tykhiy	with huge file trees.  The old fts(3) ABI is preserved
62348aaad5fSYaroslav Tykhiy	through symbol versioning in libc, so third-party binaries
62448aaad5fSYaroslav Tykhiy	using fts(3) should still work, although they will not take
62548aaad5fSYaroslav Tykhiy	advantage of the extended types.  At the same time, some
62648aaad5fSYaroslav Tykhiy	third-party software might fail to build after this change
62748aaad5fSYaroslav Tykhiy	due to unportable assumptions made in its source code about
62848aaad5fSYaroslav Tykhiy	fts(3) structure members.  Such software should be fixed
62948aaad5fSYaroslav Tykhiy	by its vendor or, in the worst case, in the ports tree.
63048aaad5fSYaroslav Tykhiy	FreeBSD_version 800015 marks this change for the unlikely
63148aaad5fSYaroslav Tykhiy	case that a portable fix is impossible.
63248aaad5fSYaroslav Tykhiy
63351dc1e12SRuslan Ermilov20080123:
6348015f45cSWarner Losh	To upgrade to -current after this date, you must be running
63551dc1e12SRuslan Ermilov	FreeBSD not older than 6.0-RELEASE.  Upgrading to -current
6368015f45cSWarner Losh	from 5.x now requires a stop over at RELENG_6 or RELENG_7 systems.
6378015f45cSWarner Losh
638ab4a2c41SMatteo Riondato20071128:
639ab4a2c41SMatteo Riondato	The ADAPTIVE_GIANT kernel option has been retired because its
640ab4a2c41SMatteo Riondato	functionality is the default now.
641ab4a2c41SMatteo Riondato
642e393af84SMarius Strobl20071118:
643e393af84SMarius Strobl	The AT keyboard emulation of sunkbd(4) has been turned on
644e393af84SMarius Strobl	by default. In order to make the special symbols of the Sun
645e393af84SMarius Strobl	keyboards driven by sunkbd(4) work under X these now have
646e393af84SMarius Strobl	to be configured the same way as Sun USB keyboards driven
647e393af84SMarius Strobl	by ukbd(4) (which also does AT keyboard emulation), f.e.:
648e393af84SMarius Strobl
649e393af84SMarius Strobl	Option	"XkbLayout" "us"
650e393af84SMarius Strobl	Option	"XkbRules" "xorg"
651e393af84SMarius Strobl	Option	"XkbSymbols" "pc(pc105)+sun_vndr/usb(sun_usb)+us"
652e393af84SMarius Strobl
65333d3fffaSMarius Strobl20071024:
65433d3fffaSMarius Strobl	It has been decided that it is desirable to provide ABI
65533d3fffaSMarius Strobl	backwards compatibility to the FreeBSD 4/5/6 versions of the
65633d3fffaSMarius Strobl	PCIOCGETCONF, PCIOCREAD and PCIOCWRITE IOCTLs, which was
65733d3fffaSMarius Strobl	broken with the introduction of PCI domain support (see the
65833d3fffaSMarius Strobl	20070930 entry). Unfortunately, this required the ABI of
65933d3fffaSMarius Strobl	PCIOCGETCONF to be broken again in order to be able to
66033d3fffaSMarius Strobl	provide backwards compatibility to the old version of that
66133d3fffaSMarius Strobl	IOCTL. Thus consumers of PCIOCGETCONF have to be recompiled
66233d3fffaSMarius Strobl	again. As for prominent ports this affects neither pciutils
66333d3fffaSMarius Strobl	nor xorg-server this time, the hal port needs to be rebuilt
66433d3fffaSMarius Strobl	however.
66533d3fffaSMarius Strobl
6663d461febSJulian Elischer20071020:
6673d461febSJulian Elischer	The misnamed kthread_create() and friends have been renamed
6683d461febSJulian Elischer	to kproc_create() etc. Many of the callers already
6693d461febSJulian Elischer	used kproc_start()..
6703d461febSJulian Elischer	I will return kthread_create() and friends in a while
6713d461febSJulian Elischer	with implementations that actually create threads, not procs.
6723d461febSJulian Elischer	Renaming corresponds with version 800002.
6733d461febSJulian Elischer
674c15e0967SKen Smith20071010:
675c15e0967SKen Smith	RELENG_7 branched.
676c15e0967SKen Smith
677dbc6a2cfSDavid E. O'Brien20071009:
67865c045e9SDavid E. O'Brien	Setting WITHOUT_LIBPTHREAD now means WITHOUT_LIBKSE and
67965c045e9SDavid E. O'Brien	WITHOUT_LIBTHR are set.
68065c045e9SDavid E. O'Brien
68155aaf894SMarius Strobl20070930:
68255aaf894SMarius Strobl	The PCI code has been made aware of PCI domains. This means that
68355aaf894SMarius Strobl	the location strings as used by pciconf(8) etc are now in the
68455aaf894SMarius Strobl	following format: pci<domain>:<bus>:<device>[:<function>]. It
68555aaf894SMarius Strobl	also means that consumers of <sys/pciio.h> potentially need to
68655aaf894SMarius Strobl	be recompiled; this includes the hal and xorg-server ports.
68755aaf894SMarius Strobl
688c97fe77dSMichael Bushkov20070928:
689c97fe77dSMichael Bushkov	The caching daemon (cached) was renamed to nscd. nscd.conf
690c97fe77dSMichael Bushkov	configuration file should be used instead of cached.conf and
691c97fe77dSMichael Bushkov	nscd_enable, nscd_pidfile and nscd_flags options should be used
692c97fe77dSMichael Bushkov	instead of cached_enable, cached_pidfile and cached_flags in
693c97fe77dSMichael Bushkov	rc.conf.
694c97fe77dSMichael Bushkov
69599f4ae2fSKevin Lo20070921:
69699f4ae2fSKevin Lo	The getfacl(1) utility now prints owning user and group name
69799f4ae2fSKevin Lo	instead of owning uid and gid in the three line comment header.
69899f4ae2fSKevin Lo	This is the same behavior as getfacl(1) on Solaris and Linux.
69999f4ae2fSKevin Lo
700fd954571SGeorge V. Neville-Neil20070704:
701fd954571SGeorge V. Neville-Neil	The new IPsec code is now compiled in using the IPSEC option.  The
702fd954571SGeorge V. Neville-Neil	IPSEC option now requires "device crypto" be defined in your kernel
703fd954571SGeorge V. Neville-Neil	configuration.  The FAST_IPSEC kernel option is now deprecated.
704fd954571SGeorge V. Neville-Neil
705be65697fSMax Laier20070702:
706be65697fSMax Laier	The packet filter (pf) code has been updated to OpenBSD 4.1 Please
707be65697fSMax Laier	note the changed syntax - keep state is now on by default.  Also
708be65697fSMax Laier	note the fact that ftp-proxy(8) has been changed from bottom up and
709be65697fSMax Laier	has been moved from libexec to usr/sbin.  Changes in the ALTQ
710be65697fSMax Laier	handling also affect users of IPFW's ALTQ capabilities.
711be65697fSMax Laier
712069441f7SAndrew Thompson20070701:
7132cb64cb2SGeorge V. Neville-Neil	Remove KAME IPsec in favor of FAST_IPSEC, which is now the
7142cb64cb2SGeorge V. Neville-Neil	only IPsec supported by FreeBSD.  The new IPsec stack
7152cb64cb2SGeorge V. Neville-Neil	supports both IPv4 and IPv6. The kernel option will change
7162cb64cb2SGeorge V. Neville-Neil	after the code changes have settled in.  For now the kernel
7172cb64cb2SGeorge V. Neville-Neil	option IPSEC is deprecated and FAST_IPSEC is the only option, that
7182cb64cb2SGeorge V. Neville-Neil	will change after some settling time.
7192cb64cb2SGeorge V. Neville-Neil
7202cb64cb2SGeorge V. Neville-Neil20070701:
721069441f7SAndrew Thompson	The wicontrol(8) utility has been removed from the base system. wi(4)
722069441f7SAndrew Thompson	cards should be configured using ifconfig(8), see the man page for more
723069441f7SAndrew Thompson	information.
724069441f7SAndrew Thompson
725628e65ecSPyun YongHyeon20070612:
72653ffeb8eSPyun YongHyeon	The i386/amd64 GENERIC kernel now defaults to the nfe(4) driver
72753ffeb8eSPyun YongHyeon	instead of the nve(4) driver. Please update your configuration
72853ffeb8eSPyun YongHyeon	accordingly.
72953ffeb8eSPyun YongHyeon
73071498f30SBruce M Simpson20070612:
7312bc2025cSGregory Neil Shapiro	By default, /etc/rc.d/sendmail no longer rebuilds the aliases
7322bc2025cSGregory Neil Shapiro	database if it is missing or older than the aliases file.  If
7332bc2025cSGregory Neil Shapiro	desired, set the new rc.conf option sendmail_rebuild_aliases
7342bc2025cSGregory Neil Shapiro	to "YES" to restore that functionality.
7352bc2025cSGregory Neil Shapiro
7362bc2025cSGregory Neil Shapiro20070612:
73771498f30SBruce M Simpson	The IPv4 multicast socket code has been considerably modified, and
73871498f30SBruce M Simpson	moved to the file sys/netinet/in_mcast.c. Initial support for the
73971498f30SBruce M Simpson	RFC 3678 Source-Specific Multicast Socket API has been added to
74071498f30SBruce M Simpson	the IPv4 network stack.
74171498f30SBruce M Simpson
74271498f30SBruce M Simpson	Strict multicast and broadcast reception is now the default for
74371498f30SBruce M Simpson	UDP/IPv4 sockets; the net.inet.udp.strict_mcast_mship sysctl variable
74471498f30SBruce M Simpson	has now been removed.
74571498f30SBruce M Simpson
74671498f30SBruce M Simpson	The RFC 1724 hack for interface selection has been removed; the use
74771498f30SBruce M Simpson	of the Linux-derived ip_mreqn structure with IP_MULTICAST_IF has
74871498f30SBruce M Simpson	been added to replace it. Consumers such as routed will soon be
74971498f30SBruce M Simpson	updated to reflect this.
75071498f30SBruce M Simpson
75171498f30SBruce M Simpson	These changes affect users who are running routed(8) or rdisc(8)
75271498f30SBruce M Simpson	from the FreeBSD base system on point-to-point or unnumbered
75371498f30SBruce M Simpson	interfaces.
75471498f30SBruce M Simpson
7559cd40e64SYaroslav Tykhiy20070610:
756e8aff090SSam Leffler	The net80211 layer has changed significantly and all wireless
757e8aff090SSam Leffler	drivers that depend on it need to be recompiled.  Further these
758e8aff090SSam Leffler	changes require that any program that interacts with the wireless
759e8aff090SSam Leffler	support in the kernel be recompiled; this includes: ifconfig,
760e8aff090SSam Leffler	wpa_supplicant, hostapd, and wlanstats.  Users must also, for
761e8aff090SSam Leffler	the moment, kldload the wlan_scan_sta and/or wlan_scan_ap modules
762e8aff090SSam Leffler	if they use modules for wireless support.  These modules implement
763e8aff090SSam Leffler	scanning support for station and ap modes, respectively.  Failure
764e8aff090SSam Leffler	to load the appropriate module before marking a wireless interface
765e8aff090SSam Leffler	up will result in a message to the console and the device not
766e8aff090SSam Leffler	operating properly.
767e8aff090SSam Leffler
768e8aff090SSam Leffler20070610:
7699cd40e64SYaroslav Tykhiy	The pam_nologin(8) module ceases to provide an authentication
7709cd40e64SYaroslav Tykhiy	function and starts providing an account management function.
7719cd40e64SYaroslav Tykhiy	Consequent changes to /etc/pam.d should be brought in using
7729cd40e64SYaroslav Tykhiy	mergemaster(8).  Third-party files in /usr/local/etc/pam.d may
7739cd40e64SYaroslav Tykhiy	need manual editing as follows.  Locate this line (or similar):
7749cd40e64SYaroslav Tykhiy
7759cd40e64SYaroslav Tykhiy		auth	required	pam_nologin.so	no_warn
7769cd40e64SYaroslav Tykhiy
7779cd40e64SYaroslav Tykhiy	and change it according to this example:
7789cd40e64SYaroslav Tykhiy
7799cd40e64SYaroslav Tykhiy		account	required	pam_nologin.so	no_warn
7809cd40e64SYaroslav Tykhiy
7819cd40e64SYaroslav Tykhiy	That is, the first word needs to be changed from "auth" to
7829cd40e64SYaroslav Tykhiy	"account".  The new line can be moved to the account section
7839cd40e64SYaroslav Tykhiy	within the file for clarity.  Not updating pam.conf(5) files
7849cd40e64SYaroslav Tykhiy	will result in nologin(5) ignored by the respective services.
7859cd40e64SYaroslav Tykhiy
786995c7fd1SYaroslav Tykhiy20070529:
787995c7fd1SYaroslav Tykhiy	The ether_ioctl() function has been synchronized with ioctl(2)
788995c7fd1SYaroslav Tykhiy	and ifnet.if_ioctl.  Due to that, the size of one of its arguments
789995c7fd1SYaroslav Tykhiy	has changed on 64-bit architectures.  All kernel modules using
790995c7fd1SYaroslav Tykhiy	ether_ioctl() need to be rebuilt on such architectures.
791995c7fd1SYaroslav Tykhiy
792332fd25cSWojciech A. Koszek20070516:
793332fd25cSWojciech A. Koszek	Improved INCLUDE_CONFIG_FILE support has been introduced to the
794332fd25cSWojciech A. Koszek	config(8) utility. In order to take advantage of this new
795332fd25cSWojciech A. Koszek	functionality, you are expected to recompile and install
796332fd25cSWojciech A. Koszek	src/usr.sbin/config. If you don't rebuild config(8), and your
797332fd25cSWojciech A. Koszek	kernel configuration depends on INCLUDE_CONFIG_FILE, the kernel
798332fd25cSWojciech A. Koszek	build will be broken because of a missing "kernconfstring"
799332fd25cSWojciech A. Koszek	symbol.
800332fd25cSWojciech A. Koszek
801c4bc02eaSDaniel Eischen20070513:
802c4bc02eaSDaniel Eischen	Symbol versioning is enabled by default.  To disable it, use
803c4bc02eaSDaniel Eischen	option WITHOUT_SYMVER.  It is not advisable to attempt to
804c4bc02eaSDaniel Eischen	disable symbol versioning once it is enabled; your installworld
805c4bc02eaSDaniel Eischen	will break because a symbol version-less libc will get installed
806c4bc02eaSDaniel Eischen	before the install tools.  As a result, the old install tools,
807c4bc02eaSDaniel Eischen	which previously had symbol dependencies to FBSD_1.0, will fail
808c4bc02eaSDaniel Eischen	because the freshly installed libc will not have them.
809c4bc02eaSDaniel Eischen
81065c045e9SDavid E. O'Brien	The default threading library (providing "libpthread") has been
81165c045e9SDavid E. O'Brien	changed to libthr.  If you wish to have libkse as your default,
81265c045e9SDavid E. O'Brien	use option DEFAULT_THREAD_LIB=libkse for the buildworld.
813c4bc02eaSDaniel Eischen
814a69c10f5SGregory Neil Shapiro20070423:
815a69c10f5SGregory Neil Shapiro	The ABI breakage in sendmail(8)'s libmilter has been repaired
816a69c10f5SGregory Neil Shapiro	so it is no longer necessary to recompile mail filters (aka,
817a69c10f5SGregory Neil Shapiro	milters).  If you recompiled mail filters after the 20070408
818a69c10f5SGregory Neil Shapiro	note, it is not necessary to recompile them again.
819a69c10f5SGregory Neil Shapiro
8201a19fe2aSAndrew Thompson20070417:
8211a19fe2aSAndrew Thompson	The new trunk(4) driver has been renamed to lagg(4) as it better
8221a19fe2aSAndrew Thompson	reflects its purpose. ifconfig will need to be recompiled.
8231a19fe2aSAndrew Thompson
824ac01a4c6SGregory Neil Shapiro20070408:
825ac01a4c6SGregory Neil Shapiro	sendmail(8) has been updated to version 8.14.1.  Mail filters
826ac01a4c6SGregory Neil Shapiro	(aka, milters) compiled against the libmilter included in the
827ac01a4c6SGregory Neil Shapiro	base operating system should be recompiled.
828ac01a4c6SGregory Neil Shapiro
829d08ec007SFlorent Thoumie20070302:
830d08ec007SFlorent Thoumie	Firmwares for ipw(4) and iwi(4) are now included in the base tree.
831d08ec007SFlorent Thoumie	In order to use them one must agree to the respective LICENSE in
832329d3aa3SChristian Brueffer	share/doc/legal and define legal.intel_<name>.license_ack=1 via
833bc42e3d0SMax Laier	loader.conf(5) or kenv(1).  Make sure to deinstall the now
834bc42e3d0SMax Laier	deprecated modules from the respective firmware ports.
835d08ec007SFlorent Thoumie
83680a65301SBruce M Simpson20070228:
83780a65301SBruce M Simpson	The name resolution/mapping functions addr2ascii(3) and ascii2addr(3)
83880a65301SBruce M Simpson	were removed from FreeBSD's libc. These originally came from INRIA
83980a65301SBruce M Simpson	IPv6. Nothing in FreeBSD ever used them. They may be regarded as
84080a65301SBruce M Simpson	deprecated in previous releases.
84180a65301SBruce M Simpson	The AF_LINK support for getnameinfo(3) was merged from NetBSD to
84280a65301SBruce M Simpson	replace it as a more portable (and re-entrant) API.
84380a65301SBruce M Simpson
84408bc2d8aSBruce M Simpson20070224:
845663829feSPaolo Pisati	To support interrupt filtering a modification to the newbus API
84682e5a028SPaolo Pisati	has occurred, ABI was broken and __FreeBSD_version was bumped
84782e5a028SPaolo Pisati	to 700031. Please make sure that your kernel and modules are in
848eb29c8f4SSimon L. B. Nielsen	sync. For more info:
849eb29c8f4SSimon L. B. Nielsen	http://docs.freebsd.org/cgi/mid.cgi?20070221233124.GA13941
850663829feSPaolo Pisati
851663829feSPaolo Pisati20070224:
85208bc2d8aSBruce M Simpson	The IPv6 multicast forwarding code may now be loaded into GENERIC
85333672cd9SBruce M Simpson	kernels by loading the ip_mroute.ko module. This is built into the
85433672cd9SBruce M Simpson	module unless WITHOUT_INET6 or WITHOUT_INET6_SUPPORT options are
85533672cd9SBruce M Simpson	set; see src.conf(5) for more information.
85608bc2d8aSBruce M Simpson
857d092c06cSBruce M Simpson20070214:
858d092c06cSBruce M Simpson	The output of netstat -r has changed. Without -n, we now only
859d092c06cSBruce M Simpson	print a "network name" without the prefix length if the network
860d092c06cSBruce M Simpson	address and mask exactly match a Class A/B/C network, and an entry
861d092c06cSBruce M Simpson	exists in the nsswitch "networks" map.
862d092c06cSBruce M Simpson	With -n, we print the full unabbreviated CIDR network prefix in
863d092c06cSBruce M Simpson	the form "a.b.c.d/p". 0.0.0.0/0 is always printed as "default".
864d092c06cSBruce M Simpson	This change is in preparation for changes such as equal-cost
865d092c06cSBruce M Simpson	multipath, and to more generally assist operational deployment
866d092c06cSBruce M Simpson	of FreeBSD as a modern IPv4 router.
867d092c06cSBruce M Simpson
8680948f0a2SBruce M Simpson20070210:
8690948f0a2SBruce M Simpson	PIM has been turned on by default in the IPv4 multicast
8700948f0a2SBruce M Simpson	routing code. The kernel option 'PIM' has now been removed.
8710948f0a2SBruce M Simpson	PIM is now built by default if option 'MROUTING' is specified.
8720948f0a2SBruce M Simpson	It may now be loaded into GENERIC kernels by loading the
8730948f0a2SBruce M Simpson	ip_mroute.ko module.
8740948f0a2SBruce M Simpson
87578cb087eSBruce M Simpson20070207:
87678cb087eSBruce M Simpson	Support for IPIP tunnels (VIFF_TUNNEL) in IPv4 multicast routing
87778cb087eSBruce M Simpson	has been removed. Its functionality may be achieved by explicitly
87878cb087eSBruce M Simpson	configuring gif(4) interfaces and using the 'phyint' keyword in
87978cb087eSBruce M Simpson	mrouted.conf.
88078cb087eSBruce M Simpson	XORP does not support source-routed IPv4 multicast tunnels nor the
88178cb087eSBruce M Simpson	integrated IPIP tunneling, therefore it is not affected by this
88278cb087eSBruce M Simpson	change. The __FreeBSD_version macro has been bumped to 700030.
88378cb087eSBruce M Simpson
884067c6db2SJohn Polstra20061221:
885067c6db2SJohn Polstra	Support for PCI Message Signalled Interrupts has been
886067c6db2SJohn Polstra	re-enabled in the bge driver, only for those chips which are
887067c6db2SJohn Polstra	believed to support it properly.  If there are any problems,
888067c6db2SJohn Polstra	MSI can be disabled completely by setting the
889067c6db2SJohn Polstra	'hw.pci.enable_msi' and 'hw.pci.enable_msix' tunables to 0
890067c6db2SJohn Polstra	in the loader.
891067c6db2SJohn Polstra
8923ebdb4eeSJohn Polstra20061214:
893cca510b1SJohn Polstra	Support for PCI Message Signalled Interrupts has been
894cca510b1SJohn Polstra	disabled again in the bge driver.  Many revisions of the
895cca510b1SJohn Polstra	hardware fail to support it properly.  Support can be
896cca510b1SJohn Polstra	re-enabled by removing the #define of BGE_DISABLE_MSI in
897cca510b1SJohn Polstra	"src/sys/dev/bge/if_bge.c".
898cca510b1SJohn Polstra
899cca510b1SJohn Polstra20061214:
9003ebdb4eeSJohn Polstra	Support for PCI Message Signalled Interrupts has been added
9013ebdb4eeSJohn Polstra	to the bge driver.  If there are any problems, MSI can be
9023ebdb4eeSJohn Polstra	disabled completely by setting the 'hw.pci.enable_msi' and
9033ebdb4eeSJohn Polstra	'hw.pci.enable_msix' tunables to 0 in the loader.
9043ebdb4eeSJohn Polstra
905fc19e4c4SJulian Elischer20061205:
906fc19e4c4SJulian Elischer	The removal of several facets of the experimental Threading
907fc19e4c4SJulian Elischer	system from the kernel means that the proc and thread structures
908fc19e4c4SJulian Elischer	have changed quite a bit. I suggest all kernel modules that might
909fc19e4c4SJulian Elischer	reference these structures be recompiled.. Especially the
910fc19e4c4SJulian Elischer	linux module.
911fc19e4c4SJulian Elischer
912a580b31aSAriff Abdullah20061126:
913a580b31aSAriff Abdullah	Sound infrastructure has been updated with various fixes and
914a580b31aSAriff Abdullah	improvements. Most of the changes are pretty much transparent,
915a580b31aSAriff Abdullah	with exceptions of followings:
916a580b31aSAriff Abdullah	1) All sound driver specific sysctls (hw.snd.pcm%d.*) have been
917a580b31aSAriff Abdullah	   moved to their own dev sysctl nodes, for example:
918a580b31aSAriff Abdullah		hw.snd.pcm0.vchans -> dev.pcm.0.vchans
919a580b31aSAriff Abdullah	2) /dev/dspr%d.%d has been deprecated. Each channel now has its
920a580b31aSAriff Abdullah	   own chardev in the form of "dsp%d.<function>%d", where <function>
921a580b31aSAriff Abdullah	   is p = playback, r = record and v = virtual, respectively. Users
922a580b31aSAriff Abdullah	   are encouraged to use these devs instead of (old) "/dev/dsp%d.%d".
923a580b31aSAriff Abdullah	   This does not affect those who are using "/dev/dsp".
924a580b31aSAriff Abdullah
925a484c95aSCraig Rodrigues20061122:
926b5db8ef0SRemko Lodder	geom(4)'s gmirror(8) class metadata structure has been
927b5db8ef0SRemko Lodder	rev'd from v3 to v4. If you update across this point and
928b5db8ef0SRemko Lodder	your metadata is converted for you, you will not be easily
929b5db8ef0SRemko Lodder	able to downgrade since the /boot/kernel.old/geom_mirror.ko
930b5db8ef0SRemko Lodder	kernel module will be unable to read the v4 metadata.  You
931b5db8ef0SRemko Lodder	can resolve this by doing from the loader(8) prompt:
932b5db8ef0SRemko Lodder
933b5db8ef0SRemko Lodder		set vfs.root.mountfrom="ufs:/dev/XXX"
934b5db8ef0SRemko Lodder
935b5db8ef0SRemko Lodder	where XXX is the root slice of one of the disks that composed
93603efdfd1SRemko Lodder	the mirror (i.e.: /dev/ad0s1a). You can then rebuild
937b5db8ef0SRemko Lodder	the array the same way you built it originally.
938b5db8ef0SRemko Lodder
939b5db8ef0SRemko Lodder20061122:
940a484c95aSCraig Rodrigues	The following binaries have been disconnected from the build:
941a484c95aSCraig Rodrigues	mount_devfs, mount_ext2fs, mount_fdescfs, mount_procfs, mount_linprocfs,
942a484c95aSCraig Rodrigues	and mount_std.  The functionality of these programs has been
943a484c95aSCraig Rodrigues	moved into the mount program.  For example, to mount a devfs
944a484c95aSCraig Rodrigues	filesystem, instead of using mount_devfs, use: "mount -t devfs".
945a484c95aSCraig Rodrigues	This does not affect entries in /etc/fstab, since entries in
946a484c95aSCraig Rodrigues	/etc/fstab are always processed with "mount -t fstype".
947a484c95aSCraig Rodrigues
9481d7e99caSJohn Baldwin20061113:
9491d7e99caSJohn Baldwin	Support for PCI Message Signalled Interrupts on i386 and amd64
9501d7e99caSJohn Baldwin	has been added to the kernel and various drivers will soon be
9511d7e99caSJohn Baldwin	updated to use MSI when it is available.  If there are any problems,
9521d7e99caSJohn Baldwin	MSI can be disabled completely by setting the 'hw.pci.enable_msi'
9531d7e99caSJohn Baldwin	and 'hw.pci.enable_msix' tunables to 0 in the loader.
9541d7e99caSJohn Baldwin
9557c0435b9SKip Macy20061110:
9567c0435b9SKip Macy	The MUTEX_PROFILING option has been renamed to LOCK_PROFILING.
9577c0435b9SKip Macy	The lockmgr object layout has been changed as a result of having
9587c0435b9SKip Macy	a lock_object embedded in it. As a consequence all file system
9597c0435b9SKip Macy	kernel modules must be re-compiled. The mutex profiling man page
9607c0435b9SKip Macy	has not yet been updated to reflect this change.
961c1f61aa9SDavid E. O'Brien
962013d6d8cSJohn Birrell20061026:
9638460a577SJohn Birrell	KSE in the kernel has now been made optional and turned on by
964013d6d8cSJohn Birrell	default. Use 'nooption KSE' in your kernel config to turn it
965013d6d8cSJohn Birrell	off. All kernel modules *must* be recompiled after this change.
966013d6d8cSJohn Birrell	There-after, modules from a KSE kernel should be compatible with
967013d6d8cSJohn Birrell	modules from a NOKSE kernel due to the temporary padding fields
968013d6d8cSJohn Birrell	added to 'struct proc'.
9698460a577SJohn Birrell
97013b3ebf1SBruce M Simpson20060929:
97113b3ebf1SBruce M Simpson	mrouted and its utilities have been removed from the base system.
97213b3ebf1SBruce M Simpson
973014a1a84SRuslan Ermilov20060927:
974014a1a84SRuslan Ermilov	Some ioctl(2) command codes have changed.  Full backward ABI
975014a1a84SRuslan Ermilov	compatibility is provided if the "options COMPAT_FREEBSD6" is
976014a1a84SRuslan Ermilov	present in the kernel configuration file.  Make sure to add
977014a1a84SRuslan Ermilov	this option to your kernel config file, or recompile X.Org
978014a1a84SRuslan Ermilov	and the rest of ports; otherwise they may refuse to work.
979014a1a84SRuslan Ermilov
980481544f3SBruce M Simpson20060924:
981481544f3SBruce M Simpson	tcpslice has been removed from the base system.
982481544f3SBruce M Simpson
98360206edeSRuslan Ermilov20060913:
98460206edeSRuslan Ermilov	The sizes of struct tcpcb (and struct xtcpcb) have changed due to
98560206edeSRuslan Ermilov	the rewrite of TCP syncookies.  Tools like netstat, sockstat, and
98660206edeSRuslan Ermilov	systat needs to be rebuilt.
98760206edeSRuslan Ermilov
98850bdd720SSam Leffler20060903:
98950bdd720SSam Leffler	libpcap updated to v0.9.4 and tcpdump to v3.9.4
99050bdd720SSam Leffler
9913b4109aaSJulian Elischer20060816:
9923b4109aaSJulian Elischer	The IPFIREWALL_FORWARD_EXTENDED option is gone and the behaviour
9935f738ae6SMaxim Konovalov	for IPFIREWALL_FORWARD is now as it was before when it was first
9943b4109aaSJulian Elischer	committed and for years after. The behaviour is now ON.
9953b4109aaSJulian Elischer
996c8450a54SJung-uk Kim20060725:
997c8450a54SJung-uk Kim	enigma(1)/crypt(1) utility has been changed on 64 bit architectures.
998c8450a54SJung-uk Kim	Now it can decrypt files created from different architectures.
999c8450a54SJung-uk Kim	Unfortunately, it is no longer able to decrypt a cipher text
1000c8450a54SJung-uk Kim	generated with an older version on 64 bit architectures.
1001c8450a54SJung-uk Kim	If you have such a file, you need old utility to decrypt it.
1002c8450a54SJung-uk Kim
10035d0c7501SThomas Wintergerst20060709:
10045d0c7501SThomas Wintergerst	The interface version of the i4b kernel part has changed. So
10055d0c7501SThomas Wintergerst	after updating the kernel sources and compiling a new kernel,
10065d0c7501SThomas Wintergerst	the i4b user space tools in "/usr/src/usr.sbin/i4b" must also
10075d0c7501SThomas Wintergerst	be rebuilt, and vice versa.
10085d0c7501SThomas Wintergerst
100944a8277bSRink Springer20060627:
101044a8277bSRink Springer	The XBOX kernel now defaults to the nfe(4) driver instead of
101144a8277bSRink Springer	the nve(4) driver. Please update your configuration
101244a8277bSRink Springer	accordingly.
101344a8277bSRink Springer
1014647ef1a9SMarius Strobl20060514:
1015647ef1a9SMarius Strobl	The i386-only lnc(4) driver for the AMD Am7900 LANCE and Am79C9xx
1016647ef1a9SMarius Strobl	PCnet family of NICs has been removed. The new le(4) driver serves
1017647ef1a9SMarius Strobl	as an equivalent but cross-platform replacement with the pcn(4)
1018647ef1a9SMarius Strobl	driver still providing performance-optimized support for the subset
1019647ef1a9SMarius Strobl	of AMD Am79C971 PCnet-FAST and greater chips as before.
1020647ef1a9SMarius Strobl
10219f8d2f6cSGiorgos Keramidas20060511:
10229f8d2f6cSGiorgos Keramidas	The machdep.* sysctls and the adjkerntz utility have been
10239f8d2f6cSGiorgos Keramidas	modified a bit.  The new adjkerntz utility uses the new
10249f8d2f6cSGiorgos Keramidas	sysctl names and sysctlbyname() calls, so it may be impossible
10259f8d2f6cSGiorgos Keramidas	to run an old /sbin/adjkerntz utility in single-user mode
10269f8d2f6cSGiorgos Keramidas	with a new kernel.  Replace the `adjkerntz -i' step before
10279f8d2f6cSGiorgos Keramidas	`make installworld' with:
10289f8d2f6cSGiorgos Keramidas
10299f8d2f6cSGiorgos Keramidas	    /usr/obj/usr/src/sbin/adjkerntz/adjkerntz -i
10309f8d2f6cSGiorgos Keramidas
10319f8d2f6cSGiorgos Keramidas	and proceed as usual with the rest of the installworld-stage
10329f8d2f6cSGiorgos Keramidas	steps.  Otherwise, you risk installing binaries with their
10339f8d2f6cSGiorgos Keramidas	timestamp set several hours in the future, especially if
10349f8d2f6cSGiorgos Keramidas	you are running with local time set to GMT+X hours.
10359f8d2f6cSGiorgos Keramidas
1036a0a9755eSMax Laier20060412:
1037a0a9755eSMax Laier	The ip6fw utility has been removed.  The behavior provided by
1038a0a9755eSMax Laier	ip6fw has been in ipfw2 for a good while and the rc.d scripts
10394919094eSChristian Brueffer	have been updated to deal with it.  There are some rules that
1040a0a9755eSMax Laier	might not migrate cleanly.  Use rc.firewall6 as a template to
1041a0a9755eSMax Laier	rewrite rules.
1042a0a9755eSMax Laier
1043ff6a2d00SMarcel Moolenaar20060428:
1044ff6a2d00SMarcel Moolenaar	The puc(4) driver has been overhauled. The ebus(4) and sbus(4)
1045ff6a2d00SMarcel Moolenaar	attachments have been removed. Make sure to configure scc(4)
1046ff6a2d00SMarcel Moolenaar	on sparc64. Note also that by default puc(4) will use uart(4)
1047ff6a2d00SMarcel Moolenaar	and not sio(4) for serial ports because interrupt handling has
1048ff6a2d00SMarcel Moolenaar	been optimized for multi-port serial cards and only uart(4)
1049ff6a2d00SMarcel Moolenaar	implements the interface to support it.
1050ff6a2d00SMarcel Moolenaar
1051ff6a2d00SMarcel Moolenaar20060330:
1052ff6a2d00SMarcel Moolenaar	The scc(4) driver replaces puc(4) for Serial Communications
1053ff6a2d00SMarcel Moolenaar	Controllers (SCCs) like the Siemens SAB82532 and the Zilog
1054ff6a2d00SMarcel Moolenaar	Z8530. On sparc64, it is advised to add scc(4) to the kernel
1055ff6a2d00SMarcel Moolenaar	configuration to make sure that the serial ports remain
1056ff6a2d00SMarcel Moolenaar	functional.
1057ff6a2d00SMarcel Moolenaar
1058c60fab8cSRuslan Ermilov20060317:
1059c60fab8cSRuslan Ermilov	Most world/kernel related NO_* build options changed names.
1060c60fab8cSRuslan Ermilov	New knobs have common prefixes WITHOUT_*/WITH_* (modelled
1061c60fab8cSRuslan Ermilov	after FreeBSD ports) and should be set in /etc/src.conf
1062c60fab8cSRuslan Ermilov	(the src.conf(5) manpage is provided).  Full backwards
1063c60fab8cSRuslan Ermilov	compatibility is maintained for the time being though it's
1064c60fab8cSRuslan Ermilov	highly recommended to start moving old options out of the
1065c60fab8cSRuslan Ermilov	system-wide /etc/make.conf file into the new /etc/src.conf
1066c60fab8cSRuslan Ermilov	while also properly renaming them.  More conversions will
1067c60fab8cSRuslan Ermilov	likely follow.  Posting to current@:
1068c60fab8cSRuslan Ermilov
1069c60fab8cSRuslan Ermilov	http://lists.freebsd.org/pipermail/freebsd-current/2006-March/061725.html
1070c60fab8cSRuslan Ermilov
10718d96e455SYaroslav Tykhiy20060305:
10728d96e455SYaroslav Tykhiy	The NETSMBCRYPTO kernel option has been retired because its
10738d96e455SYaroslav Tykhiy	functionality is always included in NETSMB and smbfs.ko now.
10748d96e455SYaroslav Tykhiy
1075375ce679SYaroslav Tykhiy20060303:
1076375ce679SYaroslav Tykhiy	The TDFX_LINUX kernel option was retired and replaced by the
107705ab391fSYaroslav Tykhiy	tdfx_linux device.  The latter can be loaded as the 3dfx_linux.ko
107805ab391fSYaroslav Tykhiy	kernel module.  Loading it alone should suffice to get 3dfx support
107905ab391fSYaroslav Tykhiy	for Linux apps because it will pull in 3dfx.ko and linux.ko through
108005ab391fSYaroslav Tykhiy	its dependencies.
1081375ce679SYaroslav Tykhiy
108219dc3462SWarner Losh20060204:
108319dc3462SWarner Losh	The 'audit' group was added to support the new auditing functionality
108419dc3462SWarner Losh	in the base system.  Be sure to follow the directions for updating,
108519dc3462SWarner Losh	including the requirement to run mergemaster -p.
108619dc3462SWarner Losh
1087dc422d87SYaroslav Tykhiy20060201:
1088dc422d87SYaroslav Tykhiy	The kernel ABI to file system modules was changed on i386.
1089dc422d87SYaroslav Tykhiy	Please make sure that your kernel and modules are in sync.
1090dc422d87SYaroslav Tykhiy
1091347daa0fSJulian Elischer20060118:
1092347daa0fSJulian Elischer	This actually occured some time ago, but installing the kernel
1093347daa0fSJulian Elischer	now also installs a bunch of symbol files for the kernel modules.
10946aa6311fSPav Lucistnik	This increases the size of /boot/kernel to about 67Mbytes. You
1095347daa0fSJulian Elischer	will need twice this if you will eventually back this up to kernel.old
1096347daa0fSJulian Elischer	on your next install.
1097347daa0fSJulian Elischer	If you have a shortage of room in your root partition, you should add
1098347daa0fSJulian Elischer	-DINSTALL_NODEBUG to your make arguments or add INSTALL_NODEBUG="yes"
1099347daa0fSJulian Elischer	to your /etc/make.conf.
1100347daa0fSJulian Elischer
1101cc61a0b1SJason Evans20060113:
1102cc61a0b1SJason Evans	libc's malloc implementation has been replaced.  This change has the
1103cc61a0b1SJason Evans	potential to uncover application bugs that previously went unnoticed.
1104cc61a0b1SJason Evans	See the malloc(3) manual page for more details.
1105cc61a0b1SJason Evans
11067f4faad8SGleb Smirnoff20060112:
11077f4faad8SGleb Smirnoff	The generic netgraph(4) cookie has been changed. If you upgrade
11087f4faad8SGleb Smirnoff	kernel passing this point, you also need to upgrade userland
11097f4faad8SGleb Smirnoff	and netgraph(4) utilities like ports/net/mpd or ports/net/mpd4.
11107f4faad8SGleb Smirnoff
11116bed9d9eSJohn Baldwin20060106:
111290482dafSJohn Baldwin	si(4)'s device files now contain the unit number.
111390482dafSJohn Baldwin	Uses of {cua,tty}A[0-9a-f] should be replaced by {cua,tty}A0[0-9a-f].
111490482dafSJohn Baldwin
111590482dafSJohn Baldwin20060106:
11166bed9d9eSJohn Baldwin	The kernel ABI was mostly destroyed due to a change in the size
11176bed9d9eSJohn Baldwin	of struct lock_object which is nested in other structures such
11186bed9d9eSJohn Baldwin	as mutexes which are nested in all sorts of other structures.
11196bed9d9eSJohn Baldwin	Make sure your kernel and modules are in sync.
11206bed9d9eSJohn Baldwin
112152a16db3SAlexander Leidinger20051231:
112252a16db3SAlexander Leidinger	The page coloring algorithm in the VM subsystem was converted
112352a16db3SAlexander Leidinger	from tuning with kernel options to autotuning. Please remove
112452a16db3SAlexander Leidinger	any PQ_* option except PQ_NOOPT from your kernel config.
112552a16db3SAlexander Leidinger
11266dba929aSSam Leffler20051211:
11276dba929aSSam Leffler	The net80211-related tools in the tools/tools/ath directory
11286dba929aSSam Leffler	have been moved to tools/tools/net80211 and renamed with a
11296dba929aSSam Leffler	"wlan" prefix.  Scripts that use them should be adjusted
11306dba929aSSam Leffler	accordingly.
11316dba929aSSam Leffler
1132a0cdeaecSDoug Barton20051202:
1133a0cdeaecSDoug Barton	Scripts in the local_startup directories (as defined in
1134a0cdeaecSDoug Barton	/etc/defaults/rc.conf) that have the new rc.d semantics will
1135a0cdeaecSDoug Barton	now be run as part of the base system rcorder. If there are
1136a0cdeaecSDoug Barton	errors or problems with one of these local scripts, it could
1137a0cdeaecSDoug Barton	cause boot problems. If you encounter such problems, boot in
1138a0cdeaecSDoug Barton	single user mode, remove that script from the */rc.d directory.
1139a0cdeaecSDoug Barton	Please report the problem to the port's maintainer, and the
1140a0cdeaecSDoug Barton	freebsd-ports@freebsd.org mailing list.
1141a0cdeaecSDoug Barton
1142b090e4ceSGleb Smirnoff20051129:
1143a358ddbbSCraig Rodrigues	The nodev mount option was deprecated in RELENG_6 (where it
1144a358ddbbSCraig Rodrigues	was a no-op), and is now unsupported.  If you have nodev or dev listed
1145a358ddbbSCraig Rodrigues	in /etc/fstab, remove it, otherwise it will result in a mount error.
1146a358ddbbSCraig Rodrigues
1147a358ddbbSCraig Rodrigues20051129:
1148b090e4ceSGleb Smirnoff	ABI between ipfw(4) and ipfw(8) has been changed. You need
1149b090e4ceSGleb Smirnoff	to rebuild ipfw(8) when rebuilding kernel.
1150b090e4ceSGleb Smirnoff
1151d6b4b3b3SDavid E. O'Brien20051108:
1152d6b4b3b3SDavid E. O'Brien	rp(4)'s device files now contain the unit number.
1153d6b4b3b3SDavid E. O'Brien	Uses of {cua,tty}R[0-9a-f] should be replaced by {cua,tty}R0[0-9a-f].
1154d6b4b3b3SDavid E. O'Brien
1155a52364d5SYaroslav Tykhiy20051029:
1156a52364d5SYaroslav Tykhiy	/etc/rc.d/ppp-user has been renamed to /etc/rc.d/ppp.
1157a52364d5SYaroslav Tykhiy	Its /etc/rc.conf.d configuration file has been `ppp' from
1158a52364d5SYaroslav Tykhiy	the beginning, and hence there is no need to touch it.
1159a52364d5SYaroslav Tykhiy
1160fc18f73dSYaroslav Tykhiy20051014:
1161fc18f73dSYaroslav Tykhiy	Now most modules get their build-time options from the kernel
1162fc18f73dSYaroslav Tykhiy	configuration file.  A few modules still have fixed options
1163fc18f73dSYaroslav Tykhiy	due to their non-conformant implementation, but they will be
1164fc18f73dSYaroslav Tykhiy	corrected eventually.  You may need to review the options of
1165fc18f73dSYaroslav Tykhiy	the modules in use, explicitly specify the non-default options
1166fc18f73dSYaroslav Tykhiy	in the kernel configuration file, and rebuild the kernel and
1167fc18f73dSYaroslav Tykhiy	modules afterwards.
1168fc18f73dSYaroslav Tykhiy
1169114d09d8SGleb Smirnoff20051001:
1170114d09d8SGleb Smirnoff	kern.polling.enable sysctl MIB is now deprecated. Use ifconfig(8)
1171114d09d8SGleb Smirnoff	to turn polling(4) on your interfaces.
1172114d09d8SGleb Smirnoff
1173b6de9e91SMax Laier20050927:
1174b6de9e91SMax Laier	The old bridge(4) implementation was retired.  The new
1175b6de9e91SMax Laier	if_bridge(4) serves as a full functional replacement.
1176b6de9e91SMax Laier
1177bb518265SHajimu UMEMOTO20050722:
1178bb518265SHajimu UMEMOTO	The ai_addrlen of a struct addrinfo was changed to a socklen_t
1179bb518265SHajimu UMEMOTO	to conform to POSIX-2001.  This change broke an ABI
1180bb518265SHajimu UMEMOTO	compatibility on 64 bit architecture.  You have to recompile
1181bb518265SHajimu UMEMOTO	userland programs that use getaddrinfo(3) on 64 bit
1182bb518265SHajimu UMEMOTO	architecture.
1183bb518265SHajimu UMEMOTO
118499b22782SKen Smith20050711:
118599b22782SKen Smith	RELENG_6 branched here.
118699b22782SKen Smith
11877657f595SBrooks Davis20050629:
11887657f595SBrooks Davis	The pccard_ifconfig rc.conf variable has been removed and a new
11897657f595SBrooks Davis	variable, ifconfig_DEFAULT has been introduced.  Unlike
11907657f595SBrooks Davis	pccard_ifconfig, ifconfig_DEFAULT applies to ALL interfaces that
11917657f595SBrooks Davis	do not have ifconfig_ifn entries rather than just those in
11927657f595SBrooks Davis	removable_interfaces.
11937657f595SBrooks Davis
1194d33db00cSDag-Erling Smørgrav20050616:
1195d33db00cSDag-Erling Smørgrav	Some previous versions of PAM have permitted the use of
1196d33db00cSDag-Erling Smørgrav	non-absolute paths in /etc/pam.conf or /etc/pam.d/* when referring
1197d33db00cSDag-Erling Smørgrav	to third party PAM modules in /usr/local/lib.  A change has been
1198d33db00cSDag-Erling Smørgrav	made to require the use of absolute paths in order to avoid
1199d33db00cSDag-Erling Smørgrav	ambiguity and dependence on library path configuration, which may
1200d33db00cSDag-Erling Smørgrav	affect existing configurations.
1201d33db00cSDag-Erling Smørgrav
1202ad0fdce5SBrooks Davis20050610:
1203ad0fdce5SBrooks Davis	Major changes to network interface API.  All drivers must be
1204ad0fdce5SBrooks Davis	recompiled.  Drivers not in the base system will need to be
1205ad0fdce5SBrooks Davis	updated to the new APIs.
1206ad0fdce5SBrooks Davis
1207038164a1SGarance A Drosehn20050609:
1208038164a1SGarance A Drosehn	Changes were made to kinfo_proc in sys/user.h.  Please recompile
1209038164a1SGarance A Drosehn	userland, or commands like `fstat', `pkill', `ps', `top' and `w'
1210038164a1SGarance A Drosehn	will not behave correctly.
1211038164a1SGarance A Drosehn
121231f91694SJoseph Koshy	The API and ABI for hwpmc(4) have changed with the addition
121331f91694SJoseph Koshy	of sampling support.  Please recompile lib/libpmc(3) and
121431f91694SJoseph Koshy	usr.sbin/{pmcstat,pmccontrol}.
121531f91694SJoseph Koshy
1216a8d23252SBrooks Davis20050606:
1217a8d23252SBrooks Davis	The OpenBSD dhclient was imported in place of the ISC dhclient
1218a8d23252SBrooks Davis	and the network interface configuration scripts were updated
1219a8d23252SBrooks Davis	accordingly.  If you use DHCP to configure your interfaces, you
1220a8d23252SBrooks Davis	must now run devd.  Also, DNS updating was lost so you will need
1221a8d23252SBrooks Davis	to find a workaround if you use this feature.
1222a8d23252SBrooks Davis
122319dc3462SWarner Losh	The '_dhcp' user was added to support the OpenBSD dhclient.  Be
122419dc3462SWarner Losh	sure to run mergemaster -p (like you are supposed to do every time
122519dc3462SWarner Losh	anyway).
122619dc3462SWarner Losh
1227dfa58a49SAndrew Thompson20050605:
1228dfa58a49SAndrew Thompson	if_bridge was added to the tree. This has changed struct ifnet.
1229dfa58a49SAndrew Thompson	Please recompile userland and all network related modules.
1230dfa58a49SAndrew Thompson
12312554b2d1SHajimu UMEMOTO20050603:
12322554b2d1SHajimu UMEMOTO	The n_net of a struct netent was changed to an uint32_t, and
12332554b2d1SHajimu UMEMOTO	1st argument of getnetbyaddr() was changed to an uint32_t, to
12341d6a063bSHajimu UMEMOTO	conform to POSIX-2001.  These changes broke an ABI
12350fe9e21bSHajimu UMEMOTO	compatibility on 64 bit architecture.  With these changes,
12360fe9e21bSHajimu UMEMOTO	shlib major of libpcap was bumped.  You have to recompile
12370fe9e21bSHajimu UMEMOTO	userland programs that use getnetbyaddr(3), getnetbyname(3),
12380fe9e21bSHajimu UMEMOTO	getnetent(3) and/or libpcap on 64 bit architecture.
12392554b2d1SHajimu UMEMOTO
12400a4c2543SGarance A Drosehn20050528:
12410a4c2543SGarance A Drosehn	Kernel parsing of extra options on '#!' first lines of shell
12420a4c2543SGarance A Drosehn	scripts has changed.  Lines with multiple options likely will
12430a4c2543SGarance A Drosehn	fail after this date.  For full details, please see
12440a4c2543SGarance A Drosehn		http://people.freebsd.org/~gad/Updating-20050528.txt
12450a4c2543SGarance A Drosehn
12466441fe95SMax Laier20050503:
12476441fe95SMax Laier	The packet filter (pf) code has been updated to OpenBSD 3.7
12486441fe95SMax Laier	Please note the changed anchor syntax and the fact that
12496441fe95SMax Laier	authpf(8) now needs a mounted fdescfs(5) to function.
12506441fe95SMax Laier
1251cfdb76e5SScott Long20050415:
1252cfdb76e5SScott Long	The NO_MIXED_MODE kernel option has been removed from the i386
1253cfdb76e5SScott Long	amd64 platforms as its use has been superceded by the new local
1254cfdb76e5SScott Long	APIC timer code.  Any kernel config files containing this option
1255cfdb76e5SScott Long	should be updated.
1256cfdb76e5SScott Long
12574bb8b8beSRuslan Ermilov20050227:
12584bb8b8beSRuslan Ermilov	The on-disk format of LC_CTYPE files was changed to be machine
12594bb8b8beSRuslan Ermilov	independent.  Please make sure NOT to use NO_CLEAN buildworld
126065f1be68SGleb Smirnoff	when crossing this point. Crossing this point also requires
126165f1be68SGleb Smirnoff	recompile or reinstall of all locale depended packages.
12624bb8b8beSRuslan Ermilov
1263bc9d2991SBrooks Davis20050225:
1264bc9d2991SBrooks Davis	The ifi_epoch member of struct if_data has been changed to
1265bc9d2991SBrooks Davis	contain the uptime at which the interface was created or the
1266bc9d2991SBrooks Davis	statistics zeroed rather then the wall clock time because
1267bc9d2991SBrooks Davis	wallclock time may go backwards.  This should have no impact
1268bc9d2991SBrooks Davis	unless an snmp implementation is using this value (I know of
1269bc9d2991SBrooks Davis	none at this point.)
1270bc9d2991SBrooks Davis
1271915a554bSNate Lawson20050224:
1272915a554bSNate Lawson	The acpi_perf and acpi_throttle drivers are now part of the
1273915a554bSNate Lawson	acpi(4) main module.  They are no longer built separately.
1274915a554bSNate Lawson
127510d6bd76SNate Lawson20050223:
127690dc539bSMaxim Sobolev	The layout of struct image_params has changed. You have to
127790dc539bSMaxim Sobolev	recompile all compatibility modules (linux, svr4, etc) for use
127890dc539bSMaxim Sobolev	with the new kernel.
127990dc539bSMaxim Sobolev
128090dc539bSMaxim Sobolev20050223:
128110d6bd76SNate Lawson	The p4tcc driver has been merged into cpufreq(4).  This makes
128210d6bd76SNate Lawson	"options CPU_ENABLE_TCC" obsolete.  Please load cpufreq.ko or
128310d6bd76SNate Lawson	compile in "device cpufreq" to restore this functionality.
128410d6bd76SNate Lawson
1285aea80a64SXin LI20050220:
1286aea80a64SXin LI	The responsibility of recomputing the file system summary of
1287aea80a64SXin LI	a SoftUpdates-enabled dirty volume has been transferred to the
1288aea80a64SXin LI	background fsck.  A rebuild of fsck(8) utility is recommended
1289aea80a64SXin LI	if you have updated the kernel.
1290aea80a64SXin LI
1291aea80a64SXin LI	To get the old behavior (recompute file system summary at mount
1292aea80a64SXin LI	time), you can set vfs.ffs.compute_summary_at_mount=1 before
1293aea80a64SXin LI	mounting the new volume.
1294aea80a64SXin LI
1295da71ab85SGleb Smirnoff20050206:
1296398dd94cSNate Lawson	The cpufreq import is complete.  As part of this, the sysctls for
1297915a554bSNate Lawson	acpi(4) throttling have been removed.  The power_profile script
1298398dd94cSNate Lawson	has been updated, so you can use performance/economy_cpu_freq in
1299915a554bSNate Lawson	rc.conf(5) to set AC on/offline cpu frequencies.
1300398dd94cSNate Lawson
1301398dd94cSNate Lawson20050206:
1302da71ab85SGleb Smirnoff	NG_VERSION has been increased. Recompiling kernel (or ng_socket.ko)
1303da71ab85SGleb Smirnoff	requires recompiling libnetgraph and userland netgraph utilities.
13045ddd0622SBrooks Davis
13055ddd0622SBrooks Davis20050114:
13065ddd0622SBrooks Davis	Support for abbreviated forms of a number of ipfw options is
13075ddd0622SBrooks Davis	now deprecated.  Warnings are printed to stderr indicating the
13085ddd0622SBrooks Davis	correct full form when a match occurs.  Some abbreviations may
13095ddd0622SBrooks Davis	be supported at a later date based on user feedback.  To be
13105ddd0622SBrooks Davis	considered for support, abbreviations must be in use prior to
13115ddd0622SBrooks Davis	this commit and unlikely to be confused with current key words.
13125ddd0622SBrooks Davis
1313b521988eSRuslan Ermilov20041221:
1314b521988eSRuslan Ermilov	By a popular demand, a lot of NOFOO options were renamed
1315b521988eSRuslan Ermilov	to NO_FOO (see bsd.compat.mk for a full list).  The old
1316b521988eSRuslan Ermilov	spellings are still supported, but will cause annoying
1317b521988eSRuslan Ermilov	warnings on stderr.  Make sure you upgrade properly (see
1318b521988eSRuslan Ermilov	the COMMON ITEMS: section later in this file).
1319b521988eSRuslan Ermilov
132087c9e370SSam Leffler20041219:
132187c9e370SSam Leffler	Auto-loading of ancillary wlan modules such as wlan_wep has
132287c9e370SSam Leffler	been temporarily disabled; you need to statically configure
132387c9e370SSam Leffler	the modules you need into your kernel or explicitly load them
132487c9e370SSam Leffler	prior to use.  Specifically, if you intend to use WEP encryption
132587c9e370SSam Leffler	with an 802.11 device load/configure wlan_wep; if you want to
132687c9e370SSam Leffler	use WPA with the ath driver load/configure wlan_tkip, wlan_ccmp,
132787c9e370SSam Leffler	and wlan_xauth as required.
132887c9e370SSam Leffler
132971c1c49aSBrian Somers20041213:
133071c1c49aSBrian Somers	The behaviour of ppp(8) has changed slightly.  If lqr is enabled
133171c1c49aSBrian Somers	(``enable lqr''), older versions would revert to LCP ECHO mode on
133271c1c49aSBrian Somers	negotiation failure.  Now, ``enable echo'' is required for this
133371c1c49aSBrian Somers	behaviour.  The ppp version number has been bumped to 3.4.2 to
133471c1c49aSBrian Somers	reflect the change.
133571c1c49aSBrian Somers
133688046524SSam Leffler20041201:
133788046524SSam Leffler	The wlan support has been updated to split the crypto support
133888046524SSam Leffler	into separate modules.  For static WEP you must configure the
133988046524SSam Leffler	wlan_wep module in your system or build and install the module
134088046524SSam Leffler	in place where it can be loaded (the kernel will auto-load
134188046524SSam Leffler	the module when a wep key is configured).
134288046524SSam Leffler
134388046524SSam Leffler20041201:
134488046524SSam Leffler	The ath driver has been updated to split the tx rate control
134588046524SSam Leffler	algorithm into a separate module.  You need to include either
134688046524SSam Leffler	ath_rate_onoe or ath_rate_amrr when configuring the kernel.
134788046524SSam Leffler
134881adddf3SJohn Baldwin20041116:
134981adddf3SJohn Baldwin	Support for systems with an 80386 CPU has been removed.  Please
135081adddf3SJohn Baldwin	use FreeBSD 5.x or earlier on systems with an 80386.
135181adddf3SJohn Baldwin
135242ba1c57SPoul-Henning Kamp20041110:
135342ba1c57SPoul-Henning Kamp	We have had a hack which would mount the root filesystem
135442ba1c57SPoul-Henning Kamp	R/W if the device were named 'md*'.  As part of the vnode
135542ba1c57SPoul-Henning Kamp	work I'm doing I have had to remove this hack.  People
135642ba1c57SPoul-Henning Kamp	building systems which use preloaded MD root filesystems
135742ba1c57SPoul-Henning Kamp	may need to insert a "/sbin/mount -u -o rw /dev/md0 /" in
135842ba1c57SPoul-Henning Kamp	their /etc/rc scripts.
135942ba1c57SPoul-Henning Kamp
1360dcb5d8f8SRuslan Ermilov20041104:
1361dcb5d8f8SRuslan Ermilov	FreeBSD 5.3 shipped here.
1362dcb5d8f8SRuslan Ermilov
1363c94c54e4SAndre Oppermann20041102:
1364c94c54e4SAndre Oppermann	The size of struct tcpcb has changed again due to the removal
1365c94c54e4SAndre Oppermann	of RFC1644 T/TCP.  You have to recompile userland programs that
1366c94c54e4SAndre Oppermann	read kmem for tcp sockets directly (netstat, sockstat, etc.)
1367c94c54e4SAndre Oppermann
1368cd109b0dSAndre Oppermann20041022:
1369cd109b0dSAndre Oppermann	The size of struct tcpcb has changed.  You have to recompile
1370cd109b0dSAndre Oppermann	userland programs that read kmem for tcp sockets directly
1371cd109b0dSAndre Oppermann	(netstat, sockstat, etc.)
1372cd109b0dSAndre Oppermann
1373b2723608SWarner Losh20041016:
1374b2723608SWarner Losh	RELENG_5 branched here.  For older entries, please see updating
1375b2723608SWarner Losh	in the RELENG_5 branch.
137657199806SWarner Losh
1377dc0dbf5cSWarner LoshCOMMON ITEMS:
1378dc0dbf5cSWarner Losh
1379a24eff53SWarner Losh	General Notes
1380a24eff53SWarner Losh	-------------
1381a24eff53SWarner Losh	Avoid using make -j when upgrading.  From time to time in the
1382a24eff53SWarner Losh	past there have been problems using -j with buildworld and/or
1383a24eff53SWarner Losh	installworld.  This is especially true when upgrading between
1384a24eff53SWarner Losh	"distant" versions (eg one that cross a major release boundary
1385a24eff53SWarner Losh	or several minor releases, or when several months have passed
1386a24eff53SWarner Losh	on the -current branch).
1387a24eff53SWarner Losh
13885780f3baSWarner Losh	Sometimes, obscure build problems are the result of environment
13895780f3baSWarner Losh	poisoning.  This can happen because the make utility reads its
13905780f3baSWarner Losh	environment when searching for values for global variables.
13915780f3baSWarner Losh	To run your build attempts in an "environmental clean room",
13925780f3baSWarner Losh	prefix all make commands with 'env -i '.  See the env(1) manual
13935780f3baSWarner Losh	page for more details.
13945780f3baSWarner Losh
1395081ff8acSDoug Barton	When upgrading from one major version to another it is generally
1396081ff8acSDoug Barton	best to upgrade to the latest code in the currently installed branch
1397081ff8acSDoug Barton	first, then do an upgrade to the new branch. This is the best-tested
1398081ff8acSDoug Barton	upgrade path, and has the highest probability of being successful.
1399081ff8acSDoug Barton	Please try this approach before reporting problems with a major
1400081ff8acSDoug Barton	version upgrade.
1401081ff8acSDoug Barton
1402dc0dbf5cSWarner Losh	To build a kernel
1403dc0dbf5cSWarner Losh	-----------------
1404ba01eb20SWarner Losh	If you are updating from a prior version of FreeBSD (even one just
14051cf0ef11SDavid E. O'Brien	a few days old), you should follow this procedure.  It is the most
14061cf0ef11SDavid E. O'Brien	failsafe as it uses a /usr/obj tree with a fresh mini-buildworld,
14071cf0ef11SDavid E. O'Brien
14081cf0ef11SDavid E. O'Brien	make kernel-toolchain
1409282e0f01SRuslan Ermilov	make -DALWAYS_CHECK_MAKE buildkernel KERNCONF=YOUR_KERNEL_HERE
1410282e0f01SRuslan Ermilov	make -DALWAYS_CHECK_MAKE installkernel KERNCONF=YOUR_KERNEL_HERE
1411dc0dbf5cSWarner Losh
14122e937dd6SAlexander Leidinger	To test a kernel once
14132e937dd6SAlexander Leidinger	---------------------
14142e937dd6SAlexander Leidinger	If you just want to boot a kernel once (because you are not sure
14152e937dd6SAlexander Leidinger	if it works, or if you want to boot a known bad kernel to provide
14162e937dd6SAlexander Leidinger	debugging information) run
14172e937dd6SAlexander Leidinger	make installkernel KERNCONF=YOUR_KERNEL_HERE KODIR=/boot/testkernel
14182e937dd6SAlexander Leidinger	nextboot -k testkernel
14192e937dd6SAlexander Leidinger
1420ba01eb20SWarner Losh	To just build a kernel when you know that it won't mess you up
1421ba01eb20SWarner Losh	--------------------------------------------------------------
14220fbd2da9SKen Smith	This assumes you are already running a 5.X system.  Replace
14230fbd2da9SKen Smith	${arch} with the architecture of your machine (e.g. "i386",
14240fbd2da9SKen Smith	"alpha", "amd64", "ia64", "pc98", "sparc64", etc).
14250fbd2da9SKen Smith
14260fbd2da9SKen Smith	cd src/sys/${arch}/conf
142747d0d01fSWarner Losh	config KERNEL_NAME_HERE
14280fbd2da9SKen Smith	cd ../compile/KERNEL_NAME_HERE
1429ba01eb20SWarner Losh	make depend
1430ba01eb20SWarner Losh	make
1431ba01eb20SWarner Losh	make install
1432ba01eb20SWarner Losh
1433ba01eb20SWarner Losh	If this fails, go to the "To build a kernel" section.
1434ba01eb20SWarner Losh
1435ba01eb20SWarner Losh	To rebuild everything and install it on the current system.
1436ba01eb20SWarner Losh	-----------------------------------------------------------
143763cb445eSWarner Losh	# Note: sometimes if you are running current you gotta do more than
143863cb445eSWarner Losh	# is listed here if you are upgrading from a really old current.
143963cb445eSWarner Losh
1440f643de42SWarner Losh	<make sure you have good level 0 dumps>
144163cb445eSWarner Losh	make buildworld
14426586253aSWarner Losh	make kernel KERNCONF=YOUR_KERNEL_HERE
144363cb445eSWarner Losh							[1]
144463cb445eSWarner Losh	<reboot in single user>				[3]
144563cb445eSWarner Losh	mergemaster -p					[5]
144663cb445eSWarner Losh	make installworld
1447e2a36081SAlexander Leidinger	make delete-old
144863cb445eSWarner Losh	mergemaster					[4]
144963cb445eSWarner Losh	<reboot>
145063cb445eSWarner Losh
1451759f0aefSWarner Losh
1452f27b1fceSJoseph Koshy	To cross-install current onto a separate partition
1453f27b1fceSJoseph Koshy	--------------------------------------------------
1454f27b1fceSJoseph Koshy	# In this approach we use a separate partition to hold
1455f27b1fceSJoseph Koshy	# current's root, 'usr', and 'var' directories.   A partition
1456f27b1fceSJoseph Koshy	# holding "/", "/usr" and "/var" should be about 2GB in
1457f27b1fceSJoseph Koshy	# size.
1458f27b1fceSJoseph Koshy
1459f27b1fceSJoseph Koshy	<make sure you have good level 0 dumps>
1460f27b1fceSJoseph Koshy	<boot into -stable>
1461f27b1fceSJoseph Koshy	make buildworld
14623ecf3bddSRuslan Ermilov	make buildkernel KERNCONF=YOUR_KERNEL_HERE
1463f27b1fceSJoseph Koshy	<maybe newfs current's root partition>
1464f27b1fceSJoseph Koshy	<mount current's root partition on directory ${CURRENT_ROOT}>
1465f27b1fceSJoseph Koshy	make installworld DESTDIR=${CURRENT_ROOT}
14662d5cde04SRuslan Ermilov	make distribution DESTDIR=${CURRENT_ROOT} # if newfs'd
14673ecf3bddSRuslan Ermilov	make installkernel KERNCONF=YOUR_KERNEL_HERE DESTDIR=${CURRENT_ROOT}
1468f27b1fceSJoseph Koshy	cp /etc/fstab ${CURRENT_ROOT}/etc/fstab 		   # if newfs'd
1469f27b1fceSJoseph Koshy	<edit ${CURRENT_ROOT}/etc/fstab to mount "/" from the correct partition>
1470f27b1fceSJoseph Koshy	<reboot into current>
1471f27b1fceSJoseph Koshy	<do a "native" rebuild/install as described in the previous section>
1472737d990aSXin LI	<maybe install compatibility libraries from ports/misc/compat*>
1473f27b1fceSJoseph Koshy	<reboot>
1474f27b1fceSJoseph Koshy
1475f27b1fceSJoseph Koshy
14768ce4cbbfSWarner Losh	To upgrade in-place from 5.x-stable to current
1477f27b1fceSJoseph Koshy	----------------------------------------------
1478f643de42SWarner Losh	<make sure you have good level 0 dumps>
147921c075eaSWarner Losh	make buildworld					[9]
1480e5dc5f61SWarner Losh	make kernel KERNCONF=YOUR_KERNEL_HERE		[8]
1481fc8c157fSWarner Losh							[1]
1482fc8c157fSWarner Losh	<reboot in single user>				[3]
1483835284beSWarner Losh	mergemaster -p					[5]
1484ba26da8eSWarner Losh	make installworld
1485e2a36081SAlexander Leidinger	make delete-old
1486802fc49dSBrian Feldman	mergemaster -i					[4]
1487ba26da8eSWarner Losh	<reboot>
1488ba26da8eSWarner Losh
1489fdb9f54dSWarner Losh	Make sure that you've read the UPDATING file to understand the
1490fdb9f54dSWarner Losh	tweaks to various things you need.  At this point in the life
1491fdb9f54dSWarner Losh	cycle of current, things change often and you are on your own
1492fdb9f54dSWarner Losh	to cope.  The defaults can also change, so please read ALL of
1493fdb9f54dSWarner Losh	the UPDATING entries.
1494ba26da8eSWarner Losh
14951dece4a9SWarner Losh	Also, if you are tracking -current, you must be subscribed to
14961dece4a9SWarner Losh	freebsd-current@freebsd.org.  Make sure that before you update
14971dece4a9SWarner Losh	your sources that you have read and understood all the recent
14981dece4a9SWarner Losh	messages there.  If in doubt, please track -stable which has
14991dece4a9SWarner Losh	much fewer pitfalls.
15001dece4a9SWarner Losh
1501134d2e86SWarner Losh	[1] If you have third party modules, such as vmware, you
1502134d2e86SWarner Losh	should disable them at this point so they don't crash your
1503134d2e86SWarner Losh	system on reboot.
1504134d2e86SWarner Losh
1505ee6e1fc3SWarner Losh	[3] From the bootblocks, boot -s, and then do
1506ee6e1fc3SWarner Losh		fsck -p
1507ee6e1fc3SWarner Losh		mount -u /
1508ee6e1fc3SWarner Losh		mount -a
15096586253aSWarner Losh		cd src
151047d0d01fSWarner Losh		adjkerntz -i		# if CMOS is wall time
1511f6a0ef01SWarner Losh	Also, when doing a major release upgrade, it is required that
1512f6a0ef01SWarner Losh	you boot into single user mode to do the installworld.
1513ee6e1fc3SWarner Losh
1514a6cd4f9dSWarner Losh	[4] Note: This step is non-optional.  Failure to do this step
1515a6cd4f9dSWarner Losh	can result in a significant reduction in the functionality of the
1516a6cd4f9dSWarner Losh	system.  Attempting to do it by hand is not recommended and those
1517a6cd4f9dSWarner Losh	that pursue this avenue should read this file carefully, as well
1518a6cd4f9dSWarner Losh	as the archives of freebsd-current and freebsd-hackers mailing lists
1519a6cd4f9dSWarner Losh	for potential gotchas.
1520a6cd4f9dSWarner Losh
1521835284beSWarner Losh	[5] Usually this step is a noop.  However, from time to time
1522835284beSWarner Losh	you may need to do this if you get unknown user in the following
1523835284beSWarner Losh	step.  It never hurts to do it all the time.  You may need to
1524835284beSWarner Losh	install a new mergemaster (cd src/usr.sbin/mergemaster && make
1525835284beSWarner Losh	install) after the buildworld before this step if you last updated
1526835284beSWarner Losh	from current before 20020224 or from -stable before 20020408.
1527835284beSWarner Losh
1528c74fe6afSWarner Losh	[8] In order to have a kernel that can run the 4.x binaries
1529c74fe6afSWarner Losh	needed to do an installworld, you must include the COMPAT_FREEBSD4
1530c74fe6afSWarner Losh	option in your kernel.  Failure to do so may leave you with a system
153165f1be68SGleb Smirnoff	that is hard to boot to recover. A similar kernel option COMPAT_FREEBSD5
153265f1be68SGleb Smirnoff	is required to run the 5.x binaries on more recent kernels.
1533c74fe6afSWarner Losh
1534e5dc5f61SWarner Losh	Make sure that you merge any new devices from GENERIC since the
1535e5dc5f61SWarner Losh	last time you updated your kernel config file.
1536e5dc5f61SWarner Losh
153721c075eaSWarner Losh	[9] When checking out sources, you must include the -P flag to have
1538e5dc5f61SWarner Losh	cvs prune empty directories.
1539e5dc5f61SWarner Losh
1540e5dc5f61SWarner Losh	If CPUTYPE is defined in your /etc/make.conf, make sure to use the
1541e5dc5f61SWarner Losh	"?=" instead of the "=" assignment operator, so that buildworld can
1542e5dc5f61SWarner Losh	override the CPUTYPE if it needs to.
1543e5dc5f61SWarner Losh
1544e5dc5f61SWarner Losh	MAKEOBJDIRPREFIX must be defined in an environment variable, and
1545e5dc5f61SWarner Losh	not on the command line, or in /etc/make.conf.  buildworld will
1546e5dc5f61SWarner Losh	warn if it is improperly defined.
1547dc0dbf5cSWarner LoshFORMAT:
1548dc0dbf5cSWarner Losh
1549f699bbbbSMark OvensThis file contains a list, in reverse chronological order, of major
15501fc1a0dcSWarner Loshbreakages in tracking -current.  Not all things will be listed here,
15518ce4cbbfSWarner Loshand it only starts on October 16, 2004.  Updating files can found in
1552f8ab1dd6SWarner Loshprevious releases if your system is older than this.
15531fc1a0dcSWarner Losh
1554e72fd46aSWarner LoshCopyright information:
1555e72fd46aSWarner Losh
15568ce4cbbfSWarner LoshCopyright 1998-2005 M. Warner Losh.  All Rights Reserved.
1557e72fd46aSWarner Losh
1558772730c7SWarner LoshRedistribution, publication, translation and use, with or without
1559772730c7SWarner Loshmodification, in full or in part, in any form or format of this
15609698f2c0SWarner Loshdocument are permitted without further permission from the author.
1561e72fd46aSWarner Losh
1562e72fd46aSWarner LoshTHIS DOCUMENT IS PROVIDED BY WARNER LOSH ``AS IS'' AND ANY EXPRESS OR
1563e72fd46aSWarner LoshIMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
1564e72fd46aSWarner LoshWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
1565e72fd46aSWarner LoshDISCLAIMED.  IN NO EVENT SHALL WARNER LOSH BE LIABLE FOR ANY DIRECT,
1566e72fd46aSWarner LoshINDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
1567e72fd46aSWarner Losh(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
1568e72fd46aSWarner LoshSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
1569e72fd46aSWarner LoshHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
1570e72fd46aSWarner LoshSTRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
1571e72fd46aSWarner LoshIN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
1572e72fd46aSWarner LoshPOSSIBILITY OF SUCH DAMAGE.
1573e72fd46aSWarner Losh
1574e72fd46aSWarner LoshIf you find this document useful, and you want to, you may buy the
1575e72fd46aSWarner Loshauthor a beer.
1576e72fd46aSWarner Losh
157722306abcSWarner LoshContact Warner Losh if you have any questions about your use of
1578772730c7SWarner Loshthis document.
1579772730c7SWarner Losh
158097d92980SPeter Wemm$FreeBSD$
1581