xref: /freebsd/UPDATING (revision d1675e38f906ae5efde3e5bf9c91387f10db100f)
157199806SWarner LoshUpdating Information for FreeBSD current users
253dfde79SWarner Losh
3456b5dd8SWarner LoshThis file is maintained and copyrighted by M. Warner Losh <imp@freebsd.org>.
4456b5dd8SWarner LoshSee end of file for further details.  For commonly done items, please see the
5456b5dd8SWarner LoshCOMMON ITEMS: section later in the file.  These instructions assume that you
6456b5dd8SWarner Loshbasically know what you are doing.  If not, then please consult the FreeBSD
7456b5dd8SWarner Loshhandbook.
8e72fd46aSWarner Losh
92c724730SWarner LoshItems affecting the ports and packages system can be found in
10456b5dd8SWarner Losh/usr/ports/UPDATING.  Please read that file before running portupgrade.
112c724730SWarner Losh
128a3b6cc1SKen SmithNOTE TO PEOPLE WHO THINK THAT FreeBSD 10.x IS SLOW:
138a3b6cc1SKen Smith	FreeBSD 10.x has many debugging features turned on, in both the kernel
14456b5dd8SWarner Losh	and userland.  These features attempt to detect incorrect use of
15456b5dd8SWarner Losh	system primitives, and encourage loud failure through extra sanity
16456b5dd8SWarner Losh	checking and fail stop semantics.  They also substantially impact
17456b5dd8SWarner Losh	system performance.  If you want to do performance measurement,
18456b5dd8SWarner Losh	benchmarking, and optimization, you'll want to turn them off.  This
19456b5dd8SWarner Losh	includes various WITNESS- related kernel options, INVARIANTS, malloc
20456b5dd8SWarner Losh	debugging flags in userland, and various verbose features in the
21456b5dd8SWarner Losh	kernel.  Many developers choose to disable these features on build
22456b5dd8SWarner Losh	machines to maximize performance.  (To disable malloc debugging, run
236bea5c3cSTom Rhodes	ln -s aj /etc/malloc.conf.)
24efc06131SSam Leffler
25*d1675e38SJason Evans20120417:
26*d1675e38SJason Evans	The malloc(3) implementation embedded in libc now uses sources imported
27*d1675e38SJason Evans	as contrib/jemalloc.  The most disruptive API change is to
28*d1675e38SJason Evans	/etc/malloc.conf.  If your system has an old-style /etc/malloc.conf,
29*d1675e38SJason Evans	delete it prior to installworld, and optionally re-create it using the
30*d1675e38SJason Evans	new format after rebooting.  See malloc.conf(5) for details
31*d1675e38SJason Evans	(specifically the TUNING section and the "opt.*" entries in the MALLCTL
32*d1675e38SJason Evans	NAMESPACE section).
33*d1675e38SJason Evans
3484db023eSJuli Mallett20120328:
3584db023eSJuli Mallett	Big-endian MIPS TARGET_ARCH values no longer end in "eb".  mips64eb
3684db023eSJuli Mallett	is now spelled mips64.  mipsn32eb is now spelled mipsn32.  mipseb is
3784db023eSJuli Mallett	now spelled mips.  This is to aid compatibility with third-party
3884db023eSJuli Mallett	software that expects this naming scheme in uname(3).  Little-endian
3984db023eSJuli Mallett	settings are unchanged.
4084db023eSJuli Mallett
419c170fd1SAttilio Rao20120306:
429c170fd1SAttilio Rao	Disable by default the option VFS_ALLOW_NONMPSAFE for all supported
439c170fd1SAttilio Rao	platforms.
449c170fd1SAttilio Rao
45c7e41c8bSMikolaj Golub20120229:
46c7e41c8bSMikolaj Golub	Now unix domain sockets behave "as expected" on	nullfs(5). Previously
47c7e41c8bSMikolaj Golub	nullfs(5) did not pass through all behaviours to the underlying layer,
48c7e41c8bSMikolaj Golub	as a result if we bound to a socket on the lower layer we could connect
49c7e41c8bSMikolaj Golub	only to the lower path; if we bound to the upper layer we could connect
50c7e41c8bSMikolaj Golub	only to	the upper path. The new behavior is one can connect to both the
51c7e41c8bSMikolaj Golub	lower and the upper paths regardless what layer path one binds to.
52c7e41c8bSMikolaj Golub
53ca1672daSBjoern A. Zeeb20120211:
54ca1672daSBjoern A. Zeeb	The getifaddrs upgrade path broken with 20111215 has been restored.
55ca1672daSBjoern A. Zeeb	If you have upgraded in between 20111215 and 20120209 you need to
56ca1672daSBjoern A. Zeeb	recompile libc again with your kernel.  You still need to recompile
57ca1672daSBjoern A. Zeeb	world to be able to configure CARP but this restriction already
58ca1672daSBjoern A. Zeeb	comes from 20111215.
59ca1672daSBjoern A. Zeeb
60e0e0f25bSDoug Barton20120114:
61e0e0f25bSDoug Barton	The set_rcvar() function has been removed from /etc/rc.subr.  All
62e0e0f25bSDoug Barton	base and ports rc.d scripts have been updated, so if you have a
63e0e0f25bSDoug Barton	port installed with a script in /usr/local/etc/rc.d you can either
64e0e0f25bSDoug Barton	hand-edit the rcvar= line, or reinstall the port.
65e0e0f25bSDoug Barton
665d482324SDoug Barton	An easy way to handle the mass-update of /etc/rc.d:
675d482324SDoug Barton	rm /etc/rc.d/* && mergemaster -i
685d482324SDoug Barton
6990d82653SAndriy Gapon20120109:
7090d82653SAndriy Gapon	panic(9) now stops other CPUs in the SMP systems, disables interrupts
7190d82653SAndriy Gapon	on the current CPU and prevents other threads from running.
7290d82653SAndriy Gapon	This behavior can be reverted using the kern.stop_scheduler_on_panic
7390d82653SAndriy Gapon	tunable/sysctl.
7490d82653SAndriy Gapon	The new behavior can be incompatible with kern.sync_on_panic.
7590d82653SAndriy Gapon
7608b68b0eSGleb Smirnoff20111215:
7708b68b0eSGleb Smirnoff	The carp(4) facility has been changed significantly. Configuration
7808b68b0eSGleb Smirnoff	of the CARP protocol via ifconfig(8) has changed, as well as format
7908b68b0eSGleb Smirnoff	of CARP events submitted to devd(8) has changed. See manual pages
8008b68b0eSGleb Smirnoff	for more information. The arpbalance feature of carp(4) is currently
8108b68b0eSGleb Smirnoff	not supported anymore.
8208b68b0eSGleb Smirnoff
8308b68b0eSGleb Smirnoff	Size of struct in_aliasreq, struct in6_aliasreq has changed. User
8408b68b0eSGleb Smirnoff	utilities using SIOCAIFADDR, SIOCAIFADDR_IN6, e.g. ifconfig(8),
8508b68b0eSGleb Smirnoff	need to be recompiled.
8608b68b0eSGleb Smirnoff
87d5d131eeSJaakko Heinonen20111122:
88d5d131eeSJaakko Heinonen	The acpi_wmi(4) status device /dev/wmistat has been renamed to
89d5d131eeSJaakko Heinonen	/dev/wmistat0.
90d5d131eeSJaakko Heinonen
91ed1f6dc2SAttilio Rao20111108:
92ed1f6dc2SAttilio Rao	The option VFS_ALLOW_NONMPSAFE option has been added in order to
93ed1f6dc2SAttilio Rao	explicitely support non-MPSAFE filesystems.
94ed1f6dc2SAttilio Rao	It is on by default for all supported platform at this present
95ed1f6dc2SAttilio Rao	time.
96ed1f6dc2SAttilio Rao
97a9ab459bSMarius Strobl20111101:
98a9ab459bSMarius Strobl	The broken amd(4) driver has been replaced with esp(4) in the amd64,
99a9ab459bSMarius Strobl	i386 and pc98 GENERIC kernel configuration files.
100a9ab459bSMarius Strobl
101e59e2d8eSNathan Whitehorn20110930:
102e59e2d8eSNathan Whitehorn	sysinstall has been removed
103e59e2d8eSNathan Whitehorn
1048a3b6cc1SKen Smith20110923:
1058a3b6cc1SKen Smith	The stable/9 branch created in subversion.  This corresponds to the
1068a3b6cc1SKen Smith	RELENG_9 branch in CVS.
1078a3b6cc1SKen Smith
1084d30adc4SRick Macklem20110913:
1094d30adc4SRick Macklem	This commit modifies vfs_register() so that it uses a hash
1104d30adc4SRick Macklem	calculation to set vfc_typenum, which is enabled by default.
1114d30adc4SRick Macklem	The first time a system is booted after this change, the
1124d30adc4SRick Macklem	vfc_typenum values will change for all file systems. The
1134d30adc4SRick Macklem	main effect of this is a change to the NFS server file handles
1144d30adc4SRick Macklem	for file systems that use vfc_typenum in their fsid, such as ZFS.
1154d30adc4SRick Macklem	It will, however, prevent vfc_typenum from changing when file
1164d30adc4SRick Macklem	systems are loaded in a different order for subsequent reboots.
1174d30adc4SRick Macklem	To disable this, you can set vfs.typenumhash=0 in /boot/loader.conf
1184d30adc4SRick Macklem	until you are ready to remount all NFS clients after a reboot.
1194d30adc4SRick Macklem
1207596eb48SKonstantin Belousov20110828:
1217596eb48SKonstantin Belousov	Bump the shared library version numbers for libraries that
1227596eb48SKonstantin Belousov	do not use symbol versioning, have changed the ABI compared
1237596eb48SKonstantin Belousov	to stable/8 and which shared library version was not bumped.
1247596eb48SKonstantin Belousov	Done as part of 9.0-RELEASE cycle.
1257596eb48SKonstantin Belousov
12674d0c46dSRobert Watson20110815:
12774d0c46dSRobert Watson	During the merge of Capsicum features, the fget(9) KPI was modified.
12874d0c46dSRobert Watson	This may require the rebuilding of out-of-tree device drivers --
12974d0c46dSRobert Watson	issues have been reported specifically with the nVidia device driver.
13074d0c46dSRobert Watson	__FreeBSD_version is bumped to 900041.
13174d0c46dSRobert Watson
13274d0c46dSRobert Watson	Also, there is a period between 20110811 and 20110814 where the
13374d0c46dSRobert Watson	special devices /dev/{stdin,stdout,stderr} did not work correctly.
13474d0c46dSRobert Watson	Building world from a kernel during that window may not work.
13574d0c46dSRobert Watson
136e0bfbfceSBjoern A. Zeeb20110628:
137e0bfbfceSBjoern A. Zeeb	The packet filter (pf) code has been updated to OpenBSD 4.5.
138e0bfbfceSBjoern A. Zeeb	You need to update userland tools to be in sync with kernel.
13970d57756SBjoern A. Zeeb	This update breaks backward compatibility with earlier pfsync(4)
14070d57756SBjoern A. Zeeb	versions.  Care must be taken when updating redundant firewall setups.
141e0bfbfceSBjoern A. Zeeb
142234dab4aSAndriy Gapon20110608:
143234dab4aSAndriy Gapon	The following sysctls and tunables are retired on x86 platforms:
144234dab4aSAndriy Gapon		machdep.hlt_cpus
145234dab4aSAndriy Gapon		machdep.hlt_logical_cpus
146234dab4aSAndriy Gapon	The following sysctl is retired:
147234dab4aSAndriy Gapon		machdep.hyperthreading_allowed
148234dab4aSAndriy Gapon	The sysctls were supposed to provide a way to dynamically offline and
149234dab4aSAndriy Gapon	online selected CPUs on x86 platforms, but the implementation has not
150234dab4aSAndriy Gapon	been reliable especially with SCHED_ULE scheduler.
151234dab4aSAndriy Gapon	machdep.hyperthreading_allowed tunable is still available to ignore
152234dab4aSAndriy Gapon	hyperthreading CPUs at OS level.
153234dab4aSAndriy Gapon	Individual CPUs can be disabled using hint.lapic.X.disabled tunable,
154234dab4aSAndriy Gapon	where X is an APIC ID of a CPU.  Be advised, though, that disabling
155234dab4aSAndriy Gapon	CPUs in non-uniform fashion will result in non-uniform topology and
156234dab4aSAndriy Gapon	may lead to sub-optimal system performance with SCHED_ULE, which is
157234dab4aSAndriy Gapon	a default scheduler.
158234dab4aSAndriy Gapon
159f0fcb367SAttilio Rao20110607:
160f0fcb367SAttilio Rao	cpumask_t type is retired and cpuset_t is used in order to describe
161f0fcb367SAttilio Rao	a mask of CPUs.
162f0fcb367SAttilio Rao
163ec49fe39SBjoern A. Zeeb20110531:
164ec49fe39SBjoern A. Zeeb	Changes to ifconfig(8) for dynamic address family detection mandate
165ec49fe39SBjoern A. Zeeb	that you are running a kernel of 20110525 or later.  Make sure to
166ec49fe39SBjoern A. Zeeb	follow the update procedure to boot a new kernel before installing
167ec49fe39SBjoern A. Zeeb	world.
168ec49fe39SBjoern A. Zeeb
1694b547324SAttilio Rao20110513:
1704b547324SAttilio Rao	Support for sun4v architecture is officially dropped
1714b547324SAttilio Rao
1724a58ecccSMarius Strobl20110503:
1734a58ecccSMarius Strobl	Several KPI breaking changes have been committed to the mii(4) layer,
1744a58ecccSMarius Strobl	the PHY drivers and consequently some Ethernet drivers using mii(4).
1754a58ecccSMarius Strobl	This means that miibus.ko and the modules of the affected Ethernet
1764a58ecccSMarius Strobl	drivers need to be recompiled.
1774a58ecccSMarius Strobl
1784a58ecccSMarius Strobl	Note to kernel developers: Given that the OUI bit reversion problem
1794a58ecccSMarius Strobl	was fixed as part of these changes all mii(4) commits related to OUIs,
1804a58ecccSMarius Strobl	i.e. to sys/dev/mii/miidevs, PHY driver probing and vendor specific
1814a58ecccSMarius Strobl	handling, no longer can be merged verbatim to stable/8 and previous
1824a58ecccSMarius Strobl	branches.
1834a58ecccSMarius Strobl
184f9dfbfa1SAdrian Chadd20110430:
185f9dfbfa1SAdrian Chadd	Users of the Atheros AR71xx SoC code now need to add 'device ar71xx_pci'
186f9dfbfa1SAdrian Chadd	into their kernel configurations along with 'device pci'.
187f9dfbfa1SAdrian Chadd
1884309e17aSRick Macklem20110427:
1894309e17aSRick Macklem	The default NFS client is now the new NFS client, so fstype "newnfs"
1904309e17aSRick Macklem	is now "nfs" and the regular/old NFS client is now fstype "oldnfs".
1914309e17aSRick Macklem	Although mounts via fstype "nfs" will usually work without userland
1924309e17aSRick Macklem	changes, it is recommended that the mount(8) and mount_nfs(8)
1934309e17aSRick Macklem	commands be rebuilt from sources and that a link to mount_nfs called
1944309e17aSRick Macklem	mount_oldnfs be created. The new client is compiled into the
1954309e17aSRick Macklem	kernel with "options NFSCL" and this is needed for diskless root
1964309e17aSRick Macklem	file systems. The GENERIC kernel configs have been changed to use
1974309e17aSRick Macklem	NFSCL and NFSD (the new server) instead of NFSCLIENT and NFSSERVER.
1984309e17aSRick Macklem	To use the regular/old client, you can "mount -t oldnfs ...". For
1994309e17aSRick Macklem	a diskless root file system, you must also include a line like:
2004309e17aSRick Macklem
2014309e17aSRick Macklem	vfs.root.mountfrom="oldnfs:"
2024309e17aSRick Macklem
2034309e17aSRick Macklem	in the boot/loader.conf on the root fs on the NFS server to make
2044309e17aSRick Macklem	a diskless root fs use the old client.
2054309e17aSRick Macklem
20697b53e36SAlexander Motin20110424:
20797b53e36SAlexander Motin	The GENERIC kernels for all architectures now default to the new
20897b53e36SAlexander Motin	CAM-based ATA stack. It means that all legacy ATA drivers were
20997b53e36SAlexander Motin	removed and replaced by respective CAM drivers. If you are using
21097b53e36SAlexander Motin	ATA device names in /etc/fstab or other places, make sure to update
21197b53e36SAlexander Motin	them respectively (adX -> adaY, acdX -> cdY, afdX -> daY, astX -> saY,
212ddfddf12SAlexander Motin	where 'Y's are the sequential numbers starting from zero for each type
213ddfddf12SAlexander Motin	in order of detection, unless configured otherwise with tunables,
2140d307e09SAlexander Motin	see cam(4)). There will be symbolic links created in /dev/ to map
2150d307e09SAlexander Motin	old adX devices to the respective adaY. They should provide basic
2160d307e09SAlexander Motin	compatibility for file systems mounting in most cases, but they do
2170d307e09SAlexander Motin	not support old user-level APIs and do not have respective providers
2180d307e09SAlexander Motin	in GEOM. Consider using updated management tools with new device names.
2190d307e09SAlexander Motin
2200d307e09SAlexander Motin	It is possible to load devices ahci, ata, siis and mvs as modules,
2210d307e09SAlexander Motin	but option ATA_CAM should remain in kernel configuration to make ata
2220d307e09SAlexander Motin	module work as CAM driver supporting legacy ATA controllers. Device ata
2230d307e09SAlexander Motin	still can be used in modular fashion (atacore + ...). Modules atadisk
2240d307e09SAlexander Motin	and atapi* are not used and won't affect operation in ATA_CAM mode.
2255d4ac622SAlexander Motin	Note that to use CAM-based ATA kernel should include CAM devices
2265d4ac622SAlexander Motin	scbus, pass, da (or explicitly ada), cd and optionally others. All of
2275d4ac622SAlexander Motin	them are parts of the cam module.
22897b53e36SAlexander Motin
22997b53e36SAlexander Motin	ataraid(4) functionality is now supported by the RAID GEOM class.
23097b53e36SAlexander Motin	To use it you can load geom_raid kernel module and use graid(8) tool
23197b53e36SAlexander Motin	for management. Instead of /dev/arX device names, use /dev/raid/rX.
23297b53e36SAlexander Motin
23397b53e36SAlexander Motin	No kernel config options or code have been removed, so if a problem
23497b53e36SAlexander Motin	arises, please report it and optionally revert to the old ATA stack.
23597b53e36SAlexander Motin	In order to do it you can remove from the kernel config:
23697b53e36SAlexander Motin	    options        ATA_CAM
23797b53e36SAlexander Motin	    device         ahci
23897b53e36SAlexander Motin	    device         mvs
23997b53e36SAlexander Motin	    device         siis
24097b53e36SAlexander Motin	, and instead add back:
24197b53e36SAlexander Motin	    device         atadisk         # ATA disk drives
24297b53e36SAlexander Motin	    device         ataraid         # ATA RAID drives
24397b53e36SAlexander Motin	    device         atapicd         # ATAPI CDROM drives
24497b53e36SAlexander Motin	    device         atapifd         # ATAPI floppy drives
24597b53e36SAlexander Motin	    device         atapist         # ATAPI tape drives
24697b53e36SAlexander Motin
2472a85df8cSRick Macklem20110423:
2482a85df8cSRick Macklem	The default NFS server has been changed to the new server, which
2492a85df8cSRick Macklem	was referred to as the experimental server. If you need to switch
2502a85df8cSRick Macklem	back to the old NFS server, you must now put the "-o" option on
2512a85df8cSRick Macklem	both the mountd and nfsd commands. This can be done using the
2522a85df8cSRick Macklem	mountd_flags and nfs_server_flags rc.conf variables until an
2532a85df8cSRick Macklem	update to the rc scripts is committed, which is coming soon.
2542a85df8cSRick Macklem
25566f3a31fSDimitry Andric20110418:
25666f3a31fSDimitry Andric	The GNU Objective-C runtime library (libobjc), and other Objective-C
25766f3a31fSDimitry Andric	related components have been removed from the base system.  If you
25866f3a31fSDimitry Andric	require an Objective-C library, please use one of the available ports.
25966f3a31fSDimitry Andric
2601c62cc63SAdrian Chadd20110331:
2611c62cc63SAdrian Chadd	ath(4) has been split into bus- and device- modules. if_ath contains
2621c62cc63SAdrian Chadd	the HAL, the TX rate control and the network device code. if_ath_pci
2631c62cc63SAdrian Chadd	contains the PCI bus glue. For Atheros MIPS embedded systems, if_ath_ahb
2641c62cc63SAdrian Chadd	contains the AHB glue. Users need to load both if_ath_pci and if_ath
2651c62cc63SAdrian Chadd	in order to use ath on everything else.
2661c62cc63SAdrian Chadd
2671c62cc63SAdrian Chadd	TO REPEAT: if_ath_ahb is not needed for normal users. Normal users only
2681c62cc63SAdrian Chadd	need to load if_ath and if_ath_pci for ath(4) operation.
2691c62cc63SAdrian Chadd
2700a4b5285SNathan Whitehorn20110314:
2710a4b5285SNathan Whitehorn	As part of the replacement of sysinstall, the process of building
2720a4b5285SNathan Whitehorn	release media has changed significantly. For details, please re-read
2730a4b5285SNathan Whitehorn	release(7), which has been updated to reflect the new build process.
2740a4b5285SNathan Whitehorn
27576f9415bSVANHULLEBUS Yvan20110218:
276ce8fb931SDimitry Andric	GNU binutils 2.17.50 (as of 2007-07-03) has been merged to -HEAD.  This
277ce8fb931SDimitry Andric	is the last available version under GPLv2.  It brings a number of new
278ce8fb931SDimitry Andric	features, such as support for newer x86 CPU's (with SSE-3, SSSE-3, SSE
279ce8fb931SDimitry Andric	4.1 and SSE 4.2), better support for powerpc64, a number of new
280ce8fb931SDimitry Andric	directives, and lots of other small improvements.  See the ChangeLog
281ce8fb931SDimitry Andric	file in contrib/binutils for the full details.
282ce8fb931SDimitry Andric
283ce8fb931SDimitry Andric20110218:
28476f9415bSVANHULLEBUS Yvan	IPsec's HMAC_SHA256-512 support has been fixed to be RFC4868
28576f9415bSVANHULLEBUS Yvan	compliant, and will now use half of hash for authentication.
28676f9415bSVANHULLEBUS Yvan	This will break interoperability with all stacks (including all
28776f9415bSVANHULLEBUS Yvan	actual FreeBSD versions) who implement
28876f9415bSVANHULLEBUS Yvan	draft-ietf-ipsec-ciph-sha-256-00 (they use 96 bits of hash for
28976f9415bSVANHULLEBUS Yvan	authentication).
29076f9415bSVANHULLEBUS Yvan	The only workaround with such peers is to use another HMAC
29176f9415bSVANHULLEBUS Yvan	algorithm for IPsec ("phase 2") authentication.
29276f9415bSVANHULLEBUS Yvan
29313434232SMatthew D Fleming20110207:
29413434232SMatthew D Fleming	Remove the uio_yield prototype and symbol.  This function has
29513434232SMatthew D Fleming	been misnamed since it was introduced and should not be
29613434232SMatthew D Fleming	globally exposed with this name.  The equivalent functionality
29713434232SMatthew D Fleming	is now available using kern_yield(curthread->td_user_pri).
29813434232SMatthew D Fleming	The function remains undocumented.
29913434232SMatthew D Fleming
3004c8945a0SNathan Whitehorn20110112:
3011eae8811SMatthew D Fleming	A SYSCTL_[ADD_]UQUAD was added for unsigned uint64_t pointers,
3021eae8811SMatthew D Fleming	symmetric with the existing SYSCTL_[ADD_]QUAD.  Type checking
3031eae8811SMatthew D Fleming	for scalar sysctls is defined but disabled.  Code that needs
3041eae8811SMatthew D Fleming	UQUAD to pass the type checking that must compile on older
3051eae8811SMatthew D Fleming	systems where the define is not present can check against
3061eae8811SMatthew D Fleming	__FreeBSD_version >= 900030.
3071eae8811SMatthew D Fleming
3084c8945a0SNathan Whitehorn	The system dialog(1) has been replaced with a new version previously
3094c8945a0SNathan Whitehorn	in ports as devel/cdialog. dialog(1) is mostly command-line compatible
3104c8945a0SNathan Whitehorn	with the previous version, but the libdialog associated with it has
3114c8945a0SNathan Whitehorn	a largely incompatible API. As such, the original version of libdialog
3124c8945a0SNathan Whitehorn	will be kept temporarily as libodialog, until its base system consumers
3134c8945a0SNathan Whitehorn	are replaced or updated. Bump __FreeBSD_version to 900030.
3144c8945a0SNathan Whitehorn
315e4f64803SWarner Losh20110103:
316e4f64803SWarner Losh	If you are trying to run make universe on a -stable system, and you get
317e4f64803SWarner Losh	the following warning:
3187b57aa33SRebecca Cran	"Makefile", line 356: "Target architecture for i386/conf/GENERIC
3197b57aa33SRebecca Cran	unknown.  config(8) likely too old."
320e4f64803SWarner Losh	or something similar to it, then you must upgrade your -stable system
321e4f64803SWarner Losh	to 8.2-Release or newer (really, any time after r210146 7/15/2010 in
322e4f64803SWarner Losh	stable/8) or build the config from the latest stable/8 branch and
323e4f64803SWarner Losh	install it on your system.
324e4f64803SWarner Losh
325e4f64803SWarner Losh	Prior to this date, building a current universe on 8-stable system from
326e4f64803SWarner Losh	between 7/15/2010 and 1/2/2011 would result in a weird shell parsing
3277b57aa33SRebecca Cran	error in the first kernel build phase.  A new config on those old
3287b57aa33SRebecca Cran	systems will fix that problem for older versions of -current.
329e4f64803SWarner Losh
33039bc9de5SLawrence Stewart20101228:
33139bc9de5SLawrence Stewart	The TCP stack has been modified to allow Khelp modules to interact with
33239bc9de5SLawrence Stewart	it via helper hook points and store per-connection data in the TCP
33339bc9de5SLawrence Stewart	control block. Bump __FreeBSD_version to 900029. User space tools that
33439bc9de5SLawrence Stewart	rely on the size of struct tcpcb in tcp_var.h (e.g. sockstat) need to
33539bc9de5SLawrence Stewart	be recompiled.
33639bc9de5SLawrence Stewart
337efd4fc3fSMarius Strobl20101114:
338efd4fc3fSMarius Strobl	Generic IEEE 802.3 annex 31B full duplex flow control support has been
339efd4fc3fSMarius Strobl	added to mii(4) and bge(4), bce(4), msk(4), nfe(4) and stge(4) along
340efd4fc3fSMarius Strobl	with brgphy(4), e1000phy(4) as well as ip1000phy() have been converted
341efd4fc3fSMarius Strobl	to take advantage of it instead of using custom implementations.  This
342efd4fc3fSMarius Strobl	means that these drivers now no longer unconditionally advertise
343efd4fc3fSMarius Strobl	support for flow control but only do so if flow control is a selected
344efd4fc3fSMarius Strobl	media option.  This was implemented in the generic support that way in
345efd4fc3fSMarius Strobl	order to allow flow control to be switched on and off via ifconfig(8)
346efd4fc3fSMarius Strobl	with the PHY specific default to typically off in order to protect
347efd4fc3fSMarius Strobl	from unwanted effects.  Consequently, if you used flow control with
348efd4fc3fSMarius Strobl	one of the above mentioned drivers you now need to explicitly enable
349efd4fc3fSMarius Strobl	it, for example via:
350efd4fc3fSMarius Strobl		ifconfig bge0 media auto mediaopt flowcontrol
351efd4fc3fSMarius Strobl
352efd4fc3fSMarius Strobl	Along with the above mentioned changes generic support for setting
353efd4fc3fSMarius Strobl	1000baseT master mode also has been added and brgphy(4), ciphy(4),
354efd4fc3fSMarius Strobl	e1000phy(4) as well as ip1000phy(4) have been converted to take
355efd4fc3fSMarius Strobl	advantage of it.  This means that these drivers now no longer take the
356efd4fc3fSMarius Strobl	link0 parameter for selecting master mode but the master media option
357efd4fc3fSMarius Strobl	has to be used instead, for example like in the following:
358efd4fc3fSMarius Strobl		ifconfig bge0 media 1000baseT mediaopt full-duplex,master
359efd4fc3fSMarius Strobl
360efd4fc3fSMarius Strobl	Selection of master mode now is also available with all other PHY
361efd4fc3fSMarius Strobl	drivers supporting 1000baseT.
362efd4fc3fSMarius Strobl
363dbc42409SLawrence Stewart20101111:
364dbc42409SLawrence Stewart	The TCP stack has received a significant update to add support for
365dbc42409SLawrence Stewart	modularised congestion control and generally improve the clarity of
366dbc42409SLawrence Stewart	congestion control decisions. Bump __FreeBSD_version to 900025. User
367dbc42409SLawrence Stewart	space tools that rely on the size of struct tcpcb in tcp_var.h (e.g.
368dbc42409SLawrence Stewart	sockstat) need to be recompiled.
369dbc42409SLawrence Stewart
370fd77eab9SGordon Tetlow20101002:
371fd77eab9SGordon Tetlow	The man(1) utility has been replaced by a new version that no longer
372fd77eab9SGordon Tetlow	uses /etc/manpath.config. Please consult man.conf(5) for how to
373fd77eab9SGordon Tetlow	migrate local entries to the new format.
374fd77eab9SGordon Tetlow
375337299c6SEd Maste20100928:
376337299c6SEd Maste	The copyright strings printed by login(1) and sshd(8) at the time of a
377337299c6SEd Maste	new connection have been removed to follow other operating systems and
378337299c6SEd Maste	upstream sshd.
379337299c6SEd Maste
380f8fc818bSAndriy Gapon20100915:
381f8fc818bSAndriy Gapon	A workaround for a fixed ld bug has been removed in kernel code,
382f8fc818bSAndriy Gapon	so make sure that your system ld is built from sources after
383130a0815SAndriy Gapon	revision 210245 from 2010-07-19 (r211583 if building head kernel
384130a0815SAndriy Gapon	on stable/8, r211584 for stable/7; both from 2010-08-21).
385130a0815SAndriy Gapon	A symptom of incorrect ld version is different addresses for
386130a0815SAndriy Gapon	set_pcpu section and __start_set_pcpu symbol in kernel and/or modules.
387f8fc818bSAndriy Gapon
388d69eb520SRui Paulo20100913:
389d3a8a8b9SHiroki Sato	The $ipv6_prefer variable in rc.conf(5) has been split into
390d3a8a8b9SHiroki Sato	$ip6addrctl_policy and $ipv6_activate_all_interfaces.
391d3a8a8b9SHiroki Sato
392d3a8a8b9SHiroki Sato	The $ip6addrctl_policy is a variable to choose a pre-defined
393d3a8a8b9SHiroki Sato	address selection policy set by ip6addrctl(8).  A value
394d3a8a8b9SHiroki Sato	"ipv4_prefer", "ipv6_prefer" or "AUTO" can be specified.  The
395d3a8a8b9SHiroki Sato	default is "AUTO".
396d3a8a8b9SHiroki Sato
397d3a8a8b9SHiroki Sato	The $ipv6_activate_all_interfaces specifies whether IFDISABLED
398d3a8a8b9SHiroki Sato	flag (see an entry of 20090926) is set on an interface with no
399d3a8a8b9SHiroki Sato	corresponding $ifconfig_IF_ipv6 line.  The default is "NO" for
400d3a8a8b9SHiroki Sato	security reason.  If you want IPv6 link-local address on all
401d3a8a8b9SHiroki Sato	interfaces by default, set this to "YES".
402d3a8a8b9SHiroki Sato
403d3a8a8b9SHiroki Sato	The old ipv6_prefer="YES" is equivalent to
404d3a8a8b9SHiroki Sato	ipv6_activate_all_interfaces="YES" and
405d3a8a8b9SHiroki Sato	ip6addrctl_policy="ipv6_prefer".
406d3a8a8b9SHiroki Sato
407d3a8a8b9SHiroki Sato20100913:
408d69eb520SRui Paulo	DTrace has grown support for userland tracing. Due to this, DTrace is
409d69eb520SRui Paulo	now i386 and amd64 only.
410d69eb520SRui Paulo	dtruss(1) is now installed by default on those systems and a new
411d69eb520SRui Paulo	kernel module is needed for userland tracing: fasttrap.
412d69eb520SRui Paulo	No changes to your kernel config file are necessary to enable
413d69eb520SRui Paulo	userland tracing, but you might consider adding 'STRIP=' and
414d69eb520SRui Paulo	'CFLAGS+=-fno-omit-frame-pointer' to your make.conf if you want
415d69eb520SRui Paulo	to have informative userland stack traces in DTrace (ustack).
416d69eb520SRui Paulo
41740650455SRui Paulo20100725:
41840650455SRui Paulo	The acpi_aiboost(4) driver has been removed in favor of the new
41940650455SRui Paulo	aibs(4) driver. You should update your kernel configuration file.
42040650455SRui Paulo
4214dc88ebeSGabor Kovesdan20100722:
4224dc88ebeSGabor Kovesdan	BSD grep has been imported to the base system and it is built by
4234dc88ebeSGabor Kovesdan	default.  It is completely BSD licensed, highly GNU-compatible, uses
4244dc88ebeSGabor Kovesdan	less memory than its GNU counterpart and has a small codebase.
4254dc88ebeSGabor Kovesdan	However, it is slower than its GNU counterpart, which is mostly
4264dc88ebeSGabor Kovesdan	noticeable for larger searches, for smaller ones it is measurable
4274dc88ebeSGabor Kovesdan	but not significant.  The reason is complex, the most important factor
4284dc88ebeSGabor Kovesdan	is that we lack a modern and efficient regex library and GNU
4294dc88ebeSGabor Kovesdan	overcomes this by optimizing the searches internally.  Future work
4304dc88ebeSGabor Kovesdan	on improving the regex performance is planned, for the meantime,
4314dc88ebeSGabor Kovesdan	users that need better performance, can build GNU grep instead by
4324dc88ebeSGabor Kovesdan	setting the WITH_GNU_GREP knob.
4332965a453SKip Macy
4348fc25799SMartin Matuska20100713:
435c3e289e1SNathan Whitehorn	Due to the import of powerpc64 support, all existing powerpc kernel
436c3e289e1SNathan Whitehorn	configuration files must be updated with a machine directive like this:
437c3e289e1SNathan Whitehorn	    machine powerpc powerpc
438c3e289e1SNathan Whitehorn
439c3e289e1SNathan Whitehorn	In addition, an updated config(8) is required to build powerpc kernels
440c3e289e1SNathan Whitehorn	after this change.
441c3e289e1SNathan Whitehorn
442c3e289e1SNathan Whitehorn20100713:
4438fc25799SMartin Matuska	A new version of ZFS (version 15) has been merged to -HEAD.
4448fc25799SMartin Matuska	This version uses a python library for the following subcommands:
4458fc25799SMartin Matuska	zfs allow, zfs unallow, zfs groupspace, zfs userspace.
4468fc25799SMartin Matuska	For full functionality of these commands the following port must
4478fc25799SMartin Matuska	be installed: sysutils/py-zfs
4488fc25799SMartin Matuska
4492965a453SKip Macy20100429:
4502965a453SKip Macy	'vm_page's are now hashed by physical address to an array of mutexes.
4512965a453SKip Macy	Currently this is only used to serialize access to hold_count. Over
4522965a453SKip Macy	time the page queue mutex will be peeled away. This changes the size
4532965a453SKip Macy	of pmap on every architecture. And requires all callers of vm_page_hold
4542965a453SKip Macy	and vm_page_unhold to be updated.
4552965a453SKip Macy
45621edb039SAlexander Leidinger20100402:
45721edb039SAlexander Leidinger	WITH_CTF can now be specified in src.conf (not recommended, there
45821edb039SAlexander Leidinger	are some problems with static executables), make.conf (would also
45921edb039SAlexander Leidinger	affect ports which do not use GNU make and do not override the
46021edb039SAlexander Leidinger	compile targets) or in the kernel config (via "makeoptions
46121edb039SAlexander Leidinger	WITH_CTF=yes").
46221edb039SAlexander Leidinger	When WITH_CTF was specified there before this was silently ignored,
46321edb039SAlexander Leidinger	so make sure that WITH_CTF is not used in places which could lead
46421edb039SAlexander Leidinger	to unwanted behavior.
46521edb039SAlexander Leidinger
466841c0c7eSNathan Whitehorn20100311:
467841c0c7eSNathan Whitehorn	The kernel option COMPAT_IA32 has been replaced with COMPAT_FREEBSD32
468841c0c7eSNathan Whitehorn	to allow 32-bit compatibility on non-x86 platforms. All kernel
469841c0c7eSNathan Whitehorn	configurations on amd64 and ia64 platforms using these options must
470841c0c7eSNathan Whitehorn	be modified accordingly.
471841c0c7eSNathan Whitehorn
472279d8efeSEd Schouten20100113:
473279d8efeSEd Schouten	The utmp user accounting database has been replaced with utmpx,
474279d8efeSEd Schouten	the user accounting interface standardized by POSIX.
475279d8efeSEd Schouten	Unfortunately the semantics of utmp and utmpx don't match,
476279d8efeSEd Schouten	making it practically impossible to support both interfaces.
477279d8efeSEd Schouten	The user accounting database is used by tools like finger(1),
478279d8efeSEd Schouten	last(1), talk(1), w(1) and ac(8).
479279d8efeSEd Schouten
480279d8efeSEd Schouten	All applications in the base system use utmpx.  This means only
481279d8efeSEd Schouten	local binaries (e.g. from the ports tree) may still use these
482279d8efeSEd Schouten	utmp database files.  These applications must be rebuilt to make
483279d8efeSEd Schouten	use of utmpx.
484279d8efeSEd Schouten
485279d8efeSEd Schouten	After the system has been upgraded, it is safe to remove the old
486279d8efeSEd Schouten	log files (/var/run/utmp, /var/log/lastlog and /var/log/wtmp*),
4875ab7f1fcSEd Schouten	assuming their contents is of no importance anymore.  Old wtmp
4885ab7f1fcSEd Schouten	databases can only be used by last(1) and ac(8) after they have
4895ab7f1fcSEd Schouten	been converted to the new format using wtmpcvt(1).
490279d8efeSEd Schouten
491f7829d0dSAttilio Rao20100108:
492f7829d0dSAttilio Rao	Introduce the kernel thread "deadlock resolver" (which can be enabled
493f7829d0dSAttilio Rao	via the DEADLKRES option, see NOTES for more details) and the
494f7829d0dSAttilio Rao	sleepq_type() function for sleepqueues.
495f7829d0dSAttilio Rao
496f2cb5f03SHajimu UMEMOTO20091202:
497f2cb5f03SHajimu UMEMOTO	The rc.firewall and rc.firewall6 were unified, and
498f2cb5f03SHajimu UMEMOTO	rc.firewall6 and rc.d/ip6fw were removed.
499f2cb5f03SHajimu UMEMOTO	According to the removal of rc.d/ip6fw, ipv6_firewall_* rc
500f2cb5f03SHajimu UMEMOTO	variables are obsoleted.  Instead, the following new rc
501f2cb5f03SHajimu UMEMOTO	variables are added to rc.d/ipfw:
502f2cb5f03SHajimu UMEMOTO
503f2cb5f03SHajimu UMEMOTO		firewall_client_net_ipv6, firewall_simple_iif_ipv6,
504f2cb5f03SHajimu UMEMOTO		firewall_simple_inet_ipv6, firewall_simple_oif_ipv6,
505f2cb5f03SHajimu UMEMOTO		firewall_simple_onet_ipv6, firewall_trusted_ipv6
506f2cb5f03SHajimu UMEMOTO
507f2cb5f03SHajimu UMEMOTO	The meanings correspond to the relevant IPv4 variables.
508f2cb5f03SHajimu UMEMOTO
509e409c5c8SChristian Brueffer20091125:
510e409c5c8SChristian Brueffer	8.0-RELEASE.
511e409c5c8SChristian Brueffer
512e42fc368SEd Schouten20091113:
513e42fc368SEd Schouten	The default terminal emulation for syscons(4) has been changed
5144b2361f8SEd Schouten	from cons25 to xterm on all platforms except pc98.  This means
5154b2361f8SEd Schouten	that the /etc/ttys file needs to be updated to ensure correct
5164b2361f8SEd Schouten	operation of applications on the console.
517e42fc368SEd Schouten
518e42fc368SEd Schouten	The terminal emulation style can be toggled per window by using
5194b2361f8SEd Schouten	vidcontrol(1)'s -T flag.  The TEKEN_CONS25 kernel configuration
5204b2361f8SEd Schouten	options can be used to change the compile-time default back to
5214b2361f8SEd Schouten	cons25.
522e42fc368SEd Schouten
523e42fc368SEd Schouten	To prevent graphical artifacts, make sure the TERM environment
524e42fc368SEd Schouten	variable is set to match the terminal emulation that is being
525e42fc368SEd Schouten	performed by syscons(4).
526e42fc368SEd Schouten
52707ddebb5SRui Paulo20091109:
52807ddebb5SRui Paulo	The layout of the structure ieee80211req_scan_result has changed.
52907ddebb5SRui Paulo	Applications that require wireless scan results (e.g. ifconfig(8))
53007ddebb5SRui Paulo	from net80211 need to be recompiled.
53107ddebb5SRui Paulo
53296b4300cSDoug Barton	Applications such as wpa_supplicant(8) may require a full world
53396b4300cSDoug Barton	build without using NO_CLEAN in order to get synchronized with the
53496b4300cSDoug Barton	new structure.
53596b4300cSDoug Barton
53663b49c2bSRui Paulo20091025:
53763b49c2bSRui Paulo	The iwn(4) driver has been updated to support the 5000 and 5150 series.
53863b49c2bSRui Paulo	There's one kernel module for each firmware. Adding "device iwnfw"
53963b49c2bSRui Paulo	to the kernel configuration file means including all three firmware
54063b49c2bSRui Paulo	images inside the kernel. If you want to include just the one for
54136daf049SEitan Adler	your wireless card, use the devices iwn4965fw, iwn5000fw or
54263b49c2bSRui Paulo	iwn5150fw.
54363b49c2bSRui Paulo
5442e77c5abSHiroki Sato20090926:
5452e77c5abSHiroki Sato	The rc.d/network_ipv6, IPv6 configuration script has been integrated
5462e77c5abSHiroki Sato	into rc.d/netif.  The changes are the following:
5472e77c5abSHiroki Sato
5482e77c5abSHiroki Sato	1. To use IPv6, simply define $ifconfig_IF_ipv6 like $ifconfig_IF
5492e77c5abSHiroki Sato	   for IPv4.  For aliases, $ifconfig_IF_aliasN should be used.
5502e77c5abSHiroki Sato	   Note that both variables need the "inet6" keyword at the head.
5512e77c5abSHiroki Sato
5522e77c5abSHiroki Sato	   Do not set $ipv6_network_interfaces manually if you do not
5532e77c5abSHiroki Sato	   understand what you are doing.  It is not needed in most cases.
5542e77c5abSHiroki Sato
5552e77c5abSHiroki Sato	   $ipv6_ifconfig_IF and $ipv6_ifconfig_IF_aliasN still work, but
5562e77c5abSHiroki Sato	   they are obsolete.
5572e77c5abSHiroki Sato
5582e77c5abSHiroki Sato	2. $ipv6_enable is obsolete.  Use $ipv6_prefer and
5592e77c5abSHiroki Sato	   "inet6 accept_rtadv" keyword in ifconfig(8) instead.
5602e77c5abSHiroki Sato
5612e77c5abSHiroki Sato	   If you define $ipv6_enable=YES, it means $ipv6_prefer=YES and
5622e77c5abSHiroki Sato	   all configured interfaces have "inet6 accept_rtadv" in the
5632e77c5abSHiroki Sato	   $ifconfig_IF_ipv6.  These are for backward compatibility.
5642e77c5abSHiroki Sato
5652e77c5abSHiroki Sato	3. A new variable $ipv6_prefer has been added.  If NO, IPv6
5662e77c5abSHiroki Sato	   functionality of interfaces with no corresponding
5672e77c5abSHiroki Sato	   $ifconfig_IF_ipv6 is disabled by using "inet6 ifdisabled" flag,
5682e77c5abSHiroki Sato	   and the default address selection policy of ip6addrctl(8)
5692e77c5abSHiroki Sato	   is the IPv4-preferred one (see rc.d/ip6addrctl for more details).
5702e77c5abSHiroki Sato	   Note that if you want to configure IPv6 functionality on the
5712e77c5abSHiroki Sato	   disabled interfaces after boot, first you need to clear the flag by
5722e77c5abSHiroki Sato	   using ifconfig(8) like:
5732e77c5abSHiroki Sato
5742e77c5abSHiroki Sato		ifconfig em0 inet6 -ifdisabled
5752e77c5abSHiroki Sato
5762e77c5abSHiroki Sato	   If YES, the default address selection policy is set as
5772e77c5abSHiroki Sato	   IPv6-preferred.
5782e77c5abSHiroki Sato
5792e77c5abSHiroki Sato	   The default value of $ipv6_prefer is NO.
5802e77c5abSHiroki Sato
5812e77c5abSHiroki Sato	4. If your system need to receive Router Advertisement messages,
5822e77c5abSHiroki Sato	   define "inet6 accept_rtadv" in $ifconfig_IF_ipv6.  The rc(8)
5832e77c5abSHiroki Sato	   scripts automatically invoke rtsol(8) when the interface becomes
5842e77c5abSHiroki Sato	   UP.  The Router Advertisement messages are used for SLAAC
5852e77c5abSHiroki Sato	   (State-Less Address AutoConfiguration).
5862e77c5abSHiroki Sato
587350036a0SRui Paulo20090922:
588350036a0SRui Paulo	802.11s D3.03 support was committed. This is incompatible with the
589350036a0SRui Paulo	previous code, which was based on D3.0.
590350036a0SRui Paulo
5912e77c5abSHiroki Sato20090912:
5922e77c5abSHiroki Sato	A sysctl variable net.inet6.ip6.accept_rtadv now sets the default value
5932e77c5abSHiroki Sato	of a per-interface flag ND6_IFF_ACCEPT_RTADV, not a global knob to
5942e77c5abSHiroki Sato	control whether accepting Router Advertisement messages or not.
5952e77c5abSHiroki Sato	Also, a per-interface flag ND6_IFF_AUTO_LINKLOCAL has been added and
5962e77c5abSHiroki Sato	a sysctl variable net.inet6.ip6.auto_linklocal is its default value.
5972e77c5abSHiroki Sato	The ifconfig(8) utility now supports these flags.
5982e77c5abSHiroki Sato
59963e1d3dfSPawel Jakub Dawidek20090910:
60063e1d3dfSPawel Jakub Dawidek	ZFS snapshots are now mounted with MNT_IGNORE flag. Use -v option for
60163e1d3dfSPawel Jakub Dawidek	mount(8) and -a option for df(1) to see them.
60263e1d3dfSPawel Jakub Dawidek
603411c7658SWarner Losh20090825:
604411c7658SWarner Losh	The old tunable hw.bus.devctl_disable has been superseded by
605411c7658SWarner Losh	hw.bus.devctl_queue.  hw.bus.devctl_disable=1 in loader.conf should be
606411c7658SWarner Losh	replaced by hw.bus.devctl_queue=0.  The default for this new tunable
607411c7658SWarner Losh	is 1000.
608411c7658SWarner Losh
609dc6fbf65SAttilio Rao20090813:
610456b5dd8SWarner Losh	Remove the option STOP_NMI.  The default action is now to use NMI only
611456b5dd8SWarner Losh	for KDB via the newly introduced function stop_cpus_hard() and
612456b5dd8SWarner Losh	maintain stop_cpus() to just use a normal IPI_STOP on ia32 and amd64.
613456b5dd8SWarner Losh
614456b5dd8SWarner Losh20090803:
615f6a4f4b5SWarner Losh	The stable/8 branch created in subversion.  This corresponds to the
616f6a4f4b5SWarner Losh	RELENG_8 branch in CVS.
617dc6fbf65SAttilio Rao
6183ca3047aSKen Smith20090719:
619456b5dd8SWarner Losh	Bump the shared library version numbers for all libraries that do not
620456b5dd8SWarner Losh	use symbol versioning as part of the 8.0-RELEASE cycle.  Bump
621456b5dd8SWarner Losh	__FreeBSD_version to 800105.
6223ca3047aSKen Smith
623eddfbb76SRobert Watson20090714:
624456b5dd8SWarner Losh	Due to changes in the implementation of virtual network stack support,
625456b5dd8SWarner Losh	all network-related kernel modules must be recompiled.  As this change
626456b5dd8SWarner Losh	breaks the ABI, bump __FreeBSD_version to 800104.
627eddfbb76SRobert Watson
628237fbe0aSLawrence Stewart20090713:
629456b5dd8SWarner Losh	The TOE interface to the TCP syncache has been modified to remove
630456b5dd8SWarner Losh	struct tcpopt (<netinet/tcp_var.h>) from the ABI of the network stack.
631456b5dd8SWarner Losh	The cxgb driver is the only TOE consumer affected by this change, and
632456b5dd8SWarner Losh	needs to be recompiled along with the kernel. As this change breaks
633456b5dd8SWarner Losh	the ABI, bump __FreeBSD_version to 800103.
634237fbe0aSLawrence Stewart
635962ebef8SLawrence Stewart20090712:
636962ebef8SLawrence Stewart	Padding has been added to struct tcpcb, sackhint and tcpstat in
637962ebef8SLawrence Stewart	<netinet/tcp_var.h> to facilitate future MFCs and bug fixes whilst
6381733d35cSRuslan Ermilov	maintaining the ABI. However, this change breaks the ABI, so bump
639962ebef8SLawrence Stewart	__FreeBSD_version to 800102. User space tools that rely on the size of
640962ebef8SLawrence Stewart	any of these structs (e.g. sockstat) need to be recompiled.
641962ebef8SLawrence Stewart
642bab42aadSDoug Rabson20090630:
643456b5dd8SWarner Losh	The NFS_LEGACYRPC option has been removed along with the old kernel
644456b5dd8SWarner Losh	RPC implementation that this option selected. Kernel configurations
645456b5dd8SWarner Losh	may need to be adjusted.
646bab42aadSDoug Rabson
6476cb7f168SBrooks Davis20090629:
648456b5dd8SWarner Losh	The network interface device nodes at /dev/net/<interface> have been
649456b5dd8SWarner Losh	removed.  All ioctl operations can be performed the normal way using
650456b5dd8SWarner Losh	routing sockets.  The kqueue functionality can generally be replaced
651456b5dd8SWarner Losh	with routing sockets.
6526cb7f168SBrooks Davis
653944bc81dSMarc Fonvieille20090628:
654456b5dd8SWarner Losh	The documentation from the FreeBSD Documentation Project (Handbook,
655456b5dd8SWarner Losh	FAQ, etc.) is now installed via packages by sysinstall(8) and under
656456b5dd8SWarner Losh	the /usr/local/share/doc/freebsd directory instead of /usr/share/doc.
657944bc81dSMarc Fonvieille
658f5e4c105SJohn Baldwin20090624:
659456b5dd8SWarner Losh	The ABI of various structures related to the SYSV IPC API have been
660456b5dd8SWarner Losh	changed.  As a result, the COMPAT_FREEBSD[456] and COMPAT_43 kernel
661456b5dd8SWarner Losh	options now all require COMPAT_FREEBSD7.  Bump __FreeBSD_version to
662456b5dd8SWarner Losh	800100.
663f5e4c105SJohn Baldwin
664b58ea5f3SBjoern A. Zeeb20090622:
665456b5dd8SWarner Losh	Layout of struct vnet has changed as routing related variables were
666456b5dd8SWarner Losh	moved to their own Vimage module. Modules need to be recompiled.  Bump
667456b5dd8SWarner Losh	__FreeBSD_version to 800099.
668b58ea5f3SBjoern A. Zeeb
669838d9858SBrooks Davis20090619:
670456b5dd8SWarner Losh	NGROUPS_MAX and NGROUPS have been increased from 16 to 1023 and 1024
671456b5dd8SWarner Losh	respectively.  As long as no more than 16 groups per process are used,
672456b5dd8SWarner Losh	no changes should be visible.  When more than 16 groups are used, old
673456b5dd8SWarner Losh	binaries may fail if they call getgroups() or getgrouplist() with
674456b5dd8SWarner Losh	statically sized storage.  Recompiling will work around this, but
675456b5dd8SWarner Losh	applications should be modified to use dynamically allocated storage
676456b5dd8SWarner Losh	for group arrays as POSIX.1-2008 does not cap an implementation's
677456b5dd8SWarner Losh	number of supported groups at NGROUPS_MAX+1 as previous versions did.
678838d9858SBrooks Davis
679456b5dd8SWarner Losh	NFS and portalfs mounts may also be affected as the list of groups is
680456b5dd8SWarner Losh	truncated to 16.  Users of NFS who use more than 16 groups, should
681456b5dd8SWarner Losh	take care that negative group permissions are not used on the exported
682456b5dd8SWarner Losh	file systems as they will not be reliable unless a GSSAPI based
683456b5dd8SWarner Losh	authentication method is used.
684838d9858SBrooks Davis
685651175c9SAttilio Rao20090616:
686456b5dd8SWarner Losh	The compiling option ADAPTIVE_LOCKMGRS has been introduced.  This
687456b5dd8SWarner Losh	option compiles in the support for adaptive spinning for lockmgrs
688456b5dd8SWarner Losh	which want to enable it.  The lockinit() function now accepts the flag
689456b5dd8SWarner Losh	LK_ADAPTIVE in order to make the lock object subject to adaptive
690456b5dd8SWarner Losh	spinning when both held in write and read mode.
691651175c9SAttilio Rao
6922c727cb9SSam Leffler20090613:
693456b5dd8SWarner Losh	The layout of the structure returned by IEEE80211_IOC_STA_INFO has
694456b5dd8SWarner Losh	changed.  User applications that use this ioctl need to be rebuilt.
6952c727cb9SSam Leffler
696f089869fSMarko Zec20090611:
697456b5dd8SWarner Losh	The layout of struct thread has changed.  Kernel and modules need to
698456b5dd8SWarner Losh	be rebuilt.
699f089869fSMarko Zec
700bc29160dSMarko Zec20090608:
701456b5dd8SWarner Losh	The layout of structs ifnet, domain, protosw and vnet_net has changed.
702456b5dd8SWarner Losh	Kernel modules need to be rebuilt.  Bump __FreeBSD_version to 800097.
703bc29160dSMarko Zec
70489f98d57SEd Schouten20090602:
70589f98d57SEd Schouten	window(1) has been removed from the base system. It can now be
70689f98d57SEd Schouten	installed from ports. The port is called misc/window.
70789f98d57SEd Schouten
708c2c2a7c1SBjoern A. Zeeb20090601:
709456b5dd8SWarner Losh	The way we are storing and accessing `routing table' entries has
710456b5dd8SWarner Losh	changed. Programs reading the FIB, like netstat, need to be
711456b5dd8SWarner Losh	re-compiled.
712c2c2a7c1SBjoern A. Zeeb
713529cb8e3SRobert Watson20090601:
714529cb8e3SRobert Watson	A new netisr implementation has been added for FreeBSD 8.  Network
715529cb8e3SRobert Watson	file system modules, such as igmp, ipdivert, and others, should be
716529cb8e3SRobert Watson	rebuilt.
717529cb8e3SRobert Watson	Bump __FreeBSD_version to 800096.
718529cb8e3SRobert Watson
7192a61ba47SEdward Tomasz Napierala20090530:
720456b5dd8SWarner Losh	Remove the tunable/sysctl debug.mpsafevfs as its initial purpose is no
721456b5dd8SWarner Losh	more valid.
722faef64ccSAttilio Rao
723faef64ccSAttilio Rao20090530:
7242a61ba47SEdward Tomasz Napierala	Add VOP_ACCESSX(9).  File system modules need to be rebuilt.
7252a61ba47SEdward Tomasz Napierala	Bump __FreeBSD_version to 800094.
7262a61ba47SEdward Tomasz Napierala
727b89fed67SEdward Tomasz Napierala20090529:
728456b5dd8SWarner Losh	Add mnt_xflag field to 'struct mount'.  File system modules need to be
729456b5dd8SWarner Losh	rebuilt.
730b89fed67SEdward Tomasz Napierala	Bump __FreeBSD_version to 800093.
731b89fed67SEdward Tomasz Napierala
7321ae1c2a3SAttilio Rao20090528:
7331ae1c2a3SAttilio Rao	The compiling option ADAPTIVE_SX has been retired while it has been
7341ae1c2a3SAttilio Rao	introduced the option NO_ADAPTIVE_SX which handles the reversed logic.
7351ae1c2a3SAttilio Rao	The KPI for sx_init_flags() changes as accepting flags:
736456b5dd8SWarner Losh	SX_ADAPTIVESPIN flag has been retired while the SX_NOADAPTIVE flag has
737456b5dd8SWarner Losh	been introduced in order to handle the reversed logic.
7381ae1c2a3SAttilio Rao	Bump __FreeBSD_version to 800092.
7391ae1c2a3SAttilio Rao
7400304c731SJamie Gritton20090527:
7410304c731SJamie Gritton	Add support for hierarchical jails.  Remove global securelevel.
7420304c731SJamie Gritton	Bump __FreeBSD_version to 800091.
7430304c731SJamie Gritton
744dfc79e89SEdwin Groothuis20090523:
74537f17770SMarko Zec	The layout of struct vnet_net has changed, therefore modules
74637f17770SMarko Zec	need to be rebuilt.
74737f17770SMarko Zec	Bump __FreeBSD_version to 800090.
74837f17770SMarko Zec
74937f17770SMarko Zec20090523:
750456b5dd8SWarner Losh	The newly imported zic(8) produces a new format in the output. Please
751456b5dd8SWarner Losh	run tzsetup(8) to install the newly created data to /etc/localtime.
752dfc79e89SEdwin Groothuis
75323790ac0SSam Leffler20090520:
7549360ae40SAndrew Thompson	The sysctl tree for the usb stack has renamed from hw.usb2.* to
7559360ae40SAndrew Thompson	hw.usb.* and is now consistent again with previous releases.
7569360ae40SAndrew Thompson
7579360ae40SAndrew Thompson20090520:
758456b5dd8SWarner Losh	802.11 monitor mode support was revised and driver api's were changed.
759456b5dd8SWarner Losh	Drivers dependent on net80211 now support DLT_IEEE802_11_RADIO instead
760456b5dd8SWarner Losh	of DLT_IEEE802_11.  No user-visible data structures were changed but
761456b5dd8SWarner Losh	applications that use DLT_IEEE802_11 may require changes.
76223790ac0SSam Leffler	Bump __FreeBSD_version to 800088.
76323790ac0SSam Leffler
764f6dfe47aSMarko Zec20090430:
765f6dfe47aSMarko Zec	The layout of the following structs has changed: sysctl_oid,
766f6dfe47aSMarko Zec	socket, ifnet, inpcbinfo, tcpcb, syncache_head, vnet_inet,
767f6dfe47aSMarko Zec	vnet_inet6 and vnet_ipfw.  Most modules need to be rebuild or
768f6dfe47aSMarko Zec	panics may be experienced.  World rebuild is required for
769f6dfe47aSMarko Zec	correctly checking networking state from userland.
770f6dfe47aSMarko Zec	Bump __FreeBSD_version to 800085.
771f6dfe47aSMarko Zec
77233cde130SBruce M Simpson20090429:
77333cde130SBruce M Simpson	MLDv2 and Source-Specific Multicast (SSM) have been merged
77433cde130SBruce M Simpson	to the IPv6 stack. VIMAGE hooks are in but not yet used.
77533cde130SBruce M Simpson	The implementation of SSM within FreeBSD's IPv6 stack closely
77633cde130SBruce M Simpson	follows the IPv4 implementation.
77733cde130SBruce M Simpson
77833cde130SBruce M Simpson	For kernel developers:
77933cde130SBruce M Simpson
78033cde130SBruce M Simpson	* The most important changes are that the ip6_output() and
78133cde130SBruce M Simpson	  ip6_input() paths no longer take the IN6_MULTI_LOCK,
78233cde130SBruce M Simpson	  and this lock has been downgraded to a non-recursive mutex.
78333cde130SBruce M Simpson
78433cde130SBruce M Simpson	* As with the changes to the IPv4 stack to support SSM, filtering
78533cde130SBruce M Simpson	  of inbound multicast traffic must now be performed by transport
78633cde130SBruce M Simpson	  protocols within the IPv6 stack. This does not apply to TCP and
78733cde130SBruce M Simpson	  SCTP, however, it does apply to UDP in IPv6 and raw IPv6.
78833cde130SBruce M Simpson
78933cde130SBruce M Simpson	* The KPIs used by IPv6 multicast are similar to those used by
79033cde130SBruce M Simpson	  the IPv4 stack, with the following differences:
79133cde130SBruce M Simpson	   * im6o_mc_filter() is analogous to imo_multicast_filter().
79233cde130SBruce M Simpson	   * The legacy KAME entry points in6_joingroup and in6_leavegroup()
79333cde130SBruce M Simpson	     are shimmed to in6_mc_join() and in6_mc_leave() respectively.
79433cde130SBruce M Simpson	   * IN6_LOOKUP_MULTI() has been deprecated and removed.
79533cde130SBruce M Simpson	   * IPv6 relies on MLD for the DAD mechanism. KAME's internal KPIs
79633cde130SBruce M Simpson	     for MLDv1 have an additional 'timer' argument which is used to
79733cde130SBruce M Simpson	     jitter the initial membership report for the solicited-node
79833cde130SBruce M Simpson	     multicast membership on-link.
79933cde130SBruce M Simpson	   * This is not strictly needed for MLDv2, which already jitters
80033cde130SBruce M Simpson	     its report transmissions.  However, the 'timer' argument is
80133cde130SBruce M Simpson	     preserved in case MLDv1 is active on the interface.
80233cde130SBruce M Simpson
80333cde130SBruce M Simpson	* The KAME linked-list based IPv6 membership implementation has
80433cde130SBruce M Simpson	  been refactored to use a vector similar to that used by the IPv4
80533cde130SBruce M Simpson	  stack.
80633cde130SBruce M Simpson	  Code which maintains a list of its own multicast memberships
80733cde130SBruce M Simpson	  internally, e.g. carp, has been updated to reflect the new
80833cde130SBruce M Simpson	  semantics.
80933cde130SBruce M Simpson
81033cde130SBruce M Simpson	* There is a known Lock Order Reversal (LOR) due to in6_setscope()
81133cde130SBruce M Simpson	  acquiring the IF_AFDATA_LOCK and being called within ip6_output().
81233cde130SBruce M Simpson	  Whilst MLDv2 tries to avoid this otherwise benign LOR, it is an
81333cde130SBruce M Simpson	  implementation constraint which needs to be addressed in HEAD.
81433cde130SBruce M Simpson
81533cde130SBruce M Simpson	For application developers:
81633cde130SBruce M Simpson
81733cde130SBruce M Simpson	* The changes are broadly similar to those made for the IPv4
81833cde130SBruce M Simpson	  stack.
81933cde130SBruce M Simpson
82033cde130SBruce M Simpson	* The use of IPv4 and IPv6 multicast socket options on the same
82133cde130SBruce M Simpson	  socket, using mapped addresses, HAS NOT been tested or supported.
82233cde130SBruce M Simpson
82333cde130SBruce M Simpson	* There are a number of issues with the implementation of various
82433cde130SBruce M Simpson	  IPv6 multicast APIs which need to be resolved in the API surface
82533cde130SBruce M Simpson	  before the implementation is fully compatible with KAME userland
82633cde130SBruce M Simpson	  use, and these are mostly to do with interface index treatment.
82733cde130SBruce M Simpson
82833cde130SBruce M Simpson	* The literature available discusses the use of either the delta / ASM
82933cde130SBruce M Simpson	  API with setsockopt(2)/getsockopt(2), or the full-state / ASM API
83033cde130SBruce M Simpson	  using setsourcefilter(3)/getsourcefilter(3). For more information
83133cde130SBruce M Simpson	  please refer to RFC 3768, 'Socket Interface Extensions for
83233cde130SBruce M Simpson	  Multicast Source Filters'.
83333cde130SBruce M Simpson
83433cde130SBruce M Simpson	* Applications which use the published RFC 3678 APIs should be fine.
83533cde130SBruce M Simpson
83633cde130SBruce M Simpson	For systems administrators:
83733cde130SBruce M Simpson
83833cde130SBruce M Simpson	* The mtest(8) utility has been refactored to support IPv6, in
83933cde130SBruce M Simpson	  addition to IPv4. Interface addresses are no longer accepted
84033cde130SBruce M Simpson	  as arguments, their names must be used instead. The utility
84133cde130SBruce M Simpson	  will map the interface name to its first IPv4 address as
84233cde130SBruce M Simpson	  returned by getifaddrs(3).
84333cde130SBruce M Simpson
84433cde130SBruce M Simpson	* The ifmcstat(8) utility has also been updated to print the MLDv2
84533cde130SBruce M Simpson	  endpoint state and source filter lists via sysctl(3).
84633cde130SBruce M Simpson
84733cde130SBruce M Simpson	* The net.inet6.ip6.mcast.loop sysctl may be tuned to 0 to disable
84833cde130SBruce M Simpson	  loopback of IPv6 multicast datagrams by default; it defaults to 1
84933cde130SBruce M Simpson	  to preserve the existing behaviour. Disabling multicast loopback is
85033cde130SBruce M Simpson	  recommended for optimal system performance.
85133cde130SBruce M Simpson
85233cde130SBruce M Simpson	* The IPv6 MROUTING code has been changed to examine this sysctl
85333cde130SBruce M Simpson	  instead of attempting to perform a group lookup before looping
85433cde130SBruce M Simpson	  back forwarded datagrams.
85533cde130SBruce M Simpson
85633cde130SBruce M Simpson	Bump __FreeBSD_version to 800084.
85733cde130SBruce M Simpson
8588b8bf775SRobert Watson20090422:
859131cdffbSMaksim Yevmenkin	Implement low-level Bluetooth HCI API.
860131cdffbSMaksim Yevmenkin	Bump __FreeBSD_version to 800083.
861131cdffbSMaksim Yevmenkin
8628b8bf775SRobert Watson20090419:
8638b8bf775SRobert Watson	The layout of struct malloc_type, used by modules to register new
8648b8bf775SRobert Watson	memory allocation types, has changed.  Most modules will need to
8658b8bf775SRobert Watson	be rebuilt or panics may be experienced.
8668b8bf775SRobert Watson	Bump __FreeBSD_version to 800081.
8678b8bf775SRobert Watson
868de4ab55eSKip Macy20090415:
869773b573aSKip Macy	Anticipate overflowing inp_flags - add inp_flags2.
870773b573aSKip Macy	This changes most offsets in inpcb, so checking v4 connection
871773b573aSKip Macy	state will require a world rebuild.
872773b573aSKip Macy	Bump __FreeBSD_version to 800080.
873f146c211SXin LI
874773b573aSKip Macy20090415:
875de4ab55eSKip Macy	Add an llentry to struct route and struct route_in6. Modules
876de4ab55eSKip Macy	embedding a struct route will need to be recompiled.
877de4ab55eSKip Macy	Bump __FreeBSD_version to 800079.
878de4ab55eSKip Macy
879427ac07fSKip Macy20090414:
880427ac07fSKip Macy	The size of rt_metrics_lite and by extension rtentry has changed.
881427ac07fSKip Macy	Networking administration apps will need to be recompiled.
882427ac07fSKip Macy	The route command now supports show as an alias for get, weighting
883427ac07fSKip Macy	of routes, sticky and nostick flags to alter the behavior of stateful
884427ac07fSKip Macy	load balancing.
885427ac07fSKip Macy	Bump __FreeBSD_version to 800078.
8868713ec3dSRenato Botelho
88787437955SMaksim Yevmenkin20090408:
88887437955SMaksim Yevmenkin	Do not use Giant for kbdmux(4) locking. This is wrong and
88987437955SMaksim Yevmenkin	apparently causing more problems than it solves. This will
89087437955SMaksim Yevmenkin	re-open the issue where interrupt handlers may race with
89187437955SMaksim Yevmenkin	kbdmux(4) in polling mode. Typical symptoms include (but
89287437955SMaksim Yevmenkin	not limited to) duplicated and/or missing characters when
89387437955SMaksim Yevmenkin	low level console functions (such as gets) are used while
89487437955SMaksim Yevmenkin	interrupts are enabled (for example geli password prompt,
89587437955SMaksim Yevmenkin	mountroot prompt etc.). Disabling kbdmux(4) may help.
89687437955SMaksim Yevmenkin
8972f6a1858SMarko Zec20090407:
8982f6a1858SMarko Zec	The size of structs vnet_net, vnet_inet and vnet_ipfw has changed;
8992f6a1858SMarko Zec	kernel modules referencing any of the above need to be recompiled.
9002f6a1858SMarko Zec	Bump __FreeBSD_version to 800075.
9012f6a1858SMarko Zec
902781d043cSIvan Voras20090320:
903781d043cSIvan Voras	GEOM_PART has become the default partition slicer for storage devices,
904781d043cSIvan Voras	replacing GEOM_MBR, GEOM_BSD, GEOM_PC98 and GEOM_GPT slicers. It
9059a07b548SIvan Voras	introduces some changes:
9069a07b548SIvan Voras
9079a07b548SIvan Voras	MSDOS/EBR: the devices created from MSDOS extended partition entries
9089a07b548SIvan Voras	(EBR) can be named differently than with GEOM_MBR and are now symlinks
9099a07b548SIvan Voras	to devices with offset-based names. fstabs may need to be modified.
9109a07b548SIvan Voras
9119a07b548SIvan Voras	BSD: the "geometry does not match label" warning is harmless in most
9129a07b548SIvan Voras	cases but it points to problems in file system misalignment with
9139a07b548SIvan Voras	disk geometry. The "c" partition is now implicit, covers the whole
9149a07b548SIvan Voras	top-level drive and cannot be (mis)used by users.
9159a07b548SIvan Voras
9169a07b548SIvan Voras	General: Kernel dumps are now not allowed to be written to devices
9179a07b548SIvan Voras	whose partition types indicate they are meant to be used for file
9189a07b548SIvan Voras	systems (or, in case of MSDOS partitions, as something else than
9199a07b548SIvan Voras	the "386BSD" type).
9209a07b548SIvan Voras
9219a07b548SIvan Voras	Most of these changes date approximately from 200812.
922781d043cSIvan Voras
923443fc317SBruce M Simpson20090319:
9242b78d306SAndrew Thompson	The uscanner(4) driver has been removed from the kernel. This follows
9252b78d306SAndrew Thompson	Linux removing theirs in 2.6 and making libusb the default interface
9262b78d306SAndrew Thompson	(supported by sane).
9272b78d306SAndrew Thompson
9282b78d306SAndrew Thompson20090319:
929443fc317SBruce M Simpson	The multicast forwarding code has been cleaned up. netstat(1)
930443fc317SBruce M Simpson	only relies on KVM now for printing bandwidth upcall meters.
931443fc317SBruce M Simpson	The IPv4 and IPv6 modules are split into ip_mroute_mod and
932443fc317SBruce M Simpson	ip6_mroute_mod respectively. The config(5) options for statically
933443fc317SBruce M Simpson	compiling this code remain the same, i.e. 'options MROUTING'.
934443fc317SBruce M Simpson
9351df14375SRobert Watson20090315:
9361df14375SRobert Watson	Support for the IFF_NEEDSGIANT network interface flag has been
9371df14375SRobert Watson	removed, which means that non-MPSAFE network device drivers are no
9381df14375SRobert Watson	longer supported.  In particular, if_ar, if_sr, and network device
9391df14375SRobert Watson	drivers from the old (legacy) USB stack can no longer be built or
9401df14375SRobert Watson	used.
9411df14375SRobert Watson
942e667034dSRui Paulo20090313:
9437e06afcaSGabor Kovesdan	POSIX.1 Native Language Support (NLS) has been enabled in libc and
9447e06afcaSGabor Kovesdan	a bunch of new language catalog files have also been added.
9457e06afcaSGabor Kovesdan	This means that some common libc messages are now localized and
9467e06afcaSGabor Kovesdan	they depend on the LC_MESSAGES environmental variable.
9477e06afcaSGabor Kovesdan
9487e06afcaSGabor Kovesdan20090313:
949e667034dSRui Paulo	The k8temp(4) driver has been renamed to amdtemp(4) since
9508fb1e038SDavid E. O'Brien	support for Family 10 and Family 11 CPU families was added.
951e667034dSRui Paulo
952a091d2a5SAndrew Thompson20090309:
953d10910e6SBruce M Simpson	IGMPv3 and Source-Specific Multicast (SSM) have been merged
954d10910e6SBruce M Simpson	to the IPv4 stack. VIMAGE hooks are in but not yet used.
955d10910e6SBruce M Simpson
956d10910e6SBruce M Simpson	For kernel developers, the most important changes are that the
957d10910e6SBruce M Simpson	ip_output() and ip_input() paths no longer take the IN_MULTI_LOCK(),
958d10910e6SBruce M Simpson	and this lock has been downgraded to a non-recursive mutex.
959d10910e6SBruce M Simpson
960d10910e6SBruce M Simpson	Transport protocols (UDP, Raw IP) are now responsible for filtering
961d10910e6SBruce M Simpson	inbound multicast traffic according to group membership and source
962d10910e6SBruce M Simpson	filters. The imo_multicast_filter() KPI exists for this purpose.
963d10910e6SBruce M Simpson	Transports which do not use multicast (SCTP, TCP) already reject
964d10910e6SBruce M Simpson	multicast by default. Forwarding and receive performance may improve
965d10910e6SBruce M Simpson	as a mutex acquisition is no longer needed in the ip_input()
966d10910e6SBruce M Simpson	low-level input path.  in_addmulti() and in_delmulti() are shimmed
967d10910e6SBruce M Simpson	to new KPIs which exist to support SSM in-kernel.
968d10910e6SBruce M Simpson
969d10910e6SBruce M Simpson	For application developers, it is recommended that loopback of
970d10910e6SBruce M Simpson	multicast datagrams be disabled for best performance, as this
971d10910e6SBruce M Simpson	will still cause the lock to be taken for each looped-back
972d10910e6SBruce M Simpson	datagram transmission. The net.inet.ip.mcast.loop sysctl may
973d10910e6SBruce M Simpson	be tuned to 0 to disable loopback by default; it defaults to 1
974d10910e6SBruce M Simpson	to preserve the existing behaviour.
975d10910e6SBruce M Simpson
976d10910e6SBruce M Simpson	For systems administrators, to obtain best performance with
977d10910e6SBruce M Simpson	multicast reception and multiple groups, it is always recommended
978d10910e6SBruce M Simpson	that a card with a suitably precise hash filter is used. Hash
979d10910e6SBruce M Simpson	collisions will still result in the lock being taken within the
980d10910e6SBruce M Simpson	transport protocol input path to check group membership.
981d10910e6SBruce M Simpson
982d10910e6SBruce M Simpson	If deploying FreeBSD in an environment with IGMP snooping switches,
983d10910e6SBruce M Simpson	it is recommended that the net.inet.igmp.sendlocal sysctl remain
984d10910e6SBruce M Simpson	enabled; this forces 224.0.0.0/24 group membership to be announced
985d10910e6SBruce M Simpson	via IGMP.
986d10910e6SBruce M Simpson
987d10910e6SBruce M Simpson	The size of 'struct igmpstat' has changed; netstat needs to be
988d10910e6SBruce M Simpson	recompiled to reflect this.
989d10910e6SBruce M Simpson	Bump __FreeBSD_version to 800070.
990d10910e6SBruce M Simpson
991d10910e6SBruce M Simpson20090309:
992a091d2a5SAndrew Thompson	libusb20.so.1 is now installed as libusb.so.1 and the ports system
993a091d2a5SAndrew Thompson	updated to use it. This requires a buildworld/installworld in order to
994a091d2a5SAndrew Thompson	update the library and dependencies (usbconfig, etc). Its advisable to
995cb2fe9b1SStanislav Sedov	rebuild all ports which uses libusb. More specific directions are given
9960ee5826eSAndrew Thompson	in the ports collection UPDATING file. Any /etc/libmap.conf entries for
9973296f80dSAndrew Thompson	libusb are no longer required and can be removed.
998a091d2a5SAndrew Thompson
99965067cc8SKonstantin Belousov20090302:
10009f960e98SKonstantin Belousov	A workaround is committed to allow the creation of System V shared
10019f960e98SKonstantin Belousov	memory segment of size > 2 GB on the 64-bit architectures.
10029f960e98SKonstantin Belousov	Due to a limitation of the existing ABI, the shm_segsz member
100365067cc8SKonstantin Belousov	of the struct shmid_ds, returned by shmctl(IPC_STAT) call is
1004813bb2c9SJoel Dahl	wrong for large segments. Note that limits must be explicitly
100565067cc8SKonstantin Belousov	raised to allow such segments to be created.
100665067cc8SKonstantin Belousov
1007176273eaSRobert Watson20090301:
1008176273eaSRobert Watson	The layout of struct ifnet has changed, requiring a rebuild of all
1009176273eaSRobert Watson	network device driver modules.
1010176273eaSRobert Watson
1011a13a5664SAndrew Thompson20090227:
1012a13a5664SAndrew Thompson	The /dev handling for the new USB stack has changed, a
1013a13a5664SAndrew Thompson	buildworld/installworld is required for libusb20.
1014a13a5664SAndrew Thompson
101571e9286cSAndrew Thompson20090223:
101671e9286cSAndrew Thompson	The new USB2 stack has now been permanently moved in and all kernel and
1017200dcf9aSAndrew Thompson	module names reverted to their previous values (eg, usb, ehci, ohci,
10189c1e15b5SAndrew Thompson	ums, ...).  The old usb stack can be compiled in by prefixing the name
101971e9286cSAndrew Thompson	with the letter 'o', the old usb modules have been removed.
1020a709c9a6SWarner Losh	Updating entry 20090216 for xorg and 20090215 for libmap may still
1021a709c9a6SWarner Losh	apply.
102271e9286cSAndrew Thompson
1023553bf6a4SMike Makonnen20090217:
1024553bf6a4SMike Makonnen	The rc.conf(5) option if_up_delay has been renamed to
1025553bf6a4SMike Makonnen	defaultroute_delay to better reflect its purpose. If you have
1026553bf6a4SMike Makonnen	customized this setting in /etc/rc.conf you need to update it to
1027553bf6a4SMike Makonnen	use the new name.
1028553bf6a4SMike Makonnen
1029bb71e4b6SAndrew Thompson20090216:
1030bb71e4b6SAndrew Thompson	xorg 7.4 wants to configure its input devices via hald which does not
1031bb71e4b6SAndrew Thompson	yet work with USB2. If the keyboard/mouse does not work in xorg then
1032bb71e4b6SAndrew Thompson	add
1033bb71e4b6SAndrew Thompson		Option "AllowEmptyInput" "off"
1034bb71e4b6SAndrew Thompson	to your ServerLayout section.  This will cause X to use the configured
1035cbb9c89eSMaxim Konovalov	kbd and mouse sections from your xorg.conf.
1036bb71e4b6SAndrew Thompson
1037e4edc14eSAndrew Thompson20090215:
1038e4edc14eSAndrew Thompson	The GENERIC kernels for all architectures now default to the new USB2
1039e4edc14eSAndrew Thompson	stack. No kernel config options or code have been removed so if a
1040e4edc14eSAndrew Thompson	problem arises please report it and optionally revert to the old USB
1041e4edc14eSAndrew Thompson	stack. If you are loading USB kernel modules or have a custom kernel
1042e4edc14eSAndrew Thompson	that includes GENERIC then ensure that usb names are also changed over,
1043cbb9c89eSMaxim Konovalov	eg uftdi -> usb2_serial_ftdi.
1044e4edc14eSAndrew Thompson
1045a709c9a6SWarner Losh	Older programs linked against the ports libusb 0.1 need to be
1046a709c9a6SWarner Losh	redirected to the new stack's libusb20.  /etc/libmap.conf can
1047a709c9a6SWarner Losh	be used for this:
1048a709c9a6SWarner Losh		# Map old usb library to new one for usb2 stack
1049a709c9a6SWarner Losh		libusb-0.1.so.8	libusb20.so.1
1050a709c9a6SWarner Losh
105121293e70SAndrew Thompson20090209:
105221293e70SAndrew Thompson	All USB ethernet devices now attach as interfaces under the name ueN
105321293e70SAndrew Thompson	(eg. ue0). This is to provide a predictable name as vendors often
105421293e70SAndrew Thompson	change usb chipsets in a product without notice.
105521293e70SAndrew Thompson
105614943437SJohn Baldwin20090203:
105714943437SJohn Baldwin	The ichsmb(4) driver has been changed to require SMBus slave
105814943437SJohn Baldwin	addresses be left-justified (xxxxxxx0b) rather than right-justified.
105914943437SJohn Baldwin	All of the other SMBus controller drivers require left-justified
106014943437SJohn Baldwin	slave addresses, so this change makes all the drivers provide the
106114943437SJohn Baldwin	same interface.
106214943437SJohn Baldwin
106309f8c3ffSBjoern A. Zeeb20090201:
106409f8c3ffSBjoern A. Zeeb	INET6 statistics (struct ip6stat) was updated.
106509f8c3ffSBjoern A. Zeeb	netstat(1) needs to be recompiled.
106609f8c3ffSBjoern A. Zeeb
106774f91fb9SMaxim Sobolev20090119:
106874f91fb9SMaxim Sobolev	NTFS has been removed from GENERIC kernel on amd64 to match
106974f91fb9SMaxim Sobolev	GENERIC on i386. Should not cause any issues since mount_ntfs(8)
107074f91fb9SMaxim Sobolev	will load ntfs.ko module automatically when NTFS support is
107174f91fb9SMaxim Sobolev	actually needed, unless ntfs.ko is not installed or security
107274f91fb9SMaxim Sobolev	level prohibits loading kernel modules. If either is the case,
107374f91fb9SMaxim Sobolev	"options NTFS" has to be added into kernel config.
107474f91fb9SMaxim Sobolev
107524cb0f22SLawrence Stewart20090115:
107624cb0f22SLawrence Stewart	TCP Appropriate Byte Counting (RFC 3465) support added to kernel.
107724cb0f22SLawrence Stewart	New field in struct tcpcb breaks ABI, so bump __FreeBSD_version to
107824cb0f22SLawrence Stewart	800061. User space tools that rely on the size of struct tcpcb in
107924cb0f22SLawrence Stewart	tcp_var.h (e.g. sockstat) need to be recompiled.
108024cb0f22SLawrence Stewart
10815d55747eSAlexander Motin20081225:
10825d55747eSAlexander Motin	ng_tty(4) module updated to match the new TTY subsystem.
10835d55747eSAlexander Motin	Due to API change, user-level applications must be updated.
10845d55747eSAlexander Motin	New API support added to mpd5 CVS and expected to be present
10855d55747eSAlexander Motin	in next mpd5.3 release.
10865d55747eSAlexander Motin
1087efc06131SSam Leffler20081219:
1088a1c64cafSSam Leffler	With __FreeBSD_version 800060 the makefs tool is part of
1089a1c64cafSSam Leffler	the base system (it was a port).
1090efc06131SSam Leffler
1091991f8615SKip Macy20081216:
1092991f8615SKip Macy	The afdata and ifnet locks have been changed from mutexes to
1093991f8615SKip Macy	rwlocks, network modules will need to be re-compiled.
10941d7e99caSJohn Baldwin
10956e6b3f7cSQing Li20081214:
10966e6b3f7cSQing Li	__FreeBSD_version 800059 incorporates the new arp-v2 rewrite.
10976e6b3f7cSQing Li	RTF_CLONING, RTF_LLINFO and RTF_WASCLONED flags are eliminated.
10986e6b3f7cSQing Li	The new code reduced struct rtentry{} by 16 bytes on 32-bit
10996e6b3f7cSQing Li	architecture and 40 bytes on 64-bit architecture. The userland
11006e6b3f7cSQing Li	applications "arp" and "ndp" have been updated accordingly.
11016e6b3f7cSQing Li	The output from "netstat -r" shows only routing entries and
11026e6b3f7cSQing Li	none of the L2 information.
11036e6b3f7cSQing Li
110433644623SSam Leffler20081130:
110533644623SSam Leffler	__FreeBSD_version 800057 marks the switchover from the
110633644623SSam Leffler	binary ath hal to source code. Users must add the line:
110733644623SSam Leffler
1108c60b227cSSam Leffler	options	AH_SUPPORT_AR5416
110933644623SSam Leffler
111033644623SSam Leffler	to their kernel config files when specifying:
111133644623SSam Leffler
111233644623SSam Leffler	device	ath_hal
111333644623SSam Leffler
111433644623SSam Leffler	The ath_hal module no longer exists; the code is now compiled
111533644623SSam Leffler	together with the driver in the ath module.  It is now
111633644623SSam Leffler	possible to tailor chip support (i.e. reduce the set of chips
111733644623SSam Leffler	and thereby the code size); consult ath_hal(4) for details.
111833644623SSam Leffler
1119db7f0b97SKip Macy20081121:
1120db7f0b97SKip Macy	__FreeBSD_version 800054 adds memory barriers to
1121db7f0b97SKip Macy	<machine/atomic.h>, new interfaces to ifnet to facilitate
1122db7f0b97SKip Macy	multiple hardware transmit queues for cards that support
1123db7f0b97SKip Macy	them, and a lock-less ring-buffer implementation to
1124db7f0b97SKip Macy	enable drivers to more efficiently manage queueing of
1125db7f0b97SKip Macy	packets.
1126db7f0b97SKip Macy
1127de2e1b35SXin LI20081117:
1128de2e1b35SXin LI	A new version of ZFS (version 13) has been merged to -HEAD.
1129de3a91a0SXin LI	This version has zpool attribute "listsnapshots" off by
1130de3a91a0SXin LI	default, which means "zfs list" does not show snapshots,
1131de2e1b35SXin LI	and is the same as Solaris behavior.
1132de2e1b35SXin LI
113302d09f79SOleg Bulyzhin20081028:
113402d09f79SOleg Bulyzhin	dummynet(4) ABI has changed. ipfw(8) needs to be recompiled.
113502d09f79SOleg Bulyzhin
1136e91c7c81SJoseph Koshy20081009:
1137d8135f4aSNick Hibma	The uhci, ohci, ehci and slhci USB Host controller drivers have
1138d8135f4aSNick Hibma	been put into separate modules. If you load the usb module
1139d8135f4aSNick Hibma	separately through loader.conf you will need to load the
1140d8135f4aSNick Hibma	appropriate *hci module as well. E.g. for a UHCI-based USB 2.0
1141d8135f4aSNick Hibma	controller add the following to loader.conf:
1142d8135f4aSNick Hibma
1143d8135f4aSNick Hibma		uhci_load="YES"
1144d8135f4aSNick Hibma		ehci_load="YES"
1145d8135f4aSNick Hibma
1146d8135f4aSNick Hibma20081009:
1147e91c7c81SJoseph Koshy	The ABI used by the PMC toolset has changed.  Please keep
1148e91c7c81SJoseph Koshy	userland (libpmc(3)) and the kernel module (hwpmc(4)) in
1149e91c7c81SJoseph Koshy	sync.
1150e91c7c81SJoseph Koshy
1151b868265dSAlexander Motin20081009:
1152b868265dSAlexander Motin	atapci kernel module now includes only generic PCI ATA
1153b868265dSAlexander Motin	driver. AHCI driver moved to ataahci kernel module.
1154b868265dSAlexander Motin	All vendor-specific code moved into separate kernel modules:
1155b868265dSAlexander Motin	ataacard, ataacerlabs, ataadaptec, ataamd, ataati, atacenatek,
1156b868265dSAlexander Motin	atacypress, atacyrix, atahighpoint, ataintel, ataite, atajmicron,
1157b868265dSAlexander Motin	atamarvell, atamicron, atanational, atanetcell, atanvidia,
1158b868265dSAlexander Motin	atapromise, ataserverworks, atasiliconimage, atasis, atavia
1159b868265dSAlexander Motin
1160bc093719SEd Schouten20080820:
1161bc093719SEd Schouten	The TTY subsystem of the kernel has been replaced by a new
1162bc093719SEd Schouten	implementation, which provides better scalability and an
1163bc093719SEd Schouten	improved driver model. Most common drivers have been migrated to
1164bc093719SEd Schouten	the new TTY subsystem, while others have not. The following
1165bc093719SEd Schouten	drivers have not yet been ported to the new TTY layer:
1166bc093719SEd Schouten
1167bc093719SEd Schouten	PCI/ISA:
116866e7dc38SEd Schouten		cy, digi, rc, rp, sio
1169bc093719SEd Schouten
1170bc093719SEd Schouten	USB:
117166e7dc38SEd Schouten		ubser, ucycom
1172bc093719SEd Schouten
1173bc093719SEd Schouten	Line disciplines:
1174bc093719SEd Schouten		ng_h4, ng_tty, ppp, sl, snp
1175bc093719SEd Schouten
1176bc093719SEd Schouten	Adding these drivers to your kernel configuration file shall
1177bc093719SEd Schouten	cause compilation to fail.
1178bc093719SEd Schouten
11799d965219SOllivier Robert20080818:
11809d965219SOllivier Robert	ntpd has been upgraded to 4.2.4p5.
11819d965219SOllivier Robert
1182eaeb50d4SDag-Erling Smørgrav20080801:
1183eaeb50d4SDag-Erling Smørgrav	OpenSSH has been upgraded to 5.1p1.
1184eaeb50d4SDag-Erling Smørgrav
1185eaeb50d4SDag-Erling Smørgrav	For many years, FreeBSD's version of OpenSSH preferred DSA
1186eaeb50d4SDag-Erling Smørgrav	over RSA for host and user authentication keys.  With this
1187eaeb50d4SDag-Erling Smørgrav	upgrade, we've switched to the vendor's default of RSA over
1188eaeb50d4SDag-Erling Smørgrav	DSA.  This may cause upgraded clients to warn about unknown
1189eaeb50d4SDag-Erling Smørgrav	host keys even for previously known hosts.  Users should
1190eaeb50d4SDag-Erling Smørgrav	follow the usual procedure for verifying host keys before
1191eaeb50d4SDag-Erling Smørgrav	accepting the RSA key.
1192eaeb50d4SDag-Erling Smørgrav
1193eaeb50d4SDag-Erling Smørgrav	This can be circumvented by setting the "HostKeyAlgorithms"
1194eaeb50d4SDag-Erling Smørgrav	option to "ssh-dss,ssh-rsa" in ~/.ssh/config or on the ssh
1195eaeb50d4SDag-Erling Smørgrav	command line.
1196eaeb50d4SDag-Erling Smørgrav
1197737d990aSXin LI	Please note that the sequence of keys offered for
1198737d990aSXin LI	authentication has been changed as well.  You may want to
1199737d990aSXin LI	specify IdentityFile in a different order to revert this
1200737d990aSXin LI	behavior.
1201737d990aSXin LI
1202f4d811f0SEd Schouten20080713:
1203f4d811f0SEd Schouten	The sio(4) driver has been removed from the i386 and amd64
1204f4d811f0SEd Schouten	kernel configuration files. This means uart(4) is now the
1205f4d811f0SEd Schouten	default serial port driver on those platforms as well.
1206f4d811f0SEd Schouten
1207f4d811f0SEd Schouten	To prevent collisions with the sio(4) driver, the uart(4) driver
1208f4d811f0SEd Schouten	uses different names for its device nodes. This means the
1209f4d811f0SEd Schouten	onboard serial port will now most likely be called "ttyu0"
1210f4d811f0SEd Schouten	instead of "ttyd0". You may need to reconfigure applications to
1211f4d811f0SEd Schouten	use the new device names.
1212f4d811f0SEd Schouten
1213db96ec0bSEd Schouten	When using the serial port as a boot console, be sure to update
1214db96ec0bSEd Schouten	/boot/device.hints and /etc/ttys before booting the new kernel.
1215db96ec0bSEd Schouten	If you forget to do so, you can still manually specify the hints
1216db96ec0bSEd Schouten	at the loader prompt:
1217db96ec0bSEd Schouten
1218db96ec0bSEd Schouten		set hint.uart.0.at="isa"
1219db96ec0bSEd Schouten		set hint.uart.0.port="0x3F8"
1220db96ec0bSEd Schouten		set hint.uart.0.flags="0x10"
1221db96ec0bSEd Schouten		set hint.uart.0.irq="4"
1222db96ec0bSEd Schouten		boot -s
1223db96ec0bSEd Schouten
1224bdc03b37SMarcel Moolenaar20080609:
1225bdc03b37SMarcel Moolenaar	The gpt(8) utility has been removed. Use gpart(8) to partition
1226bdc03b37SMarcel Moolenaar	disks instead.
1227bdc03b37SMarcel Moolenaar
122827f7c387SRoman Divacky20080603:
1229a47444d5SRoman Divacky	The version that Linuxulator emulates was changed from 2.4.2
1230a47444d5SRoman Divacky	to 2.6.16. If you experience any problems with Linux binaries
1231a47444d5SRoman Divacky	please try to set sysctl compat.linux.osrelease to 2.4.2 and
1232a47444d5SRoman Divacky	if it fixes the problem contact emulation mailing list.
1233a47444d5SRoman Divacky
12342e598474SBjoern A. Zeeb20080525:
12352e598474SBjoern A. Zeeb	ISDN4BSD (I4B) was removed from the src tree. You may need to
12362e598474SBjoern A. Zeeb	update a your kernel configuration and remove relevant entries.
12372e598474SBjoern A. Zeeb
12384dcedde3SJulian Elischer20080509:
12394dcedde3SJulian Elischer	I have checked in code to support multiple routing tables.
1240032e0bf8SMaxim Konovalov	See the man pages setfib(1) and setfib(2).
12414dcedde3SJulian Elischer	This is a hopefully backwards compatible version,
12424dcedde3SJulian Elischer	but to make use of it you need to compile your kernel
12434dcedde3SJulian Elischer	with options ROUTETABLES=2 (or more up to 16).
12444dcedde3SJulian Elischer
1245de570baaSSam Leffler20080420:
1246de570baaSSam Leffler	The 802.11 wireless support was redone to enable multi-bss
1247de570baaSSam Leffler	operation on devices that are capable.  The underlying device
1248de570baaSSam Leffler	is no longer used directly but instead wlanX devices are
1249de570baaSSam Leffler	cloned with ifconfig.  This requires changes to rc.conf files.
12505318f840SWarner Losh	For example, change:
12515318f840SWarner Losh		ifconfig_ath0="WPA DHCP"
12525318f840SWarner Losh	to
12535318f840SWarner Losh		wlans_ath0=wlan0
12545318f840SWarner Losh		ifconfig_wlan0="WPA DHCP"
12550f95e625SWarner Losh	see rc.conf(5) for more details.  In addition, mergemaster of
12560f95e625SWarner Losh	/etc/rc.d is highly recommended.  Simultaneous update of userland
12570f95e625SWarner Losh	and kernel wouldn't hurt either.
1258de570baaSSam Leffler
1259de570baaSSam Leffler	As part of the multi-bss changes the wlan_scan_ap and wlan_scan_sta
1260de570baaSSam Leffler	modules were merged into the base wlan module.  All references
1261de570baaSSam Leffler	to these modules (e.g. in kernel config files) must be removed.
1262de570baaSSam Leffler
1263ff0af72cSJung-uk Kim20080408:
1264ff0af72cSJung-uk Kim	psm(4) has gained write(2) support in native operation level.
1265ff0af72cSJung-uk Kim	Arbitrary commands can be written to /dev/psm%d and status can
1266ff0af72cSJung-uk Kim	be read back from it.  Therefore, an application is responsible
1267ff0af72cSJung-uk Kim	for status validation and error recovery.  It is a no-op in
1268ff0af72cSJung-uk Kim	other operation levels.
1269ff0af72cSJung-uk Kim
1270e4c67b94SJeff Roberson20080312:
1271e4c67b94SJeff Roberson	Support for KSE threading has been removed from the kernel.  To
1272e4c67b94SJeff Roberson	run legacy applications linked against KSE libmap.conf may
1273e4c67b94SJeff Roberson	be used.  The following libmap.conf may be used to ensure
1274e4c67b94SJeff Roberson	compatibility with any prior release:
1275e4c67b94SJeff Roberson
1276e4c67b94SJeff Roberson	libpthread.so.1 libthr.so.1
1277e4c67b94SJeff Roberson	libpthread.so.2 libthr.so.2
1278e4c67b94SJeff Roberson	libkse.so.3 libthr.so.3
1279e4c67b94SJeff Roberson
12808775db6fSMarcel Moolenaar20080301:
12818775db6fSMarcel Moolenaar	The layout of struct vmspace has changed. This affects libkvm
12828775db6fSMarcel Moolenaar	and any executables that link against libkvm and use the
12838775db6fSMarcel Moolenaar	kvm_getprocs() function. In particular, but not exclusively,
12848775db6fSMarcel Moolenaar	it affects ps(1), fstat(1), pkill(1), systat(1), top(1) and w(1).
12858775db6fSMarcel Moolenaar	The effects are minimal, but it's advisable to upgrade world
12868775db6fSMarcel Moolenaar	nonetheless.
12878775db6fSMarcel Moolenaar
1288df09ebc0SJack F Vogel20080229:
1289df09ebc0SJack F Vogel	The latest em driver no longer has support in it for the
1290df09ebc0SJack F Vogel	82575 adapter, this is now moved to the igb driver. The
1291df09ebc0SJack F Vogel	split was done to make new features that are incompatible
1292df09ebc0SJack F Vogel	with older hardware easier to do.
1293df09ebc0SJack F Vogel
12941669d8afSAndrew Thompson20080220:
12951669d8afSAndrew Thompson	The new geom_lvm(4) geom class has been renamed to geom_linux_lvm(4),
12961669d8afSAndrew Thompson	likewise the kernel option is now GEOM_LINUX_LVM.
12971669d8afSAndrew Thompson
12982427fa19SKris Kennaway20080211:
12992427fa19SKris Kennaway	The default NFS mount mode has changed from UDP to TCP for
13002427fa19SKris Kennaway	increased reliability.  If you rely on (insecurely) NFS
13012427fa19SKris Kennaway	mounting across a firewall you may need to update your
13022427fa19SKris Kennaway	firewall rules.
13032427fa19SKris Kennaway
13045e9f6b73SSam Leffler20080208:
13055e9f6b73SSam Leffler	Belatedly note the addition of m_collapse for compacting
13065e9f6b73SSam Leffler	mbuf chains.
13075e9f6b73SSam Leffler
130848aaad5fSYaroslav Tykhiy20080126:
130948aaad5fSYaroslav Tykhiy	The fts(3) structures have been changed to use adequate
131048aaad5fSYaroslav Tykhiy	integer types for their members and so to be able to cope
131148aaad5fSYaroslav Tykhiy	with huge file trees.  The old fts(3) ABI is preserved
131248aaad5fSYaroslav Tykhiy	through symbol versioning in libc, so third-party binaries
131348aaad5fSYaroslav Tykhiy	using fts(3) should still work, although they will not take
131448aaad5fSYaroslav Tykhiy	advantage of the extended types.  At the same time, some
131548aaad5fSYaroslav Tykhiy	third-party software might fail to build after this change
131648aaad5fSYaroslav Tykhiy	due to unportable assumptions made in its source code about
131748aaad5fSYaroslav Tykhiy	fts(3) structure members.  Such software should be fixed
131848aaad5fSYaroslav Tykhiy	by its vendor or, in the worst case, in the ports tree.
131948aaad5fSYaroslav Tykhiy	FreeBSD_version 800015 marks this change for the unlikely
132048aaad5fSYaroslav Tykhiy	case that a portable fix is impossible.
132148aaad5fSYaroslav Tykhiy
132251dc1e12SRuslan Ermilov20080123:
13238015f45cSWarner Losh	To upgrade to -current after this date, you must be running
132451dc1e12SRuslan Ermilov	FreeBSD not older than 6.0-RELEASE.  Upgrading to -current
13258015f45cSWarner Losh	from 5.x now requires a stop over at RELENG_6 or RELENG_7 systems.
13268015f45cSWarner Losh
1327ab4a2c41SMatteo Riondato20071128:
1328ab4a2c41SMatteo Riondato	The ADAPTIVE_GIANT kernel option has been retired because its
1329ab4a2c41SMatteo Riondato	functionality is the default now.
1330ab4a2c41SMatteo Riondato
1331e393af84SMarius Strobl20071118:
1332e393af84SMarius Strobl	The AT keyboard emulation of sunkbd(4) has been turned on
1333e393af84SMarius Strobl	by default. In order to make the special symbols of the Sun
1334e393af84SMarius Strobl	keyboards driven by sunkbd(4) work under X these now have
1335e393af84SMarius Strobl	to be configured the same way as Sun USB keyboards driven
1336e393af84SMarius Strobl	by ukbd(4) (which also does AT keyboard emulation), f.e.:
1337e393af84SMarius Strobl
1338e393af84SMarius Strobl	Option	"XkbLayout" "us"
1339e393af84SMarius Strobl	Option	"XkbRules" "xorg"
1340e393af84SMarius Strobl	Option	"XkbSymbols" "pc(pc105)+sun_vndr/usb(sun_usb)+us"
1341e393af84SMarius Strobl
134233d3fffaSMarius Strobl20071024:
134333d3fffaSMarius Strobl	It has been decided that it is desirable to provide ABI
134433d3fffaSMarius Strobl	backwards compatibility to the FreeBSD 4/5/6 versions of the
134533d3fffaSMarius Strobl	PCIOCGETCONF, PCIOCREAD and PCIOCWRITE IOCTLs, which was
134633d3fffaSMarius Strobl	broken with the introduction of PCI domain support (see the
134733d3fffaSMarius Strobl	20070930 entry). Unfortunately, this required the ABI of
134833d3fffaSMarius Strobl	PCIOCGETCONF to be broken again in order to be able to
134933d3fffaSMarius Strobl	provide backwards compatibility to the old version of that
135033d3fffaSMarius Strobl	IOCTL. Thus consumers of PCIOCGETCONF have to be recompiled
135133d3fffaSMarius Strobl	again. As for prominent ports this affects neither pciutils
135233d3fffaSMarius Strobl	nor xorg-server this time, the hal port needs to be rebuilt
135333d3fffaSMarius Strobl	however.
135433d3fffaSMarius Strobl
13553d461febSJulian Elischer20071020:
13563d461febSJulian Elischer	The misnamed kthread_create() and friends have been renamed
13573d461febSJulian Elischer	to kproc_create() etc. Many of the callers already
13583d461febSJulian Elischer	used kproc_start()..
13593d461febSJulian Elischer	I will return kthread_create() and friends in a while
13603d461febSJulian Elischer	with implementations that actually create threads, not procs.
13613d461febSJulian Elischer	Renaming corresponds with version 800002.
13623d461febSJulian Elischer
1363c15e0967SKen Smith20071010:
1364c15e0967SKen Smith	RELENG_7 branched.
1365c15e0967SKen Smith
1366dc0dbf5cSWarner LoshCOMMON ITEMS:
1367dc0dbf5cSWarner Losh
1368a24eff53SWarner Losh	General Notes
1369a24eff53SWarner Losh	-------------
1370456b5dd8SWarner Losh	Avoid using make -j when upgrading.  While generally safe, there are
1371456b5dd8SWarner Losh	sometimes problems using -j to upgrade.  If your upgrade fails with
13721733d35cSRuslan Ermilov	-j, please try again without -j.  From time to time in the past there
1373456b5dd8SWarner Losh	have been problems using -j with buildworld and/or installworld.  This
1374456b5dd8SWarner Losh	is especially true when upgrading between "distant" versions (eg one
1375456b5dd8SWarner Losh	that cross a major release boundary or several minor releases, or when
1376456b5dd8SWarner Losh	several months have passed on the -current branch).
1377a24eff53SWarner Losh
13785780f3baSWarner Losh	Sometimes, obscure build problems are the result of environment
13795780f3baSWarner Losh	poisoning.  This can happen because the make utility reads its
1380456b5dd8SWarner Losh	environment when searching for values for global variables.  To run
1381456b5dd8SWarner Losh	your build attempts in an "environmental clean room", prefix all make
1382456b5dd8SWarner Losh	commands with 'env -i '.  See the env(1) manual page for more details.
13835780f3baSWarner Losh
1384456b5dd8SWarner Losh	When upgrading from one major version to another it is generally best
1385456b5dd8SWarner Losh	to upgrade to the latest code in the currently installed branch first,
1386456b5dd8SWarner Losh	then do an upgrade to the new branch. This is the best-tested upgrade
1387456b5dd8SWarner Losh	path, and has the highest probability of being successful.  Please try
1388456b5dd8SWarner Losh	this approach before reporting problems with a major version upgrade.
1389081ff8acSDoug Barton
13908fc25799SMartin Matuska	ZFS notes
13918fc25799SMartin Matuska	---------
13928fc25799SMartin Matuska	When upgrading the boot ZFS pool to a new version, always follow
13938fc25799SMartin Matuska	these two steps:
13948fc25799SMartin Matuska
13958fc25799SMartin Matuska	1.) recompile and reinstall the ZFS boot loader and boot block
13968fc25799SMartin Matuska	(this is part of "make buildworld" and "make installworld")
13978fc25799SMartin Matuska
13988fc25799SMartin Matuska	2.) update the ZFS boot block on your boot drive
13998fc25799SMartin Matuska
14008fc25799SMartin Matuska	The following example updates the ZFS boot block on the first
14018fc25799SMartin Matuska	partition (freebsd-boot) of a GPT partitioned drive ad0:
14028fc25799SMartin Matuska	"gpart bootcode -p /boot/gptzfsboot -i 1 ad0"
14038fc25799SMartin Matuska
14048fc25799SMartin Matuska	Non-boot pools do not need these updates.
14058fc25799SMartin Matuska
1406dc0dbf5cSWarner Losh	To build a kernel
1407dc0dbf5cSWarner Losh	-----------------
1408ba01eb20SWarner Losh	If you are updating from a prior version of FreeBSD (even one just
14091cf0ef11SDavid E. O'Brien	a few days old), you should follow this procedure.  It is the most
14101cf0ef11SDavid E. O'Brien	failsafe as it uses a /usr/obj tree with a fresh mini-buildworld,
14111cf0ef11SDavid E. O'Brien
14121cf0ef11SDavid E. O'Brien	make kernel-toolchain
1413282e0f01SRuslan Ermilov	make -DALWAYS_CHECK_MAKE buildkernel KERNCONF=YOUR_KERNEL_HERE
1414282e0f01SRuslan Ermilov	make -DALWAYS_CHECK_MAKE installkernel KERNCONF=YOUR_KERNEL_HERE
1415dc0dbf5cSWarner Losh
14162e937dd6SAlexander Leidinger	To test a kernel once
14172e937dd6SAlexander Leidinger	---------------------
14182e937dd6SAlexander Leidinger	If you just want to boot a kernel once (because you are not sure
14192e937dd6SAlexander Leidinger	if it works, or if you want to boot a known bad kernel to provide
14202e937dd6SAlexander Leidinger	debugging information) run
14212e937dd6SAlexander Leidinger	make installkernel KERNCONF=YOUR_KERNEL_HERE KODIR=/boot/testkernel
14222e937dd6SAlexander Leidinger	nextboot -k testkernel
14232e937dd6SAlexander Leidinger
1424ba01eb20SWarner Losh	To just build a kernel when you know that it won't mess you up
1425ba01eb20SWarner Losh	--------------------------------------------------------------
1426456b5dd8SWarner Losh	This assumes you are already running a CURRENT system.  Replace
14270fbd2da9SKen Smith	${arch} with the architecture of your machine (e.g. "i386",
1428456b5dd8SWarner Losh	"arm", "amd64", "ia64", "pc98", "sparc64", "powerpc", "mips", etc).
14290fbd2da9SKen Smith
14300fbd2da9SKen Smith	cd src/sys/${arch}/conf
143147d0d01fSWarner Losh	config KERNEL_NAME_HERE
14320fbd2da9SKen Smith	cd ../compile/KERNEL_NAME_HERE
1433ba01eb20SWarner Losh	make depend
1434ba01eb20SWarner Losh	make
1435ba01eb20SWarner Losh	make install
1436ba01eb20SWarner Losh
1437ba01eb20SWarner Losh	If this fails, go to the "To build a kernel" section.
1438ba01eb20SWarner Losh
1439ba01eb20SWarner Losh	To rebuild everything and install it on the current system.
1440ba01eb20SWarner Losh	-----------------------------------------------------------
144163cb445eSWarner Losh	# Note: sometimes if you are running current you gotta do more than
144263cb445eSWarner Losh	# is listed here if you are upgrading from a really old current.
144363cb445eSWarner Losh
1444f643de42SWarner Losh	<make sure you have good level 0 dumps>
144563cb445eSWarner Losh	make buildworld
14466586253aSWarner Losh	make kernel KERNCONF=YOUR_KERNEL_HERE
144763cb445eSWarner Losh							[1]
144863cb445eSWarner Losh	<reboot in single user>				[3]
144963cb445eSWarner Losh	mergemaster -p					[5]
145063cb445eSWarner Losh	make installworld
145150e8eca6SDoug Barton	mergemaster -i					[4]
145294877c06SAlexander Leidinger	make delete-old					[6]
145363cb445eSWarner Losh	<reboot>
145463cb445eSWarner Losh
1455759f0aefSWarner Losh
1456f27b1fceSJoseph Koshy	To cross-install current onto a separate partition
1457f27b1fceSJoseph Koshy	--------------------------------------------------
1458f27b1fceSJoseph Koshy	# In this approach we use a separate partition to hold
1459f27b1fceSJoseph Koshy	# current's root, 'usr', and 'var' directories.   A partition
1460f27b1fceSJoseph Koshy	# holding "/", "/usr" and "/var" should be about 2GB in
1461f27b1fceSJoseph Koshy	# size.
1462f27b1fceSJoseph Koshy
1463f27b1fceSJoseph Koshy	<make sure you have good level 0 dumps>
1464f27b1fceSJoseph Koshy	<boot into -stable>
1465f27b1fceSJoseph Koshy	make buildworld
14663ecf3bddSRuslan Ermilov	make buildkernel KERNCONF=YOUR_KERNEL_HERE
1467f27b1fceSJoseph Koshy	<maybe newfs current's root partition>
1468f27b1fceSJoseph Koshy	<mount current's root partition on directory ${CURRENT_ROOT}>
1469f27b1fceSJoseph Koshy	make installworld DESTDIR=${CURRENT_ROOT}
14702d5cde04SRuslan Ermilov	make distribution DESTDIR=${CURRENT_ROOT} # if newfs'd
14713ecf3bddSRuslan Ermilov	make installkernel KERNCONF=YOUR_KERNEL_HERE DESTDIR=${CURRENT_ROOT}
1472f27b1fceSJoseph Koshy	cp /etc/fstab ${CURRENT_ROOT}/etc/fstab 		   # if newfs'd
1473f27b1fceSJoseph Koshy	<edit ${CURRENT_ROOT}/etc/fstab to mount "/" from the correct partition>
1474f27b1fceSJoseph Koshy	<reboot into current>
1475f27b1fceSJoseph Koshy	<do a "native" rebuild/install as described in the previous section>
1476737d990aSXin LI	<maybe install compatibility libraries from ports/misc/compat*>
1477f27b1fceSJoseph Koshy	<reboot>
1478f27b1fceSJoseph Koshy
1479f27b1fceSJoseph Koshy
1480456b5dd8SWarner Losh	To upgrade in-place from 8.x-stable to current
1481f27b1fceSJoseph Koshy	----------------------------------------------
1482f643de42SWarner Losh	<make sure you have good level 0 dumps>
148321c075eaSWarner Losh	make buildworld					[9]
1484e5dc5f61SWarner Losh	make kernel KERNCONF=YOUR_KERNEL_HERE		[8]
1485fc8c157fSWarner Losh							[1]
1486fc8c157fSWarner Losh	<reboot in single user>				[3]
1487835284beSWarner Losh	mergemaster -p					[5]
1488ba26da8eSWarner Losh	make installworld
1489802fc49dSBrian Feldman	mergemaster -i					[4]
149094877c06SAlexander Leidinger	make delete-old					[6]
1491ba26da8eSWarner Losh	<reboot>
1492ba26da8eSWarner Losh
1493fdb9f54dSWarner Losh	Make sure that you've read the UPDATING file to understand the
1494fdb9f54dSWarner Losh	tweaks to various things you need.  At this point in the life
1495fdb9f54dSWarner Losh	cycle of current, things change often and you are on your own
1496fdb9f54dSWarner Losh	to cope.  The defaults can also change, so please read ALL of
1497fdb9f54dSWarner Losh	the UPDATING entries.
1498ba26da8eSWarner Losh
14991dece4a9SWarner Losh	Also, if you are tracking -current, you must be subscribed to
15001dece4a9SWarner Losh	freebsd-current@freebsd.org.  Make sure that before you update
15011dece4a9SWarner Losh	your sources that you have read and understood all the recent
15021dece4a9SWarner Losh	messages there.  If in doubt, please track -stable which has
15031dece4a9SWarner Losh	much fewer pitfalls.
15041dece4a9SWarner Losh
1505134d2e86SWarner Losh	[1] If you have third party modules, such as vmware, you
1506134d2e86SWarner Losh	should disable them at this point so they don't crash your
1507134d2e86SWarner Losh	system on reboot.
1508134d2e86SWarner Losh
1509ee6e1fc3SWarner Losh	[3] From the bootblocks, boot -s, and then do
1510ee6e1fc3SWarner Losh		fsck -p
1511ee6e1fc3SWarner Losh		mount -u /
1512ee6e1fc3SWarner Losh		mount -a
15136586253aSWarner Losh		cd src
151447d0d01fSWarner Losh		adjkerntz -i		# if CMOS is wall time
1515f6a0ef01SWarner Losh	Also, when doing a major release upgrade, it is required that
1516f6a0ef01SWarner Losh	you boot into single user mode to do the installworld.
1517ee6e1fc3SWarner Losh
1518a6cd4f9dSWarner Losh	[4] Note: This step is non-optional.  Failure to do this step
1519a6cd4f9dSWarner Losh	can result in a significant reduction in the functionality of the
1520a6cd4f9dSWarner Losh	system.  Attempting to do it by hand is not recommended and those
1521a6cd4f9dSWarner Losh	that pursue this avenue should read this file carefully, as well
1522a6cd4f9dSWarner Losh	as the archives of freebsd-current and freebsd-hackers mailing lists
152350e8eca6SDoug Barton	for potential gotchas.  The -U option is also useful to consider.
152450e8eca6SDoug Barton	See mergemaster(8) for more information.
1525a6cd4f9dSWarner Losh
1526835284beSWarner Losh	[5] Usually this step is a noop.  However, from time to time
1527835284beSWarner Losh	you may need to do this if you get unknown user in the following
1528835284beSWarner Losh	step.  It never hurts to do it all the time.  You may need to
1529835284beSWarner Losh	install a new mergemaster (cd src/usr.sbin/mergemaster && make
1530835284beSWarner Losh	install) after the buildworld before this step if you last updated
1531835284beSWarner Losh	from current before 20020224 or from -stable before 20020408.
1532835284beSWarner Losh
153394877c06SAlexander Leidinger	[6] This only deletes old files and directories. Old libraries
153494877c06SAlexander Leidinger	can be deleted by "make delete-old-libs", but you have to make
153594877c06SAlexander Leidinger	sure that no program is using those libraries anymore.
153694877c06SAlexander Leidinger
1537456b5dd8SWarner Losh	[8] In order to have a kernel that can run the 4.x binaries needed to
1538456b5dd8SWarner Losh	do an installworld, you must include the COMPAT_FREEBSD4 option in
1539456b5dd8SWarner Losh	your kernel.  Failure to do so may leave you with a system that is
1540456b5dd8SWarner Losh	hard to boot to recover. A similar kernel option COMPAT_FREEBSD5 is
1541456b5dd8SWarner Losh	required to run the 5.x binaries on more recent kernels.  And so on
1542456b5dd8SWarner Losh	for COMPAT_FREEBSD6 and COMPAT_FREEBSD7.
1543c74fe6afSWarner Losh
1544e5dc5f61SWarner Losh	Make sure that you merge any new devices from GENERIC since the
1545e5dc5f61SWarner Losh	last time you updated your kernel config file.
1546e5dc5f61SWarner Losh
154721c075eaSWarner Losh	[9] When checking out sources, you must include the -P flag to have
1548e5dc5f61SWarner Losh	cvs prune empty directories.
1549e5dc5f61SWarner Losh
1550e5dc5f61SWarner Losh	If CPUTYPE is defined in your /etc/make.conf, make sure to use the
1551e5dc5f61SWarner Losh	"?=" instead of the "=" assignment operator, so that buildworld can
1552e5dc5f61SWarner Losh	override the CPUTYPE if it needs to.
1553e5dc5f61SWarner Losh
1554e5dc5f61SWarner Losh	MAKEOBJDIRPREFIX must be defined in an environment variable, and
1555e5dc5f61SWarner Losh	not on the command line, or in /etc/make.conf.  buildworld will
1556e5dc5f61SWarner Losh	warn if it is improperly defined.
1557dc0dbf5cSWarner LoshFORMAT:
1558dc0dbf5cSWarner Losh
1559f699bbbbSMark OvensThis file contains a list, in reverse chronological order, of major
1560630f2154SGlen Barberbreakages in tracking -current.  It is not guaranteed to be a complete
1561630f2154SGlen Barberlist of such breakages, and only contains entries since October 10, 2007.
1562630f2154SGlen BarberIf you need to see UPDATING entries from before that date, you will need
1563630f2154SGlen Barberto fetch an UPDATING file from an older FreeBSD release.
15641fc1a0dcSWarner Losh
1565e72fd46aSWarner LoshCopyright information:
1566e72fd46aSWarner Losh
1567456b5dd8SWarner LoshCopyright 1998-2009 M. Warner Losh.  All Rights Reserved.
1568e72fd46aSWarner Losh
1569772730c7SWarner LoshRedistribution, publication, translation and use, with or without
1570772730c7SWarner Loshmodification, in full or in part, in any form or format of this
15719698f2c0SWarner Loshdocument are permitted without further permission from the author.
1572e72fd46aSWarner Losh
1573e72fd46aSWarner LoshTHIS DOCUMENT IS PROVIDED BY WARNER LOSH ``AS IS'' AND ANY EXPRESS OR
1574e72fd46aSWarner LoshIMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
1575e72fd46aSWarner LoshWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
1576e72fd46aSWarner LoshDISCLAIMED.  IN NO EVENT SHALL WARNER LOSH BE LIABLE FOR ANY DIRECT,
1577e72fd46aSWarner LoshINDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
1578e72fd46aSWarner Losh(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
1579e72fd46aSWarner LoshSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
1580e72fd46aSWarner LoshHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
1581e72fd46aSWarner LoshSTRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
1582e72fd46aSWarner LoshIN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
1583e72fd46aSWarner LoshPOSSIBILITY OF SUCH DAMAGE.
1584e72fd46aSWarner Losh
158522306abcSWarner LoshContact Warner Losh if you have any questions about your use of
1586772730c7SWarner Loshthis document.
1587772730c7SWarner Losh
158897d92980SPeter Wemm$FreeBSD$
1589