article.xml revision 285493
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 285493 2015-07-13 18:53:55Z 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> </para> 406 </sect2> 407 </sect1> 408 409 <sect1 xml:id="hardware"> 410 <title>Hardware Support</title> 411 412 <para>This section covers general hardware support for physical 413 machines, hypervisors, and virtualization environments, as well 414 as hardware changes and updates that do not otherwise fit in 415 other sections of this document.</para> 416 417 <sect2 xml:id="hardware-support"> 418 <title>Hardware Support</title> 419 420 <para> </para> 421 </sect2> 422 423 <sect2 xml:id="hardware-virtualization"> 424 <title>Virtualization Support</title> 425 426 <para revision="280370">The &man.bhyve.8; hypervisor has been 427 updated to support <literal>DSM TRIM</literal> commands for 428 virtual <acronym>AHCI</acronym> disks.</para> 429 430 <para revision="283280" contrib="sponsor" sponsor="&msostc;">The 431 Hyper-V™ drivers have been updated with several 432 enhancements:</para> 433 434 <itemizedlist> 435 <listitem> 436 <para>The &man.hv.vmbus.4; driver now has multi-channel 437 support.</para> 438 </listitem> 439 440 <listitem> 441 <para>The &man.hv.storvsc.4; driver now has scatter/gather 442 support, in addition to performance improvements.</para> 443 </listitem> 444 445 <listitem> 446 <para>The &man.hv.kvp.4; driver has received several bug 447 fixes.</para> 448 </listitem> 449 </itemizedlist> 450 451 <para revision="285236" contrib="sponsor" sponsor="&msostc;">The 452 &man.hv.netvsc.4; driver has been updated to support checksum 453 offloading and <acronym>TSO</acronym>.</para> 454 </sect2> 455 456 <sect2 xml:id="hardware-arm"> 457 <title>ARM Support</title> 458 459 <para revision="278608">The <literal>bcm2835_cpufreq</literal> 460 driver has been added, which supports <acronym>CPU</acronym> 461 frequency and voltage control on the Raspberry Pi 462 <acronym>SOC</acronym>.</para> 463 </sect2> 464 </sect1> 465 466 <sect1 xml:id="storage"> 467 <title>Storage</title> 468 469 <para>This section covers changes and additions to file systems 470 and other storage subsystems, both local and networked.</para> 471 472 <sect2 xml:id="storage-general"> 473 <title>General Storage</title> 474 475 <para revision="279002" contrib="sponsor" sponsor="&ix;">The 476 &man.ctl.4; <acronym>LUN</acronym> mapping has been rewritten, 477 replacing <acronym>iSCSI</acronym>-specific mapping mechanisms 478 with a new mechanism that works for any port.</para> 479 480 <para revision="279055" contrib="sponsor" sponsor="&ix;">The 481 &man.ctld.8; utility has been updated to allow controlling 482 non-<acronym>iSCSI</acronym> &man.ctl.4; ports.</para> 483 484 <para revision="283223" contrib="sponsor" sponsor="&ff;">The 485 &man.autofs.5; subsystem has been updated to include a new 486 &man.auto.master.5; map, <literal>-media</literal>, which 487 allows automatically mounting removable media, such as 488 <acronym>CD</acronym> drives or <acronym>USB</acronym> flash 489 drives.</para> 490 491 <para revision="283242" contrib="sponsor" sponsor="&ff;">The 492 &man.autofs.5; subsystem has been updated to include a new 493 &man.auto.master.5; map, <literal>-noauto</literal>, which 494 handles &man.fstab.5; entries set to 495 <literal>noauto</literal>.</para> 496 </sect2> 497 498 <sect2 xml:id="storage-net"> 499 <title>Networked Storage</title> 500 501 <para revision="274939" contrib="sponsor" sponsor="&ix;">The 502 &man.ctld.8; utility has been updated to include support for 503 registering <acronym>iSCSI</acronym> targets and portals on 504 <acronym>iSNS</acronym> servers. This provides a mechanism 505 which allows <acronym>iSCSI</acronym> initiators to find 506 targets and portals without requiring active 507 discovery.</para> 508 </sect2> 509 510 <sect2 xml:id="storage-zfs"> 511 <title>ZFS</title> 512 513 <para revision="275490">A new tunable, 514 <literal>vfs.zfs.spa_slop_shift</literal>, has been added, 515 which controls how much space is reserved by default.</para> 516 517 <para revision="277583">The <literal>arc_meta_limit</literal> 518 statistics are now visible through the 519 <literal>kstat</literal> &man.sysctl.8;. As a result of this 520 change, the <literal>vfs.zfs.arc_meta_used</literal> 521 &man.sysctl.8; has been removed, and replaced with the 522 <literal>kstat.zfs.misc.arcstats.arc_meta_used</literal> 523 &man.sysctl.8;.</para> 524 </sect2> 525 526 <sect2 xml:id="storage-geom"> 527 <title>&man.geom.4;</title> 528 529 <para revision="275891" contrib="sponsor" sponsor="&ix;">The 530 &man.ctl.4; subsystem has been updated, increasing the ports 531 limit from <literal>128</literal> to <literal>256</literal>, 532 and <acronym>LUN</acronym> limit from <literal>256</literal> 533 to <literal>1024</literal>.</para> 534 535 <para revision="282861">Support for the 536 <literal>apple-boot</literal>, <literal>apple-hfs</literal>, 537 and <literal>apple-ufs</literal> <acronym>MBR</acronym> 538 partitioning schemes have been added to &man.gpart.8;.</para> 539 </sect2> 540 </sect1> 541 542 <sect1 xml:id="boot"> 543 <title>Boot Loader Changes</title> 544 545 <para>This section covers the boot loader, boot menu, and other 546 boot-related changes.</para> 547 548 <sect2 xml:id="boot-loader"> 549 <title>Boot Loader Changes</title> 550 551 <para revision="281843">The boot loader has been updated to 552 support entering the <acronym>GELI</acronym> passphrase before 553 loading the kernel. To enable this behavior, add 554 <literal>geom_eli_passphrase_prompt="YES"</literal> to 555 &man.loader.conf.5;.</para> 556 557 <para revision="283262" contrib="sponsor" sponsor="&ff;">The 558 memory test run at boot time on &os;/&arch.amd64; platforms 559 has been disabled by default.</para> 560 561 <para revision="283972">A new &man.ttys.5; class, 562 <literal>3wire</literal>, has been added. This is similar to 563 the existing terminal classes, but does not have a defined 564 baudrate.</para> 565 566 <para revision="284775" contrib="sponsor" sponsor="&ff;" 567 arch="arm">The &man.ttys.5; file for &os;/&arch.arm; has been 568 updated to enable <filename>ttyu1</filename>, 569 <filename>ttyu2</filename>, and <filename>ttyu3</filename> by 570 default, if the callin port is an active console port.</para> 571 </sect2> 572 573 <sect2 xml:id="boot-menu"> 574 <title>Boot Menu Changes</title> 575 576 <para> </para> 577 </sect2> 578 </sect1> 579 580 <sect1 xml:id="network"> 581 <title>Networking</title> 582 583 <para>This section describes changes that affect networking in 584 &os;.</para> 585 586 <sect2 xml:id="network-protocols"> 587 <title>Network Procols</title> 588 589 <para> </para> 590 </sect2> 591 </sect1> 592 593 <sect1 xml:id="ports"> 594 <title>Ports Collection and Package Infrastructure</title> 595 596 <para>This section covers changes to the &os; Ports 597 Collection, package infrastructure, and package maintenance and 598 installation tools.</para> 599 600 <sect2 xml:id="ports-infrastructure"> 601 <title>Infrastructure Changes</title> 602 603 <para> </para> 604 </sect2> 605 606 <sect2 xml:id="ports-packages "> 607 <title>Packaging Changes</title> 608 609 <para> </para> 610 </sect2> 611 </sect1> 612 613 <sect1 xml:id="doc"> 614 <title>Documentation</title> 615 616 <para>This section covers changes to the &os; Documentation 617 Project sources and toolchain.</para> 618 619 <sect2 xml:id="doc-sources"> 620 <title>Documentation Source Changes</title> 621 622 <para> </para> 623 </sect2> 624 625 <sect2 xml:id="doc-toolchain"> 626 <title>Documentation Toolchain Changes</title> 627 628 <para> </para> 629 </sect2> 630 </sect1> 631 632 <sect1 xml:id="releng"> 633 <title>Release Engineering and Integration</title> 634 635 <para>This section convers changes that are specific to the 636 &os; Release Engineering processes.</para> 637 638 <sect2 xml:id="releng-changes"> 639 <title>Integration Changes</title> 640 641 <para revision="283161" contrib="sponsor" sponsor="&ff;">The 642 Release Engineering build tools have been updated to support 643 building &os;/&arch.arm; images without external utilities for 644 supported boards where a corresponding 645 <literal>u-boot</literal> port exists in the Ports 646 Collection.</para> 647 648 <para revision="283548" contrib="sponsor" sponsor="&ff;">The 649 &os;/&arch.i386; memory stick installation images are now 650 created using the &man.mkimg.1; utility, matching the way 651 the &os;/&arch.amd64; images are created.</para> 652 </sect2> 653 </sect1> 654</article> 655