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