xref: /freebsd/UPDATING (revision 738919c0391b99947b758d85f6a8636be1886fbb)
112f22a78SPeter WemmUpdating Information for FreeBSD current users.
253dfde79SWarner Losh
3456b5dd8SWarner LoshThis file is maintained and copyrighted by M. Warner Losh <imp@freebsd.org>.
4456b5dd8SWarner LoshSee end of file for further details.  For commonly done items, please see the
5456b5dd8SWarner LoshCOMMON ITEMS: section later in the file.  These instructions assume that you
6456b5dd8SWarner Loshbasically know what you are doing.  If not, then please consult the FreeBSD
7e0fb6dc3SRobert Watsonhandbook:
8e0fb6dc3SRobert Watson
9f539305eSJeremie Le Hen    https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/updating-src.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
19ae940db1SGlen BarberNOTE TO PEOPLE WHO THINK THAT FreeBSD 12.x IS SLOW:
20981b538fSGlen Barber	FreeBSD 12.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
345ad05815SWarner Losh
355ad05815SWarner Losh****************************** SPECIAL WARNING: ******************************
365ad05815SWarner Losh
375ad05815SWarner Losh	Due to a bug in some versions of clang that's very hard to workaround in
385ad05815SWarner Losh	the upgrade process, to upgrade to -current you must first upgrade
39fca3dcdfSWarner Losh	either stable/9 after r286035 or stable/10 after r286033 (including
40fca3dcdfSWarner Losh	10.3-RELEASE) or current after r286007 (including stable/11 and
41fca3dcdfSWarner Losh	11.0-RELEASE). These revisions post-date the 10.2 and 9.3 releases, so
42fca3dcdfSWarner Losh	you'll need to take the unusual step of upgrading to the tip of the
43fca3dcdfSWarner Losh	stable branch before moving to 11 or -current via a source upgrade.
4490136961SWarner Losh	stable/11 and 11.0-RELEASE have working newer compiler. This differs
4590136961SWarner Losh	from the historical situation where one could upgrade from anywhere on
4690136961SWarner Losh	the last couple of stable branches, so be careful.
4790136961SWarner Losh
4890136961SWarner Losh	If you're running a hybrid system on 9.x or 10.x with an updated clang
4990136961SWarner Losh	compiler or are using an supported external toolchain, the build system
5090136961SWarner Losh	will allow the upgrade. Otherwise it will print a reminder.
515ad05815SWarner Losh
525ad05815SWarner Losh****************************** SPECIAL WARNING: ******************************
53efc06131SSam Leffler
549949595eSAdrian Chadd20170524:
559949595eSAdrian Chadd	The ath(4) and ath_hal(4) modules now build piecemeal to allow for
569949595eSAdrian Chadd	smaller runtime footprint builds.  This is useful for embedded systems
579949595eSAdrian Chadd	which only require one chipset support.
589949595eSAdrian Chadd
599949595eSAdrian Chadd	If you load it as a module, make sure this is in /boot/loader.conf:
609949595eSAdrian Chadd
619949595eSAdrian Chadd	if_ath_load="YES"
629949595eSAdrian Chadd
639949595eSAdrian Chadd	This will load the HAL, all chip/RF backends and if_ath_pci.
649949595eSAdrian Chadd	If you have if_ath_pci in /boot/loader.conf, ensure it is after
659949595eSAdrian Chadd	if_ath or it will not load any HAL chipset support.
669949595eSAdrian Chadd
679949595eSAdrian Chadd	If you want to selectively load things (eg on ye cheape ARM/MIPS
689949595eSAdrian Chadd	platforms where RAM is at a premium) you should:
699949595eSAdrian Chadd
709949595eSAdrian Chadd	* load ath_hal
719949595eSAdrian Chadd	* load the chip modules in question
729949595eSAdrian Chadd	* load ath_rate, ath_dfs
739949595eSAdrian Chadd	* load ath_main
749949595eSAdrian Chadd	* load if_ath_pci and/or if_ath_ahb depending upon your particular
759949595eSAdrian Chadd	  bus bind type - this is where probe/attach is done.
769949595eSAdrian Chadd
779949595eSAdrian Chadd	For further comments/feedback, poke adrian@ .
789949595eSAdrian Chadd
79*738919c0SBaptiste Daroussin20170531:
80*738919c0SBaptiste Daroussin	The GNU roff toolchain has been removed from base. To render manpages
81*738919c0SBaptiste Daroussin	which are not supported by mandoc(1), man(1) can fallback on GNU roff
82*738919c0SBaptiste Daroussin	from ports (and recommends to install it).
83*738919c0SBaptiste Daroussin	To render roff(7) documents, consider using GNU roff from ports or the
84*738919c0SBaptiste Daroussin	heirloom doctools roff toolchain from ports via pkg install groff or
85*738919c0SBaptiste Daroussin	via pkg install heirloom-doctools.
86*738919c0SBaptiste Daroussin
87b149eba4SEd Maste20170523:
88b149eba4SEd Maste	The "ino64" 64-bit inode project has been committed, which extends
89dcfffd04SEd Maste	a number of types to 64 bits.  Upgrading in place requires care and
90dcfffd04SEd Maste	adherence to the documented upgrade procedure.
91dcfffd04SEd Maste
92dcfffd04SEd Maste	If using a custom kernel configuration ensure that the
93dcfffd04SEd Maste	COMPAT_FREEBSD11 option is included (as during the upgrade the
94dcfffd04SEd Maste	system will be running the ino64 kernel with the existing world).
95dcfffd04SEd Maste
96dcfffd04SEd Maste	For the safest in-place upgrade begin by removing previous build
97dcfffd04SEd Maste	artifacts via "rm -rf /usr/obj/*".   Then, carefully follow the
98dcfffd04SEd Maste	full procedure documented below under the heading "To rebuild
99dcfffd04SEd Maste	everything and install it on the current system."  Specifically,
100dcfffd04SEd Maste	a reboot is required after installing the new kernel before
101dcfffd04SEd Maste	installing world.
102b149eba4SEd Maste
103a25a1ff4SBrooks Davis20170424:
104a25a1ff4SBrooks Davis	The NATM framework including the en(4), fatm(4), hatm(4), and
105a25a1ff4SBrooks Davis	patm(4) devices has been removed.  Consumers should plan a
106a25a1ff4SBrooks Davis	migration before the end-of-life date for FreeBSD 11.
107a25a1ff4SBrooks Davis
108a17665bcSBaptiste Daroussin20170420:
109a17665bcSBaptiste Daroussin	GNU diff has been replaced by a BSD licensed diff. Some features of GNU
110a17665bcSBaptiste Daroussin	diff has not been implemented, if those are needed a newer version of
111a17665bcSBaptiste Daroussin	GNU diff is available via the diffutils package under the gdiff name.
112a17665bcSBaptiste Daroussin
1135810e45bSCy Schubert20170413:
1145810e45bSCy Schubert	As of r316810 for ipfilter, keep frags is no longer assumed when
1155810e45bSCy Schubert	keep state is specified in a rule. r316810 aligns ipfilter with
1165810e45bSCy Schubert	documentation in man pages separating keep frags from keep state.
117a3a09aefSJens Schweikhardt	This allows keep state to be specified without forcing keep frags
1185810e45bSCy Schubert	and allows keep frags to be specified independently of keep state.
1195810e45bSCy Schubert	To maintain previous behaviour, also specify keep frags with
1200cad3ecaSCy Schubert	keep state (as documented in ipf.conf.5).
1215810e45bSCy Schubert
1221bf5e133SEd Maste20170407:
1231bf5e133SEd Maste	arm64 builds now use the base system LLD 4.0.0 linker by default,
1241bf5e133SEd Maste	instead of requiring that the aarch64-binutils port or package be
1251bf5e133SEd Maste	installed. To continue using aarch64-binutils, set
1261bf5e133SEd Maste	CROSS_BINUTILS_PREFIX=/usr/local/aarch64-freebsd/bin .
1271bf5e133SEd Maste
12828da7a25SBryan Drewery20170405:
12928da7a25SBryan Drewery	The UDP optimization in entry 20160818 that added the sysctl
13028da7a25SBryan Drewery	net.inet.udp.require_l2_bcast has been reverted.  L2 broadcast
13128da7a25SBryan Drewery	packets will no longer be treated as L3 broadcast packets.
13228da7a25SBryan Drewery
1336ebc1b7bSSteven Hartland20170331:
1344d806fc6SSteven Hartland	Binds and sends to the loopback addresses, IPv6 and IPv4, will now
1356ebc1b7bSSteven Hartland	use any explicitly assigned loopback address available in the jail
1364d806fc6SSteven Hartland	instead of using the first assigned address of the jail.
1376ebc1b7bSSteven Hartland
1380458b265SEnji Cooper20170329:
1390458b265SEnji Cooper	The ctl.ko module no longer implements the iSCSI target frontend:
1400458b265SEnji Cooper	cfiscsi.ko does instead.
1410458b265SEnji Cooper
1420458b265SEnji Cooper	If building cfiscsi.ko as a kernel module, the module can be loaded
1430458b265SEnji Cooper	via one of the following methods:
1440458b265SEnji Cooper	- `cfiscsi_load="YES"` in loader.conf(5).
1450458b265SEnji Cooper	- Add `cfiscsi` to `$kld_list` in rc.conf(5).
1460458b265SEnji Cooper	- ctladm(8)/ctld(8), when compiled with iSCSI support
1470458b265SEnji Cooper	  (`WITH_ISCSI=yes` in src.conf(5))
1480458b265SEnji Cooper
1490458b265SEnji Cooper	Please see cfiscsi(4) for more details.
1500458b265SEnji Cooper
15172dec079SMarius Strobl20170316:
15272dec079SMarius Strobl	The mmcsd.ko module now additionally depends on geom_flashmap.ko.
15372dec079SMarius Strobl	Also, mmc.ko and mmcsd.ko need to be a matching pair built from the
15472dec079SMarius Strobl	same source (previously, the dependency of mmcsd.ko on mmc.ko was
15572dec079SMarius Strobl	missing, but mmcsd.ko now will refuse to load if it is incompatible
15672dec079SMarius Strobl	with mmc.ko).
15772dec079SMarius Strobl
1586ed14738SAndrey V. Elsukov20170315:
1596ed14738SAndrey V. Elsukov	The syntax of ipfw(8) named states was changed to avoid ambiguity.
1606ed14738SAndrey V. Elsukov	If you have used named states in the firewall rules, you need to modify
1616ed14738SAndrey V. Elsukov	them after installworld and before rebooting. Now named states must
1626ed14738SAndrey V. Elsukov	be prefixed with colon.
1636ed14738SAndrey V. Elsukov
1643bbe3f67SBaptiste Daroussin20170311:
165f7c23774SEmmanuel Vadot	The old drm (sys/dev/drm/) drivers for i915 and radeon have been
166f7c23774SEmmanuel Vadot	removed as the userland we provide cannot use them. The KMS version
167a3a09aefSJens Schweikhardt	(sys/dev/drm2) supports the same hardware.
168f7c23774SEmmanuel Vadot
169e1bb2a82SDimitry Andric20170302:
170617b5f75SDimitry Andric	Clang, llvm, lldb, compiler-rt and libc++ have been upgraded to 4.0.0.
171617b5f75SDimitry Andric	Please see the 20141231 entry below for information about prerequisites
172617b5f75SDimitry Andric	and upgrading, if you are not already using clang 3.5.0 or higher.
173617b5f75SDimitry Andric
174e9a0a054SAndriy Gapon20170221:
175e9a0a054SAndriy Gapon	The code that provides support for ZFS .zfs/ directory functionality
176e9a0a054SAndriy Gapon	has been reimplemented.  It's not possible now to create a snapshot
177e9a0a054SAndriy Gapon	by mkdir under .zfs/snapshot/.  That should be the only user visible
178e9a0a054SAndriy Gapon	change.
179e9a0a054SAndriy Gapon
18018f447edSWarner Losh20170216:
18118f447edSWarner Losh	EISA bus support has been removed. The WITH_EISA option is no longer
18218f447edSWarner Losh	valid.
18318f447edSWarner Losh
18418f447edSWarner Losh20170215:
18518f447edSWarner Losh	MCA bus support has been removed.
18618f447edSWarner Losh
187f52e4bdfSEd Maste20170127:
188f52e4bdfSEd Maste	The WITH_LLD_AS_LD / WITHOUT_LLD_AS_LD build knobs have been renamed
189f52e4bdfSEd Maste	WITH_LLD_IS_LD / WITHOUT_LLD_IS_LD, for consistency with CLANG_IS_CC.
190f52e4bdfSEd Maste
191062a4b8cSSean Bruno20170112:
192062a4b8cSSean Bruno	The EM_MULTIQUEUE kernel configuration option is deprecated now that
193062a4b8cSSean Bruno	the em(4) driver conforms to iflib specifications.
194062a4b8cSSean Bruno
195f2d6ace4SSean Bruno20170109:
196f2d6ace4SSean Bruno	The igb(4), em(4) and lem(4) ethernet drivers are now implemented via
197f2d6ace4SSean Bruno	IFLIB.  If you have a custom kernel configuration that excludes em(4)
198f2d6ace4SSean Bruno	but you use igb(4), you need to re-add em(4) to your custom configuration.
199f2d6ace4SSean Bruno
2004644fe91SDimitry Andric20161217:
20145bd65d6SDimitry Andric	Clang, llvm, lldb, compiler-rt and libc++ have been upgraded to 3.9.1.
20245bd65d6SDimitry Andric	Please see the 20141231 entry below for information about prerequisites
20345bd65d6SDimitry Andric	and upgrading, if you are not already using clang 3.5.0 or higher.
20445bd65d6SDimitry Andric
2057736f1a9SDimitry Andric20161124:
2067736f1a9SDimitry Andric	Clang, llvm, lldb, compiler-rt and libc++ have been upgraded to 3.9.0.
2077736f1a9SDimitry Andric	Please see the 20141231 entry below for information about prerequisites
2087736f1a9SDimitry Andric	and upgrading, if you are not already using clang 3.5.0 or higher.
2097736f1a9SDimitry Andric
2104026b447SJustin Hibbits20161119:
2114026b447SJustin Hibbits	The layout of the pmap structure has changed for powerpc to put the pmap
2124026b447SJustin Hibbits	statistics at the front for all CPU variations.  libkvm(3) and all tools
2134026b447SJustin Hibbits	that link against it need to be recompiled.
2144026b447SJustin Hibbits
215448897d3SAndriy Gapon20161030:
216448897d3SAndriy Gapon	isl(4) and cyapa(4) drivers now require a new driver,
217448897d3SAndriy Gapon	chromebook_platform(4), to work properly on Chromebook-class hardware.
218448897d3SAndriy Gapon	On other types of hardware the drivers may need to be configured using
219448897d3SAndriy Gapon	device hints.  Please see the corresponding manual pages for details.
220448897d3SAndriy Gapon
2212616dd0bSAndriy Voskoboinyk20161017:
2222616dd0bSAndriy Voskoboinyk	The urtwn(4) driver was merged into rtwn(4) and now consists of
2232616dd0bSAndriy Voskoboinyk	rtwn(4) main module + rtwn_usb(4) and rtwn_pci(4) bus-specific
2242616dd0bSAndriy Voskoboinyk	parts.
2252616dd0bSAndriy Voskoboinyk	Also, firmware for RTL8188CE was renamed due to possible name
2262616dd0bSAndriy Voskoboinyk	conflict (rtwnrtl8192cU(B) -> rtwnrtl8192cE(B))
2272616dd0bSAndriy Voskoboinyk
228a0135a1eSBaptiste Daroussin20161015:
229963d6c18SBaptiste Daroussin	GNU rcs has been removed from base.  It is available as packages:
230a0135a1eSBaptiste Daroussin	- rcs: Latest GPLv3 GNU rcs version.
23131b54b30SBaptiste Daroussin	- rcs57: Copy of the latest version of GNU rcs (GPLv2) before it was
23231b54b30SBaptiste Daroussin	removed from base.
233a0135a1eSBaptiste Daroussin
234bd79708dSJonathan T. Looney20161008:
235bd79708dSJonathan T. Looney	Use of the cc_cdg, cc_chd, cc_hd, or cc_vegas congestion control
236bd79708dSJonathan T. Looney	modules now requires that the kernel configuration contain the
237bd79708dSJonathan T. Looney	TCP_HHOOK option. (This option is included in the GENERIC kernel.)
238bd79708dSJonathan T. Looney
2399ce3c6b0SEd Maste20161003:
2409ce3c6b0SEd Maste	The WITHOUT_ELFCOPY_AS_OBJCOPY src.conf(5) knob has been retired.
2419ce3c6b0SEd Maste	ELF Tool Chain's elfcopy is always installed as /usr/bin/objcopy.
2429ce3c6b0SEd Maste
243bba95d2dSMarcel Moolenaar20160924:
244bba95d2dSMarcel Moolenaar	Relocatable object files with the extension of .So have been renamed
245bba95d2dSMarcel Moolenaar	to use an extension of .pico instead.  The purpose of this change is
246bba95d2dSMarcel Moolenaar	to avoid a name clash with shared libraries on case-insensitive file
247bba95d2dSMarcel Moolenaar	systems.  On those file systems, foo.So is the same file as foo.so.
248bba95d2dSMarcel Moolenaar
2495b71d899SBaptiste Daroussin20160918:
250f902d06cSBaptiste Daroussin	GNU rcs has been turned off by default.  It can (temporarily) be built
2510adf2bc8SBaptiste Daroussin	again by adding WITH_RCS knob in src.conf.
252452e1889SBaptiste Daroussin	Otherwise, GNU rcs is available from packages:
253452e1889SBaptiste Daroussin	- rcs: Latest GPLv3 GNU rcs version.
254452e1889SBaptiste Daroussin	- rcs57: Copy of the latest version of GNU rcs (GPLv2) from base.
2550adf2bc8SBaptiste Daroussin
2560adf2bc8SBaptiste Daroussin20160918:
2575b71d899SBaptiste Daroussin	The backup_uses_rcs functionality has been removed from rc.subr.
2585b71d899SBaptiste Daroussin
25906b93667SConrad Meyer20160908:
26006b93667SConrad Meyer	The queue(3) debugging macro, QUEUE_MACRO_DEBUG, has been split into
26106b93667SConrad Meyer	two separate components, QUEUE_MACRO_DEBUG_TRACE and
26206b93667SConrad Meyer	QUEUE_MACRO_DEBUG_TRASH.  Define both for the original
26306b93667SConrad Meyer	QUEUE_MACRO_DEBUG behavior.
26406b93667SConrad Meyer
2651c828193SNavdeep Parhar20160824:
2661c828193SNavdeep Parhar	r304787 changed some ioctl interfaces between the iSCSI userspace
2671c828193SNavdeep Parhar	programs and the kernel.  ctladm, ctld, iscsictl, and iscsid must be
2681c828193SNavdeep Parhar	rebuilt to work with new kernels.  __FreeBSD_version has been bumped
2691c828193SNavdeep Parhar	to 1200005.
2701c828193SNavdeep Parhar
2713e7e2333SGeorge V. Neville-Neil20160818:
27228da7a25SBryan Drewery	The UDP receive code has been updated to only treat incoming UDP
27328da7a25SBryan Drewery	packets that were addressed to an L2 broadcast address as L3
27428da7a25SBryan Drewery	broadcast packets.  It is not expected that this will affect any
27528da7a25SBryan Drewery	standards-conforming UDP application.  The new behaviour can be
27628da7a25SBryan Drewery	disabled by setting the sysctl net.inet.udp.require_l2_bcast to
27728da7a25SBryan Drewery	0.
27828da7a25SBryan Drewery
27928da7a25SBryan Drewery20160818:
2803e7e2333SGeorge V. Neville-Neil	Remove the openbsd_poll system call.
2813e7e2333SGeorge V. Neville-Neil	__FreeBSD_version has been bumped because of this.
2823e7e2333SGeorge V. Neville-Neil
283ddc2f805SBrooks Davis20160622:
284678243ffSBrooks Davis	The libc stub for the pipe(2) system call has been replaced with
285f0db8553SBrooks Davis	a wrapper that calls the pipe2(2) system call and the pipe(2)
286f0db8553SBrooks Davis	system call is now only implemented by the kernels that include
287f0db8553SBrooks Davis	"options COMPAT_FREEBSD10" in their config file (this is the
288f0db8553SBrooks Davis	default).  Users should ensure that this option is enabled in
289f0db8553SBrooks Davis	their kernel or upgrade userspace to r302092 before upgrading their
290f0db8553SBrooks Davis	kernel.
291ddc2f805SBrooks Davis
292583febf4SAlan Somers20160527:
293583febf4SAlan Somers	CAM will now strip leading spaces from SCSI disks' serial numbers.
294fb9b2ab1SBryan Drewery	This will affect users who create UFS filesystems on SCSI disks using
295583febf4SAlan Somers	those disk's diskid device nodes.  For example, if /etc/fstab
296583febf4SAlan Somers	previously contained a line like
297583febf4SAlan Somers	"/dev/diskid/DISK-%20%20%20%20%20%20%20ABCDEFG0123456", you should
298583febf4SAlan Somers	change it to "/dev/diskid/DISK-ABCDEFG0123456".  Users of geom
299ab5d7fb1SAlan Somers	transforms like gmirror may also be affected.  ZFS users should
300583febf4SAlan Somers	generally be fine.
301583febf4SAlan Somers
3021b82e02fSAlan Somers20160523:
3031b82e02fSAlan Somers	The bitstring(3) API has been updated with new functionality and
3041b82e02fSAlan Somers	improved performance.  But it is binary-incompatible with the old API.
3051b82e02fSAlan Somers	Objects built with the new headers may not be linked against objects
3061b82e02fSAlan Somers	built with the old headers.
3071b82e02fSAlan Somers
30894098ab7SAndrew Turner20160520:
30994098ab7SAndrew Turner	The brk and sbrk functions have been removed from libc on arm64.
31094098ab7SAndrew Turner	Binutils from ports has been updated to not link to these
31194098ab7SAndrew Turner	functions and should be updated to the latest version before
31294098ab7SAndrew Turner	installing a new libc.
31394098ab7SAndrew Turner
3142c0e9e2aSWarner Losh20160517:
3152c0e9e2aSWarner Losh	The armv6 port now defaults to hard float ABI. Limited support
3162c0e9e2aSWarner Losh	for running both hardfloat and soft float on the same system
3172c0e9e2aSWarner Losh	is available using the libraries installed with -DWITH_LIBSOFT.
3182c0e9e2aSWarner Losh	This has only been tested as an upgrade path for installworld
3192c0e9e2aSWarner Losh	and packages may fail or need manual intervention to run. New
3202c0e9e2aSWarner Losh	packages will be needed.
3212c0e9e2aSWarner Losh
322957fc425SIan Lepore	To update an existing self-hosted armv6hf system, you must add
323957fc425SIan Lepore	TARGET_ARCH=armv6 on the make command line for both the build
324957fc425SIan Lepore	and the install steps.
325957fc425SIan Lepore
3265f0263c1SJohn Baldwin20160510:
3275f0263c1SJohn Baldwin	Kernel modules compiled outside of a kernel build now default to
3285f0263c1SJohn Baldwin	installing to /boot/modules instead of /boot/kernel.  Many kernel
3295f0263c1SJohn Baldwin	modules built this way (such as those in ports) already overrode
3305f0263c1SJohn Baldwin	KMODDIR explicitly to install into /boot/modules.  However,
3315f0263c1SJohn Baldwin	manually building and installing a module from /sys/modules will
3325f0263c1SJohn Baldwin	now install to /boot/modules instead of /boot/kernel.
3335f0263c1SJohn Baldwin
33413694b35SWarner Losh20160414:
335a1743365SWarner Losh	The CAM I/O scheduler has been committed to the kernel. There should be
336a1743365SWarner Losh	no user visible impact. This does enable NCQ Trim on ada SSDs. While the
337a1743365SWarner Losh	list of known rogues that claim support for this but actually corrupt
338a1743365SWarner Losh	data is believed to be complete, be on the lookout for data
339a1743365SWarner Losh	corruption. The known rogue list is believed to be complete:
340a1743365SWarner Losh
341a1743365SWarner Losh		o Crucial MX100, M550 drives with MU01 firmware.
342a1743365SWarner Losh		o Micron M510 and M550 drives with MU01 firmware.
343a1743365SWarner Losh		o Micron M500 prior to MU07 firmware
344a1743365SWarner Losh		o Samsung 830, 840, and 850 all firmwares
345a1743365SWarner Losh		o FCCT M500 all firmwares
346a1743365SWarner Losh
347a1743365SWarner Losh	Crucial has firmware http://www.crucial.com/usa/en/support-ssd-firmware
348a1743365SWarner Losh	with working NCQ TRIM. For Micron branded drives, see your sales rep for
349a1743365SWarner Losh	updated firmware. Black listed drives will work correctly because these
350a1743365SWarner Losh	drives work correctly so long as no NCQ TRIMs are sent to them. Given
351a1743365SWarner Losh	this list is the same as found in Linux, it's believed there are no
352a1743365SWarner Losh	other rogues in the market place. All other models from the above
353a1743365SWarner Losh	vendors work.
354a1743365SWarner Losh
355a1743365SWarner Losh	To be safe, if you are at all concerned, you can quirk each of your
356a1743365SWarner Losh	drives to prevent NCQ from being sent by setting:
357a1743365SWarner Losh		kern.cam.ada.X.quirks="0x2"
358a1743365SWarner Losh	in loader.conf. If the drive requires the 4k sector quirk, set the
359a1743365SWarner Losh	quirks entry to 0x3.
36013694b35SWarner Losh
361497e8091SBryan Drewery20160330:
362497e8091SBryan Drewery	The FAST_DEPEND build option has been removed and its functionality is
363497e8091SBryan Drewery	now the one true way.  The old mkdep(1) style of 'make depend' has
364497e8091SBryan Drewery	been removed.  See 20160311 for further details.
365497e8091SBryan Drewery
366da1b038aSJustin Hibbits20160317:
367da1b038aSJustin Hibbits	Resource range types have grown from unsigned long to uintmax_t.  All
368da1b038aSJustin Hibbits	drivers, and anything using libdevinfo, need to be recompiled.
369da1b038aSJustin Hibbits
370d783b170SBryan Drewery20160311:
371d783b170SBryan Drewery	WITH_FAST_DEPEND is now enabled by default for in-tree and out-of-tree
372d783b170SBryan Drewery	builds.  It no longer runs mkdep(1) during 'make depend', and the
373d783b170SBryan Drewery	'make depend' stage can safely be skipped now as it is auto ran
374d783b170SBryan Drewery	when building 'make all' and will generate all SRCS and DPSRCS before
375d783b170SBryan Drewery	building anything else.  Dependencies are gathered at compile time with
376d783b170SBryan Drewery	-MF flags kept in separate .depend files per object file.  Users should
377d783b170SBryan Drewery	run 'make cleandepend' once if using -DNO_CLEAN to clean out older
378d783b170SBryan Drewery	stale .depend files.
379d783b170SBryan Drewery
380c834228bSDimitry Andric20160306:
381c834228bSDimitry Andric	On amd64, clang 3.8.0 can now insert sections of type AMD64_UNWIND into
382c834228bSDimitry Andric	kernel modules.  Therefore, if you load any kernel modules at boot time,
383c834228bSDimitry Andric	please install the boot loaders after you install the kernel, but before
384c834228bSDimitry Andric	rebooting, e.g.:
385c834228bSDimitry Andric
386c834228bSDimitry Andric	make buildworld
387c834228bSDimitry Andric	make kernel KERNCONF=YOUR_KERNEL_HERE
388c834228bSDimitry Andric	make -C sys/boot install
389c834228bSDimitry Andric	<reboot in single user>
390c834228bSDimitry Andric
391c834228bSDimitry Andric	Then follow the usual steps, described in the General Notes section,
392c834228bSDimitry Andric	below.
393c834228bSDimitry Andric
394e74e149fSDimitry Andric20160305:
395e74e149fSDimitry Andric	Clang, llvm, lldb and compiler-rt have been upgraded to 3.8.0.  Please
396e74e149fSDimitry Andric	see the 20141231 entry below for information about prerequisites and
397e74e149fSDimitry Andric	upgrading, if you are not already using clang 3.5.0 or higher.
398e74e149fSDimitry Andric
3998b66d3d3SJohn Baldwin20160301:
4008b66d3d3SJohn Baldwin	The AIO subsystem is now a standard part of the kernel.  The
4018b66d3d3SJohn Baldwin	VFS_AIO kernel option and aio.ko kernel module have been removed.
4028b66d3d3SJohn Baldwin	Due to stability concerns, asynchronous I/O requests are only
4038b66d3d3SJohn Baldwin	permitted on sockets and raw disks by default.  To enable
4048b66d3d3SJohn Baldwin	asynchronous I/O requests on all file types, set the
4058b66d3d3SJohn Baldwin	vfs.aio.enable_unsafe sysctl to a non-zero value.
4068b66d3d3SJohn Baldwin
407de463b29SEd Maste20160226:
408ca8b902aSEd Maste	The ELF object manipulation tool objcopy is now provided by the
409ca8b902aSEd Maste	ELF Tool Chain project rather than by GNU binutils. It should be a
410ca8b902aSEd Maste	drop-in replacement, with the addition of arm64 support. The
411ca8b902aSEd Maste	(temporary) src.conf knob WITHOUT_ELFCOPY_AS_OBJCOPY knob may be set
412ca8b902aSEd Maste	to obtain the GNU version if necessary.
413ca8b902aSEd Maste
414d4b9233aSAlan Somers20160129:
415d4b9233aSAlan Somers	Building ZFS pools on top of zvols is prohibited by default.  That
416d4b9233aSAlan Somers	feature has never worked safely; it's always been prone to deadlocks.
417d4b9233aSAlan Somers	Using a zvol as the backing store for a VM guest's virtual disk will
418d4b9233aSAlan Somers	still work, even if the guest is using ZFS.  Legacy behavior can be
419d4b9233aSAlan Somers	restored by setting vfs.zfs.vol.recursive=1.
420d4b9233aSAlan Somers
42160c59fadSDag-Erling Smørgrav20160119:
42260c59fadSDag-Erling Smørgrav	The NONE and HPN patches has been removed from OpenSSH.  They are
42360c59fadSDag-Erling Smørgrav	still available in the security/openssh-portable port.
42460c59fadSDag-Erling Smørgrav
4253bf7d9a6SMarcelo Araujo20160113:
4263bf7d9a6SMarcelo Araujo	With the addition of ypldap(8), a new _ypldap user is now required
4273bf7d9a6SMarcelo Araujo	during installworld. "mergemaster -p" can be used to add the user
4283bf7d9a6SMarcelo Araujo	prior to installworld, as documented in the handbook.
4293bf7d9a6SMarcelo Araujo
4304d6ab32fSBaptiste Daroussin20151216:
4314d6ab32fSBaptiste Daroussin	The tftp loader (pxeboot) now uses the option root-path directive. As a
4324d6ab32fSBaptiste Daroussin	consequence it no longer looks for a pxeboot.4th file on the tftp
4334d6ab32fSBaptiste Daroussin	server. Instead it uses the regular /boot infrastructure as with the
4344d6ab32fSBaptiste Daroussin	other loaders.
4354d6ab32fSBaptiste Daroussin
436ca7e5285SWarner Losh20151211:
437ca7e5285SWarner Losh	The code to start recording plug and play data into the modules has
438ca7e5285SWarner Losh	been committed. While the old tools will properly build a new kernel,
439ca7e5285SWarner Losh	a number of warnings about "unknown metadata record 4" will be produced
440ca7e5285SWarner Losh	for an older kldxref. To avoid such warnings, make sure to rebuild
441ca7e5285SWarner Losh	the kernel toolchain (or world). Make sure that you have r292078 or
442ca7e5285SWarner Losh	later when trying to build 292077 or later before rebuilding.
443ca7e5285SWarner Losh
444015dfda6SEd Maste20151207:
445015dfda6SEd Maste	Debug data files are now built by default with 'make buildworld' and
446015dfda6SEd Maste	installed with 'make installworld'. This facilitates debugging but
447015dfda6SEd Maste	requires more disk space both during the build and for the installed
448015dfda6SEd Maste	world. Debug files may be disabled by setting WITHOUT_DEBUG_FILES=yes
449015dfda6SEd Maste	in src.conf(5).
450015dfda6SEd Maste
45133ba1088SRick Macklem20151130:
45233ba1088SRick Macklem	r291527 changed the internal interface between the nfsd.ko and
45333ba1088SRick Macklem	nfscommon.ko modules. As such, they must both be upgraded to-gether.
45433ba1088SRick Macklem	__FreeBSD_version has been bumped because of this.
45533ba1088SRick Macklem
456af1d74f0SBaptiste Daroussin20151108:
457af1d74f0SBaptiste Daroussin	Add support for unicode collation strings leads to a change of
458af1d74f0SBaptiste Daroussin	order of files listed by ls(1) for example. To get back to the old
459af1d74f0SBaptiste Daroussin	behaviour, set LC_COLLATE environment variable to "C".
460af1d74f0SBaptiste Daroussin
4610492a14fSBaptiste Daroussin	Databases administrators will need to reindex their databases given
4620492a14fSBaptiste Daroussin	collation results will be different.
4630492a14fSBaptiste Daroussin
46410b5202eSBaptiste Daroussin	Due to a bug in install(1) it is recommended to remove the ancient
4651300d6f1SBaptiste Daroussin	locales before running make installworld.
46601bedb0cSBaptiste Daroussin
4671300d6f1SBaptiste Daroussin	rm -rf /usr/share/locale/*
46801bedb0cSBaptiste Daroussin
4697bded2dbSJung-uk Kim20151030:
4707bded2dbSJung-uk Kim	The OpenSSL has been upgraded to 1.0.2d.  Any binaries requiring
4717bded2dbSJung-uk Kim	libcrypto.so.7 or libssl.so.7 must be recompiled.
4727bded2dbSJung-uk Kim
473ebda5173SAlexander Motin20151020:
474ebda5173SAlexander Motin	Qlogic 24xx/25xx firmware images were updated from 5.5.0 to 7.3.0.
475ebda5173SAlexander Motin	Kernel modules isp_2400_multi and isp_2500_multi were removed and
476ebda5173SAlexander Motin	should be replaced with isp_2400 and isp_2500 modules respectively.
477ebda5173SAlexander Motin
47856585ab5SBryan Drewery20151017:
47956585ab5SBryan Drewery	The build previously allowed using 'make -n' to not recurse into
48056585ab5SBryan Drewery	sub-directories while showing what commands would be executed, and
48156585ab5SBryan Drewery	'make -n -n' to recursively show commands.  Now 'make -n' will recurse
48256585ab5SBryan Drewery	and 'make -N' will not.
48356585ab5SBryan Drewery
484ff446b05SPeter Wemm20151012:
485ff446b05SPeter Wemm	If you specify SENDMAIL_MC or SENDMAIL_CF in make.conf, mergemaster
486ff446b05SPeter Wemm	and etcupdate will now use this file. A custom sendmail.cf is now
487ff446b05SPeter Wemm	updated via this mechanism rather than via installworld.  If you had
488ff446b05SPeter Wemm	excluded sendmail.cf in mergemaster.rc or etcupdate.conf, you may
489ff446b05SPeter Wemm	want to remove the exclusion or change it to "always install".
490ff446b05SPeter Wemm	/etc/mail/sendmail.cf is now managed the same way regardless of
491ff446b05SPeter Wemm	whether SENDMAIL_MC/SENDMAIL_CF is used.  If you are not using
492ff446b05SPeter Wemm	SENDMAIL_MC/SENDMAIL_CF there should be no change in behavior.
493ff446b05SPeter Wemm
4944a3760baSAlexander Motin20151011:
4954a3760baSAlexander Motin	Compatibility shims for legacy ATA device names have been removed.
4964a3760baSAlexander Motin	It includes ATA_STATIC_ID kernel option, kern.cam.ada.legacy_aliases
4974a3760baSAlexander Motin	and kern.geom.raid.legacy_aliases loader tunables, kern.devalias.*
4984a3760baSAlexander Motin	environment variables, /dev/ad* and /dev/ar* symbolic links.
4994a3760baSAlexander Motin
500d31de548SDimitry Andric20151006:
5014f01407bSDimitry Andric	Clang, llvm, lldb, compiler-rt and libc++ have been upgraded to 3.7.0.
5024f01407bSDimitry Andric	Please see the 20141231 entry below for information about prerequisites
5034f01407bSDimitry Andric	and upgrading, if you are not already using clang 3.5.0 or higher.
504ebeff3f9SDimitry Andric
5055882166bSEd Maste20150924:
50605117b57SEd Maste	Kernel debug files have been moved to /usr/lib/debug/boot/kernel/,
50705117b57SEd Maste	and renamed from .symbols to .debug. This reduces the size requirements
50805117b57SEd Maste	on the boot partition or file system and provides consistency with
50905117b57SEd Maste	userland debug files.
51005117b57SEd Maste
51105117b57SEd Maste	When using the supported kernel installation method the
51205117b57SEd Maste	/usr/lib/debug/boot/kernel directory will be renamed (to kernel.old)
51305117b57SEd Maste	as is done with /boot/kernel.
51405117b57SEd Maste
51505117b57SEd Maste	Developers wishing to maintain the historical behavior of installing
51605117b57SEd Maste	debug files in /boot/kernel/ can set KERN_DEBUGDIR="" in src.conf(5).
51705117b57SEd Maste
51864b3b4d6SKristof Provost20150827:
5198ed69220SGleb Smirnoff	The wireless drivers had undergone changes that remove the 'parent
5208ed69220SGleb Smirnoff	interface' from the ifconfig -l output. The rc.d network scripts
5218ed69220SGleb Smirnoff	used to check presence of a parent interface in the list, so old
5228ed69220SGleb Smirnoff	scripts would fail to start wireless networking. Thus, etcupdate(3)
5238ed69220SGleb Smirnoff	or mergemaster(8) run is required after kernel update, to update your
5248ed69220SGleb Smirnoff	rc.d scripts in /etc.
5258ed69220SGleb Smirnoff
5268ed69220SGleb Smirnoff20150827:
52764b3b4d6SKristof Provost	pf no longer supports 'scrub fragment crop' or 'scrub fragment drop-ovl'
52864b3b4d6SKristof Provost	These configurations are now automatically interpreted as
52964b3b4d6SKristof Provost	'scrub fragment reassemble'.
53064b3b4d6SKristof Provost
531646041a8SMark Murray20150817:
532646041a8SMark Murray	Kernel-loadable modules for the random(4) device are back. To use
533646041a8SMark Murray	them, the kernel must have
534646041a8SMark Murray
535646041a8SMark Murray	device	random
536646041a8SMark Murray	options	RANDOM_LOADABLE
537646041a8SMark Murray
538646041a8SMark Murray	kldload(8) can then be used to load random_fortuna.ko
539646041a8SMark Murray	or random_yarrow.ko. Please note that due to the indirect
540646041a8SMark Murray	function calls that the loadable modules need to provide,
541646041a8SMark Murray	the build-in variants will be slightly more efficient.
542646041a8SMark Murray
543646041a8SMark Murray	The random(4) kernel option RANDOM_DUMMY has been retired due to
544646041a8SMark Murray	unpopularity. It was not all that useful anyway.
545646041a8SMark Murray
5461bc28ffcSEd Maste20150813:
5471bc28ffcSEd Maste	The WITHOUT_ELFTOOLCHAIN_TOOLS src.conf(5) knob has been retired.
5481bc28ffcSEd Maste	Control over building the ELF Tool Chain tools is now provided by
5491bc28ffcSEd Maste	the WITHOUT_TOOLCHAIN knob.
5501bc28ffcSEd Maste
551e7dbaf58SIan Lepore20150810:
552e7dbaf58SIan Lepore	The polarity of Pulse Per Second (PPS) capture events with the
553e7dbaf58SIan Lepore	uart(4) driver has been corrected.  Prior to this change the PPS
554e7dbaf58SIan Lepore	"assert" event corresponded to the trailing edge of a positive PPS
555e7dbaf58SIan Lepore	pulse and the "clear" event was the leading edge of the next pulse.
556e7dbaf58SIan Lepore
557e7dbaf58SIan Lepore	As the width of a PPS pulse in a typical GPS receiver is on the
558e7dbaf58SIan Lepore	order of 1 millisecond, most users will not notice any significant
559e7dbaf58SIan Lepore	difference with this change.
560e7dbaf58SIan Lepore
561e7dbaf58SIan Lepore	Anyone who has compensated for the historical polarity reversal by
562e7dbaf58SIan Lepore	configuring a negative offset equal to the pulse width will need to
563e7dbaf58SIan Lepore	remove that workaround.
564e7dbaf58SIan Lepore
56534c7eb57SKoop Mast20150809:
56634c7eb57SKoop Mast	The default group assigned to /dev/dri entries has been changed
56734c7eb57SKoop Mast	from 'wheel' to 'video' with the id of '44'. If you want to have
56834c7eb57SKoop Mast	access to the dri devices please add yourself to the video group
56934c7eb57SKoop Mast	with:
57034c7eb57SKoop Mast
57134c7eb57SKoop Mast	# pw groupmod video -m $USER
57234c7eb57SKoop Mast
5739322ac3fSAllan Jude20150806:
5749322ac3fSAllan Jude	The menu.rc and loader.rc files will now be replaced during
5759322ac3fSAllan Jude	upgrades. Please migrate local changes to menu.rc.local and
5769322ac3fSAllan Jude	loader.rc.local instead.
5779322ac3fSAllan Jude
578f97aa232SEd Maste20150805:
579f97aa232SEd Maste	GNU Binutils versions of addr2line, c++filt, nm, readelf, size,
580f97aa232SEd Maste	strings and strip have been removed. The src.conf(5) knob
581f97aa232SEd Maste	WITHOUT_ELFTOOLCHAIN_TOOLS no longer provides the binutils tools.
582f97aa232SEd Maste
5831635369eSSteven Hartland20150728:
58468d5f492SSteven Hartland	As ZFS requires more kernel stack pages than is the default on some
5851635369eSSteven Hartland	architectures e.g. i386, it now warns if KSTACK_PAGES is less than
5861635369eSSteven Hartland	ZFS_MIN_KSTACK_PAGES (which is 4 at the time of writing).
5871635369eSSteven Hartland
5881635369eSSteven Hartland	Please consider using 'options KSTACK_PAGES=X' where X is greater
5891635369eSSteven Hartland	than or equal to ZFS_MIN_KSTACK_PAGES i.e. 4 in such configurations.
5901635369eSSteven Hartland
591ab1f4a42SGregory Neil Shapiro20150706:
592ab1f4a42SGregory Neil Shapiro	sendmail has been updated to 8.15.2.  Starting with FreeBSD 11.0
593ab1f4a42SGregory Neil Shapiro	and sendmail 8.15, sendmail uses uncompressed IPv6 addresses by
594ab1f4a42SGregory Neil Shapiro	default, i.e., they will not contain "::".  For example, instead
595ab1f4a42SGregory Neil Shapiro	of ::1, it will be 0:0:0:0:0:0:0:1.  This permits a zero subnet
596ab1f4a42SGregory Neil Shapiro	to have a more specific match, such as different map entries for
597ab1f4a42SGregory Neil Shapiro	IPv6:0:0 vs IPv6:0.  This change requires that configuration
598ab1f4a42SGregory Neil Shapiro	data (including maps, files, classes, custom ruleset, etc.) must
599ab1f4a42SGregory Neil Shapiro	use the same format, so make certain such configuration data is
600ab1f4a42SGregory Neil Shapiro	upgrading.  As a very simple check search for patterns like
601ab1f4a42SGregory Neil Shapiro	'IPv6:[0-9a-fA-F:]*::' and 'IPv6::'.  To return to the old
602ab1f4a42SGregory Neil Shapiro	behavior, set the m4 option confUSE_COMPRESSED_IPV6_ADDRESSES or
603ab1f4a42SGregory Neil Shapiro	the cf option UseCompressedIPv6Addresses.
604ab1f4a42SGregory Neil Shapiro
605d1b06863SMark Murray20150630:
606d1b06863SMark Murray	The default kernel entropy-processing algorithm is now
607d1b06863SMark Murray	Fortuna, replacing Yarrow.
6086f78e390SSimon J. Gerraty
609d1b06863SMark Murray	Assuming you have 'device random' in your kernel config
610d1b06863SMark Murray	file, the configurations allow a kernel option to override
611d1b06863SMark Murray	this default. You may choose *ONE* of:
6126f78e390SSimon J. Gerraty
613d1b06863SMark Murray	options	RANDOM_YARROW	# Legacy /dev/random algorithm.
614d1b06863SMark Murray	options	RANDOM_DUMMY	# Blocking-only driver.
6156f78e390SSimon J. Gerraty
616d1b06863SMark Murray	If you have neither, you get Fortuna.  For most people,
617d1b06863SMark Murray	read no further, Fortuna will give a /dev/random that works
618d1b06863SMark Murray	like it always used to, and the difference will be irrelevant.
6196f78e390SSimon J. Gerraty
620d1b06863SMark Murray	If you remove 'device random', you get *NO* kernel-processed
62102dcb6e0SEitan Adler	entropy at all. This may be acceptable to folks building
622d1b06863SMark Murray	embedded systems, but has complications. Carry on reading,
623d1b06863SMark Murray	and it is assumed you know what you need.
624d1b06863SMark Murray
625d1b06863SMark Murray	*PLEASE* read random(4) and random(9) if you are in the
62602dcb6e0SEitan Adler	habit of tweaking kernel configs, and/or if you are a member
627d1b06863SMark Murray	of the embedded community, wanting specific and not-usual
628d1b06863SMark Murray	behaviour from your security subsystems.
629d1b06863SMark Murray
630d1b06863SMark Murray	NOTE!! If you use RANDOM_DUMMY and/or have no 'device
631d1b06863SMark Murray	random', you will NOT have a functioning /dev/random, and
632d1b06863SMark Murray	many cryptographic features will not work, including SSH.
633d1b06863SMark Murray	You may also find strange behaviour from the random(3) set
634d1b06863SMark Murray	of library functions, in particular sranddev(3), srandomdev(3)
635d1b06863SMark Murray	and arc4random(3). The reason for this is that the KERN_ARND
636d1b06863SMark Murray	sysctl only returns entropy if it thinks it has some to
637d1b06863SMark Murray	share, and with RANDOM_DUMMY or no 'device random' this
638d1b06863SMark Murray	will never happen.
639d1b06863SMark Murray
640e44053b7SGregory Neil Shapiro20150623:
641e44053b7SGregory Neil Shapiro	An additional fix for the issue described in the 20150614 sendmail
642e44053b7SGregory Neil Shapiro	entry below has been been committed in revision 284717.
6436f78e390SSimon J. Gerraty
6446f78e390SSimon J. Gerraty20150616:
64532c88b52SWarner Losh	FreeBSD's old make (fmake) has been removed from the system. It is
64632c88b52SWarner Losh	available as the devel/fmake port or via pkg install fmake.
64732c88b52SWarner Losh
6489c5682edSGregory Neil Shapiro20150615:
6499c5682edSGregory Neil Shapiro	The fix for the issue described in the 20150614 sendmail entry
6509c5682edSGregory Neil Shapiro	below has been been committed in revision 284436.  The work
6519c5682edSGregory Neil Shapiro	around described in that entry is no longer needed unless the
6529c5682edSGregory Neil Shapiro	default setting is overridden by a confDH_PARAMETERS configuration
6539c5682edSGregory Neil Shapiro	setting of '5' or pointing to a 512 bit DH parameter file.
6549c5682edSGregory Neil Shapiro
65522596424SGregory Neil Shapiro20150614:
65661099d9aSEnji Cooper	ALLOW_DEPRECATED_ATF_TOOLS/ATFFILE support has been removed from
65761099d9aSEnji Cooper	atf.test.mk (included from bsd.test.mk). Please upgrade devel/atf
65861099d9aSEnji Cooper	and devel/kyua to version 0.20+ and adjust any calling code to work
65961099d9aSEnji Cooper	with Kyuafile and kyua.
66061099d9aSEnji Cooper
66161099d9aSEnji Cooper20150614:
66222596424SGregory Neil Shapiro	The import of openssl to address the FreeBSD-SA-15:10.openssl
66322596424SGregory Neil Shapiro	security advisory includes a change which rejects handshakes
66422596424SGregory Neil Shapiro	with DH parameters below 768 bits.  sendmail releases prior
66522596424SGregory Neil Shapiro	to 8.15.2 (not yet released), defaulted to a 512 bit
66622596424SGregory Neil Shapiro	DH parameter setting for client connections.  To work around
66722596424SGregory Neil Shapiro	this interoperability, sendmail can be configured to use a
66822596424SGregory Neil Shapiro	2048 bit DH parameter by:
66922596424SGregory Neil Shapiro
67022596424SGregory Neil Shapiro	1. Edit /etc/mail/`hostname`.mc
67122596424SGregory Neil Shapiro	2. If a setting for confDH_PARAMETERS does not exist or
67222596424SGregory Neil Shapiro	   exists and is set to a string beginning with '5',
67322596424SGregory Neil Shapiro	   replace it with '2'.
67422596424SGregory Neil Shapiro	3. If a setting for confDH_PARAMETERS exists and is set to
67522596424SGregory Neil Shapiro	   a file path, create a new file with:
67622596424SGregory Neil Shapiro		openssl dhparam -out /path/to/file 2048
67722596424SGregory Neil Shapiro	4. Rebuild the .cf file:
67822596424SGregory Neil Shapiro		cd /etc/mail/; make; make install
67922596424SGregory Neil Shapiro	5. Restart sendmail:
68022596424SGregory Neil Shapiro		cd /etc/mail/; make restart
68122596424SGregory Neil Shapiro
68222596424SGregory Neil Shapiro	A sendmail patch is coming, at which time this file will be
68322596424SGregory Neil Shapiro	updated.
68422596424SGregory Neil Shapiro
685b8d08379SXin LI20150604:
686b8d08379SXin LI	Generation of legacy formatted entries have been disabled by default
687b8d08379SXin LI	in pwd_mkdb(8), as all base system consumers of the legacy formatted
688b8d08379SXin LI	entries were converted to use the new format by default when the new,
689b8d08379SXin LI	machine independent format have been added and supported since FreeBSD
690b8d08379SXin LI	5.x.
691b8d08379SXin LI
692b8d08379SXin LI	Please see the pwd_mkdb(8) manual page for further details.
693b8d08379SXin LI
694ef6fa9e2SDimitry Andric20150525:
695ef6fa9e2SDimitry Andric	Clang and llvm have been upgraded to 3.6.1 release.  Please see the
696ef6fa9e2SDimitry Andric	20141231 entry below for information about prerequisites and upgrading,
697ef6fa9e2SDimitry Andric	if you are not already using 3.5.0 or higher.
698ef6fa9e2SDimitry Andric
6995b03aba6SOleksandr Tymoshenko20150521:
7005b03aba6SOleksandr Tymoshenko	TI platform code switched to using vendor DTS files and this update
7015b03aba6SOleksandr Tymoshenko	may break existing systems running on Beaglebone, Beaglebone Black,
7025b03aba6SOleksandr Tymoshenko	and Pandaboard:
7035b03aba6SOleksandr Tymoshenko
7045b03aba6SOleksandr Tymoshenko	- dtb files should be regenerated/reinstalled. Filenames are the
7055b03aba6SOleksandr Tymoshenko	  same but content is different now
7065b03aba6SOleksandr Tymoshenko	- GPIO addressing was changed, now each GPIO bank (32 pins per bank)
7075b03aba6SOleksandr Tymoshenko	  has its own /dev/gpiocX device, e.g. pin 121 on /dev/gpioc0 in old
7085b03aba6SOleksandr Tymoshenko	  addressing scheme is now pin 25 on /dev/gpioc3.
7095b03aba6SOleksandr Tymoshenko	- Pandaboard: /etc/ttys should be updated, serial console device is
7105b03aba6SOleksandr Tymoshenko	  now /dev/ttyu2, not /dev/ttyu0
7115b03aba6SOleksandr Tymoshenko
71221fcca66SBaptiste Daroussin20150501:
71321fcca66SBaptiste Daroussin	soelim(1) from gnu/usr.bin/groff has been replaced by usr.bin/soelim.
71421fcca66SBaptiste Daroussin	If you need the GNU extension from groff soelim(1), install groff
71521fcca66SBaptiste Daroussin	from package: pkg install groff, or via ports: textproc/groff.
71621fcca66SBaptiste Daroussin
717eee7269fSSteven Hartland20150423:
718ad34caceSSteven Hartland	chmod, chflags, chown and chgrp now affect symlinks in -R mode as
719ad34caceSSteven Hartland	defined in symlink(7); previously symlinks were silently ignored.
720ad34caceSSteven Hartland
7211243a98eSTijl Coosemans20150415:
7221243a98eSTijl Coosemans	The const qualifier has been removed from iconv(3) to comply with
7231243a98eSTijl Coosemans	POSIX.  The ports tree is aware of this from r384038 onwards.
7241243a98eSTijl Coosemans
725757a876fSBrooks Davis20150416:
726757a876fSBrooks Davis	Libraries specified by LIBADD in Makefiles must have a corresponding
727757a876fSBrooks Davis	DPADD_<lib> variable to ensure correct dependencies.  This is now
728757a876fSBrooks Davis	enforced in src.libnames.mk.
729757a876fSBrooks Davis
730cdc58367SAlexander Motin20150324:
731cdc58367SAlexander Motin	From legacy ata(4) driver was removed support for SATA controllers
732cdc58367SAlexander Motin	supported by more functional drivers ahci(4), siis(4) and mvs(4).
733cdc58367SAlexander Motin	Kernel modules ataahci and ataadaptec were removed completely,
734cdc58367SAlexander Motin	replaced by ahci and mvs modules respectively.
735cdc58367SAlexander Motin
736302cd48aSDimitry Andric20150315:
73770aad3bfSDimitry Andric	Clang, llvm and lldb have been upgraded to 3.6.0 release.  Please see
73870aad3bfSDimitry Andric	the 20141231 entry below for information about prerequisites and
73970aad3bfSDimitry Andric	upgrading, if you are not already using 3.5.0 or higher.
7406ce3ca64SDimitry Andric
7415c845fdeSNathan Whitehorn20150307:
7425c845fdeSNathan Whitehorn	The 32-bit PowerPC kernel has been changed to a position-independent
7435c845fdeSNathan Whitehorn	executable. This can only be booted with a version of loader(8)
7445c845fdeSNathan Whitehorn	newer than January 31, 2015, so make sure to update both world and
7455c845fdeSNathan Whitehorn	kernel before rebooting.
7465c845fdeSNathan Whitehorn
747997707f4SJohn-Mark Gurney20150217:
748997707f4SJohn-Mark Gurney	If you are running a -CURRENT kernel since r273872 (Oct 30th, 2014),
74919442b85SXin LI	but before r278950, the RNG was not seeded properly.  Immediately
75019442b85SXin LI	upgrade the kernel to r278950 or later and regenerate any keys (e.g.
751997707f4SJohn-Mark Gurney	ssh keys or openssl keys) that were generated w/ a kernel from that
7524c25bba7SGavin Atkinson	range.  This does not affect programs that directly used /dev/random
7533a25555cSGlen Barber	or /dev/urandom.  All userland uses of arc4random(3) are affected.
754997707f4SJohn-Mark Gurney
75509cfaa45SEdward Tomasz Napierala20150210:
75609cfaa45SEdward Tomasz Napierala	The autofs(4) ABI was changed in order to restore binary compatibility
75709cfaa45SEdward Tomasz Napierala	with 10.1-RELEASE.  The automountd(8) daemon needs to be rebuilt to work
75809cfaa45SEdward Tomasz Napierala	with the new kernel.
75909cfaa45SEdward Tomasz Napierala
7600fa22505SNathan Whitehorn20150131:
7610fa22505SNathan Whitehorn	The powerpc64 kernel has been changed to a position-independent
7620fa22505SNathan Whitehorn	executable. This can only be booted with a new version of loader(8),
7630fa22505SNathan Whitehorn	so make sure to update both world and kernel before rebooting.
7640fa22505SNathan Whitehorn
7659cac79b3SDimitry Andric20150118:
7669cac79b3SDimitry Andric	Clang and llvm have been upgraded to 3.5.1 release.  This is a bugfix
7679cac79b3SDimitry Andric	only release, no new features have been added.  Please see the 20141231
7689cac79b3SDimitry Andric	entry below for information about prerequisites and upgrading, if you
7699cac79b3SDimitry Andric	are not already using 3.5.0.
7709cac79b3SDimitry Andric
771968d62e1SEd Maste20150107:
772968d62e1SEd Maste	ELF tools addr2line, elfcopy (strip), nm, size, and strings are now
773968d62e1SEd Maste	taken from the ELF Tool Chain project rather than GNU binutils. They
774968d62e1SEd Maste	should be drop-in replacements, with the addition of arm64 support.
775968d62e1SEd Maste	The WITHOUT_ELFTOOLCHAIN_TOOLS= knob may be used to obtain the
776f97aa232SEd Maste	binutils tools, if necessary. See 20150805 for updated information.
777968d62e1SEd Maste
778f1b3840cSDag-Erling Smørgrav20150105:
779f1b3840cSDag-Erling Smørgrav	The default Unbound configuration now enables remote control
780f1b3840cSDag-Erling Smørgrav	using a local socket.  Users who have already enabled the
781f1b3840cSDag-Erling Smørgrav	local_unbound service should regenerate their configuration
782f1b3840cSDag-Erling Smørgrav	by running "service local_unbound setup" as root.
783f1b3840cSDag-Erling Smørgrav
7842d281361SBaptiste Daroussin20150102:
7852d281361SBaptiste Daroussin	The GNU texinfo and GNU info pages have been removed.
7862d281361SBaptiste Daroussin	To be able to view GNU info pages please install texinfo from ports.
7872d281361SBaptiste Daroussin
788143c11b4SDimitry Andric20141231:
789143c11b4SDimitry Andric	Clang, llvm and lldb have been upgraded to 3.5.0 release.
790143c11b4SDimitry Andric
7910ac2c3d1SDimitry Andric	As of this release, a prerequisite for building clang, llvm and lldb is
7920ac2c3d1SDimitry Andric	a C++11 capable compiler and C++11 standard library.  This means that to
793143c11b4SDimitry Andric	be able to successfully build the cross-tools stage of buildworld, with
794143c11b4SDimitry Andric	clang as the bootstrap compiler, your system compiler or cross compiler
795143c11b4SDimitry Andric	should either be clang 3.3 or later, or gcc 4.8 or later, and your
796143c11b4SDimitry Andric	system C++ library should be libc++, or libdstdc++ from gcc 4.8 or
797143c11b4SDimitry Andric	later.
798143c11b4SDimitry Andric
7990ac2c3d1SDimitry Andric	On any standard FreeBSD 10.x or 11.x installation, where clang and
8000ac2c3d1SDimitry Andric	libc++ are on by default (that is, on x86 or arm), this should work out
8010ac2c3d1SDimitry Andric	of the box.
802143c11b4SDimitry Andric
803143c11b4SDimitry Andric	On 9.x installations where clang is enabled by default, e.g. on x86 and
804143c11b4SDimitry Andric	powerpc, libc++ will not be enabled by default, so libc++ should be
805143c11b4SDimitry Andric	built (with clang) and installed first.  If both clang and libc++ are
806143c11b4SDimitry Andric	missing, build clang first, then use it to build libc++.
807143c11b4SDimitry Andric
808143c11b4SDimitry Andric	On 8.x and earlier installations, upgrade to 9.x first, and then follow
809143c11b4SDimitry Andric	the instructions for 9.x above.
810143c11b4SDimitry Andric
8110ac2c3d1SDimitry Andric	Sparc64 and mips users are unaffected, as they still use gcc 4.2.1 by
8120ac2c3d1SDimitry Andric	default, and do not build clang.
8130ac2c3d1SDimitry Andric
8140ac2c3d1SDimitry Andric	Many embedded systems are resource constrained, and will not be able to
8150ac2c3d1SDimitry Andric	build clang in a reasonable time, or in some cases at all.  In those
8160ac2c3d1SDimitry Andric	cases, cross building bootable systems on amd64 is a workaround.
8170ac2c3d1SDimitry Andric
818143c11b4SDimitry Andric	This new version of clang introduces a number of new warnings, of which
819143c11b4SDimitry Andric	the following are most likely to appear:
820143c11b4SDimitry Andric
821143c11b4SDimitry Andric	-Wabsolute-value
822143c11b4SDimitry Andric
823143c11b4SDimitry Andric	This warns in two cases, for both C and C++:
824143c11b4SDimitry Andric	* When the code is trying to take the absolute value of an unsigned
825143c11b4SDimitry Andric	  quantity, which is effectively a no-op, and almost never what was
826143c11b4SDimitry Andric	  intended.  The code should be fixed, if at all possible.  If you are
827143c11b4SDimitry Andric	  sure that the unsigned quantity can be safely cast to signed, without
828143c11b4SDimitry Andric	  loss of information or undefined behavior, you can add an explicit
829143c11b4SDimitry Andric	  cast, or disable the warning.
830143c11b4SDimitry Andric
831143c11b4SDimitry Andric	* When the code is trying to take an absolute value, but the called
832143c11b4SDimitry Andric	  abs() variant is for the wrong type, which can lead to truncation.
833143c11b4SDimitry Andric	  If you want to disable the warning instead of fixing the code, please
834143c11b4SDimitry Andric	  make sure that truncation will not occur, or it might lead to unwanted
835143c11b4SDimitry Andric	  side-effects.
836143c11b4SDimitry Andric
837143c11b4SDimitry Andric	-Wtautological-undefined-compare and
838143c11b4SDimitry Andric	-Wundefined-bool-conversion
839143c11b4SDimitry Andric
840143c11b4SDimitry Andric	These warn when C++ code is trying to compare 'this' against NULL, while
841143c11b4SDimitry Andric	'this' should never be NULL in well-defined C++ code.  However, there is
842143c11b4SDimitry Andric	some legacy (pre C++11) code out there, which actively abuses this
843143c11b4SDimitry Andric	feature, which was less strictly defined in previous C++ versions.
844143c11b4SDimitry Andric
845143c11b4SDimitry Andric	Squid and openjdk do this, for example.  The warning can be turned off
846143c11b4SDimitry Andric	for C++98 and earlier, but compiling the code in C++11 mode might result
847143c11b4SDimitry Andric	in unexpected behavior; for example, the parts of the program that are
848143c11b4SDimitry Andric	unreachable could be optimized away.
849143c11b4SDimitry Andric
8500b327b63SRick Macklem20141222:
8510b327b63SRick Macklem	The old NFS client and server (kernel options NFSCLIENT, NFSSERVER)
8520b327b63SRick Macklem	kernel sources have been removed. The .h files remain, since some
8530b327b63SRick Macklem	utilities include them. This will need to be fixed later.
8540b327b63SRick Macklem	If "mount -t oldnfs ..." is attempted, it will fail.
8550b327b63SRick Macklem	If the "-o" option on mountd(8), nfsd(8) or nfsstat(1) is used,
8560b327b63SRick Macklem	the utilities will report errors.
8570b327b63SRick Macklem
8585f25ee9cSBrooks Davis20141121:
8595f25ee9cSBrooks Davis	The handling of LOCAL_LIB_DIRS has been altered to skip addition of
8605f25ee9cSBrooks Davis	directories to top level SUBDIR variable when their parent
8615f25ee9cSBrooks Davis	directory is included in LOCAL_DIRS.  Users with build systems with
8625f25ee9cSBrooks Davis	such hierarchies and without SUBDIR entries in the parent
8635f25ee9cSBrooks Davis	directory Makefiles should add them or add the directories to
8645f25ee9cSBrooks Davis	LOCAL_DIRS.
8655f25ee9cSBrooks Davis
866603eaf79SAlexander V. Chernikov20141109:
86774342541SChristian Brueffer	faith(4) and faithd(8) have been removed from the base system. Faith
868603eaf79SAlexander V. Chernikov	has been obsolete for a very long time.
869603eaf79SAlexander V. Chernikov
8702d6f6d63SJean-Sébastien Pédron20141104:
8712d6f6d63SJean-Sébastien Pédron	vt(4), the new console driver, is enabled by default. It brings
8722d6f6d63SJean-Sébastien Pédron	support for Unicode and double-width characters, as well as
8732d6f6d63SJean-Sébastien Pédron	support for UEFI and integration with the KMS kernel video
8742d6f6d63SJean-Sébastien Pédron	drivers.
8752d6f6d63SJean-Sébastien Pédron
8762d6f6d63SJean-Sébastien Pédron	You may need to update your console settings in /etc/rc.conf,
8772d6f6d63SJean-Sébastien Pédron	most probably the keymap. During boot, /etc/rc.d/syscons will
8782d6f6d63SJean-Sébastien Pédron	indicate what you need to do.
8792d6f6d63SJean-Sébastien Pédron
8802d6f6d63SJean-Sébastien Pédron	vt(4) still has issues and lacks some features compared to
8812d6f6d63SJean-Sébastien Pédron	syscons(4). See the wiki for up-to-date information:
8822d6f6d63SJean-Sébastien Pédron	  https://wiki.freebsd.org/Newcons
8832d6f6d63SJean-Sébastien Pédron
8842d6f6d63SJean-Sébastien Pédron	If you want to keep using syscons(4), you can do so by adding
8852d6f6d63SJean-Sébastien Pédron	the following line to /boot/loader.conf:
8862d6f6d63SJean-Sébastien Pédron	  kern.vty=sc
8872d6f6d63SJean-Sébastien Pédron
888fa809347SEnji Cooper20141102:
889fa809347SEnji Cooper	pjdfstest has been integrated into kyua as an opt-in test suite.
89074342541SChristian Brueffer	Please see share/doc/pjdfstest/README for more details on how to
891fa809347SEnji Cooper	execute it.
892fa809347SEnji Cooper
893ddd96d23SEd Maste20141009:
894ddd96d23SEd Maste	gperf has been removed from the base system for architectures
895ddd96d23SEd Maste	that use clang. Ports that require gperf will obtain it from the
896ddd96d23SEd Maste	devel/gperf port.
897ddd96d23SEd Maste
89840a8ac8fSEnji Cooper20140923:
89940a8ac8fSEnji Cooper	pjdfstest has been moved from tools/regression/pjdfstest to
90040a8ac8fSEnji Cooper	contrib/pjdfstest .
90140a8ac8fSEnji Cooper
902243d6a50SSean Bruno20140922:
903243d6a50SSean Bruno	At svn r271982, The default linux compat kernel ABI has been adjusted
904243d6a50SSean Bruno	to 2.6.18 in support of the linux-c6 compat ports infrastructure
905243d6a50SSean Bruno	update.  If you wish to continue using the linux-f10 compat ports,
906243d6a50SSean Bruno	add compat.linux.osrelease=2.6.16 to your local sysctl.conf.  Users are
907243d6a50SSean Bruno	encouraged to update their linux-compat packages to linux-c6 during
908243d6a50SSean Bruno	their next update cycle.
909243d6a50SSean Bruno
910232490c6SNathan Whitehorn20140729:
911232490c6SNathan Whitehorn	The ofwfb driver, used to provide a graphics console on PowerPC when
91274342541SChristian Brueffer	using vt(4), no longer allows mmap() of all physical memory. This
913232490c6SNathan Whitehorn	will prevent Xorg on PowerPC with some ATI graphics cards from
914232490c6SNathan Whitehorn	initializing properly unless x11-servers/xorg-server is updated to
915232490c6SNathan Whitehorn	1.12.4_8 or newer.
916232490c6SNathan Whitehorn
9170aafd404SWarner Losh20140723:
9180aafd404SWarner Losh	The xdev targets have been converted to using TARGET and
9190aafd404SWarner Losh	TARGET_ARCH instead of XDEV and XDEV_ARCH.
9200aafd404SWarner Losh
9210d0485e2SDag-Erling Smørgrav20140719:
9220d0485e2SDag-Erling Smørgrav	The default unbound configuration has been modified to address
9230d0485e2SDag-Erling Smørgrav	issues with reverse lookups on networks that use private
9240d0485e2SDag-Erling Smørgrav	address ranges.  If you use the local_unbound service, run
9250d0485e2SDag-Erling Smørgrav	"service local_unbound setup" as root to regenerate your
9260d0485e2SDag-Erling Smørgrav	configuration, then "service local_unbound reload" to load the
9270d0485e2SDag-Erling Smørgrav	new configuration.
9280d0485e2SDag-Erling Smørgrav
929f4717209SBaptiste Daroussin20140709:
930f4717209SBaptiste Daroussin	The GNU texinfo and GNU info pages are not built and installed
931f4717209SBaptiste Daroussin	anymore, WITH_INFO knob has been added to allow to built and install
932f4717209SBaptiste Daroussin	them again.
9332d281361SBaptiste Daroussin	UPDATE: see 20150102 entry on texinfo's removal
934f4717209SBaptiste Daroussin
9358a833bdaSBaptiste Daroussin20140708:
9368a833bdaSBaptiste Daroussin	The GNU readline library is now an INTERNALLIB - that is, it is
9378a833bdaSBaptiste Daroussin	statically linked into consumers (GDB and variants) in the base
9388a833bdaSBaptiste Daroussin	system, and the shared library is no longer installed.  The
9398a833bdaSBaptiste Daroussin	devel/readline port is available for third party software that
9408a833bdaSBaptiste Daroussin	requires readline.
9418a833bdaSBaptiste Daroussin
94250f73640SMarcel Moolenaar20140702:
94350f73640SMarcel Moolenaar	The Itanium architecture (ia64) has been removed from the list of
94450f73640SMarcel Moolenaar	known architectures. This is the first step in the removal of the
94550f73640SMarcel Moolenaar	architecture.
94650f73640SMarcel Moolenaar
94718aa7fccSRick Macklem20140701:
94818aa7fccSRick Macklem	Commit r268115 has added NFSv4.1 server support, merged from
94918aa7fccSRick Macklem	projects/nfsv4.1-server.  Since this includes changes to the
95018aa7fccSRick Macklem	internal interfaces between the NFS related modules, a full
95118aa7fccSRick Macklem	build of the kernel and modules will be necessary.
95218aa7fccSRick Macklem	__FreeBSD_version has been bumped.
95318aa7fccSRick Macklem
954824a9093SEd Maste20140629:
955824a9093SEd Maste	The WITHOUT_VT_SUPPORT kernel config knob has been renamed
956824a9093SEd Maste	WITHOUT_VT.  (The other _SUPPORT knobs have a consistent meaning
957824a9093SEd Maste	which differs from the behaviour controlled by this knob.)
958824a9093SEd Maste
95938b72f8cSAlexander Motin20140619:
96038b72f8cSAlexander Motin	Maximal length of the serial number in CTL was increased from 16 to
96138b72f8cSAlexander Motin	64 chars, that breaks ABI.  All CTL-related tools, such as ctladm
96238b72f8cSAlexander Motin	and ctld, need to be rebuilt to work with a new kernel.
96338b72f8cSAlexander Motin
964727a7ce8SJulio Merino20140606:
965727a7ce8SJulio Merino	The libatf-c and libatf-c++ major versions were downgraded to 0 and
966727a7ce8SJulio Merino	1 respectively to match the upstream numbers.  They were out of
967727a7ce8SJulio Merino	sync because, when they were originally added to FreeBSD, the
968727a7ce8SJulio Merino	upstream versions were not respected.  These libraries are private
969727a7ce8SJulio Merino	and not yet built by default, so renumbering them should be a
970727a7ce8SJulio Merino	non-issue.  However, unclean source trees will yield broken test
971727a7ce8SJulio Merino	programs once the operator executes "make delete-old-libs" after a
972727a7ce8SJulio Merino	"make installworld".
973727a7ce8SJulio Merino
9748c7ec47aSJulio Merino	Additionally, the atf-sh binary was made private by moving it into
9758c7ec47aSJulio Merino	/usr/libexec/.  Already-built shell test programs will keep the
9768c7ec47aSJulio Merino	path to the old binary so they will break after "make delete-old"
9778c7ec47aSJulio Merino	is run.
9788c7ec47aSJulio Merino
979727a7ce8SJulio Merino	If you are using WITH_TESTS=yes (not the default), wipe the object
980727a7ce8SJulio Merino	tree and rebuild from scratch to prevent spurious test failures.
9818c7ec47aSJulio Merino	This is only needed once: the misnumbered libraries and misplaced
9828c7ec47aSJulio Merino	binaries have been added to OptionalObsoleteFiles.inc so they will
9838c7ec47aSJulio Merino	be removed during a clean upgrade.
984727a7ce8SJulio Merino
98585d60e68SDimitry Andric20140512:
98685d60e68SDimitry Andric	Clang and llvm have been upgraded to 3.4.1 release.
98785d60e68SDimitry Andric
988fa114234SWarner Losh20140508:
989fa114234SWarner Losh	We bogusly installed src.opts.mk in /usr/share/mk. This file should
990fa114234SWarner Losh	be removed to avoid issues in the future (and has been added to
991fa114234SWarner Losh	ObsoleteFiles.inc).
992fa114234SWarner Losh
993a46954e2SWarner Losh20140505:
994a46954e2SWarner Losh	/etc/src.conf now affects only builds of the FreeBSD src tree. In the
995a46954e2SWarner Losh	past, it affected all builds that used the bsd.*.mk files. The old
996a46954e2SWarner Losh	behavior was a bug, but people may have relied upon it. To get this
997a46954e2SWarner Losh	behavior back, you can .include /etc/src.conf from /etc/make.conf
998a46954e2SWarner Losh	(which is still global and isn't changed). This also changes the
999a46954e2SWarner Losh	behavior of incremental builds inside the tree of individual
100059a24370SWarner Losh	directories. Set MAKESYSPATH to ".../share/mk" to do that.
1001a46954e2SWarner Losh	Although this has survived make universe and some upgrade scenarios,
100255b76981SWarner Losh	other upgrade scenarios may have broken. At least one form of
100355b76981SWarner Losh	temporary breakage was fixed with MAKESYSPATH settings for buildworld
100459a24370SWarner Losh	as well... In cases where MAKESYSPATH isn't working with this
100559a24370SWarner Losh	setting, you'll need to set it to the full path to your tree.
1006a46954e2SWarner Losh
1007bd871f14SWarner Losh	One side effect of all this cleaning up is that bsd.compiler.mk
1008bd871f14SWarner Losh	is no longer implicitly included by bsd.own.mk. If you wish to
1009bd871f14SWarner Losh	use COMPILER_TYPE, you must now explicitly include bsd.compiler.mk
1010bd871f14SWarner Losh	as well.
1011bd871f14SWarner Losh
1012461dbce2SEitan Adler20140430:
1013461dbce2SEitan Adler	The lindev device has been removed since /dev/full has been made a
1014461dbce2SEitan Adler	standard device.  __FreeBSD_version has been bumped.
1015461dbce2SEitan Adler
1016e9aba509SEnji Cooper20140424:
1017e9aba509SEnji Cooper	The knob WITHOUT_VI was added to the base system, which controls
1018e9aba509SEnji Cooper	building ex(1), vi(1), etc. Older releases of FreeBSD required ex(1)
1019e9aba509SEnji Cooper	in order to reorder files share/termcap and didn't build ex(1) as a
1020e9aba509SEnji Cooper	build tool, so building/installing with WITH_VI is highly advised for
1021e9aba509SEnji Cooper	build hosts for older releases.
1022e9aba509SEnji Cooper
1023e9aba509SEnji Cooper	This issue has been fixed in stable/9 and stable/10 in r277022 and
1024e9aba509SEnji Cooper	r276991, respectively.
1025e9aba509SEnji Cooper
10262bb08298SWarner Losh20140418:
10272bb08298SWarner Losh	The YES_HESIOD knob has been removed. It has been obsolete for
10282bb08298SWarner Losh	a decade. Please move to using WITH_HESIOD instead or your builds
10292bb08298SWarner Losh	will silently lack HESIOD.
10302bb08298SWarner Losh
10314c710b67SMarcel Moolenaar20140405:
10324c710b67SMarcel Moolenaar	The uart(4) driver has been changed with respect to its handling
10334c710b67SMarcel Moolenaar	of the low-level console. Previously the uart(4) driver prevented
10344c710b67SMarcel Moolenaar	any process from changing the baudrate or the CLOCAL and HUPCL
10354c710b67SMarcel Moolenaar	control flags. By removing the restrictions, operators can make
10364c710b67SMarcel Moolenaar	changes to the serial console port without having to reboot.
10374c710b67SMarcel Moolenaar	However, when getty(8) is started on the serial device that is
10384c710b67SMarcel Moolenaar	associated with the low-level console, a misconfigured terminal
10394c710b67SMarcel Moolenaar	line in /etc/ttys will now have a real impact.
10404c710b67SMarcel Moolenaar	Before upgrading the kernel, make sure that /etc/ttys has the
10414c710b67SMarcel Moolenaar	serial console device configured as 3wire without baudrate to
1042086036aaSMarcel Moolenaar	preserve the previous behaviour. E.g:
10434c710b67SMarcel Moolenaar	    ttyu0  "/usr/libexec/getty 3wire"  vt100  on  secure
10444c710b67SMarcel Moolenaar
1045ea9ed3d8SAlexander Motin20140306:
1046ea9ed3d8SAlexander Motin	Support for libwrap (TCP wrappers) in rpcbind was disabled by default
1047ea9ed3d8SAlexander Motin	to improve performance.  To re-enable it, if needed, run rpcbind
1048ea9ed3d8SAlexander Motin	with command line option -W.
1049ea9ed3d8SAlexander Motin
1050a9fd2218SWarner Losh20140226:
1051a9fd2218SWarner Losh	Switched back to the GPL dtc compiler due to updates in the upstream
1052a9fd2218SWarner Losh	dts files not being supported by the BSDL dtc compiler. You will need
1053a9fd2218SWarner Losh	to rebuild your kernel toolchain to pick up the new compiler. Core dumps
1054a9fd2218SWarner Losh	may result while building dtb files during a kernel build if you fail
1055a9fd2218SWarner Losh	to do so. Set WITHOUT_GPL_DTC if you require the BSDL compiler.
1056a9fd2218SWarner Losh
10578de08345SChristian Brueffer20140216:
10583ad1a091SWarner Losh	Clang and llvm have been upgraded to 3.4 release.
10593ad1a091SWarner Losh
1060f785676fSDimitry Andric20140216:
10618de08345SChristian Brueffer	The nve(4) driver has been removed.  Please use the nfe(4) driver
10628de08345SChristian Brueffer	for NVIDIA nForce MCP Ethernet adapters instead.
10638de08345SChristian Brueffer
10649f23d19aSDimitry Andric20140212:
10659f23d19aSDimitry Andric	An ABI incompatibility crept into the libc++ 3.4 import in r261283.
10669f23d19aSDimitry Andric	This could cause certain C++ applications using shared libraries built
10679f23d19aSDimitry Andric	against the previous version of libc++ to crash.  The incompatibility
10689f23d19aSDimitry Andric	has now been fixed, but any C++ applications or shared libraries built
10699f23d19aSDimitry Andric	between r261283 and r261801 should be recompiled.
10709f23d19aSDimitry Andric
10715e4b8b0dSXin LI20140204:
10725e4b8b0dSXin LI	OpenSSH will now ignore errors caused by kernel lacking of Capsicum
10735e4b8b0dSXin LI	capability mode support.  Please note that enabling the feature in
10745e4b8b0dSXin LI	kernel is still highly recommended.
10755e4b8b0dSXin LI
10765e4b8b0dSXin LI20140131:
10775e4b8b0dSXin LI	OpenSSH is now built with sandbox support, and will use sandbox as
10785e4b8b0dSXin LI	the default privilege separation method.  This requires Capsicum
10795e4b8b0dSXin LI	capability mode support in kernel.
10805e4b8b0dSXin LI
1081d1166b82SKai Wang20140128:
10822e503d34SKai Wang	The libelf and libdwarf libraries have been updated to newer
10832e503d34SKai Wang	versions from upstream. Shared library version numbers for
10842e503d34SKai Wang	these two libraries were bumped. Any ports or binaries
10852e503d34SKai Wang	requiring these two libraries should be recompiled.
10862e503d34SKai Wang	__FreeBSD_version is bumped to 1100006.
10872e503d34SKai Wang
1088d7efee23SJulio Merino20140110:
1089d7efee23SJulio Merino	If a Makefile in a tests/ directory was auto-generating a Kyuafile
1090d7efee23SJulio Merino	instead of providing an explicit one, this would prevent such
1091d7efee23SJulio Merino	Makefile from providing its own Kyuafile in the future during
1092d7efee23SJulio Merino	NO_CLEAN builds.  This has been fixed in the Makefiles but manual
1093d7efee23SJulio Merino	intervention is needed to clean an objdir if you use NO_CLEAN:
1094d7efee23SJulio Merino	  # find /usr/obj -name Kyuafile | xargs rm -f
1095d7efee23SJulio Merino
10962773bfa9SBenjamin Kaduk20131213:
10972773bfa9SBenjamin Kaduk	The behavior of gss_pseudo_random() for the krb5 mechanism
10982773bfa9SBenjamin Kaduk	has changed, for applications requesting a longer random string
10992773bfa9SBenjamin Kaduk	than produced by the underlying enctype's pseudo-random() function.
11002773bfa9SBenjamin Kaduk	In particular, the random string produced from a session key of
11012773bfa9SBenjamin Kaduk	enctype aes256-cts-hmac-sha1-96 or aes256-cts-hmac-sha1-96 will
11022773bfa9SBenjamin Kaduk	be different at the 17th octet and later, after this change.
11032773bfa9SBenjamin Kaduk	The counter used in the PRF+ construction is now encoded as a
11042773bfa9SBenjamin Kaduk	big-endian integer in accordance with RFC 4402.
11052773bfa9SBenjamin Kaduk	__FreeBSD_version is bumped to 1100004.
11062773bfa9SBenjamin Kaduk
1107e01d128aSJulio Merino20131108:
1108e01d128aSJulio Merino	The WITHOUT_ATF build knob has been removed and its functionality
1109e01d128aSJulio Merino	has been subsumed into the more generic WITHOUT_TESTS.  If you were
1110e01d128aSJulio Merino	using the former to disable the build of the ATF libraries, you
1111e01d128aSJulio Merino	should change your settings to use the latter.
1112e01d128aSJulio Merino
1113b9cd6b0aSBrooks Davis20131025:
1114b9cd6b0aSBrooks Davis	The default version of mtree is nmtree which is obtained from
1115b9cd6b0aSBrooks Davis	NetBSD.  The output is generally the same, but may vary
1116b9cd6b0aSBrooks Davis	slightly.  If you found you need identical output adding
1117b9cd6b0aSBrooks Davis	"-F freebsd9" to the command line should do the trick.  For the
1118b9cd6b0aSBrooks Davis	time being, the old mtree is available as fmtree.
1119b9cd6b0aSBrooks Davis
1120e3ededfaSBryan Drewery20131014:
1121e3ededfaSBryan Drewery	libbsdyml has been renamed to libyaml and moved to /usr/lib/private.
1122e3ededfaSBryan Drewery	This will break ports-mgmt/pkg. Rebuild the port, or upgrade to pkg
1123e3ededfaSBryan Drewery	1.1.4_8 and verify bsdyml not linked in, before running "make
1124e3ededfaSBryan Drewery	delete-old-libs":
1125e3ededfaSBryan Drewery	  # make -C /usr/ports/ports-mgmt/pkg build deinstall install clean
1126e3ededfaSBryan Drewery	  or
1127e3ededfaSBryan Drewery	  # pkg install pkg; ldd /usr/local/sbin/pkg | grep bsdyml
1128e3ededfaSBryan Drewery
112984b354cbSHiroki Sato20131010:
11309c80b8aaSWarner Losh	The stable/10 branch has been created in subversion from head
11319c80b8aaSWarner Losh	revision r256279.
11329c80b8aaSWarner Losh
11339c80b8aaSWarner Losh20131010:
113484b354cbSHiroki Sato	The rc.d/jail script has been updated to support jail(8)
113584b354cbSHiroki Sato	configuration file.  The "jail_<jname>_*" rc.conf(5) variables
113684b354cbSHiroki Sato	for per-jail configuration are automatically converted to
113784b354cbSHiroki Sato	/var/run/jail.<jname>.conf before the jail(8) utility is invoked.
113884b354cbSHiroki Sato	This is transparently backward compatible.  See below about some
113984b354cbSHiroki Sato	incompatibilities and rc.conf(5) manual page for more details.
114084b354cbSHiroki Sato
114184b354cbSHiroki Sato	These variables are now deprecated in favor of jail(8) configuration
114284b354cbSHiroki Sato	file.  One can use "rc.d/jail config <jname>" command to generate
114384b354cbSHiroki Sato	a jail(8) configuration file in /var/run/jail.<jname>.conf without
114484b354cbSHiroki Sato	running the jail(8) utility.   The default pathname of the
114584b354cbSHiroki Sato	configuration file is /etc/jail.conf and can be specified by
114684b354cbSHiroki Sato	using $jail_conf or $jail_<jname>_conf variables.
114784b354cbSHiroki Sato
114884b354cbSHiroki Sato	Please note that jail_devfs_ruleset accepts an integer at
114984b354cbSHiroki Sato	this moment.  Please consider to rewrite the ruleset name
115084b354cbSHiroki Sato	with an integer.
115184b354cbSHiroki Sato
11522d69252aSDag-Erling Smørgrav20130930:
11532d69252aSDag-Erling Smørgrav	BIND has been removed from the base system.  If all you need
11542d69252aSDag-Erling Smørgrav	is a local resolver, simply enable and start the local_unbound
11552d69252aSDag-Erling Smørgrav	service instead.  Otherwise, several versions of BIND are
11568a65c0b9SCraig Rodrigues	available in the ports tree.   The dns/bind99 port is one example.
11578a65c0b9SCraig Rodrigues
11588a65c0b9SCraig Rodrigues	With this change, nslookup(1) and dig(1) are no longer in the base
1159edc144a1SCraig Rodrigues	system.  Users should instead use host(1) and drill(1) which are
11608a65c0b9SCraig Rodrigues	in the base system.  Alternatively, nslookup and dig can
11618a65c0b9SCraig Rodrigues	be obtained by installing the dns/bind-tools port.
11622d69252aSDag-Erling Smørgrav
1163665751ecSGlen Barber20130916:
1164665751ecSGlen Barber	With the addition of unbound(8), a new unbound user is now
1165665751ecSGlen Barber	required during installworld.  "mergemaster -p" can be used to
1166665751ecSGlen Barber	add the user prior to installworld, as documented in the handbook.
1167665751ecSGlen Barber
1168bd8277b4SDag-Erling Smørgrav20130911:
1169bd8277b4SDag-Erling Smørgrav	OpenSSH is now built with DNSSEC support, and will by default
1170bd8277b4SDag-Erling Smørgrav	silently trust signed SSHFP records.  This can be controlled with
1171bd8277b4SDag-Erling Smørgrav	the VerifyHostKeyDNS client configuration setting.  DNSSEC support
1172bd8277b4SDag-Erling Smørgrav	can be disabled entirely with the WITHOUT_LDNS option in src.conf.
1173bd8277b4SDag-Erling Smørgrav
1174d6d3e03eSDavid Chisnall20130906:
1175d6d3e03eSDavid Chisnall	The GNU Compiler Collection and C++ standard library (libstdc++)
1176d6d3e03eSDavid Chisnall	are no longer built by default on platforms where clang is the system
1177d6d3e03eSDavid Chisnall	compiler.  You can enable them with the WITH_GCC and WITH_GNUCXX
1178d6d3e03eSDavid Chisnall	options in src.conf.
1179d6d3e03eSDavid Chisnall
11804877522eSPawel Jakub Dawidek20130905:
11812057b58bSPawel Jakub Dawidek	The PROCDESC kernel option is now part of the GENERIC kernel
11822057b58bSPawel Jakub Dawidek	configuration and is required for the rwhod(8) to work.
11832057b58bSPawel Jakub Dawidek	If you are using custom kernel configuration, you should include
11842057b58bSPawel Jakub Dawidek	'options PROCDESC'.
11852057b58bSPawel Jakub Dawidek
11862057b58bSPawel Jakub Dawidek20130905:
11874877522eSPawel Jakub Dawidek	The API and ABI related to the Capsicum framework was modified
11884877522eSPawel Jakub Dawidek	in backward incompatible way. The userland libraries and programs
11894877522eSPawel Jakub Dawidek	have to be recompiled to work with the new kernel. This includes the
11904877522eSPawel Jakub Dawidek	following libraries and programs, but the whole buildworld is
11914877522eSPawel Jakub Dawidek	advised: libc, libprocstat, dhclient, tcpdump, hastd, hastctl,
11924877522eSPawel Jakub Dawidek	kdump, procstat, rwho, rwhod, uniq.
11934877522eSPawel Jakub Dawidek
1194c8a84c2aSJohn-Mark Gurney20130903:
1195c8a84c2aSJohn-Mark Gurney	AES-NI intrinsic support has been added to gcc.  The AES-NI module
1196c8a84c2aSJohn-Mark Gurney	has been updated to use this support.  A new gcc is required to build
1197c8a84c2aSJohn-Mark Gurney	the aesni module on both i386 and amd64.
1198c8a84c2aSJohn-Mark Gurney
119946be218dSDavid E. O'Brien20130821:
120046be218dSDavid E. O'Brien	The PADLOCK_RNG and RDRAND_RNG kernel options are now devices.
120146be218dSDavid E. O'Brien	Thus "device padlock_rng" and "device rdrand_rng" should be
120246be218dSDavid E. O'Brien	used instead of "options PADLOCK_RNG" & "options RDRAND_RNG".
120346be218dSDavid E. O'Brien
12040ff204bbSPeter Wemm20130813:
12050ff204bbSPeter Wemm	WITH_ICONV has been split into two feature sets.  WITH_ICONV now
12060ff204bbSPeter Wemm	enables just the iconv* functionality and is now on by default.
12070ff204bbSPeter Wemm	WITH_LIBICONV_COMPAT enables the libiconv api and link time
1208a1ff7af0SPedro F. Giffuni	compatibility.  Set WITHOUT_ICONV to build the old way.
12090dc59c0fSPeter Wemm	If you have been using WITH_ICONV before, you will very likely
12100dc59c0fSPeter Wemm	need to turn on WITH_LIBICONV_COMPAT.
12110ff204bbSPeter Wemm
1212ccc88f7bSHiroki Sato20130806:
1213c319ea15SAndriy Gapon	INVARIANTS option now enables DEBUG for code with OpenSolaris and
1214c319ea15SAndriy Gapon	Illumos origin, including ZFS.  If you have INVARIANTS in your
1215c319ea15SAndriy Gapon	kernel configuration, then there is no need to set DEBUG or ZFS_DEBUG
1216c319ea15SAndriy Gapon	explicitly.
1217c319ea15SAndriy Gapon	DEBUG used to enable witness(9) tracking of OpenSolaris (mostly ZFS)
1218c319ea15SAndriy Gapon	locks if WITNESS option was set.  Because that generated a lot of
1219c319ea15SAndriy Gapon	witness(9) reports and all of them were believed to be false
1220c319ea15SAndriy Gapon	positives, this is no longer done.  New option OPENSOLARIS_WITNESS
1221c319ea15SAndriy Gapon	can be used to achieve the previous behavior.
1222c319ea15SAndriy Gapon
1223c319ea15SAndriy Gapon20130806:
1224ccc88f7bSHiroki Sato	Timer values in IPv6 data structures now use time_uptime instead
1225ccc88f7bSHiroki Sato	of time_second.  Although this is not a user-visible functional
1226ccc88f7bSHiroki Sato	change, userland utilities which directly use them---ndp(8),
1227ccc88f7bSHiroki Sato	rtadvd(8), and rtsold(8) in the base system---need to be updated
1228ccc88f7bSHiroki Sato	to r253970 or later.
1229ccc88f7bSHiroki Sato
12309d6d5a71SJilles Tjoelker20130802:
12319d6d5a71SJilles Tjoelker	find -delete can now delete the pathnames given as arguments,
12329d6d5a71SJilles Tjoelker	instead of only files found below them or if the pathname did
12339d6d5a71SJilles Tjoelker	not contain any slashes. Formerly, the following error message
12349d6d5a71SJilles Tjoelker	would result:
12359d6d5a71SJilles Tjoelker
12369d6d5a71SJilles Tjoelker	find: -delete: <path>: relative path potentially not safe
12379d6d5a71SJilles Tjoelker
12389d6d5a71SJilles Tjoelker	Deleting the pathnames given as arguments can be prevented
12399d6d5a71SJilles Tjoelker	without error messages using -mindepth 1 or by changing
12409d6d5a71SJilles Tjoelker	directory and passing "." as argument to find. This works in the
12419d6d5a71SJilles Tjoelker	old as well as the new version of find.
12429d6d5a71SJilles Tjoelker
1243663dea3dSAndriy Gapon20130726:
1244663dea3dSAndriy Gapon	Behavior of devfs rules path matching has been changed.
1245663dea3dSAndriy Gapon	Pattern is now always matched against fully qualified devfs
1246663dea3dSAndriy Gapon	path and slash characters must be explicitly matched by
1247663dea3dSAndriy Gapon	slashes in pattern (FNM_PATHNAME). Rulesets involving devfs
1248663dea3dSAndriy Gapon	subdirectories must be reviewed.
1249663dea3dSAndriy Gapon
125046e95f64SAndrew Turner20130716:
125146e95f64SAndrew Turner	The default ARM ABI has changed to the ARM EABI. The old ABI is
125246e95f64SAndrew Turner	incompatible with the ARM EABI and all programs and modules will
125346e95f64SAndrew Turner	need to be rebuilt to work with a new kernel.
125446e95f64SAndrew Turner
125546e95f64SAndrew Turner	To keep using the old ABI ensure the WITHOUT_ARM_EABI knob is set.
125646e95f64SAndrew Turner
125746e95f64SAndrew Turner	NOTE: Support for the old ABI will be removed in the future and
125846e95f64SAndrew Turner	users are advised to upgrade.
125946e95f64SAndrew Turner
1260b40e2b6dSAndrey V. Elsukov20130709:
12619b953f2cSBaptiste Daroussin	pkg_install has been disconnected from the build if you really need it
12629b953f2cSBaptiste Daroussin	you should add WITH_PKGTOOLS in your src.conf(5).
12639b953f2cSBaptiste Daroussin
12649b953f2cSBaptiste Daroussin20130709:
1265b40e2b6dSAndrey V. Elsukov	Most of network statistics structures were changed to be able
1266b40e2b6dSAndrey V. Elsukov	keep 64-bits counters. Thus all tools, that work with networking
1267aa011413SRui Paulo	statistics, must be rebuilt (netstat(1), bsnmpd(1), etc.)
1268b40e2b6dSAndrey V. Elsukov
12695b3e0257SDag-Erling Smørgrav20130618:
12705b3e0257SDag-Erling Smørgrav	Fix a bug that allowed a tracing process (e.g. gdb) to write
12715b3e0257SDag-Erling Smørgrav	to a memory-mapped file in the traced process's address space
12725b3e0257SDag-Erling Smørgrav	even if neither the traced process nor the tracing process had
12735b3e0257SDag-Erling Smørgrav	write access to that file.
12745b3e0257SDag-Erling Smørgrav
12751cbff2a9SEitan Adler20130615:
12761cbff2a9SEitan Adler	CVS has been removed from the base system.  An exact copy
12771cbff2a9SEitan Adler	of the code is available from the devel/cvs port.
12781cbff2a9SEitan Adler
1279ba10b444SSimon J. Gerraty20130613:
1280ba10b444SSimon J. Gerraty	Some people report the following error after the switch to bmake:
1281ba10b444SSimon J. Gerraty
1282ba10b444SSimon J. Gerraty		make: illegal option -- J
1283ba10b444SSimon J. Gerraty		usage: make [-BPSXeiknpqrstv] [-C directory] [-D variable]
1284ba10b444SSimon J. Gerraty			...
1285ba10b444SSimon J. Gerraty		*** [buildworld] Error code 2
1286ba10b444SSimon J. Gerraty
1287ba10b444SSimon J. Gerraty	this likely due to an old instance of make in
1288ba10b444SSimon J. Gerraty	${MAKEPATH} (${MAKEOBJDIRPREFIX}${.CURDIR}/make.${MACHINE})
1289ba10b444SSimon J. Gerraty	which src/Makefile will use that blindly, if it exists, so if
1290ba10b444SSimon J. Gerraty	you see the above error:
1291ba10b444SSimon J. Gerraty
1292ba10b444SSimon J. Gerraty		rm -rf `make -V MAKEPATH`
1293ba10b444SSimon J. Gerraty
1294ba10b444SSimon J. Gerraty	should resolve it.
1295ba10b444SSimon J. Gerraty
1296ff8d4375SSimon J. Gerraty20130516:
1297ff8d4375SSimon J. Gerraty	Use bmake by default.
1298ff8d4375SSimon J. Gerraty	Whereas before one could choose to build with bmake via
1299ff8d4375SSimon J. Gerraty	-DWITH_BMAKE one must now use -DWITHOUT_BMAKE to use the old
1300ff8d4375SSimon J. Gerraty	make. The goal is to remove these knobs for 10-RELEASE.
1301ff8d4375SSimon J. Gerraty
1302ff8d4375SSimon J. Gerraty	It is worth noting that bmake (like gmake) treats the command
1303ff8d4375SSimon J. Gerraty	line as the unit of failure, rather than statements within the
1304ff8d4375SSimon J. Gerraty	command line.  Thus '(cd some/where && dosomething)' is safer
1305ff8d4375SSimon J. Gerraty	than 'cd some/where; dosomething'. The '()' allows consistent
1306ff8d4375SSimon J. Gerraty	behavior in parallel build.
1307ff8d4375SSimon J. Gerraty
130832164d53SDag-Erling Smørgrav20130429:
130932164d53SDag-Erling Smørgrav	Fix a bug that allows NFS clients to issue READDIR on files.
131032164d53SDag-Erling Smørgrav
1311562a9d58SSteven Hartland20130426:
1312850163e4SEitan Adler	The WITHOUT_IDEA option has been removed because
1313850163e4SEitan Adler	the IDEA patent expired.
1314850163e4SEitan Adler
1315850163e4SEitan Adler20130426:
1316562a9d58SSteven Hartland	The sysctl which controls TRIM support under ZFS has been renamed
1317562a9d58SSteven Hartland	from vfs.zfs.trim_disable -> vfs.zfs.trim.enabled and has been
1318562a9d58SSteven Hartland	enabled by default.
1319562a9d58SSteven Hartland
132020e0cc0aSBrooks Davis20130425:
132120e0cc0aSBrooks Davis	The mergemaster command now uses the default MAKEOBJDIRPREFIX
132220e0cc0aSBrooks Davis	rather than creating it's own in the temporary directory in
132320e0cc0aSBrooks Davis	order allow access to bootstrapped versions of tools such as
132420e0cc0aSBrooks Davis	install and mtree.  When upgrading from version of FreeBSD where
132520e0cc0aSBrooks Davis	the install command does not support -l, you will need to
132620e0cc0aSBrooks Davis	install a new mergemaster command if mergemaster -p is required.
132720e0cc0aSBrooks Davis	This can be accomplished with the command (cd src/usr.sbin/mergemaster
132820e0cc0aSBrooks Davis	&& make install).
132920e0cc0aSBrooks Davis
13309a95a7caSAlexander Motin20130404:
13319a95a7caSAlexander Motin	Legacy ATA stack, disabled and replaced by new CAM-based one since
13329a95a7caSAlexander Motin	FreeBSD 9.0, completely removed from the sources.  Kernel modules
13339a95a7caSAlexander Motin	atadisk and atapi*, user-level tools atacontrol and burncd are
13349a95a7caSAlexander Motin	removed.  Kernel option `options ATA_CAM` is now permanently enabled
13359a95a7caSAlexander Motin	and removed.
13369a95a7caSAlexander Motin
13375ad7e649SJilles Tjoelker20130319:
13385ad7e649SJilles Tjoelker	SOCK_CLOEXEC and SOCK_NONBLOCK flags have been added to socket(2)
13395ad7e649SJilles Tjoelker	and socketpair(2). Software, in particular Kerberos, may
13405ad7e649SJilles Tjoelker	automatically detect and use these during building. The resulting
13415ad7e649SJilles Tjoelker	binaries will not work on older kernels.
13425ad7e649SJilles Tjoelker
1343105421ffSMarius Strobl20130308:
1344105421ffSMarius Strobl	CTL_DISABLE has also been added to the sparc64 GENERIC (for further
1345105421ffSMarius Strobl	information, see the respective 20130304 entry).
1346105421ffSMarius Strobl
13473a45b478SKenneth D. Merry20130304:
134823d44ab5SDavide Italiano	Recent commits to callout(9) changed the size of struct callout,
134923d44ab5SDavide Italiano	so the KBI is probably heavily disturbed. Also, some functions
135023d44ab5SDavide Italiano	in callout(9)/sleep(9)/sleepqueue(9)/condvar(9) KPIs were replaced
135123d44ab5SDavide Italiano	by macros. Every kernel module using it won't load, so rebuild
135223d44ab5SDavide Italiano	is requested.
135323d44ab5SDavide Italiano
13543a45b478SKenneth D. Merry	The ctl device has been re-enabled in GENERIC for i386 and amd64,
13553a45b478SKenneth D. Merry	but does not initialize by default (because of the new CTL_DISABLE
13563a45b478SKenneth D. Merry	option) to save memory.  To re-enable it, remove the CTL_DISABLE
13573a45b478SKenneth D. Merry	option from the kernel config file or set kern.cam.ctl.disable=0
13583a45b478SKenneth D. Merry	in /boot/loader.conf.
13593a45b478SKenneth D. Merry
1360fe138cc2SAdrian Chadd20130301:
1361fe138cc2SAdrian Chadd	The ctl device has been disabled in GENERIC for i386 and amd64.
1362fe138cc2SAdrian Chadd	This was done due to the extra memory being allocated at system
1363fe138cc2SAdrian Chadd	initialisation time by the ctl driver which was only used if
1364fe138cc2SAdrian Chadd	a CAM target device was created.  This makes a FreeBSD system
1365fe138cc2SAdrian Chadd	unusable on 128MB or less of RAM.
1366fe138cc2SAdrian Chadd
136720a011d5SXin LI20130208:
136820a011d5SXin LI	A new compression method (lz4) has been merged to -HEAD.  Please
136920a011d5SXin LI	refer to zpool-features(7) for more information.
137020a011d5SXin LI
137120a011d5SXin LI	Please refer to the "ZFS notes" section of this file for information
137220a011d5SXin LI	on upgrading boot ZFS pools.
137320a011d5SXin LI
13742dd076b8SGabor Kovesdan20130129:
13752dd076b8SGabor Kovesdan	A BSD-licensed patch(1) variant has been added and is installed
13762dd076b8SGabor Kovesdan	as bsdpatch, being the GNU version the default patch.
13772dd076b8SGabor Kovesdan	To inverse the logic and use the BSD-licensed one as default,
13782dd076b8SGabor Kovesdan	while having the GNU version installed as gnupatch, rebuild
13792d329593SGabor Kovesdan	and install world with the WITH_BSD_PATCH knob set.
13802dd076b8SGabor Kovesdan
1381fe06cae7SBrooks Davis20130121:
1382fe06cae7SBrooks Davis	Due to the use of the new -l option to install(1) during build
1383fe06cae7SBrooks Davis	and install, you must take care not to directly set the INSTALL
1384fe06cae7SBrooks Davis	make variable in your /etc/make.conf, /etc/src.conf, or on the
13858c5836c3SEitan Adler	command line.  If you wish to use the -C flag for all installs
1386fe06cae7SBrooks Davis	you may be able to add INSTALL+=-C to /etc/make.conf or
1387fe06cae7SBrooks Davis	/etc/src.conf.
1388fe06cae7SBrooks Davis
1389f2b19f9eSBrooks Davis20130118:
1390f2b19f9eSBrooks Davis	The install(1) option -M has changed meaning and now takes an
1391f2b19f9eSBrooks Davis	argument that is a file or path to append logs to.  In the
1392f2b19f9eSBrooks Davis	unlikely event that -M was the last option on the command line
1393f2b19f9eSBrooks Davis	and the command line contained at least two files and a target
1394f2b19f9eSBrooks Davis	directory the first file will have logs appended to it.  The -M
13954cf5de80SGlen Barber	option served little practical purpose in the last decade so its
13964cf5de80SGlen Barber	use is expected to be extremely rare.
1397f2b19f9eSBrooks Davis
13983fea4e6bSAndriy Gapon20121223:
13993fea4e6bSAndriy Gapon	After switching to Clang as the default compiler some users of ZFS
14003fea4e6bSAndriy Gapon	on i386 systems started to experience stack overflow kernel panics.
14013fea4e6bSAndriy Gapon	Please consider using 'options KSTACK_PAGES=4' in such configurations.
14023fea4e6bSAndriy Gapon
1403efec959cSJaakko Heinonen20121222:
1404efec959cSJaakko Heinonen	GEOM_LABEL now mangles label names read from file system metadata.
1405efec959cSJaakko Heinonen	Mangling affect labels containing spaces, non-printable characters,
1406efec959cSJaakko Heinonen	'%' or '"'. Device names in /etc/fstab and other places may need to
1407efec959cSJaakko Heinonen	be updated.
1408efec959cSJaakko Heinonen
140911631ad0SPawel Jakub Dawidek20121217:
141011631ad0SPawel Jakub Dawidek	By default, only the 10 most recent kernel dumps will be saved.  To
141111631ad0SPawel Jakub Dawidek	restore the previous behaviour (no limit on the number of kernel dumps
141211631ad0SPawel Jakub Dawidek	stored in the dump directory) add the following line to /etc/rc.conf:
141311631ad0SPawel Jakub Dawidek
141411631ad0SPawel Jakub Dawidek		savecore_flags=""
141511631ad0SPawel Jakub Dawidek
1416e0fb6dc3SRobert Watson20121201:
1417e0fb6dc3SRobert Watson	With the addition of auditdistd(8), a new auditdistd user is now
14180312d1caSGlen Barber	required during installworld.  "mergemaster -p" can be used to
14190312d1caSGlen Barber	add the user prior to installworld, as documented in the handbook.
1420e0fb6dc3SRobert Watson
1421b91dc775SHiroki Sato20121117:
1422b91dc775SHiroki Sato	The sin6_scope_id member variable in struct sockaddr_in6 is now
1423b91dc775SHiroki Sato	filled by the kernel before passing the structure to the userland via
1424b91dc775SHiroki Sato	sysctl or routing socket.  This means the KAME-specific embedded scope
1425b91dc775SHiroki Sato	id in sin6_addr.s6_addr[2] is always cleared in userland application.
1426b91dc775SHiroki Sato	This behavior can be controlled by net.inet6.ip6.deembed_scopeid.
1427b91dc775SHiroki Sato	__FreeBSD_version is bumped to 1000025.
1428b91dc775SHiroki Sato
14295b6478b0SBrooks Davis20121105:
14305b6478b0SBrooks Davis	On i386 and amd64 systems WITH_CLANG_IS_CC is now the default.
14315b6478b0SBrooks Davis	This means that the world and kernel will be compiled with clang
14325b6478b0SBrooks Davis	and that clang will be installed as /usr/bin/cc, /usr/bin/c++,
14335b6478b0SBrooks Davis	and /usr/bin/cpp.  To disable this behavior and revert to building
1434da0e842aSWarner Losh	with gcc, compile with WITHOUT_CLANG_IS_CC. Really old versions
1435da0e842aSWarner Losh	of current may need to bootstrap WITHOUT_CLANG first if the clang
1436da0e842aSWarner Losh	build fails (its compatibility window doesn't extend to the 9 stable
1437da0e842aSWarner Losh	branch point).
14385b6478b0SBrooks Davis
1439ffdbf9daSAndrey V. Elsukov20121102:
1440a971b547SAndrey V. Elsukov	The IPFIREWALL_FORWARD kernel option has been removed. Its
1441ffdbf9daSAndrey V. Elsukov	functionality now turned on by default.
1442a971b547SAndrey V. Elsukov
14438f134647SGleb Smirnoff20121023:
1444cb69178dSAndre Oppermann	The ZERO_COPY_SOCKET kernel option has been removed and
1445cb69178dSAndre Oppermann	split into SOCKET_SEND_COW and SOCKET_RECV_PFLIP.
1446cb69178dSAndre Oppermann	NB: SOCKET_SEND_COW uses the VM page based copy-on-write
1447cb69178dSAndre Oppermann	mechanism which is not safe and may result in kernel crashes.
1448cb69178dSAndre Oppermann	NB: The SOCKET_RECV_PFLIP mechanism is useless as no current
1449cb69178dSAndre Oppermann	driver supports disposeable external page sized mbuf storage.
1450cb69178dSAndre Oppermann	Proper replacements for both zero-copy mechanisms are under
1451cb69178dSAndre Oppermann	consideration and will eventually lead to complete removal
1452cb69178dSAndre Oppermann	of the two kernel options.
1453cb69178dSAndre Oppermann
1454cb69178dSAndre Oppermann20121023:
14558f134647SGleb Smirnoff	The IPv4 network stack has been converted to network byte
14568f134647SGleb Smirnoff	order. The following modules need to be recompiled together
14578f134647SGleb Smirnoff	with kernel: carp(4), divert(4), gif(4), siftr(4), gre(4),
14588f134647SGleb Smirnoff	pf(4), ipfw(4), ng_ipfw(4), stf(4).
14598f134647SGleb Smirnoff
14608859ec84SKonstantin Belousov20121022:
14618859ec84SKonstantin Belousov	Support for non-MPSAFE filesystems was removed from VFS. The
14628859ec84SKonstantin Belousov	VFS_VERSION was bumped, all filesystem modules shall be
14638859ec84SKonstantin Belousov	recompiled.
14648859ec84SKonstantin Belousov
1465e053ead0SAttilio Rao20121018:
1466e053ead0SAttilio Rao	All the non-MPSAFE filesystems have been disconnected from
1467e053ead0SAttilio Rao	the build. The full list includes: codafs, hpfs, ntfs, nwfs,
1468e053ead0SAttilio Rao	portalfs, smbfs, xfs.
1469e053ead0SAttilio Rao
147042a58907SGleb Smirnoff20121016:
147142a58907SGleb Smirnoff	The interface cloning API and ABI has changed. The following
147242a58907SGleb Smirnoff	modules need to be recompiled together with kernel:
147342a58907SGleb Smirnoff	ipfw(4), pfsync(4), pflog(4), usb(4), wlan(4), stf(4),
147442a58907SGleb Smirnoff	vlan(4), disc(4), edsc(4), if_bridge(4), gif(4), tap(4),
147542a58907SGleb Smirnoff	faith(4), epair(4), enc(4), tun(4), if_lagg(4), gre(4).
147642a58907SGleb Smirnoff
1477d6b3aaf8SOleksandr Tymoshenko20121015:
1478d6b3aaf8SOleksandr Tymoshenko	The sdhci driver was split in two parts: sdhci (generic SD Host
1479d6b3aaf8SOleksandr Tymoshenko	Controller logic) and sdhci_pci (actual hardware driver).
1480d6b3aaf8SOleksandr Tymoshenko	No kernel config modifications are required, but if you
1481d6b3aaf8SOleksandr Tymoshenko	load sdhc as a module you must switch to sdhci_pci instead.
1482d6b3aaf8SOleksandr Tymoshenko
14835fe58019SAttilio Rao20121014:
14845fe58019SAttilio Rao	Import the FUSE kernel and userland support into base system.
14855fe58019SAttilio Rao
1486d38ae94bSGabor Kovesdan20121013:
1487d38ae94bSGabor Kovesdan	The GNU sort(1) program has been removed since the BSD-licensed
1488d38ae94bSGabor Kovesdan	sort(1) has been the default for quite some time and no serious
1489d38ae94bSGabor Kovesdan	problems have been reported.  The corresponding WITH_GNU_SORT
149058b6d9a2SGabor Kovesdan	knob has also gone.
1491d38ae94bSGabor Kovesdan
149221d172a3SGleb Smirnoff20121006:
149321d172a3SGleb Smirnoff	The pfil(9) API/ABI for AF_INET family has been changed. Packet
149421d172a3SGleb Smirnoff	filtering modules: pf(4), ipfw(4), ipfilter(4) need to be recompiled
149521d172a3SGleb Smirnoff	with new kernel.
149621d172a3SGleb Smirnoff
14977b81c83cSAdrian Chadd20121001:
14987b81c83cSAdrian Chadd	The net80211(4) ABI has been changed to allow for improved driver
14997b81c83cSAdrian Chadd	PS-POLL and power-save support.  All wireless drivers need to be
15007b81c83cSAdrian Chadd	recompiled to work with the new kernel.
15017b81c83cSAdrian Chadd
1502d65043bcSKonstantin Belousov20120913:
1503d65043bcSKonstantin Belousov	The random(4) support for the VIA hardware random number
1504d65043bcSKonstantin Belousov	generator (`PADLOCK') is no longer enabled unconditionally.
150546be218dSDavid E. O'Brien	Add the padlock_rng device in the custom kernel config if
1506d65043bcSKonstantin Belousov	needed.  The GENERIC kernels on i386 and amd64 do include the
150746be218dSDavid E. O'Brien	device, so the change only affects the custom kernel
1508d65043bcSKonstantin Belousov	configurations.
1509d65043bcSKonstantin Belousov
1510d6d3f01eSGleb Smirnoff20120908:
1511d6d3f01eSGleb Smirnoff	The pf(4) packet filter ABI has been changed. pfctl(8) and
1512d6d3f01eSGleb Smirnoff	snmp_pf module need to be recompiled to work with new kernel.
1513d6d3f01eSGleb Smirnoff
15146e767defSMartin Matuska20120828:
15156e767defSMartin Matuska	A new ZFS feature flag "com.delphix:empty_bpobj" has been merged
15166e767defSMartin Matuska	to -HEAD. Pools that have empty_bpobj in active state can not be
15176e767defSMartin Matuska	imported read-write with ZFS implementations that do not support
15186e767defSMartin Matuska	this feature. For more information read the zpool-features(5)
15196e767defSMartin Matuska	manual page.
15206e767defSMartin Matuska
1521614e3098SMarius Strobl20120727:
1522614e3098SMarius Strobl	The sparc64 ZFS loader has been changed to no longer try to auto-
1523614e3098SMarius Strobl	detect ZFS providers based on diskN aliases but now requires these
1524614e3098SMarius Strobl	to be explicitly listed in the OFW boot-device environment variable.
1525614e3098SMarius Strobl
15267e003b0aSChristian Brueffer20120712:
15271f13597dSJung-uk Kim	The OpenSSL has been upgraded to 1.0.1c.  Any binaries requiring
15281f13597dSJung-uk Kim	libcrypto.so.6 or libssl.so.6 must be recompiled.  Also, there are
15291f13597dSJung-uk Kim	configuration changes.  Make sure to merge /etc/ssl/openssl.cnf.
15301f13597dSJung-uk Kim
15311f13597dSJung-uk Kim20120712:
15327e003b0aSChristian Brueffer	The following sysctls and tunables have been renamed for consistency
15337e003b0aSChristian Brueffer	with other variables:
15347e003b0aSChristian Brueffer	  kern.cam.da.da_send_ordered   -> kern.cam.da.send_ordered
15357e003b0aSChristian Brueffer	  kern.cam.ada.ada_send_ordered -> kern.cam.ada.send_ordered
15367e003b0aSChristian Brueffer
1537d22c63acSGabor Kovesdan20120628:
1538d22c63acSGabor Kovesdan	The sort utility has been replaced with BSD sort.  For now, GNU sort
1539d22c63acSGabor Kovesdan	is also available as "gnusort" or the default can be set back to
1540d22c63acSGabor Kovesdan	GNU sort by setting WITH_GNU_SORT.  In this case, BSD sort will be
1541d22c63acSGabor Kovesdan	installed as "bsdsort".
1542d22c63acSGabor Kovesdan
15432d9cf57eSMartin Matuska20120611:
15442d9cf57eSMartin Matuska	A new version of ZFS (pool version 5000) has been merged to -HEAD.
15452d9cf57eSMartin Matuska	Starting with this version the old system of ZFS pool versioning
15462d9cf57eSMartin Matuska	is superseded by "feature flags". This concept enables forward
15472d9cf57eSMartin Matuska	compatibility against certain future changes in functionality of ZFS
15482d9cf57eSMartin Matuska	pools. The first read-only compatible "feature flag" for ZFS pools
15492d9cf57eSMartin Matuska	is named "com.delphix:async_destroy". For more information
15502d9cf57eSMartin Matuska	read the new zpool-features(5) manual page.
15512d9cf57eSMartin Matuska	Please refer to the "ZFS notes" section of this file for information
15522d9cf57eSMartin Matuska	on upgrading boot ZFS pools.
15532d9cf57eSMartin Matuska
1554d1675e38SJason Evans20120417:
1555d1675e38SJason Evans	The malloc(3) implementation embedded in libc now uses sources imported
1556d1675e38SJason Evans	as contrib/jemalloc.  The most disruptive API change is to
1557d1675e38SJason Evans	/etc/malloc.conf.  If your system has an old-style /etc/malloc.conf,
1558d1675e38SJason Evans	delete it prior to installworld, and optionally re-create it using the
1559d1675e38SJason Evans	new format after rebooting.  See malloc.conf(5) for details
1560d1675e38SJason Evans	(specifically the TUNING section and the "opt.*" entries in the MALLCTL
1561d1675e38SJason Evans	NAMESPACE section).
1562d1675e38SJason Evans
156384db023eSJuli Mallett20120328:
156484db023eSJuli Mallett	Big-endian MIPS TARGET_ARCH values no longer end in "eb".  mips64eb
156584db023eSJuli Mallett	is now spelled mips64.  mipsn32eb is now spelled mipsn32.  mipseb is
156684db023eSJuli Mallett	now spelled mips.  This is to aid compatibility with third-party
156784db023eSJuli Mallett	software that expects this naming scheme in uname(3).  Little-endian
1568474dbfb7SWarner Losh	settings are unchanged. If you are updating a big-endian mips64 machine
1569474dbfb7SWarner Losh	from before this change, you may need to set MACHINE_ARCH=mips64 in
1570474dbfb7SWarner Losh	your environment before the new build system will recognize your machine.
157184db023eSJuli Mallett
15729c170fd1SAttilio Rao20120306:
15739c170fd1SAttilio Rao	Disable by default the option VFS_ALLOW_NONMPSAFE for all supported
15749c170fd1SAttilio Rao	platforms.
15759c170fd1SAttilio Rao
1576c7e41c8bSMikolaj Golub20120229:
1577c7e41c8bSMikolaj Golub	Now unix domain sockets behave "as expected" on	nullfs(5). Previously
1578c7e41c8bSMikolaj Golub	nullfs(5) did not pass through all behaviours to the underlying layer,
1579c7e41c8bSMikolaj Golub	as a result if we bound to a socket on the lower layer we could connect
1580c7e41c8bSMikolaj Golub	only to the lower path; if we bound to the upper layer we could connect
1581c7e41c8bSMikolaj Golub	only to	the upper path. The new behavior is one can connect to both the
1582c7e41c8bSMikolaj Golub	lower and the upper paths regardless what layer path one binds to.
1583c7e41c8bSMikolaj Golub
1584ca1672daSBjoern A. Zeeb20120211:
1585ca1672daSBjoern A. Zeeb	The getifaddrs upgrade path broken with 20111215 has been restored.
1586ca1672daSBjoern A. Zeeb	If you have upgraded in between 20111215 and 20120209 you need to
1587ca1672daSBjoern A. Zeeb	recompile libc again with your kernel.  You still need to recompile
1588ca1672daSBjoern A. Zeeb	world to be able to configure CARP but this restriction already
1589ca1672daSBjoern A. Zeeb	comes from 20111215.
1590ca1672daSBjoern A. Zeeb
1591e0e0f25bSDoug Barton20120114:
1592e0e0f25bSDoug Barton	The set_rcvar() function has been removed from /etc/rc.subr.  All
1593e0e0f25bSDoug Barton	base and ports rc.d scripts have been updated, so if you have a
1594e0e0f25bSDoug Barton	port installed with a script in /usr/local/etc/rc.d you can either
1595e0e0f25bSDoug Barton	hand-edit the rcvar= line, or reinstall the port.
1596e0e0f25bSDoug Barton
15975d482324SDoug Barton	An easy way to handle the mass-update of /etc/rc.d:
15985d482324SDoug Barton	rm /etc/rc.d/* && mergemaster -i
15995d482324SDoug Barton
160090d82653SAndriy Gapon20120109:
160190d82653SAndriy Gapon	panic(9) now stops other CPUs in the SMP systems, disables interrupts
160290d82653SAndriy Gapon	on the current CPU and prevents other threads from running.
160390d82653SAndriy Gapon	This behavior can be reverted using the kern.stop_scheduler_on_panic
160490d82653SAndriy Gapon	tunable/sysctl.
160590d82653SAndriy Gapon	The new behavior can be incompatible with kern.sync_on_panic.
160690d82653SAndriy Gapon
160708b68b0eSGleb Smirnoff20111215:
160808b68b0eSGleb Smirnoff	The carp(4) facility has been changed significantly. Configuration
160908b68b0eSGleb Smirnoff	of the CARP protocol via ifconfig(8) has changed, as well as format
161008b68b0eSGleb Smirnoff	of CARP events submitted to devd(8) has changed. See manual pages
161108b68b0eSGleb Smirnoff	for more information. The arpbalance feature of carp(4) is currently
161208b68b0eSGleb Smirnoff	not supported anymore.
161308b68b0eSGleb Smirnoff
161408b68b0eSGleb Smirnoff	Size of struct in_aliasreq, struct in6_aliasreq has changed. User
161508b68b0eSGleb Smirnoff	utilities using SIOCAIFADDR, SIOCAIFADDR_IN6, e.g. ifconfig(8),
161608b68b0eSGleb Smirnoff	need to be recompiled.
161708b68b0eSGleb Smirnoff
1618d5d131eeSJaakko Heinonen20111122:
1619d5d131eeSJaakko Heinonen	The acpi_wmi(4) status device /dev/wmistat has been renamed to
1620d5d131eeSJaakko Heinonen	/dev/wmistat0.
1621d5d131eeSJaakko Heinonen
1622ed1f6dc2SAttilio Rao20111108:
1623ed1f6dc2SAttilio Rao	The option VFS_ALLOW_NONMPSAFE option has been added in order to
1624ed1f6dc2SAttilio Rao	explicitely support non-MPSAFE filesystems.
1625ed1f6dc2SAttilio Rao	It is on by default for all supported platform at this present
1626ed1f6dc2SAttilio Rao	time.
1627ed1f6dc2SAttilio Rao
1628a9ab459bSMarius Strobl20111101:
1629a9ab459bSMarius Strobl	The broken amd(4) driver has been replaced with esp(4) in the amd64,
1630a9ab459bSMarius Strobl	i386 and pc98 GENERIC kernel configuration files.
1631a9ab459bSMarius Strobl
1632e59e2d8eSNathan Whitehorn20110930:
1633e59e2d8eSNathan Whitehorn	sysinstall has been removed
1634e59e2d8eSNathan Whitehorn
16358a3b6cc1SKen Smith20110923:
16368a3b6cc1SKen Smith	The stable/9 branch created in subversion.  This corresponds to the
16378a3b6cc1SKen Smith	RELENG_9 branch in CVS.
16388a3b6cc1SKen Smith
1639dc0dbf5cSWarner LoshCOMMON ITEMS:
1640dc0dbf5cSWarner Losh
1641a24eff53SWarner Losh	General Notes
1642a24eff53SWarner Losh	-------------
1643456b5dd8SWarner Losh	Avoid using make -j when upgrading.  While generally safe, there are
1644456b5dd8SWarner Losh	sometimes problems using -j to upgrade.  If your upgrade fails with
16451733d35cSRuslan Ermilov	-j, please try again without -j.  From time to time in the past there
1646456b5dd8SWarner Losh	have been problems using -j with buildworld and/or installworld.  This
1647456b5dd8SWarner Losh	is especially true when upgrading between "distant" versions (eg one
1648456b5dd8SWarner Losh	that cross a major release boundary or several minor releases, or when
1649456b5dd8SWarner Losh	several months have passed on the -current branch).
1650a24eff53SWarner Losh
16515780f3baSWarner Losh	Sometimes, obscure build problems are the result of environment
16525780f3baSWarner Losh	poisoning.  This can happen because the make utility reads its
1653456b5dd8SWarner Losh	environment when searching for values for global variables.  To run
1654456b5dd8SWarner Losh	your build attempts in an "environmental clean room", prefix all make
1655456b5dd8SWarner Losh	commands with 'env -i '.  See the env(1) manual page for more details.
16565780f3baSWarner Losh
16575ad05815SWarner Losh	When upgrading from one major version to another it is generally best to
16585ad05815SWarner Losh	upgrade to the latest code in the currently installed branch first, then
16595ad05815SWarner Losh	do an upgrade to the new branch. This is the best-tested upgrade path,
16605ad05815SWarner Losh	and has the highest probability of being successful.  Please try this
16615ad05815SWarner Losh	approach if you encounter problems with a major version upgrade.  Since
16625ad05815SWarner Losh	the stable 4.x branch point, one has generally been able to upgade from
16635ad05815SWarner Losh	anywhere in the most recent stable branch to head / current (or even the
16645ad05815SWarner Losh	last couple of stable branches). See the top of this file when there's
16655ad05815SWarner Losh	an exception.
1666081ff8acSDoug Barton
16676eeab389SWarner Losh	When upgrading a live system, having a root shell around before
1668da0e842aSWarner Losh	installing anything can help undo problems. Not having a root shell
1669da0e842aSWarner Losh	around can lead to problems if pam has changed too much from your
1670da0e842aSWarner Losh	starting point to allow continued authentication after the upgrade.
1671da0e842aSWarner Losh
16729c80b8aaSWarner Losh	This file should be read as a log of events. When a later event changes
16739c80b8aaSWarner Losh	information of a prior event, the prior event should not be deleted.
16749c80b8aaSWarner Losh	Instead, a pointer to the entry with the new information should be
16759c80b8aaSWarner Losh	placed in the old entry. Readers of this file should also sanity check
16769c80b8aaSWarner Losh	older entries before relying on them blindly. Authors of new entries
16779c80b8aaSWarner Losh	should write them with this in mind.
16789c80b8aaSWarner Losh
16798fc25799SMartin Matuska	ZFS notes
16808fc25799SMartin Matuska	---------
16818fc25799SMartin Matuska	When upgrading the boot ZFS pool to a new version, always follow
16828fc25799SMartin Matuska	these two steps:
16838fc25799SMartin Matuska
16848fc25799SMartin Matuska	1.) recompile and reinstall the ZFS boot loader and boot block
16858fc25799SMartin Matuska	(this is part of "make buildworld" and "make installworld")
16868fc25799SMartin Matuska
16878fc25799SMartin Matuska	2.) update the ZFS boot block on your boot drive
16888fc25799SMartin Matuska
16898fc25799SMartin Matuska	The following example updates the ZFS boot block on the first
169072ce7f29SAlexander Leidinger	partition (freebsd-boot) of a GPT partitioned drive ada0:
169172ce7f29SAlexander Leidinger	"gpart bootcode -p /boot/gptzfsboot -i 1 ada0"
16928fc25799SMartin Matuska
16938fc25799SMartin Matuska	Non-boot pools do not need these updates.
16948fc25799SMartin Matuska
1695dc0dbf5cSWarner Losh	To build a kernel
1696dc0dbf5cSWarner Losh	-----------------
1697ba01eb20SWarner Losh	If you are updating from a prior version of FreeBSD (even one just
16981cf0ef11SDavid E. O'Brien	a few days old), you should follow this procedure.  It is the most
16991cf0ef11SDavid E. O'Brien	failsafe as it uses a /usr/obj tree with a fresh mini-buildworld,
17001cf0ef11SDavid E. O'Brien
17011cf0ef11SDavid E. O'Brien	make kernel-toolchain
1702282e0f01SRuslan Ermilov	make -DALWAYS_CHECK_MAKE buildkernel KERNCONF=YOUR_KERNEL_HERE
1703282e0f01SRuslan Ermilov	make -DALWAYS_CHECK_MAKE installkernel KERNCONF=YOUR_KERNEL_HERE
1704dc0dbf5cSWarner Losh
17052e937dd6SAlexander Leidinger	To test a kernel once
17062e937dd6SAlexander Leidinger	---------------------
17072e937dd6SAlexander Leidinger	If you just want to boot a kernel once (because you are not sure
17082e937dd6SAlexander Leidinger	if it works, or if you want to boot a known bad kernel to provide
17092e937dd6SAlexander Leidinger	debugging information) run
17102e937dd6SAlexander Leidinger	make installkernel KERNCONF=YOUR_KERNEL_HERE KODIR=/boot/testkernel
17112e937dd6SAlexander Leidinger	nextboot -k testkernel
17122e937dd6SAlexander Leidinger
1713ba01eb20SWarner Losh	To just build a kernel when you know that it won't mess you up
1714ba01eb20SWarner Losh	--------------------------------------------------------------
1715456b5dd8SWarner Losh	This assumes you are already running a CURRENT system.  Replace
17160fbd2da9SKen Smith	${arch} with the architecture of your machine (e.g. "i386",
1717456b5dd8SWarner Losh	"arm", "amd64", "ia64", "pc98", "sparc64", "powerpc", "mips", etc).
17180fbd2da9SKen Smith
17190fbd2da9SKen Smith	cd src/sys/${arch}/conf
172047d0d01fSWarner Losh	config KERNEL_NAME_HERE
17210fbd2da9SKen Smith	cd ../compile/KERNEL_NAME_HERE
1722ba01eb20SWarner Losh	make depend
1723ba01eb20SWarner Losh	make
1724ba01eb20SWarner Losh	make install
1725ba01eb20SWarner Losh
1726ba01eb20SWarner Losh	If this fails, go to the "To build a kernel" section.
1727ba01eb20SWarner Losh
1728ba01eb20SWarner Losh	To rebuild everything and install it on the current system.
1729ba01eb20SWarner Losh	-----------------------------------------------------------
173063cb445eSWarner Losh	# Note: sometimes if you are running current you gotta do more than
173163cb445eSWarner Losh	# is listed here if you are upgrading from a really old current.
173263cb445eSWarner Losh
1733f643de42SWarner Losh	<make sure you have good level 0 dumps>
173463cb445eSWarner Losh	make buildworld
17356586253aSWarner Losh	make kernel KERNCONF=YOUR_KERNEL_HERE
173663cb445eSWarner Losh							[1]
173763cb445eSWarner Losh	<reboot in single user>				[3]
173805940036SJohn-Mark Gurney	mergemaster -Fp					[5]
173963cb445eSWarner Losh	make installworld
174005940036SJohn-Mark Gurney	mergemaster -Fi					[4]
174194877c06SAlexander Leidinger	make delete-old					[6]
174263cb445eSWarner Losh	<reboot>
174363cb445eSWarner Losh
1744f27b1fceSJoseph Koshy	To cross-install current onto a separate partition
1745f27b1fceSJoseph Koshy	--------------------------------------------------
1746f27b1fceSJoseph Koshy	# In this approach we use a separate partition to hold
1747f27b1fceSJoseph Koshy	# current's root, 'usr', and 'var' directories.   A partition
1748f27b1fceSJoseph Koshy	# holding "/", "/usr" and "/var" should be about 2GB in
1749f27b1fceSJoseph Koshy	# size.
1750f27b1fceSJoseph Koshy
1751f27b1fceSJoseph Koshy	<make sure you have good level 0 dumps>
1752f27b1fceSJoseph Koshy	<boot into -stable>
1753f27b1fceSJoseph Koshy	make buildworld
17543ecf3bddSRuslan Ermilov	make buildkernel KERNCONF=YOUR_KERNEL_HERE
1755f27b1fceSJoseph Koshy	<maybe newfs current's root partition>
1756f27b1fceSJoseph Koshy	<mount current's root partition on directory ${CURRENT_ROOT}>
1757af34024aSJohn-Mark Gurney	make installworld DESTDIR=${CURRENT_ROOT} -DDB_FROM_SRC
17582d5cde04SRuslan Ermilov	make distribution DESTDIR=${CURRENT_ROOT} # if newfs'd
17593ecf3bddSRuslan Ermilov	make installkernel KERNCONF=YOUR_KERNEL_HERE DESTDIR=${CURRENT_ROOT}
1760f27b1fceSJoseph Koshy	cp /etc/fstab ${CURRENT_ROOT}/etc/fstab 		   # if newfs'd
1761f27b1fceSJoseph Koshy	<edit ${CURRENT_ROOT}/etc/fstab to mount "/" from the correct partition>
1762f27b1fceSJoseph Koshy	<reboot into current>
1763f27b1fceSJoseph Koshy	<do a "native" rebuild/install as described in the previous section>
1764737d990aSXin LI	<maybe install compatibility libraries from ports/misc/compat*>
1765f27b1fceSJoseph Koshy	<reboot>
1766f27b1fceSJoseph Koshy
1767f27b1fceSJoseph Koshy
176815974d55SGavin Atkinson	To upgrade in-place from stable to current
1769f27b1fceSJoseph Koshy	----------------------------------------------
1770f643de42SWarner Losh	<make sure you have good level 0 dumps>
177121c075eaSWarner Losh	make buildworld					[9]
1772e5dc5f61SWarner Losh	make kernel KERNCONF=YOUR_KERNEL_HERE		[8]
1773fc8c157fSWarner Losh							[1]
1774fc8c157fSWarner Losh	<reboot in single user>				[3]
177505940036SJohn-Mark Gurney	mergemaster -Fp					[5]
1776ba26da8eSWarner Losh	make installworld
177705940036SJohn-Mark Gurney	mergemaster -Fi					[4]
177894877c06SAlexander Leidinger	make delete-old					[6]
1779ba26da8eSWarner Losh	<reboot>
1780ba26da8eSWarner Losh
1781fdb9f54dSWarner Losh	Make sure that you've read the UPDATING file to understand the
1782fdb9f54dSWarner Losh	tweaks to various things you need.  At this point in the life
1783fdb9f54dSWarner Losh	cycle of current, things change often and you are on your own
1784fdb9f54dSWarner Losh	to cope.  The defaults can also change, so please read ALL of
1785fdb9f54dSWarner Losh	the UPDATING entries.
1786ba26da8eSWarner Losh
17871dece4a9SWarner Losh	Also, if you are tracking -current, you must be subscribed to
17881dece4a9SWarner Losh	freebsd-current@freebsd.org.  Make sure that before you update
17891dece4a9SWarner Losh	your sources that you have read and understood all the recent
17901dece4a9SWarner Losh	messages there.  If in doubt, please track -stable which has
17911dece4a9SWarner Losh	much fewer pitfalls.
17921dece4a9SWarner Losh
1793134d2e86SWarner Losh	[1] If you have third party modules, such as vmware, you
1794134d2e86SWarner Losh	should disable them at this point so they don't crash your
1795134d2e86SWarner Losh	system on reboot.
1796134d2e86SWarner Losh
1797ee6e1fc3SWarner Losh	[3] From the bootblocks, boot -s, and then do
1798ee6e1fc3SWarner Losh		fsck -p
1799ee6e1fc3SWarner Losh		mount -u /
1800ee6e1fc3SWarner Losh		mount -a
18016586253aSWarner Losh		cd src
180247d0d01fSWarner Losh		adjkerntz -i		# if CMOS is wall time
1803f6a0ef01SWarner Losh	Also, when doing a major release upgrade, it is required that
1804f6a0ef01SWarner Losh	you boot into single user mode to do the installworld.
1805ee6e1fc3SWarner Losh
1806a6cd4f9dSWarner Losh	[4] Note: This step is non-optional.  Failure to do this step
1807a6cd4f9dSWarner Losh	can result in a significant reduction in the functionality of the
1808a6cd4f9dSWarner Losh	system.  Attempting to do it by hand is not recommended and those
1809a6cd4f9dSWarner Losh	that pursue this avenue should read this file carefully, as well
1810a6cd4f9dSWarner Losh	as the archives of freebsd-current and freebsd-hackers mailing lists
181150e8eca6SDoug Barton	for potential gotchas.  The -U option is also useful to consider.
181250e8eca6SDoug Barton	See mergemaster(8) for more information.
1813a6cd4f9dSWarner Losh
1814835284beSWarner Losh	[5] Usually this step is a noop.  However, from time to time
1815835284beSWarner Losh	you may need to do this if you get unknown user in the following
1816835284beSWarner Losh	step.  It never hurts to do it all the time.  You may need to
1817835284beSWarner Losh	install a new mergemaster (cd src/usr.sbin/mergemaster && make
1818835284beSWarner Losh	install) after the buildworld before this step if you last updated
181920e0cc0aSBrooks Davis	from current before 20130425 or from -stable before 20130430.
1820835284beSWarner Losh
182194877c06SAlexander Leidinger	[6] This only deletes old files and directories. Old libraries
182294877c06SAlexander Leidinger	can be deleted by "make delete-old-libs", but you have to make
182394877c06SAlexander Leidinger	sure that no program is using those libraries anymore.
182494877c06SAlexander Leidinger
1825456b5dd8SWarner Losh	[8] In order to have a kernel that can run the 4.x binaries needed to
1826456b5dd8SWarner Losh	do an installworld, you must include the COMPAT_FREEBSD4 option in
1827456b5dd8SWarner Losh	your kernel.  Failure to do so may leave you with a system that is
1828456b5dd8SWarner Losh	hard to boot to recover. A similar kernel option COMPAT_FREEBSD5 is
1829456b5dd8SWarner Losh	required to run the 5.x binaries on more recent kernels.  And so on
1830456b5dd8SWarner Losh	for COMPAT_FREEBSD6 and COMPAT_FREEBSD7.
1831c74fe6afSWarner Losh
1832e5dc5f61SWarner Losh	Make sure that you merge any new devices from GENERIC since the
1833e5dc5f61SWarner Losh	last time you updated your kernel config file.
1834e5dc5f61SWarner Losh
183521c075eaSWarner Losh	[9] When checking out sources, you must include the -P flag to have
1836e5dc5f61SWarner Losh	cvs prune empty directories.
1837e5dc5f61SWarner Losh
1838e5dc5f61SWarner Losh	If CPUTYPE is defined in your /etc/make.conf, make sure to use the
1839e5dc5f61SWarner Losh	"?=" instead of the "=" assignment operator, so that buildworld can
1840e5dc5f61SWarner Losh	override the CPUTYPE if it needs to.
1841e5dc5f61SWarner Losh
1842e5dc5f61SWarner Losh	MAKEOBJDIRPREFIX must be defined in an environment variable, and
1843e5dc5f61SWarner Losh	not on the command line, or in /etc/make.conf.  buildworld will
1844e5dc5f61SWarner Losh	warn if it is improperly defined.
1845dc0dbf5cSWarner LoshFORMAT:
1846dc0dbf5cSWarner Losh
1847f699bbbbSMark OvensThis file contains a list, in reverse chronological order, of major
1848630f2154SGlen Barberbreakages in tracking -current.  It is not guaranteed to be a complete
18499c80b8aaSWarner Loshlist of such breakages, and only contains entries since September 23, 2011.
1850630f2154SGlen BarberIf you need to see UPDATING entries from before that date, you will need
1851630f2154SGlen Barberto fetch an UPDATING file from an older FreeBSD release.
18521fc1a0dcSWarner Losh
1853e72fd46aSWarner LoshCopyright information:
1854e72fd46aSWarner Losh
1855456b5dd8SWarner LoshCopyright 1998-2009 M. Warner Losh.  All Rights Reserved.
1856e72fd46aSWarner Losh
1857772730c7SWarner LoshRedistribution, publication, translation and use, with or without
1858772730c7SWarner Loshmodification, in full or in part, in any form or format of this
18599698f2c0SWarner Loshdocument are permitted without further permission from the author.
1860e72fd46aSWarner Losh
1861e72fd46aSWarner LoshTHIS DOCUMENT IS PROVIDED BY WARNER LOSH ``AS IS'' AND ANY EXPRESS OR
1862e72fd46aSWarner LoshIMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
1863e72fd46aSWarner LoshWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
1864e72fd46aSWarner LoshDISCLAIMED.  IN NO EVENT SHALL WARNER LOSH BE LIABLE FOR ANY DIRECT,
1865e72fd46aSWarner LoshINDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
1866e72fd46aSWarner Losh(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
1867e72fd46aSWarner LoshSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
1868e72fd46aSWarner LoshHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
1869e72fd46aSWarner LoshSTRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
1870e72fd46aSWarner LoshIN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
1871e72fd46aSWarner LoshPOSSIBILITY OF SUCH DAMAGE.
1872e72fd46aSWarner Losh
187322306abcSWarner LoshContact Warner Losh if you have any questions about your use of
1874772730c7SWarner Loshthis document.
1875772730c7SWarner Losh
187697d92980SPeter Wemm$FreeBSD$
1877