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