article.xml revision 284855
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 284855 2015-06-25 18:45:33Z gjb $</pubdate> 24 25 <!-- Last rev: 282497 --> 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 </sect2> 222 223 <sect2 xml:id="userland-contrib"> 224 <title>Contributed Software</title> 225 226 <para revision="277592"><application>file</application> has been 227 updated to version 5.22.</para> 228 229 <para revision="282746" contrib="sponsor" sponsor="&ff;">The 230 &man.resolvconf.8; utility has been updated to version 231 3.7.0.</para> 232 233 <para revision="284330"><application>OpenSSL</application> has 234 been updated to version 1.0.1o.</para> 235 236 <para revision="284460">The &man.acpi.4; subsystem has been 237 updated to version 20150515.</para> 238 </sect2> 239 240 <sect2 xml:id="userland-installer"> 241 <title>Installation and Configuration Tools</title> 242 243 <para> </para> 244 </sect2> 245 246 <sect2 xml:id="userland-rc"> 247 <title><filename class="directory">/etc/rc.d</filename> 248 Scripts</title> 249 250 <para> </para> 251 </sect2> 252 253 <sect2 xml:id="userland-periodic"> 254 <title><filename class="directory">/etc/periodic</filename> 255 Scripts</title> 256 257 <para> </para> 258 </sect2> 259 260 <sect2 xml:id="userland-libraries"> 261 <title>Runtime Libraries and API</title> 262 263 <para revision="275040">A new file configuration library, 264 &man.figpar.3;, has been added to the base system.</para> 265 266 <para revision="280392">The &man.setmode.3; function has been 267 updated to consistently set <literal>errno</literal> on 268 failure.</para> 269 </sect2> 270 271 <sect2 xml:id="userland-abi"> 272 <title>ABI Compatibility</title> 273 274 <para> </para> 275 </sect2> 276 </sect1> 277 278 <sect1 xml:id="kernel"> 279 <title>Kernel</title> 280 281 <para>This section covers changes to kernel configurations, system 282 tuning, and system control parameters that are not otherwise 283 categorized.</para> 284 285 <sect2 xml:id="kernel-bugfix"> 286 <title>Kernel Bug Fixes</title> 287 288 <para> </para> 289 </sect2> 290 291 <sect2 xml:id="kernel-config"> 292 <title>Kernel Configuration</title> 293 294 <para revision="284522" contrib="sponsor" 295 sponsor="&limelight;">A new kernel configuration option, 296 <literal>EM_MULTIQUEUE</literal>, has been added which enables 297 multi-queue support in the &man.em.4; driver.</para> 298 299 <note> 300 <para>Multi-queue support in the &man.em.4; driver is not 301 officially supported by &intel;.</para> 302 </note> 303 </sect2> 304 305 <sect2 xml:id="kernel-sysctl"> 306 <title>System Tuning and Controls</title> 307 308 <para revision="276986">Throttling via <acronym>ACPI</acronym> 309 and <acronym>P4TCC</acronym> via &man.device.hints.5; have 310 been turned off by default.</para> 311 312 <para revision="278982" contrib="sponsor" sponsor="&ff;">The 313 &man.hwpmc.4; default and maximum callchain depths have been 314 increased. The default has been increased from 16 to 32, and 315 the maximum increased from 32 to 128.</para> 316 317 <para revision="281255" contrib="sponsor" 318 sponsor="&ix;, &ff;">The &man.devfs.5; device filesystem has 319 been changed to update timestamps for read/write operations 320 using seconds precision. A new &man.sysctl.8;, 321 <literal>vfs.devfs.dotimes</literal> has been added, which 322 when set to a non-zero value, enables default precision 323 timestamps for these operations.</para> 324 325 <para revision="280632">The <literal>kern.osrelease</literal> 326 and <literal>kern.osreldate</literal> are now configurable 327 &man.jail.8; parameters.</para> 328 329 <para revision="284665" contrib="sponsor" sponsor="&ff;">A new 330 &man.sysctl.8;, <literal>kern.racct.enable</literal>, has been 331 added, which when set to a non-zero value allows using 332 &man.rctl.8; with the <literal>GENERIC</literal> kernel. 333 A new kernel configuration option, 334 <literal>RACCT_DISABLED</literal> has also been added.</para> 335 336 <para revision="284665" contrib="sponsor" sponsor="&ff;">The 337 <literal>GENERIC</literal> kernel configuration now includes 338 <literal>RACCT</literal> and <literal>RCTL</literal> by 339 default.</para> 340 341 <note> 342 <para>To enable <literal>RACCT</literal> and 343 <literal>RCTL</literal> on a system using the 344 <literal>GENERIC</literal> kernel configuration, add 345 <literal>kern.racct.enable=1</literal> to 346 &man.loader.conf.5;, and reboot the system.</para> 347 </note> 348 </sect2> 349 </sect1> 350 351 <sect1 xml:id="drivers"> 352 <title>Devices and Drivers</title> 353 354 <para>This section covers changes and additions to devices and 355 device drivers since &release.prev;.</para> 356 357 <sect2 xml:id="drivers-device"> 358 <title>Device Drivers</title> 359 360 <para revision="282199">The <literal>drm</literal> code has 361 been updated to match &linux; version 3.8.13.</para> 362 </sect2> 363 364 <sect2 xml:id="drivers-storage"> 365 <title>Storage Drivers</title> 366 367 <para revision="281957">The &man.hptnr.4; driver has been 368 updated to version 1.1.1.</para> 369 </sect2> 370 371 <sect2 xml:id="drivers-network"> 372 <title>Network Drivers</title> 373 374 <para> </para> 375 </sect2> 376 </sect1> 377 378 <sect1 xml:id="hardware"> 379 <title>Hardware Support</title> 380 381 <para>This section covers general hardware support for physical 382 machines, hypervisors, and virtualization environments, as well 383 as hardware changes and updates that do not otherwise fit in 384 other sections of this document.</para> 385 386 <sect2 xml:id="hardware-support"> 387 <title>Hardware Support</title> 388 389 <para> </para> 390 </sect2> 391 392 <sect2 xml:id="hardware-virtualization"> 393 <title>Virtualization Support</title> 394 395 <para revision="280370">The &man.bhyve.8; hypervisor has been 396 updated to support <literal>DSM TRIM</literal> commands for 397 virtual <acronym>AHCI</acronym> disks.</para> 398 399 <para revision="283280" contrib="sponsor" sponsor="&msostc;">The 400 Hyper-V™ drivers have been updated with several 401 enhancements:</para> 402 403 <itemizedlist> 404 <listitem> 405 <para>The &man.hv.vmbus.4; driver now has multi-channel 406 support.</para> 407 </listitem> 408 409 <listitem> 410 <para>The &man.hv.storvsc.4; driver now has scatter/gather 411 support, in addition to performance improvements.</para> 412 </listitem> 413 414 <listitem> 415 <para>The &man.hv.kvp.4; driver has received several bug 416 fixes.</para> 417 </listitem> 418 </itemizedlist> 419 </sect2> 420 421 <sect2 xml:id="hardware-arm"> 422 <title>ARM Support</title> 423 424 <para revision="278608">The <literal>bcm2835_cpufreq</literal> 425 driver has been added, which supports <acronym>CPU</acronym> 426 frequency and voltage control on the Raspberry Pi 427 <acronym>SOC</acronym>.</para> 428 </sect2> 429 </sect1> 430 431 <sect1 xml:id="storage"> 432 <title>Storage</title> 433 434 <para>This section covers changes and additions to file systems 435 and other storage subsystems, both local and networked.</para> 436 437 <sect2 xml:id="storage-general"> 438 <title>General Storage</title> 439 440 <para revision="279002" contrib="sponsor" sponsor="&ix;">The 441 &man.ctl.4; <acronym>LUN</acronym> mapping has been rewritten, 442 replacing <acronym>iSCSI</acronym>-specific mapping mechanisms 443 with a new mechanism that works for any port.</para> 444 445 <para revision="279055" contrib="sponsor" sponsor="&ix;">The 446 &man.ctld.8; utility has been updated to allow controlling 447 non-<acronym>iSCSI</acronym> &man.ctl.4; ports.</para> 448 449 <para revision="283223" contrib="sponsor" sponsor="&ff;">The 450 &man.autofs.5; subsystem has been updated to include a new 451 &man.auto.master.5; map, <literal>-media</literal>, which 452 allows automatically mounting removable media, such as 453 <acronym>CD</acronym> drives or <acronym>USB</acronym> flash 454 drives.</para> 455 456 <para revision="283242" contrib="sponsor" sponsor="&ff;">The 457 &man.autofs.5; subsystem has been updated to include a new 458 &man.auto.master.5; map, <literal>-noauto</literal>, which 459 handles &man.fstab.5; entries set to 460 <literal>noauto</literal>.</para> 461 </sect2> 462 463 <sect2 xml:id="storage-net"> 464 <title>Networked Storage</title> 465 466 <para revision="274939" contrib="sponsor" sponsor="&ix;">The 467 &man.ctld.8; utility has been updated to include support for 468 registering <acronym>iSCSI</acronym> targets and portals on 469 <acronym>iSNS</acronym> servers. This provides a mechanism 470 which allows <acronym>iSCSI</acronym> initiators to find 471 targets and portals without requiring active 472 discovery.</para> 473 </sect2> 474 475 <sect2 xml:id="storage-zfs"> 476 <title>ZFS</title> 477 478 <para revision="275490">A new tunable, 479 <literal>vfs.zfs.spa_slop_shift</literal>, has been added, 480 which controls how much space is reserved by default.</para> 481 482 <para revision="277583">The <literal>arc_meta_limit</literal> 483 statistics are now visible through the 484 <literal>kstat</literal> &man.sysctl.8;. As a result of this 485 change, the <literal>vfs.zfs.arc_meta_used</literal> 486 &man.sysctl.8; has been removed, and replaced with the 487 <literal>kstat.zfs.misc.arcstats.arc_meta_used</literal> 488 &man.sysctl.8;.</para> 489 </sect2> 490 491 <sect2 xml:id="storage-geom"> 492 <title>&man.geom.4;</title> 493 494 <para revision="275891" contrib="sponsor" sponsor="&ix;">The 495 &man.ctl.4; subsystem has been updated, increasing the ports 496 limit from <literal>128</literal> to <literal>256</literal>, 497 and <acronym>LUN</acronym> limit from <literal>256</literal> 498 to <literal>1024</literal>.</para> 499 </sect2> 500 </sect1> 501 502 <sect1 xml:id="boot"> 503 <title>Boot Loader Changes</title> 504 505 <para>This section covers the boot loader, boot menu, and other 506 boot-related changes.</para> 507 508 <sect2 xml:id="boot-loader"> 509 <title>Boot Loader Changes</title> 510 511 <para revision="281843">The boot loader has been updated to 512 support entering the <acronym>GELI</acronym> passphrase before 513 loading the kernel. To enable this behavior, add 514 <literal>geom_eli_passphrase_prompt="YES"</literal> to 515 &man.loader.conf.5;.</para> 516 517 <para revision="283262" contrib="sponsor" sponsor="&ff;">The 518 memory test run at boot time on &os;/&arch.amd64; platforms 519 has been disabled by default.</para> 520 </sect2> 521 522 <sect2 xml:id="boot-menu"> 523 <title>Boot Menu Changes</title> 524 525 <para> </para> 526 </sect2> 527 </sect1> 528 529 <sect1 xml:id="network"> 530 <title>Networking</title> 531 532 <para>This section describes changes that affect networking in 533 &os;.</para> 534 535 <sect2 xml:id="network-protocols"> 536 <title>Network Procols</title> 537 538 <para> </para> 539 </sect2> 540 </sect1> 541 542 <sect1 xml:id="ports"> 543 <title>Ports Collection and Package Infrastructure</title> 544 545 <para>This section covers changes to the &os; Ports 546 Collection, package infrastructure, and package maintenance and 547 installation tools.</para> 548 549 <sect2 xml:id="ports-infrastructure"> 550 <title>Infrastructure Changes</title> 551 552 <para> </para> 553 </sect2> 554 555 <sect2 xml:id="ports-packages "> 556 <title>Packaging Changes</title> 557 558 <para> </para> 559 </sect2> 560 </sect1> 561 562 <sect1 xml:id="doc"> 563 <title>Documentation</title> 564 565 <para>This section covers changes to the &os; Documentation 566 Project sources and toolchain.</para> 567 568 <sect2 xml:id="doc-sources"> 569 <title>Documentation Source Changes</title> 570 571 <para> </para> 572 </sect2> 573 574 <sect2 xml:id="doc-toolchain"> 575 <title>Documentation Toolchain Changes</title> 576 577 <para> </para> 578 </sect2> 579 </sect1> 580 581 <sect1 xml:id="releng"> 582 <title>Release Engineering and Integration</title> 583 584 <para>This section convers changes that are specific to the 585 &os; Release Engineering processes.</para> 586 587 <sect2 xml:id="releng-changes"> 588 <title>Integration Changes</title> 589 590 <para> </para> 591 </sect2> 592 </sect1> 593</article> 594