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