article.xml revision 285306
1252504Slstewart<?xml version="1.0" encoding="iso-8859-1"?> 2252504Slstewart<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" 3252504Slstewart "../../../share/xml/freebsd50.dtd" [ 4252504Slstewart<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent"> 5252504Slstewart %release; 6252504Slstewart<!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "sponsor.ent"> 7252504Slstewart %sponsor; 8252504Slstewart<!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "vendor.ent"> 9252504Slstewart %vendor; 10252504Slstewart<!ENTITY security SYSTEM "../../share/xml/security.xml"> 11252504Slstewart<!ENTITY errata SYSTEM "../../share/xml/errata.xml"> 12252504Slstewart]> 13252504Slstewart<article xmlns="http://docbook.org/ns/docbook" 14252504Slstewart xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"> 15252504Slstewart 16252504Slstewart <info> 17252504Slstewart <title>&os; &release.current; Release Notes</title> 18252504Slstewart 19252504Slstewart <author> 20252504Slstewart <orgname>The &os; Project</orgname> 21252504Slstewart </author> 22252504Slstewart 23252504Slstewart <pubdate>$FreeBSD: stable/10/release/doc/en_US.ISO8859-1/relnotes/article.xml 285306 2015-07-09 05:46:37Z gjb $</pubdate> 24252504Slstewart 25252504Slstewart <!-- Last rev: 284813 --> 26252504Slstewart 27252504Slstewart <copyright> 28252504Slstewart <year>2015</year> 29252504Slstewart <holder role="mailto:doc@FreeBSD.org">The &os; Documentation 30252504Slstewart Project</holder> 31252504Slstewart </copyright> 32252504Slstewart 33252504Slstewart <legalnotice xml:id="trademarks" role="trademarks"> 34252504Slstewart &tm-attrib.freebsd; 35252504Slstewart &tm-attrib.ibm; 36252504Slstewart &tm-attrib.ieee; 37252504Slstewart &tm-attrib.intel; 38252504Slstewart &tm-attrib.sparc; 39252504Slstewart &tm-attrib.general; 40252504Slstewart </legalnotice> 41252504Slstewart 42252504Slstewart <abstract> 43252504Slstewart <para>The release notes for &os; &release.current; contain 44252504Slstewart a summary of the changes made to the &os; base system on the 45252504Slstewart &release.branch; development line. This document lists 46252504Slstewart applicable security advisories that were issued since the last 47252504Slstewart release, as well as significant changes to the &os; kernel and 48252504Slstewart userland. Some brief remarks on upgrading are also 49252504Slstewart presented.</para> 50252504Slstewart </abstract> 51252504Slstewart </info> 52252504Slstewart 53252504Slstewart <sect1 xml:id="intro"> 54252504Slstewart <title>Introduction</title> 55252504Slstewart 56252504Slstewart <para>This document contains the release notes for &os; 57252504Slstewart &release.current;. It describes recently added, changed, or 58252504Slstewart deleted features of &os;. It also provides some notes on 59252504Slstewart upgrading from previous versions of &os;.</para> 60252504Slstewart 61252504Slstewart <para releasetype="current">The &release.type; distribution to 62252504Slstewart which these release notes apply represents the latest point 63252504Slstewart along the &release.branch; development branch since 64252504Slstewart &release.branch; was created. Information regarding pre-built, 65252504Slstewart binary &release.type; distributions along this branch can be 66252504Slstewart found at <uri 67252504Slstewart xlink:href="&release.url;">&release.url;</uri>.</para> 68252504Slstewart 69252504Slstewart <para releasetype="snapshot">The &release.type; distribution to 70252504Slstewart which these release notes apply represents a point along the 71252504Slstewart &release.branch; development branch between &release.prev; and 72252504Slstewart the future &release.next;. Information regarding pre-built, 73252504Slstewart binary &release.type; distributions along this branch can be 74252504Slstewart found at <uri 75252504Slstewart xlink:href="&release.url;">&release.url;</uri>.</para> 76252504Slstewart 77252504Slstewart <para releasetype="release">This distribution of &os; 78252504Slstewart &release.current; is a &release.type; distribution. It can be 79252504Slstewart found at <uri xlink:href="&release.url;">&release.url;</uri> or 80252504Slstewart any of its mirrors. More information on obtaining this (or 81252504Slstewart other) &release.type; distributions of &os; can be found in the 82252504Slstewart <link 83252504Slstewart xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining 84252504Slstewart &os;</quote> appendix</link> to the <link 85252504Slstewart xlink:href="&url.books.handbook;/">&os; 86252504Slstewart Handbook</link>.</para> 87252504Slstewart 88252504Slstewart <para>All users are encouraged to consult the release errata 89252504Slstewart before installing &os;. The errata document is updated with 90252504Slstewart <quote>late-breaking</quote> information discovered late in the 91252504Slstewart release cycle or after the release. Typically, it contains 92252504Slstewart information on known bugs, security advisories, and corrections 93252504Slstewart to documentation. An up-to-date copy of the errata for &os; 94252504Slstewart &release.current; can be found on the &os; Web site.</para> 95252504Slstewart 96252504Slstewart <para>This document describes the most user-visible new or changed 97252504Slstewart features in &os; since &release.prev;.</para> 98252504Slstewart 99252504Slstewart <para>Typical release note items document recent security 100252504Slstewart advisories issued after &release.prev;, new drivers or hardware 101252504Slstewart support, new commands or options, major bug fixes, or 102252504Slstewart contributed software upgrades. They may also list changes to 103252504Slstewart major ports/packages or release engineering practices. Clearly 104252504Slstewart the release notes cannot list every single change made to &os; 105252504Slstewart between releases; this document focuses primarily on security 106252504Slstewart advisories, user-visible changes, and major architectural 107252504Slstewart improvements.</para> 108252504Slstewart </sect1> 109252504Slstewart 110252504Slstewart <sect1 xml:id="upgrade"> 111252504Slstewart <title>Upgrading from Previous Releases of &os;</title> 112252504Slstewart 113252504Slstewart <para arch="amd64,i386">Binary upgrades between RELEASE versions 114252504Slstewart (and snapshots of the various security branches) are supported 115252504Slstewart using the &man.freebsd-update.8; utility. The binary upgrade 116252504Slstewart procedure will update unmodified userland utilities, as well as 117252504Slstewart unmodified <filename>GENERIC</filename> kernel distributed as 118252504Slstewart a part of an official &os; release. The &man.freebsd-update.8; 119252504Slstewart utility requires that the host being upgraded have Internet 120252504Slstewart connectivity.</para> 121252504Slstewart 122252504Slstewart <para>Source-based upgrades (those based on recompiling the &os; 123252504Slstewart base system from source code) from previous versions are 124252504Slstewart supported, according to the instructions in 125252504Slstewart <filename>/usr/src/UPDATING</filename>.</para> 126252504Slstewart 127252504Slstewart <important> 128252504Slstewart <para>Upgrading &os; should only be attempted after 129252504Slstewart backing up <emphasis>all</emphasis> data and configuration 130252504Slstewart files.</para> 131252504Slstewart </important> 132252504Slstewart </sect1> 133252504Slstewart 134252504Slstewart <sect1 xml:id="security-errata"> 135252504Slstewart <title>Security and Errata</title> 136252504Slstewart 137252504Slstewart <para>This section lists the various Security Advisories and 138252504Slstewart Errata Notices since &release.prev;.</para> 139252504Slstewart 140252504Slstewart <sect2 xml:id="security"> 141252504Slstewart <title>Security Advisories</title> 142252504Slstewart 143252504Slstewart &security; 144252504Slstewart </sect2> 145252504Slstewart 146252504Slstewart <sect2 xml:id="errata"> 147252504Slstewart <title>Errata Notices</title> 148252504Slstewart 149252504Slstewart &errata; 150252504Slstewart </sect2> 151252504Slstewart </sect1> 152252504Slstewart 153252504Slstewart <sect1 xml:id="userland"> 154252504Slstewart <title>Userland</title> 155252504Slstewart 156 <para>This section covers changes and additions to userland 157 applications, contributed software, and system utilities.</para> 158 159 <sect2 xml:id="userland-config"> 160 <title>Userland Configuration Changes</title> 161 162 <para revision="276991">The &man.termcap.5; file is installed 163 as-is from sources, instead of reordering, creating 164 <filename>/etc/termcap.db</filename> by default, providing 165 a performance improvements to applications that use the 166 &man.termcap.5; database, such as &man.vi.1; and 167 &man.ncurses.3;.</para> 168 </sect2> 169 170 <sect2 xml:id="userland-programs"> 171 <title>Userland Application Changes</title> 172 173 <para revision="275040">A new utility, &man.dpv.1;, has been 174 added to the base system, providing a &man.dialog.1;-style 175 progress view from one or more input streams. A corresponding 176 library, &man.dpv.3;, has also been added.</para> 177 178 <para revision="275945">The &man.elfdump.1; utility has been 179 updated to support capability mode provided by 180 &man.capsicum.4;.</para> 181 182 <para revision="277434" contrib="sponsor" sponsor="&ff;">The 183 &man.fstyp.8; utility has been added, which is used to 184 determine the filesystem on a specified device.</para> 185 186 <para revision="281044">A regression in the &man.libarchive.3; 187 library that would prevent a directory from being included in 188 the archive when <literal>--one-file-system</literal> is used 189 has been fixed.</para> 190 191 <para revision="281161" contrib="sponsor" 192 sponsor="&limelight;">A new flag, <literal>-R</literal>, has 193 been added to the &man.netstat.8; utility, which is used to 194 dump <acronym>RSS</acronym>/flow information.</para> 195 196 <para revision="281936" contrib="sponsor" sponsor="&ff;">The 197 &man.ar.1; utility has been updated to set 198 <literal>ARCHIVE_EXTRACT_SECURE_SYMLINKS</literal> and 199 <literal>ARCHIVE_EXTRACT_SECURE_NODOTDOT</literal> to disallow 200 directory traversal when extracting an archive, similar to 201 &man.tar.1;.</para> 202 203 <para revision="282278">A race condition in &man.wc.1; that 204 would cause final results to be sent to &man.stderr.4; when 205 receiving the <literal>SIGINFO</literal> signal has been 206 fixed.</para> 207 208 <para revision="282870" contrib="sponsor" 209 sponsor="&scaleengine;">The &man.freebsd-update.8; utility has 210 been updated to prevent fetching updated binary patches when 211 a previous upgrade has not been thoroughly completed.</para> 212 213 <para revision="282974" contrib="sponsor" sponsor="&ff;">The 214 &man.uefisign.8; utility has been added.</para> 215 216 <para revision="283875" contrib="sponsor" 217 sponsor="&multiplay;">The &man.chflags.1;, &man.chgrp.1;, 218 &man.chmod.1;, and &man.chown.8; utilities now affect symbolic 219 links when the <literal>-R</literal> flag is specified, as 220 documented in &man.symlink.7;.</para> 221 222 <para revision="285092">The &man.pw.8; utility has been updated 223 with a new flag, <literal>-R</literal>, that sets the root 224 directory within which the utility will operate.</para> 225 </sect2> 226 227 <sect2 xml:id="userland-contrib"> 228 <title>Contributed Software</title> 229 230 <para revision="277592"><application>file</application> has been 231 updated to version 5.22.</para> 232 233 <para revision="282746" contrib="sponsor" sponsor="&ff;">The 234 &man.resolvconf.8; utility has been updated to version 235 3.7.0.</para> 236 237 <para revision="284330"><application>OpenSSL</application> has 238 been updated to version 1.0.1o.</para> 239 240 <para revision="284460">The &man.acpi.4; subsystem has been 241 updated to version 20150515.</para> 242 243 <para revision="284778">The &man.file.1; utility has been 244 updated to version 5.23.</para> 245 246 <para revision="285206">The &man.unbound.8; utility has been 247 updated to version 1.5.3.</para> 248 249 <para revision="285305">The <application>sendmail</application> 250 utility has been updated to version 8.15.2.</para> 251 </sect2> 252 253 <sect2 xml:id="userland-installer"> 254 <title>Installation and Configuration Tools</title> 255 256 <para> </para> 257 </sect2> 258 259 <sect2 xml:id="userland-rc"> 260 <title><filename class="directory">/etc/rc.d</filename> 261 Scripts</title> 262 263 <para> </para> 264 </sect2> 265 266 <sect2 xml:id="userland-periodic"> 267 <title><filename class="directory">/etc/periodic</filename> 268 Scripts</title> 269 270 <para> </para> 271 </sect2> 272 273 <sect2 xml:id="userland-libraries"> 274 <title>Runtime Libraries and API</title> 275 276 <para revision="275040">A new file configuration library, 277 &man.figpar.3;, has been added to the base system.</para> 278 279 <para revision="280392">The &man.setmode.3; function has been 280 updated to consistently set <literal>errno</literal> on 281 failure.</para> 282 </sect2> 283 284 <sect2 xml:id="userland-abi"> 285 <title>ABI Compatibility</title> 286 287 <para> </para> 288 </sect2> 289 </sect1> 290 291 <sect1 xml:id="kernel"> 292 <title>Kernel</title> 293 294 <para>This section covers changes to kernel configurations, system 295 tuning, and system control parameters that are not otherwise 296 categorized.</para> 297 298 <sect2 xml:id="kernel-bugfix"> 299 <title>Kernel Bug Fixes</title> 300 301 <para> </para> 302 </sect2> 303 304 <sect2 xml:id="kernel-config"> 305 <title>Kernel Configuration</title> 306 307 <para revision="284522" contrib="sponsor" 308 sponsor="&limelight;">A new kernel configuration option, 309 <literal>EM_MULTIQUEUE</literal>, has been added which enables 310 multi-queue support in the &man.em.4; driver.</para> 311 312 <note> 313 <para>Multi-queue support in the &man.em.4; driver is not 314 officially supported by &intel;.</para> 315 </note> 316 </sect2> 317 318 <sect2 xml:id="kernel-sysctl"> 319 <title>System Tuning and Controls</title> 320 321 <para revision="276986">Throttling via <acronym>ACPI</acronym> 322 and <acronym>P4TCC</acronym> via &man.device.hints.5; have 323 been turned off by default.</para> 324 325 <para revision="278982" contrib="sponsor" sponsor="&ff;">The 326 &man.hwpmc.4; default and maximum callchain depths have been 327 increased. The default has been increased from 16 to 32, and 328 the maximum increased from 32 to 128.</para> 329 330 <para revision="281255" contrib="sponsor" 331 sponsor="&ix;, &ff;">The &man.devfs.5; device filesystem has 332 been changed to update timestamps for read/write operations 333 using seconds precision. A new &man.sysctl.8;, 334 <literal>vfs.devfs.dotimes</literal> has been added, which 335 when set to a non-zero value, enables default precision 336 timestamps for these operations.</para> 337 338 <para revision="280632">The <literal>kern.osrelease</literal> 339 and <literal>kern.osreldate</literal> are now configurable 340 &man.jail.8; parameters.</para> 341 342 <para revision="284665" contrib="sponsor" sponsor="&ff;">A new 343 &man.sysctl.8;, <literal>kern.racct.enable</literal>, has been 344 added, which when set to a non-zero value allows using 345 &man.rctl.8; with the <literal>GENERIC</literal> kernel. 346 A new kernel configuration option, 347 <literal>RACCT_DISABLED</literal> has also been added.</para> 348 349 <para revision="284665" contrib="sponsor" sponsor="&ff;">The 350 <literal>GENERIC</literal> kernel configuration now includes 351 <literal>RACCT</literal> and <literal>RCTL</literal> by 352 default.</para> 353 354 <note> 355 <para>To enable <literal>RACCT</literal> and 356 <literal>RCTL</literal> on a system using the 357 <literal>GENERIC</literal> kernel configuration, add 358 <literal>kern.racct.enable=1</literal> to 359 &man.loader.conf.5;, and reboot the system.</para> 360 </note> 361 </sect2> 362 </sect1> 363 364 <sect1 xml:id="drivers"> 365 <title>Devices and Drivers</title> 366 367 <para>This section covers changes and additions to devices and 368 device drivers since &release.prev;.</para> 369 370 <sect2 xml:id="drivers-device"> 371 <title>Device Drivers</title> 372 373 <para revision="282199">The <literal>drm</literal> code has 374 been updated to match &linux; version 3.8.13.</para> 375 </sect2> 376 377 <sect2 xml:id="drivers-storage"> 378 <title>Storage Drivers</title> 379 380 <para revision="281957">The &man.hptnr.4; driver has been 381 updated to version 1.1.1.</para> 382 </sect2> 383 384 <sect2 xml:id="drivers-network"> 385 <title>Network Drivers</title> 386 387 <para> </para> 388 </sect2> 389 </sect1> 390 391 <sect1 xml:id="hardware"> 392 <title>Hardware Support</title> 393 394 <para>This section covers general hardware support for physical 395 machines, hypervisors, and virtualization environments, as well 396 as hardware changes and updates that do not otherwise fit in 397 other sections of this document.</para> 398 399 <sect2 xml:id="hardware-support"> 400 <title>Hardware Support</title> 401 402 <para> </para> 403 </sect2> 404 405 <sect2 xml:id="hardware-virtualization"> 406 <title>Virtualization Support</title> 407 408 <para revision="280370">The &man.bhyve.8; hypervisor has been 409 updated to support <literal>DSM TRIM</literal> commands for 410 virtual <acronym>AHCI</acronym> disks.</para> 411 412 <para revision="283280" contrib="sponsor" sponsor="&msostc;">The 413 Hyper-V™ drivers have been updated with several 414 enhancements:</para> 415 416 <itemizedlist> 417 <listitem> 418 <para>The &man.hv.vmbus.4; driver now has multi-channel 419 support.</para> 420 </listitem> 421 422 <listitem> 423 <para>The &man.hv.storvsc.4; driver now has scatter/gather 424 support, in addition to performance improvements.</para> 425 </listitem> 426 427 <listitem> 428 <para>The &man.hv.kvp.4; driver has received several bug 429 fixes.</para> 430 </listitem> 431 </itemizedlist> 432 433 <para revision="285236" contrib="sponsor" sponsor="&msostc;">The 434 &man.hv.netvsc.4; driver has been updated to support checksum 435 offloading and <acronym>TSO</acronym>.</para> 436 </sect2> 437 438 <sect2 xml:id="hardware-arm"> 439 <title>ARM Support</title> 440 441 <para revision="278608">The <literal>bcm2835_cpufreq</literal> 442 driver has been added, which supports <acronym>CPU</acronym> 443 frequency and voltage control on the Raspberry Pi 444 <acronym>SOC</acronym>.</para> 445 </sect2> 446 </sect1> 447 448 <sect1 xml:id="storage"> 449 <title>Storage</title> 450 451 <para>This section covers changes and additions to file systems 452 and other storage subsystems, both local and networked.</para> 453 454 <sect2 xml:id="storage-general"> 455 <title>General Storage</title> 456 457 <para revision="279002" contrib="sponsor" sponsor="&ix;">The 458 &man.ctl.4; <acronym>LUN</acronym> mapping has been rewritten, 459 replacing <acronym>iSCSI</acronym>-specific mapping mechanisms 460 with a new mechanism that works for any port.</para> 461 462 <para revision="279055" contrib="sponsor" sponsor="&ix;">The 463 &man.ctld.8; utility has been updated to allow controlling 464 non-<acronym>iSCSI</acronym> &man.ctl.4; ports.</para> 465 466 <para revision="283223" contrib="sponsor" sponsor="&ff;">The 467 &man.autofs.5; subsystem has been updated to include a new 468 &man.auto.master.5; map, <literal>-media</literal>, which 469 allows automatically mounting removable media, such as 470 <acronym>CD</acronym> drives or <acronym>USB</acronym> flash 471 drives.</para> 472 473 <para revision="283242" contrib="sponsor" sponsor="&ff;">The 474 &man.autofs.5; subsystem has been updated to include a new 475 &man.auto.master.5; map, <literal>-noauto</literal>, which 476 handles &man.fstab.5; entries set to 477 <literal>noauto</literal>.</para> 478 </sect2> 479 480 <sect2 xml:id="storage-net"> 481 <title>Networked Storage</title> 482 483 <para revision="274939" contrib="sponsor" sponsor="&ix;">The 484 &man.ctld.8; utility has been updated to include support for 485 registering <acronym>iSCSI</acronym> targets and portals on 486 <acronym>iSNS</acronym> servers. This provides a mechanism 487 which allows <acronym>iSCSI</acronym> initiators to find 488 targets and portals without requiring active 489 discovery.</para> 490 </sect2> 491 492 <sect2 xml:id="storage-zfs"> 493 <title>ZFS</title> 494 495 <para revision="275490">A new tunable, 496 <literal>vfs.zfs.spa_slop_shift</literal>, has been added, 497 which controls how much space is reserved by default.</para> 498 499 <para revision="277583">The <literal>arc_meta_limit</literal> 500 statistics are now visible through the 501 <literal>kstat</literal> &man.sysctl.8;. As a result of this 502 change, the <literal>vfs.zfs.arc_meta_used</literal> 503 &man.sysctl.8; has been removed, and replaced with the 504 <literal>kstat.zfs.misc.arcstats.arc_meta_used</literal> 505 &man.sysctl.8;.</para> 506 </sect2> 507 508 <sect2 xml:id="storage-geom"> 509 <title>&man.geom.4;</title> 510 511 <para revision="275891" contrib="sponsor" sponsor="&ix;">The 512 &man.ctl.4; subsystem has been updated, increasing the ports 513 limit from <literal>128</literal> to <literal>256</literal>, 514 and <acronym>LUN</acronym> limit from <literal>256</literal> 515 to <literal>1024</literal>.</para> 516 </sect2> 517 </sect1> 518 519 <sect1 xml:id="boot"> 520 <title>Boot Loader Changes</title> 521 522 <para>This section covers the boot loader, boot menu, and other 523 boot-related changes.</para> 524 525 <sect2 xml:id="boot-loader"> 526 <title>Boot Loader Changes</title> 527 528 <para revision="281843">The boot loader has been updated to 529 support entering the <acronym>GELI</acronym> passphrase before 530 loading the kernel. To enable this behavior, add 531 <literal>geom_eli_passphrase_prompt="YES"</literal> to 532 &man.loader.conf.5;.</para> 533 534 <para revision="283262" contrib="sponsor" sponsor="&ff;">The 535 memory test run at boot time on &os;/&arch.amd64; platforms 536 has been disabled by default.</para> 537 </sect2> 538 539 <sect2 xml:id="boot-menu"> 540 <title>Boot Menu Changes</title> 541 542 <para> </para> 543 </sect2> 544 </sect1> 545 546 <sect1 xml:id="network"> 547 <title>Networking</title> 548 549 <para>This section describes changes that affect networking in 550 &os;.</para> 551 552 <sect2 xml:id="network-protocols"> 553 <title>Network Procols</title> 554 555 <para> </para> 556 </sect2> 557 </sect1> 558 559 <sect1 xml:id="ports"> 560 <title>Ports Collection and Package Infrastructure</title> 561 562 <para>This section covers changes to the &os; Ports 563 Collection, package infrastructure, and package maintenance and 564 installation tools.</para> 565 566 <sect2 xml:id="ports-infrastructure"> 567 <title>Infrastructure Changes</title> 568 569 <para> </para> 570 </sect2> 571 572 <sect2 xml:id="ports-packages "> 573 <title>Packaging Changes</title> 574 575 <para> </para> 576 </sect2> 577 </sect1> 578 579 <sect1 xml:id="doc"> 580 <title>Documentation</title> 581 582 <para>This section covers changes to the &os; Documentation 583 Project sources and toolchain.</para> 584 585 <sect2 xml:id="doc-sources"> 586 <title>Documentation Source Changes</title> 587 588 <para> </para> 589 </sect2> 590 591 <sect2 xml:id="doc-toolchain"> 592 <title>Documentation Toolchain Changes</title> 593 594 <para> </para> 595 </sect2> 596 </sect1> 597 598 <sect1 xml:id="releng"> 599 <title>Release Engineering and Integration</title> 600 601 <para>This section convers changes that are specific to the 602 &os; Release Engineering processes.</para> 603 604 <sect2 xml:id="releng-changes"> 605 <title>Integration Changes</title> 606 607 <para> </para> 608 </sect2> 609 </sect1> 610</article> 611