article.xml revision 322180
1<?xml version="1.0" encoding="iso-8859-1"?>
2<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
3	  "http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd" [
4<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN"
5	 "http://www.FreeBSD.org/release/XML/share/xml/release.ent">
6 %release;
7<!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN"
8	 "http://www.FreeBSD.org/release/XML/share/xml/sponsor.ent">
9 %sponsor;
10<!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN"
11	 "http://www.FreeBSD.org/release/XML/share/xml/vendor.ent">
12 %vendor;
13<!ENTITY security PUBLIC "-//FreeBSD//ENTITIES Security Advisory List//EN"
14	 "http://www.FreeBSD.org/release/XML/share/xml/security.xml">
15<!ENTITY errata PUBLIC "-//FreeBSD//ENTITIES Errata List//EN"
16	 "http://www.FreeBSD.org/release/XML/share/xml/errata.xml">
17]>
18<article xmlns="http://docbook.org/ns/docbook"
19  xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
20
21  <info>
22    <title>&os; &release.current; Release Notes</title>
23
24    <author>
25      <orgname>The &os; Project</orgname>
26    </author>
27
28    <pubdate>$FreeBSD: stable/10/release/doc/en_US.ISO8859-1/relnotes/article.xml 322180 2017-08-07 19:45:13Z gjb $</pubdate>
29
30    <copyright>
31      <year>2017</year>
32      <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
33	Project</holder>
34    </copyright>
35
36    <legalnotice xml:id="trademarks" role="trademarks">
37      &tm-attrib.freebsd;
38      &tm-attrib.ibm;
39      &tm-attrib.ieee;
40      &tm-attrib.intel;
41      &tm-attrib.sparc;
42      &tm-attrib.general;
43    </legalnotice>
44
45    <abstract>
46      <para>The release notes for &os; &release.current; contain
47	a summary of the changes made to the &os; base system on the
48	&release.branch; development line.  This document lists
49	applicable security advisories that were issued since the last
50	release, as well as significant changes to the &os; kernel and
51	userland.  Some brief remarks on upgrading are also
52	presented.</para>
53    </abstract>
54  </info>
55
56  <sect1 xml:id="intro">
57    <title>Introduction</title>
58
59    <para>This document contains the release notes for &os;
60      &release.current;.  It describes recently added, changed, or
61      deleted features of &os;.  It also provides some notes on
62      upgrading from previous versions of &os;.</para>
63
64    <para releasetype="current">The &release.type; distribution to
65      which these release notes apply represents the latest point
66      along the &release.branch; development branch since
67      &release.branch; was created.  Information regarding pre-built,
68      binary &release.type; distributions along this branch can be
69      found at <uri
70	xlink:href="&release.url;">&release.url;</uri>.</para>
71
72    <para releasetype="snapshot">The &release.type; distribution to
73      which these release notes apply represents a point along the
74      &release.branch; development branch between &release.prev; and
75      the future &release.next;.  Information regarding pre-built,
76      binary &release.type; distributions along this branch can be
77      found at <uri
78	xlink:href="&release.url;">&release.url;</uri>.</para>
79
80    <para releasetype="release">This distribution of &os;
81      &release.current; is a &release.type; distribution.  It can be
82      found at <uri xlink:href="&release.url;">&release.url;</uri> or
83      any of its mirrors.  More information on obtaining this (or
84      other) &release.type; distributions of &os; can be found in the
85      <link
86	xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
87	  &os;</quote> appendix</link> to the <link
88	xlink:href="&url.books.handbook;/">&os;
89	Handbook</link>.</para>
90
91    <para>All users are encouraged to consult the release errata
92      before installing &os;.  The errata document is updated with
93      <quote>late-breaking</quote> information discovered late in the
94      release cycle or after the release.  Typically, it contains
95      information on known bugs, security advisories, and corrections
96      to documentation.  An up-to-date copy of the errata for &os;
97      &release.current; can be found on the &os; Web site.</para>
98
99    <para>This document describes the most user-visible new or changed
100      features in &os; since &release.prev;.</para>
101
102    <para>Typical release note items document recent security
103      advisories issued after &release.prev;, new drivers or hardware
104      support, new commands or options, major bug fixes, or
105      contributed software upgrades.  They may also list changes to
106      major ports/packages or release engineering practices.  Clearly
107      the release notes cannot list every single change made to &os;
108      between releases; this document focuses primarily on security
109      advisories, user-visible changes, and major architectural
110      improvements.</para>
111  </sect1>
112
113  <sect1 xml:id="upgrade">
114    <title>Upgrading from Previous Releases of &os;</title>
115
116    <para arch="amd64,i386">Binary upgrades between RELEASE versions
117      (and snapshots of the various security branches) are supported
118      using the &man.freebsd-update.8; utility.  The binary upgrade
119      procedure will update unmodified userland utilities, as well as
120      unmodified <filename>GENERIC</filename> kernel distributed as
121      a part of an official &os; release.  The &man.freebsd-update.8;
122      utility requires that the host being upgraded have Internet
123      connectivity.</para>
124
125    <para>Source-based upgrades (those based on recompiling the &os;
126      base system from source code) from previous versions are
127      supported, according to the instructions in
128      <filename>/usr/src/UPDATING</filename>.</para>
129
130    <important>
131      <para>Upgrading &os; should only be attempted after
132	backing up <emphasis>all</emphasis> data and configuration
133	files.</para>
134    </important>
135  </sect1>
136
137  <sect1 xml:id="security-errata">
138    <title>Security and Errata</title>
139
140    <para>This section lists the various Security Advisories and
141      Errata Notices since &release.prev;.</para>
142
143    <sect2 xml:id="security">
144      <title>Security Advisories</title>
145
146      &security;
147    </sect2>
148
149    <sect2 xml:id="errata">
150      <title>Errata Notices</title>
151
152      &errata;
153    </sect2>
154  </sect1>
155
156  <sect1 xml:id="userland">
157    <title>Userland</title>
158
159    <para>This section covers changes and additions to userland
160      applications, contributed software, and system utilities.</para>
161
162    <sect2 xml:id="userland-config">
163      <title>Userland Configuration Changes</title>
164
165      <para revision="313206">The &man.inetd.8; utility is now built
166	without <literal>libwrap</literal> support when
167	<literal>WITHOUT_TCP_WRAPPERS</literal> is set in
168	&man.src.conf.5;.</para>
169
170      <para revision="316046">The &man.libthr.3; library and related
171	files are now evaluated and removed by the
172	<literal>delete-old-libs</literal> target when upgrading the
173	system if <literal>WITHOUT_LIBTHR</literal> is
174	set in &man.src.conf.5;.</para>
175
176      <para revision="319243">The
177	<literal>WITH_RPCBIND_WARMSTART_SUPPORT</literal>
178	&man.src.conf.5; knob has been added, which when enabled
179	allows building &man.rpcbind.8; with
180	<literal>warmstart</literal> support.</para>
181    </sect2>
182
183    <sect2 xml:id="userland-programs">
184      <title>Userland Application Changes</title>
185
186      <para revision="298427">The &man.truss.1; utility has been
187	updated to include the <literal>-H</literal> flag, which logs
188	the thread ID of a thread invoking a system call.</para>
189
190      <para revision="308915">The &man.zfsbootcfg.8; utility has been
191	added, providing one-time &man.boot.config.5;-style options
192	for &man.zfsboot.8;.</para>
193
194      <para revision="319390">The &man.cxgbetool.8; utility has been
195	added, providing command-line access to features and debugging
196	facilities of &man.cxgbe.4; devices.</para>
197    </sect2>
198
199    <sect2 xml:id="userland-contrib">
200      <title>Contributed Software</title>
201
202      <para revision="309512"><application>Subversion</application>
203	has been updated to version 1.9.5.</para>
204
205      <para revision="309848">&man.file.1; has been updated to version
206	5.29.</para>
207
208      <para revision="310490">The &man.amd.8; utility has been updated
209	to version 6.2.</para>
210
211      <para revision="312516">&man.xz.1; has been updated to version
212	5.2.3.</para>
213
214      <para revision="313796">&man.zlib.3; has been updated to version
215	1.2.11.</para>
216
217      <para revision="316069">&man.ntpd.8; has been updated to version
218	4.2.8p10.</para>
219
220      <para revision="316350">Timezone data files have been updated to
221	version 2017b.</para>
222
223      <para revision="316958">&man.tcsh.1; has been updated to version
224	6.20.00.</para>
225
226      <para revision="321304">&man.libarchive.3; has been updated to
227	version 3.3.2.</para>
228    </sect2>
229
230    <sect2 xml:id="userland-installer">
231      <title>Installation and Configuration Tools</title>
232
233      <para>&nbsp;</para>
234    </sect2>
235
236    <sect2 xml:id="userland-rc">
237      <title><filename class="directory">/etc/rc.d</filename>
238	Scripts</title>
239
240      <para>&nbsp;</para>
241    </sect2>
242
243    <sect2 xml:id="userland-periodic">
244      <title><filename class="directory">/etc/periodic</filename>
245	Scripts</title>
246
247      <para>&nbsp;</para>
248    </sect2>
249
250    <sect2 xml:id="userland-libraries">
251      <title>Runtime Libraries and API</title>
252
253      <para revision="316040">The &man.kvm.close.3; function has been
254	updated to return the accumulated error from previous
255	&man.close.2; calls.</para>
256    </sect2>
257
258    <sect2 xml:id="userland-abi">
259      <title>ABI Compatibility</title>
260
261      <para revision="309258">The type <literal>max_align_t</literal>
262	is now defined for C11 compliance.</para>
263    </sect2>
264
265    <sect2 xml:id="userland-debug">
266      <title>Userland Debugging</title>
267
268      <para revision="304017">&man.ptrace.2; now supports events for
269	thread creation and destruction, permitting more reliable
270	debugging of threaded processes.</para>
271
272      <para revision="304499">&man.ptrace.2; now supports events for
273	&man.vfork.2;, permitting reliable debugging across
274	&man.vfork.2; invocations.</para>
275
276      <para revision="306786">Process core dumps now include the
277	process ID (<acronym>PID</acronym>) and command line
278	arguments.</para>
279    </sect2>
280  </sect1>
281
282  <sect1 xml:id="kernel">
283    <title>Kernel</title>
284
285    <para>This section covers changes to kernel configurations, system
286      tuning, and system control parameters that are not otherwise
287      categorized.</para>
288
289    <sect2 xml:id="kernel-bugfix">
290      <title>Kernel Bug Fixes</title>
291
292      <para revision="317434">The &man.ipf.4; packet filter has been
293	updated to prevent <literal>keep state</literal> from
294	incorrectly implying <literal>keep frags</literal>, matching
295	the behavior documented in &man.ipf.5;.</para>
296    </sect2>
297
298    <sect2 xml:id="kernel-config">
299      <title>Kernel Configuration</title>
300
301      <para>&nbsp;</para>
302    </sect2>
303
304    <sect2 xml:id="kernel-sysctl">
305      <title>System Tuning and Controls</title>
306
307      <para></para>
308    </sect2>
309  </sect1>
310
311  <sect1 xml:id="drivers">
312    <title>Devices and Drivers</title>
313
314    <para>This section covers changes and additions to devices and
315      device drivers since &release.prev;.</para>
316
317    <sect2 xml:id="drivers-device">
318      <title>Device Drivers</title>
319
320      <para revision="306533" contrib="sponsor"
321	sponsor="&chelsio;">&man.devctl.8; now supports a &quot;clear
322	driver&quot; command as a complement to &quot;set
323	driver&quot;.</para>
324    </sect2>
325
326    <sect2 xml:id="drivers-storage">
327      <title>Storage Drivers</title>
328
329      <para revision="319436">The &man.mpr.4; driver has been updated
330	to support tri-mode
331	(<acronym>SAS</acronym>/<acronym>SATA</acronym>/<acronym>PCIe</acronym>)
332	Broadcom&reg; storage adapters.</para>
333    </sect2>
334
335    <sect2 xml:id="drivers-network">
336      <title>Network Drivers</title>
337
338      <para revision="309447" contrib="sponsor"
339	sponsor="&chelsio;">The &man.cxgbev.4; driver has been added,
340	providing support for Virtual Function devices
341	(<acronym>VFs</acronym>) on Chelsio T4 and T5 adapters.</para>
342
343      <para revision="309560" contrib="sponsor"
344	sponsor="&chelsio;">The &man.cxgbe.4; driver has been updated
345	to provide support for Virtual Function devices
346	(<acronym>VFs</acronym>) on Chelsio T6 adapters.</para>
347
348      <para revision="309560" contrib="sponsor"
349	sponsor="&chelsio;">The &man.cxgbe.4; driver now supports
350	devices using T6-based adapters which support 10, 25, 40, and
351	100 Gbps.</para>
352
353      <para revision="312359">The &man.alc.4; driver has been updated
354	to provide support for Atheros&reg; Killer&nbsp;E2400&trade;
355	Gigabit ethernet cards.</para>
356
357      <para revision="314019" contrib="sponsor" sponsor="&ms;">The
358	&man.alc.4; driver has been updated to provide support for
359	Atheros&reg; Killer&nbsp;E2500&trade; Gigabit ethernet
360	cards.</para>
361
362      <para revision="316485">The &man.qlnxe.4; driver has been added,
363	providing support for Cavium&reg; Qlogic&trade; 45000 Series
364	adapters.</para>
365
366      <para revision="319270" contrib="sponsor"
367	sponsor="&chelsio;">The &man.cxgbe.4; driver has been updated
368	to firmware version 1.16.45.0 for T4, T5, and T6 cards.</para>
369    </sect2>
370  </sect1>
371
372  <sect1 xml:id="hardware">
373    <title>Hardware Support</title>
374
375    <para>This section covers general hardware support for physical
376      machines, hypervisors, and virtualization environments, as well
377      as hardware changes and updates that do not otherwise fit in
378      other sections of this document.</para>
379
380    <sect2 xml:id="hardware-support">
381      <title>Hardware Support</title>
382
383      <para>&nbsp;</para>
384    </sect2>
385
386    <sect2 xml:id="hardware-virtualization">
387      <title>Virtualization Support</title>
388
389      <para revision="306520" contrib="sponsor"
390	sponsor="&chelsio;"><acronym>PCI</acronym> passthrough with
391	&man.bhyve.4; resets functions via <acronym>FLR</acronym> when
392	a virtual machine is started and stopped.</para>
393
394      <para revision="306472" contrib="sponsor"
395	sponsor="&chelsio;"><acronym>PCI</acronym> passthrough with
396	&man.bhyve.4; supports more dynamic configurations permitting
397	devices to be marked for passthrough or host use at
398	runtime.</para>
399    </sect2>
400
401    <sect2 xml:id="hardware-arm">
402      <title>ARM Support</title>
403
404      <para>&nbsp;</para>
405    </sect2>
406  </sect1>
407
408  <sect1 xml:id="storage">
409    <title>Storage</title>
410
411    <para>This section covers changes and additions to file systems
412      and other storage subsystems, both local and networked.</para>
413
414    <sect2 xml:id="storage-general">
415      <title>General Storage</title>
416
417      <para>&nbsp;</para>
418    </sect2>
419
420    <sect2 xml:id="storage-net">
421      <title>Networked Storage</title>
422
423      <para revision="318675">The <acronym>NFS</acronym> client now
424	properly handles <literal>NFS4ERR_BAD_SESSION</literal> errors
425	received from an <acronym>NFS</acronym> server.  Additionally,
426	the kernel <acronym>RPC</acronym> client has been updated to
427	prevent creating new <acronym>TCP</acronym> connections when
428	<literal>ERESTART</literal> is received from
429	&man.sosend.9;.</para>
430    </sect2>
431
432    <sect2 xml:id="storage-zfs">
433      <title>ZFS</title>
434
435      <para></para>
436    </sect2>
437
438    <sect2 xml:id="storage-geom">
439      <title>&man.geom.4;</title>
440
441      <para>&nbsp;</para>
442    </sect2>
443  </sect1>
444
445  <sect1 xml:id="boot">
446    <title>Boot Loader Changes</title>
447
448    <para>This section covers the boot loader, boot menu, and other
449      boot-related changes.</para>
450
451    <sect2 xml:id="boot-loader">
452      <title>Boot Loader Changes</title>
453
454      <para>&nbsp;</para>
455    </sect2>
456
457    <sect2 xml:id="boot-menu">
458      <title>Boot Menu Changes</title>
459
460      <para>&nbsp;</para>
461    </sect2>
462  </sect1>
463
464  <sect1 xml:id="network">
465    <title>Networking</title>
466
467    <para>This section describes changes that affect networking in
468      &os;.</para>
469
470    <sect2 xml:id="network-general">
471      <title>General Networking Changes</title>
472
473      <para revision="313558" contrib="sponsor"
474	sponsor="&dellemc;">The network stack has been modified to fix
475	incorrect or invalid <acronym>IP</acronym> addresses if
476	multiple threads emit a <acronym>UDP</acronym>
477	<literal>log_in_vain</literal> message concurrently.</para>
478
479      <para revision="317375" contrib="sponsor"
480	sponsor="&multiplay;">The <acronym>TCP</acronym> stack has
481	been changed to use the estimated <acronym>RTT</acronym>
482	instead of timestamps for receive buffer auto resizing.</para>
483    </sect2>
484
485    <sect2 xml:id="network-protocols">
486      <title>Network Protocols</title>
487
488      <para revision="309340" contrib="sponsor"
489	sponsor="&dellemc;">Support for <acronym>GARP</acronym>
490	(gratuitous <acronym>ARP</acronym>) retransmit has been added.
491	A new &man.sysctl.8;,
492	<literal>net.link.ether.inet.garp_rexmit_count</literal>, has
493	been added, which sets the maximum number of retransmissions
494	when set to a non-zero value.</para>
495    </sect2>
496  </sect1>
497
498  <sect1 xml:id="ports">
499    <title>Ports Collection and Package Infrastructure</title>
500
501    <para>This section covers changes to the &os;&nbsp;Ports
502      Collection, package infrastructure, and package maintenance and
503      installation tools.</para>
504
505    <sect2 xml:id="ports-infrastructure">
506      <title>Infrastructure Changes</title>
507
508      <para>&nbsp;</para>
509    </sect2>
510
511    <sect2 xml:id="ports-packages ">
512      <title>Packaging Changes</title>
513
514      <para>&nbsp;</para>
515    </sect2>
516  </sect1>
517
518  <sect1 xml:id="doc">
519    <title>Documentation</title>
520
521    <para>This section covers changes to the &os;&nbsp;Documentation
522      Project sources and toolchain.</para>
523
524    <sect2 xml:id="doc-sources">
525      <title>Documentation Source Changes</title>
526
527      <para>&nbsp;</para>
528    </sect2>
529
530    <sect2 xml:id="doc-toolchain">
531      <title>Documentation Toolchain Changes</title>
532
533      <para>&nbsp;</para>
534    </sect2>
535  </sect1>
536
537  <sect1 xml:id="releng">
538    <title>Release Engineering and Integration</title>
539
540    <para>This section convers changes that are specific to the
541      &os;&nbsp;Release Engineering processes.</para>
542
543    <sect2 xml:id="releng-changes">
544      <title>Integration Changes</title>
545
546      <para>&nbsp;</para>
547    </sect2>
548  </sect1>
549</article>
550