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