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