]> CyberLeo.Net >> Repos - FreeBSD/stable/10.git/blob - release/doc/en_US.ISO8859-1/relnotes/article.xml
Document r316348, pw(8) respecting pw.conf(5).
[FreeBSD/stable/10.git] / release / doc / en_US.ISO8859-1 / relnotes / article.xml
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$</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="316348">The &man.pw.8; utility has been updated
195         to properly respect &man.pw.conf.5;, if present.</para>
196
197       <para revision="319390">The &man.cxgbetool.8; utility has been
198         added, providing command-line access to features and debugging
199         facilities of &man.cxgbe.4; devices.</para>
200
201       <para revision="320646">The &man.rcp.1;, &man.rlogin.1;,
202         &man.rsh.1;, &man.rlogind.8;, and &man.rshd.8; utilities have
203         been marked as deprecated, and planned for removal in
204         &os;&nbsp;12.0-RELEASE.</para>
205
206       <para revision="320772">The &man.syslogd.8; utility has been
207         updated to restart logging a subprocess that had restarted
208         unexpectedly.</para>
209
210       <para revision="320824">The &man.gdb.1; and &man.kgdb.1;
211         utilities have been marked as deprecated, and planned for
212         removal from the base system in the future.  A newer version
213         is available in the <filename
214           role="package">devel/gdb</filename> port.</para>
215
216       <para revision="321242">The &man.cron.8; utility has been
217         updated to add support for including files within <filename
218           class="directory">/etc/cron.d</filename> and <filename
219           class="directory">/usr/local/etc/cron.d</filename> by
220         default.</para>
221
222       <para revision="321234">The &man.syslogd.8; utility has been
223         updated to add the <literal>include</literal> keyword which
224         allows specifying a directory containing configuration files
225         to be included in addition to &man.syslog.conf.5;.  The
226         default &man.syslog.conf.5; has been updated to include
227         <filename class="directory">/etc/syslog.d</filename> and
228         <filename class="directory">/usr/local/etc/syslog.d</filename>
229         by default.</para>
230
231       <para revision="321263">The &man.newsyslog.8; utility has been
232         updated to support logging to &man.syslogd.8; in a format
233         compliant with RFC5424.  For more details, see the description
234         for the <literal>T</literal> flag in
235         &man.newsyslog.conf.5;.</para>
236     </sect2>
237
238     <sect2 xml:id="userland-contrib">
239       <title>Contributed Software</title>
240
241       <para revision="309512"><application>Subversion</application>
242         has been updated to version 1.9.5.</para>
243
244       <para revision="309848">&man.file.1; has been updated to version
245         5.29.</para>
246
247       <para revision="310490">The &man.amd.8; utility has been updated
248         to version 6.2.</para>
249
250       <para revision="312516">&man.xz.1; has been updated to version
251         5.2.3.</para>
252
253       <para revision="313796">&man.zlib.3; has been updated to version
254         1.2.11.</para>
255
256       <para revision="316069">&man.ntpd.8; has been updated to version
257         4.2.8p10.</para>
258
259       <para revision="316350">Timezone data files have been updated to
260         version 2017b.</para>
261
262       <para revision="316958">&man.tcsh.1; has been updated to version
263         6.20.00.</para>
264
265       <para revision="321304">&man.libarchive.3; has been updated to
266         version 3.3.2.</para>
267
268       <para revision="321964"><application>bmake</application> has
269         been updated to version 20170720.</para>
270
271       <para revision="322244"><filename>pci_vendors</filename> has
272         been updated to version 2017.07.27.</para>
273     </sect2>
274
275     <sect2 xml:id="userland-installer">
276       <title>Installation and Configuration Tools</title>
277
278       <para revision="321202" contrib="sponsor" sponsor="&ff;">The
279         default <acronym>EFI</acronym> partition created by
280         &man.bsdinstall.8; has been increased from 800KB to
281         200MB.</para>
282     </sect2>
283
284     <sect2 xml:id="userland-rc">
285       <title><filename class="directory">/etc/rc.d</filename>
286         Scripts</title>
287
288       <para>&nbsp;</para>
289     </sect2>
290
291     <sect2 xml:id="userland-periodic">
292       <title><filename class="directory">/etc/periodic</filename>
293         Scripts</title>
294
295       <para>&nbsp;</para>
296     </sect2>
297
298     <sect2 xml:id="userland-libraries">
299       <title>Runtime Libraries and API</title>
300
301       <para revision="316040">The &man.kvm.close.3; function has been
302         updated to return the accumulated error from previous
303         &man.close.2; calls.</para>
304
305       <para revision="320312">The &man.syslog.3; function has been
306         updated to be more resilent to thread cancellation occurring
307         in supported deferred mode, eliminating possible lockups in
308         multi-threaded applications that often create and cancel
309         threads using the function, such as <filename
310           role="package">net/mpd5</filename>.</para>
311
312       <para revision="321074">The &man.stdio.3; function has been
313         updated to be deferred cancel-safe, eliminating possible
314         lockups in multi-threaded applications using functions such
315         as &man.funopen.3;, &man.fropen.3;, and &man.fwopen.3;.</para>
316     </sect2>
317
318     <sect2 xml:id="userland-abi">
319       <title>ABI Compatibility</title>
320
321       <para revision="309258">The type <literal>max_align_t</literal>
322         is now defined for C11 compliance.</para>
323     </sect2>
324
325     <sect2 xml:id="userland-debug">
326       <title>Userland Debugging</title>
327
328       <para revision="304017">&man.ptrace.2; now supports events for
329         thread creation and destruction, permitting more reliable
330         debugging of threaded processes.</para>
331
332       <para revision="304499">&man.ptrace.2; now supports events for
333         &man.vfork.2;, permitting reliable debugging across
334         &man.vfork.2; invocations.</para>
335
336       <para revision="306786">Process core dumps now include the
337         process ID (<acronym>PID</acronym>) and command line
338         arguments.</para>
339     </sect2>
340   </sect1>
341
342   <sect1 xml:id="kernel">
343     <title>Kernel</title>
344
345     <para>This section covers changes to kernel configurations, system
346       tuning, and system control parameters that are not otherwise
347       categorized.</para>
348
349     <sect2 xml:id="kernel-misc">
350       <title>Miscellaneous Kernel Changes</title>
351
352       <para revision="321198">The &man.vt.4; driver has been updated,
353         increasing the maximum framebuffer size.</para>
354     </sect2>
355
356     <sect2 xml:id="kernel-bugfix">
357       <title>Kernel Bug Fixes</title>
358
359       <para revision="317434">The &man.ipf.4; packet filter has been
360         updated to prevent <literal>keep state</literal> from
361         incorrectly implying <literal>keep frags</literal>, matching
362         the behavior documented in &man.ipf.5;.</para>
363
364       <para revision="322793">The &man.geom.4;
365         <literal>JOURNAL</literal> class has been updated to fix
366         <literal>flush_queue</literal> handling.</para>
367     </sect2>
368
369     <sect2 xml:id="kernel-config">
370       <title>Kernel Configuration</title>
371
372       <para>&nbsp;</para>
373     </sect2>
374
375     <sect2 xml:id="kernel-sysctl">
376       <title>System Tuning and Controls</title>
377
378       <para revision="321024">The
379         <literal>kern.features.linux</literal> and
380         <literal>kern.features.linux64</literal> flags have been
381         added to the <literal>kern.features</literal> &man.sysctl.8;,
382         which when set to <literal>1</literal>, indicate the kernel
383         is configured with compatibility for 32-bit and/or 64-bit
384         linux binaries, respectively.</para>
385     </sect2>
386   </sect1>
387
388   <sect1 xml:id="drivers">
389     <title>Devices and Drivers</title>
390
391     <para>This section covers changes and additions to devices and
392       device drivers since &release.prev;.</para>
393
394     <sect2 xml:id="drivers-device">
395       <title>Device Drivers</title>
396
397       <para revision="306533" contrib="sponsor"
398         sponsor="&chelsio;">&man.devctl.8; now supports a &quot;clear
399         driver&quot; command as a complement to &quot;set
400         driver&quot;.</para>
401     </sect2>
402
403     <sect2 xml:id="drivers-storage">
404       <title>Storage Drivers</title>
405
406       <para revision="319436">The &man.mpr.4; driver has been updated
407         to support tri-mode
408         (<acronym>SAS</acronym>/<acronym>SATA</acronym>/<acronym>PCIe</acronym>)
409         Broadcom&reg; storage adapters.</para>
410
411       <para revision="321067">The &man.arcmsr.4; driver has been
412         updated to version 1.40.00.00, adding support for ARC-1884
413         <acronym>SATA</acronym> controllers.</para>
414     </sect2>
415
416     <sect2 xml:id="drivers-network">
417       <title>Network Drivers</title>
418
419       <para revision="309447" contrib="sponsor"
420         sponsor="&chelsio;">The &man.cxgbev.4; driver has been added,
421         providing support for Virtual Function devices
422         (<acronym>VFs</acronym>) on Chelsio T4 and T5 adapters.</para>
423
424       <para revision="309560" contrib="sponsor"
425         sponsor="&chelsio;">The &man.cxgbe.4; driver has been updated
426         to provide support for Virtual Function devices
427         (<acronym>VFs</acronym>) on Chelsio T6 adapters.</para>
428
429       <para revision="309560" contrib="sponsor"
430         sponsor="&chelsio;">The &man.cxgbe.4; driver now supports
431         devices using T6-based adapters which support 10, 25, 40, and
432         100 Gbps.</para>
433
434       <para revision="312359">The &man.alc.4; driver has been updated
435         to provide support for Atheros&reg; Killer&nbsp;E2400&trade;
436         Gigabit ethernet cards.</para>
437
438       <para revision="314019" contrib="sponsor" sponsor="&ms;">The
439         &man.alc.4; driver has been updated to provide support for
440         Atheros&reg; Killer&nbsp;E2500&trade; Gigabit ethernet
441         cards.</para>
442
443       <para revision="316485">The &man.qlnxe.4; driver has been added,
444         providing support for Cavium&reg; Qlogic&trade; 45000 Series
445         adapters.</para>
446
447       <para revision="319270" contrib="sponsor"
448         sponsor="&chelsio;">The &man.cxgbe.4; driver has been updated
449         to firmware version 1.16.45.0 for T4, T5, and T6 cards.</para>
450     </sect2>
451   </sect1>
452
453   <sect1 xml:id="hardware">
454     <title>Hardware Support</title>
455
456     <para>This section covers general hardware support for physical
457       machines, hypervisors, and virtualization environments, as well
458       as hardware changes and updates that do not otherwise fit in
459       other sections of this document.</para>
460
461     <sect2 xml:id="hardware-support">
462       <title>Hardware Support</title>
463
464       <para>&nbsp;</para>
465     </sect2>
466
467     <sect2 xml:id="hardware-virtualization">
468       <title>Virtualization Support</title>
469
470       <para revision="306520" contrib="sponsor"
471         sponsor="&chelsio;"><acronym>PCI</acronym> passthrough with
472         &man.bhyve.4; resets functions via <acronym>FLR</acronym> when
473         a virtual machine is started and stopped.</para>
474
475       <para revision="306472" contrib="sponsor"
476         sponsor="&chelsio;"><acronym>PCI</acronym> passthrough with
477         &man.bhyve.4; supports more dynamic configurations permitting
478         devices to be marked for passthrough or host use at
479         runtime.</para>
480     </sect2>
481
482     <sect2 xml:id="hardware-arm">
483       <title>ARM Support</title>
484
485       <para>&nbsp;</para>
486     </sect2>
487   </sect1>
488
489   <sect1 xml:id="storage">
490     <title>Storage</title>
491
492     <para>This section covers changes and additions to file systems
493       and other storage subsystems, both local and networked.</para>
494
495     <sect2 xml:id="storage-general">
496       <title>General Storage</title>
497
498       <para>&nbsp;</para>
499     </sect2>
500
501     <sect2 xml:id="storage-net">
502       <title>Networked Storage</title>
503
504       <para revision="318675">The <acronym>NFS</acronym> client now
505         properly handles <literal>NFS4ERR_BAD_SESSION</literal> errors
506         received from an <acronym>NFS</acronym> server.  Additionally,
507         the kernel <acronym>RPC</acronym> client has been updated to
508         prevent creating new <acronym>TCP</acronym> connections when
509         <literal>ERESTART</literal> is received from
510         &man.sosend.9;.</para>
511
512       <para revision="321031">The <acronym>NFS</acronym> client has
513         been updated to support <acronym>pNFS</acronym>
514         <literal>commit</literal> through the
515         <literal>DS</literal>.</para>
516     </sect2>
517
518     <sect2 xml:id="storage-zfs">
519       <title>ZFS</title>
520
521       <para></para>
522     </sect2>
523
524     <sect2 xml:id="storage-geom">
525       <title>&man.geom.4;</title>
526
527       <para>&nbsp;</para>
528     </sect2>
529   </sect1>
530
531   <sect1 xml:id="boot">
532     <title>Boot Loader Changes</title>
533
534     <para>This section covers the boot loader, boot menu, and other
535       boot-related changes.</para>
536
537     <sect2 xml:id="boot-loader">
538       <title>Boot Loader Changes</title>
539
540       <para>&nbsp;</para>
541     </sect2>
542
543     <sect2 xml:id="boot-menu">
544       <title>Boot Menu Changes</title>
545
546       <para>&nbsp;</para>
547     </sect2>
548   </sect1>
549
550   <sect1 xml:id="network">
551     <title>Networking</title>
552
553     <para>This section describes changes that affect networking in
554       &os;.</para>
555
556     <sect2 xml:id="network-general">
557       <title>General Networking Changes</title>
558
559       <para revision="313558" contrib="sponsor"
560         sponsor="&dellemc;">The network stack has been modified to fix
561         incorrect or invalid <acronym>IP</acronym> addresses if
562         multiple threads emit a <acronym>UDP</acronym>
563         <literal>log_in_vain</literal> message concurrently.</para>
564
565       <para revision="317375" contrib="sponsor"
566         sponsor="&multiplay;">The <acronym>TCP</acronym> stack has
567         been changed to use the estimated <acronym>RTT</acronym>
568         instead of timestamps for receive buffer auto resizing.</para>
569     </sect2>
570
571     <sect2 xml:id="network-protocols">
572       <title>Network Protocols</title>
573
574       <para revision="309340" contrib="sponsor"
575         sponsor="&dellemc;">Support for <acronym>GARP</acronym>
576         (gratuitous <acronym>ARP</acronym>) retransmit has been added.
577         A new &man.sysctl.8;,
578         <literal>net.link.ether.inet.garp_rexmit_count</literal>, has
579         been added, which sets the maximum number of retransmissions
580         when set to a non-zero value.</para>
581     </sect2>
582   </sect1>
583
584   <sect1 xml:id="ports">
585     <title>Ports Collection and Package Infrastructure</title>
586
587     <para>This section covers changes to the &os;&nbsp;Ports
588       Collection, package infrastructure, and package maintenance and
589       installation tools.</para>
590
591     <sect2 xml:id="ports-infrastructure">
592       <title>Infrastructure Changes</title>
593
594       <para>&nbsp;</para>
595     </sect2>
596
597     <sect2 xml:id="ports-packages ">
598       <title>Packaging Changes</title>
599
600       <para>&nbsp;</para>
601     </sect2>
602   </sect1>
603
604   <sect1 xml:id="doc">
605     <title>Documentation</title>
606
607     <para>This section covers changes to the &os;&nbsp;Documentation
608       Project sources and toolchain.</para>
609
610     <sect2 xml:id="doc-sources">
611       <title>Documentation Source Changes</title>
612
613       <para>&nbsp;</para>
614     </sect2>
615
616     <sect2 xml:id="doc-toolchain">
617       <title>Documentation Toolchain Changes</title>
618
619       <para>&nbsp;</para>
620     </sect2>
621   </sect1>
622
623   <sect1 xml:id="releng">
624     <title>Release Engineering and Integration</title>
625
626     <para>This section convers changes that are specific to the
627       &os;&nbsp;Release Engineering processes.</para>
628
629     <sect2 xml:id="releng-changes">
630       <title>Integration Changes</title>
631
632       <para>&nbsp;</para>
633     </sect2>
634   </sect1>
635 </article>