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