article.xml revision 285494
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 285494 2015-07-13 18:53:58Z 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="283270">The &man.nc.1; utility has been updated 241 to the OpenBSD 5.7 version.</para> 242 243 <para revision="284398">Timezone data files have been updated to 244 version 2015e.</para> 245 246 <para revision="284460">The &man.acpi.4; subsystem has been 247 updated to version 20150515.</para> 248 249 <para revision="284778">The &man.file.1; utility has been 250 updated to version 5.23.</para> 251 252 <para revision="285206">The &man.unbound.8; utility has been 253 updated to version 1.5.3.</para> 254 255 <para revision="285305">The <application>sendmail</application> 256 utility has been updated to version 8.15.2.</para> 257 258 <para revision="285330"><application>OpenSSL</application> has 259 been updated to version 1.0.1p.</para> 260 </sect2> 261 262 <sect2 xml:id="userland-installer"> 263 <title>Installation and Configuration Tools</title> 264 265 <para> </para> 266 </sect2> 267 268 <sect2 xml:id="userland-rc"> 269 <title><filename class="directory">/etc/rc.d</filename> 270 Scripts</title> 271 272 <para revision="284009">A new &man.rc.8; script, 273 <filename>growfs</filename>, has been added, which will resize 274 the root filesystem on boot if <filename>/firstboot</filename> 275 exists.</para> 276 </sect2> 277 278 <sect2 xml:id="userland-periodic"> 279 <title><filename class="directory">/etc/periodic</filename> 280 Scripts</title> 281 282 <para revision="277520" contrib="sponsor" sponsor="&ff;">A new 283 &man.periodic.8; script, 284 <filename>510.status-world-kernel</filename>, has been added, 285 which evaluates the running userland and kernel versions from 286 the &man.uname.1; <literal>-U</literal> and 287 <literal>-K</literal> arguments, and prints an error if the 288 system userland and kernel are not in sync.</para> 289 </sect2> 290 291 <sect2 xml:id="userland-libraries"> 292 <title>Runtime Libraries and API</title> 293 294 <para revision="275040">A new file configuration library, 295 &man.figpar.3;, has been added to the base system.</para> 296 297 <para revision="280392">The &man.setmode.3; function has been 298 updated to consistently set <literal>errno</literal> on 299 failure.</para> 300 </sect2> 301 302 <sect2 xml:id="userland-abi"> 303 <title>ABI Compatibility</title> 304 305 <para> </para> 306 </sect2> 307 </sect1> 308 309 <sect1 xml:id="kernel"> 310 <title>Kernel</title> 311 312 <para>This section covers changes to kernel configurations, system 313 tuning, and system control parameters that are not otherwise 314 categorized.</para> 315 316 <sect2 xml:id="kernel-bugfix"> 317 <title>Kernel Bug Fixes</title> 318 319 <para> </para> 320 </sect2> 321 322 <sect2 xml:id="kernel-config"> 323 <title>Kernel Configuration</title> 324 325 <para revision="284522" contrib="sponsor" 326 sponsor="&limelight;">A new kernel configuration option, 327 <literal>EM_MULTIQUEUE</literal>, has been added which enables 328 multi-queue support in the &man.em.4; driver.</para> 329 330 <note> 331 <para>Multi-queue support in the &man.em.4; driver is not 332 officially supported by &intel;.</para> 333 </note> 334 </sect2> 335 336 <sect2 xml:id="kernel-sysctl"> 337 <title>System Tuning and Controls</title> 338 339 <para revision="276986">Throttling via <acronym>ACPI</acronym> 340 and <acronym>P4TCC</acronym> via &man.device.hints.5; have 341 been turned off by default.</para> 342 343 <para revision="278982" contrib="sponsor" sponsor="&ff;">The 344 &man.hwpmc.4; default and maximum callchain depths have been 345 increased. The default has been increased from 16 to 32, and 346 the maximum increased from 32 to 128.</para> 347 348 <para revision="281255" contrib="sponsor" 349 sponsor="&ix;, &ff;">The &man.devfs.5; device filesystem has 350 been changed to update timestamps for read/write operations 351 using seconds precision. A new &man.sysctl.8;, 352 <literal>vfs.devfs.dotimes</literal> has been added, which 353 when set to a non-zero value, enables default precision 354 timestamps for these operations.</para> 355 356 <para revision="280632">The <literal>kern.osrelease</literal> 357 and <literal>kern.osreldate</literal> are now configurable 358 &man.jail.8; parameters.</para> 359 360 <para revision="284665" contrib="sponsor" sponsor="&ff;">A new 361 &man.sysctl.8;, <literal>kern.racct.enable</literal>, has been 362 added, which when set to a non-zero value allows using 363 &man.rctl.8; with the <literal>GENERIC</literal> kernel. 364 A new kernel configuration option, 365 <literal>RACCT_DISABLED</literal> has also been added.</para> 366 367 <para revision="284665" contrib="sponsor" sponsor="&ff;">The 368 <literal>GENERIC</literal> kernel configuration now includes 369 <literal>RACCT</literal> and <literal>RCTL</literal> by 370 default.</para> 371 372 <note> 373 <para>To enable <literal>RACCT</literal> and 374 <literal>RCTL</literal> on a system using the 375 <literal>GENERIC</literal> kernel configuration, add 376 <literal>kern.racct.enable=1</literal> to 377 &man.loader.conf.5;, and reboot the system.</para> 378 </note> 379 </sect2> 380 </sect1> 381 382 <sect1 xml:id="drivers"> 383 <title>Devices and Drivers</title> 384 385 <para>This section covers changes and additions to devices and 386 device drivers since &release.prev;.</para> 387 388 <sect2 xml:id="drivers-device"> 389 <title>Device Drivers</title> 390 391 <para revision="282199">The <literal>drm</literal> code has 392 been updated to match &linux; version 3.8.13.</para> 393 </sect2> 394 395 <sect2 xml:id="drivers-storage"> 396 <title>Storage Drivers</title> 397 398 <para revision="281957">The &man.hptnr.4; driver has been 399 updated to version 1.1.1.</para> 400 </sect2> 401 402 <sect2 xml:id="drivers-network"> 403 <title>Network Drivers</title> 404 405 <para revision="284066" contrib="sponsor" sponsor="&yandex;">The 406 &man.gre.4; driver has been significantly overhauled, and has 407 been split into two separate modules, &man.gre.4; and 408 &man.me.4;.</para> 409 </sect2> 410 </sect1> 411 412 <sect1 xml:id="hardware"> 413 <title>Hardware Support</title> 414 415 <para>This section covers general hardware support for physical 416 machines, hypervisors, and virtualization environments, as well 417 as hardware changes and updates that do not otherwise fit in 418 other sections of this document.</para> 419 420 <sect2 xml:id="hardware-support"> 421 <title>Hardware Support</title> 422 423 <para> </para> 424 </sect2> 425 426 <sect2 xml:id="hardware-virtualization"> 427 <title>Virtualization Support</title> 428 429 <para revision="280370">The &man.bhyve.8; hypervisor has been 430 updated to support <literal>DSM TRIM</literal> commands for 431 virtual <acronym>AHCI</acronym> disks.</para> 432 433 <para revision="283280" contrib="sponsor" sponsor="&msostc;">The 434 Hyper-V™ drivers have been updated with several 435 enhancements:</para> 436 437 <itemizedlist> 438 <listitem> 439 <para>The &man.hv.vmbus.4; driver now has multi-channel 440 support.</para> 441 </listitem> 442 443 <listitem> 444 <para>The &man.hv.storvsc.4; driver now has scatter/gather 445 support, in addition to performance improvements.</para> 446 </listitem> 447 448 <listitem> 449 <para>The &man.hv.kvp.4; driver has received several bug 450 fixes.</para> 451 </listitem> 452 </itemizedlist> 453 454 <para revision="285236" contrib="sponsor" sponsor="&msostc;">The 455 &man.hv.netvsc.4; driver has been updated to support checksum 456 offloading and <acronym>TSO</acronym>.</para> 457 </sect2> 458 459 <sect2 xml:id="hardware-arm"> 460 <title>ARM Support</title> 461 462 <para revision="278608">The <literal>bcm2835_cpufreq</literal> 463 driver has been added, which supports <acronym>CPU</acronym> 464 frequency and voltage control on the Raspberry Pi 465 <acronym>SOC</acronym>.</para> 466 </sect2> 467 </sect1> 468 469 <sect1 xml:id="storage"> 470 <title>Storage</title> 471 472 <para>This section covers changes and additions to file systems 473 and other storage subsystems, both local and networked.</para> 474 475 <sect2 xml:id="storage-general"> 476 <title>General Storage</title> 477 478 <para revision="279002" contrib="sponsor" sponsor="&ix;">The 479 &man.ctl.4; <acronym>LUN</acronym> mapping has been rewritten, 480 replacing <acronym>iSCSI</acronym>-specific mapping mechanisms 481 with a new mechanism that works for any port.</para> 482 483 <para revision="279055" contrib="sponsor" sponsor="&ix;">The 484 &man.ctld.8; utility has been updated to allow controlling 485 non-<acronym>iSCSI</acronym> &man.ctl.4; ports.</para> 486 487 <para revision="283223" contrib="sponsor" sponsor="&ff;">The 488 &man.autofs.5; subsystem has been updated to include a new 489 &man.auto.master.5; map, <literal>-media</literal>, which 490 allows automatically mounting removable media, such as 491 <acronym>CD</acronym> drives or <acronym>USB</acronym> flash 492 drives.</para> 493 494 <para revision="283242" contrib="sponsor" sponsor="&ff;">The 495 &man.autofs.5; subsystem has been updated to include a new 496 &man.auto.master.5; map, <literal>-noauto</literal>, which 497 handles &man.fstab.5; entries set to 498 <literal>noauto</literal>.</para> 499 </sect2> 500 501 <sect2 xml:id="storage-net"> 502 <title>Networked Storage</title> 503 504 <para revision="274939" contrib="sponsor" sponsor="&ix;">The 505 &man.ctld.8; utility has been updated to include support for 506 registering <acronym>iSCSI</acronym> targets and portals on 507 <acronym>iSNS</acronym> servers. This provides a mechanism 508 which allows <acronym>iSCSI</acronym> initiators to find 509 targets and portals without requiring active 510 discovery.</para> 511 </sect2> 512 513 <sect2 xml:id="storage-zfs"> 514 <title>ZFS</title> 515 516 <para revision="275490">A new tunable, 517 <literal>vfs.zfs.spa_slop_shift</literal>, has been added, 518 which controls how much space is reserved by default.</para> 519 520 <para revision="277583">The <literal>arc_meta_limit</literal> 521 statistics are now visible through the 522 <literal>kstat</literal> &man.sysctl.8;. As a result of this 523 change, the <literal>vfs.zfs.arc_meta_used</literal> 524 &man.sysctl.8; has been removed, and replaced with the 525 <literal>kstat.zfs.misc.arcstats.arc_meta_used</literal> 526 &man.sysctl.8;.</para> 527 </sect2> 528 529 <sect2 xml:id="storage-geom"> 530 <title>&man.geom.4;</title> 531 532 <para revision="275891" contrib="sponsor" sponsor="&ix;">The 533 &man.ctl.4; subsystem has been updated, increasing the ports 534 limit from <literal>128</literal> to <literal>256</literal>, 535 and <acronym>LUN</acronym> limit from <literal>256</literal> 536 to <literal>1024</literal>.</para> 537 538 <para revision="282861">Support for the 539 <literal>apple-boot</literal>, <literal>apple-hfs</literal>, 540 and <literal>apple-ufs</literal> <acronym>MBR</acronym> 541 partitioning schemes have been added to &man.gpart.8;.</para> 542 </sect2> 543 </sect1> 544 545 <sect1 xml:id="boot"> 546 <title>Boot Loader Changes</title> 547 548 <para>This section covers the boot loader, boot menu, and other 549 boot-related changes.</para> 550 551 <sect2 xml:id="boot-loader"> 552 <title>Boot Loader Changes</title> 553 554 <para revision="281843">The boot loader has been updated to 555 support entering the <acronym>GELI</acronym> passphrase before 556 loading the kernel. To enable this behavior, add 557 <literal>geom_eli_passphrase_prompt="YES"</literal> to 558 &man.loader.conf.5;.</para> 559 560 <para revision="283262" contrib="sponsor" sponsor="&ff;">The 561 memory test run at boot time on &os;/&arch.amd64; platforms 562 has been disabled by default.</para> 563 564 <para revision="283972">A new &man.ttys.5; class, 565 <literal>3wire</literal>, has been added. This is similar to 566 the existing terminal classes, but does not have a defined 567 baudrate.</para> 568 569 <para revision="284775" contrib="sponsor" sponsor="&ff;" 570 arch="arm">The &man.ttys.5; file for &os;/&arch.arm; has been 571 updated to enable <filename>ttyu1</filename>, 572 <filename>ttyu2</filename>, and <filename>ttyu3</filename> by 573 default, if the callin port is an active console port.</para> 574 </sect2> 575 576 <sect2 xml:id="boot-menu"> 577 <title>Boot Menu Changes</title> 578 579 <para> </para> 580 </sect2> 581 </sect1> 582 583 <sect1 xml:id="network"> 584 <title>Networking</title> 585 586 <para>This section describes changes that affect networking in 587 &os;.</para> 588 589 <sect2 xml:id="network-protocols"> 590 <title>Network Procols</title> 591 592 <para> </para> 593 </sect2> 594 </sect1> 595 596 <sect1 xml:id="ports"> 597 <title>Ports Collection and Package Infrastructure</title> 598 599 <para>This section covers changes to the &os; Ports 600 Collection, package infrastructure, and package maintenance and 601 installation tools.</para> 602 603 <sect2 xml:id="ports-infrastructure"> 604 <title>Infrastructure Changes</title> 605 606 <para> </para> 607 </sect2> 608 609 <sect2 xml:id="ports-packages "> 610 <title>Packaging Changes</title> 611 612 <para> </para> 613 </sect2> 614 </sect1> 615 616 <sect1 xml:id="doc"> 617 <title>Documentation</title> 618 619 <para>This section covers changes to the &os; Documentation 620 Project sources and toolchain.</para> 621 622 <sect2 xml:id="doc-sources"> 623 <title>Documentation Source Changes</title> 624 625 <para> </para> 626 </sect2> 627 628 <sect2 xml:id="doc-toolchain"> 629 <title>Documentation Toolchain Changes</title> 630 631 <para> </para> 632 </sect2> 633 </sect1> 634 635 <sect1 xml:id="releng"> 636 <title>Release Engineering and Integration</title> 637 638 <para>This section convers changes that are specific to the 639 &os; Release Engineering processes.</para> 640 641 <sect2 xml:id="releng-changes"> 642 <title>Integration Changes</title> 643 644 <para revision="283161" contrib="sponsor" sponsor="&ff;">The 645 Release Engineering build tools have been updated to support 646 building &os;/&arch.arm; images without external utilities for 647 supported boards where a corresponding 648 <literal>u-boot</literal> port exists in the Ports 649 Collection.</para> 650 651 <para revision="283548" contrib="sponsor" sponsor="&ff;">The 652 &os;/&arch.i386; memory stick installation images are now 653 created using the &man.mkimg.1; utility, matching the way 654 the &os;/&arch.amd64; images are created.</para> 655 </sect2> 656 </sect1> 657</article> 658