xref: /freebsd/UPDATING (revision ba57dad4b02b161b69122d9525807b1d2e33031b)
112f22a78SPeter Wemm Updating 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
9197b832fSGlen Barber    https://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
19b9583179SGlen BarberNOTE TO PEOPLE WHO THINK THAT FreeBSD 13.x IS SLOW:
20b9583179SGlen Barber	FreeBSD 13.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
32fca3dcdfSWarner Losh	"ln -s 'abort:false,junk:false' /etc/malloc.conf".)
335ad05815SWarner Losh
34f3d2512dSConrad Meyer20190416:
35*ba57dad4SConrad Meyer	The tunable "security.stack_protect.permit_nonrandom_cookies" may be
36*ba57dad4SConrad Meyer	set to a non-zero value to boot systems that do not provide early
37*ba57dad4SConrad Meyer	entropy.  Otherwise, such systems may see the panic message:
38*ba57dad4SConrad Meyer	"cannot initialize stack cookies because random device is not yet
39*ba57dad4SConrad Meyer	seeded."
40*ba57dad4SConrad Meyer
41*ba57dad4SConrad Meyer20190416:
42f3d2512dSConrad Meyer	The loadable random module KPI has changed; the random_infra_init()
43f3d2512dSConrad Meyer	routine now requires a 3rd function pointer for a bool (*)(void)
44f3d2512dSConrad Meyer	method that returns true if the random device is seeded (and
45f3d2512dSConrad Meyer	therefore unblocked).
46f3d2512dSConrad Meyer
47bcf55f64SRick Macklem20190404:
48bcf55f64SRick Macklem	r345895 reverts r320698. This implies that an nfsuserd(8) daemon
49bcf55f64SRick Macklem	built from head sources between r320757 (July 6, 2017) and
50bcf55f64SRick Macklem	r338192 (Aug. 22, 2018) will not work unless the "-use-udpsock"
51bcf55f64SRick Macklem	is added to the command line.
52bcf55f64SRick Macklem	nfsuserd daemons built from head sources that are post-r338192 are
53bcf55f64SRick Macklem	not affected and should continue to work.
54bcf55f64SRick Macklem
55123af6ecSAlan Somers20190320:
56123af6ecSAlan Somers	The fuse(4) module has been renamed to fusefs(4) for consistency with
57123af6ecSAlan Somers	other filesystems.  You should update any kld_load="fuse" entries in
58123af6ecSAlan Somers	/etc/rc.conf, fuse_load="YES" entries in /boot/loader.conf, and
59123af6ecSAlan Somers	"options FUSE" enties in kernel config files.
60123af6ecSAlan Somers
611791078bSDimitry Andric20190304:
620bf31f1fSDimitry Andric	Clang, llvm, lld, lldb, compiler-rt and libc++ have been upgraded to
630bf31f1fSDimitry Andric	8.0.0.  Please see the 20141231 entry below for information about
640bf31f1fSDimitry Andric	prerequisites and upgrading, if you are not already using clang 3.5.0
650bf31f1fSDimitry Andric	or higher.
660bf31f1fSDimitry Andric
67fc56fdf3SKonstantin Belousov20190226:
68fc56fdf3SKonstantin Belousov	geom_uzip(4) depends on the new module xz.  If geom_uzip is statically
69fc56fdf3SKonstantin Belousov	compiled into your custom kernel, add 'device xz' statement to the
70fc56fdf3SKonstantin Belousov	kernel config.
71fc56fdf3SKonstantin Belousov
72625bdc78SWarner Losh20190219:
73625bdc78SWarner Losh	drm and drm2 have been removed from the tree. Please see
74625bdc78SWarner Losh	https://wiki.freebsd.org/Graphics for the latest information on
75625bdc78SWarner Losh	migrating to the drm ports.
76625bdc78SWarner Losh
77c75f49f7SKonstantin Belousov20190131:
78c75f49f7SKonstantin Belousov	Iflib is no longer unconditionally compiled into the kernel.  Drivers
79c75f49f7SKonstantin Belousov	using iflib and statically compiled into the kernel, now require
80c75f49f7SKonstantin Belousov	the 'device iflib' config option.  For the same drivers loaded as
81c75f49f7SKonstantin Belousov	modules on kernels not having 'device iflib', the iflib.ko module
82c75f49f7SKonstantin Belousov	is loaded automatically.
83c75f49f7SKonstantin Belousov
845864456dSAndriy Voskoboinyk20190125:
855864456dSAndriy Voskoboinyk	The IEEE80211_AMPDU_AGE and AH_SUPPORT_AR5416 kernel configuration
865864456dSAndriy Voskoboinyk	options no longer exist since r343219 and r343427 respectively;
875864456dSAndriy Voskoboinyk	nothing uses them, so they should be just removed from custom
885864456dSAndriy Voskoboinyk	kernel config files.
895864456dSAndriy Voskoboinyk
9083a41dd0SRebecca Cran20181230:
9183a41dd0SRebecca Cran	r342635 changes the way efibootmgr(8) works by requiring users to add
9283a41dd0SRebecca Cran	the -b (bootnum) parameter for commands where the bootnum was previously
9383a41dd0SRebecca Cran	specified with each option. For example 'efibootmgr -B 0001' is now
9483a41dd0SRebecca Cran	'efibootmgr -B -b 0001'.
9583a41dd0SRebecca Cran
96d493fe42SRick Macklem20181220:
97d493fe42SRick Macklem	r342286 modifies the NFSv4 server so that it obeys vfs.nfsd.nfs_privport
98d493fe42SRick Macklem	in the same as it is applied to NFSv2 and 3.  This implies that NFSv4
99d493fe42SRick Macklem	servers that have vfs.nfsd.nfs_privport set will only allow mounts
100d493fe42SRick Macklem	from clients using a reserved port#. Since both the FreeBSD and Linux
101d493fe42SRick Macklem	NFSv4 clients use reserved port#s by default, this should not affect
102d493fe42SRick Macklem	most NFSv4 mounts.
103d493fe42SRick Macklem
104beab3c4bSWarner Losh20181219:
10531733a7dSWarner Losh	The XLP config has been removed. We can't support 64-bit atomics in this
10631733a7dSWarner Losh	kernel because it is running in 32-bit mode. XLP users must transition
10731733a7dSWarner Losh	to running a 64-bit kernel (XLP64 or XLPN32).
10831733a7dSWarner Losh
10931733a7dSWarner Losh	The mips GXEMUL support has been removed from FreeBSD. MALTA* + qemu is
11031733a7dSWarner Losh	the preferred emulator today and we don't need two different ones.
11131733a7dSWarner Losh
1120bb183edSWarner Losh	The old sibyte / swarm / Broadcom BCM1250 support has been
1130bb183edSWarner Losh	removed from the mips port.
1140bb183edSWarner Losh
11570f308d0SDimitry Andric20181211:
1162bf1d8b7SDimitry Andric	Clang, llvm, lld, lldb, compiler-rt and libc++ have been upgraded to
1172bf1d8b7SDimitry Andric	7.0.1.  Please see the 20141231 entry below for information about
1182bf1d8b7SDimitry Andric	prerequisites and upgrading, if you are not already using clang 3.5.0
1192bf1d8b7SDimitry Andric	or higher.
1202bf1d8b7SDimitry Andric
12153fc043dSGeorge V. Neville-Neil20181211:
12253fc043dSGeorge V. Neville-Neil	Remove the timed and netdate programs from the base tree.  Setting
12353fc043dSGeorge V. Neville-Neil	the time with these deamons has been obsolete for over a decade.
12453fc043dSGeorge V. Neville-Neil
125df27a97eSEd Maste20181126:
126df27a97eSEd Maste	On amd64, arm64 and armv7 (architectures that install LLVM's ld.lld
127df27a97eSEd Maste	linker as /usr/bin/ld) GNU ld is no longer installed as ld.bfd, as
128df27a97eSEd Maste	it produces broken binaries when ifuncs are in use.  Users needing
129df27a97eSEd Maste	GNU ld should install the binutils port or package.
130df27a97eSEd Maste
13130c5db2bSAndrew Turner20181123:
13230c5db2bSAndrew Turner	The BSD crtbegin and crtend code has been enabled by default. It has
13330c5db2bSAndrew Turner	had extensive testing on amd64, arm64, and i386. It can be disabled
13430c5db2bSAndrew Turner	by building a world with -DWITHOUT_BSD_CRTBEGIN.
13530c5db2bSAndrew Turner
13618946268SStefan Eßer20181115:
13718946268SStefan Eßer	The set of CTM commands (ctm, ctm_smail, ctm_rmail, ctm_dequeue)
13818946268SStefan Eßer	has been converted to a port (misc/ctm) and will be removed from
13918946268SStefan Eßer	FreeBSD-13.  It is available as a package (ctm) for all supported
14018946268SStefan Eßer	FreeBSD versions.
14118946268SStefan Eßer
1429c66c1dfSBen Woods20181110:
1439c66c1dfSBen Woods	The default newsyslog.conf(5) file has been changed to only include
1449c66c1dfSBen Woods	files in /etc/newsyslog.conf.d/ and /usr/local/etc/newsyslog.conf.d/ if
1459c66c1dfSBen Woods	the filenames end in '.conf' and do not begin with a '.'.
1469c66c1dfSBen Woods
1479c66c1dfSBen Woods	You should check the configuration files in these two directories match
1489c66c1dfSBen Woods	this naming convention. You can verify which configuration files are
1499c66c1dfSBen Woods	being included using the command:
1509c66c1dfSBen Woods		$ newsyslog -Nrv
1519c66c1dfSBen Woods
152468002c5SWarner Losh20181015:
153468002c5SWarner Losh	Ports for the DRM modules have been simplified. Now, amd64 users should
154468002c5SWarner Losh	just install the drm-kmod port. All others should install
155468002c5SWarner Losh	drm-legacy-kmod.
156468002c5SWarner Losh
157468002c5SWarner Losh	Graphics hardware that's newer than about 2010 usually works with
158468002c5SWarner Losh	drm-kmod.  For hardware older than 2013, however, some users will need
159468002c5SWarner Losh	to use drm-legacy-kmod if drm-kmod doesn't work for them. Hardware older
160468002c5SWarner Losh	than 2008 usually only works in drm-legacy-kmod. The graphics team can
161468002c5SWarner Losh	only commit to hardware made since 2013 due to the complexity of the
162468002c5SWarner Losh	market and difficulty to test all the older cards effectively. If you
163468002c5SWarner Losh	have hardware supported by drm-kmod, you are strongly encouraged to use
164468002c5SWarner Losh	that as you will get better support.
165468002c5SWarner Losh
166468002c5SWarner Losh	Other than KPI chasing, drm-legacy-kmod will not be updated. As outlined
167468002c5SWarner Losh	elsewhere, the drm and drm2 modules will be eliminated from the src base
168274cfcd7SWarner Losh	soon (with a limited exception for arm). Please update to the package
169274cfcd7SWarner Losh	asap and report any issues to x11@freebsd.org.
170468002c5SWarner Losh
171468002c5SWarner Losh	Generally, anybody using the drm*-kmod packages should add
172468002c5SWarner Losh	WITHOUT_DRM_MODULE=t and WITHOUT_DRM2_MODULE=t to avoid nasty
173468002c5SWarner Losh	cross-threading surprises, especially with automatic driver
174468002c5SWarner Losh	loading from X11 startup. These will become the defaults in 13-current
175468002c5SWarner Losh	shortly.
176468002c5SWarner Losh
177b34bb3bfSMarius Strobl20181012:
178b34bb3bfSMarius Strobl	The ixlv(4) driver has been renamed to iavf(4).  As a consequence,
179b34bb3bfSMarius Strobl	custom kernel and module loading configuration files must be updated
180b34bb3bfSMarius Strobl	accordingly.  Moreover, interfaces previous presented as ixlvN to the
181b34bb3bfSMarius Strobl	system are now exposed as iavfN and network configuration files must
182b34bb3bfSMarius Strobl	be adjusted as necessary.
183b34bb3bfSMarius Strobl
1841da7787fSGlen Barber20181009:
1851da7787fSGlen Barber	OpenSSL has been updated to version 1.1.1.  This update included
1861da7787fSGlen Barber	additional various API changes througout the base system.  It is
1871da7787fSGlen Barber	important to rebuild third-party software after upgrading.  The value
1881da7787fSGlen Barber	of __FreeBSD_version has been bumped accordingly.
1891da7787fSGlen Barber
190532dc172SKyle Evans20181006:
191532dc172SKyle Evans	The legacy DRM modules and drivers have now been added to the loader's
192532dc172SKyle Evans	module blacklist, in favor of loading them with kld_list in rc.conf(5).
193532dc172SKyle Evans	The module blacklist may be overridden with the loader.conf(5)
194532dc172SKyle Evans	'module_blacklist' variable, but loading them via rc.conf(5) is strongly
195532dc172SKyle Evans	encouraged.
196532dc172SKyle Evans
1978ac2f3baSKevin Bowling20181002:
1988ac2f3baSKevin Bowling	The cam(4) based nda(4) driver will be used over nvd(4) by default on
1998ac2f3baSKevin Bowling	powerpc64. You may set 'options NVME_USE_NVD=1' in your kernel conf or
2008ac2f3baSKevin Bowling	loader tunable 'hw.nvme.use_nvd=1' if you wish to use the existing
2018ac2f3baSKevin Bowling	driver.  Make sure to edit /boot/etc/kboot.conf and fstab to use the
2028ac2f3baSKevin Bowling	nda device name.
2038ac2f3baSKevin Bowling
2048d66f7beSEd Maste20180913:
2058d66f7beSEd Maste	Reproducible build mode is now on by default, in preparation for
2068d66f7beSEd Maste	FreeBSD 12.0.  This eliminates build metadata such as the user,
2078d66f7beSEd Maste	host, and time from the kernel (and uname), unless the working tree
2088d66f7beSEd Maste	corresponds to a modified checkout from a version control system.
2098d66f7beSEd Maste	The previous behavior can be obtained by setting the /etc/src.conf
2108d66f7beSEd Maste	knob WITHOUT_REPRODUCIBLE_BUILD.
2118d66f7beSEd Maste
21219fa89e9SMark Murray20180826:
21319fa89e9SMark Murray	The Yarrow CSPRNG has been removed from the kernel as it has not been
21419fa89e9SMark Murray	supported by its designers since at least 2003. Fortuna has been the
21519fa89e9SMark Murray	default since FreeBSD-11.
21619fa89e9SMark Murray
2170fb707ecSWarner Losh20180822:
2180fb707ecSWarner Losh	devctl freeze/thaw have gone into the tree, the rc scripts have been
21984b9dfe4SWarner Losh	updated to use them and devmatch has been changed.  You should update
22084b9dfe4SWarner Losh	kernel, userland and rc scripts all at the same time.
22184b9dfe4SWarner Losh
222f9f8ac94SKyle Evans20180818:
223f9f8ac94SKyle Evans	The default interpreter has been switched from 4th to Lua.
224f9f8ac94SKyle Evans	LOADER_DEFAULT_INTERP, documented in build(7), will override the default
225f9f8ac94SKyle Evans	interpreter.  If you have custom FORTH code you will need to set
226f9f8ac94SKyle Evans	LOADER_DEFAULT_INTERP=4th (valid values are 4th, lua or simp) in
227f9f8ac94SKyle Evans	src.conf for the build.  This will create default hard links between
228f9f8ac94SKyle Evans	loader and loader_4th instead of loader and loader_lua, the new default.
229f9f8ac94SKyle Evans	If you are using UEFI it will create the proper hard link to loader.efi.
230f9f8ac94SKyle Evans
231295506bfSWarner Losh	bhyve uses userboot.so. It remains 4th-only until some issues are solved
232295506bfSWarner Losh	regarding coexisting with multiple versions of FreeBSD are resolved.
233295506bfSWarner Losh
23472ad696aSKyle Evans20180815:
23572ad696aSKyle Evans	ls(1) now respects the COLORTERM environment variable used in other
23672ad696aSKyle Evans	systems and software to indicate that a colored terminal is both
23772ad696aSKyle Evans	supported and desired.  If ls(1) is suddenly emitting colors, they may
238e10ba800SKyle Evans	be disabled again by either removing the unwanted COLORTERM from your
239e10ba800SKyle Evans	environment, or using `ls --color=never`.  The ls(1) specific CLICOLOR
240e10ba800SKyle Evans	may not be observed in a future release.
24172ad696aSKyle Evans
24247cc9ee1SAlan Somers20180808:
24347cc9ee1SAlan Somers	The default pager for most commands has been changed to "less".  To
24447cc9ee1SAlan Somers	restore the old behavior, set PAGER="more" and MANPAGER="more -s" in
24547cc9ee1SAlan Somers	your environment.
24647cc9ee1SAlan Somers
247b5988450SRavi Pokala20180731:
248b5988450SRavi Pokala	The jedec_ts(4) driver has been removed. A superset of its functionality
249b5988450SRavi Pokala	is available in the jedec_dimm(4) driver, and the manpage for that
250b5988450SRavi Pokala	driver includes migration instructions. If you have "device jedec_ts"
251b5988450SRavi Pokala	in your kernel configuration file, it must be removed.
252b5988450SRavi Pokala
253164138e7SKyle Evans20180730:
254164138e7SKyle Evans	amd64/GENERIC now has EFI runtime services, EFIRT, enabled by default.
255dfa6eec2SKyle Evans	This should have no effect if the kernel is booted via BIOS/legacy boot.
2561ddc8a8eSKyle Evans	EFIRT may be disabled via a loader tunable, efi.rt.disabled, if a system
257164138e7SKyle Evans	has a buggy firmware that prevents a successful boot due to use of
258164138e7SKyle Evans	runtime services.
259164138e7SKyle Evans
260411e4219SWarner Losh20180727:
261411e4219SWarner Losh	Atmel AT91RM9200 and AT91SAM9, Cavium CNS 11xx and XScale
262411e4219SWarner Losh	support has been removed from the tree. These ports were
263411e4219SWarner Losh	obsolete and/or known to be broken for many years.
264411e4219SWarner Losh
265b43c6042SWarner Losh20180723:
266b43c6042SWarner Losh	loader.efi has been augmented to participate more fully in the
267663472dfSWarner Losh	UEFI boot manager protocol. loader.efi will now look at the
268663472dfSWarner Losh	BootXXXX environment variable to determine if a specific kernel
269663472dfSWarner Losh	or root partition was specified. XXXX is derived from BootCurrent.
270663472dfSWarner Losh	efibootmgr(8) manages these standard UEFI variables.
271b43c6042SWarner Losh
272d397afa3SWarner Losh20180720:
273d397afa3SWarner Losh	zfsloader's functionality has now been folded into loader.
2745f9d7aafSEd Maste	zfsloader is no longer necessary once you've updated your
2753b741022SWarner Losh	boot blocks. For a transition period, we will install a
2763b741022SWarner Losh	hardlink for zfsloader to loader to allow a smooth transition
2773b741022SWarner Losh	until the boot blocks can be updated (hard link because old
2783b741022SWarner Losh	zfs boot blocks don't understand symlinks).
279d397afa3SWarner Losh
280d0e46652SIan Lepore20180719:
281c59a544eSEmmanuel Vadot	ARM64 now have efifb support, if you want to have serial console
282c59a544eSEmmanuel Vadot	on your arm64 board when an screen is connected and the bootloader
283deb17a3bSWarner Losh	setup a framebuffer for us to use, just add :
284c59a544eSEmmanuel Vadot	boot_serial=YES
285c59a544eSEmmanuel Vadot	boot_multicons=YES
286c59a544eSEmmanuel Vadot	in /boot/loader.conf
287c59a544eSEmmanuel Vadot	For Raspberry Pi 3 (RPI) users, this is needed even if you don't have
288c59a544eSEmmanuel Vadot	an screen connected as the firmware will setup a framebuffer are that
289c59a544eSEmmanuel Vadot	u-boot will expose as an EFI framebuffer.
290c59a544eSEmmanuel Vadot
291c59a544eSEmmanuel Vadot20180719:
292d0e46652SIan Lepore	New uid:gid added, ntpd:ntpd (123:123).  Be sure to run mergemaster
293d0e46652SIan Lepore	or take steps to update /etc/passwd before doing installworld on
2940d77d170SIan Lepore	existing systems.  Do not skip the "mergemaster -Fp" step before
2950d77d170SIan Lepore	installworld, as described in the update procedures near the bottom
2960d77d170SIan Lepore	of this document.  Also, rc.d/ntpd now starts ntpd(8) as user ntpd
297d0e46652SIan Lepore	if the new mac_ntpd(4) policy is available, unless ntpd_flags or
298d0e46652SIan Lepore	the ntp config file contain options that change file/dir locations.
299d0e46652SIan Lepore	When such options (e.g., "statsdir" or "crypto") are used, ntpd can
300d0e46652SIan Lepore	still be run as non-root by setting ntpd_user=ntpd in rc.conf, after
301d0e46652SIan Lepore	taking steps to ensure that all required files/dirs are accessible
302d0e46652SIan Lepore	by the ntpd user.
303d0e46652SIan Lepore
304dbe8ed38SWarner Losh20180717:
305dbe8ed38SWarner Losh	Big endian arm support has been removed.
306dbe8ed38SWarner Losh
30744314c35SKyle Evans20180711:
30844314c35SKyle Evans	The static environment setup in kernel configs is no longer mutually
30944314c35SKyle Evans	exclusive with the loader(8) environment by default.  In order to
31044314c35SKyle Evans	restore the previous default behavior of disabling the loader(8)
31144314c35SKyle Evans	environment if a static environment is present, you must specify
31244314c35SKyle Evans	loader_env.disabled=1 in the static environment.
31344314c35SKyle Evans
314f38b68aeSBrooks Davis20180705:
315f38b68aeSBrooks Davis	The ABI of syscalls used by management tools like sockstat and
316f38b68aeSBrooks Davis	netstat has been broken to allow 32-bit binaries to work on
317f38b68aeSBrooks Davis	64-bit kernels without modification.  These programs will need
318f38b68aeSBrooks Davis	to match the kernel in order to function.  External programs may
319f38b68aeSBrooks Davis	require minor modifications to accommodate a change of type in
320f38b68aeSBrooks Davis	structures from pointers to 64-bit virtual addresses.
321f38b68aeSBrooks Davis
322f4b36404SMatt Macy20180702:
323f4b36404SMatt Macy	On i386 and amd64 atomics are now inlined. Out of tree modules using
324f4b36404SMatt Macy	atomics will need to be rebuilt.
325f4b36404SMatt Macy
3260dea6e3cSMariusz Zaborski20180701:
3270dea6e3cSMariusz Zaborski	The '%I' format in the kern.corefile sysctl limits the number of
3280dea6e3cSMariusz Zaborski	core files that a process can generate to the number stored in the
3290dea6e3cSMariusz Zaborski	debug.ncores sysctl. The '%I' format is replaced by the single digit
3300dea6e3cSMariusz Zaborski	index. Previously, if all indexes were taken the kernel would overwrite
3310dea6e3cSMariusz Zaborski	only a core file with the highest index in a filename.
3320dea6e3cSMariusz Zaborski	Currently the system will create a new core file if there is a free
3330dea6e3cSMariusz Zaborski	index or if all slots are taken it will overwrite the oldest one.
3345ad05815SWarner Losh
33555458465SDimitry Andric20180630:
33655458465SDimitry Andric	Clang, llvm, lld, lldb, compiler-rt and libc++ have been upgraded to
33755458465SDimitry Andric	6.0.1.  Please see the 20141231 entry below for information about
33855458465SDimitry Andric	prerequisites and upgrading, if you are not already using clang 3.5.0
33955458465SDimitry Andric	or higher.
34055458465SDimitry Andric
3412fd8cef4SWarner Losh20180628:
3422fd8cef4SWarner Losh	r335753 introduced a new quoting method. However, etc/devd/devmatch.conf
3432fd8cef4SWarner Losh	needed to be changed to work with it. This change was made with r335763
344274cfcd7SWarner Losh	and requires a mergemaster / etcupdate / etc to update the installed
345274cfcd7SWarner Losh	file.
3462fd8cef4SWarner Losh
347fa986e33SRick Macklem20180612:
348fa986e33SRick Macklem	r334930 changed the interface between the NFS modules, so they all
349fa986e33SRick Macklem	need to be rebuilt.  r335018 did a __FreeBSD_version bump for this.
350fa986e33SRick Macklem
3510bf7cdd5SWarner Losh20180530:
3526f282e72SEd Maste	As of r334391 lld is the default amd64 system linker; it is installed
3536f282e72SEd Maste	as /usr/bin/ld.  Kernel build workarounds (see 20180510 entry) are no
3546f282e72SEd Maste	longer necessary.
3556f282e72SEd Maste
3566f282e72SEd Maste20180530:
3570bf7cdd5SWarner Losh	The kernel / userland interface for devinfo changed, so you'll
3580bf7cdd5SWarner Losh	need a new kernel and userland as a pair for it to work (rebuilding
3590bf7cdd5SWarner Losh	lib/libdevinfo is all that's required). devinfo and devmatch will
3600bf7cdd5SWarner Losh	not work, but everything else will when there's a mismatch.
3610bf7cdd5SWarner Losh
3627e1a13f4SMatt Macy20180523:
3637e1a13f4SMatt Macy	The on-disk format for hwpmc callchain records has changed to include
3647e1a13f4SMatt Macy	threadid corresponding to a given record. This changes the field offsets
3657e1a13f4SMatt Macy	and thus requires that libpmcstat be rebuilt before using a kernel
3667e1a13f4SMatt Macy	later than r334108.
3677e1a13f4SMatt Macy
3686f78fad3SSean Bruno20180517:
3696f78fad3SSean Bruno	The vxge(4) driver has been removed.  This driver was introduced into
3706f78fad3SSean Bruno	HEAD one week before the Exar left the Ethernet market and is not
3716f78fad3SSean Bruno	known to be used.  If you have device vxge in your kernel config file
3726f78fad3SSean Bruno	it must be removed.
3736f78fad3SSean Bruno
3746e258ed3SWarner Losh20180510:
375eb8831b9SWarner Losh	The amd64 kernel now requires a ld that supports ifunc to produce a
376eb8831b9SWarner Losh	working kernel, either lld or a newer binutils. lld is built by default
377eb8831b9SWarner Losh	on amd64, and the 'buildkernel' target uses it automatically. However,
378eb8831b9SWarner Losh	it is not the default linker, so building the kernel the traditional
379eb8831b9SWarner Losh	way requires LD=ld.lld on the command line (or LD=/usr/local/bin/ld for
380eb8831b9SWarner Losh	binutils port/package). lld will soon be default, and this requirement
381eb8831b9SWarner Losh	will go away.
382eb8831b9SWarner Losh
3836f282e72SEd Maste	NOTE: As of r334391 lld is the default system linker on amd64, and no
3846f282e72SEd Maste	workaround is necessary.
3856f282e72SEd Maste
38657b49365SSean Bruno20180508:
38757b49365SSean Bruno	The nxge(4) driver has been removed.  This driver was for PCI-X 10g
38857b49365SSean Bruno	cards made by s2io/Neterion.  The company was aquired by Exar and
38957b49365SSean Bruno	no longer sells or supports Ethernet products.  If you have device
39057b49365SSean Bruno	nxge in your kernel config file it must be removed.
39157b49365SSean Bruno
392ba3833a8SPhilip Paeps20180504:
393ba3833a8SPhilip Paeps	The tz database (tzdb) has been updated to 2018e.  This version more
394ba3833a8SPhilip Paeps	correctly models time stamps in time zones with negative DST such as
395ba3833a8SPhilip Paeps	Europe/Dublin (from 1971 on), Europe/Prague (1946/7), and
396ba3833a8SPhilip Paeps	Africa/Windhoek (1994/2017).  This does not affect the UT offsets, only
397ba3833a8SPhilip Paeps	time zone abbreviations and the tm_isdst flag.
398ba3833a8SPhilip Paeps
3992695c9c1SSean Bruno20180502:
4002695c9c1SSean Bruno	The ixgb(4) driver has been removed.  This driver was for an early and
4012695c9c1SSean Bruno	uncommon legacy PCI 10GbE for a single ASIC, Intel 82597EX. Intel
4022695c9c1SSean Bruno	quickly shifted to the long lived ixgbe family.  If you have device
4032695c9c1SSean Bruno	ixgb in your kernel config file it must be removed.
4042695c9c1SSean Bruno
405e6a376d1SEd Maste20180501:
406e6a376d1SEd Maste	The lmc(4) driver has been removed.  This was a WAN interface
407e6a376d1SEd Maste	card that was already reportedly rare in 2003, and had an ambiguous
408e6a376d1SEd Maste	license.  If you have device lmc in your kernel config file it must
409e6a376d1SEd Maste	be removed.
410e6a376d1SEd Maste
4113a4fc8a8SBrooks Davis20180413:
4123a4fc8a8SBrooks Davis	Support for Arcnet networks has been removed.  If you have device
4133a4fc8a8SBrooks Davis	arcnet or device cm in your kernel config file they must be
4143a4fc8a8SBrooks Davis	removed.
4153a4fc8a8SBrooks Davis
4160437c8e3SBrooks Davis20180411:
4170437c8e3SBrooks Davis	Support for FDDI networks has been removed.  If you have device
4180437c8e3SBrooks Davis	fddi or device fpa in your kernel config file they must be
4190437c8e3SBrooks Davis	removed.
4200437c8e3SBrooks Davis
4218129693eSEd Schouten20180406:
4228129693eSEd Schouten	In addition to supporting RFC 3164 formatted messages, the
4238129693eSEd Schouten	syslogd(8) service is now capable of parsing RFC 5424 formatted
4248129693eSEd Schouten	log messages. The main benefit of using RFC 5424 is that clients
4258129693eSEd Schouten	may now send log messages with timestamps containing year numbers,
4268129693eSEd Schouten	microseconds and time zone offsets.
4278129693eSEd Schouten
4288129693eSEd Schouten	Similarly, the syslog(3) C library function has been altered to
4298129693eSEd Schouten	send RFC 5424 formatted messages to the local system logging
4308129693eSEd Schouten	daemon. On systems using syslogd(8), this change should have no
4318129693eSEd Schouten	negative impact, as long as syslogd(8) and the C library are
4328129693eSEd Schouten	updated at the same time. On systems using a different system
4338129693eSEd Schouten	logging daemon, it may be necessary to make configuration
4348129693eSEd Schouten	adjustments, depending on the software used.
4358129693eSEd Schouten
4368129693eSEd Schouten	When using syslog-ng, add the 'syslog-protocol' flag to local
4378129693eSEd Schouten	input sources to enable parsing of RFC 5424 formatted messages:
4388129693eSEd Schouten
4398129693eSEd Schouten		source src {
4408129693eSEd Schouten			unix-dgram("/var/run/log" flags(syslog-protocol));
4418129693eSEd Schouten		}
4428129693eSEd Schouten
4438129693eSEd Schouten	When using rsyslog, disable the 'SysSock.UseSpecialParser' option
4448129693eSEd Schouten	of the 'imuxsock' module to let messages be processed by the
4458129693eSEd Schouten	regular RFC 3164/5424 parsing pipeline:
4468129693eSEd Schouten
4478129693eSEd Schouten		module(load="imuxsock" SysSock.UseSpecialParser="off")
4488129693eSEd Schouten
4498129693eSEd Schouten	Do note that these changes only affect communication between local
4508129693eSEd Schouten	applications and syslogd(8). The format that syslogd(8) uses to
4518129693eSEd Schouten	store messages on disk or forward messages to other systems
4528129693eSEd Schouten	remains unchanged. syslogd(8) still uses RFC 3164 for these
4538129693eSEd Schouten	purposes. Options to customize this behaviour will be added in the
4548129693eSEd Schouten	future. Utilities that process log files stored in /var/log are
4558129693eSEd Schouten	thus expected to continue to function as before.
4568129693eSEd Schouten
4578129693eSEd Schouten	__FreeBSD_version has been incremented to 1200061 to denote this
4588129693eSEd Schouten	change.
4598129693eSEd Schouten
460c53b0251SBrooks Davis20180328:
46169f0fecbSBrooks Davis	Support for token ring networks has been removed. If you
46269f0fecbSBrooks Davis	have "device token" in your kernel config you should remove
46369f0fecbSBrooks Davis	it. No device drivers supported token ring.
46469f0fecbSBrooks Davis
46572bf324cSBenno Rice20180323:
46672bf324cSBenno Rice	makefs was modified to be able to tag ISO9660 El Torito boot catalog
46772bf324cSBenno Rice	entries as EFI instead of overloading the i386 tag as done previously.
46872bf324cSBenno Rice	The amd64 mkisoimages.sh script used to build amd64 ISO images for
46972bf324cSBenno Rice	release was updated to use this. This may mean that makefs must be
47072bf324cSBenno Rice	updated before "make cdrom" can be run in the release directory. This
47172bf324cSBenno Rice	should be as simple as:
47272bf324cSBenno Rice
47372bf324cSBenno Rice		$ cd $SRCDIR/usr.sbin/makefs
47472bf324cSBenno Rice		$ make depend all install
47572bf324cSBenno Rice
4767cafeaa1SWarner Losh20180212:
4777cafeaa1SWarner Losh	FreeBSD boot loader enhanced with Lua scripting. It's purely opt-in for
4787cafeaa1SWarner Losh	now by building WITH_LOADER_LUA and WITHOUT_FORTH in /etc/src.conf.
4797cafeaa1SWarner Losh	Co-existance for the transition period will come shortly. Booting is a
4807cafeaa1SWarner Losh	complex environment and test coverage for Lua-enabled loaders has been
4817cafeaa1SWarner Losh	thin, so it would be prudent to assume it might not work and make
4827cafeaa1SWarner Losh	provisions for backup boot methods.
4837cafeaa1SWarner Losh
484ac28ac48SWarner Losh20180211:
485ac28ac48SWarner Losh	devmatch functionality has been turned on in devd. It will automatically
486274cfcd7SWarner Losh	load drivers for unattached devices. This may cause unexpected drivers
487274cfcd7SWarner Losh	to be loaded. Please report any problems to current@ and
488274cfcd7SWarner Losh	imp@freebsd.org.
489ac28ac48SWarner Losh
490e04518a6SDimitry Andric20180114:
491e04518a6SDimitry Andric	Clang, llvm, lld, lldb, compiler-rt and libc++ have been upgraded to
492e04518a6SDimitry Andric	6.0.0.  Please see the 20141231 entry below for information about
493e04518a6SDimitry Andric	prerequisites and upgrading, if you are not already using clang 3.5.0
494e04518a6SDimitry Andric	or higher.
495e04518a6SDimitry Andric
496e92cdf4bSWarner Losh20180110:
49792593573SEd Maste	LLVM's lld linker is now used as the FreeBSD/amd64 bootstrap linker.
49892593573SEd Maste	This means it is used to link the kernel and userland libraries and
49992593573SEd Maste	executables, but is not yet installed as /usr/bin/ld by default.
50092593573SEd Maste
50192593573SEd Maste	To revert to ld.bfd as the bootstrap linker, in /etc/src.conf set
50292593573SEd Maste        WITHOUT_LLD_BOOTSTRAP=yes
50392593573SEd Maste
50492593573SEd Maste20180110:
50544c1484aSJens Schweikhardt	On i386, pmtimer has been removed. Its functionality has been folded
506274cfcd7SWarner Losh	into apm. It was a no-op on ACPI in current for a while now (but was
507274cfcd7SWarner Losh	still needed on i386 in FreeBSD 11 and earlier). Users may need to
508274cfcd7SWarner Losh	remove it from kernel config files.
509e92cdf4bSWarner Losh
510fd3bb7aaSSteven Hartland20180104:
511fd3bb7aaSSteven Hartland	The use of RSS hash from the network card aka flowid has been
512fd3bb7aaSSteven Hartland	disabled by default for lagg(4) as it's currently incompatible with
513fd3bb7aaSSteven Hartland	the lacp and loadbalance protocols.
514fd3bb7aaSSteven Hartland
515fd3bb7aaSSteven Hartland	This can be re-enabled by setting the following in loader.conf:
516fd3bb7aaSSteven Hartland	net.link.lagg.default_use_flowid="1"
517fd3bb7aaSSteven Hartland
518d07a3ed0SMike Karels20180102:
519d07a3ed0SMike Karels	The SW_WATCHDOG option is no longer necessary to enable the
520d07a3ed0SMike Karels	hardclock-based software watchdog if no hardware watchdog is
521d07a3ed0SMike Karels	configured. As before, SW_WATCHDOG will cause the software
522d07a3ed0SMike Karels	watchdog to be enabled even if a hardware watchdog is configured.
523d07a3ed0SMike Karels
5246e050ee6SWarner Losh20171215:
5256e050ee6SWarner Losh	r326887 fixes the issue described in the 20171214 UPDATING entry.
5266e050ee6SWarner Losh	r326888 flips the switch back to building GELI support always.
5276e050ee6SWarner Losh
52886375a7eSWarner Losh20171214:
52986375a7eSWarner Losh	r362593 broke ZFS + GELI support for reasons unknown. However,
53086375a7eSWarner Losh	it also broke ZFS support generally, so GELI has been turned off
531e02f5a18SJens Schweikhardt	by default as the lesser evil in r326857. If you boot off ZFS and/or
53286375a7eSWarner Losh	GELI, it might not be a good time to update.
53386375a7eSWarner Losh
53447f69f4fSNathan Whitehorn20171125:
53547f69f4fSNathan Whitehorn	PowerPC users must update loader(8) by rebuilding world before
53647f69f4fSNathan Whitehorn	installing a new kernel, as the protocol connecting them has
53747f69f4fSNathan Whitehorn	changed. Without the update, loader metadata will not be passed
53847f69f4fSNathan Whitehorn	successfully to the kernel and users will have to enter their
53947f69f4fSNathan Whitehorn	root partition at the kernel mountroot prompt to continue booting.
54047f69f4fSNathan Whitehorn	Newer versions of loader can boot old kernels without issue.
54147f69f4fSNathan Whitehorn
5428b6d515aSXin LI20171110:
543a179cd91SWarner Losh	The LOADER_FIREWIRE_SUPPORT build variable as been renamed to
5444728f534SWarner Losh	WITH/OUT_LOADER_FIREWIRE. LOADER_{NO_,}GELI_SUPPORT has been renamed
5454728f534SWarner Losh	to WITH/OUT_LOADER_GELI.
546a179cd91SWarner Losh
547da86af28SAndriy Gapon20171106:
548da86af28SAndriy Gapon	The naive and non-compliant support of posix_fallocate(2) in ZFS
549da86af28SAndriy Gapon	has been removed as of r325320.  The system call now returns EINVAL
550da86af28SAndriy Gapon	when used on a ZFS file.  Although the new behavior complies with the
551da86af28SAndriy Gapon	standard, some consumers are not prepared to cope with it.
552da86af28SAndriy Gapon	One known victim is lld prior to r325420.
553da86af28SAndriy Gapon
554615a1e70SBryan Drewery20171102:
555615a1e70SBryan Drewery	Building in a FreeBSD src checkout will automatically create object
556615a1e70SBryan Drewery	directories now rather than store files in the current directory if
55784de4b97SGordon Tetlow	'make obj' was not ran.  Calling 'make obj' is no longer necessary.
558615a1e70SBryan Drewery	This feature can be disabled by setting WITHOUT_AUTO_OBJ=yes in
559615a1e70SBryan Drewery	/etc/src-env.conf (not /etc/src.conf), or passing the option in the
560615a1e70SBryan Drewery	environment.
561615a1e70SBryan Drewery
562dfa09989SBryan Drewery20171101:
563dfa09989SBryan Drewery	The default MAKEOBJDIR has changed from /usr/obj/<srcdir> for native
564dfa09989SBryan Drewery	builds, and /usr/obj/<arch>/<srcdir> for cross-builds, to a unified
565dfa09989SBryan Drewery	/usr/obj/<srcdir>/<arch>.  This behavior can be changed to the old
566dfa09989SBryan Drewery	format by setting WITHOUT_UNIFIED_OBJDIR=yes in /etc/src-env.conf,
567dfa09989SBryan Drewery	the environment, or with -DWITHOUT_UNIFIED_OBJDIR when building.
568dfa09989SBryan Drewery	The UNIFIED_OBJDIR option is a transitional feature that will be
569dfa09989SBryan Drewery	removed for 12.0 release; please migrate to the new format for any
570dfa09989SBryan Drewery	tools by looking up the OBJDIR used by 'make -V .OBJDIR' means rather
571dfa09989SBryan Drewery	than hardcoding paths.
572dfa09989SBryan Drewery
5735bd47cc5SBryan Drewery20171028:
5745bd47cc5SBryan Drewery	The native-xtools target no longer installs the files by default to the
5755bd47cc5SBryan Drewery	OBJDIR.  Use the native-xtools-install target with a DESTDIR to install
5765bd47cc5SBryan Drewery	to ${DESTDIR}/${NXTP} where NXTP defaults to /nxb-bin.
5775bd47cc5SBryan Drewery
5780a51cbc9SWarner Losh20171021:
5790a51cbc9SWarner Losh	As part of the boot loader infrastructure cleanup, LOADER_*_SUPPORT
5800a51cbc9SWarner Losh	options are changing from controlling the build if defined / undefined
5810a51cbc9SWarner Losh	to controlling the build with explicit 'yes' or 'no' values. They will
5820a51cbc9SWarner Losh	shift to WITH/WITHOUT options to match other options in the system.
5830a51cbc9SWarner Losh
584b0bd840bSWarner Losh20171010:
585b0bd840bSWarner Losh	libstand has turned into a private library for sys/boot use only.
586b0bd840bSWarner Losh	It is no longer supported as a public interface outside of sys/boot.
587b0bd840bSWarner Losh
5881b755713SWarner Losh20171005:
5891b755713SWarner Losh	The arm port has split armv6 into armv6 and armv7. armv7 is now
59060a64746SWarner Losh	a valid TARGET_ARCH/MACHINE_ARCH setting. If you have an armv7 system
59160a64746SWarner Losh	and are running a kernel from before r324363, you will need to add
59260a64746SWarner Losh	MACHINE_ARCH=armv7 to 'make buildworld' to do a native build.
5931b755713SWarner Losh
59482ef8ce5SCy Schubert20171003:
5950c059da3SCy Schubert	When building multiple kernels using KERNCONF, non-existent KERNCONF
5960c059da3SCy Schubert	files will produce an error and buildkernel will fail. Previously
5970c059da3SCy Schubert	missing KERNCONF files silently failed giving no indication as to
5980c059da3SCy Schubert	why, only to subsequently discover during installkernel that the
5990c059da3SCy Schubert	desired kernel was never built in the first place.
6000c059da3SCy Schubert
60108d1c5b1SWarner Losh20170912:
60271cd87c6SAlan Somers	The default serial number format for CTL LUNs has changed.  This will
60371cd87c6SAlan Somers	affect users who use /dev/diskid/* device nodes, or whose FibreChannel
60471cd87c6SAlan Somers	or iSCSI clients care about their LUNs' serial numbers.  Users who
60571cd87c6SAlan Somers	require serial number stability should hardcode serial numbers in
60671cd87c6SAlan Somers	/etc/ctl.conf .
60771cd87c6SAlan Somers
60871cd87c6SAlan Somers20170912:
60908d1c5b1SWarner Losh	For 32-bit arm compiled for hard-float support, soft-floating point
61008d1c5b1SWarner Losh	binaries now always get their shared libraries from
61108d1c5b1SWarner Losh	LD_SOFT_LIBRARY_PATH (in the past, this was only used if
61208d1c5b1SWarner Losh	/usr/libsoft also existed). Only users with a hard-float ld.so, but
61308d1c5b1SWarner Losh	soft-float everything else should be affected.
61408d1c5b1SWarner Losh
6153453dc72SMariusz Zaborski20170826:
616d1797f7bSMariusz Zaborski	The geli password typed at boot is now hidden.  To restore the previous
617d1797f7bSMariusz Zaborski	behavior, see geli(8) for configuration options.
6183453dc72SMariusz Zaborski
61932a04bb8SSean Bruno20170825:
62032a04bb8SSean Bruno	Move PMTUD blackhole counters to TCPSTATS and remove them from bare
62132a04bb8SSean Bruno	sysctl values.  Minor nit, but requires a rebuild of both world/kernel
62232a04bb8SSean Bruno	to complete.
62332a04bb8SSean Bruno
624992f1a8eSEnji Cooper20170814:
625992f1a8eSEnji Cooper	"make check" behavior (made in ^/head@r295380) has been changed to
626992f1a8eSEnji Cooper	execute from a limited sandbox, as opposed to executing from
627992f1a8eSEnji Cooper	${TESTSDIR}.
628992f1a8eSEnji Cooper
629992f1a8eSEnji Cooper	Behavioral changes:
630992f1a8eSEnji Cooper	- The "beforecheck" and "aftercheck" targets are now specified.
631992f1a8eSEnji Cooper	- ${CHECKDIR} (added in commit noted above) has been removed.
632992f1a8eSEnji Cooper	- Legacy behavior can be enabled by setting
633992f1a8eSEnji Cooper	  WITHOUT_MAKE_CHECK_USE_SANDBOX in src.conf(5) or the environment.
634992f1a8eSEnji Cooper
635992f1a8eSEnji Cooper	If the limited sandbox mode is enabled, "make check" will execute
636992f1a8eSEnji Cooper	"make distribution", then install, execute the tests, and clean up the
637992f1a8eSEnji Cooper	sandbox if successful.
638992f1a8eSEnji Cooper
639992f1a8eSEnji Cooper	The "make distribution" and "make install" targets are typically run as
640992f1a8eSEnji Cooper	root to set appropriate permissions and ownership at installation time.
641992f1a8eSEnji Cooper	The end-user should set "WITH_INSTALL_AS_USER" in src.conf(5) or the
642992f1a8eSEnji Cooper	environment if executing "make check" with limited sandbox mode using
643992f1a8eSEnji Cooper	an unprivileged user.
644992f1a8eSEnji Cooper
6452f401b0aSKirk McKusick20170808:
6462f401b0aSKirk McKusick	Since the switch to GPT disk labels, fsck for UFS/FFS has been
6472f401b0aSKirk McKusick	unable to automatically find alternate superblocks. As of r322297,
6482f401b0aSKirk McKusick	the information needed to find alternate superblocks has been
6492f401b0aSKirk McKusick	moved to the end of the area reserved for the boot block.
6502f401b0aSKirk McKusick	Filesystems created with a newfs of this vintage or later
6512f401b0aSKirk McKusick	will create the recovery information. If you have a filesystem
6522f401b0aSKirk McKusick	created prior to this change and wish to have a recovery block
6532f401b0aSKirk McKusick	created for your filesystem, you can do so by running fsck in
65444c1484aSJens Schweikhardt	foreground mode (i.e., do not use the -p or -y options). As it
6552f401b0aSKirk McKusick	starts, fsck will ask ``SAVE DATA TO FIND ALTERNATE SUPERBLOCKS''
6562f401b0aSKirk McKusick	to which you should answer yes.
6572f401b0aSKirk McKusick
658d10cef38SRick Macklem20170728:
659d10cef38SRick Macklem	As of r321665, an NFSv4 server configuration that services
660d10cef38SRick Macklem	Kerberos mounts or clients that do not support the uid/gid in
661d10cef38SRick Macklem	owner/owner_group string capability, must explicitly enable
662d10cef38SRick Macklem	the nfsuserd daemon by adding nfsuserd_enable="YES" to the
663d10cef38SRick Macklem	machine's /etc/rc.conf file.
664d10cef38SRick Macklem
665726fd71dSDimitry Andric20170722:
666f849be8aSDimitry Andric	Clang, llvm, lldb, compiler-rt and libc++ have been upgraded to 5.0.0.
667f849be8aSDimitry Andric	Please see the 20141231 entry below for information about prerequisites
668f849be8aSDimitry Andric	and upgrading, if you are not already using clang 3.5.0 or higher.
669f849be8aSDimitry Andric
670cf3de641SJeremie Le Hen20170701:
671662e9863SEd Maste	WITHOUT_RCMDS is now the default. Set WITH_RCMDS if you need the
672662e9863SEd Maste	r-commands (rlogin, rsh, etc.) to be built with the base system.
673cf3de641SJeremie Le Hen
674fbcf7bcdSJustin Hibbits20170625:
675fbcf7bcdSJustin Hibbits	The FreeBSD/powerpc platform now uses a 64-bit type for time_t.  This is
676fbcf7bcdSJustin Hibbits	a very major ABI incompatible change, so users of FreeBSD/powerpc must
677fbcf7bcdSJustin Hibbits	be careful when performing source upgrades.  It is best to run
678fbcf7bcdSJustin Hibbits	'make installworld' from an alternate root system, either a live
679fbcf7bcdSJustin Hibbits	CD/memory stick, or a temporary root partition.  Additionally, all ports
680fbcf7bcdSJustin Hibbits	must be recompiled.  powerpc64 is largely unaffected, except in the case
681fbcf7bcdSJustin Hibbits	of 32-bit compatibility.  All 32-bit binaries will be affected.
682fbcf7bcdSJustin Hibbits
6839dd39fd6SWarner Losh20170623:
6845ab191c4SWarner Losh	Forward compatibility for the "ino64" project have been committed. This
6855ab191c4SWarner Losh	will allow most new binaries to run on older kernels in a limited
6865ab191c4SWarner Losh	fashion.  This prevents many of the common foot-shooting actions in the
6875ab191c4SWarner Losh	upgrade as well as the limited ability to roll back the kernel across
6885ab191c4SWarner Losh	the ino64 upgrade. Complicated use cases may not work properly, though
689a28412b0SEd Maste	enough simpler ones work to allow recovery in most situations.
6909dd39fd6SWarner Losh
6919dd39fd6SWarner Losh20170620:
6929dd39fd6SWarner Losh	Switch back to the BSDL dtc (Device Tree Compiler). Set WITH_GPL_DTC
6939dd39fd6SWarner Losh	if you require the GPL compiler.
6945ab191c4SWarner Losh
69533ecebd1SRick Macklem20170618:
69633ecebd1SRick Macklem	The internal ABI used for communication between the NFS kernel modules
69733ecebd1SRick Macklem	was changed by r320085, so __FreeBSD_version was bumped to
69833ecebd1SRick Macklem	ensure all the NFS related modules are updated together.
69933ecebd1SRick Macklem
7009a96ba16SKonstantin Belousov20170617:
7019a96ba16SKonstantin Belousov	The ABI of struct event was changed by extending the data
7029a96ba16SKonstantin Belousov	member to 64bit and adding ext fields.  For upgrade, same
7039a96ba16SKonstantin Belousov	precautions as for the entry 20170523 "ino64" must be
7049a96ba16SKonstantin Belousov	followed.
7059a96ba16SKonstantin Belousov
706472c2b48SEd Maste20170531:
707472c2b48SEd Maste	The GNU roff toolchain has been removed from base. To render manpages
708472c2b48SEd Maste	which are not supported by mandoc(1), man(1) can fallback on GNU roff
709472c2b48SEd Maste	from ports (and recommends to install it).
710472c2b48SEd Maste	To render roff(7) documents, consider using GNU roff from ports or the
711472c2b48SEd Maste	heirloom doctools roff toolchain from ports via pkg install groff or
712472c2b48SEd Maste	via pkg install heirloom-doctools.
713472c2b48SEd Maste
7149949595eSAdrian Chadd20170524:
7159949595eSAdrian Chadd	The ath(4) and ath_hal(4) modules now build piecemeal to allow for
7169949595eSAdrian Chadd	smaller runtime footprint builds.  This is useful for embedded systems
7179949595eSAdrian Chadd	which only require one chipset support.
7189949595eSAdrian Chadd
7199949595eSAdrian Chadd	If you load it as a module, make sure this is in /boot/loader.conf:
7209949595eSAdrian Chadd
7219949595eSAdrian Chadd	if_ath_load="YES"
7229949595eSAdrian Chadd
7239949595eSAdrian Chadd	This will load the HAL, all chip/RF backends and if_ath_pci.
7249949595eSAdrian Chadd	If you have if_ath_pci in /boot/loader.conf, ensure it is after
7259949595eSAdrian Chadd	if_ath or it will not load any HAL chipset support.
7269949595eSAdrian Chadd
7279949595eSAdrian Chadd	If you want to selectively load things (eg on ye cheape ARM/MIPS
7289949595eSAdrian Chadd	platforms where RAM is at a premium) you should:
7299949595eSAdrian Chadd
7309949595eSAdrian Chadd	* load ath_hal
7319949595eSAdrian Chadd	* load the chip modules in question
7329949595eSAdrian Chadd	* load ath_rate, ath_dfs
7339949595eSAdrian Chadd	* load ath_main
7349949595eSAdrian Chadd	* load if_ath_pci and/or if_ath_ahb depending upon your particular
7359949595eSAdrian Chadd	  bus bind type - this is where probe/attach is done.
7369949595eSAdrian Chadd
7379949595eSAdrian Chadd	For further comments/feedback, poke adrian@ .
7389949595eSAdrian Chadd
739b149eba4SEd Maste20170523:
740b149eba4SEd Maste	The "ino64" 64-bit inode project has been committed, which extends
741dcfffd04SEd Maste	a number of types to 64 bits.  Upgrading in place requires care and
742dcfffd04SEd Maste	adherence to the documented upgrade procedure.
743dcfffd04SEd Maste
744dcfffd04SEd Maste	If using a custom kernel configuration ensure that the
745dcfffd04SEd Maste	COMPAT_FREEBSD11 option is included (as during the upgrade the
746dcfffd04SEd Maste	system will be running the ino64 kernel with the existing world).
747dcfffd04SEd Maste
748dcfffd04SEd Maste	For the safest in-place upgrade begin by removing previous build
749359d22d4SWarner Losh	artifacts via "rm -rf /usr/obj/*".  Then, carefully follow the full
750359d22d4SWarner Losh	procedure documented below under the heading "To rebuild everything and
751359d22d4SWarner Losh	install it on the current system."  Specifically, a reboot is required
752359d22d4SWarner Losh	after installing the new kernel before installing world. While an
753359d22d4SWarner Losh	installworld normally works by accident from multiuser after rebooting
754359d22d4SWarner Losh	the proper kernel, there are many cases where this will fail across this
755359d22d4SWarner Losh	upgrade and installworld from single user is required.
756b149eba4SEd Maste
757a25a1ff4SBrooks Davis20170424:
758a25a1ff4SBrooks Davis	The NATM framework including the en(4), fatm(4), hatm(4), and
759a25a1ff4SBrooks Davis	patm(4) devices has been removed.  Consumers should plan a
760a25a1ff4SBrooks Davis	migration before the end-of-life date for FreeBSD 11.
761a25a1ff4SBrooks Davis
762a17665bcSBaptiste Daroussin20170420:
763a17665bcSBaptiste Daroussin	GNU diff has been replaced by a BSD licensed diff. Some features of GNU
764a17665bcSBaptiste Daroussin	diff has not been implemented, if those are needed a newer version of
765a17665bcSBaptiste Daroussin	GNU diff is available via the diffutils package under the gdiff name.
766a17665bcSBaptiste Daroussin
7675810e45bSCy Schubert20170413:
7685810e45bSCy Schubert	As of r316810 for ipfilter, keep frags is no longer assumed when
7695810e45bSCy Schubert	keep state is specified in a rule. r316810 aligns ipfilter with
7705810e45bSCy Schubert	documentation in man pages separating keep frags from keep state.
771a3a09aefSJens Schweikhardt	This allows keep state to be specified without forcing keep frags
7725810e45bSCy Schubert	and allows keep frags to be specified independently of keep state.
7735810e45bSCy Schubert	To maintain previous behaviour, also specify keep frags with
7740cad3ecaSCy Schubert	keep state (as documented in ipf.conf.5).
7755810e45bSCy Schubert
7761bf5e133SEd Maste20170407:
7771bf5e133SEd Maste	arm64 builds now use the base system LLD 4.0.0 linker by default,
7781bf5e133SEd Maste	instead of requiring that the aarch64-binutils port or package be
7791bf5e133SEd Maste	installed. To continue using aarch64-binutils, set
7801bf5e133SEd Maste	CROSS_BINUTILS_PREFIX=/usr/local/aarch64-freebsd/bin .
7811bf5e133SEd Maste
78228da7a25SBryan Drewery20170405:
78328da7a25SBryan Drewery	The UDP optimization in entry 20160818 that added the sysctl
78428da7a25SBryan Drewery	net.inet.udp.require_l2_bcast has been reverted.  L2 broadcast
78528da7a25SBryan Drewery	packets will no longer be treated as L3 broadcast packets.
78628da7a25SBryan Drewery
7876ebc1b7bSSteven Hartland20170331:
7884d806fc6SSteven Hartland	Binds and sends to the loopback addresses, IPv6 and IPv4, will now
7896ebc1b7bSSteven Hartland	use any explicitly assigned loopback address available in the jail
7904d806fc6SSteven Hartland	instead of using the first assigned address of the jail.
7916ebc1b7bSSteven Hartland
7920458b265SEnji Cooper20170329:
7930458b265SEnji Cooper	The ctl.ko module no longer implements the iSCSI target frontend:
7940458b265SEnji Cooper	cfiscsi.ko does instead.
7950458b265SEnji Cooper
7960458b265SEnji Cooper	If building cfiscsi.ko as a kernel module, the module can be loaded
7970458b265SEnji Cooper	via one of the following methods:
7980458b265SEnji Cooper	- `cfiscsi_load="YES"` in loader.conf(5).
7990458b265SEnji Cooper	- Add `cfiscsi` to `$kld_list` in rc.conf(5).
8000458b265SEnji Cooper	- ctladm(8)/ctld(8), when compiled with iSCSI support
8010458b265SEnji Cooper	  (`WITH_ISCSI=yes` in src.conf(5))
8020458b265SEnji Cooper
8030458b265SEnji Cooper	Please see cfiscsi(4) for more details.
8040458b265SEnji Cooper
80572dec079SMarius Strobl20170316:
80672dec079SMarius Strobl	The mmcsd.ko module now additionally depends on geom_flashmap.ko.
80772dec079SMarius Strobl	Also, mmc.ko and mmcsd.ko need to be a matching pair built from the
80872dec079SMarius Strobl	same source (previously, the dependency of mmcsd.ko on mmc.ko was
80972dec079SMarius Strobl	missing, but mmcsd.ko now will refuse to load if it is incompatible
81072dec079SMarius Strobl	with mmc.ko).
81172dec079SMarius Strobl
8126ed14738SAndrey V. Elsukov20170315:
8136ed14738SAndrey V. Elsukov	The syntax of ipfw(8) named states was changed to avoid ambiguity.
8146ed14738SAndrey V. Elsukov	If you have used named states in the firewall rules, you need to modify
8156ed14738SAndrey V. Elsukov	them after installworld and before rebooting. Now named states must
8166ed14738SAndrey V. Elsukov	be prefixed with colon.
8176ed14738SAndrey V. Elsukov
8183bbe3f67SBaptiste Daroussin20170311:
819f7c23774SEmmanuel Vadot	The old drm (sys/dev/drm/) drivers for i915 and radeon have been
820f7c23774SEmmanuel Vadot	removed as the userland we provide cannot use them. The KMS version
821a3a09aefSJens Schweikhardt	(sys/dev/drm2) supports the same hardware.
822f7c23774SEmmanuel Vadot
823e1bb2a82SDimitry Andric20170302:
824617b5f75SDimitry Andric	Clang, llvm, lldb, compiler-rt and libc++ have been upgraded to 4.0.0.
825617b5f75SDimitry Andric	Please see the 20141231 entry below for information about prerequisites
826617b5f75SDimitry Andric	and upgrading, if you are not already using clang 3.5.0 or higher.
827617b5f75SDimitry Andric
828e9a0a054SAndriy Gapon20170221:
829e9a0a054SAndriy Gapon	The code that provides support for ZFS .zfs/ directory functionality
830e9a0a054SAndriy Gapon	has been reimplemented.  It's not possible now to create a snapshot
831e9a0a054SAndriy Gapon	by mkdir under .zfs/snapshot/.  That should be the only user visible
832e9a0a054SAndriy Gapon	change.
833e9a0a054SAndriy Gapon
83418f447edSWarner Losh20170216:
83518f447edSWarner Losh	EISA bus support has been removed. The WITH_EISA option is no longer
83618f447edSWarner Losh	valid.
83718f447edSWarner Losh
83818f447edSWarner Losh20170215:
83918f447edSWarner Losh	MCA bus support has been removed.
84018f447edSWarner Losh
841f52e4bdfSEd Maste20170127:
842f52e4bdfSEd Maste	The WITH_LLD_AS_LD / WITHOUT_LLD_AS_LD build knobs have been renamed
843f52e4bdfSEd Maste	WITH_LLD_IS_LD / WITHOUT_LLD_IS_LD, for consistency with CLANG_IS_CC.
844f52e4bdfSEd Maste
845062a4b8cSSean Bruno20170112:
846062a4b8cSSean Bruno	The EM_MULTIQUEUE kernel configuration option is deprecated now that
847062a4b8cSSean Bruno	the em(4) driver conforms to iflib specifications.
848062a4b8cSSean Bruno
849f2d6ace4SSean Bruno20170109:
850f2d6ace4SSean Bruno	The igb(4), em(4) and lem(4) ethernet drivers are now implemented via
851f2d6ace4SSean Bruno	IFLIB.  If you have a custom kernel configuration that excludes em(4)
852274cfcd7SWarner Losh	but you use igb(4), you need to re-add em(4) to your custom
853274cfcd7SWarner Losh	configuration.
854f2d6ace4SSean Bruno
8554644fe91SDimitry Andric20161217:
85645bd65d6SDimitry Andric	Clang, llvm, lldb, compiler-rt and libc++ have been upgraded to 3.9.1.
85745bd65d6SDimitry Andric	Please see the 20141231 entry below for information about prerequisites
85845bd65d6SDimitry Andric	and upgrading, if you are not already using clang 3.5.0 or higher.
85945bd65d6SDimitry Andric
8607736f1a9SDimitry Andric20161124:
8617736f1a9SDimitry Andric	Clang, llvm, lldb, compiler-rt and libc++ have been upgraded to 3.9.0.
8627736f1a9SDimitry Andric	Please see the 20141231 entry below for information about prerequisites
8637736f1a9SDimitry Andric	and upgrading, if you are not already using clang 3.5.0 or higher.
8647736f1a9SDimitry Andric
8654026b447SJustin Hibbits20161119:
8664026b447SJustin Hibbits	The layout of the pmap structure has changed for powerpc to put the pmap
8674026b447SJustin Hibbits	statistics at the front for all CPU variations.  libkvm(3) and all tools
8684026b447SJustin Hibbits	that link against it need to be recompiled.
8694026b447SJustin Hibbits
870448897d3SAndriy Gapon20161030:
871448897d3SAndriy Gapon	isl(4) and cyapa(4) drivers now require a new driver,
872448897d3SAndriy Gapon	chromebook_platform(4), to work properly on Chromebook-class hardware.
873448897d3SAndriy Gapon	On other types of hardware the drivers may need to be configured using
874448897d3SAndriy Gapon	device hints.  Please see the corresponding manual pages for details.
875448897d3SAndriy Gapon
8762616dd0bSAndriy Voskoboinyk20161017:
8772616dd0bSAndriy Voskoboinyk	The urtwn(4) driver was merged into rtwn(4) and now consists of
8782616dd0bSAndriy Voskoboinyk	rtwn(4) main module + rtwn_usb(4) and rtwn_pci(4) bus-specific
8792616dd0bSAndriy Voskoboinyk	parts.
8802616dd0bSAndriy Voskoboinyk	Also, firmware for RTL8188CE was renamed due to possible name
8812616dd0bSAndriy Voskoboinyk	conflict (rtwnrtl8192cU(B) -> rtwnrtl8192cE(B))
8822616dd0bSAndriy Voskoboinyk
883a0135a1eSBaptiste Daroussin20161015:
884963d6c18SBaptiste Daroussin	GNU rcs has been removed from base.  It is available as packages:
885a0135a1eSBaptiste Daroussin	- rcs: Latest GPLv3 GNU rcs version.
88631b54b30SBaptiste Daroussin	- rcs57: Copy of the latest version of GNU rcs (GPLv2) before it was
88731b54b30SBaptiste Daroussin	removed from base.
888a0135a1eSBaptiste Daroussin
889bd79708dSJonathan T. Looney20161008:
890bd79708dSJonathan T. Looney	Use of the cc_cdg, cc_chd, cc_hd, or cc_vegas congestion control
891bd79708dSJonathan T. Looney	modules now requires that the kernel configuration contain the
892bd79708dSJonathan T. Looney	TCP_HHOOK option. (This option is included in the GENERIC kernel.)
893bd79708dSJonathan T. Looney
8949ce3c6b0SEd Maste20161003:
8959ce3c6b0SEd Maste	The WITHOUT_ELFCOPY_AS_OBJCOPY src.conf(5) knob has been retired.
8969ce3c6b0SEd Maste	ELF Tool Chain's elfcopy is always installed as /usr/bin/objcopy.
8979ce3c6b0SEd Maste
898bba95d2dSMarcel Moolenaar20160924:
899bba95d2dSMarcel Moolenaar	Relocatable object files with the extension of .So have been renamed
900bba95d2dSMarcel Moolenaar	to use an extension of .pico instead.  The purpose of this change is
901bba95d2dSMarcel Moolenaar	to avoid a name clash with shared libraries on case-insensitive file
902bba95d2dSMarcel Moolenaar	systems.  On those file systems, foo.So is the same file as foo.so.
903bba95d2dSMarcel Moolenaar
9045b71d899SBaptiste Daroussin20160918:
905f902d06cSBaptiste Daroussin	GNU rcs has been turned off by default.  It can (temporarily) be built
9060adf2bc8SBaptiste Daroussin	again by adding WITH_RCS knob in src.conf.
907452e1889SBaptiste Daroussin	Otherwise, GNU rcs is available from packages:
908452e1889SBaptiste Daroussin	- rcs: Latest GPLv3 GNU rcs version.
909452e1889SBaptiste Daroussin	- rcs57: Copy of the latest version of GNU rcs (GPLv2) from base.
9100adf2bc8SBaptiste Daroussin
9110adf2bc8SBaptiste Daroussin20160918:
9125b71d899SBaptiste Daroussin	The backup_uses_rcs functionality has been removed from rc.subr.
9135b71d899SBaptiste Daroussin
91406b93667SConrad Meyer20160908:
91506b93667SConrad Meyer	The queue(3) debugging macro, QUEUE_MACRO_DEBUG, has been split into
91606b93667SConrad Meyer	two separate components, QUEUE_MACRO_DEBUG_TRACE and
91706b93667SConrad Meyer	QUEUE_MACRO_DEBUG_TRASH.  Define both for the original
91806b93667SConrad Meyer	QUEUE_MACRO_DEBUG behavior.
91906b93667SConrad Meyer
9201c828193SNavdeep Parhar20160824:
9211c828193SNavdeep Parhar	r304787 changed some ioctl interfaces between the iSCSI userspace
9221c828193SNavdeep Parhar	programs and the kernel.  ctladm, ctld, iscsictl, and iscsid must be
9231c828193SNavdeep Parhar	rebuilt to work with new kernels.  __FreeBSD_version has been bumped
9241c828193SNavdeep Parhar	to 1200005.
9251c828193SNavdeep Parhar
9263e7e2333SGeorge V. Neville-Neil20160818:
92741029db1SRyan Stone	The UDP receive code has been updated to only treat incoming UDP
92841029db1SRyan Stone	packets that were addressed to an L2 broadcast address as L3
92941029db1SRyan Stone	broadcast packets.  It is not expected that this will affect any
93041029db1SRyan Stone	standards-conforming UDP application.  The new behaviour can be
93141029db1SRyan Stone	disabled by setting the sysctl net.inet.udp.require_l2_bcast to
93241029db1SRyan Stone	0.
93341029db1SRyan Stone
93441029db1SRyan Stone20160818:
9353e7e2333SGeorge V. Neville-Neil	Remove the openbsd_poll system call.
9363e7e2333SGeorge V. Neville-Neil	__FreeBSD_version has been bumped because of this.
9373e7e2333SGeorge V. Neville-Neil
9387bca8056SPeter Jeremy20160708:
9397bca8056SPeter Jeremy	The stable/11 branch has been created from head@r302406.
9407bca8056SPeter Jeremy
941ddc2f805SBrooks Davis20160622:
942678243ffSBrooks Davis	The libc stub for the pipe(2) system call has been replaced with
943f0db8553SBrooks Davis	a wrapper that calls the pipe2(2) system call and the pipe(2)
944f0db8553SBrooks Davis	system call is now only implemented by the kernels that include
945f0db8553SBrooks Davis	"options COMPAT_FREEBSD10" in their config file (this is the
946f0db8553SBrooks Davis	default).  Users should ensure that this option is enabled in
947f0db8553SBrooks Davis	their kernel or upgrade userspace to r302092 before upgrading their
948f0db8553SBrooks Davis	kernel.
949ddc2f805SBrooks Davis
950583febf4SAlan Somers20160527:
951583febf4SAlan Somers	CAM will now strip leading spaces from SCSI disks' serial numbers.
952fb9b2ab1SBryan Drewery	This will affect users who create UFS filesystems on SCSI disks using
953583febf4SAlan Somers	those disk's diskid device nodes.  For example, if /etc/fstab
954583febf4SAlan Somers	previously contained a line like
955583febf4SAlan Somers	"/dev/diskid/DISK-%20%20%20%20%20%20%20ABCDEFG0123456", you should
956583febf4SAlan Somers	change it to "/dev/diskid/DISK-ABCDEFG0123456".  Users of geom
957ab5d7fb1SAlan Somers	transforms like gmirror may also be affected.  ZFS users should
958583febf4SAlan Somers	generally be fine.
959583febf4SAlan Somers
9601b82e02fSAlan Somers20160523:
9611b82e02fSAlan Somers	The bitstring(3) API has been updated with new functionality and
9621b82e02fSAlan Somers	improved performance.  But it is binary-incompatible with the old API.
9631b82e02fSAlan Somers	Objects built with the new headers may not be linked against objects
9641b82e02fSAlan Somers	built with the old headers.
9651b82e02fSAlan Somers
96694098ab7SAndrew Turner20160520:
96794098ab7SAndrew Turner	The brk and sbrk functions have been removed from libc on arm64.
96894098ab7SAndrew Turner	Binutils from ports has been updated to not link to these
96994098ab7SAndrew Turner	functions and should be updated to the latest version before
97094098ab7SAndrew Turner	installing a new libc.
97194098ab7SAndrew Turner
9722c0e9e2aSWarner Losh20160517:
9732c0e9e2aSWarner Losh	The armv6 port now defaults to hard float ABI. Limited support
9742c0e9e2aSWarner Losh	for running both hardfloat and soft float on the same system
9752c0e9e2aSWarner Losh	is available using the libraries installed with -DWITH_LIBSOFT.
9762c0e9e2aSWarner Losh	This has only been tested as an upgrade path for installworld
9772c0e9e2aSWarner Losh	and packages may fail or need manual intervention to run. New
9782c0e9e2aSWarner Losh	packages will be needed.
9792c0e9e2aSWarner Losh
980957fc425SIan Lepore	To update an existing self-hosted armv6hf system, you must add
981957fc425SIan Lepore	TARGET_ARCH=armv6 on the make command line for both the build
982957fc425SIan Lepore	and the install steps.
983957fc425SIan Lepore
9845f0263c1SJohn Baldwin20160510:
9855f0263c1SJohn Baldwin	Kernel modules compiled outside of a kernel build now default to
9865f0263c1SJohn Baldwin	installing to /boot/modules instead of /boot/kernel.  Many kernel
9875f0263c1SJohn Baldwin	modules built this way (such as those in ports) already overrode
9885f0263c1SJohn Baldwin	KMODDIR explicitly to install into /boot/modules.  However,
9895f0263c1SJohn Baldwin	manually building and installing a module from /sys/modules will
9905f0263c1SJohn Baldwin	now install to /boot/modules instead of /boot/kernel.
9915f0263c1SJohn Baldwin
99213694b35SWarner Losh20160414:
993a1743365SWarner Losh	The CAM I/O scheduler has been committed to the kernel. There should be
994a1743365SWarner Losh	no user visible impact. This does enable NCQ Trim on ada SSDs. While the
995a1743365SWarner Losh	list of known rogues that claim support for this but actually corrupt
996a1743365SWarner Losh	data is believed to be complete, be on the lookout for data
997a1743365SWarner Losh	corruption. The known rogue list is believed to be complete:
998a1743365SWarner Losh
999a1743365SWarner Losh		o Crucial MX100, M550 drives with MU01 firmware.
1000a1743365SWarner Losh		o Micron M510 and M550 drives with MU01 firmware.
1001a1743365SWarner Losh		o Micron M500 prior to MU07 firmware
1002a1743365SWarner Losh		o Samsung 830, 840, and 850 all firmwares
1003a1743365SWarner Losh		o FCCT M500 all firmwares
1004a1743365SWarner Losh
1005a1743365SWarner Losh	Crucial has firmware http://www.crucial.com/usa/en/support-ssd-firmware
1006a1743365SWarner Losh	with working NCQ TRIM. For Micron branded drives, see your sales rep for
1007a1743365SWarner Losh	updated firmware. Black listed drives will work correctly because these
1008a1743365SWarner Losh	drives work correctly so long as no NCQ TRIMs are sent to them. Given
1009a1743365SWarner Losh	this list is the same as found in Linux, it's believed there are no
1010a1743365SWarner Losh	other rogues in the market place. All other models from the above
1011a1743365SWarner Losh	vendors work.
1012a1743365SWarner Losh
1013a1743365SWarner Losh	To be safe, if you are at all concerned, you can quirk each of your
1014a1743365SWarner Losh	drives to prevent NCQ from being sent by setting:
1015a1743365SWarner Losh		kern.cam.ada.X.quirks="0x2"
1016a1743365SWarner Losh	in loader.conf. If the drive requires the 4k sector quirk, set the
1017a1743365SWarner Losh	quirks entry to 0x3.
101813694b35SWarner Losh
1019497e8091SBryan Drewery20160330:
1020497e8091SBryan Drewery	The FAST_DEPEND build option has been removed and its functionality is
1021497e8091SBryan Drewery	now the one true way.  The old mkdep(1) style of 'make depend' has
1022497e8091SBryan Drewery	been removed.  See 20160311 for further details.
1023497e8091SBryan Drewery
1024da1b038aSJustin Hibbits20160317:
1025da1b038aSJustin Hibbits	Resource range types have grown from unsigned long to uintmax_t.  All
1026da1b038aSJustin Hibbits	drivers, and anything using libdevinfo, need to be recompiled.
1027da1b038aSJustin Hibbits
1028d783b170SBryan Drewery20160311:
1029d783b170SBryan Drewery	WITH_FAST_DEPEND is now enabled by default for in-tree and out-of-tree
1030d783b170SBryan Drewery	builds.  It no longer runs mkdep(1) during 'make depend', and the
1031d783b170SBryan Drewery	'make depend' stage can safely be skipped now as it is auto ran
1032d783b170SBryan Drewery	when building 'make all' and will generate all SRCS and DPSRCS before
1033d783b170SBryan Drewery	building anything else.  Dependencies are gathered at compile time with
1034d783b170SBryan Drewery	-MF flags kept in separate .depend files per object file.  Users should
1035d783b170SBryan Drewery	run 'make cleandepend' once if using -DNO_CLEAN to clean out older
1036d783b170SBryan Drewery	stale .depend files.
1037d783b170SBryan Drewery
1038c834228bSDimitry Andric20160306:
1039c834228bSDimitry Andric	On amd64, clang 3.8.0 can now insert sections of type AMD64_UNWIND into
1040c834228bSDimitry Andric	kernel modules.  Therefore, if you load any kernel modules at boot time,
1041c834228bSDimitry Andric	please install the boot loaders after you install the kernel, but before
1042c834228bSDimitry Andric	rebooting, e.g.:
1043c834228bSDimitry Andric
1044c834228bSDimitry Andric	make buildworld
1045779f392bSJohn Baldwin	make buildkernel KERNCONF=YOUR_KERNEL_HERE
1046779f392bSJohn Baldwin	make installkernel KERNCONF=YOUR_KERNEL_HERE
1047c834228bSDimitry Andric	make -C sys/boot install
1048c834228bSDimitry Andric	<reboot in single user>
1049c834228bSDimitry Andric
1050c834228bSDimitry Andric	Then follow the usual steps, described in the General Notes section,
1051c834228bSDimitry Andric	below.
1052c834228bSDimitry Andric
1053e74e149fSDimitry Andric20160305:
1054e74e149fSDimitry Andric	Clang, llvm, lldb and compiler-rt have been upgraded to 3.8.0.  Please
1055e74e149fSDimitry Andric	see the 20141231 entry below for information about prerequisites and
1056e74e149fSDimitry Andric	upgrading, if you are not already using clang 3.5.0 or higher.
1057e74e149fSDimitry Andric
10588b66d3d3SJohn Baldwin20160301:
10598b66d3d3SJohn Baldwin	The AIO subsystem is now a standard part of the kernel.  The
10608b66d3d3SJohn Baldwin	VFS_AIO kernel option and aio.ko kernel module have been removed.
10618b66d3d3SJohn Baldwin	Due to stability concerns, asynchronous I/O requests are only
10628b66d3d3SJohn Baldwin	permitted on sockets and raw disks by default.  To enable
10638b66d3d3SJohn Baldwin	asynchronous I/O requests on all file types, set the
10648b66d3d3SJohn Baldwin	vfs.aio.enable_unsafe sysctl to a non-zero value.
10658b66d3d3SJohn Baldwin
1066de463b29SEd Maste20160226:
1067ca8b902aSEd Maste	The ELF object manipulation tool objcopy is now provided by the
1068ca8b902aSEd Maste	ELF Tool Chain project rather than by GNU binutils. It should be a
1069ca8b902aSEd Maste	drop-in replacement, with the addition of arm64 support. The
1070ca8b902aSEd Maste	(temporary) src.conf knob WITHOUT_ELFCOPY_AS_OBJCOPY knob may be set
1071ca8b902aSEd Maste	to obtain the GNU version if necessary.
1072ca8b902aSEd Maste
1073d4b9233aSAlan Somers20160129:
1074d4b9233aSAlan Somers	Building ZFS pools on top of zvols is prohibited by default.  That
1075d4b9233aSAlan Somers	feature has never worked safely; it's always been prone to deadlocks.
1076d4b9233aSAlan Somers	Using a zvol as the backing store for a VM guest's virtual disk will
1077d4b9233aSAlan Somers	still work, even if the guest is using ZFS.  Legacy behavior can be
1078d4b9233aSAlan Somers	restored by setting vfs.zfs.vol.recursive=1.
1079d4b9233aSAlan Somers
108060c59fadSDag-Erling Smørgrav20160119:
108160c59fadSDag-Erling Smørgrav	The NONE and HPN patches has been removed from OpenSSH.  They are
108260c59fadSDag-Erling Smørgrav	still available in the security/openssh-portable port.
108360c59fadSDag-Erling Smørgrav
10843bf7d9a6SMarcelo Araujo20160113:
10853bf7d9a6SMarcelo Araujo	With the addition of ypldap(8), a new _ypldap user is now required
10863bf7d9a6SMarcelo Araujo	during installworld. "mergemaster -p" can be used to add the user
10873bf7d9a6SMarcelo Araujo	prior to installworld, as documented in the handbook.
10883bf7d9a6SMarcelo Araujo
10894d6ab32fSBaptiste Daroussin20151216:
10904d6ab32fSBaptiste Daroussin	The tftp loader (pxeboot) now uses the option root-path directive. As a
10914d6ab32fSBaptiste Daroussin	consequence it no longer looks for a pxeboot.4th file on the tftp
10924d6ab32fSBaptiste Daroussin	server. Instead it uses the regular /boot infrastructure as with the
10934d6ab32fSBaptiste Daroussin	other loaders.
10944d6ab32fSBaptiste Daroussin
1095ca7e5285SWarner Losh20151211:
1096ca7e5285SWarner Losh	The code to start recording plug and play data into the modules has
1097ca7e5285SWarner Losh	been committed. While the old tools will properly build a new kernel,
1098ca7e5285SWarner Losh	a number of warnings about "unknown metadata record 4" will be produced
1099ca7e5285SWarner Losh	for an older kldxref. To avoid such warnings, make sure to rebuild
1100ca7e5285SWarner Losh	the kernel toolchain (or world). Make sure that you have r292078 or
1101ca7e5285SWarner Losh	later when trying to build 292077 or later before rebuilding.
1102ca7e5285SWarner Losh
1103015dfda6SEd Maste20151207:
1104015dfda6SEd Maste	Debug data files are now built by default with 'make buildworld' and
1105015dfda6SEd Maste	installed with 'make installworld'. This facilitates debugging but
1106015dfda6SEd Maste	requires more disk space both during the build and for the installed
1107015dfda6SEd Maste	world. Debug files may be disabled by setting WITHOUT_DEBUG_FILES=yes
1108015dfda6SEd Maste	in src.conf(5).
1109015dfda6SEd Maste
111033ba1088SRick Macklem20151130:
111133ba1088SRick Macklem	r291527 changed the internal interface between the nfsd.ko and
111233ba1088SRick Macklem	nfscommon.ko modules. As such, they must both be upgraded to-gether.
111333ba1088SRick Macklem	__FreeBSD_version has been bumped because of this.
111433ba1088SRick Macklem
1115af1d74f0SBaptiste Daroussin20151108:
1116af1d74f0SBaptiste Daroussin	Add support for unicode collation strings leads to a change of
1117af1d74f0SBaptiste Daroussin	order of files listed by ls(1) for example. To get back to the old
1118af1d74f0SBaptiste Daroussin	behaviour, set LC_COLLATE environment variable to "C".
1119af1d74f0SBaptiste Daroussin
11200492a14fSBaptiste Daroussin	Databases administrators will need to reindex their databases given
11210492a14fSBaptiste Daroussin	collation results will be different.
11220492a14fSBaptiste Daroussin
112310b5202eSBaptiste Daroussin	Due to a bug in install(1) it is recommended to remove the ancient
11241300d6f1SBaptiste Daroussin	locales before running make installworld.
112501bedb0cSBaptiste Daroussin
11261300d6f1SBaptiste Daroussin	rm -rf /usr/share/locale/*
112701bedb0cSBaptiste Daroussin
11287bded2dbSJung-uk Kim20151030:
11297bded2dbSJung-uk Kim	The OpenSSL has been upgraded to 1.0.2d.  Any binaries requiring
11307bded2dbSJung-uk Kim	libcrypto.so.7 or libssl.so.7 must be recompiled.
11317bded2dbSJung-uk Kim
1132ebda5173SAlexander Motin20151020:
1133ebda5173SAlexander Motin	Qlogic 24xx/25xx firmware images were updated from 5.5.0 to 7.3.0.
1134ebda5173SAlexander Motin	Kernel modules isp_2400_multi and isp_2500_multi were removed and
1135ebda5173SAlexander Motin	should be replaced with isp_2400 and isp_2500 modules respectively.
1136ebda5173SAlexander Motin
113756585ab5SBryan Drewery20151017:
113856585ab5SBryan Drewery	The build previously allowed using 'make -n' to not recurse into
113956585ab5SBryan Drewery	sub-directories while showing what commands would be executed, and
114056585ab5SBryan Drewery	'make -n -n' to recursively show commands.  Now 'make -n' will recurse
114156585ab5SBryan Drewery	and 'make -N' will not.
114256585ab5SBryan Drewery
1143ff446b05SPeter Wemm20151012:
1144ff446b05SPeter Wemm	If you specify SENDMAIL_MC or SENDMAIL_CF in make.conf, mergemaster
1145ff446b05SPeter Wemm	and etcupdate will now use this file. A custom sendmail.cf is now
1146ff446b05SPeter Wemm	updated via this mechanism rather than via installworld.  If you had
1147ff446b05SPeter Wemm	excluded sendmail.cf in mergemaster.rc or etcupdate.conf, you may
1148ff446b05SPeter Wemm	want to remove the exclusion or change it to "always install".
1149ff446b05SPeter Wemm	/etc/mail/sendmail.cf is now managed the same way regardless of
1150ff446b05SPeter Wemm	whether SENDMAIL_MC/SENDMAIL_CF is used.  If you are not using
1151ff446b05SPeter Wemm	SENDMAIL_MC/SENDMAIL_CF there should be no change in behavior.
1152ff446b05SPeter Wemm
11534a3760baSAlexander Motin20151011:
11544a3760baSAlexander Motin	Compatibility shims for legacy ATA device names have been removed.
11554a3760baSAlexander Motin	It includes ATA_STATIC_ID kernel option, kern.cam.ada.legacy_aliases
11564a3760baSAlexander Motin	and kern.geom.raid.legacy_aliases loader tunables, kern.devalias.*
11574a3760baSAlexander Motin	environment variables, /dev/ad* and /dev/ar* symbolic links.
11584a3760baSAlexander Motin
1159d31de548SDimitry Andric20151006:
11604f01407bSDimitry Andric	Clang, llvm, lldb, compiler-rt and libc++ have been upgraded to 3.7.0.
11614f01407bSDimitry Andric	Please see the 20141231 entry below for information about prerequisites
11624f01407bSDimitry Andric	and upgrading, if you are not already using clang 3.5.0 or higher.
1163ebeff3f9SDimitry Andric
11645882166bSEd Maste20150924:
116505117b57SEd Maste	Kernel debug files have been moved to /usr/lib/debug/boot/kernel/,
116605117b57SEd Maste	and renamed from .symbols to .debug. This reduces the size requirements
116705117b57SEd Maste	on the boot partition or file system and provides consistency with
116805117b57SEd Maste	userland debug files.
116905117b57SEd Maste
117005117b57SEd Maste	When using the supported kernel installation method the
117105117b57SEd Maste	/usr/lib/debug/boot/kernel directory will be renamed (to kernel.old)
117205117b57SEd Maste	as is done with /boot/kernel.
117305117b57SEd Maste
117405117b57SEd Maste	Developers wishing to maintain the historical behavior of installing
117505117b57SEd Maste	debug files in /boot/kernel/ can set KERN_DEBUGDIR="" in src.conf(5).
117605117b57SEd Maste
117764b3b4d6SKristof Provost20150827:
11788ed69220SGleb Smirnoff	The wireless drivers had undergone changes that remove the 'parent
11798ed69220SGleb Smirnoff	interface' from the ifconfig -l output. The rc.d network scripts
11808ed69220SGleb Smirnoff	used to check presence of a parent interface in the list, so old
11818ed69220SGleb Smirnoff	scripts would fail to start wireless networking. Thus, etcupdate(3)
11828ed69220SGleb Smirnoff	or mergemaster(8) run is required after kernel update, to update your
11838ed69220SGleb Smirnoff	rc.d scripts in /etc.
11848ed69220SGleb Smirnoff
11858ed69220SGleb Smirnoff20150827:
118664b3b4d6SKristof Provost	pf no longer supports 'scrub fragment crop' or 'scrub fragment drop-ovl'
118764b3b4d6SKristof Provost	These configurations are now automatically interpreted as
118864b3b4d6SKristof Provost	'scrub fragment reassemble'.
118964b3b4d6SKristof Provost
1190646041a8SMark Murray20150817:
1191646041a8SMark Murray	Kernel-loadable modules for the random(4) device are back. To use
1192646041a8SMark Murray	them, the kernel must have
1193646041a8SMark Murray
1194646041a8SMark Murray	device	random
1195646041a8SMark Murray	options	RANDOM_LOADABLE
1196646041a8SMark Murray
1197646041a8SMark Murray	kldload(8) can then be used to load random_fortuna.ko
1198646041a8SMark Murray	or random_yarrow.ko. Please note that due to the indirect
1199646041a8SMark Murray	function calls that the loadable modules need to provide,
1200646041a8SMark Murray	the build-in variants will be slightly more efficient.
1201646041a8SMark Murray
1202646041a8SMark Murray	The random(4) kernel option RANDOM_DUMMY has been retired due to
1203646041a8SMark Murray	unpopularity. It was not all that useful anyway.
1204646041a8SMark Murray
12051bc28ffcSEd Maste20150813:
12061bc28ffcSEd Maste	The WITHOUT_ELFTOOLCHAIN_TOOLS src.conf(5) knob has been retired.
12071bc28ffcSEd Maste	Control over building the ELF Tool Chain tools is now provided by
12081bc28ffcSEd Maste	the WITHOUT_TOOLCHAIN knob.
12091bc28ffcSEd Maste
1210e7dbaf58SIan Lepore20150810:
1211e7dbaf58SIan Lepore	The polarity of Pulse Per Second (PPS) capture events with the
1212e7dbaf58SIan Lepore	uart(4) driver has been corrected.  Prior to this change the PPS
1213e7dbaf58SIan Lepore	"assert" event corresponded to the trailing edge of a positive PPS
1214e7dbaf58SIan Lepore	pulse and the "clear" event was the leading edge of the next pulse.
1215e7dbaf58SIan Lepore
1216e7dbaf58SIan Lepore	As the width of a PPS pulse in a typical GPS receiver is on the
1217e7dbaf58SIan Lepore	order of 1 millisecond, most users will not notice any significant
1218e7dbaf58SIan Lepore	difference with this change.
1219e7dbaf58SIan Lepore
1220e7dbaf58SIan Lepore	Anyone who has compensated for the historical polarity reversal by
1221e7dbaf58SIan Lepore	configuring a negative offset equal to the pulse width will need to
1222e7dbaf58SIan Lepore	remove that workaround.
1223e7dbaf58SIan Lepore
122434c7eb57SKoop Mast20150809:
122534c7eb57SKoop Mast	The default group assigned to /dev/dri entries has been changed
122634c7eb57SKoop Mast	from 'wheel' to 'video' with the id of '44'. If you want to have
122734c7eb57SKoop Mast	access to the dri devices please add yourself to the video group
122834c7eb57SKoop Mast	with:
122934c7eb57SKoop Mast
123034c7eb57SKoop Mast	# pw groupmod video -m $USER
123134c7eb57SKoop Mast
12329322ac3fSAllan Jude20150806:
12339322ac3fSAllan Jude	The menu.rc and loader.rc files will now be replaced during
12349322ac3fSAllan Jude	upgrades. Please migrate local changes to menu.rc.local and
12359322ac3fSAllan Jude	loader.rc.local instead.
12369322ac3fSAllan Jude
1237f97aa232SEd Maste20150805:
1238f97aa232SEd Maste	GNU Binutils versions of addr2line, c++filt, nm, readelf, size,
1239f97aa232SEd Maste	strings and strip have been removed. The src.conf(5) knob
1240f97aa232SEd Maste	WITHOUT_ELFTOOLCHAIN_TOOLS no longer provides the binutils tools.
1241f97aa232SEd Maste
12421635369eSSteven Hartland20150728:
124368d5f492SSteven Hartland	As ZFS requires more kernel stack pages than is the default on some
12441635369eSSteven Hartland	architectures e.g. i386, it now warns if KSTACK_PAGES is less than
12451635369eSSteven Hartland	ZFS_MIN_KSTACK_PAGES (which is 4 at the time of writing).
12461635369eSSteven Hartland
12471635369eSSteven Hartland	Please consider using 'options KSTACK_PAGES=X' where X is greater
12481635369eSSteven Hartland	than or equal to ZFS_MIN_KSTACK_PAGES i.e. 4 in such configurations.
12491635369eSSteven Hartland
1250ab1f4a42SGregory Neil Shapiro20150706:
1251ab1f4a42SGregory Neil Shapiro	sendmail has been updated to 8.15.2.  Starting with FreeBSD 11.0
1252ab1f4a42SGregory Neil Shapiro	and sendmail 8.15, sendmail uses uncompressed IPv6 addresses by
1253ab1f4a42SGregory Neil Shapiro	default, i.e., they will not contain "::".  For example, instead
1254ab1f4a42SGregory Neil Shapiro	of ::1, it will be 0:0:0:0:0:0:0:1.  This permits a zero subnet
1255ab1f4a42SGregory Neil Shapiro	to have a more specific match, such as different map entries for
1256ab1f4a42SGregory Neil Shapiro	IPv6:0:0 vs IPv6:0.  This change requires that configuration
1257ab1f4a42SGregory Neil Shapiro	data (including maps, files, classes, custom ruleset, etc.) must
1258ab1f4a42SGregory Neil Shapiro	use the same format, so make certain such configuration data is
1259ab1f4a42SGregory Neil Shapiro	upgrading.  As a very simple check search for patterns like
1260ab1f4a42SGregory Neil Shapiro	'IPv6:[0-9a-fA-F:]*::' and 'IPv6::'.  To return to the old
1261ab1f4a42SGregory Neil Shapiro	behavior, set the m4 option confUSE_COMPRESSED_IPV6_ADDRESSES or
1262ab1f4a42SGregory Neil Shapiro	the cf option UseCompressedIPv6Addresses.
1263ab1f4a42SGregory Neil Shapiro
1264d1b06863SMark Murray20150630:
1265d1b06863SMark Murray	The default kernel entropy-processing algorithm is now
1266d1b06863SMark Murray	Fortuna, replacing Yarrow.
12676f78e390SSimon J. Gerraty
1268d1b06863SMark Murray	Assuming you have 'device random' in your kernel config
1269d1b06863SMark Murray	file, the configurations allow a kernel option to override
1270d1b06863SMark Murray	this default. You may choose *ONE* of:
12716f78e390SSimon J. Gerraty
1272d1b06863SMark Murray	options	RANDOM_YARROW	# Legacy /dev/random algorithm.
1273d1b06863SMark Murray	options	RANDOM_DUMMY	# Blocking-only driver.
12746f78e390SSimon J. Gerraty
1275d1b06863SMark Murray	If you have neither, you get Fortuna.  For most people,
1276d1b06863SMark Murray	read no further, Fortuna will give a /dev/random that works
1277d1b06863SMark Murray	like it always used to, and the difference will be irrelevant.
12786f78e390SSimon J. Gerraty
1279d1b06863SMark Murray	If you remove 'device random', you get *NO* kernel-processed
128002dcb6e0SEitan Adler	entropy at all. This may be acceptable to folks building
1281d1b06863SMark Murray	embedded systems, but has complications. Carry on reading,
1282d1b06863SMark Murray	and it is assumed you know what you need.
1283d1b06863SMark Murray
1284d1b06863SMark Murray	*PLEASE* read random(4) and random(9) if you are in the
128502dcb6e0SEitan Adler	habit of tweaking kernel configs, and/or if you are a member
1286d1b06863SMark Murray	of the embedded community, wanting specific and not-usual
1287d1b06863SMark Murray	behaviour from your security subsystems.
1288d1b06863SMark Murray
1289d1b06863SMark Murray	NOTE!! If you use RANDOM_DUMMY and/or have no 'device
1290d1b06863SMark Murray	random', you will NOT have a functioning /dev/random, and
1291d1b06863SMark Murray	many cryptographic features will not work, including SSH.
1292d1b06863SMark Murray	You may also find strange behaviour from the random(3) set
1293d1b06863SMark Murray	of library functions, in particular sranddev(3), srandomdev(3)
1294d1b06863SMark Murray	and arc4random(3). The reason for this is that the KERN_ARND
1295d1b06863SMark Murray	sysctl only returns entropy if it thinks it has some to
1296d1b06863SMark Murray	share, and with RANDOM_DUMMY or no 'device random' this
1297d1b06863SMark Murray	will never happen.
1298d1b06863SMark Murray
1299e44053b7SGregory Neil Shapiro20150623:
1300e44053b7SGregory Neil Shapiro	An additional fix for the issue described in the 20150614 sendmail
130199144520SEitan Adler	entry below has been committed in revision 284717.
13026f78e390SSimon J. Gerraty
13036f78e390SSimon J. Gerraty20150616:
130432c88b52SWarner Losh	FreeBSD's old make (fmake) has been removed from the system. It is
130532c88b52SWarner Losh	available as the devel/fmake port or via pkg install fmake.
130632c88b52SWarner Losh
13079c5682edSGregory Neil Shapiro20150615:
13089c5682edSGregory Neil Shapiro	The fix for the issue described in the 20150614 sendmail entry
130999144520SEitan Adler	below has been committed in revision 284436.  The work
13109c5682edSGregory Neil Shapiro	around described in that entry is no longer needed unless the
13119c5682edSGregory Neil Shapiro	default setting is overridden by a confDH_PARAMETERS configuration
13129c5682edSGregory Neil Shapiro	setting of '5' or pointing to a 512 bit DH parameter file.
13139c5682edSGregory Neil Shapiro
131422596424SGregory Neil Shapiro20150614:
131561099d9aSEnji Cooper	ALLOW_DEPRECATED_ATF_TOOLS/ATFFILE support has been removed from
131661099d9aSEnji Cooper	atf.test.mk (included from bsd.test.mk). Please upgrade devel/atf
131761099d9aSEnji Cooper	and devel/kyua to version 0.20+ and adjust any calling code to work
131861099d9aSEnji Cooper	with Kyuafile and kyua.
131961099d9aSEnji Cooper
132061099d9aSEnji Cooper20150614:
132122596424SGregory Neil Shapiro	The import of openssl to address the FreeBSD-SA-15:10.openssl
132222596424SGregory Neil Shapiro	security advisory includes a change which rejects handshakes
132322596424SGregory Neil Shapiro	with DH parameters below 768 bits.  sendmail releases prior
132422596424SGregory Neil Shapiro	to 8.15.2 (not yet released), defaulted to a 512 bit
132522596424SGregory Neil Shapiro	DH parameter setting for client connections.  To work around
132622596424SGregory Neil Shapiro	this interoperability, sendmail can be configured to use a
132722596424SGregory Neil Shapiro	2048 bit DH parameter by:
132822596424SGregory Neil Shapiro
132922596424SGregory Neil Shapiro	1. Edit /etc/mail/`hostname`.mc
133022596424SGregory Neil Shapiro	2. If a setting for confDH_PARAMETERS does not exist or
133122596424SGregory Neil Shapiro	   exists and is set to a string beginning with '5',
133222596424SGregory Neil Shapiro	   replace it with '2'.
133322596424SGregory Neil Shapiro	3. If a setting for confDH_PARAMETERS exists and is set to
133422596424SGregory Neil Shapiro	   a file path, create a new file with:
133522596424SGregory Neil Shapiro		openssl dhparam -out /path/to/file 2048
133622596424SGregory Neil Shapiro	4. Rebuild the .cf file:
133722596424SGregory Neil Shapiro		cd /etc/mail/; make; make install
133822596424SGregory Neil Shapiro	5. Restart sendmail:
133922596424SGregory Neil Shapiro		cd /etc/mail/; make restart
134022596424SGregory Neil Shapiro
134122596424SGregory Neil Shapiro	A sendmail patch is coming, at which time this file will be
134222596424SGregory Neil Shapiro	updated.
134322596424SGregory Neil Shapiro
1344b8d08379SXin LI20150604:
1345b8d08379SXin LI	Generation of legacy formatted entries have been disabled by default
1346b8d08379SXin LI	in pwd_mkdb(8), as all base system consumers of the legacy formatted
1347b8d08379SXin LI	entries were converted to use the new format by default when the new,
1348b8d08379SXin LI	machine independent format have been added and supported since FreeBSD
1349b8d08379SXin LI	5.x.
1350b8d08379SXin LI
1351b8d08379SXin LI	Please see the pwd_mkdb(8) manual page for further details.
1352b8d08379SXin LI
1353ef6fa9e2SDimitry Andric20150525:
1354ef6fa9e2SDimitry Andric	Clang and llvm have been upgraded to 3.6.1 release.  Please see the
1355ef6fa9e2SDimitry Andric	20141231 entry below for information about prerequisites and upgrading,
1356ef6fa9e2SDimitry Andric	if you are not already using 3.5.0 or higher.
1357ef6fa9e2SDimitry Andric
13585b03aba6SOleksandr Tymoshenko20150521:
13595b03aba6SOleksandr Tymoshenko	TI platform code switched to using vendor DTS files and this update
13605b03aba6SOleksandr Tymoshenko	may break existing systems running on Beaglebone, Beaglebone Black,
13615b03aba6SOleksandr Tymoshenko	and Pandaboard:
13625b03aba6SOleksandr Tymoshenko
13635b03aba6SOleksandr Tymoshenko	- dtb files should be regenerated/reinstalled. Filenames are the
13645b03aba6SOleksandr Tymoshenko	  same but content is different now
13655b03aba6SOleksandr Tymoshenko	- GPIO addressing was changed, now each GPIO bank (32 pins per bank)
13665b03aba6SOleksandr Tymoshenko	  has its own /dev/gpiocX device, e.g. pin 121 on /dev/gpioc0 in old
13675b03aba6SOleksandr Tymoshenko	  addressing scheme is now pin 25 on /dev/gpioc3.
13685b03aba6SOleksandr Tymoshenko	- Pandaboard: /etc/ttys should be updated, serial console device is
13695b03aba6SOleksandr Tymoshenko	  now /dev/ttyu2, not /dev/ttyu0
13705b03aba6SOleksandr Tymoshenko
137121fcca66SBaptiste Daroussin20150501:
137221fcca66SBaptiste Daroussin	soelim(1) from gnu/usr.bin/groff has been replaced by usr.bin/soelim.
137321fcca66SBaptiste Daroussin	If you need the GNU extension from groff soelim(1), install groff
137421fcca66SBaptiste Daroussin	from package: pkg install groff, or via ports: textproc/groff.
137521fcca66SBaptiste Daroussin
1376eee7269fSSteven Hartland20150423:
1377ad34caceSSteven Hartland	chmod, chflags, chown and chgrp now affect symlinks in -R mode as
1378ad34caceSSteven Hartland	defined in symlink(7); previously symlinks were silently ignored.
1379ad34caceSSteven Hartland
13801243a98eSTijl Coosemans20150415:
13811243a98eSTijl Coosemans	The const qualifier has been removed from iconv(3) to comply with
13821243a98eSTijl Coosemans	POSIX.  The ports tree is aware of this from r384038 onwards.
13831243a98eSTijl Coosemans
1384757a876fSBrooks Davis20150416:
1385757a876fSBrooks Davis	Libraries specified by LIBADD in Makefiles must have a corresponding
1386757a876fSBrooks Davis	DPADD_<lib> variable to ensure correct dependencies.  This is now
1387757a876fSBrooks Davis	enforced in src.libnames.mk.
1388757a876fSBrooks Davis
1389cdc58367SAlexander Motin20150324:
1390cdc58367SAlexander Motin	From legacy ata(4) driver was removed support for SATA controllers
1391cdc58367SAlexander Motin	supported by more functional drivers ahci(4), siis(4) and mvs(4).
1392cdc58367SAlexander Motin	Kernel modules ataahci and ataadaptec were removed completely,
1393cdc58367SAlexander Motin	replaced by ahci and mvs modules respectively.
1394cdc58367SAlexander Motin
1395302cd48aSDimitry Andric20150315:
139670aad3bfSDimitry Andric	Clang, llvm and lldb have been upgraded to 3.6.0 release.  Please see
139770aad3bfSDimitry Andric	the 20141231 entry below for information about prerequisites and
139870aad3bfSDimitry Andric	upgrading, if you are not already using 3.5.0 or higher.
13996ce3ca64SDimitry Andric
14005c845fdeSNathan Whitehorn20150307:
14015c845fdeSNathan Whitehorn	The 32-bit PowerPC kernel has been changed to a position-independent
14025c845fdeSNathan Whitehorn	executable. This can only be booted with a version of loader(8)
14035c845fdeSNathan Whitehorn	newer than January 31, 2015, so make sure to update both world and
14045c845fdeSNathan Whitehorn	kernel before rebooting.
14055c845fdeSNathan Whitehorn
1406997707f4SJohn-Mark Gurney20150217:
1407997707f4SJohn-Mark Gurney	If you are running a -CURRENT kernel since r273872 (Oct 30th, 2014),
140819442b85SXin LI	but before r278950, the RNG was not seeded properly.  Immediately
140919442b85SXin LI	upgrade the kernel to r278950 or later and regenerate any keys (e.g.
1410997707f4SJohn-Mark Gurney	ssh keys or openssl keys) that were generated w/ a kernel from that
14114c25bba7SGavin Atkinson	range.  This does not affect programs that directly used /dev/random
14123a25555cSGlen Barber	or /dev/urandom.  All userland uses of arc4random(3) are affected.
1413997707f4SJohn-Mark Gurney
141409cfaa45SEdward Tomasz Napierala20150210:
141509cfaa45SEdward Tomasz Napierala	The autofs(4) ABI was changed in order to restore binary compatibility
141609cfaa45SEdward Tomasz Napierala	with 10.1-RELEASE.  The automountd(8) daemon needs to be rebuilt to work
141709cfaa45SEdward Tomasz Napierala	with the new kernel.
141809cfaa45SEdward Tomasz Napierala
14190fa22505SNathan Whitehorn20150131:
14200fa22505SNathan Whitehorn	The powerpc64 kernel has been changed to a position-independent
14210fa22505SNathan Whitehorn	executable. This can only be booted with a new version of loader(8),
14220fa22505SNathan Whitehorn	so make sure to update both world and kernel before rebooting.
14230fa22505SNathan Whitehorn
14249cac79b3SDimitry Andric20150118:
14259cac79b3SDimitry Andric	Clang and llvm have been upgraded to 3.5.1 release.  This is a bugfix
14269cac79b3SDimitry Andric	only release, no new features have been added.  Please see the 20141231
14279cac79b3SDimitry Andric	entry below for information about prerequisites and upgrading, if you
14289cac79b3SDimitry Andric	are not already using 3.5.0.
14299cac79b3SDimitry Andric
1430968d62e1SEd Maste20150107:
1431968d62e1SEd Maste	ELF tools addr2line, elfcopy (strip), nm, size, and strings are now
1432968d62e1SEd Maste	taken from the ELF Tool Chain project rather than GNU binutils. They
1433968d62e1SEd Maste	should be drop-in replacements, with the addition of arm64 support.
1434968d62e1SEd Maste	The WITHOUT_ELFTOOLCHAIN_TOOLS= knob may be used to obtain the
1435f97aa232SEd Maste	binutils tools, if necessary. See 20150805 for updated information.
1436968d62e1SEd Maste
1437f1b3840cSDag-Erling Smørgrav20150105:
1438f1b3840cSDag-Erling Smørgrav	The default Unbound configuration now enables remote control
1439f1b3840cSDag-Erling Smørgrav	using a local socket.  Users who have already enabled the
1440f1b3840cSDag-Erling Smørgrav	local_unbound service should regenerate their configuration
1441f1b3840cSDag-Erling Smørgrav	by running "service local_unbound setup" as root.
1442f1b3840cSDag-Erling Smørgrav
14432d281361SBaptiste Daroussin20150102:
14442d281361SBaptiste Daroussin	The GNU texinfo and GNU info pages have been removed.
14452d281361SBaptiste Daroussin	To be able to view GNU info pages please install texinfo from ports.
14462d281361SBaptiste Daroussin
1447143c11b4SDimitry Andric20141231:
1448143c11b4SDimitry Andric	Clang, llvm and lldb have been upgraded to 3.5.0 release.
1449143c11b4SDimitry Andric
14500ac2c3d1SDimitry Andric	As of this release, a prerequisite for building clang, llvm and lldb is
14510ac2c3d1SDimitry Andric	a C++11 capable compiler and C++11 standard library.  This means that to
1452143c11b4SDimitry Andric	be able to successfully build the cross-tools stage of buildworld, with
1453143c11b4SDimitry Andric	clang as the bootstrap compiler, your system compiler or cross compiler
1454143c11b4SDimitry Andric	should either be clang 3.3 or later, or gcc 4.8 or later, and your
1455143c11b4SDimitry Andric	system C++ library should be libc++, or libdstdc++ from gcc 4.8 or
1456143c11b4SDimitry Andric	later.
1457143c11b4SDimitry Andric
14580ac2c3d1SDimitry Andric	On any standard FreeBSD 10.x or 11.x installation, where clang and
14590ac2c3d1SDimitry Andric	libc++ are on by default (that is, on x86 or arm), this should work out
14600ac2c3d1SDimitry Andric	of the box.
1461143c11b4SDimitry Andric
1462143c11b4SDimitry Andric	On 9.x installations where clang is enabled by default, e.g. on x86 and
1463143c11b4SDimitry Andric	powerpc, libc++ will not be enabled by default, so libc++ should be
1464143c11b4SDimitry Andric	built (with clang) and installed first.  If both clang and libc++ are
1465143c11b4SDimitry Andric	missing, build clang first, then use it to build libc++.
1466143c11b4SDimitry Andric
1467143c11b4SDimitry Andric	On 8.x and earlier installations, upgrade to 9.x first, and then follow
1468143c11b4SDimitry Andric	the instructions for 9.x above.
1469143c11b4SDimitry Andric
14700ac2c3d1SDimitry Andric	Sparc64 and mips users are unaffected, as they still use gcc 4.2.1 by
14710ac2c3d1SDimitry Andric	default, and do not build clang.
14720ac2c3d1SDimitry Andric
14730ac2c3d1SDimitry Andric	Many embedded systems are resource constrained, and will not be able to
14740ac2c3d1SDimitry Andric	build clang in a reasonable time, or in some cases at all.  In those
14750ac2c3d1SDimitry Andric	cases, cross building bootable systems on amd64 is a workaround.
14760ac2c3d1SDimitry Andric
1477143c11b4SDimitry Andric	This new version of clang introduces a number of new warnings, of which
1478143c11b4SDimitry Andric	the following are most likely to appear:
1479143c11b4SDimitry Andric
1480143c11b4SDimitry Andric	-Wabsolute-value
1481143c11b4SDimitry Andric
1482143c11b4SDimitry Andric	This warns in two cases, for both C and C++:
1483143c11b4SDimitry Andric	* When the code is trying to take the absolute value of an unsigned
1484143c11b4SDimitry Andric	  quantity, which is effectively a no-op, and almost never what was
1485143c11b4SDimitry Andric	  intended.  The code should be fixed, if at all possible.  If you are
1486143c11b4SDimitry Andric	  sure that the unsigned quantity can be safely cast to signed, without
1487143c11b4SDimitry Andric	  loss of information or undefined behavior, you can add an explicit
1488143c11b4SDimitry Andric	  cast, or disable the warning.
1489143c11b4SDimitry Andric
1490143c11b4SDimitry Andric	* When the code is trying to take an absolute value, but the called
1491143c11b4SDimitry Andric	  abs() variant is for the wrong type, which can lead to truncation.
1492143c11b4SDimitry Andric	  If you want to disable the warning instead of fixing the code, please
1493143c11b4SDimitry Andric	  make sure that truncation will not occur, or it might lead to unwanted
1494143c11b4SDimitry Andric	  side-effects.
1495143c11b4SDimitry Andric
1496143c11b4SDimitry Andric	-Wtautological-undefined-compare and
1497143c11b4SDimitry Andric	-Wundefined-bool-conversion
1498143c11b4SDimitry Andric
1499143c11b4SDimitry Andric	These warn when C++ code is trying to compare 'this' against NULL, while
1500143c11b4SDimitry Andric	'this' should never be NULL in well-defined C++ code.  However, there is
1501143c11b4SDimitry Andric	some legacy (pre C++11) code out there, which actively abuses this
1502143c11b4SDimitry Andric	feature, which was less strictly defined in previous C++ versions.
1503143c11b4SDimitry Andric
1504143c11b4SDimitry Andric	Squid and openjdk do this, for example.  The warning can be turned off
1505143c11b4SDimitry Andric	for C++98 and earlier, but compiling the code in C++11 mode might result
1506143c11b4SDimitry Andric	in unexpected behavior; for example, the parts of the program that are
1507143c11b4SDimitry Andric	unreachable could be optimized away.
1508143c11b4SDimitry Andric
15090b327b63SRick Macklem20141222:
15100b327b63SRick Macklem	The old NFS client and server (kernel options NFSCLIENT, NFSSERVER)
15110b327b63SRick Macklem	kernel sources have been removed. The .h files remain, since some
15120b327b63SRick Macklem	utilities include them. This will need to be fixed later.
15130b327b63SRick Macklem	If "mount -t oldnfs ..." is attempted, it will fail.
15140b327b63SRick Macklem	If the "-o" option on mountd(8), nfsd(8) or nfsstat(1) is used,
15150b327b63SRick Macklem	the utilities will report errors.
15160b327b63SRick Macklem
15175f25ee9cSBrooks Davis20141121:
15185f25ee9cSBrooks Davis	The handling of LOCAL_LIB_DIRS has been altered to skip addition of
15195f25ee9cSBrooks Davis	directories to top level SUBDIR variable when their parent
15205f25ee9cSBrooks Davis	directory is included in LOCAL_DIRS.  Users with build systems with
15215f25ee9cSBrooks Davis	such hierarchies and without SUBDIR entries in the parent
15225f25ee9cSBrooks Davis	directory Makefiles should add them or add the directories to
15235f25ee9cSBrooks Davis	LOCAL_DIRS.
15245f25ee9cSBrooks Davis
1525603eaf79SAlexander V. Chernikov20141109:
152674342541SChristian Brueffer	faith(4) and faithd(8) have been removed from the base system. Faith
1527603eaf79SAlexander V. Chernikov	has been obsolete for a very long time.
1528603eaf79SAlexander V. Chernikov
15292d6f6d63SJean-Sébastien Pédron20141104:
15302d6f6d63SJean-Sébastien Pédron	vt(4), the new console driver, is enabled by default. It brings
15312d6f6d63SJean-Sébastien Pédron	support for Unicode and double-width characters, as well as
15322d6f6d63SJean-Sébastien Pédron	support for UEFI and integration with the KMS kernel video
15332d6f6d63SJean-Sébastien Pédron	drivers.
15342d6f6d63SJean-Sébastien Pédron
15352d6f6d63SJean-Sébastien Pédron	You may need to update your console settings in /etc/rc.conf,
15362d6f6d63SJean-Sébastien Pédron	most probably the keymap. During boot, /etc/rc.d/syscons will
15372d6f6d63SJean-Sébastien Pédron	indicate what you need to do.
15382d6f6d63SJean-Sébastien Pédron
15392d6f6d63SJean-Sébastien Pédron	vt(4) still has issues and lacks some features compared to
15402d6f6d63SJean-Sébastien Pédron	syscons(4). See the wiki for up-to-date information:
15412d6f6d63SJean-Sébastien Pédron	  https://wiki.freebsd.org/Newcons
15422d6f6d63SJean-Sébastien Pédron
15432d6f6d63SJean-Sébastien Pédron	If you want to keep using syscons(4), you can do so by adding
15442d6f6d63SJean-Sébastien Pédron	the following line to /boot/loader.conf:
15452d6f6d63SJean-Sébastien Pédron	  kern.vty=sc
15462d6f6d63SJean-Sébastien Pédron
1547fa809347SEnji Cooper20141102:
1548fa809347SEnji Cooper	pjdfstest has been integrated into kyua as an opt-in test suite.
154974342541SChristian Brueffer	Please see share/doc/pjdfstest/README for more details on how to
1550fa809347SEnji Cooper	execute it.
1551fa809347SEnji Cooper
1552ddd96d23SEd Maste20141009:
1553ddd96d23SEd Maste	gperf has been removed from the base system for architectures
1554ddd96d23SEd Maste	that use clang. Ports that require gperf will obtain it from the
1555ddd96d23SEd Maste	devel/gperf port.
1556ddd96d23SEd Maste
155740a8ac8fSEnji Cooper20140923:
155840a8ac8fSEnji Cooper	pjdfstest has been moved from tools/regression/pjdfstest to
155940a8ac8fSEnji Cooper	contrib/pjdfstest .
156040a8ac8fSEnji Cooper
1561243d6a50SSean Bruno20140922:
1562243d6a50SSean Bruno	At svn r271982, The default linux compat kernel ABI has been adjusted
1563243d6a50SSean Bruno	to 2.6.18 in support of the linux-c6 compat ports infrastructure
1564243d6a50SSean Bruno	update.  If you wish to continue using the linux-f10 compat ports,
1565243d6a50SSean Bruno	add compat.linux.osrelease=2.6.16 to your local sysctl.conf.  Users are
1566243d6a50SSean Bruno	encouraged to update their linux-compat packages to linux-c6 during
1567243d6a50SSean Bruno	their next update cycle.
1568243d6a50SSean Bruno
1569232490c6SNathan Whitehorn20140729:
1570232490c6SNathan Whitehorn	The ofwfb driver, used to provide a graphics console on PowerPC when
157174342541SChristian Brueffer	using vt(4), no longer allows mmap() of all physical memory. This
1572232490c6SNathan Whitehorn	will prevent Xorg on PowerPC with some ATI graphics cards from
1573232490c6SNathan Whitehorn	initializing properly unless x11-servers/xorg-server is updated to
1574232490c6SNathan Whitehorn	1.12.4_8 or newer.
1575232490c6SNathan Whitehorn
15760aafd404SWarner Losh20140723:
15770aafd404SWarner Losh	The xdev targets have been converted to using TARGET and
15780aafd404SWarner Losh	TARGET_ARCH instead of XDEV and XDEV_ARCH.
15790aafd404SWarner Losh
15800d0485e2SDag-Erling Smørgrav20140719:
15810d0485e2SDag-Erling Smørgrav	The default unbound configuration has been modified to address
15820d0485e2SDag-Erling Smørgrav	issues with reverse lookups on networks that use private
15830d0485e2SDag-Erling Smørgrav	address ranges.  If you use the local_unbound service, run
15840d0485e2SDag-Erling Smørgrav	"service local_unbound setup" as root to regenerate your
15850d0485e2SDag-Erling Smørgrav	configuration, then "service local_unbound reload" to load the
15860d0485e2SDag-Erling Smørgrav	new configuration.
15870d0485e2SDag-Erling Smørgrav
1588f4717209SBaptiste Daroussin20140709:
1589f4717209SBaptiste Daroussin	The GNU texinfo and GNU info pages are not built and installed
1590f4717209SBaptiste Daroussin	anymore, WITH_INFO knob has been added to allow to built and install
1591f4717209SBaptiste Daroussin	them again.
15922d281361SBaptiste Daroussin	UPDATE: see 20150102 entry on texinfo's removal
1593f4717209SBaptiste Daroussin
15948a833bdaSBaptiste Daroussin20140708:
15958a833bdaSBaptiste Daroussin	The GNU readline library is now an INTERNALLIB - that is, it is
15968a833bdaSBaptiste Daroussin	statically linked into consumers (GDB and variants) in the base
15978a833bdaSBaptiste Daroussin	system, and the shared library is no longer installed.  The
15988a833bdaSBaptiste Daroussin	devel/readline port is available for third party software that
15998a833bdaSBaptiste Daroussin	requires readline.
16008a833bdaSBaptiste Daroussin
160150f73640SMarcel Moolenaar20140702:
160250f73640SMarcel Moolenaar	The Itanium architecture (ia64) has been removed from the list of
160350f73640SMarcel Moolenaar	known architectures. This is the first step in the removal of the
160450f73640SMarcel Moolenaar	architecture.
160550f73640SMarcel Moolenaar
160618aa7fccSRick Macklem20140701:
160718aa7fccSRick Macklem	Commit r268115 has added NFSv4.1 server support, merged from
160818aa7fccSRick Macklem	projects/nfsv4.1-server.  Since this includes changes to the
160918aa7fccSRick Macklem	internal interfaces between the NFS related modules, a full
161018aa7fccSRick Macklem	build of the kernel and modules will be necessary.
161118aa7fccSRick Macklem	__FreeBSD_version has been bumped.
161218aa7fccSRick Macklem
1613824a9093SEd Maste20140629:
1614824a9093SEd Maste	The WITHOUT_VT_SUPPORT kernel config knob has been renamed
1615824a9093SEd Maste	WITHOUT_VT.  (The other _SUPPORT knobs have a consistent meaning
1616824a9093SEd Maste	which differs from the behaviour controlled by this knob.)
1617824a9093SEd Maste
161838b72f8cSAlexander Motin20140619:
161938b72f8cSAlexander Motin	Maximal length of the serial number in CTL was increased from 16 to
162038b72f8cSAlexander Motin	64 chars, that breaks ABI.  All CTL-related tools, such as ctladm
162138b72f8cSAlexander Motin	and ctld, need to be rebuilt to work with a new kernel.
162238b72f8cSAlexander Motin
1623727a7ce8SJulio Merino20140606:
1624727a7ce8SJulio Merino	The libatf-c and libatf-c++ major versions were downgraded to 0 and
1625727a7ce8SJulio Merino	1 respectively to match the upstream numbers.  They were out of
1626727a7ce8SJulio Merino	sync because, when they were originally added to FreeBSD, the
1627727a7ce8SJulio Merino	upstream versions were not respected.  These libraries are private
1628727a7ce8SJulio Merino	and not yet built by default, so renumbering them should be a
1629727a7ce8SJulio Merino	non-issue.  However, unclean source trees will yield broken test
1630727a7ce8SJulio Merino	programs once the operator executes "make delete-old-libs" after a
1631727a7ce8SJulio Merino	"make installworld".
1632727a7ce8SJulio Merino
16338c7ec47aSJulio Merino	Additionally, the atf-sh binary was made private by moving it into
16348c7ec47aSJulio Merino	/usr/libexec/.  Already-built shell test programs will keep the
16358c7ec47aSJulio Merino	path to the old binary so they will break after "make delete-old"
16368c7ec47aSJulio Merino	is run.
16378c7ec47aSJulio Merino
1638727a7ce8SJulio Merino	If you are using WITH_TESTS=yes (not the default), wipe the object
1639727a7ce8SJulio Merino	tree and rebuild from scratch to prevent spurious test failures.
16408c7ec47aSJulio Merino	This is only needed once: the misnumbered libraries and misplaced
16418c7ec47aSJulio Merino	binaries have been added to OptionalObsoleteFiles.inc so they will
16428c7ec47aSJulio Merino	be removed during a clean upgrade.
1643727a7ce8SJulio Merino
164485d60e68SDimitry Andric20140512:
164585d60e68SDimitry Andric	Clang and llvm have been upgraded to 3.4.1 release.
164685d60e68SDimitry Andric
1647fa114234SWarner Losh20140508:
1648fa114234SWarner Losh	We bogusly installed src.opts.mk in /usr/share/mk. This file should
1649fa114234SWarner Losh	be removed to avoid issues in the future (and has been added to
1650fa114234SWarner Losh	ObsoleteFiles.inc).
1651fa114234SWarner Losh
1652a46954e2SWarner Losh20140505:
1653a46954e2SWarner Losh	/etc/src.conf now affects only builds of the FreeBSD src tree. In the
1654a46954e2SWarner Losh	past, it affected all builds that used the bsd.*.mk files. The old
1655a46954e2SWarner Losh	behavior was a bug, but people may have relied upon it. To get this
1656a46954e2SWarner Losh	behavior back, you can .include /etc/src.conf from /etc/make.conf
1657a46954e2SWarner Losh	(which is still global and isn't changed). This also changes the
1658a46954e2SWarner Losh	behavior of incremental builds inside the tree of individual
165959a24370SWarner Losh	directories. Set MAKESYSPATH to ".../share/mk" to do that.
1660a46954e2SWarner Losh	Although this has survived make universe and some upgrade scenarios,
166155b76981SWarner Losh	other upgrade scenarios may have broken. At least one form of
166255b76981SWarner Losh	temporary breakage was fixed with MAKESYSPATH settings for buildworld
166359a24370SWarner Losh	as well... In cases where MAKESYSPATH isn't working with this
166459a24370SWarner Losh	setting, you'll need to set it to the full path to your tree.
1665a46954e2SWarner Losh
1666bd871f14SWarner Losh	One side effect of all this cleaning up is that bsd.compiler.mk
1667bd871f14SWarner Losh	is no longer implicitly included by bsd.own.mk. If you wish to
1668bd871f14SWarner Losh	use COMPILER_TYPE, you must now explicitly include bsd.compiler.mk
1669bd871f14SWarner Losh	as well.
1670bd871f14SWarner Losh
1671461dbce2SEitan Adler20140430:
1672461dbce2SEitan Adler	The lindev device has been removed since /dev/full has been made a
1673461dbce2SEitan Adler	standard device.  __FreeBSD_version has been bumped.
1674461dbce2SEitan Adler
1675e9aba509SEnji Cooper20140424:
1676e9aba509SEnji Cooper	The knob WITHOUT_VI was added to the base system, which controls
1677e9aba509SEnji Cooper	building ex(1), vi(1), etc. Older releases of FreeBSD required ex(1)
1678e9aba509SEnji Cooper	in order to reorder files share/termcap and didn't build ex(1) as a
1679e9aba509SEnji Cooper	build tool, so building/installing with WITH_VI is highly advised for
1680e9aba509SEnji Cooper	build hosts for older releases.
1681e9aba509SEnji Cooper
1682e9aba509SEnji Cooper	This issue has been fixed in stable/9 and stable/10 in r277022 and
1683e9aba509SEnji Cooper	r276991, respectively.
1684e9aba509SEnji Cooper
16852bb08298SWarner Losh20140418:
16862bb08298SWarner Losh	The YES_HESIOD knob has been removed. It has been obsolete for
16872bb08298SWarner Losh	a decade. Please move to using WITH_HESIOD instead or your builds
16882bb08298SWarner Losh	will silently lack HESIOD.
16892bb08298SWarner Losh
16904c710b67SMarcel Moolenaar20140405:
16914c710b67SMarcel Moolenaar	The uart(4) driver has been changed with respect to its handling
16924c710b67SMarcel Moolenaar	of the low-level console. Previously the uart(4) driver prevented
16934c710b67SMarcel Moolenaar	any process from changing the baudrate or the CLOCAL and HUPCL
16944c710b67SMarcel Moolenaar	control flags. By removing the restrictions, operators can make
16954c710b67SMarcel Moolenaar	changes to the serial console port without having to reboot.
16964c710b67SMarcel Moolenaar	However, when getty(8) is started on the serial device that is
16974c710b67SMarcel Moolenaar	associated with the low-level console, a misconfigured terminal
16984c710b67SMarcel Moolenaar	line in /etc/ttys will now have a real impact.
16994c710b67SMarcel Moolenaar	Before upgrading the kernel, make sure that /etc/ttys has the
17004c710b67SMarcel Moolenaar	serial console device configured as 3wire without baudrate to
1701086036aaSMarcel Moolenaar	preserve the previous behaviour. E.g:
17024c710b67SMarcel Moolenaar	    ttyu0  "/usr/libexec/getty 3wire"  vt100  on  secure
17034c710b67SMarcel Moolenaar
1704ea9ed3d8SAlexander Motin20140306:
1705ea9ed3d8SAlexander Motin	Support for libwrap (TCP wrappers) in rpcbind was disabled by default
1706ea9ed3d8SAlexander Motin	to improve performance.  To re-enable it, if needed, run rpcbind
1707ea9ed3d8SAlexander Motin	with command line option -W.
1708ea9ed3d8SAlexander Motin
1709a9fd2218SWarner Losh20140226:
1710a9fd2218SWarner Losh	Switched back to the GPL dtc compiler due to updates in the upstream
1711a9fd2218SWarner Losh	dts files not being supported by the BSDL dtc compiler. You will need
1712a9fd2218SWarner Losh	to rebuild your kernel toolchain to pick up the new compiler. Core dumps
1713a9fd2218SWarner Losh	may result while building dtb files during a kernel build if you fail
1714a9fd2218SWarner Losh	to do so. Set WITHOUT_GPL_DTC if you require the BSDL compiler.
1715a9fd2218SWarner Losh
17168de08345SChristian Brueffer20140216:
17173ad1a091SWarner Losh	Clang and llvm have been upgraded to 3.4 release.
17183ad1a091SWarner Losh
1719f785676fSDimitry Andric20140216:
17208de08345SChristian Brueffer	The nve(4) driver has been removed.  Please use the nfe(4) driver
17218de08345SChristian Brueffer	for NVIDIA nForce MCP Ethernet adapters instead.
17228de08345SChristian Brueffer
17239f23d19aSDimitry Andric20140212:
17249f23d19aSDimitry Andric	An ABI incompatibility crept into the libc++ 3.4 import in r261283.
17259f23d19aSDimitry Andric	This could cause certain C++ applications using shared libraries built
17269f23d19aSDimitry Andric	against the previous version of libc++ to crash.  The incompatibility
17279f23d19aSDimitry Andric	has now been fixed, but any C++ applications or shared libraries built
17289f23d19aSDimitry Andric	between r261283 and r261801 should be recompiled.
17299f23d19aSDimitry Andric
17305e4b8b0dSXin LI20140204:
17315e4b8b0dSXin LI	OpenSSH will now ignore errors caused by kernel lacking of Capsicum
17325e4b8b0dSXin LI	capability mode support.  Please note that enabling the feature in
17335e4b8b0dSXin LI	kernel is still highly recommended.
17345e4b8b0dSXin LI
17355e4b8b0dSXin LI20140131:
17365e4b8b0dSXin LI	OpenSSH is now built with sandbox support, and will use sandbox as
17375e4b8b0dSXin LI	the default privilege separation method.  This requires Capsicum
17385e4b8b0dSXin LI	capability mode support in kernel.
17395e4b8b0dSXin LI
1740d1166b82SKai Wang20140128:
17412e503d34SKai Wang	The libelf and libdwarf libraries have been updated to newer
17422e503d34SKai Wang	versions from upstream. Shared library version numbers for
17432e503d34SKai Wang	these two libraries were bumped. Any ports or binaries
17442e503d34SKai Wang	requiring these two libraries should be recompiled.
17452e503d34SKai Wang	__FreeBSD_version is bumped to 1100006.
17462e503d34SKai Wang
1747d7efee23SJulio Merino20140110:
1748d7efee23SJulio Merino	If a Makefile in a tests/ directory was auto-generating a Kyuafile
1749d7efee23SJulio Merino	instead of providing an explicit one, this would prevent such
1750d7efee23SJulio Merino	Makefile from providing its own Kyuafile in the future during
1751d7efee23SJulio Merino	NO_CLEAN builds.  This has been fixed in the Makefiles but manual
1752d7efee23SJulio Merino	intervention is needed to clean an objdir if you use NO_CLEAN:
1753d7efee23SJulio Merino	  # find /usr/obj -name Kyuafile | xargs rm -f
1754d7efee23SJulio Merino
17552773bfa9SBenjamin Kaduk20131213:
17562773bfa9SBenjamin Kaduk	The behavior of gss_pseudo_random() for the krb5 mechanism
17572773bfa9SBenjamin Kaduk	has changed, for applications requesting a longer random string
17582773bfa9SBenjamin Kaduk	than produced by the underlying enctype's pseudo-random() function.
17592773bfa9SBenjamin Kaduk	In particular, the random string produced from a session key of
17602773bfa9SBenjamin Kaduk	enctype aes256-cts-hmac-sha1-96 or aes256-cts-hmac-sha1-96 will
17612773bfa9SBenjamin Kaduk	be different at the 17th octet and later, after this change.
17622773bfa9SBenjamin Kaduk	The counter used in the PRF+ construction is now encoded as a
17632773bfa9SBenjamin Kaduk	big-endian integer in accordance with RFC 4402.
17642773bfa9SBenjamin Kaduk	__FreeBSD_version is bumped to 1100004.
17652773bfa9SBenjamin Kaduk
1766e01d128aSJulio Merino20131108:
1767e01d128aSJulio Merino	The WITHOUT_ATF build knob has been removed and its functionality
1768e01d128aSJulio Merino	has been subsumed into the more generic WITHOUT_TESTS.  If you were
1769e01d128aSJulio Merino	using the former to disable the build of the ATF libraries, you
1770e01d128aSJulio Merino	should change your settings to use the latter.
1771e01d128aSJulio Merino
1772b9cd6b0aSBrooks Davis20131025:
1773b9cd6b0aSBrooks Davis	The default version of mtree is nmtree which is obtained from
1774b9cd6b0aSBrooks Davis	NetBSD.  The output is generally the same, but may vary
1775b9cd6b0aSBrooks Davis	slightly.  If you found you need identical output adding
1776b9cd6b0aSBrooks Davis	"-F freebsd9" to the command line should do the trick.  For the
1777b9cd6b0aSBrooks Davis	time being, the old mtree is available as fmtree.
1778b9cd6b0aSBrooks Davis
1779e3ededfaSBryan Drewery20131014:
1780e3ededfaSBryan Drewery	libbsdyml has been renamed to libyaml and moved to /usr/lib/private.
1781e3ededfaSBryan Drewery	This will break ports-mgmt/pkg. Rebuild the port, or upgrade to pkg
1782e3ededfaSBryan Drewery	1.1.4_8 and verify bsdyml not linked in, before running "make
1783e3ededfaSBryan Drewery	delete-old-libs":
1784e3ededfaSBryan Drewery	  # make -C /usr/ports/ports-mgmt/pkg build deinstall install clean
1785e3ededfaSBryan Drewery	  or
1786e3ededfaSBryan Drewery	  # pkg install pkg; ldd /usr/local/sbin/pkg | grep bsdyml
1787e3ededfaSBryan Drewery
178884b354cbSHiroki Sato20131010:
17899c80b8aaSWarner Losh	The stable/10 branch has been created in subversion from head
17909c80b8aaSWarner Losh	revision r256279.
17919c80b8aaSWarner Losh
1792dc0dbf5cSWarner LoshCOMMON ITEMS:
1793dc0dbf5cSWarner Losh
1794a24eff53SWarner Losh	General Notes
1795a24eff53SWarner Losh	-------------
1796456b5dd8SWarner Losh	Avoid using make -j when upgrading.  While generally safe, there are
1797456b5dd8SWarner Losh	sometimes problems using -j to upgrade.  If your upgrade fails with
17981733d35cSRuslan Ermilov	-j, please try again without -j.  From time to time in the past there
1799456b5dd8SWarner Losh	have been problems using -j with buildworld and/or installworld.  This
1800456b5dd8SWarner Losh	is especially true when upgrading between "distant" versions (eg one
1801456b5dd8SWarner Losh	that cross a major release boundary or several minor releases, or when
1802456b5dd8SWarner Losh	several months have passed on the -current branch).
1803a24eff53SWarner Losh
18045780f3baSWarner Losh	Sometimes, obscure build problems are the result of environment
18055780f3baSWarner Losh	poisoning.  This can happen because the make utility reads its
1806456b5dd8SWarner Losh	environment when searching for values for global variables.  To run
1807456b5dd8SWarner Losh	your build attempts in an "environmental clean room", prefix all make
1808456b5dd8SWarner Losh	commands with 'env -i '.  See the env(1) manual page for more details.
18095780f3baSWarner Losh
18105ad05815SWarner Losh	When upgrading from one major version to another it is generally best to
18115ad05815SWarner Losh	upgrade to the latest code in the currently installed branch first, then
18125ad05815SWarner Losh	do an upgrade to the new branch. This is the best-tested upgrade path,
18135ad05815SWarner Losh	and has the highest probability of being successful.  Please try this
18145ad05815SWarner Losh	approach if you encounter problems with a major version upgrade.  Since
181544c1484aSJens Schweikhardt	the stable 4.x branch point, one has generally been able to upgrade from
18165ad05815SWarner Losh	anywhere in the most recent stable branch to head / current (or even the
18175ad05815SWarner Losh	last couple of stable branches). See the top of this file when there's
18185ad05815SWarner Losh	an exception.
1819081ff8acSDoug Barton
18206eeab389SWarner Losh	When upgrading a live system, having a root shell around before
1821da0e842aSWarner Losh	installing anything can help undo problems. Not having a root shell
1822da0e842aSWarner Losh	around can lead to problems if pam has changed too much from your
1823da0e842aSWarner Losh	starting point to allow continued authentication after the upgrade.
1824da0e842aSWarner Losh
18259c80b8aaSWarner Losh	This file should be read as a log of events. When a later event changes
18269c80b8aaSWarner Losh	information of a prior event, the prior event should not be deleted.
18279c80b8aaSWarner Losh	Instead, a pointer to the entry with the new information should be
18289c80b8aaSWarner Losh	placed in the old entry. Readers of this file should also sanity check
18299c80b8aaSWarner Losh	older entries before relying on them blindly. Authors of new entries
18309c80b8aaSWarner Losh	should write them with this in mind.
18319c80b8aaSWarner Losh
18328fc25799SMartin Matuska	ZFS notes
18338fc25799SMartin Matuska	---------
18348fc25799SMartin Matuska	When upgrading the boot ZFS pool to a new version, always follow
18358fc25799SMartin Matuska	these two steps:
18368fc25799SMartin Matuska
18378fc25799SMartin Matuska	1.) recompile and reinstall the ZFS boot loader and boot block
18388fc25799SMartin Matuska	(this is part of "make buildworld" and "make installworld")
18398fc25799SMartin Matuska
18408fc25799SMartin Matuska	2.) update the ZFS boot block on your boot drive
18418fc25799SMartin Matuska
18428fc25799SMartin Matuska	The following example updates the ZFS boot block on the first
184372ce7f29SAlexander Leidinger	partition (freebsd-boot) of a GPT partitioned drive ada0:
184472ce7f29SAlexander Leidinger	"gpart bootcode -p /boot/gptzfsboot -i 1 ada0"
18458fc25799SMartin Matuska
18468fc25799SMartin Matuska	Non-boot pools do not need these updates.
18478fc25799SMartin Matuska
1848dc0dbf5cSWarner Losh	To build a kernel
1849dc0dbf5cSWarner Losh	-----------------
1850ba01eb20SWarner Losh	If you are updating from a prior version of FreeBSD (even one just
18511cf0ef11SDavid E. O'Brien	a few days old), you should follow this procedure.  It is the most
18521cf0ef11SDavid E. O'Brien	failsafe as it uses a /usr/obj tree with a fresh mini-buildworld,
18531cf0ef11SDavid E. O'Brien
18541cf0ef11SDavid E. O'Brien	make kernel-toolchain
1855282e0f01SRuslan Ermilov	make -DALWAYS_CHECK_MAKE buildkernel KERNCONF=YOUR_KERNEL_HERE
1856282e0f01SRuslan Ermilov	make -DALWAYS_CHECK_MAKE installkernel KERNCONF=YOUR_KERNEL_HERE
1857dc0dbf5cSWarner Losh
18582e937dd6SAlexander Leidinger	To test a kernel once
18592e937dd6SAlexander Leidinger	---------------------
18602e937dd6SAlexander Leidinger	If you just want to boot a kernel once (because you are not sure
18612e937dd6SAlexander Leidinger	if it works, or if you want to boot a known bad kernel to provide
18622e937dd6SAlexander Leidinger	debugging information) run
18632e937dd6SAlexander Leidinger	make installkernel KERNCONF=YOUR_KERNEL_HERE KODIR=/boot/testkernel
18642e937dd6SAlexander Leidinger	nextboot -k testkernel
18652e937dd6SAlexander Leidinger
1866ba01eb20SWarner Losh	To rebuild everything and install it on the current system.
1867ba01eb20SWarner Losh	-----------------------------------------------------------
186863cb445eSWarner Losh	# Note: sometimes if you are running current you gotta do more than
186963cb445eSWarner Losh	# is listed here if you are upgrading from a really old current.
187063cb445eSWarner Losh
1871f643de42SWarner Losh	<make sure you have good level 0 dumps>
187263cb445eSWarner Losh	make buildworld
1873e5f5a852SEitan Adler	make buildkernel KERNCONF=YOUR_KERNEL_HERE
1874e5f5a852SEitan Adler	make installkernel KERNCONF=YOUR_KERNEL_HERE
187563cb445eSWarner Losh							[1]
187663cb445eSWarner Losh	<reboot in single user>				[3]
187705940036SJohn-Mark Gurney	mergemaster -Fp					[5]
187863cb445eSWarner Losh	make installworld
187905940036SJohn-Mark Gurney	mergemaster -Fi					[4]
188094877c06SAlexander Leidinger	make delete-old					[6]
188163cb445eSWarner Losh	<reboot>
188263cb445eSWarner Losh
1883f27b1fceSJoseph Koshy	To cross-install current onto a separate partition
1884f27b1fceSJoseph Koshy	--------------------------------------------------
1885f27b1fceSJoseph Koshy	# In this approach we use a separate partition to hold
1886f27b1fceSJoseph Koshy	# current's root, 'usr', and 'var' directories.   A partition
1887f27b1fceSJoseph Koshy	# holding "/", "/usr" and "/var" should be about 2GB in
1888f27b1fceSJoseph Koshy	# size.
1889f27b1fceSJoseph Koshy
1890f27b1fceSJoseph Koshy	<make sure you have good level 0 dumps>
1891f27b1fceSJoseph Koshy	<boot into -stable>
1892f27b1fceSJoseph Koshy	make buildworld
18933ecf3bddSRuslan Ermilov	make buildkernel KERNCONF=YOUR_KERNEL_HERE
1894f27b1fceSJoseph Koshy	<maybe newfs current's root partition>
1895f27b1fceSJoseph Koshy	<mount current's root partition on directory ${CURRENT_ROOT}>
1896af34024aSJohn-Mark Gurney	make installworld DESTDIR=${CURRENT_ROOT} -DDB_FROM_SRC
18972d5cde04SRuslan Ermilov	make distribution DESTDIR=${CURRENT_ROOT} # if newfs'd
18983ecf3bddSRuslan Ermilov	make installkernel KERNCONF=YOUR_KERNEL_HERE DESTDIR=${CURRENT_ROOT}
1899f27b1fceSJoseph Koshy	cp /etc/fstab ${CURRENT_ROOT}/etc/fstab 		   # if newfs'd
1900f27b1fceSJoseph Koshy	<edit ${CURRENT_ROOT}/etc/fstab to mount "/" from the correct partition>
1901f27b1fceSJoseph Koshy	<reboot into current>
1902f27b1fceSJoseph Koshy	<do a "native" rebuild/install as described in the previous section>
1903737d990aSXin LI	<maybe install compatibility libraries from ports/misc/compat*>
1904f27b1fceSJoseph Koshy	<reboot>
1905f27b1fceSJoseph Koshy
1906f27b1fceSJoseph Koshy
190715974d55SGavin Atkinson	To upgrade in-place from stable to current
1908f27b1fceSJoseph Koshy	----------------------------------------------
1909f643de42SWarner Losh	<make sure you have good level 0 dumps>
191021c075eaSWarner Losh	make buildworld					[9]
1911779f392bSJohn Baldwin	make buildkernel KERNCONF=YOUR_KERNEL_HERE	[8]
1912779f392bSJohn Baldwin	make installkernel KERNCONF=YOUR_KERNEL_HERE
1913fc8c157fSWarner Losh							[1]
1914fc8c157fSWarner Losh	<reboot in single user>				[3]
191505940036SJohn-Mark Gurney	mergemaster -Fp					[5]
1916ba26da8eSWarner Losh	make installworld
191705940036SJohn-Mark Gurney	mergemaster -Fi					[4]
191894877c06SAlexander Leidinger	make delete-old					[6]
1919ba26da8eSWarner Losh	<reboot>
1920ba26da8eSWarner Losh
1921fdb9f54dSWarner Losh	Make sure that you've read the UPDATING file to understand the
1922fdb9f54dSWarner Losh	tweaks to various things you need.  At this point in the life
1923fdb9f54dSWarner Losh	cycle of current, things change often and you are on your own
1924fdb9f54dSWarner Losh	to cope.  The defaults can also change, so please read ALL of
1925fdb9f54dSWarner Losh	the UPDATING entries.
1926ba26da8eSWarner Losh
19271dece4a9SWarner Losh	Also, if you are tracking -current, you must be subscribed to
19281dece4a9SWarner Losh	freebsd-current@freebsd.org.  Make sure that before you update
19291dece4a9SWarner Losh	your sources that you have read and understood all the recent
19301dece4a9SWarner Losh	messages there.  If in doubt, please track -stable which has
19311dece4a9SWarner Losh	much fewer pitfalls.
19321dece4a9SWarner Losh
1933134d2e86SWarner Losh	[1] If you have third party modules, such as vmware, you
1934134d2e86SWarner Losh	should disable them at this point so they don't crash your
1935134d2e86SWarner Losh	system on reboot.
1936134d2e86SWarner Losh
1937ee6e1fc3SWarner Losh	[3] From the bootblocks, boot -s, and then do
1938ee6e1fc3SWarner Losh		fsck -p
1939ee6e1fc3SWarner Losh		mount -u /
1940ee6e1fc3SWarner Losh		mount -a
19418ed2d94aSWarner Losh		sh /etc/rc.d/zfs start	# mount zfs filesystem, if needed
19428ed2d94aSWarner Losh		cd src			# full path to source
194347d0d01fSWarner Losh		adjkerntz -i		# if CMOS is wall time
1944f6a0ef01SWarner Losh	Also, when doing a major release upgrade, it is required that
1945f6a0ef01SWarner Losh	you boot into single user mode to do the installworld.
1946ee6e1fc3SWarner Losh
1947a6cd4f9dSWarner Losh	[4] Note: This step is non-optional.  Failure to do this step
1948a6cd4f9dSWarner Losh	can result in a significant reduction in the functionality of the
1949a6cd4f9dSWarner Losh	system.  Attempting to do it by hand is not recommended and those
1950a6cd4f9dSWarner Losh	that pursue this avenue should read this file carefully, as well
1951a6cd4f9dSWarner Losh	as the archives of freebsd-current and freebsd-hackers mailing lists
195250e8eca6SDoug Barton	for potential gotchas.  The -U option is also useful to consider.
195350e8eca6SDoug Barton	See mergemaster(8) for more information.
1954a6cd4f9dSWarner Losh
195544c1484aSJens Schweikhardt	[5] Usually this step is a no-op.  However, from time to time
1956835284beSWarner Losh	you may need to do this if you get unknown user in the following
1957835284beSWarner Losh	step.  It never hurts to do it all the time.  You may need to
1958835284beSWarner Losh	install a new mergemaster (cd src/usr.sbin/mergemaster && make
1959835284beSWarner Losh	install) after the buildworld before this step if you last updated
196020e0cc0aSBrooks Davis	from current before 20130425 or from -stable before 20130430.
1961835284beSWarner Losh
196294877c06SAlexander Leidinger	[6] This only deletes old files and directories. Old libraries
196394877c06SAlexander Leidinger	can be deleted by "make delete-old-libs", but you have to make
196494877c06SAlexander Leidinger	sure that no program is using those libraries anymore.
196594877c06SAlexander Leidinger
1966ed651a74SWarner Losh	[8] The new kernel must be able to run existing binaries used by an
1967ed651a74SWarner Losh	installworld.  When upgrading across major versions, the new kernel's
1968ed651a74SWarner Losh	configuration must include the correct COMPAT_FREEBSD<n> option for
1969ed651a74SWarner Losh	existing binaries (e.g. COMPAT_FREEBSD11 to run 11.x binaries).  Failure
1970ed651a74SWarner Losh	to do so may leave you with a system that is hard to boot to recover. A
1971ed651a74SWarner Losh	GENERIC kernel will include suitable compatibility options to run
1972ed651a74SWarner Losh	binaries from older branches.  Note that the ability to run binaries
1973ed651a74SWarner Losh	from unsupported branches is not guaranteed.
1974c74fe6afSWarner Losh
1975e5dc5f61SWarner Losh	Make sure that you merge any new devices from GENERIC since the
19768ed2d94aSWarner Losh	last time you updated your kernel config file. Options also
19778ed2d94aSWarner Losh	change over time, so you may need to adjust your custom kernels
19788ed2d94aSWarner Losh	for these as well.
1979e5dc5f61SWarner Losh
1980e5f5a852SEitan Adler	[9] If CPUTYPE is defined in your /etc/make.conf, make sure to use the
1981e5dc5f61SWarner Losh	"?=" instead of the "=" assignment operator, so that buildworld can
1982e5dc5f61SWarner Losh	override the CPUTYPE if it needs to.
1983e5dc5f61SWarner Losh
1984e5dc5f61SWarner Losh	MAKEOBJDIRPREFIX must be defined in an environment variable, and
1985e5dc5f61SWarner Losh	not on the command line, or in /etc/make.conf.  buildworld will
1986e5dc5f61SWarner Losh	warn if it is improperly defined.
1987dc0dbf5cSWarner LoshFORMAT:
1988dc0dbf5cSWarner Losh
1989f699bbbbSMark OvensThis file contains a list, in reverse chronological order, of major
1990630f2154SGlen Barberbreakages in tracking -current.  It is not guaranteed to be a complete
19919c80b8aaSWarner Loshlist of such breakages, and only contains entries since September 23, 2011.
1992630f2154SGlen BarberIf you need to see UPDATING entries from before that date, you will need
1993630f2154SGlen Barberto fetch an UPDATING file from an older FreeBSD release.
19941fc1a0dcSWarner Losh
1995e72fd46aSWarner LoshCopyright information:
1996e72fd46aSWarner Losh
19978590b14eSWarner LoshCopyright 1998-2009 M. Warner Losh.
1998e72fd46aSWarner Losh
1999772730c7SWarner LoshRedistribution, publication, translation and use, with or without
2000772730c7SWarner Loshmodification, in full or in part, in any form or format of this
20019698f2c0SWarner Loshdocument are permitted without further permission from the author.
2002e72fd46aSWarner Losh
2003e72fd46aSWarner LoshTHIS DOCUMENT IS PROVIDED BY WARNER LOSH ``AS IS'' AND ANY EXPRESS OR
2004e72fd46aSWarner LoshIMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
2005e72fd46aSWarner LoshWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
2006e72fd46aSWarner LoshDISCLAIMED.  IN NO EVENT SHALL WARNER LOSH BE LIABLE FOR ANY DIRECT,
2007e72fd46aSWarner LoshINDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
2008e72fd46aSWarner Losh(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
2009e72fd46aSWarner LoshSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2010e72fd46aSWarner LoshHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
2011e72fd46aSWarner LoshSTRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
2012e72fd46aSWarner LoshIN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
2013e72fd46aSWarner LoshPOSSIBILITY OF SUCH DAMAGE.
2014e72fd46aSWarner Losh
201522306abcSWarner LoshContact Warner Losh if you have any questions about your use of
2016772730c7SWarner Loshthis document.
2017772730c7SWarner Losh
201897d92980SPeter Wemm$FreeBSD$
2019