article.xml revision 285472
1<?xml version="1.0" encoding="iso-8859-1"?> 2<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" 3 "../../../share/xml/freebsd50.dtd" [ 4<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent"> 5 %release; 6<!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "sponsor.ent"> 7 %sponsor; 8<!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "vendor.ent"> 9 %vendor; 10<!ENTITY security SYSTEM "../../share/xml/security.xml"> 11<!ENTITY errata SYSTEM "../../share/xml/errata.xml"> 12]> 13<article xmlns="http://docbook.org/ns/docbook" 14 xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"> 15 16 <info> 17 <title>&os; &release.current; Release Notes</title> 18 19 <author> 20 <orgname>The &os; Project</orgname> 21 </author> 22 23 <pubdate>$FreeBSD: stable/10/release/doc/en_US.ISO8859-1/relnotes/article.xml 285472 2015-07-13 15:45:42Z gjb $</pubdate> 24 25 <!-- Last rev: 284813 --> 26 27 <copyright> 28 <year>2015</year> 29 <holder role="mailto:doc@FreeBSD.org">The &os; Documentation 30 Project</holder> 31 </copyright> 32 33 <legalnotice xml:id="trademarks" role="trademarks"> 34 &tm-attrib.freebsd; 35 &tm-attrib.ibm; 36 &tm-attrib.ieee; 37 &tm-attrib.intel; 38 &tm-attrib.sparc; 39 &tm-attrib.general; 40 </legalnotice> 41 42 <abstract> 43 <para>The release notes for &os; &release.current; contain 44 a summary of the changes made to the &os; base system on the 45 &release.branch; development line. This document lists 46 applicable security advisories that were issued since the last 47 release, as well as significant changes to the &os; kernel and 48 userland. Some brief remarks on upgrading are also 49 presented.</para> 50 </abstract> 51 </info> 52 53 <sect1 xml:id="intro"> 54 <title>Introduction</title> 55 56 <para>This document contains the release notes for &os; 57 &release.current;. It describes recently added, changed, or 58 deleted features of &os;. It also provides some notes on 59 upgrading from previous versions of &os;.</para> 60 61 <para releasetype="current">The &release.type; distribution to 62 which these release notes apply represents the latest point 63 along the &release.branch; development branch since 64 &release.branch; was created. Information regarding pre-built, 65 binary &release.type; distributions along this branch can be 66 found at <uri 67 xlink:href="&release.url;">&release.url;</uri>.</para> 68 69 <para releasetype="snapshot">The &release.type; distribution to 70 which these release notes apply represents a point along the 71 &release.branch; development branch between &release.prev; and 72 the future &release.next;. Information regarding pre-built, 73 binary &release.type; distributions along this branch can be 74 found at <uri 75 xlink:href="&release.url;">&release.url;</uri>.</para> 76 77 <para releasetype="release">This distribution of &os; 78 &release.current; is a &release.type; distribution. It can be 79 found at <uri xlink:href="&release.url;">&release.url;</uri> or 80 any of its mirrors. More information on obtaining this (or 81 other) &release.type; distributions of &os; can be found in the 82 <link 83 xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining 84 &os;</quote> appendix</link> to the <link 85 xlink:href="&url.books.handbook;/">&os; 86 Handbook</link>.</para> 87 88 <para>All users are encouraged to consult the release errata 89 before installing &os;. The errata document is updated with 90 <quote>late-breaking</quote> information discovered late in the 91 release cycle or after the release. Typically, it contains 92 information on known bugs, security advisories, and corrections 93 to documentation. An up-to-date copy of the errata for &os; 94 &release.current; can be found on the &os; Web site.</para> 95 96 <para>This document describes the most user-visible new or changed 97 features in &os; since &release.prev;.</para> 98 99 <para>Typical release note items document recent security 100 advisories issued after &release.prev;, new drivers or hardware 101 support, new commands or options, major bug fixes, or 102 contributed software upgrades. They may also list changes to 103 major ports/packages or release engineering practices. Clearly 104 the release notes cannot list every single change made to &os; 105 between releases; this document focuses primarily on security 106 advisories, user-visible changes, and major architectural 107 improvements.</para> 108 </sect1> 109 110 <sect1 xml:id="upgrade"> 111 <title>Upgrading from Previous Releases of &os;</title> 112 113 <para arch="amd64,i386">Binary upgrades between RELEASE versions 114 (and snapshots of the various security branches) are supported 115 using the &man.freebsd-update.8; utility. The binary upgrade 116 procedure will update unmodified userland utilities, as well as 117 unmodified <filename>GENERIC</filename> kernel distributed as 118 a part of an official &os; release. The &man.freebsd-update.8; 119 utility requires that the host being upgraded have Internet 120 connectivity.</para> 121 122 <para>Source-based upgrades (those based on recompiling the &os; 123 base system from source code) from previous versions are 124 supported, according to the instructions in 125 <filename>/usr/src/UPDATING</filename>.</para> 126 127 <important> 128 <para>Upgrading &os; should only be attempted after 129 backing up <emphasis>all</emphasis> data and configuration 130 files.</para> 131 </important> 132 </sect1> 133 134 <sect1 xml:id="security-errata"> 135 <title>Security and Errata</title> 136 137 <para>This section lists the various Security Advisories and 138 Errata Notices since &release.prev;.</para> 139 140 <sect2 xml:id="security"> 141 <title>Security Advisories</title> 142 143 &security; 144 </sect2> 145 146 <sect2 xml:id="errata"> 147 <title>Errata Notices</title> 148 149 &errata; 150 </sect2> 151 </sect1> 152 153 <sect1 xml:id="userland"> 154 <title>Userland</title> 155 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 226 <para revision="283258">The &man.date.1; utility has been 227 updated to print the modification time of the file passed as 228 an argument to the <literal>-r</literal> flag, improving 229 compatibility with the <acronym>GNU</acronym> &man.date.1; 230 utility behavior.</para> 231 </sect2> 232 233 <sect2 xml:id="userland-contrib"> 234 <title>Contributed Software</title> 235 236 <para revision="282746" contrib="sponsor" sponsor="&ff;">The 237 &man.resolvconf.8; utility has been updated to version 238 3.7.0.</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 252 <para revision="285330"><application>OpenSSL</application> has 253 been updated to version 1.0.1p.</para> 254 </sect2> 255 256 <sect2 xml:id="userland-installer"> 257 <title>Installation and Configuration Tools</title> 258 259 <para> </para> 260 </sect2> 261 262 <sect2 xml:id="userland-rc"> 263 <title><filename class="directory">/etc/rc.d</filename> 264 Scripts</title> 265 266 <para> </para> 267 </sect2> 268 269 <sect2 xml:id="userland-periodic"> 270 <title><filename class="directory">/etc/periodic</filename> 271 Scripts</title> 272 273 <para> </para> 274 </sect2> 275 276 <sect2 xml:id="userland-libraries"> 277 <title>Runtime Libraries and API</title> 278 279 <para revision="275040">A new file configuration library, 280 &man.figpar.3;, has been added to the base system.</para> 281 282 <para revision="280392">The &man.setmode.3; function has been 283 updated to consistently set <literal>errno</literal> on 284 failure.</para> 285 </sect2> 286 287 <sect2 xml:id="userland-abi"> 288 <title>ABI Compatibility</title> 289 290 <para> </para> 291 </sect2> 292 </sect1> 293 294 <sect1 xml:id="kernel"> 295 <title>Kernel</title> 296 297 <para>This section covers changes to kernel configurations, system 298 tuning, and system control parameters that are not otherwise 299 categorized.</para> 300 301 <sect2 xml:id="kernel-bugfix"> 302 <title>Kernel Bug Fixes</title> 303 304 <para> </para> 305 </sect2> 306 307 <sect2 xml:id="kernel-config"> 308 <title>Kernel Configuration</title> 309 310 <para revision="284522" contrib="sponsor" 311 sponsor="&limelight;">A new kernel configuration option, 312 <literal>EM_MULTIQUEUE</literal>, has been added which enables 313 multi-queue support in the &man.em.4; driver.</para> 314 315 <note> 316 <para>Multi-queue support in the &man.em.4; driver is not 317 officially supported by &intel;.</para> 318 </note> 319 </sect2> 320 321 <sect2 xml:id="kernel-sysctl"> 322 <title>System Tuning and Controls</title> 323 324 <para revision="276986">Throttling via <acronym>ACPI</acronym> 325 and <acronym>P4TCC</acronym> via &man.device.hints.5; have 326 been turned off by default.</para> 327 328 <para revision="278982" contrib="sponsor" sponsor="&ff;">The 329 &man.hwpmc.4; default and maximum callchain depths have been 330 increased. The default has been increased from 16 to 32, and 331 the maximum increased from 32 to 128.</para> 332 333 <para revision="281255" contrib="sponsor" 334 sponsor="&ix;, &ff;">The &man.devfs.5; device filesystem has 335 been changed to update timestamps for read/write operations 336 using seconds precision. A new &man.sysctl.8;, 337 <literal>vfs.devfs.dotimes</literal> has been added, which 338 when set to a non-zero value, enables default precision 339 timestamps for these operations.</para> 340 341 <para revision="280632">The <literal>kern.osrelease</literal> 342 and <literal>kern.osreldate</literal> are now configurable 343 &man.jail.8; parameters.</para> 344 345 <para revision="284665" contrib="sponsor" sponsor="&ff;">A new 346 &man.sysctl.8;, <literal>kern.racct.enable</literal>, has been 347 added, which when set to a non-zero value allows using 348 &man.rctl.8; with the <literal>GENERIC</literal> kernel. 349 A new kernel configuration option, 350 <literal>RACCT_DISABLED</literal> has also been added.</para> 351 352 <para revision="284665" contrib="sponsor" sponsor="&ff;">The 353 <literal>GENERIC</literal> kernel configuration now includes 354 <literal>RACCT</literal> and <literal>RCTL</literal> by 355 default.</para> 356 357 <note> 358 <para>To enable <literal>RACCT</literal> and 359 <literal>RCTL</literal> on a system using the 360 <literal>GENERIC</literal> kernel configuration, add 361 <literal>kern.racct.enable=1</literal> to 362 &man.loader.conf.5;, and reboot the system.</para> 363 </note> 364 </sect2> 365 </sect1> 366 367 <sect1 xml:id="drivers"> 368 <title>Devices and Drivers</title> 369 370 <para>This section covers changes and additions to devices and 371 device drivers since &release.prev;.</para> 372 373 <sect2 xml:id="drivers-device"> 374 <title>Device Drivers</title> 375 376 <para revision="282199">The <literal>drm</literal> code has 377 been updated to match &linux; version 3.8.13.</para> 378 </sect2> 379 380 <sect2 xml:id="drivers-storage"> 381 <title>Storage Drivers</title> 382 383 <para revision="281957">The &man.hptnr.4; driver has been 384 updated to version 1.1.1.</para> 385 </sect2> 386 387 <sect2 xml:id="drivers-network"> 388 <title>Network Drivers</title> 389 390 <para> </para> 391 </sect2> 392 </sect1> 393 394 <sect1 xml:id="hardware"> 395 <title>Hardware Support</title> 396 397 <para>This section covers general hardware support for physical 398 machines, hypervisors, and virtualization environments, as well 399 as hardware changes and updates that do not otherwise fit in 400 other sections of this document.</para> 401 402 <sect2 xml:id="hardware-support"> 403 <title>Hardware Support</title> 404 405 <para> </para> 406 </sect2> 407 408 <sect2 xml:id="hardware-virtualization"> 409 <title>Virtualization Support</title> 410 411 <para revision="280370">The &man.bhyve.8; hypervisor has been 412 updated to support <literal>DSM TRIM</literal> commands for 413 virtual <acronym>AHCI</acronym> disks.</para> 414 415 <para revision="283280" contrib="sponsor" sponsor="&msostc;">The 416 Hyper-V™ drivers have been updated with several 417 enhancements:</para> 418 419 <itemizedlist> 420 <listitem> 421 <para>The &man.hv.vmbus.4; driver now has multi-channel 422 support.</para> 423 </listitem> 424 425 <listitem> 426 <para>The &man.hv.storvsc.4; driver now has scatter/gather 427 support, in addition to performance improvements.</para> 428 </listitem> 429 430 <listitem> 431 <para>The &man.hv.kvp.4; driver has received several bug 432 fixes.</para> 433 </listitem> 434 </itemizedlist> 435 436 <para revision="285236" contrib="sponsor" sponsor="&msostc;">The 437 &man.hv.netvsc.4; driver has been updated to support checksum 438 offloading and <acronym>TSO</acronym>.</para> 439 </sect2> 440 441 <sect2 xml:id="hardware-arm"> 442 <title>ARM Support</title> 443 444 <para revision="278608">The <literal>bcm2835_cpufreq</literal> 445 driver has been added, which supports <acronym>CPU</acronym> 446 frequency and voltage control on the Raspberry Pi 447 <acronym>SOC</acronym>.</para> 448 </sect2> 449 </sect1> 450 451 <sect1 xml:id="storage"> 452 <title>Storage</title> 453 454 <para>This section covers changes and additions to file systems 455 and other storage subsystems, both local and networked.</para> 456 457 <sect2 xml:id="storage-general"> 458 <title>General Storage</title> 459 460 <para revision="279002" contrib="sponsor" sponsor="&ix;">The 461 &man.ctl.4; <acronym>LUN</acronym> mapping has been rewritten, 462 replacing <acronym>iSCSI</acronym>-specific mapping mechanisms 463 with a new mechanism that works for any port.</para> 464 465 <para revision="279055" contrib="sponsor" sponsor="&ix;">The 466 &man.ctld.8; utility has been updated to allow controlling 467 non-<acronym>iSCSI</acronym> &man.ctl.4; ports.</para> 468 469 <para revision="283223" contrib="sponsor" sponsor="&ff;">The 470 &man.autofs.5; subsystem has been updated to include a new 471 &man.auto.master.5; map, <literal>-media</literal>, which 472 allows automatically mounting removable media, such as 473 <acronym>CD</acronym> drives or <acronym>USB</acronym> flash 474 drives.</para> 475 476 <para revision="283242" contrib="sponsor" sponsor="&ff;">The 477 &man.autofs.5; subsystem has been updated to include a new 478 &man.auto.master.5; map, <literal>-noauto</literal>, which 479 handles &man.fstab.5; entries set to 480 <literal>noauto</literal>.</para> 481 </sect2> 482 483 <sect2 xml:id="storage-net"> 484 <title>Networked Storage</title> 485 486 <para revision="274939" contrib="sponsor" sponsor="&ix;">The 487 &man.ctld.8; utility has been updated to include support for 488 registering <acronym>iSCSI</acronym> targets and portals on 489 <acronym>iSNS</acronym> servers. This provides a mechanism 490 which allows <acronym>iSCSI</acronym> initiators to find 491 targets and portals without requiring active 492 discovery.</para> 493 </sect2> 494 495 <sect2 xml:id="storage-zfs"> 496 <title>ZFS</title> 497 498 <para revision="275490">A new tunable, 499 <literal>vfs.zfs.spa_slop_shift</literal>, has been added, 500 which controls how much space is reserved by default.</para> 501 502 <para revision="277583">The <literal>arc_meta_limit</literal> 503 statistics are now visible through the 504 <literal>kstat</literal> &man.sysctl.8;. As a result of this 505 change, the <literal>vfs.zfs.arc_meta_used</literal> 506 &man.sysctl.8; has been removed, and replaced with the 507 <literal>kstat.zfs.misc.arcstats.arc_meta_used</literal> 508 &man.sysctl.8;.</para> 509 </sect2> 510 511 <sect2 xml:id="storage-geom"> 512 <title>&man.geom.4;</title> 513 514 <para revision="275891" contrib="sponsor" sponsor="&ix;">The 515 &man.ctl.4; subsystem has been updated, increasing the ports 516 limit from <literal>128</literal> to <literal>256</literal>, 517 and <acronym>LUN</acronym> limit from <literal>256</literal> 518 to <literal>1024</literal>.</para> 519 </sect2> 520 </sect1> 521 522 <sect1 xml:id="boot"> 523 <title>Boot Loader Changes</title> 524 525 <para>This section covers the boot loader, boot menu, and other 526 boot-related changes.</para> 527 528 <sect2 xml:id="boot-loader"> 529 <title>Boot Loader Changes</title> 530 531 <para revision="281843">The boot loader has been updated to 532 support entering the <acronym>GELI</acronym> passphrase before 533 loading the kernel. To enable this behavior, add 534 <literal>geom_eli_passphrase_prompt="YES"</literal> to 535 &man.loader.conf.5;.</para> 536 537 <para revision="283262" contrib="sponsor" sponsor="&ff;">The 538 memory test run at boot time on &os;/&arch.amd64; platforms 539 has been disabled by default.</para> 540 </sect2> 541 542 <sect2 xml:id="boot-menu"> 543 <title>Boot Menu Changes</title> 544 545 <para> </para> 546 </sect2> 547 </sect1> 548 549 <sect1 xml:id="network"> 550 <title>Networking</title> 551 552 <para>This section describes changes that affect networking in 553 &os;.</para> 554 555 <sect2 xml:id="network-protocols"> 556 <title>Network Procols</title> 557 558 <para> </para> 559 </sect2> 560 </sect1> 561 562 <sect1 xml:id="ports"> 563 <title>Ports Collection and Package Infrastructure</title> 564 565 <para>This section covers changes to the &os; Ports 566 Collection, package infrastructure, and package maintenance and 567 installation tools.</para> 568 569 <sect2 xml:id="ports-infrastructure"> 570 <title>Infrastructure Changes</title> 571 572 <para> </para> 573 </sect2> 574 575 <sect2 xml:id="ports-packages "> 576 <title>Packaging Changes</title> 577 578 <para> </para> 579 </sect2> 580 </sect1> 581 582 <sect1 xml:id="doc"> 583 <title>Documentation</title> 584 585 <para>This section covers changes to the &os; Documentation 586 Project sources and toolchain.</para> 587 588 <sect2 xml:id="doc-sources"> 589 <title>Documentation Source Changes</title> 590 591 <para> </para> 592 </sect2> 593 594 <sect2 xml:id="doc-toolchain"> 595 <title>Documentation Toolchain Changes</title> 596 597 <para> </para> 598 </sect2> 599 </sect1> 600 601 <sect1 xml:id="releng"> 602 <title>Release Engineering and Integration</title> 603 604 <para>This section convers changes that are specific to the 605 &os; Release Engineering processes.</para> 606 607 <sect2 xml:id="releng-changes"> 608 <title>Integration Changes</title> 609 610 <para> </para> 611 </sect2> 612 </sect1> 613</article> 614