xref: /freebsd/UPDATING (revision d4b9233a9622d9b5a246124d7cf734ea7894a13d)
112f22a78SPeter WemmUpdating 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
7e0fb6dc3SRobert Watsonhandbook:
8e0fb6dc3SRobert Watson
9e0fb6dc3SRobert Watson    http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html
10e72fd46aSWarner Losh
112c724730SWarner LoshItems affecting the ports and packages system can be found in
12456b5dd8SWarner Losh/usr/ports/UPDATING.  Please read that file before running portupgrade.
132c724730SWarner Losh
144f1def68SWarner LoshNOTE: FreeBSD has switched from gcc to clang. If you have trouble bootstrapping
15a46954e2SWarner Loshfrom older versions of FreeBSD, try WITHOUT_CLANG and WITH_GCC to bootstrap to
16a8f2a2b9SEd Mastethe tip of head, and then rebuild without this option. The bootstrap process
17a8f2a2b9SEd Mastefrom older version of current across the gcc/clang cutover is a bit fragile.
184f1def68SWarner Losh
19006a42a9SGlen BarberNOTE TO PEOPLE WHO THINK THAT FreeBSD 11.x IS SLOW:
20006a42a9SGlen Barber	FreeBSD 11.x has many debugging features turned on, in both the kernel
21456b5dd8SWarner Losh	and userland.  These features attempt to detect incorrect use of
22456b5dd8SWarner Losh	system primitives, and encourage loud failure through extra sanity
23456b5dd8SWarner Losh	checking and fail stop semantics.  They also substantially impact
24456b5dd8SWarner Losh	system performance.  If you want to do performance measurement,
25456b5dd8SWarner Losh	benchmarking, and optimization, you'll want to turn them off.  This
26456b5dd8SWarner Losh	includes various WITNESS- related kernel options, INVARIANTS, malloc
27456b5dd8SWarner Losh	debugging flags in userland, and various verbose features in the
28456b5dd8SWarner Losh	kernel.  Many developers choose to disable these features on build
2999e449f2SJason Evans	machines to maximize performance.  (To completely disable malloc
3099e449f2SJason Evans	debugging, define MALLOC_PRODUCTION in /etc/make.conf, or to merely
3199e449f2SJason Evans	disable the most expensive debugging functionality run
3299e449f2SJason Evans	"ln -s 'abort:false,junk:false' /etc/malloc.conf".)
33efc06131SSam Leffler
34*d4b9233aSAlan Somers20160129:
35*d4b9233aSAlan Somers	Building ZFS pools on top of zvols is prohibited by default.  That
36*d4b9233aSAlan Somers	feature has never worked safely; it's always been prone to deadlocks.
37*d4b9233aSAlan Somers	Using a zvol as the backing store for a VM guest's virtual disk will
38*d4b9233aSAlan Somers	still work, even if the guest is using ZFS.  Legacy behavior can be
39*d4b9233aSAlan Somers	restored by setting vfs.zfs.vol.recursive=1.
40*d4b9233aSAlan Somers
4160c59fadSDag-Erling Smørgrav20160119:
4260c59fadSDag-Erling Smørgrav	The NONE and HPN patches has been removed from OpenSSH.  They are
4360c59fadSDag-Erling Smørgrav	still available in the security/openssh-portable port.
4460c59fadSDag-Erling Smørgrav
453bf7d9a6SMarcelo Araujo20160113:
463bf7d9a6SMarcelo Araujo	With the addition of ypldap(8), a new _ypldap user is now required
473bf7d9a6SMarcelo Araujo	during installworld. "mergemaster -p" can be used to add the user
483bf7d9a6SMarcelo Araujo	prior to installworld, as documented in the handbook.
493bf7d9a6SMarcelo Araujo
504d6ab32fSBaptiste Daroussin20151216:
514d6ab32fSBaptiste Daroussin	The tftp loader (pxeboot) now uses the option root-path directive. As a
524d6ab32fSBaptiste Daroussin	consequence it no longer looks for a pxeboot.4th file on the tftp
534d6ab32fSBaptiste Daroussin	server. Instead it uses the regular /boot infrastructure as with the
544d6ab32fSBaptiste Daroussin	other loaders.
554d6ab32fSBaptiste Daroussin
56ca7e5285SWarner Losh20151211:
57ca7e5285SWarner Losh	The code to start recording plug and play data into the modules has
58ca7e5285SWarner Losh	been committed. While the old tools will properly build a new kernel,
59ca7e5285SWarner Losh	a number of warnings about "unknown metadata record 4" will be produced
60ca7e5285SWarner Losh	for an older kldxref. To avoid such warnings, make sure to rebuild
61ca7e5285SWarner Losh	the kernel toolchain (or world). Make sure that you have r292078 or
62ca7e5285SWarner Losh	later when trying to build 292077 or later before rebuilding.
63ca7e5285SWarner Losh
64015dfda6SEd Maste20151207:
65015dfda6SEd Maste	Debug data files are now built by default with 'make buildworld' and
66015dfda6SEd Maste	installed with 'make installworld'. This facilitates debugging but
67015dfda6SEd Maste	requires more disk space both during the build and for the installed
68015dfda6SEd Maste	world. Debug files may be disabled by setting WITHOUT_DEBUG_FILES=yes
69015dfda6SEd Maste	in src.conf(5).
70015dfda6SEd Maste
7133ba1088SRick Macklem20151130:
7233ba1088SRick Macklem	r291527 changed the internal interface between the nfsd.ko and
7333ba1088SRick Macklem	nfscommon.ko modules. As such, they must both be upgraded to-gether.
7433ba1088SRick Macklem	__FreeBSD_version has been bumped because of this.
7533ba1088SRick Macklem
76af1d74f0SBaptiste Daroussin20151108:
77af1d74f0SBaptiste Daroussin	Add support for unicode collation strings leads to a change of
78af1d74f0SBaptiste Daroussin	order of files listed by ls(1) for example. To get back to the old
79af1d74f0SBaptiste Daroussin	behaviour, set LC_COLLATE environment variable to "C".
80af1d74f0SBaptiste Daroussin
810492a14fSBaptiste Daroussin	Databases administrators will need to reindex their databases given
820492a14fSBaptiste Daroussin	collation results will be different.
830492a14fSBaptiste Daroussin
8410b5202eSBaptiste Daroussin	Due to a bug in install(1) it is recommended to remove the ancient
851300d6f1SBaptiste Daroussin	locales before running make installworld.
8601bedb0cSBaptiste Daroussin
871300d6f1SBaptiste Daroussin	rm -rf /usr/share/locale/*
8801bedb0cSBaptiste Daroussin
897bded2dbSJung-uk Kim20151030:
907bded2dbSJung-uk Kim	The OpenSSL has been upgraded to 1.0.2d.  Any binaries requiring
917bded2dbSJung-uk Kim	libcrypto.so.7 or libssl.so.7 must be recompiled.
927bded2dbSJung-uk Kim
93ebda5173SAlexander Motin20151020:
94ebda5173SAlexander Motin	Qlogic 24xx/25xx firmware images were updated from 5.5.0 to 7.3.0.
95ebda5173SAlexander Motin	Kernel modules isp_2400_multi and isp_2500_multi were removed and
96ebda5173SAlexander Motin	should be replaced with isp_2400 and isp_2500 modules respectively.
97ebda5173SAlexander Motin
9856585ab5SBryan Drewery20151017:
9956585ab5SBryan Drewery	The build previously allowed using 'make -n' to not recurse into
10056585ab5SBryan Drewery	sub-directories while showing what commands would be executed, and
10156585ab5SBryan Drewery	'make -n -n' to recursively show commands.  Now 'make -n' will recurse
10256585ab5SBryan Drewery	and 'make -N' will not.
10356585ab5SBryan Drewery
104ff446b05SPeter Wemm20151012:
105ff446b05SPeter Wemm	If you specify SENDMAIL_MC or SENDMAIL_CF in make.conf, mergemaster
106ff446b05SPeter Wemm	and etcupdate will now use this file. A custom sendmail.cf is now
107ff446b05SPeter Wemm	updated via this mechanism rather than via installworld.  If you had
108ff446b05SPeter Wemm	excluded sendmail.cf in mergemaster.rc or etcupdate.conf, you may
109ff446b05SPeter Wemm	want to remove the exclusion or change it to "always install".
110ff446b05SPeter Wemm	/etc/mail/sendmail.cf is now managed the same way regardless of
111ff446b05SPeter Wemm	whether SENDMAIL_MC/SENDMAIL_CF is used.  If you are not using
112ff446b05SPeter Wemm	SENDMAIL_MC/SENDMAIL_CF there should be no change in behavior.
113ff446b05SPeter Wemm
1144a3760baSAlexander Motin20151011:
1154a3760baSAlexander Motin	Compatibility shims for legacy ATA device names have been removed.
1164a3760baSAlexander Motin	It includes ATA_STATIC_ID kernel option, kern.cam.ada.legacy_aliases
1174a3760baSAlexander Motin	and kern.geom.raid.legacy_aliases loader tunables, kern.devalias.*
1184a3760baSAlexander Motin	environment variables, /dev/ad* and /dev/ar* symbolic links.
1194a3760baSAlexander Motin
120d31de548SDimitry Andric20151006:
1214f01407bSDimitry Andric	Clang, llvm, lldb, compiler-rt and libc++ have been upgraded to 3.7.0.
1224f01407bSDimitry Andric	Please see the 20141231 entry below for information about prerequisites
1234f01407bSDimitry Andric	and upgrading, if you are not already using clang 3.5.0 or higher.
124ebeff3f9SDimitry Andric
1255882166bSEd Maste20150924:
12605117b57SEd Maste	Kernel debug files have been moved to /usr/lib/debug/boot/kernel/,
12705117b57SEd Maste	and renamed from .symbols to .debug. This reduces the size requirements
12805117b57SEd Maste	on the boot partition or file system and provides consistency with
12905117b57SEd Maste	userland debug files.
13005117b57SEd Maste
13105117b57SEd Maste	When using the supported kernel installation method the
13205117b57SEd Maste	/usr/lib/debug/boot/kernel directory will be renamed (to kernel.old)
13305117b57SEd Maste	as is done with /boot/kernel.
13405117b57SEd Maste
13505117b57SEd Maste	Developers wishing to maintain the historical behavior of installing
13605117b57SEd Maste	debug files in /boot/kernel/ can set KERN_DEBUGDIR="" in src.conf(5).
13705117b57SEd Maste
13864b3b4d6SKristof Provost20150827:
1398ed69220SGleb Smirnoff	The wireless drivers had undergone changes that remove the 'parent
1408ed69220SGleb Smirnoff	interface' from the ifconfig -l output. The rc.d network scripts
1418ed69220SGleb Smirnoff	used to check presence of a parent interface in the list, so old
1428ed69220SGleb Smirnoff	scripts would fail to start wireless networking. Thus, etcupdate(3)
1438ed69220SGleb Smirnoff	or mergemaster(8) run is required after kernel update, to update your
1448ed69220SGleb Smirnoff	rc.d scripts in /etc.
1458ed69220SGleb Smirnoff
1468ed69220SGleb Smirnoff20150827:
14764b3b4d6SKristof Provost	pf no longer supports 'scrub fragment crop' or 'scrub fragment drop-ovl'
14864b3b4d6SKristof Provost	These configurations are now automatically interpreted as
14964b3b4d6SKristof Provost	'scrub fragment reassemble'.
15064b3b4d6SKristof Provost
151646041a8SMark Murray20150817:
152646041a8SMark Murray	Kernel-loadable modules for the random(4) device are back. To use
153646041a8SMark Murray	them, the kernel must have
154646041a8SMark Murray
155646041a8SMark Murray	device	random
156646041a8SMark Murray	options	RANDOM_LOADABLE
157646041a8SMark Murray
158646041a8SMark Murray	kldload(8) can then be used to load random_fortuna.ko
159646041a8SMark Murray	or random_yarrow.ko. Please note that due to the indirect
160646041a8SMark Murray	function calls that the loadable modules need to provide,
161646041a8SMark Murray	the build-in variants will be slightly more efficient.
162646041a8SMark Murray
163646041a8SMark Murray	The random(4) kernel option RANDOM_DUMMY has been retired due to
164646041a8SMark Murray	unpopularity. It was not all that useful anyway.
165646041a8SMark Murray
1661bc28ffcSEd Maste20150813:
1671bc28ffcSEd Maste	The WITHOUT_ELFTOOLCHAIN_TOOLS src.conf(5) knob has been retired.
1681bc28ffcSEd Maste	Control over building the ELF Tool Chain tools is now provided by
1691bc28ffcSEd Maste	the WITHOUT_TOOLCHAIN knob.
1701bc28ffcSEd Maste
171e7dbaf58SIan Lepore20150810:
172e7dbaf58SIan Lepore	The polarity of Pulse Per Second (PPS) capture events with the
173e7dbaf58SIan Lepore	uart(4) driver has been corrected.  Prior to this change the PPS
174e7dbaf58SIan Lepore	"assert" event corresponded to the trailing edge of a positive PPS
175e7dbaf58SIan Lepore	pulse and the "clear" event was the leading edge of the next pulse.
176e7dbaf58SIan Lepore
177e7dbaf58SIan Lepore	As the width of a PPS pulse in a typical GPS receiver is on the
178e7dbaf58SIan Lepore	order of 1 millisecond, most users will not notice any significant
179e7dbaf58SIan Lepore	difference with this change.
180e7dbaf58SIan Lepore
181e7dbaf58SIan Lepore	Anyone who has compensated for the historical polarity reversal by
182e7dbaf58SIan Lepore	configuring a negative offset equal to the pulse width will need to
183e7dbaf58SIan Lepore	remove that workaround.
184e7dbaf58SIan Lepore
18534c7eb57SKoop Mast20150809:
18634c7eb57SKoop Mast	The default group assigned to /dev/dri entries has been changed
18734c7eb57SKoop Mast	from 'wheel' to 'video' with the id of '44'. If you want to have
18834c7eb57SKoop Mast	access to the dri devices please add yourself to the video group
18934c7eb57SKoop Mast	with:
19034c7eb57SKoop Mast
19134c7eb57SKoop Mast	# pw groupmod video -m $USER
19234c7eb57SKoop Mast
1939322ac3fSAllan Jude20150806:
1949322ac3fSAllan Jude	The menu.rc and loader.rc files will now be replaced during
1959322ac3fSAllan Jude	upgrades. Please migrate local changes to menu.rc.local and
1969322ac3fSAllan Jude	loader.rc.local instead.
1979322ac3fSAllan Jude
198f97aa232SEd Maste20150805:
199f97aa232SEd Maste	GNU Binutils versions of addr2line, c++filt, nm, readelf, size,
200f97aa232SEd Maste	strings and strip have been removed. The src.conf(5) knob
201f97aa232SEd Maste	WITHOUT_ELFTOOLCHAIN_TOOLS no longer provides the binutils tools.
202f97aa232SEd Maste
2031635369eSSteven Hartland20150728:
20468d5f492SSteven Hartland	As ZFS requires more kernel stack pages than is the default on some
2051635369eSSteven Hartland	architectures e.g. i386, it now warns if KSTACK_PAGES is less than
2061635369eSSteven Hartland	ZFS_MIN_KSTACK_PAGES (which is 4 at the time of writing).
2071635369eSSteven Hartland
2081635369eSSteven Hartland	Please consider using 'options KSTACK_PAGES=X' where X is greater
2091635369eSSteven Hartland	than or equal to ZFS_MIN_KSTACK_PAGES i.e. 4 in such configurations.
2101635369eSSteven Hartland
211ab1f4a42SGregory Neil Shapiro20150706:
212ab1f4a42SGregory Neil Shapiro	sendmail has been updated to 8.15.2.  Starting with FreeBSD 11.0
213ab1f4a42SGregory Neil Shapiro	and sendmail 8.15, sendmail uses uncompressed IPv6 addresses by
214ab1f4a42SGregory Neil Shapiro	default, i.e., they will not contain "::".  For example, instead
215ab1f4a42SGregory Neil Shapiro	of ::1, it will be 0:0:0:0:0:0:0:1.  This permits a zero subnet
216ab1f4a42SGregory Neil Shapiro	to have a more specific match, such as different map entries for
217ab1f4a42SGregory Neil Shapiro	IPv6:0:0 vs IPv6:0.  This change requires that configuration
218ab1f4a42SGregory Neil Shapiro	data (including maps, files, classes, custom ruleset, etc.) must
219ab1f4a42SGregory Neil Shapiro	use the same format, so make certain such configuration data is
220ab1f4a42SGregory Neil Shapiro	upgrading.  As a very simple check search for patterns like
221ab1f4a42SGregory Neil Shapiro	'IPv6:[0-9a-fA-F:]*::' and 'IPv6::'.  To return to the old
222ab1f4a42SGregory Neil Shapiro	behavior, set the m4 option confUSE_COMPRESSED_IPV6_ADDRESSES or
223ab1f4a42SGregory Neil Shapiro	the cf option UseCompressedIPv6Addresses.
224ab1f4a42SGregory Neil Shapiro
225d1b06863SMark Murray20150630:
226d1b06863SMark Murray	The default kernel entropy-processing algorithm is now
227d1b06863SMark Murray	Fortuna, replacing Yarrow.
2286f78e390SSimon J. Gerraty
229d1b06863SMark Murray	Assuming you have 'device random' in your kernel config
230d1b06863SMark Murray	file, the configurations allow a kernel option to override
231d1b06863SMark Murray	this default. You may choose *ONE* of:
2326f78e390SSimon J. Gerraty
233d1b06863SMark Murray	options	RANDOM_YARROW	# Legacy /dev/random algorithm.
234d1b06863SMark Murray	options	RANDOM_DUMMY	# Blocking-only driver.
2356f78e390SSimon J. Gerraty
236d1b06863SMark Murray	If you have neither, you get Fortuna.  For most people,
237d1b06863SMark Murray	read no further, Fortuna will give a /dev/random that works
238d1b06863SMark Murray	like it always used to, and the difference will be irrelevant.
2396f78e390SSimon J. Gerraty
240d1b06863SMark Murray	If you remove 'device random', you get *NO* kernel-processed
24102dcb6e0SEitan Adler	entropy at all. This may be acceptable to folks building
242d1b06863SMark Murray	embedded systems, but has complications. Carry on reading,
243d1b06863SMark Murray	and it is assumed you know what you need.
244d1b06863SMark Murray
245d1b06863SMark Murray	*PLEASE* read random(4) and random(9) if you are in the
24602dcb6e0SEitan Adler	habit of tweaking kernel configs, and/or if you are a member
247d1b06863SMark Murray	of the embedded community, wanting specific and not-usual
248d1b06863SMark Murray	behaviour from your security subsystems.
249d1b06863SMark Murray
250d1b06863SMark Murray	NOTE!! If you use RANDOM_DUMMY and/or have no 'device
251d1b06863SMark Murray	random', you will NOT have a functioning /dev/random, and
252d1b06863SMark Murray	many cryptographic features will not work, including SSH.
253d1b06863SMark Murray	You may also find strange behaviour from the random(3) set
254d1b06863SMark Murray	of library functions, in particular sranddev(3), srandomdev(3)
255d1b06863SMark Murray	and arc4random(3). The reason for this is that the KERN_ARND
256d1b06863SMark Murray	sysctl only returns entropy if it thinks it has some to
257d1b06863SMark Murray	share, and with RANDOM_DUMMY or no 'device random' this
258d1b06863SMark Murray	will never happen.
259d1b06863SMark Murray
260e44053b7SGregory Neil Shapiro20150623:
261e44053b7SGregory Neil Shapiro	An additional fix for the issue described in the 20150614 sendmail
262e44053b7SGregory Neil Shapiro	entry below has been been committed in revision 284717.
2636f78e390SSimon J. Gerraty
2646f78e390SSimon J. Gerraty20150616:
26532c88b52SWarner Losh	FreeBSD's old make (fmake) has been removed from the system. It is
26632c88b52SWarner Losh	available as the devel/fmake port or via pkg install fmake.
26732c88b52SWarner Losh
2689c5682edSGregory Neil Shapiro20150615:
2699c5682edSGregory Neil Shapiro	The fix for the issue described in the 20150614 sendmail entry
2709c5682edSGregory Neil Shapiro	below has been been committed in revision 284436.  The work
2719c5682edSGregory Neil Shapiro	around described in that entry is no longer needed unless the
2729c5682edSGregory Neil Shapiro	default setting is overridden by a confDH_PARAMETERS configuration
2739c5682edSGregory Neil Shapiro	setting of '5' or pointing to a 512 bit DH parameter file.
2749c5682edSGregory Neil Shapiro
27522596424SGregory Neil Shapiro20150614:
27661099d9aSEnji Cooper	ALLOW_DEPRECATED_ATF_TOOLS/ATFFILE support has been removed from
27761099d9aSEnji Cooper	atf.test.mk (included from bsd.test.mk). Please upgrade devel/atf
27861099d9aSEnji Cooper	and devel/kyua to version 0.20+ and adjust any calling code to work
27961099d9aSEnji Cooper	with Kyuafile and kyua.
28061099d9aSEnji Cooper
28161099d9aSEnji Cooper20150614:
28222596424SGregory Neil Shapiro	The import of openssl to address the FreeBSD-SA-15:10.openssl
28322596424SGregory Neil Shapiro	security advisory includes a change which rejects handshakes
28422596424SGregory Neil Shapiro	with DH parameters below 768 bits.  sendmail releases prior
28522596424SGregory Neil Shapiro	to 8.15.2 (not yet released), defaulted to a 512 bit
28622596424SGregory Neil Shapiro	DH parameter setting for client connections.  To work around
28722596424SGregory Neil Shapiro	this interoperability, sendmail can be configured to use a
28822596424SGregory Neil Shapiro	2048 bit DH parameter by:
28922596424SGregory Neil Shapiro
29022596424SGregory Neil Shapiro	1. Edit /etc/mail/`hostname`.mc
29122596424SGregory Neil Shapiro	2. If a setting for confDH_PARAMETERS does not exist or
29222596424SGregory Neil Shapiro	   exists and is set to a string beginning with '5',
29322596424SGregory Neil Shapiro	   replace it with '2'.
29422596424SGregory Neil Shapiro	3. If a setting for confDH_PARAMETERS exists and is set to
29522596424SGregory Neil Shapiro	   a file path, create a new file with:
29622596424SGregory Neil Shapiro		openssl dhparam -out /path/to/file 2048
29722596424SGregory Neil Shapiro	4. Rebuild the .cf file:
29822596424SGregory Neil Shapiro		cd /etc/mail/; make; make install
29922596424SGregory Neil Shapiro	5. Restart sendmail:
30022596424SGregory Neil Shapiro		cd /etc/mail/; make restart
30122596424SGregory Neil Shapiro
30222596424SGregory Neil Shapiro	A sendmail patch is coming, at which time this file will be
30322596424SGregory Neil Shapiro	updated.
30422596424SGregory Neil Shapiro
305b8d08379SXin LI20150604:
306b8d08379SXin LI	Generation of legacy formatted entries have been disabled by default
307b8d08379SXin LI	in pwd_mkdb(8), as all base system consumers of the legacy formatted
308b8d08379SXin LI	entries were converted to use the new format by default when the new,
309b8d08379SXin LI	machine independent format have been added and supported since FreeBSD
310b8d08379SXin LI	5.x.
311b8d08379SXin LI
312b8d08379SXin LI	Please see the pwd_mkdb(8) manual page for further details.
313b8d08379SXin LI
314ef6fa9e2SDimitry Andric20150525:
315ef6fa9e2SDimitry Andric	Clang and llvm have been upgraded to 3.6.1 release.  Please see the
316ef6fa9e2SDimitry Andric	20141231 entry below for information about prerequisites and upgrading,
317ef6fa9e2SDimitry Andric	if you are not already using 3.5.0 or higher.
318ef6fa9e2SDimitry Andric
3195b03aba6SOleksandr Tymoshenko20150521:
3205b03aba6SOleksandr Tymoshenko	TI platform code switched to using vendor DTS files and this update
3215b03aba6SOleksandr Tymoshenko	may break existing systems running on Beaglebone, Beaglebone Black,
3225b03aba6SOleksandr Tymoshenko	and Pandaboard:
3235b03aba6SOleksandr Tymoshenko
3245b03aba6SOleksandr Tymoshenko	- dtb files should be regenerated/reinstalled. Filenames are the
3255b03aba6SOleksandr Tymoshenko	  same but content is different now
3265b03aba6SOleksandr Tymoshenko	- GPIO addressing was changed, now each GPIO bank (32 pins per bank)
3275b03aba6SOleksandr Tymoshenko	  has its own /dev/gpiocX device, e.g. pin 121 on /dev/gpioc0 in old
3285b03aba6SOleksandr Tymoshenko	  addressing scheme is now pin 25 on /dev/gpioc3.
3295b03aba6SOleksandr Tymoshenko	- Pandaboard: /etc/ttys should be updated, serial console device is
3305b03aba6SOleksandr Tymoshenko	  now /dev/ttyu2, not /dev/ttyu0
3315b03aba6SOleksandr Tymoshenko
33221fcca66SBaptiste Daroussin20150501:
33321fcca66SBaptiste Daroussin	soelim(1) from gnu/usr.bin/groff has been replaced by usr.bin/soelim.
33421fcca66SBaptiste Daroussin	If you need the GNU extension from groff soelim(1), install groff
33521fcca66SBaptiste Daroussin	from package: pkg install groff, or via ports: textproc/groff.
33621fcca66SBaptiste Daroussin
337eee7269fSSteven Hartland20150423:
338ad34caceSSteven Hartland	chmod, chflags, chown and chgrp now affect symlinks in -R mode as
339ad34caceSSteven Hartland	defined in symlink(7); previously symlinks were silently ignored.
340ad34caceSSteven Hartland
3411243a98eSTijl Coosemans20150415:
3421243a98eSTijl Coosemans	The const qualifier has been removed from iconv(3) to comply with
3431243a98eSTijl Coosemans	POSIX.  The ports tree is aware of this from r384038 onwards.
3441243a98eSTijl Coosemans
345757a876fSBrooks Davis20150416:
346757a876fSBrooks Davis	Libraries specified by LIBADD in Makefiles must have a corresponding
347757a876fSBrooks Davis	DPADD_<lib> variable to ensure correct dependencies.  This is now
348757a876fSBrooks Davis	enforced in src.libnames.mk.
349757a876fSBrooks Davis
350cdc58367SAlexander Motin20150324:
351cdc58367SAlexander Motin	From legacy ata(4) driver was removed support for SATA controllers
352cdc58367SAlexander Motin	supported by more functional drivers ahci(4), siis(4) and mvs(4).
353cdc58367SAlexander Motin	Kernel modules ataahci and ataadaptec were removed completely,
354cdc58367SAlexander Motin	replaced by ahci and mvs modules respectively.
355cdc58367SAlexander Motin
356302cd48aSDimitry Andric20150315:
35770aad3bfSDimitry Andric	Clang, llvm and lldb have been upgraded to 3.6.0 release.  Please see
35870aad3bfSDimitry Andric	the 20141231 entry below for information about prerequisites and
35970aad3bfSDimitry Andric	upgrading, if you are not already using 3.5.0 or higher.
3606ce3ca64SDimitry Andric
3615c845fdeSNathan Whitehorn20150307:
3625c845fdeSNathan Whitehorn	The 32-bit PowerPC kernel has been changed to a position-independent
3635c845fdeSNathan Whitehorn	executable. This can only be booted with a version of loader(8)
3645c845fdeSNathan Whitehorn	newer than January 31, 2015, so make sure to update both world and
3655c845fdeSNathan Whitehorn	kernel before rebooting.
3665c845fdeSNathan Whitehorn
367997707f4SJohn-Mark Gurney20150217:
368997707f4SJohn-Mark Gurney	If you are running a -CURRENT kernel since r273872 (Oct 30th, 2014),
36919442b85SXin LI	but before r278950, the RNG was not seeded properly.  Immediately
37019442b85SXin LI	upgrade the kernel to r278950 or later and regenerate any keys (e.g.
371997707f4SJohn-Mark Gurney	ssh keys or openssl keys) that were generated w/ a kernel from that
3724c25bba7SGavin Atkinson	range.  This does not affect programs that directly used /dev/random
3733a25555cSGlen Barber	or /dev/urandom.  All userland uses of arc4random(3) are affected.
374997707f4SJohn-Mark Gurney
37509cfaa45SEdward Tomasz Napierala20150210:
37609cfaa45SEdward Tomasz Napierala	The autofs(4) ABI was changed in order to restore binary compatibility
37709cfaa45SEdward Tomasz Napierala	with 10.1-RELEASE.  The automountd(8) daemon needs to be rebuilt to work
37809cfaa45SEdward Tomasz Napierala	with the new kernel.
37909cfaa45SEdward Tomasz Napierala
3800fa22505SNathan Whitehorn20150131:
3810fa22505SNathan Whitehorn	The powerpc64 kernel has been changed to a position-independent
3820fa22505SNathan Whitehorn	executable. This can only be booted with a new version of loader(8),
3830fa22505SNathan Whitehorn	so make sure to update both world and kernel before rebooting.
3840fa22505SNathan Whitehorn
3859cac79b3SDimitry Andric20150118:
3869cac79b3SDimitry Andric	Clang and llvm have been upgraded to 3.5.1 release.  This is a bugfix
3879cac79b3SDimitry Andric	only release, no new features have been added.  Please see the 20141231
3889cac79b3SDimitry Andric	entry below for information about prerequisites and upgrading, if you
3899cac79b3SDimitry Andric	are not already using 3.5.0.
3909cac79b3SDimitry Andric
391968d62e1SEd Maste20150107:
392968d62e1SEd Maste	ELF tools addr2line, elfcopy (strip), nm, size, and strings are now
393968d62e1SEd Maste	taken from the ELF Tool Chain project rather than GNU binutils. They
394968d62e1SEd Maste	should be drop-in replacements, with the addition of arm64 support.
395968d62e1SEd Maste	The WITHOUT_ELFTOOLCHAIN_TOOLS= knob may be used to obtain the
396f97aa232SEd Maste	binutils tools, if necessary. See 20150805 for updated information.
397968d62e1SEd Maste
398f1b3840cSDag-Erling Smørgrav20150105:
399f1b3840cSDag-Erling Smørgrav	The default Unbound configuration now enables remote control
400f1b3840cSDag-Erling Smørgrav	using a local socket.  Users who have already enabled the
401f1b3840cSDag-Erling Smørgrav	local_unbound service should regenerate their configuration
402f1b3840cSDag-Erling Smørgrav	by running "service local_unbound setup" as root.
403f1b3840cSDag-Erling Smørgrav
4042d281361SBaptiste Daroussin20150102:
4052d281361SBaptiste Daroussin	The GNU texinfo and GNU info pages have been removed.
4062d281361SBaptiste Daroussin	To be able to view GNU info pages please install texinfo from ports.
4072d281361SBaptiste Daroussin
408143c11b4SDimitry Andric20141231:
409143c11b4SDimitry Andric	Clang, llvm and lldb have been upgraded to 3.5.0 release.
410143c11b4SDimitry Andric
4110ac2c3d1SDimitry Andric	As of this release, a prerequisite for building clang, llvm and lldb is
4120ac2c3d1SDimitry Andric	a C++11 capable compiler and C++11 standard library.  This means that to
413143c11b4SDimitry Andric	be able to successfully build the cross-tools stage of buildworld, with
414143c11b4SDimitry Andric	clang as the bootstrap compiler, your system compiler or cross compiler
415143c11b4SDimitry Andric	should either be clang 3.3 or later, or gcc 4.8 or later, and your
416143c11b4SDimitry Andric	system C++ library should be libc++, or libdstdc++ from gcc 4.8 or
417143c11b4SDimitry Andric	later.
418143c11b4SDimitry Andric
4190ac2c3d1SDimitry Andric	On any standard FreeBSD 10.x or 11.x installation, where clang and
4200ac2c3d1SDimitry Andric	libc++ are on by default (that is, on x86 or arm), this should work out
4210ac2c3d1SDimitry Andric	of the box.
422143c11b4SDimitry Andric
423143c11b4SDimitry Andric	On 9.x installations where clang is enabled by default, e.g. on x86 and
424143c11b4SDimitry Andric	powerpc, libc++ will not be enabled by default, so libc++ should be
425143c11b4SDimitry Andric	built (with clang) and installed first.  If both clang and libc++ are
426143c11b4SDimitry Andric	missing, build clang first, then use it to build libc++.
427143c11b4SDimitry Andric
428143c11b4SDimitry Andric	On 8.x and earlier installations, upgrade to 9.x first, and then follow
429143c11b4SDimitry Andric	the instructions for 9.x above.
430143c11b4SDimitry Andric
4310ac2c3d1SDimitry Andric	Sparc64 and mips users are unaffected, as they still use gcc 4.2.1 by
4320ac2c3d1SDimitry Andric	default, and do not build clang.
4330ac2c3d1SDimitry Andric
4340ac2c3d1SDimitry Andric	Many embedded systems are resource constrained, and will not be able to
4350ac2c3d1SDimitry Andric	build clang in a reasonable time, or in some cases at all.  In those
4360ac2c3d1SDimitry Andric	cases, cross building bootable systems on amd64 is a workaround.
4370ac2c3d1SDimitry Andric
438143c11b4SDimitry Andric	This new version of clang introduces a number of new warnings, of which
439143c11b4SDimitry Andric	the following are most likely to appear:
440143c11b4SDimitry Andric
441143c11b4SDimitry Andric	-Wabsolute-value
442143c11b4SDimitry Andric
443143c11b4SDimitry Andric	This warns in two cases, for both C and C++:
444143c11b4SDimitry Andric	* When the code is trying to take the absolute value of an unsigned
445143c11b4SDimitry Andric	  quantity, which is effectively a no-op, and almost never what was
446143c11b4SDimitry Andric	  intended.  The code should be fixed, if at all possible.  If you are
447143c11b4SDimitry Andric	  sure that the unsigned quantity can be safely cast to signed, without
448143c11b4SDimitry Andric	  loss of information or undefined behavior, you can add an explicit
449143c11b4SDimitry Andric	  cast, or disable the warning.
450143c11b4SDimitry Andric
451143c11b4SDimitry Andric	* When the code is trying to take an absolute value, but the called
452143c11b4SDimitry Andric	  abs() variant is for the wrong type, which can lead to truncation.
453143c11b4SDimitry Andric	  If you want to disable the warning instead of fixing the code, please
454143c11b4SDimitry Andric	  make sure that truncation will not occur, or it might lead to unwanted
455143c11b4SDimitry Andric	  side-effects.
456143c11b4SDimitry Andric
457143c11b4SDimitry Andric	-Wtautological-undefined-compare and
458143c11b4SDimitry Andric	-Wundefined-bool-conversion
459143c11b4SDimitry Andric
460143c11b4SDimitry Andric	These warn when C++ code is trying to compare 'this' against NULL, while
461143c11b4SDimitry Andric	'this' should never be NULL in well-defined C++ code.  However, there is
462143c11b4SDimitry Andric	some legacy (pre C++11) code out there, which actively abuses this
463143c11b4SDimitry Andric	feature, which was less strictly defined in previous C++ versions.
464143c11b4SDimitry Andric
465143c11b4SDimitry Andric	Squid and openjdk do this, for example.  The warning can be turned off
466143c11b4SDimitry Andric	for C++98 and earlier, but compiling the code in C++11 mode might result
467143c11b4SDimitry Andric	in unexpected behavior; for example, the parts of the program that are
468143c11b4SDimitry Andric	unreachable could be optimized away.
469143c11b4SDimitry Andric
4700b327b63SRick Macklem20141222:
4710b327b63SRick Macklem	The old NFS client and server (kernel options NFSCLIENT, NFSSERVER)
4720b327b63SRick Macklem	kernel sources have been removed. The .h files remain, since some
4730b327b63SRick Macklem	utilities include them. This will need to be fixed later.
4740b327b63SRick Macklem	If "mount -t oldnfs ..." is attempted, it will fail.
4750b327b63SRick Macklem	If the "-o" option on mountd(8), nfsd(8) or nfsstat(1) is used,
4760b327b63SRick Macklem	the utilities will report errors.
4770b327b63SRick Macklem
4785f25ee9cSBrooks Davis20141121:
4795f25ee9cSBrooks Davis	The handling of LOCAL_LIB_DIRS has been altered to skip addition of
4805f25ee9cSBrooks Davis	directories to top level SUBDIR variable when their parent
4815f25ee9cSBrooks Davis	directory is included in LOCAL_DIRS.  Users with build systems with
4825f25ee9cSBrooks Davis	such hierarchies and without SUBDIR entries in the parent
4835f25ee9cSBrooks Davis	directory Makefiles should add them or add the directories to
4845f25ee9cSBrooks Davis	LOCAL_DIRS.
4855f25ee9cSBrooks Davis
486603eaf79SAlexander V. Chernikov20141109:
48774342541SChristian Brueffer	faith(4) and faithd(8) have been removed from the base system. Faith
488603eaf79SAlexander V. Chernikov	has been obsolete for a very long time.
489603eaf79SAlexander V. Chernikov
4902d6f6d63SJean-Sébastien Pédron20141104:
4912d6f6d63SJean-Sébastien Pédron	vt(4), the new console driver, is enabled by default. It brings
4922d6f6d63SJean-Sébastien Pédron	support for Unicode and double-width characters, as well as
4932d6f6d63SJean-Sébastien Pédron	support for UEFI and integration with the KMS kernel video
4942d6f6d63SJean-Sébastien Pédron	drivers.
4952d6f6d63SJean-Sébastien Pédron
4962d6f6d63SJean-Sébastien Pédron	You may need to update your console settings in /etc/rc.conf,
4972d6f6d63SJean-Sébastien Pédron	most probably the keymap. During boot, /etc/rc.d/syscons will
4982d6f6d63SJean-Sébastien Pédron	indicate what you need to do.
4992d6f6d63SJean-Sébastien Pédron
5002d6f6d63SJean-Sébastien Pédron	vt(4) still has issues and lacks some features compared to
5012d6f6d63SJean-Sébastien Pédron	syscons(4). See the wiki for up-to-date information:
5022d6f6d63SJean-Sébastien Pédron	  https://wiki.freebsd.org/Newcons
5032d6f6d63SJean-Sébastien Pédron
5042d6f6d63SJean-Sébastien Pédron	If you want to keep using syscons(4), you can do so by adding
5052d6f6d63SJean-Sébastien Pédron	the following line to /boot/loader.conf:
5062d6f6d63SJean-Sébastien Pédron	  kern.vty=sc
5072d6f6d63SJean-Sébastien Pédron
508fa809347SEnji Cooper20141102:
509fa809347SEnji Cooper	pjdfstest has been integrated into kyua as an opt-in test suite.
51074342541SChristian Brueffer	Please see share/doc/pjdfstest/README for more details on how to
511fa809347SEnji Cooper	execute it.
512fa809347SEnji Cooper
513ddd96d23SEd Maste20141009:
514ddd96d23SEd Maste	gperf has been removed from the base system for architectures
515ddd96d23SEd Maste	that use clang. Ports that require gperf will obtain it from the
516ddd96d23SEd Maste	devel/gperf port.
517ddd96d23SEd Maste
51840a8ac8fSEnji Cooper20140923:
51940a8ac8fSEnji Cooper	pjdfstest has been moved from tools/regression/pjdfstest to
52040a8ac8fSEnji Cooper	contrib/pjdfstest .
52140a8ac8fSEnji Cooper
522243d6a50SSean Bruno20140922:
523243d6a50SSean Bruno	At svn r271982, The default linux compat kernel ABI has been adjusted
524243d6a50SSean Bruno	to 2.6.18 in support of the linux-c6 compat ports infrastructure
525243d6a50SSean Bruno	update.  If you wish to continue using the linux-f10 compat ports,
526243d6a50SSean Bruno	add compat.linux.osrelease=2.6.16 to your local sysctl.conf.  Users are
527243d6a50SSean Bruno	encouraged to update their linux-compat packages to linux-c6 during
528243d6a50SSean Bruno	their next update cycle.
529243d6a50SSean Bruno
530232490c6SNathan Whitehorn20140729:
531232490c6SNathan Whitehorn	The ofwfb driver, used to provide a graphics console on PowerPC when
53274342541SChristian Brueffer	using vt(4), no longer allows mmap() of all physical memory. This
533232490c6SNathan Whitehorn	will prevent Xorg on PowerPC with some ATI graphics cards from
534232490c6SNathan Whitehorn	initializing properly unless x11-servers/xorg-server is updated to
535232490c6SNathan Whitehorn	1.12.4_8 or newer.
536232490c6SNathan Whitehorn
5370aafd404SWarner Losh20140723:
5380aafd404SWarner Losh	The xdev targets have been converted to using TARGET and
5390aafd404SWarner Losh	TARGET_ARCH instead of XDEV and XDEV_ARCH.
5400aafd404SWarner Losh
5410d0485e2SDag-Erling Smørgrav20140719:
5420d0485e2SDag-Erling Smørgrav	The default unbound configuration has been modified to address
5430d0485e2SDag-Erling Smørgrav	issues with reverse lookups on networks that use private
5440d0485e2SDag-Erling Smørgrav	address ranges.  If you use the local_unbound service, run
5450d0485e2SDag-Erling Smørgrav	"service local_unbound setup" as root to regenerate your
5460d0485e2SDag-Erling Smørgrav	configuration, then "service local_unbound reload" to load the
5470d0485e2SDag-Erling Smørgrav	new configuration.
5480d0485e2SDag-Erling Smørgrav
549f4717209SBaptiste Daroussin20140709:
550f4717209SBaptiste Daroussin	The GNU texinfo and GNU info pages are not built and installed
551f4717209SBaptiste Daroussin	anymore, WITH_INFO knob has been added to allow to built and install
552f4717209SBaptiste Daroussin	them again.
5532d281361SBaptiste Daroussin	UPDATE: see 20150102 entry on texinfo's removal
554f4717209SBaptiste Daroussin
5558a833bdaSBaptiste Daroussin20140708:
5568a833bdaSBaptiste Daroussin	The GNU readline library is now an INTERNALLIB - that is, it is
5578a833bdaSBaptiste Daroussin	statically linked into consumers (GDB and variants) in the base
5588a833bdaSBaptiste Daroussin	system, and the shared library is no longer installed.  The
5598a833bdaSBaptiste Daroussin	devel/readline port is available for third party software that
5608a833bdaSBaptiste Daroussin	requires readline.
5618a833bdaSBaptiste Daroussin
56250f73640SMarcel Moolenaar20140702:
56350f73640SMarcel Moolenaar	The Itanium architecture (ia64) has been removed from the list of
56450f73640SMarcel Moolenaar	known architectures. This is the first step in the removal of the
56550f73640SMarcel Moolenaar	architecture.
56650f73640SMarcel Moolenaar
56718aa7fccSRick Macklem20140701:
56818aa7fccSRick Macklem	Commit r268115 has added NFSv4.1 server support, merged from
56918aa7fccSRick Macklem	projects/nfsv4.1-server.  Since this includes changes to the
57018aa7fccSRick Macklem	internal interfaces between the NFS related modules, a full
57118aa7fccSRick Macklem	build of the kernel and modules will be necessary.
57218aa7fccSRick Macklem	__FreeBSD_version has been bumped.
57318aa7fccSRick Macklem
574824a9093SEd Maste20140629:
575824a9093SEd Maste	The WITHOUT_VT_SUPPORT kernel config knob has been renamed
576824a9093SEd Maste	WITHOUT_VT.  (The other _SUPPORT knobs have a consistent meaning
577824a9093SEd Maste	which differs from the behaviour controlled by this knob.)
578824a9093SEd Maste
57938b72f8cSAlexander Motin20140619:
58038b72f8cSAlexander Motin	Maximal length of the serial number in CTL was increased from 16 to
58138b72f8cSAlexander Motin	64 chars, that breaks ABI.  All CTL-related tools, such as ctladm
58238b72f8cSAlexander Motin	and ctld, need to be rebuilt to work with a new kernel.
58338b72f8cSAlexander Motin
584727a7ce8SJulio Merino20140606:
585727a7ce8SJulio Merino	The libatf-c and libatf-c++ major versions were downgraded to 0 and
586727a7ce8SJulio Merino	1 respectively to match the upstream numbers.  They were out of
587727a7ce8SJulio Merino	sync because, when they were originally added to FreeBSD, the
588727a7ce8SJulio Merino	upstream versions were not respected.  These libraries are private
589727a7ce8SJulio Merino	and not yet built by default, so renumbering them should be a
590727a7ce8SJulio Merino	non-issue.  However, unclean source trees will yield broken test
591727a7ce8SJulio Merino	programs once the operator executes "make delete-old-libs" after a
592727a7ce8SJulio Merino	"make installworld".
593727a7ce8SJulio Merino
5948c7ec47aSJulio Merino	Additionally, the atf-sh binary was made private by moving it into
5958c7ec47aSJulio Merino	/usr/libexec/.  Already-built shell test programs will keep the
5968c7ec47aSJulio Merino	path to the old binary so they will break after "make delete-old"
5978c7ec47aSJulio Merino	is run.
5988c7ec47aSJulio Merino
599727a7ce8SJulio Merino	If you are using WITH_TESTS=yes (not the default), wipe the object
600727a7ce8SJulio Merino	tree and rebuild from scratch to prevent spurious test failures.
6018c7ec47aSJulio Merino	This is only needed once: the misnumbered libraries and misplaced
6028c7ec47aSJulio Merino	binaries have been added to OptionalObsoleteFiles.inc so they will
6038c7ec47aSJulio Merino	be removed during a clean upgrade.
604727a7ce8SJulio Merino
60585d60e68SDimitry Andric20140512:
60685d60e68SDimitry Andric	Clang and llvm have been upgraded to 3.4.1 release.
60785d60e68SDimitry Andric
608fa114234SWarner Losh20140508:
609fa114234SWarner Losh	We bogusly installed src.opts.mk in /usr/share/mk. This file should
610fa114234SWarner Losh	be removed to avoid issues in the future (and has been added to
611fa114234SWarner Losh	ObsoleteFiles.inc).
612fa114234SWarner Losh
613a46954e2SWarner Losh20140505:
614a46954e2SWarner Losh	/etc/src.conf now affects only builds of the FreeBSD src tree. In the
615a46954e2SWarner Losh	past, it affected all builds that used the bsd.*.mk files. The old
616a46954e2SWarner Losh	behavior was a bug, but people may have relied upon it. To get this
617a46954e2SWarner Losh	behavior back, you can .include /etc/src.conf from /etc/make.conf
618a46954e2SWarner Losh	(which is still global and isn't changed). This also changes the
619a46954e2SWarner Losh	behavior of incremental builds inside the tree of individual
62059a24370SWarner Losh	directories. Set MAKESYSPATH to ".../share/mk" to do that.
621a46954e2SWarner Losh	Although this has survived make universe and some upgrade scenarios,
62255b76981SWarner Losh	other upgrade scenarios may have broken. At least one form of
62355b76981SWarner Losh	temporary breakage was fixed with MAKESYSPATH settings for buildworld
62459a24370SWarner Losh	as well... In cases where MAKESYSPATH isn't working with this
62559a24370SWarner Losh	setting, you'll need to set it to the full path to your tree.
626a46954e2SWarner Losh
627bd871f14SWarner Losh	One side effect of all this cleaning up is that bsd.compiler.mk
628bd871f14SWarner Losh	is no longer implicitly included by bsd.own.mk. If you wish to
629bd871f14SWarner Losh	use COMPILER_TYPE, you must now explicitly include bsd.compiler.mk
630bd871f14SWarner Losh	as well.
631bd871f14SWarner Losh
632461dbce2SEitan Adler20140430:
633461dbce2SEitan Adler	The lindev device has been removed since /dev/full has been made a
634461dbce2SEitan Adler	standard device.  __FreeBSD_version has been bumped.
635461dbce2SEitan Adler
636e9aba509SEnji Cooper20140424:
637e9aba509SEnji Cooper	The knob WITHOUT_VI was added to the base system, which controls
638e9aba509SEnji Cooper	building ex(1), vi(1), etc. Older releases of FreeBSD required ex(1)
639e9aba509SEnji Cooper	in order to reorder files share/termcap and didn't build ex(1) as a
640e9aba509SEnji Cooper	build tool, so building/installing with WITH_VI is highly advised for
641e9aba509SEnji Cooper	build hosts for older releases.
642e9aba509SEnji Cooper
643e9aba509SEnji Cooper	This issue has been fixed in stable/9 and stable/10 in r277022 and
644e9aba509SEnji Cooper	r276991, respectively.
645e9aba509SEnji Cooper
6462bb08298SWarner Losh20140418:
6472bb08298SWarner Losh	The YES_HESIOD knob has been removed. It has been obsolete for
6482bb08298SWarner Losh	a decade. Please move to using WITH_HESIOD instead or your builds
6492bb08298SWarner Losh	will silently lack HESIOD.
6502bb08298SWarner Losh
6514c710b67SMarcel Moolenaar20140405:
6524c710b67SMarcel Moolenaar	The uart(4) driver has been changed with respect to its handling
6534c710b67SMarcel Moolenaar	of the low-level console. Previously the uart(4) driver prevented
6544c710b67SMarcel Moolenaar	any process from changing the baudrate or the CLOCAL and HUPCL
6554c710b67SMarcel Moolenaar	control flags. By removing the restrictions, operators can make
6564c710b67SMarcel Moolenaar	changes to the serial console port without having to reboot.
6574c710b67SMarcel Moolenaar	However, when getty(8) is started on the serial device that is
6584c710b67SMarcel Moolenaar	associated with the low-level console, a misconfigured terminal
6594c710b67SMarcel Moolenaar	line in /etc/ttys will now have a real impact.
6604c710b67SMarcel Moolenaar	Before upgrading the kernel, make sure that /etc/ttys has the
6614c710b67SMarcel Moolenaar	serial console device configured as 3wire without baudrate to
662086036aaSMarcel Moolenaar	preserve the previous behaviour. E.g:
6634c710b67SMarcel Moolenaar	    ttyu0  "/usr/libexec/getty 3wire"  vt100  on  secure
6644c710b67SMarcel Moolenaar
665ea9ed3d8SAlexander Motin20140306:
666ea9ed3d8SAlexander Motin	Support for libwrap (TCP wrappers) in rpcbind was disabled by default
667ea9ed3d8SAlexander Motin	to improve performance.  To re-enable it, if needed, run rpcbind
668ea9ed3d8SAlexander Motin	with command line option -W.
669ea9ed3d8SAlexander Motin
670a9fd2218SWarner Losh20140226:
671a9fd2218SWarner Losh	Switched back to the GPL dtc compiler due to updates in the upstream
672a9fd2218SWarner Losh	dts files not being supported by the BSDL dtc compiler. You will need
673a9fd2218SWarner Losh	to rebuild your kernel toolchain to pick up the new compiler. Core dumps
674a9fd2218SWarner Losh	may result while building dtb files during a kernel build if you fail
675a9fd2218SWarner Losh	to do so. Set WITHOUT_GPL_DTC if you require the BSDL compiler.
676a9fd2218SWarner Losh
6778de08345SChristian Brueffer20140216:
6783ad1a091SWarner Losh	Clang and llvm have been upgraded to 3.4 release.
6793ad1a091SWarner Losh
680f785676fSDimitry Andric20140216:
6818de08345SChristian Brueffer	The nve(4) driver has been removed.  Please use the nfe(4) driver
6828de08345SChristian Brueffer	for NVIDIA nForce MCP Ethernet adapters instead.
6838de08345SChristian Brueffer
6849f23d19aSDimitry Andric20140212:
6859f23d19aSDimitry Andric	An ABI incompatibility crept into the libc++ 3.4 import in r261283.
6869f23d19aSDimitry Andric	This could cause certain C++ applications using shared libraries built
6879f23d19aSDimitry Andric	against the previous version of libc++ to crash.  The incompatibility
6889f23d19aSDimitry Andric	has now been fixed, but any C++ applications or shared libraries built
6899f23d19aSDimitry Andric	between r261283 and r261801 should be recompiled.
6909f23d19aSDimitry Andric
6915e4b8b0dSXin LI20140204:
6925e4b8b0dSXin LI	OpenSSH will now ignore errors caused by kernel lacking of Capsicum
6935e4b8b0dSXin LI	capability mode support.  Please note that enabling the feature in
6945e4b8b0dSXin LI	kernel is still highly recommended.
6955e4b8b0dSXin LI
6965e4b8b0dSXin LI20140131:
6975e4b8b0dSXin LI	OpenSSH is now built with sandbox support, and will use sandbox as
6985e4b8b0dSXin LI	the default privilege separation method.  This requires Capsicum
6995e4b8b0dSXin LI	capability mode support in kernel.
7005e4b8b0dSXin LI
701d1166b82SKai Wang20140128:
7022e503d34SKai Wang	The libelf and libdwarf libraries have been updated to newer
7032e503d34SKai Wang	versions from upstream. Shared library version numbers for
7042e503d34SKai Wang	these two libraries were bumped. Any ports or binaries
7052e503d34SKai Wang	requiring these two libraries should be recompiled.
7062e503d34SKai Wang	__FreeBSD_version is bumped to 1100006.
7072e503d34SKai Wang
708d7efee23SJulio Merino20140110:
709d7efee23SJulio Merino	If a Makefile in a tests/ directory was auto-generating a Kyuafile
710d7efee23SJulio Merino	instead of providing an explicit one, this would prevent such
711d7efee23SJulio Merino	Makefile from providing its own Kyuafile in the future during
712d7efee23SJulio Merino	NO_CLEAN builds.  This has been fixed in the Makefiles but manual
713d7efee23SJulio Merino	intervention is needed to clean an objdir if you use NO_CLEAN:
714d7efee23SJulio Merino	  # find /usr/obj -name Kyuafile | xargs rm -f
715d7efee23SJulio Merino
7162773bfa9SBenjamin Kaduk20131213:
7172773bfa9SBenjamin Kaduk	The behavior of gss_pseudo_random() for the krb5 mechanism
7182773bfa9SBenjamin Kaduk	has changed, for applications requesting a longer random string
7192773bfa9SBenjamin Kaduk	than produced by the underlying enctype's pseudo-random() function.
7202773bfa9SBenjamin Kaduk	In particular, the random string produced from a session key of
7212773bfa9SBenjamin Kaduk	enctype aes256-cts-hmac-sha1-96 or aes256-cts-hmac-sha1-96 will
7222773bfa9SBenjamin Kaduk	be different at the 17th octet and later, after this change.
7232773bfa9SBenjamin Kaduk	The counter used in the PRF+ construction is now encoded as a
7242773bfa9SBenjamin Kaduk	big-endian integer in accordance with RFC 4402.
7252773bfa9SBenjamin Kaduk	__FreeBSD_version is bumped to 1100004.
7262773bfa9SBenjamin Kaduk
727e01d128aSJulio Merino20131108:
728e01d128aSJulio Merino	The WITHOUT_ATF build knob has been removed and its functionality
729e01d128aSJulio Merino	has been subsumed into the more generic WITHOUT_TESTS.  If you were
730e01d128aSJulio Merino	using the former to disable the build of the ATF libraries, you
731e01d128aSJulio Merino	should change your settings to use the latter.
732e01d128aSJulio Merino
733b9cd6b0aSBrooks Davis20131025:
734b9cd6b0aSBrooks Davis	The default version of mtree is nmtree which is obtained from
735b9cd6b0aSBrooks Davis	NetBSD.  The output is generally the same, but may vary
736b9cd6b0aSBrooks Davis	slightly.  If you found you need identical output adding
737b9cd6b0aSBrooks Davis	"-F freebsd9" to the command line should do the trick.  For the
738b9cd6b0aSBrooks Davis	time being, the old mtree is available as fmtree.
739b9cd6b0aSBrooks Davis
740e3ededfaSBryan Drewery20131014:
741e3ededfaSBryan Drewery	libbsdyml has been renamed to libyaml and moved to /usr/lib/private.
742e3ededfaSBryan Drewery	This will break ports-mgmt/pkg. Rebuild the port, or upgrade to pkg
743e3ededfaSBryan Drewery	1.1.4_8 and verify bsdyml not linked in, before running "make
744e3ededfaSBryan Drewery	delete-old-libs":
745e3ededfaSBryan Drewery	  # make -C /usr/ports/ports-mgmt/pkg build deinstall install clean
746e3ededfaSBryan Drewery	  or
747e3ededfaSBryan Drewery	  # pkg install pkg; ldd /usr/local/sbin/pkg | grep bsdyml
748e3ededfaSBryan Drewery
74984b354cbSHiroki Sato20131010:
7509c80b8aaSWarner Losh	The stable/10 branch has been created in subversion from head
7519c80b8aaSWarner Losh	revision r256279.
7529c80b8aaSWarner Losh
7539c80b8aaSWarner Losh20131010:
75484b354cbSHiroki Sato	The rc.d/jail script has been updated to support jail(8)
75584b354cbSHiroki Sato	configuration file.  The "jail_<jname>_*" rc.conf(5) variables
75684b354cbSHiroki Sato	for per-jail configuration are automatically converted to
75784b354cbSHiroki Sato	/var/run/jail.<jname>.conf before the jail(8) utility is invoked.
75884b354cbSHiroki Sato	This is transparently backward compatible.  See below about some
75984b354cbSHiroki Sato	incompatibilities and rc.conf(5) manual page for more details.
76084b354cbSHiroki Sato
76184b354cbSHiroki Sato	These variables are now deprecated in favor of jail(8) configuration
76284b354cbSHiroki Sato	file.  One can use "rc.d/jail config <jname>" command to generate
76384b354cbSHiroki Sato	a jail(8) configuration file in /var/run/jail.<jname>.conf without
76484b354cbSHiroki Sato	running the jail(8) utility.   The default pathname of the
76584b354cbSHiroki Sato	configuration file is /etc/jail.conf and can be specified by
76684b354cbSHiroki Sato	using $jail_conf or $jail_<jname>_conf variables.
76784b354cbSHiroki Sato
76884b354cbSHiroki Sato	Please note that jail_devfs_ruleset accepts an integer at
76984b354cbSHiroki Sato	this moment.  Please consider to rewrite the ruleset name
77084b354cbSHiroki Sato	with an integer.
77184b354cbSHiroki Sato
7722d69252aSDag-Erling Smørgrav20130930:
7732d69252aSDag-Erling Smørgrav	BIND has been removed from the base system.  If all you need
7742d69252aSDag-Erling Smørgrav	is a local resolver, simply enable and start the local_unbound
7752d69252aSDag-Erling Smørgrav	service instead.  Otherwise, several versions of BIND are
7768a65c0b9SCraig Rodrigues	available in the ports tree.   The dns/bind99 port is one example.
7778a65c0b9SCraig Rodrigues
7788a65c0b9SCraig Rodrigues	With this change, nslookup(1) and dig(1) are no longer in the base
779edc144a1SCraig Rodrigues	system.  Users should instead use host(1) and drill(1) which are
7808a65c0b9SCraig Rodrigues	in the base system.  Alternatively, nslookup and dig can
7818a65c0b9SCraig Rodrigues	be obtained by installing the dns/bind-tools port.
7822d69252aSDag-Erling Smørgrav
783665751ecSGlen Barber20130916:
784665751ecSGlen Barber	With the addition of unbound(8), a new unbound user is now
785665751ecSGlen Barber	required during installworld.  "mergemaster -p" can be used to
786665751ecSGlen Barber	add the user prior to installworld, as documented in the handbook.
787665751ecSGlen Barber
788bd8277b4SDag-Erling Smørgrav20130911:
789bd8277b4SDag-Erling Smørgrav	OpenSSH is now built with DNSSEC support, and will by default
790bd8277b4SDag-Erling Smørgrav	silently trust signed SSHFP records.  This can be controlled with
791bd8277b4SDag-Erling Smørgrav	the VerifyHostKeyDNS client configuration setting.  DNSSEC support
792bd8277b4SDag-Erling Smørgrav	can be disabled entirely with the WITHOUT_LDNS option in src.conf.
793bd8277b4SDag-Erling Smørgrav
794d6d3e03eSDavid Chisnall20130906:
795d6d3e03eSDavid Chisnall	The GNU Compiler Collection and C++ standard library (libstdc++)
796d6d3e03eSDavid Chisnall	are no longer built by default on platforms where clang is the system
797d6d3e03eSDavid Chisnall	compiler.  You can enable them with the WITH_GCC and WITH_GNUCXX
798d6d3e03eSDavid Chisnall	options in src.conf.
799d6d3e03eSDavid Chisnall
8004877522eSPawel Jakub Dawidek20130905:
8012057b58bSPawel Jakub Dawidek	The PROCDESC kernel option is now part of the GENERIC kernel
8022057b58bSPawel Jakub Dawidek	configuration and is required for the rwhod(8) to work.
8032057b58bSPawel Jakub Dawidek	If you are using custom kernel configuration, you should include
8042057b58bSPawel Jakub Dawidek	'options PROCDESC'.
8052057b58bSPawel Jakub Dawidek
8062057b58bSPawel Jakub Dawidek20130905:
8074877522eSPawel Jakub Dawidek	The API and ABI related to the Capsicum framework was modified
8084877522eSPawel Jakub Dawidek	in backward incompatible way. The userland libraries and programs
8094877522eSPawel Jakub Dawidek	have to be recompiled to work with the new kernel. This includes the
8104877522eSPawel Jakub Dawidek	following libraries and programs, but the whole buildworld is
8114877522eSPawel Jakub Dawidek	advised: libc, libprocstat, dhclient, tcpdump, hastd, hastctl,
8124877522eSPawel Jakub Dawidek	kdump, procstat, rwho, rwhod, uniq.
8134877522eSPawel Jakub Dawidek
814c8a84c2aSJohn-Mark Gurney20130903:
815c8a84c2aSJohn-Mark Gurney	AES-NI intrinsic support has been added to gcc.  The AES-NI module
816c8a84c2aSJohn-Mark Gurney	has been updated to use this support.  A new gcc is required to build
817c8a84c2aSJohn-Mark Gurney	the aesni module on both i386 and amd64.
818c8a84c2aSJohn-Mark Gurney
81946be218dSDavid E. O'Brien20130821:
82046be218dSDavid E. O'Brien	The PADLOCK_RNG and RDRAND_RNG kernel options are now devices.
82146be218dSDavid E. O'Brien	Thus "device padlock_rng" and "device rdrand_rng" should be
82246be218dSDavid E. O'Brien	used instead of "options PADLOCK_RNG" & "options RDRAND_RNG".
82346be218dSDavid E. O'Brien
8240ff204bbSPeter Wemm20130813:
8250ff204bbSPeter Wemm	WITH_ICONV has been split into two feature sets.  WITH_ICONV now
8260ff204bbSPeter Wemm	enables just the iconv* functionality and is now on by default.
8270ff204bbSPeter Wemm	WITH_LIBICONV_COMPAT enables the libiconv api and link time
8280ff204bbSPeter Wemm	compatability.  Set WITHOUT_ICONV to build the old way.
8290dc59c0fSPeter Wemm	If you have been using WITH_ICONV before, you will very likely
8300dc59c0fSPeter Wemm	need to turn on WITH_LIBICONV_COMPAT.
8310ff204bbSPeter Wemm
832ccc88f7bSHiroki Sato20130806:
833c319ea15SAndriy Gapon	INVARIANTS option now enables DEBUG for code with OpenSolaris and
834c319ea15SAndriy Gapon	Illumos origin, including ZFS.  If you have INVARIANTS in your
835c319ea15SAndriy Gapon	kernel configuration, then there is no need to set DEBUG or ZFS_DEBUG
836c319ea15SAndriy Gapon	explicitly.
837c319ea15SAndriy Gapon	DEBUG used to enable witness(9) tracking of OpenSolaris (mostly ZFS)
838c319ea15SAndriy Gapon	locks if WITNESS option was set.  Because that generated a lot of
839c319ea15SAndriy Gapon	witness(9) reports and all of them were believed to be false
840c319ea15SAndriy Gapon	positives, this is no longer done.  New option OPENSOLARIS_WITNESS
841c319ea15SAndriy Gapon	can be used to achieve the previous behavior.
842c319ea15SAndriy Gapon
843c319ea15SAndriy Gapon20130806:
844ccc88f7bSHiroki Sato	Timer values in IPv6 data structures now use time_uptime instead
845ccc88f7bSHiroki Sato	of time_second.  Although this is not a user-visible functional
846ccc88f7bSHiroki Sato	change, userland utilities which directly use them---ndp(8),
847ccc88f7bSHiroki Sato	rtadvd(8), and rtsold(8) in the base system---need to be updated
848ccc88f7bSHiroki Sato	to r253970 or later.
849ccc88f7bSHiroki Sato
8509d6d5a71SJilles Tjoelker20130802:
8519d6d5a71SJilles Tjoelker	find -delete can now delete the pathnames given as arguments,
8529d6d5a71SJilles Tjoelker	instead of only files found below them or if the pathname did
8539d6d5a71SJilles Tjoelker	not contain any slashes. Formerly, the following error message
8549d6d5a71SJilles Tjoelker	would result:
8559d6d5a71SJilles Tjoelker
8569d6d5a71SJilles Tjoelker	find: -delete: <path>: relative path potentially not safe
8579d6d5a71SJilles Tjoelker
8589d6d5a71SJilles Tjoelker	Deleting the pathnames given as arguments can be prevented
8599d6d5a71SJilles Tjoelker	without error messages using -mindepth 1 or by changing
8609d6d5a71SJilles Tjoelker	directory and passing "." as argument to find. This works in the
8619d6d5a71SJilles Tjoelker	old as well as the new version of find.
8629d6d5a71SJilles Tjoelker
863663dea3dSAndriy Gapon20130726:
864663dea3dSAndriy Gapon	Behavior of devfs rules path matching has been changed.
865663dea3dSAndriy Gapon	Pattern is now always matched against fully qualified devfs
866663dea3dSAndriy Gapon	path and slash characters must be explicitly matched by
867663dea3dSAndriy Gapon	slashes in pattern (FNM_PATHNAME). Rulesets involving devfs
868663dea3dSAndriy Gapon	subdirectories must be reviewed.
869663dea3dSAndriy Gapon
87046e95f64SAndrew Turner20130716:
87146e95f64SAndrew Turner	The default ARM ABI has changed to the ARM EABI. The old ABI is
87246e95f64SAndrew Turner	incompatible with the ARM EABI and all programs and modules will
87346e95f64SAndrew Turner	need to be rebuilt to work with a new kernel.
87446e95f64SAndrew Turner
87546e95f64SAndrew Turner	To keep using the old ABI ensure the WITHOUT_ARM_EABI knob is set.
87646e95f64SAndrew Turner
87746e95f64SAndrew Turner	NOTE: Support for the old ABI will be removed in the future and
87846e95f64SAndrew Turner	users are advised to upgrade.
87946e95f64SAndrew Turner
880b40e2b6dSAndrey V. Elsukov20130709:
8819b953f2cSBaptiste Daroussin	pkg_install has been disconnected from the build if you really need it
8829b953f2cSBaptiste Daroussin	you should add WITH_PKGTOOLS in your src.conf(5).
8839b953f2cSBaptiste Daroussin
8849b953f2cSBaptiste Daroussin20130709:
885b40e2b6dSAndrey V. Elsukov	Most of network statistics structures were changed to be able
886b40e2b6dSAndrey V. Elsukov	keep 64-bits counters. Thus all tools, that work with networking
887aa011413SRui Paulo	statistics, must be rebuilt (netstat(1), bsnmpd(1), etc.)
888b40e2b6dSAndrey V. Elsukov
8895b3e0257SDag-Erling Smørgrav20130618:
8905b3e0257SDag-Erling Smørgrav	Fix a bug that allowed a tracing process (e.g. gdb) to write
8915b3e0257SDag-Erling Smørgrav	to a memory-mapped file in the traced process's address space
8925b3e0257SDag-Erling Smørgrav	even if neither the traced process nor the tracing process had
8935b3e0257SDag-Erling Smørgrav	write access to that file.
8945b3e0257SDag-Erling Smørgrav
8951cbff2a9SEitan Adler20130615:
8961cbff2a9SEitan Adler	CVS has been removed from the base system.  An exact copy
8971cbff2a9SEitan Adler	of the code is available from the devel/cvs port.
8981cbff2a9SEitan Adler
899ba10b444SSimon J. Gerraty20130613:
900ba10b444SSimon J. Gerraty	Some people report the following error after the switch to bmake:
901ba10b444SSimon J. Gerraty
902ba10b444SSimon J. Gerraty		make: illegal option -- J
903ba10b444SSimon J. Gerraty		usage: make [-BPSXeiknpqrstv] [-C directory] [-D variable]
904ba10b444SSimon J. Gerraty			...
905ba10b444SSimon J. Gerraty		*** [buildworld] Error code 2
906ba10b444SSimon J. Gerraty
907ba10b444SSimon J. Gerraty	this likely due to an old instance of make in
908ba10b444SSimon J. Gerraty	${MAKEPATH} (${MAKEOBJDIRPREFIX}${.CURDIR}/make.${MACHINE})
909ba10b444SSimon J. Gerraty	which src/Makefile will use that blindly, if it exists, so if
910ba10b444SSimon J. Gerraty	you see the above error:
911ba10b444SSimon J. Gerraty
912ba10b444SSimon J. Gerraty		rm -rf `make -V MAKEPATH`
913ba10b444SSimon J. Gerraty
914ba10b444SSimon J. Gerraty	should resolve it.
915ba10b444SSimon J. Gerraty
916ff8d4375SSimon J. Gerraty20130516:
917ff8d4375SSimon J. Gerraty	Use bmake by default.
918ff8d4375SSimon J. Gerraty	Whereas before one could choose to build with bmake via
919ff8d4375SSimon J. Gerraty	-DWITH_BMAKE one must now use -DWITHOUT_BMAKE to use the old
920ff8d4375SSimon J. Gerraty	make. The goal is to remove these knobs for 10-RELEASE.
921ff8d4375SSimon J. Gerraty
922ff8d4375SSimon J. Gerraty	It is worth noting that bmake (like gmake) treats the command
923ff8d4375SSimon J. Gerraty	line as the unit of failure, rather than statements within the
924ff8d4375SSimon J. Gerraty	command line.  Thus '(cd some/where && dosomething)' is safer
925ff8d4375SSimon J. Gerraty	than 'cd some/where; dosomething'. The '()' allows consistent
926ff8d4375SSimon J. Gerraty	behavior in parallel build.
927ff8d4375SSimon J. Gerraty
92832164d53SDag-Erling Smørgrav20130429:
92932164d53SDag-Erling Smørgrav        Fix a bug that allows NFS clients to issue READDIR on files.
93032164d53SDag-Erling Smørgrav
931562a9d58SSteven Hartland20130426:
932850163e4SEitan Adler	The WITHOUT_IDEA option has been removed because
933850163e4SEitan Adler	the IDEA patent expired.
934850163e4SEitan Adler
935850163e4SEitan Adler20130426:
936562a9d58SSteven Hartland	The sysctl which controls TRIM support under ZFS has been renamed
937562a9d58SSteven Hartland	from vfs.zfs.trim_disable -> vfs.zfs.trim.enabled and has been
938562a9d58SSteven Hartland	enabled by default.
939562a9d58SSteven Hartland
94020e0cc0aSBrooks Davis20130425:
94120e0cc0aSBrooks Davis	The mergemaster command now uses the default MAKEOBJDIRPREFIX
94220e0cc0aSBrooks Davis	rather than creating it's own in the temporary directory in
94320e0cc0aSBrooks Davis	order allow access to bootstrapped versions of tools such as
94420e0cc0aSBrooks Davis	install and mtree.  When upgrading from version of FreeBSD where
94520e0cc0aSBrooks Davis	the install command does not support -l, you will need to
94620e0cc0aSBrooks Davis	install a new mergemaster command if mergemaster -p is required.
94720e0cc0aSBrooks Davis	This can be accomplished with the command (cd src/usr.sbin/mergemaster
94820e0cc0aSBrooks Davis	&& make install).
94920e0cc0aSBrooks Davis
9509a95a7caSAlexander Motin20130404:
9519a95a7caSAlexander Motin	Legacy ATA stack, disabled and replaced by new CAM-based one since
9529a95a7caSAlexander Motin	FreeBSD 9.0, completely removed from the sources.  Kernel modules
9539a95a7caSAlexander Motin	atadisk and atapi*, user-level tools atacontrol and burncd are
9549a95a7caSAlexander Motin	removed.  Kernel option `options ATA_CAM` is now permanently enabled
9559a95a7caSAlexander Motin	and removed.
9569a95a7caSAlexander Motin
9575ad7e649SJilles Tjoelker20130319:
9585ad7e649SJilles Tjoelker	SOCK_CLOEXEC and SOCK_NONBLOCK flags have been added to socket(2)
9595ad7e649SJilles Tjoelker	and socketpair(2). Software, in particular Kerberos, may
9605ad7e649SJilles Tjoelker	automatically detect and use these during building. The resulting
9615ad7e649SJilles Tjoelker	binaries will not work on older kernels.
9625ad7e649SJilles Tjoelker
963105421ffSMarius Strobl20130308:
964105421ffSMarius Strobl	CTL_DISABLE has also been added to the sparc64 GENERIC (for further
965105421ffSMarius Strobl	information, see the respective 20130304 entry).
966105421ffSMarius Strobl
9673a45b478SKenneth D. Merry20130304:
96823d44ab5SDavide Italiano	Recent commits to callout(9) changed the size of struct callout,
96923d44ab5SDavide Italiano	so the KBI is probably heavily disturbed. Also, some functions
97023d44ab5SDavide Italiano	in callout(9)/sleep(9)/sleepqueue(9)/condvar(9) KPIs were replaced
97123d44ab5SDavide Italiano	by macros. Every kernel module using it won't load, so rebuild
97223d44ab5SDavide Italiano	is requested.
97323d44ab5SDavide Italiano
9743a45b478SKenneth D. Merry	The ctl device has been re-enabled in GENERIC for i386 and amd64,
9753a45b478SKenneth D. Merry	but does not initialize by default (because of the new CTL_DISABLE
9763a45b478SKenneth D. Merry	option) to save memory.  To re-enable it, remove the CTL_DISABLE
9773a45b478SKenneth D. Merry	option from the kernel config file or set kern.cam.ctl.disable=0
9783a45b478SKenneth D. Merry	in /boot/loader.conf.
9793a45b478SKenneth D. Merry
980fe138cc2SAdrian Chadd20130301:
981fe138cc2SAdrian Chadd	The ctl device has been disabled in GENERIC for i386 and amd64.
982fe138cc2SAdrian Chadd	This was done due to the extra memory being allocated at system
983fe138cc2SAdrian Chadd	initialisation time by the ctl driver which was only used if
984fe138cc2SAdrian Chadd	a CAM target device was created.  This makes a FreeBSD system
985fe138cc2SAdrian Chadd	unusable on 128MB or less of RAM.
986fe138cc2SAdrian Chadd
98720a011d5SXin LI20130208:
98820a011d5SXin LI	A new compression method (lz4) has been merged to -HEAD.  Please
98920a011d5SXin LI	refer to zpool-features(7) for more information.
99020a011d5SXin LI
99120a011d5SXin LI	Please refer to the "ZFS notes" section of this file for information
99220a011d5SXin LI	on upgrading boot ZFS pools.
99320a011d5SXin LI
9942dd076b8SGabor Kovesdan20130129:
9952dd076b8SGabor Kovesdan	A BSD-licensed patch(1) variant has been added and is installed
9962dd076b8SGabor Kovesdan	as bsdpatch, being the GNU version the default patch.
9972dd076b8SGabor Kovesdan	To inverse the logic and use the BSD-licensed one as default,
9982dd076b8SGabor Kovesdan	while having the GNU version installed as gnupatch, rebuild
9992d329593SGabor Kovesdan	and install world with the WITH_BSD_PATCH knob set.
10002dd076b8SGabor Kovesdan
1001fe06cae7SBrooks Davis20130121:
1002fe06cae7SBrooks Davis	Due to the use of the new -l option to install(1) during build
1003fe06cae7SBrooks Davis	and install, you must take care not to directly set the INSTALL
1004fe06cae7SBrooks Davis	make variable in your /etc/make.conf, /etc/src.conf, or on the
10058c5836c3SEitan Adler	command line.  If you wish to use the -C flag for all installs
1006fe06cae7SBrooks Davis	you may be able to add INSTALL+=-C to /etc/make.conf or
1007fe06cae7SBrooks Davis	/etc/src.conf.
1008fe06cae7SBrooks Davis
1009f2b19f9eSBrooks Davis20130118:
1010f2b19f9eSBrooks Davis	The install(1) option -M has changed meaning and now takes an
1011f2b19f9eSBrooks Davis	argument that is a file or path to append logs to.  In the
1012f2b19f9eSBrooks Davis	unlikely event that -M was the last option on the command line
1013f2b19f9eSBrooks Davis	and the command line contained at least two files and a target
1014f2b19f9eSBrooks Davis	directory the first file will have logs appended to it.  The -M
10154cf5de80SGlen Barber	option served little practical purpose in the last decade so its
10164cf5de80SGlen Barber	use is expected to be extremely rare.
1017f2b19f9eSBrooks Davis
10183fea4e6bSAndriy Gapon20121223:
10193fea4e6bSAndriy Gapon	After switching to Clang as the default compiler some users of ZFS
10203fea4e6bSAndriy Gapon	on i386 systems started to experience stack overflow kernel panics.
10213fea4e6bSAndriy Gapon	Please consider using 'options KSTACK_PAGES=4' in such configurations.
10223fea4e6bSAndriy Gapon
1023efec959cSJaakko Heinonen20121222:
1024efec959cSJaakko Heinonen	GEOM_LABEL now mangles label names read from file system metadata.
1025efec959cSJaakko Heinonen	Mangling affect labels containing spaces, non-printable characters,
1026efec959cSJaakko Heinonen	'%' or '"'. Device names in /etc/fstab and other places may need to
1027efec959cSJaakko Heinonen	be updated.
1028efec959cSJaakko Heinonen
102911631ad0SPawel Jakub Dawidek20121217:
103011631ad0SPawel Jakub Dawidek	By default, only the 10 most recent kernel dumps will be saved.  To
103111631ad0SPawel Jakub Dawidek	restore the previous behaviour (no limit on the number of kernel dumps
103211631ad0SPawel Jakub Dawidek	stored in the dump directory) add the following line to /etc/rc.conf:
103311631ad0SPawel Jakub Dawidek
103411631ad0SPawel Jakub Dawidek		savecore_flags=""
103511631ad0SPawel Jakub Dawidek
1036e0fb6dc3SRobert Watson20121201:
1037e0fb6dc3SRobert Watson	With the addition of auditdistd(8), a new auditdistd user is now
10380312d1caSGlen Barber	required during installworld.  "mergemaster -p" can be used to
10390312d1caSGlen Barber	add the user prior to installworld, as documented in the handbook.
1040e0fb6dc3SRobert Watson
1041b91dc775SHiroki Sato20121117:
1042b91dc775SHiroki Sato	The sin6_scope_id member variable in struct sockaddr_in6 is now
1043b91dc775SHiroki Sato	filled by the kernel before passing the structure to the userland via
1044b91dc775SHiroki Sato	sysctl or routing socket.  This means the KAME-specific embedded scope
1045b91dc775SHiroki Sato	id in sin6_addr.s6_addr[2] is always cleared in userland application.
1046b91dc775SHiroki Sato	This behavior can be controlled by net.inet6.ip6.deembed_scopeid.
1047b91dc775SHiroki Sato	__FreeBSD_version is bumped to 1000025.
1048b91dc775SHiroki Sato
10495b6478b0SBrooks Davis20121105:
10505b6478b0SBrooks Davis	On i386 and amd64 systems WITH_CLANG_IS_CC is now the default.
10515b6478b0SBrooks Davis	This means that the world and kernel will be compiled with clang
10525b6478b0SBrooks Davis	and that clang will be installed as /usr/bin/cc, /usr/bin/c++,
10535b6478b0SBrooks Davis	and /usr/bin/cpp.  To disable this behavior and revert to building
1054da0e842aSWarner Losh	with gcc, compile with WITHOUT_CLANG_IS_CC. Really old versions
1055da0e842aSWarner Losh	of current may need to bootstrap WITHOUT_CLANG first if the clang
1056da0e842aSWarner Losh	build fails (its compatibility window doesn't extend to the 9 stable
1057da0e842aSWarner Losh	branch point).
10585b6478b0SBrooks Davis
1059ffdbf9daSAndrey V. Elsukov20121102:
1060a971b547SAndrey V. Elsukov	The IPFIREWALL_FORWARD kernel option has been removed. Its
1061ffdbf9daSAndrey V. Elsukov	functionality now turned on by default.
1062a971b547SAndrey V. Elsukov
10638f134647SGleb Smirnoff20121023:
1064cb69178dSAndre Oppermann	The ZERO_COPY_SOCKET kernel option has been removed and
1065cb69178dSAndre Oppermann	split into SOCKET_SEND_COW and SOCKET_RECV_PFLIP.
1066cb69178dSAndre Oppermann	NB: SOCKET_SEND_COW uses the VM page based copy-on-write
1067cb69178dSAndre Oppermann	mechanism which is not safe and may result in kernel crashes.
1068cb69178dSAndre Oppermann	NB: The SOCKET_RECV_PFLIP mechanism is useless as no current
1069cb69178dSAndre Oppermann	driver supports disposeable external page sized mbuf storage.
1070cb69178dSAndre Oppermann	Proper replacements for both zero-copy mechanisms are under
1071cb69178dSAndre Oppermann	consideration and will eventually lead to complete removal
1072cb69178dSAndre Oppermann	of the two kernel options.
1073cb69178dSAndre Oppermann
1074cb69178dSAndre Oppermann20121023:
10758f134647SGleb Smirnoff	The IPv4 network stack has been converted to network byte
10768f134647SGleb Smirnoff	order. The following modules need to be recompiled together
10778f134647SGleb Smirnoff	with kernel: carp(4), divert(4), gif(4), siftr(4), gre(4),
10788f134647SGleb Smirnoff	pf(4), ipfw(4), ng_ipfw(4), stf(4).
10798f134647SGleb Smirnoff
10808859ec84SKonstantin Belousov20121022:
10818859ec84SKonstantin Belousov	Support for non-MPSAFE filesystems was removed from VFS. The
10828859ec84SKonstantin Belousov	VFS_VERSION was bumped, all filesystem modules shall be
10838859ec84SKonstantin Belousov	recompiled.
10848859ec84SKonstantin Belousov
1085e053ead0SAttilio Rao20121018:
1086e053ead0SAttilio Rao	All the non-MPSAFE filesystems have been disconnected from
1087e053ead0SAttilio Rao	the build. The full list includes: codafs, hpfs, ntfs, nwfs,
1088e053ead0SAttilio Rao	portalfs, smbfs, xfs.
1089e053ead0SAttilio Rao
109042a58907SGleb Smirnoff20121016:
109142a58907SGleb Smirnoff	The interface cloning API and ABI has changed. The following
109242a58907SGleb Smirnoff	modules need to be recompiled together with kernel:
109342a58907SGleb Smirnoff	ipfw(4), pfsync(4), pflog(4), usb(4), wlan(4), stf(4),
109442a58907SGleb Smirnoff	vlan(4), disc(4), edsc(4), if_bridge(4), gif(4), tap(4),
109542a58907SGleb Smirnoff	faith(4), epair(4), enc(4), tun(4), if_lagg(4), gre(4).
109642a58907SGleb Smirnoff
1097d6b3aaf8SOleksandr Tymoshenko20121015:
1098d6b3aaf8SOleksandr Tymoshenko	The sdhci driver was split in two parts: sdhci (generic SD Host
1099d6b3aaf8SOleksandr Tymoshenko	Controller logic) and sdhci_pci (actual hardware driver).
1100d6b3aaf8SOleksandr Tymoshenko	No kernel config modifications are required, but if you
1101d6b3aaf8SOleksandr Tymoshenko	load sdhc as a module you must switch to sdhci_pci instead.
1102d6b3aaf8SOleksandr Tymoshenko
11035fe58019SAttilio Rao20121014:
11045fe58019SAttilio Rao	Import the FUSE kernel and userland support into base system.
11055fe58019SAttilio Rao
1106d38ae94bSGabor Kovesdan20121013:
1107d38ae94bSGabor Kovesdan	The GNU sort(1) program has been removed since the BSD-licensed
1108d38ae94bSGabor Kovesdan	sort(1) has been the default for quite some time and no serious
1109d38ae94bSGabor Kovesdan	problems have been reported.  The corresponding WITH_GNU_SORT
111058b6d9a2SGabor Kovesdan	knob has also gone.
1111d38ae94bSGabor Kovesdan
111221d172a3SGleb Smirnoff20121006:
111321d172a3SGleb Smirnoff	The pfil(9) API/ABI for AF_INET family has been changed. Packet
111421d172a3SGleb Smirnoff	filtering modules: pf(4), ipfw(4), ipfilter(4) need to be recompiled
111521d172a3SGleb Smirnoff	with new kernel.
111621d172a3SGleb Smirnoff
11177b81c83cSAdrian Chadd20121001:
11187b81c83cSAdrian Chadd	The net80211(4) ABI has been changed to allow for improved driver
11197b81c83cSAdrian Chadd	PS-POLL and power-save support.  All wireless drivers need to be
11207b81c83cSAdrian Chadd	recompiled to work with the new kernel.
11217b81c83cSAdrian Chadd
1122d65043bcSKonstantin Belousov20120913:
1123d65043bcSKonstantin Belousov	The random(4) support for the VIA hardware random number
1124d65043bcSKonstantin Belousov	generator (`PADLOCK') is no longer enabled unconditionally.
112546be218dSDavid E. O'Brien	Add the padlock_rng device in the custom kernel config if
1126d65043bcSKonstantin Belousov	needed.  The GENERIC kernels on i386 and amd64 do include the
112746be218dSDavid E. O'Brien	device, so the change only affects the custom kernel
1128d65043bcSKonstantin Belousov	configurations.
1129d65043bcSKonstantin Belousov
1130d6d3f01eSGleb Smirnoff20120908:
1131d6d3f01eSGleb Smirnoff	The pf(4) packet filter ABI has been changed. pfctl(8) and
1132d6d3f01eSGleb Smirnoff	snmp_pf module need to be recompiled to work with new kernel.
1133d6d3f01eSGleb Smirnoff
11346e767defSMartin Matuska20120828:
11356e767defSMartin Matuska	A new ZFS feature flag "com.delphix:empty_bpobj" has been merged
11366e767defSMartin Matuska	to -HEAD. Pools that have empty_bpobj in active state can not be
11376e767defSMartin Matuska	imported read-write with ZFS implementations that do not support
11386e767defSMartin Matuska	this feature. For more information read the zpool-features(5)
11396e767defSMartin Matuska	manual page.
11406e767defSMartin Matuska
1141614e3098SMarius Strobl20120727:
1142614e3098SMarius Strobl	The sparc64 ZFS loader has been changed to no longer try to auto-
1143614e3098SMarius Strobl	detect ZFS providers based on diskN aliases but now requires these
1144614e3098SMarius Strobl	to be explicitly listed in the OFW boot-device environment variable.
1145614e3098SMarius Strobl
11467e003b0aSChristian Brueffer20120712:
11471f13597dSJung-uk Kim	The OpenSSL has been upgraded to 1.0.1c.  Any binaries requiring
11481f13597dSJung-uk Kim	libcrypto.so.6 or libssl.so.6 must be recompiled.  Also, there are
11491f13597dSJung-uk Kim	configuration changes.  Make sure to merge /etc/ssl/openssl.cnf.
11501f13597dSJung-uk Kim
11511f13597dSJung-uk Kim20120712:
11527e003b0aSChristian Brueffer	The following sysctls and tunables have been renamed for consistency
11537e003b0aSChristian Brueffer	with other variables:
11547e003b0aSChristian Brueffer	  kern.cam.da.da_send_ordered   -> kern.cam.da.send_ordered
11557e003b0aSChristian Brueffer	  kern.cam.ada.ada_send_ordered -> kern.cam.ada.send_ordered
11567e003b0aSChristian Brueffer
1157d22c63acSGabor Kovesdan20120628:
1158d22c63acSGabor Kovesdan	The sort utility has been replaced with BSD sort.  For now, GNU sort
1159d22c63acSGabor Kovesdan	is also available as "gnusort" or the default can be set back to
1160d22c63acSGabor Kovesdan	GNU sort by setting WITH_GNU_SORT.  In this case, BSD sort will be
1161d22c63acSGabor Kovesdan	installed as "bsdsort".
1162d22c63acSGabor Kovesdan
11632d9cf57eSMartin Matuska20120611:
11642d9cf57eSMartin Matuska	A new version of ZFS (pool version 5000) has been merged to -HEAD.
11652d9cf57eSMartin Matuska	Starting with this version the old system of ZFS pool versioning
11662d9cf57eSMartin Matuska	is superseded by "feature flags". This concept enables forward
11672d9cf57eSMartin Matuska	compatibility against certain future changes in functionality of ZFS
11682d9cf57eSMartin Matuska	pools. The first read-only compatible "feature flag" for ZFS pools
11692d9cf57eSMartin Matuska	is named "com.delphix:async_destroy". For more information
11702d9cf57eSMartin Matuska	read the new zpool-features(5) manual page.
11712d9cf57eSMartin Matuska	Please refer to the "ZFS notes" section of this file for information
11722d9cf57eSMartin Matuska	on upgrading boot ZFS pools.
11732d9cf57eSMartin Matuska
1174d1675e38SJason Evans20120417:
1175d1675e38SJason Evans	The malloc(3) implementation embedded in libc now uses sources imported
1176d1675e38SJason Evans	as contrib/jemalloc.  The most disruptive API change is to
1177d1675e38SJason Evans	/etc/malloc.conf.  If your system has an old-style /etc/malloc.conf,
1178d1675e38SJason Evans	delete it prior to installworld, and optionally re-create it using the
1179d1675e38SJason Evans	new format after rebooting.  See malloc.conf(5) for details
1180d1675e38SJason Evans	(specifically the TUNING section and the "opt.*" entries in the MALLCTL
1181d1675e38SJason Evans	NAMESPACE section).
1182d1675e38SJason Evans
118384db023eSJuli Mallett20120328:
118484db023eSJuli Mallett	Big-endian MIPS TARGET_ARCH values no longer end in "eb".  mips64eb
118584db023eSJuli Mallett	is now spelled mips64.  mipsn32eb is now spelled mipsn32.  mipseb is
118684db023eSJuli Mallett	now spelled mips.  This is to aid compatibility with third-party
118784db023eSJuli Mallett	software that expects this naming scheme in uname(3).  Little-endian
1188474dbfb7SWarner Losh	settings are unchanged. If you are updating a big-endian mips64 machine
1189474dbfb7SWarner Losh	from before this change, you may need to set MACHINE_ARCH=mips64 in
1190474dbfb7SWarner Losh	your environment before the new build system will recognize your machine.
119184db023eSJuli Mallett
11929c170fd1SAttilio Rao20120306:
11939c170fd1SAttilio Rao	Disable by default the option VFS_ALLOW_NONMPSAFE for all supported
11949c170fd1SAttilio Rao	platforms.
11959c170fd1SAttilio Rao
1196c7e41c8bSMikolaj Golub20120229:
1197c7e41c8bSMikolaj Golub	Now unix domain sockets behave "as expected" on	nullfs(5). Previously
1198c7e41c8bSMikolaj Golub	nullfs(5) did not pass through all behaviours to the underlying layer,
1199c7e41c8bSMikolaj Golub	as a result if we bound to a socket on the lower layer we could connect
1200c7e41c8bSMikolaj Golub	only to the lower path; if we bound to the upper layer we could connect
1201c7e41c8bSMikolaj Golub	only to	the upper path. The new behavior is one can connect to both the
1202c7e41c8bSMikolaj Golub	lower and the upper paths regardless what layer path one binds to.
1203c7e41c8bSMikolaj Golub
1204ca1672daSBjoern A. Zeeb20120211:
1205ca1672daSBjoern A. Zeeb	The getifaddrs upgrade path broken with 20111215 has been restored.
1206ca1672daSBjoern A. Zeeb	If you have upgraded in between 20111215 and 20120209 you need to
1207ca1672daSBjoern A. Zeeb	recompile libc again with your kernel.  You still need to recompile
1208ca1672daSBjoern A. Zeeb	world to be able to configure CARP but this restriction already
1209ca1672daSBjoern A. Zeeb	comes from 20111215.
1210ca1672daSBjoern A. Zeeb
1211e0e0f25bSDoug Barton20120114:
1212e0e0f25bSDoug Barton	The set_rcvar() function has been removed from /etc/rc.subr.  All
1213e0e0f25bSDoug Barton	base and ports rc.d scripts have been updated, so if you have a
1214e0e0f25bSDoug Barton	port installed with a script in /usr/local/etc/rc.d you can either
1215e0e0f25bSDoug Barton	hand-edit the rcvar= line, or reinstall the port.
1216e0e0f25bSDoug Barton
12175d482324SDoug Barton	An easy way to handle the mass-update of /etc/rc.d:
12185d482324SDoug Barton	rm /etc/rc.d/* && mergemaster -i
12195d482324SDoug Barton
122090d82653SAndriy Gapon20120109:
122190d82653SAndriy Gapon	panic(9) now stops other CPUs in the SMP systems, disables interrupts
122290d82653SAndriy Gapon	on the current CPU and prevents other threads from running.
122390d82653SAndriy Gapon	This behavior can be reverted using the kern.stop_scheduler_on_panic
122490d82653SAndriy Gapon	tunable/sysctl.
122590d82653SAndriy Gapon	The new behavior can be incompatible with kern.sync_on_panic.
122690d82653SAndriy Gapon
122708b68b0eSGleb Smirnoff20111215:
122808b68b0eSGleb Smirnoff	The carp(4) facility has been changed significantly. Configuration
122908b68b0eSGleb Smirnoff	of the CARP protocol via ifconfig(8) has changed, as well as format
123008b68b0eSGleb Smirnoff	of CARP events submitted to devd(8) has changed. See manual pages
123108b68b0eSGleb Smirnoff	for more information. The arpbalance feature of carp(4) is currently
123208b68b0eSGleb Smirnoff	not supported anymore.
123308b68b0eSGleb Smirnoff
123408b68b0eSGleb Smirnoff	Size of struct in_aliasreq, struct in6_aliasreq has changed. User
123508b68b0eSGleb Smirnoff	utilities using SIOCAIFADDR, SIOCAIFADDR_IN6, e.g. ifconfig(8),
123608b68b0eSGleb Smirnoff	need to be recompiled.
123708b68b0eSGleb Smirnoff
1238d5d131eeSJaakko Heinonen20111122:
1239d5d131eeSJaakko Heinonen	The acpi_wmi(4) status device /dev/wmistat has been renamed to
1240d5d131eeSJaakko Heinonen	/dev/wmistat0.
1241d5d131eeSJaakko Heinonen
1242ed1f6dc2SAttilio Rao20111108:
1243ed1f6dc2SAttilio Rao	The option VFS_ALLOW_NONMPSAFE option has been added in order to
1244ed1f6dc2SAttilio Rao	explicitely support non-MPSAFE filesystems.
1245ed1f6dc2SAttilio Rao	It is on by default for all supported platform at this present
1246ed1f6dc2SAttilio Rao	time.
1247ed1f6dc2SAttilio Rao
1248a9ab459bSMarius Strobl20111101:
1249a9ab459bSMarius Strobl	The broken amd(4) driver has been replaced with esp(4) in the amd64,
1250a9ab459bSMarius Strobl	i386 and pc98 GENERIC kernel configuration files.
1251a9ab459bSMarius Strobl
1252e59e2d8eSNathan Whitehorn20110930:
1253e59e2d8eSNathan Whitehorn	sysinstall has been removed
1254e59e2d8eSNathan Whitehorn
12558a3b6cc1SKen Smith20110923:
12568a3b6cc1SKen Smith	The stable/9 branch created in subversion.  This corresponds to the
12578a3b6cc1SKen Smith	RELENG_9 branch in CVS.
12588a3b6cc1SKen Smith
1259dc0dbf5cSWarner LoshCOMMON ITEMS:
1260dc0dbf5cSWarner Losh
1261a24eff53SWarner Losh	General Notes
1262a24eff53SWarner Losh	-------------
1263456b5dd8SWarner Losh	Avoid using make -j when upgrading.  While generally safe, there are
1264456b5dd8SWarner Losh	sometimes problems using -j to upgrade.  If your upgrade fails with
12651733d35cSRuslan Ermilov	-j, please try again without -j.  From time to time in the past there
1266456b5dd8SWarner Losh	have been problems using -j with buildworld and/or installworld.  This
1267456b5dd8SWarner Losh	is especially true when upgrading between "distant" versions (eg one
1268456b5dd8SWarner Losh	that cross a major release boundary or several minor releases, or when
1269456b5dd8SWarner Losh	several months have passed on the -current branch).
1270a24eff53SWarner Losh
12715780f3baSWarner Losh	Sometimes, obscure build problems are the result of environment
12725780f3baSWarner Losh	poisoning.  This can happen because the make utility reads its
1273456b5dd8SWarner Losh	environment when searching for values for global variables.  To run
1274456b5dd8SWarner Losh	your build attempts in an "environmental clean room", prefix all make
1275456b5dd8SWarner Losh	commands with 'env -i '.  See the env(1) manual page for more details.
12765780f3baSWarner Losh
1277456b5dd8SWarner Losh	When upgrading from one major version to another it is generally best
1278456b5dd8SWarner Losh	to upgrade to the latest code in the currently installed branch first,
1279456b5dd8SWarner Losh	then do an upgrade to the new branch. This is the best-tested upgrade
1280456b5dd8SWarner Losh	path, and has the highest probability of being successful.  Please try
1281456b5dd8SWarner Losh	this approach before reporting problems with a major version upgrade.
1282081ff8acSDoug Barton
12836eeab389SWarner Losh	When upgrading a live system, having a root shell around before
1284da0e842aSWarner Losh	installing anything can help undo problems. Not having a root shell
1285da0e842aSWarner Losh	around can lead to problems if pam has changed too much from your
1286da0e842aSWarner Losh	starting point to allow continued authentication after the upgrade.
1287da0e842aSWarner Losh
12889c80b8aaSWarner Losh	This file should be read as a log of events. When a later event changes
12899c80b8aaSWarner Losh	information of a prior event, the prior event should not be deleted.
12909c80b8aaSWarner Losh	Instead, a pointer to the entry with the new information should be
12919c80b8aaSWarner Losh	placed in the old entry. Readers of this file should also sanity check
12929c80b8aaSWarner Losh	older entries before relying on them blindly. Authors of new entries
12939c80b8aaSWarner Losh	should write them with this in mind.
12949c80b8aaSWarner Losh
12958fc25799SMartin Matuska	ZFS notes
12968fc25799SMartin Matuska	---------
12978fc25799SMartin Matuska	When upgrading the boot ZFS pool to a new version, always follow
12988fc25799SMartin Matuska	these two steps:
12998fc25799SMartin Matuska
13008fc25799SMartin Matuska	1.) recompile and reinstall the ZFS boot loader and boot block
13018fc25799SMartin Matuska	(this is part of "make buildworld" and "make installworld")
13028fc25799SMartin Matuska
13038fc25799SMartin Matuska	2.) update the ZFS boot block on your boot drive
13048fc25799SMartin Matuska
13058fc25799SMartin Matuska	The following example updates the ZFS boot block on the first
130672ce7f29SAlexander Leidinger	partition (freebsd-boot) of a GPT partitioned drive ada0:
130772ce7f29SAlexander Leidinger	"gpart bootcode -p /boot/gptzfsboot -i 1 ada0"
13088fc25799SMartin Matuska
13098fc25799SMartin Matuska	Non-boot pools do not need these updates.
13108fc25799SMartin Matuska
1311dc0dbf5cSWarner Losh	To build a kernel
1312dc0dbf5cSWarner Losh	-----------------
1313ba01eb20SWarner Losh	If you are updating from a prior version of FreeBSD (even one just
13141cf0ef11SDavid E. O'Brien	a few days old), you should follow this procedure.  It is the most
13151cf0ef11SDavid E. O'Brien	failsafe as it uses a /usr/obj tree with a fresh mini-buildworld,
13161cf0ef11SDavid E. O'Brien
13171cf0ef11SDavid E. O'Brien	make kernel-toolchain
1318282e0f01SRuslan Ermilov	make -DALWAYS_CHECK_MAKE buildkernel KERNCONF=YOUR_KERNEL_HERE
1319282e0f01SRuslan Ermilov	make -DALWAYS_CHECK_MAKE installkernel KERNCONF=YOUR_KERNEL_HERE
1320dc0dbf5cSWarner Losh
13212e937dd6SAlexander Leidinger	To test a kernel once
13222e937dd6SAlexander Leidinger	---------------------
13232e937dd6SAlexander Leidinger	If you just want to boot a kernel once (because you are not sure
13242e937dd6SAlexander Leidinger	if it works, or if you want to boot a known bad kernel to provide
13252e937dd6SAlexander Leidinger	debugging information) run
13262e937dd6SAlexander Leidinger	make installkernel KERNCONF=YOUR_KERNEL_HERE KODIR=/boot/testkernel
13272e937dd6SAlexander Leidinger	nextboot -k testkernel
13282e937dd6SAlexander Leidinger
1329ba01eb20SWarner Losh	To just build a kernel when you know that it won't mess you up
1330ba01eb20SWarner Losh	--------------------------------------------------------------
1331456b5dd8SWarner Losh	This assumes you are already running a CURRENT system.  Replace
13320fbd2da9SKen Smith	${arch} with the architecture of your machine (e.g. "i386",
1333456b5dd8SWarner Losh	"arm", "amd64", "ia64", "pc98", "sparc64", "powerpc", "mips", etc).
13340fbd2da9SKen Smith
13350fbd2da9SKen Smith	cd src/sys/${arch}/conf
133647d0d01fSWarner Losh	config KERNEL_NAME_HERE
13370fbd2da9SKen Smith	cd ../compile/KERNEL_NAME_HERE
1338ba01eb20SWarner Losh	make depend
1339ba01eb20SWarner Losh	make
1340ba01eb20SWarner Losh	make install
1341ba01eb20SWarner Losh
1342ba01eb20SWarner Losh	If this fails, go to the "To build a kernel" section.
1343ba01eb20SWarner Losh
1344ba01eb20SWarner Losh	To rebuild everything and install it on the current system.
1345ba01eb20SWarner Losh	-----------------------------------------------------------
134663cb445eSWarner Losh	# Note: sometimes if you are running current you gotta do more than
134763cb445eSWarner Losh	# is listed here if you are upgrading from a really old current.
134863cb445eSWarner Losh
1349f643de42SWarner Losh	<make sure you have good level 0 dumps>
135063cb445eSWarner Losh	make buildworld
13516586253aSWarner Losh	make kernel KERNCONF=YOUR_KERNEL_HERE
135263cb445eSWarner Losh							[1]
135363cb445eSWarner Losh	<reboot in single user>				[3]
135405940036SJohn-Mark Gurney	mergemaster -Fp					[5]
135563cb445eSWarner Losh	make installworld
135605940036SJohn-Mark Gurney	mergemaster -Fi					[4]
135794877c06SAlexander Leidinger	make delete-old					[6]
135863cb445eSWarner Losh	<reboot>
135963cb445eSWarner Losh
1360f27b1fceSJoseph Koshy	To cross-install current onto a separate partition
1361f27b1fceSJoseph Koshy	--------------------------------------------------
1362f27b1fceSJoseph Koshy	# In this approach we use a separate partition to hold
1363f27b1fceSJoseph Koshy	# current's root, 'usr', and 'var' directories.   A partition
1364f27b1fceSJoseph Koshy	# holding "/", "/usr" and "/var" should be about 2GB in
1365f27b1fceSJoseph Koshy	# size.
1366f27b1fceSJoseph Koshy
1367f27b1fceSJoseph Koshy	<make sure you have good level 0 dumps>
1368f27b1fceSJoseph Koshy	<boot into -stable>
1369f27b1fceSJoseph Koshy	make buildworld
13703ecf3bddSRuslan Ermilov	make buildkernel KERNCONF=YOUR_KERNEL_HERE
1371f27b1fceSJoseph Koshy	<maybe newfs current's root partition>
1372f27b1fceSJoseph Koshy	<mount current's root partition on directory ${CURRENT_ROOT}>
1373af34024aSJohn-Mark Gurney	make installworld DESTDIR=${CURRENT_ROOT} -DDB_FROM_SRC
13742d5cde04SRuslan Ermilov	make distribution DESTDIR=${CURRENT_ROOT} # if newfs'd
13753ecf3bddSRuslan Ermilov	make installkernel KERNCONF=YOUR_KERNEL_HERE DESTDIR=${CURRENT_ROOT}
1376f27b1fceSJoseph Koshy	cp /etc/fstab ${CURRENT_ROOT}/etc/fstab 		   # if newfs'd
1377f27b1fceSJoseph Koshy	<edit ${CURRENT_ROOT}/etc/fstab to mount "/" from the correct partition>
1378f27b1fceSJoseph Koshy	<reboot into current>
1379f27b1fceSJoseph Koshy	<do a "native" rebuild/install as described in the previous section>
1380737d990aSXin LI	<maybe install compatibility libraries from ports/misc/compat*>
1381f27b1fceSJoseph Koshy	<reboot>
1382f27b1fceSJoseph Koshy
1383f27b1fceSJoseph Koshy
138415974d55SGavin Atkinson	To upgrade in-place from stable to current
1385f27b1fceSJoseph Koshy	----------------------------------------------
1386f643de42SWarner Losh	<make sure you have good level 0 dumps>
138721c075eaSWarner Losh	make buildworld					[9]
1388e5dc5f61SWarner Losh	make kernel KERNCONF=YOUR_KERNEL_HERE		[8]
1389fc8c157fSWarner Losh							[1]
1390fc8c157fSWarner Losh	<reboot in single user>				[3]
139105940036SJohn-Mark Gurney	mergemaster -Fp					[5]
1392ba26da8eSWarner Losh	make installworld
139305940036SJohn-Mark Gurney	mergemaster -Fi					[4]
139494877c06SAlexander Leidinger	make delete-old					[6]
1395ba26da8eSWarner Losh	<reboot>
1396ba26da8eSWarner Losh
1397fdb9f54dSWarner Losh	Make sure that you've read the UPDATING file to understand the
1398fdb9f54dSWarner Losh	tweaks to various things you need.  At this point in the life
1399fdb9f54dSWarner Losh	cycle of current, things change often and you are on your own
1400fdb9f54dSWarner Losh	to cope.  The defaults can also change, so please read ALL of
1401fdb9f54dSWarner Losh	the UPDATING entries.
1402ba26da8eSWarner Losh
14031dece4a9SWarner Losh	Also, if you are tracking -current, you must be subscribed to
14041dece4a9SWarner Losh	freebsd-current@freebsd.org.  Make sure that before you update
14051dece4a9SWarner Losh	your sources that you have read and understood all the recent
14061dece4a9SWarner Losh	messages there.  If in doubt, please track -stable which has
14071dece4a9SWarner Losh	much fewer pitfalls.
14081dece4a9SWarner Losh
1409134d2e86SWarner Losh	[1] If you have third party modules, such as vmware, you
1410134d2e86SWarner Losh	should disable them at this point so they don't crash your
1411134d2e86SWarner Losh	system on reboot.
1412134d2e86SWarner Losh
1413ee6e1fc3SWarner Losh	[3] From the bootblocks, boot -s, and then do
1414ee6e1fc3SWarner Losh		fsck -p
1415ee6e1fc3SWarner Losh		mount -u /
1416ee6e1fc3SWarner Losh		mount -a
14176586253aSWarner Losh		cd src
141847d0d01fSWarner Losh		adjkerntz -i		# if CMOS is wall time
1419f6a0ef01SWarner Losh	Also, when doing a major release upgrade, it is required that
1420f6a0ef01SWarner Losh	you boot into single user mode to do the installworld.
1421ee6e1fc3SWarner Losh
1422a6cd4f9dSWarner Losh	[4] Note: This step is non-optional.  Failure to do this step
1423a6cd4f9dSWarner Losh	can result in a significant reduction in the functionality of the
1424a6cd4f9dSWarner Losh	system.  Attempting to do it by hand is not recommended and those
1425a6cd4f9dSWarner Losh	that pursue this avenue should read this file carefully, as well
1426a6cd4f9dSWarner Losh	as the archives of freebsd-current and freebsd-hackers mailing lists
142750e8eca6SDoug Barton	for potential gotchas.  The -U option is also useful to consider.
142850e8eca6SDoug Barton	See mergemaster(8) for more information.
1429a6cd4f9dSWarner Losh
1430835284beSWarner Losh	[5] Usually this step is a noop.  However, from time to time
1431835284beSWarner Losh	you may need to do this if you get unknown user in the following
1432835284beSWarner Losh	step.  It never hurts to do it all the time.  You may need to
1433835284beSWarner Losh	install a new mergemaster (cd src/usr.sbin/mergemaster && make
1434835284beSWarner Losh	install) after the buildworld before this step if you last updated
143520e0cc0aSBrooks Davis	from current before 20130425 or from -stable before 20130430.
1436835284beSWarner Losh
143794877c06SAlexander Leidinger	[6] This only deletes old files and directories. Old libraries
143894877c06SAlexander Leidinger	can be deleted by "make delete-old-libs", but you have to make
143994877c06SAlexander Leidinger	sure that no program is using those libraries anymore.
144094877c06SAlexander Leidinger
1441456b5dd8SWarner Losh	[8] In order to have a kernel that can run the 4.x binaries needed to
1442456b5dd8SWarner Losh	do an installworld, you must include the COMPAT_FREEBSD4 option in
1443456b5dd8SWarner Losh	your kernel.  Failure to do so may leave you with a system that is
1444456b5dd8SWarner Losh	hard to boot to recover. A similar kernel option COMPAT_FREEBSD5 is
1445456b5dd8SWarner Losh	required to run the 5.x binaries on more recent kernels.  And so on
1446456b5dd8SWarner Losh	for COMPAT_FREEBSD6 and COMPAT_FREEBSD7.
1447c74fe6afSWarner Losh
1448e5dc5f61SWarner Losh	Make sure that you merge any new devices from GENERIC since the
1449e5dc5f61SWarner Losh	last time you updated your kernel config file.
1450e5dc5f61SWarner Losh
145121c075eaSWarner Losh	[9] When checking out sources, you must include the -P flag to have
1452e5dc5f61SWarner Losh	cvs prune empty directories.
1453e5dc5f61SWarner Losh
1454e5dc5f61SWarner Losh	If CPUTYPE is defined in your /etc/make.conf, make sure to use the
1455e5dc5f61SWarner Losh	"?=" instead of the "=" assignment operator, so that buildworld can
1456e5dc5f61SWarner Losh	override the CPUTYPE if it needs to.
1457e5dc5f61SWarner Losh
1458e5dc5f61SWarner Losh	MAKEOBJDIRPREFIX must be defined in an environment variable, and
1459e5dc5f61SWarner Losh	not on the command line, or in /etc/make.conf.  buildworld will
1460e5dc5f61SWarner Losh	warn if it is improperly defined.
1461dc0dbf5cSWarner LoshFORMAT:
1462dc0dbf5cSWarner Losh
1463f699bbbbSMark OvensThis file contains a list, in reverse chronological order, of major
1464630f2154SGlen Barberbreakages in tracking -current.  It is not guaranteed to be a complete
14659c80b8aaSWarner Loshlist of such breakages, and only contains entries since September 23, 2011.
1466630f2154SGlen BarberIf you need to see UPDATING entries from before that date, you will need
1467630f2154SGlen Barberto fetch an UPDATING file from an older FreeBSD release.
14681fc1a0dcSWarner Losh
1469e72fd46aSWarner LoshCopyright information:
1470e72fd46aSWarner Losh
1471456b5dd8SWarner LoshCopyright 1998-2009 M. Warner Losh.  All Rights Reserved.
1472e72fd46aSWarner Losh
1473772730c7SWarner LoshRedistribution, publication, translation and use, with or without
1474772730c7SWarner Loshmodification, in full or in part, in any form or format of this
14759698f2c0SWarner Loshdocument are permitted without further permission from the author.
1476e72fd46aSWarner Losh
1477e72fd46aSWarner LoshTHIS DOCUMENT IS PROVIDED BY WARNER LOSH ``AS IS'' AND ANY EXPRESS OR
1478e72fd46aSWarner LoshIMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
1479e72fd46aSWarner LoshWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
1480e72fd46aSWarner LoshDISCLAIMED.  IN NO EVENT SHALL WARNER LOSH BE LIABLE FOR ANY DIRECT,
1481e72fd46aSWarner LoshINDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
1482e72fd46aSWarner Losh(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
1483e72fd46aSWarner LoshSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
1484e72fd46aSWarner LoshHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
1485e72fd46aSWarner LoshSTRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
1486e72fd46aSWarner LoshIN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
1487e72fd46aSWarner LoshPOSSIBILITY OF SUCH DAMAGE.
1488e72fd46aSWarner Losh
148922306abcSWarner LoshContact Warner Losh if you have any questions about your use of
1490772730c7SWarner Loshthis document.
1491772730c7SWarner Losh
149297d92980SPeter Wemm$FreeBSD$
1493