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