article.xml revision 286245
1<?xml version="1.0" encoding="iso-8859-1"?>
2<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
3	"../../../share/xml/freebsd50.dtd" [
4<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent">
5 %release;
6<!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "sponsor.ent">
7 %sponsor;
8<!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "vendor.ent">
9 %vendor;
10<!ENTITY security SYSTEM "../../share/xml/security.xml">
11<!ENTITY errata SYSTEM "../../share/xml/errata.xml">
12]>
13<article xmlns="http://docbook.org/ns/docbook"
14  xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
15
16  <info>
17    <title>&os; &release.current; Release Notes</title>
18
19    <author>
20      <orgname>The &os; Project</orgname>
21    </author>
22
23    <pubdate>$FreeBSD: releng/10.2/release/doc/en_US.ISO8859-1/relnotes/article.xml 286245 2015-08-03 19:08:29Z gjb $</pubdate>
24
25    <!-- Last rev: 284813 -->
26
27    <copyright>
28      <year>2015</year>
29      <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
30	Project</holder>
31    </copyright>
32
33    <legalnotice xml:id="trademarks" role="trademarks">
34      &tm-attrib.freebsd;
35      &tm-attrib.ibm;
36      &tm-attrib.ieee;
37      &tm-attrib.intel;
38      &tm-attrib.sparc;
39      &tm-attrib.general;
40    </legalnotice>
41
42    <abstract>
43      <para>The release notes for &os; &release.current; contain
44	a summary of the changes made to the &os; base system on the
45	&release.branch; development line.  This document lists
46	applicable security advisories that were issued since the last
47	release, as well as significant changes to the &os; kernel and
48	userland.  Some brief remarks on upgrading are also
49	presented.</para>
50    </abstract>
51  </info>
52
53  <sect1 xml:id="intro">
54    <title>Introduction</title>
55
56    <para>This document contains the release notes for &os;
57      &release.current;.  It describes recently added, changed, or
58      deleted features of &os;.  It also provides some notes on
59      upgrading from previous versions of &os;.</para>
60
61    <para releasetype="current">The &release.type; distribution to
62      which these release notes apply represents the latest point
63      along the &release.branch; development branch since
64      &release.branch; was created.  Information regarding pre-built,
65      binary &release.type; distributions along this branch can be
66      found at <uri
67	xlink:href="&release.url;">&release.url;</uri>.</para>
68
69    <para releasetype="snapshot">The &release.type; distribution to
70      which these release notes apply represents a point along the
71      &release.branch; development branch between &release.prev; and
72      the future &release.next;.  Information regarding pre-built,
73      binary &release.type; distributions along this branch can be
74      found at <uri
75	xlink:href="&release.url;">&release.url;</uri>.</para>
76
77    <para releasetype="release">This distribution of &os;
78      &release.current; is a &release.type; distribution.  It can be
79      found at <uri xlink:href="&release.url;">&release.url;</uri> or
80      any of its mirrors.  More information on obtaining this (or
81      other) &release.type; distributions of &os; can be found in the
82      <link
83	xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
84	  &os;</quote> appendix</link> to the <link
85	xlink:href="&url.books.handbook;/">&os;
86	Handbook</link>.</para>
87
88    <para>All users are encouraged to consult the release errata
89      before installing &os;.  The errata document is updated with
90      <quote>late-breaking</quote> information discovered late in the
91      release cycle or after the release.  Typically, it contains
92      information on known bugs, security advisories, and corrections
93      to documentation.  An up-to-date copy of the errata for &os;
94      &release.current; can be found on the &os; Web site.</para>
95
96    <para>This document describes the most user-visible new or changed
97      features in &os; since &release.prev;.</para>
98
99    <para>Typical release note items document recent security
100      advisories issued after &release.prev;, new drivers or hardware
101      support, new commands or options, major bug fixes, or
102      contributed software upgrades.  They may also list changes to
103      major ports/packages or release engineering practices.  Clearly
104      the release notes cannot list every single change made to &os;
105      between releases; this document focuses primarily on security
106      advisories, user-visible changes, and major architectural
107      improvements.</para>
108  </sect1>
109
110  <sect1 xml:id="upgrade">
111    <title>Upgrading from Previous Releases of &os;</title>
112
113    <para arch="amd64,i386">Binary upgrades between RELEASE versions
114      (and snapshots of the various security branches) are supported
115      using the &man.freebsd-update.8; utility.  The binary upgrade
116      procedure will update unmodified userland utilities, as well as
117      unmodified <filename>GENERIC</filename> kernel distributed as
118      a part of an official &os; release.  The &man.freebsd-update.8;
119      utility requires that the host being upgraded have Internet
120      connectivity.</para>
121
122    <para>Source-based upgrades (those based on recompiling the &os;
123      base system from source code) from previous versions are
124      supported, according to the instructions in
125      <filename>/usr/src/UPDATING</filename>.</para>
126
127    <important>
128      <para>Upgrading &os; should only be attempted after
129	backing up <emphasis>all</emphasis> data and configuration
130	files.</para>
131    </important>
132  </sect1>
133
134  <sect1 xml:id="security-errata">
135    <title>Security and Errata</title>
136
137    <para>This section lists the various Security Advisories and
138      Errata Notices since &release.prev;.</para>
139
140    <sect2 xml:id="security">
141      <title>Security Advisories</title>
142
143      &security;
144    </sect2>
145
146    <sect2 xml:id="errata">
147      <title>Errata Notices</title>
148
149      &errata;
150    </sect2>
151  </sect1>
152
153  <sect1 xml:id="userland">
154    <title>Userland</title>
155
156    <para>This section covers changes and additions to userland
157      applications, contributed software, and system utilities.</para>
158
159    <sect2 xml:id="userland-config">
160      <title>Userland Configuration Changes</title>
161
162      <para revision="276991">The &man.termcap.5; file is installed
163	as-is from sources, instead of reordering, creating
164	<filename>/etc/termcap.db</filename> by default, providing
165	a performance improvements to applications that use the
166	&man.termcap.5; database, such as &man.vi.1; and
167	&man.ncurses.3;.</para>
168    </sect2>
169
170    <sect2 xml:id="userland-programs">
171      <title>Userland Application Changes</title>
172
173      <para revision="275040">A new utility, &man.dpv.1;, has been
174	added to the base system, providing a &man.dialog.1;-style
175	progress view from one or more input streams.  A corresponding
176	library, &man.dpv.3;, has also been added.</para>
177
178      <para revision="275945">The &man.elfdump.1; utility has been
179	updated to support capability mode provided by
180	&man.capsicum.4;.</para>
181
182      <para revision="277434" contrib="sponsor" sponsor="&ff;">The
183	&man.fstyp.8; utility has been added, which is used to
184	determine the filesystem on a specified device.</para>
185
186      <para revision="278968" contrib="sponsor" sponsor="&ff;">The
187	&man.mkimg.1; utility has been updated to support the
188	<acronym>MBR</acronym> <acronym>EFI</acronym> partition
189	type.</para>
190
191      <para revision="281044">A regression in the &man.libarchive.3;
192	library that would prevent a directory from being included in
193	the archive when <literal>--one-file-system</literal> is used
194	has been fixed.</para>
195
196      <para revision="281161" contrib="sponsor"
197	sponsor="&limelight;">A new flag, <literal>-R</literal>, has
198	been added to the &man.netstat.8; utility, which is used to
199	dump <acronym>RSS</acronym>/flow information.</para>
200
201      <para revision="281936" contrib="sponsor" sponsor="&ff;">The
202	&man.ar.1; utility has been updated to set
203	<literal>ARCHIVE_EXTRACT_SECURE_SYMLINKS</literal> and
204	<literal>ARCHIVE_EXTRACT_SECURE_NODOTDOT</literal> to disallow
205	directory traversal when extracting an archive, similar to
206	&man.tar.1;.</para>
207
208      <para revision="282278">A race condition in &man.wc.1; that
209	would cause final results to be sent to &man.stderr.4; when
210	receiving the <literal>SIGINFO</literal> signal has been
211	fixed.</para>
212
213      <para revision="282870" contrib="sponsor"
214	sponsor="&scaleengine;">The &man.freebsd-update.8; utility has
215	been updated to prevent fetching updated binary patches when
216	a previous upgrade has not been thoroughly completed.</para>
217
218      <para revision="282974" contrib="sponsor" sponsor="&ff;">The
219	&man.uefisign.8; utility has been added.</para>
220
221      <para revision="283875" contrib="sponsor"
222	sponsor="&multiplay;">The &man.chflags.1;, &man.chgrp.1;,
223	&man.chmod.1;, and &man.chown.8; utilities now affect symbolic
224	links when the <literal>-R</literal> flag is specified, as
225	documented in &man.symlink.7;.</para>
226
227      <para revision="283258">The &man.date.1; utility has been
228	updated to print the modification time of the file passed as
229	an argument to the <literal>-r</literal> flag, improving
230	compatibility with the <acronym>GNU</acronym> &man.date.1;
231	utility behavior.</para>
232
233      <para revision="284523">A new flag, <literal>-c</literal>, has
234	been added to the &man.mkimg.1; utility, which allows
235	specifying the capacity of the target disk image.</para>
236
237      <para revision="285092">The &man.pw.8; utility has been updated
238	with a new flag, <literal>-R</literal>, that sets the root
239	directory within which the utility will operate.</para>
240    </sect2>
241
242    <sect2 xml:id="userland-contrib">
243      <title>Contributed Software</title>
244
245      <para revision="282746" contrib="sponsor" sponsor="&ff;">The
246	&man.resolvconf.8; utility has been updated to version
247	3.7.0.</para>
248
249      <para revision="283270">The &man.nc.1; utility has been updated
250	to the OpenBSD 5.7 version.</para>
251
252      <para revision="284398">Timezone data files have been updated to
253	version 2015e.</para>
254
255      <para revision="284460">The &man.acpi.4; subsystem has been
256	updated to version 20150515.</para>
257
258      <para revision="284778">The &man.file.1; utility has been
259	updated to version 5.23.</para>
260
261      <para revision="285206">The &man.unbound.8; utility has been
262	updated to version 1.5.3.</para>
263
264      <para revision="285305">The <application>sendmail</application>
265	utility has been updated to version 8.15.2.</para>
266
267      <para revision="285330"><application>OpenSSL</application> has
268	been updated to version 1.0.1p.</para>
269
270      <para revision="285612">The <application>ntp</application>
271	suite has been updated to version 4.2.8p3.</para>
272
273      <para revision="285750" contrib="sponsor" sponsor="&dell;">The
274	&man.ssh.1; utility has been updated to re-implement hostname
275	canonicalization before locating the host in
276	<filename>known_hosts</filename>.</para>
277
278      <para revision="286084">The &man.tar.1; utility has been updated
279	to fix an issue that would prevent compressing sparse
280	files.</para>
281    </sect2>
282
283    <sect2 xml:id="userland-installer">
284      <title>Installation and Configuration Tools</title>
285
286      <para revision="285769" contrib="sponsor"
287	sponsor="&scaleengine;">Support for detecting and implementing
288	a workaround for various laptops and motherboards that do not
289	boot properly from <acronym>GPT</acronym>-partitioned disks
290	has been added to &man.bsdinstall.8;.  Additionally, the
291	<literal>active</literal> flag will be set on the partition
292	when needed.</para>
293
294      <para revision="285721" contrib="sponsor"
295	sponsor="&scaleengine;">Support for detecting and implementing
296	aligning partitions on 1Mb boundaries has been added to
297	&man.bsdinstall.8;.</para>
298
299      <para revision="285769" contrib="sponsor"
300	sponsor="&scaleengine;">Support for selecting the partitioning
301	scheme when installing on the <acronym>UFS</acronym>
302	filesystem has been added to &man.bsdinstall.8;.</para>
303    </sect2>
304
305    <sect2 xml:id="userland-rc">
306      <title><filename class="directory">/etc/rc.d</filename>
307	Scripts</title>
308
309      <para revision="284009">A new &man.rc.8; script,
310	<filename>growfs</filename>, has been added, which will resize
311	the root filesystem on boot if <filename>/firstboot</filename>
312	exists.</para>
313    </sect2>
314
315    <sect2 xml:id="userland-periodic">
316      <title><filename class="directory">/etc/periodic</filename>
317	Scripts</title>
318
319      <para revision="277520" contrib="sponsor" sponsor="&ff;">A new
320	&man.periodic.8; script,
321	<filename>510.status-world-kernel</filename>, has been added,
322	which evaluates the running userland and kernel versions from
323	the &man.uname.1; <literal>-U</literal> and
324	<literal>-K</literal> arguments, and prints an error if the
325	system userland and kernel are not in sync.</para>
326    </sect2>
327
328    <sect2 xml:id="userland-libraries">
329      <title>Runtime Libraries and API</title>
330
331      <para revision="275040">A new file configuration library,
332	&man.figpar.3;, has been added to the base system.</para>
333
334      <para revision="276686" contrib="sponsor" sponsor="&ff;">The
335	&man.procctl.2; system call has been updated to include
336	a facility for non-&man.init.8; processes to be declared as
337	the reaper of child processes and their decendants.</para>
338
339      <para revision="280392">The &man.setmode.3; function has been
340	updated to consistently set <literal>errno</literal> on
341	failure.</para>
342    </sect2>
343
344    <sect2 xml:id="userland-abi">
345      <title>ABI Compatibility</title>
346
347      <para revision="275807">The &linux; compatibility version has
348	been updated to <literal>2.6.18</literal>.  The
349	<literal>compat.linux.osrelease</literal> &man.sysctl.8; is
350	evaluated when building the <filename
351	  role="package">emulators/linux-c6</filename> and related
352	ports.</para>
353    </sect2>
354  </sect1>
355
356  <sect1 xml:id="kernel">
357    <title>Kernel</title>
358
359    <para>This section covers changes to kernel configurations, system
360      tuning, and system control parameters that are not otherwise
361      categorized.</para>
362
363    <sect2 xml:id="kernel-bugfix">
364      <title>Kernel Bug Fixes</title>
365
366      <para revision="276068">A kernel panic triggered when destroying
367	a &man.vnet.9; &man.jail.8; configured with &man.gif.4; has
368	been fixed.</para>
369
370      <para revision="284018">A kernel panic triggered when destroying
371	a &man.vnet.9; &man.jail.8; configured with &man.gre.4; has
372	been fixed.</para>
373    </sect2>
374
375    <sect2 xml:id="kernel-config">
376      <title>Kernel Configuration</title>
377
378      <para revision="282065" contrib="sponsor" sponsor="&ff;">The
379	<literal>PAE_TABLES</literal> kernel configuration option has
380	been added for &os;/&arch.i386;, which instructs &man.pmap.9;
381	to use <acronym>PAE</acronym> format for page tables while
382	maintaining a 32-bit physical address size elsewhere in the
383	kernel.  The use of this option can enhance application-level
384	security by enabling the creation of <quote>no execute</quote>
385	mappings on modern &arch.i386; processors.  Unlike the
386	<literal>PAE</literal> option, <literal>PAE_TABLES</literal>
387	preserves kernel binary interface (<acronym>KBI</acronym>)
388	compatibility with non-<literal>PAE</literal> kernels,
389	allowing non-<literal>PAE</literal> kernel modules and drivers
390	to work with a <literal>PAE_TABLES</literal>-enabled kernel.
391	Additionally, system limits are tuned for 4GB maximum
392	<acronym>RAM</acronym>, avoiding kernel virtual address space
393	(<acronym>KVA</acronym>) exhaustion.</para>
394
395      <para revision="282826">The <literal>SIFTR</literal> kernel
396	configuration has been added, allowing building &man.siftr.4;
397	statically into the kernel.</para>
398
399      <para revision="283076" contrib="sponsor" sponsor="&intelcorp;"
400	arch="amd64,i386">The &man.nvd.4; and &man.nvme.4; drivers are
401	now included in the <filename>GENERIC</filename> kernel
402	configuration by default.</para>
403
404      <para revision="283505" arch="arm">The &arch.arm; boot loader,
405	<filename>ubldr</filename>, is now relocatable.  In addition,
406	<filename>ubldr.bin</filename> is now created during build
407	time, which is a stripped binary with an entry point of
408	<literal>0</literal>, providing the ability to specify the
409	load address by running <literal>go
410	  &dollar;{loadaddr}</literal> in
411	<literal>u-boot</literal>.</para>
412
413      <para revision="284094" arch="arm">A new module for creating
414	<filename>rpi.dtb</filename> has been added for the Raspberry
415	Pi.</para>
416
417      <para revision="284094" arch="arm">The
418	<filename>rpi.dtb</filename> module is now installed to
419	<filename class="directory">/boot/dtb/</filename> by
420	default for the Raspberry Pi system.</para>
421
422      <para revision="284096" arch="arm">A new module for creating
423	the <filename>dtb</filename> module for AM335x systems has
424	been added.</para>
425
426      <para revision="284522" contrib="sponsor"
427	sponsor="&limelight;">A new kernel configuration option,
428	<literal>EM_MULTIQUEUE</literal>, has been added which enables
429	multi-queue support in the &man.em.4; driver.</para>
430
431      <note>
432	<para>Multi-queue support in the &man.em.4; driver is not
433	  officially supported by &intel;.</para>
434      </note>
435    </sect2>
436
437    <sect2 xml:id="kernel-sysctl">
438      <title>System Tuning and Controls</title>
439
440      <para revision="276986">Throttling via <acronym>ACPI</acronym>
441	and <acronym>P4TCC</acronym> via &man.device.hints.5; have
442	been turned off by default.</para>
443
444      <para revision="278982" contrib="sponsor" sponsor="&ff;">The
445	&man.hwpmc.4; default and maximum callchain depths have been
446	increased.  The default has been increased from 16 to 32, and
447	the maximum increased from 32 to 128.</para>
448
449      <para revision="281255" contrib="sponsor"
450	sponsor="&ix;, &ff;">The &man.devfs.5; device filesystem has
451	been changed to update timestamps for read/write operations
452	using seconds precision.  A new &man.sysctl.8;,
453	<literal>vfs.devfs.dotimes</literal> has been added, which
454	when set to a non-zero value, enables default precision
455	timestamps for these operations.</para>
456
457      <para revision="280632">The <literal>kern.osrelease</literal>
458	and <literal>kern.osreldate</literal> are now configurable
459	&man.jail.8; parameters.</para>
460
461      <para revision="284665" contrib="sponsor" sponsor="&ff;">A new
462	&man.sysctl.8;, <literal>kern.racct.enable</literal>, has been
463	added, which when set to a non-zero value allows using
464	&man.rctl.8; with the <literal>GENERIC</literal> kernel.
465	A new kernel configuration option,
466	<literal>RACCT_DISABLED</literal> has also been added.</para>
467
468      <para revision="284665" contrib="sponsor" sponsor="&ff;">The
469	<literal>GENERIC</literal> kernel configuration now includes
470	<literal>RACCT</literal> and <literal>RCTL</literal> by
471	default.</para>
472
473      <note>
474	<para>To enable <literal>RACCT</literal> and
475	  <literal>RCTL</literal> on a system using the
476	  <literal>GENERIC</literal> kernel configuration, add
477	  <literal>kern.racct.enable=1</literal> to
478	  &man.loader.conf.5;, and reboot the system.</para>
479      </note>
480    </sect2>
481  </sect1>
482
483  <sect1 xml:id="drivers">
484    <title>Devices and Drivers</title>
485
486    <para>This section covers changes and additions to devices and
487      device drivers since &release.prev;.</para>
488
489    <sect2 xml:id="drivers-device">
490      <title>Device Drivers</title>
491
492      <para revision="282199">The <literal>drm</literal> code has
493	been updated to match &linux; version 3.8.13.</para>
494
495      <para revision="281708">The &man.psm.4; driver has been updated
496	to include improved support for newer Synaptics&nbsp;&reg;
497	touchpads and the ClickPad&nbsp;&reg; mouse on newer
498	Lenovo&nbsp;&trade; laptops.</para>
499    </sect2>
500
501    <sect2 xml:id="drivers-storage">
502      <title>Storage Drivers</title>
503
504      <para revision="281957">The &man.hptnr.4; driver has been
505	updated to version 1.1.1.</para>
506    </sect2>
507
508    <sect2 xml:id="drivers-network">
509      <title>Network Drivers</title>
510
511      <para revision="274486">The &man.pf.4; interface default hash
512	has been changed from <literal>Jenkins</literal> to
513	<literal>Murmur3</literal>, providing a 3-percent performance
514	increase in packets-per-second.</para>
515
516      <para revision="279157">The &man.ral.4; driver has been updated
517	to support the RT5390 and RT5392 chipsets.</para>
518
519      <para revision="284066" contrib="sponsor" sponsor="&yandex;">The
520	&man.gre.4; driver has been significantly overhauled, and has
521	been split into two separate modules, &man.gre.4; and
522	&man.me.4;.</para>
523
524      <para revision="284365">The &man.vxlan.4; driver has been added,
525	which creates a virtual Layer 2 (Ethernet) network overlaid in
526	a Layer 3 (IP/UDP) network.  The &man.vxlan.4; driver is
527	analogous to &man.vlan.4;, but is designed to be better suited
528	for large, multiple-tenant datacenter environments.</para>
529
530      <para revision="284499">The &man.cdce.4; driver has been updated
531	to include support for the RTL8153 chipset.</para>
532
533      <para revision="284555" contrib="sponsor"
534	sponsor="&solarflare;">The &man.sfxge.4; driver has been
535	updated to support Solarflare Flareon Ultra 7000-series
536	chipsets.</para>
537    </sect2>
538  </sect1>
539
540  <sect1 xml:id="hardware">
541    <title>Hardware Support</title>
542
543    <para>This section covers general hardware support for physical
544      machines, hypervisors, and virtualization environments, as well
545      as hardware changes and updates that do not otherwise fit in
546      other sections of this document.</para>
547
548    <sect2 xml:id="hardware-support">
549      <title>Hardware Support</title>
550
551      <para revision="278407">The &man.uart.4; driver has been updated
552	to include support for the <acronym>AMT</acronym> serial
553	interface found on the Lenovo&reg; ThinkPad&trade; T61.</para>
554
555      <para revision="279924">The &man.uart.4; driver has been updated
556	to include support for the <acronym>AMT</acronym> serial
557	interface found on the Lenovo&reg; ThinkPad&trade;
558	T400.</para>
559    </sect2>
560
561    <sect2 xml:id="hardware-virtualization">
562      <title>Virtualization Support</title>
563
564      <para revision="275273">The &man.virtio.console.4; driver has
565	been added, which provides an interface to VirtIO console
566	devices through a &man.tty.4; device.</para>
567
568      <para revision="276403">The &man.bhyve.8; hypervisor has been
569	updated to support &amd; processors with
570	<acronym>SVM</acronym> and <acronym>AMD-V</acronym> hardware
571	extensions.</para>
572
573      <para revision="280370">The &man.bhyve.8; hypervisor has been
574	updated to support <literal>DSM TRIM</literal> commands for
575	virtual <acronym>AHCI</acronym> disks.</para>
576
577      <para revision="283280" contrib="sponsor" sponsor="&msostc;">The
578	Hyper-V&trade; drivers have been updated with several
579	enhancements:</para>
580
581      <itemizedlist>
582	<listitem>
583	  <para>The &man.hv.vmbus.4; driver now has multi-channel
584	    support.</para>
585	</listitem>
586
587	<listitem>
588	  <para>The &man.hv.storvsc.4; driver now has scatter/gather
589	    support, in addition to performance improvements.</para>
590	</listitem>
591
592	<listitem>
593	  <para>The &man.hv.kvp.4; driver has received several bug
594	    fixes.</para>
595	</listitem>
596      </itemizedlist>
597
598      <para revision="285236" contrib="sponsor" sponsor="&msostc;">The
599	&man.hv.netvsc.4; driver has been updated to support checksum
600	offloading and <acronym>TSO</acronym>.</para>
601    </sect2>
602
603    <sect2 xml:id="hardware-arm">
604      <title>ARM Support</title>
605
606      <para revision="278079" arch="arm">Support to turn off the
607	BeagleBone Black system with the &man.shutdown.8;
608	<literal>-p</literal> flag or by invoking &man.poweroff.8; has
609	been added.</para>
610
611      <para revision="278599" arch="arm">Support for the Exynos 5420
612	Octa system has been added.</para>
613
614      <para revision="278599" arch="arm">The <acronym>SMP</acronym>
615	option has been enabled for all Exynos 5 systems supported by
616	&os;.</para>
617
618      <para revision="278608">The <literal>bcm2835_cpufreq</literal>
619	driver has been added, which supports <acronym>CPU</acronym>
620	frequency and voltage control on the Raspberry Pi
621	<acronym>SOC</acronym>.</para>
622
623      <para revision="283500" arch="arm">Support for the Toradex
624	Apalis i.MX6 development board has been added.</para>
625
626      <para revision="283500" arch="arm">Audio transmission drivers
627	have been added for Digital Audio Multiplexer
628	(<acronym>AUDMUXM</acronym>), Smart Direct Memory Access
629	Controller (<acronym>SDMA</acronym>), and Syncronous Serial
630	Interface (<acronym>SSI</acronym>).</para>
631    </sect2>
632  </sect1>
633
634  <sect1 xml:id="storage">
635    <title>Storage</title>
636
637    <para>This section covers changes and additions to file systems
638      and other storage subsystems, both local and networked.</para>
639
640    <sect2 xml:id="storage-general">
641      <title>General Storage</title>
642
643      <para revision="279002" contrib="sponsor" sponsor="&ix;">The
644	&man.ctl.4; <acronym>LUN</acronym> mapping has been rewritten,
645	replacing <acronym>iSCSI</acronym>-specific mapping mechanisms
646	with a new mechanism that works for any port.</para>
647
648      <para revision="279055" contrib="sponsor" sponsor="&ix;">The
649	&man.ctld.8; utility has been updated to allow controlling
650	non-<acronym>iSCSI</acronym> &man.ctl.4; ports.</para>
651
652      <para revision="283223" contrib="sponsor" sponsor="&ff;">The
653	&man.autofs.5; subsystem has been updated to include a new
654	&man.auto.master.5; map, <literal>-media</literal>, which
655	allows automatically mounting removable media, such as
656	<acronym>CD</acronym> drives or <acronym>USB</acronym> flash
657	drives.</para>
658
659      <para revision="283242" contrib="sponsor" sponsor="&ff;">The
660	&man.autofs.5; subsystem has been updated to include a new
661	&man.auto.master.5; map, <literal>-noauto</literal>, which
662	handles &man.fstab.5; entries set to
663	<literal>noauto</literal>.</para>
664    </sect2>
665
666    <sect2 xml:id="storage-net">
667      <title>Networked Storage</title>
668
669      <para revision="274939" contrib="sponsor" sponsor="&ix;">The
670	&man.ctld.8; utility has been updated to include support for
671	registering <acronym>iSCSI</acronym> targets and portals on
672	<acronym>iSNS</acronym> servers.  This provides a mechanism
673	which allows <acronym>iSCSI</acronym> initiators to find
674	targets and portals without requiring active
675	discovery.</para>
676
677      <para revision="275249" contrib="sponsor" sponsor="&ff;">Support
678	for the <literal>timeo</literal>, <literal>actimeo</literal>,
679	<literal>noac</literal>, and <literal>proto</literal> options
680	have been added to &man.mount.nfs.8;.</para>
681    </sect2>
682
683    <sect2 xml:id="storage-zfs">
684      <title>ZFS</title>
685
686      <para revision="275490">A new tunable,
687	<literal>vfs.zfs.spa_slop_shift</literal>, has been added,
688	which controls how much space is reserved by default.</para>
689
690      <para revision="277583">The <literal>arc_meta_limit</literal>
691	statistics are now visible through the
692	<literal>kstat</literal> &man.sysctl.8;.  As a result of this
693	change, the <literal>vfs.zfs.arc_meta_used</literal>
694	&man.sysctl.8; has been removed, and replaced with the
695	<literal>kstat.zfs.misc.arcstats.arc_meta_used</literal>
696	&man.sysctl.8;.</para>
697    </sect2>
698
699    <sect2 xml:id="storage-geom">
700      <title>&man.geom.4;</title>
701
702      <para revision="275891" contrib="sponsor" sponsor="&ix;">The
703	&man.ctl.4; subsystem has been updated, increasing the ports
704	limit from <literal>128</literal> to <literal>256</literal>,
705	and <acronym>LUN</acronym> limit from <literal>256</literal>
706	to <literal>1024</literal>.</para>
707
708      <para revision="282861">Support for the
709	<literal>apple-boot</literal>, <literal>apple-hfs</literal>,
710	and <literal>apple-ufs</literal> <acronym>MBR</acronym>
711	partitioning schemes have been added to &man.gpart.8;.</para>
712    </sect2>
713  </sect1>
714
715  <sect1 xml:id="boot">
716    <title>Boot Loader Changes</title>
717
718    <para>This section covers the boot loader, boot menu, and other
719      boot-related changes.</para>
720
721    <sect2 xml:id="boot-loader">
722      <title>Boot Loader Changes</title>
723
724      <para revision="281323">Support for <literal>bzipfs</literal>
725	has been added to the <acronym>EFI</acronym> loader.</para>
726
727      <para revision="281843">The boot loader has been updated to
728	support entering the <acronym>GELI</acronym> passphrase before
729	loading the kernel.  To enable this behavior, add
730	<literal>geom_eli_passphrase_prompt="YES"</literal> to
731	&man.loader.conf.5;.</para>
732
733      <para revision="283262" contrib="sponsor" sponsor="&ff;">The
734	memory test run at boot time on &os;/&arch.amd64; platforms
735	has been disabled by default.</para>
736
737      <para revision="283972">A new &man.ttys.5; class,
738	<literal>3wire</literal>, has been added.  This is similar to
739	the existing terminal classes, but does not have a defined
740	baudrate.</para>
741
742      <para revision="284775" contrib="sponsor" sponsor="&ff;"
743	arch="arm">The &man.ttys.5; file for &os;/&arch.arm; has been
744	updated to enable <filename>ttyu1</filename>,
745	<filename>ttyu2</filename>, and <filename>ttyu3</filename> by
746	default, if the callin port is an active console port.</para>
747    </sect2>
748
749    <sect2 xml:id="boot-menu">
750      <title>Boot Menu Changes</title>
751
752      <para>&nbsp;</para>
753    </sect2>
754  </sect1>
755
756  <sect1 xml:id="network">
757    <title>Networking</title>
758
759    <para>This section describes changes that affect networking in
760      &os;.</para>
761
762    <sect2 xml:id="network-protocols">
763      <title>Network Procols</title>
764
765      <para revision="273838" contrib="sponsor"
766	sponsor="&limelight;">Support for <acronym>PLPMTUD</acronym>
767	blackhole detection (<acronym>RFC</acronym> 4821) has been
768	added to the &man.tcp.4; stack, disabled by default.  New
769	control tunables have been added:</para>
770
771      <informaltable frame="none" pgwide="0">
772	<tgroup cols="2">
773	  <colspec colwidth="1*"/>
774	  <colspec colwidth="1*"/>
775	  <thead>
776	    <row>
777	      <entry>Tunable</entry>
778	      <entry>Description</entry>
779	    </row>
780	  </thead>
781
782	  <tbody>
783	    <row>
784	      <entry><literal>net.inet.tcp.pmtud_blackhole_detection</literal></entry>
785	      <entry>Enables or disables <acronym>PLPMTUD</acronym>
786		blackhole detection</entry>
787	    </row>
788
789	    <row>
790	      <entry><literal>net.inet.tcp.pmtud_blackhole_mss</literal></entry>
791	      <entry><acronym>MSS</acronym> to try for IPv4</entry>
792	    </row>
793
794	    <row>
795	      <entry><literal>net.inet.tcp.v6pmtud_blackhole_mss</literal></entry>
796	      <entry><acronym>MSS to try for IPv6</acronym></entry>
797	    </row>
798	  </tbody>
799	</tgroup>
800      </informaltable>
801
802      <para>New monitoring &man.sysctl.8;s haven been added:</para>
803
804      <informaltable frame="none" pgwide="0">
805	<tgroup cols="2">
806	  <colspec colwidth="1*"/>
807	  <colspec colwidth="1*"/>
808	  <thead>
809	    <row>
810	      <entry>Tunable</entry>
811	      <entry>Description</entry>
812	    </row>
813	  </thead>
814
815	  <tbody>
816	    <row>
817	      <entry><literal>net.inet.tcp.pmtud_blackhole_activated</literal></entry>
818	      <entry>Number of times the code was activated to attempt
819		downshifting the <acronym>MSS</acronym></entry>
820	    </row>
821
822	    <row>
823	      <entry><literal>net.inet.tcp.pmtud_blackhole_min_activated</literal></entry>
824	      <entry>Number of times the blackhole
825		<acronym>MSS</acronym> was used in an attempt to
826		downshift</entry>
827	    </row>
828
829	    <row>
830	      <entry><literal>net.inet.tcp.pmtud_blackhole_failed</literal></entry>
831	      <entry>Number of times that the blackhole failed to
832		connect after downshifting the
833		<acronym>MSS</acronym></entry>
834	    </row>
835	  </tbody>
836	</tgroup>
837      </informaltable>
838
839    </sect2>
840  </sect1>
841
842  <sect1 xml:id="ports">
843    <title>Ports Collection and Package Infrastructure</title>
844
845    <para>This section covers changes to the &os;&nbsp;Ports
846      Collection, package infrastructure, and package maintenance and
847      installation tools.</para>
848
849    <sect2 xml:id="ports-infrastructure">
850      <title>Infrastructure Changes</title>
851
852      <para>&nbsp;</para>
853    </sect2>
854
855    <sect2 xml:id="ports-packages ">
856      <title>Packaging Changes</title>
857
858      <para>&nbsp;</para>
859    </sect2>
860  </sect1>
861
862  <sect1 xml:id="doc">
863    <title>Documentation</title>
864
865    <para>This section covers changes to the &os;&nbsp;Documentation
866      Project sources and toolchain.</para>
867
868    <sect2 xml:id="doc-sources">
869      <title>Documentation Source Changes</title>
870
871      <para>&nbsp;</para>
872    </sect2>
873
874    <sect2 xml:id="doc-toolchain">
875      <title>Documentation Toolchain Changes</title>
876
877      <para>&nbsp;</para>
878    </sect2>
879  </sect1>
880
881  <sect1 xml:id="releng">
882    <title>Release Engineering and Integration</title>
883
884    <para>This section convers changes that are specific to the
885      &os;&nbsp;Release Engineering processes.</para>
886
887    <sect2 xml:id="releng-changes">
888      <title>Integration Changes</title>
889
890      <para revision="283161" contrib="sponsor" sponsor="&ff;">The
891	Release Engineering build tools have been updated to support
892	building &os;/&arch.arm; images without external utilities for
893	supported boards where a corresponding
894	<literal>u-boot</literal> port exists in the Ports
895	Collection.</para>
896
897      <para revision="283548" contrib="sponsor" sponsor="&ff;">The
898	&os;/&arch.i386; memory stick installation images are now
899	created using the &man.mkimg.1; utility, matching the way
900	the &os;/&arch.amd64; images are created.</para>
901
902      <para revision="285830" contrib="sponsor" sponsor="&ff;">The
903	default &man.pkg.8; repository set in
904	<filename>/etc/pkg/FreeBSD.conf</filename> now defaults to
905	the <literal>quarterly</literal> package set.  To use the
906	<literal>latest</literal> branch (as was the previous
907	default), the comment at the top of
908	<filename>/etc/pkg/FreeBSD.conf</filename> explains how to
909	disable the default repository and specify an alternative
910	repository.</para>
911    </sect2>
912  </sect1>
913</article>
914