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