release/doc/en_US.ISO8859-1/relnotes/article.xml

   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$</pubdate>
  24
  25     <!-- First rev: 285831 -->
  26     <!-- Last rev: 284813 -->
  27
  28     <copyright>
  29       <year>2015</year>
  30       <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
  31         Project</holder>
  32     </copyright>
  33
  34     <legalnotice xml:id="trademarks" role="trademarks">
  35       &tm-attrib.freebsd;
  36       &tm-attrib.ibm;
  37       &tm-attrib.ieee;
  38       &tm-attrib.intel;
  39       &tm-attrib.sparc;
  40       &tm-attrib.general;
  41     </legalnotice>
  42
  43     <abstract>
  44       <para>The release notes for &os; &release.current; contain
  45         a summary of the changes made to the &os; base system on the
  46         &release.branch; development line.  This document lists
  47         applicable security advisories that were issued since the last
  48         release, as well as significant changes to the &os; kernel and
  49         userland.  Some brief remarks on upgrading are also
  50         presented.</para>
  51     </abstract>
  52   </info>
  53
  54   <sect1 xml:id="intro">
  55     <title>Introduction</title>
  56
  57     <para>This document contains the release notes for &os;
  58       &release.current;.  It describes recently added, changed, or
  59       deleted features of &os;.  It also provides some notes on
  60       upgrading from previous versions of &os;.</para>
  61
  62     <para releasetype="current">The &release.type; distribution to
  63       which these release notes apply represents the latest point
  64       along the &release.branch; development branch since
  65       &release.branch; was created.  Information regarding pre-built,
  66       binary &release.type; distributions along this branch can be
  67       found at <uri
  68         xlink:href="&release.url;">&release.url;</uri>.</para>
  69
  70     <para releasetype="snapshot">The &release.type; distribution to
  71       which these release notes apply represents a point along the
  72       &release.branch; development branch between &release.prev; and
  73       the future &release.next;.  Information regarding pre-built,
  74       binary &release.type; distributions along this branch can be
  75       found at <uri
  76         xlink:href="&release.url;">&release.url;</uri>.</para>
  77
  78     <para releasetype="release">This distribution of &os;
  79       &release.current; is a &release.type; distribution.  It can be
  80       found at <uri xlink:href="&release.url;">&release.url;</uri> or
  81       any of its mirrors.  More information on obtaining this (or
  82       other) &release.type; distributions of &os; can be found in the
  83       <link
  84         xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
  85           &os;</quote> appendix</link> to the <link
  86         xlink:href="&url.books.handbook;/">&os;
  87         Handbook</link>.</para>
  88
  89     <para>All users are encouraged to consult the release errata
  90       before installing &os;.  The errata document is updated with
  91       <quote>late-breaking</quote> information discovered late in the
  92       release cycle or after the release.  Typically, it contains
  93       information on known bugs, security advisories, and corrections
  94       to documentation.  An up-to-date copy of the errata for &os;
  95       &release.current; can be found on the &os; Web site.</para>
  96
  97     <para>This document describes the most user-visible new or changed
  98       features in &os; since &release.prev;.</para>
  99
 100     <para>Typical release note items document recent security
 101       advisories issued after &release.prev;, new drivers or hardware
 102       support, new commands or options, major bug fixes, or
 103       contributed software upgrades.  They may also list changes to
 104       major ports/packages or release engineering practices.  Clearly
 105       the release notes cannot list every single change made to &os;
 106       between releases; this document focuses primarily on security
 107       advisories, user-visible changes, and major architectural
 108       improvements.</para>
 109   </sect1>
 110
 111   <sect1 xml:id="upgrade">
 112     <title>Upgrading from Previous Releases of &os;</title>
 113
 114     <para arch="amd64,i386">Binary upgrades between RELEASE versions
 115       (and snapshots of the various security branches) are supported
 116       using the &man.freebsd-update.8; utility.  The binary upgrade
 117       procedure will update unmodified userland utilities, as well as
 118       unmodified <filename>GENERIC</filename> kernel distributed as
 119       a part of an official &os; release.  The &man.freebsd-update.8;
 120       utility requires that the host being upgraded have Internet
 121       connectivity.</para>
 122
 123     <para>Source-based upgrades (those based on recompiling the &os;
 124       base system from source code) from previous versions are
 125       supported, according to the instructions in
 126       <filename>/usr/src/UPDATING</filename>.</para>
 127
 128     <important>
 129       <para>Upgrading &os; should only be attempted after
 130         backing up <emphasis>all</emphasis> data and configuration
 131         files.</para>
 132     </important>
 133   </sect1>
 134
 135   <sect1 xml:id="security-errata">
 136     <title>Security and Errata</title>
 137
 138     <para>This section lists the various Security Advisories and
 139       Errata Notices since &release.prev;.</para>
 140
 141     <sect2 xml:id="security">
 142       <title>Security Advisories</title>
 143
 144       &security;
 145     </sect2>
 146
 147     <sect2 xml:id="errata">
 148       <title>Errata Notices</title>
 149
 150       &errata;
 151     </sect2>
 152   </sect1>
 153
 154   <sect1 xml:id="userland">
 155     <title>Userland</title>
 156
 157     <para>This section covers changes and additions to userland
 158       applications, contributed software, and system utilities.</para>
 159
 160     <sect2 xml:id="userland-config">
 161       <title>Userland Configuration Changes</title>
 162
 163       <para>&nbsp;</para>
 164     </sect2>
 165
 166     <sect2 xml:id="userland-programs">
 167       <title>Userland Application Changes</title>
 168
 169       <para revision="286064">The &man.jail.8; utility has been
 170         updated to include a new flag, <literal>-l</literal>, which
 171         ensures a clean environment in the target jail when used.
 172         Additionally, &man.jail.8; will run a shell within the target
 173         jail when run no commands are specified.</para>
 174
 175       <para revision="287122">The &man.mkimg.1; utility has been
 176         updated to include support for <literal>NTFS</literal>
 177         filesystems in both <acronym>MBR</acronym> and
 178         <acronym>GPT</acronym> partitioning schemes.</para>
 179
 180       <para revision="288202" contrib="sponsor" sponsor="&ff;">The
 181         &man.ar.1; utility now enables deterministic mode
 182         (<literal>-D</literal>) by default.  This behavior can be
 183         disabled by specifying the <literal>-U</literal> flag.</para>
 184
 185       <para revision="287746">The &man.pciconf.8; utility has been
 186         updated to use the PCI ID database from the <filename
 187           role="package">misc/pciids</filename> package, if present,
 188         falling back to the PCI ID database in the &os; base
 189         system.</para>
 190
 191       <para revision="288710" contrib="sponsor" sponsor="&gandi;">A
 192         new utility, &man.sesutil.8;, has been added, which is used
 193         to manage &man.ses.4; devices.</para>
 194     </sect2>
 195
 196     <sect2 xml:id="userland-contrib">
 197       <title>Contributed Software</title>
 198
 199       <para revision="286082">The &man.libarchive.3; library has been
 200         updated to properly skip a sparse file entry in a &man.tar.1;
 201         file, which would previously produce errors.</para>
 202
 203       <para revision="286751">Timezone data files have been updated to
 204         version 2015f.</para>
 205
 206       <para revision="295367">The <application>OpenSSH</application>
 207         suite has been updated to version 7.1p2.</para>
 208
 209       <para revision="295690">The
 210         <literal>unbound-control-setup</literal> script has been
 211         removed from the base system.</para>
 212
 213       <para revision="295691">The &man.unbound.8; utility has been
 214         updated to enable the <literal>insecure-lan-zones</literal>
 215         option in preference of listing each <acronym>AS112</acronym>
 216         zone individually.</para>
 217
 218       <para revision="296317">The <application>OpenSSL</application>
 219         suite has been updated to version 1.0.1s.</para>
 220     </sect2>
 221
 222     <sect2 xml:id="userland-installer">
 223       <title>Installation and Configuration Tools</title>
 224
 225       <para revision="295264" contrib="sponsor"
 226         sponsor="&scaleengine;">The &man.bsdinstall.8; utility has
 227         been updated to support <acronym>ZFS</acronym> installation
 228         on <acronym>EFI</acronym>-based systems.</para>
 229     </sect2>
 230
 231     <sect2 xml:id="userland-rc">
 232       <title><filename class="directory">/etc/rc.d</filename>
 233         Scripts</title>
 234
 235       <para revision="294680">The <literal>netwait</literal>
 236         &man.rc.8; script has been updated to wait for network
 237         interfaces that attach late in the boot process, such as some
 238         <acronym>USB</acronym> network cards.</para>
 239     </sect2>
 240
 241     <sect2 xml:id="userland-periodic">
 242       <title><filename class="directory">/etc/periodic</filename>
 243         Scripts</title>
 244
 245       <para>&nbsp;</para>
 246     </sect2>
 247
 248     <sect2 xml:id="userland-libraries">
 249       <title>Runtime Libraries and API</title>
 250
 251       <para>&nbsp;</para>
 252     </sect2>
 253
 254     <sect2 xml:id="userland-abi">
 255       <title>ABI Compatibility</title>
 256
 257       <para>&nbsp;</para>
 258     </sect2>
 259   </sect1>
 260
 261   <sect1 xml:id="kernel">
 262     <title>Kernel</title>
 263
 264     <para>This section covers changes to kernel configurations, system
 265       tuning, and system control parameters that are not otherwise
 266       categorized.</para>
 267
 268     <sect2 xml:id="kernel-bugfix">
 269       <title>Kernel Bug Fixes</title>
 270
 271       <para revision="288167" contrib="sponsor"
 272         sponsor="&multiplay;">The &man.kqueue.2; system call has been
 273         updated to handle write events to files larger than 2
 274         gigabytes.</para>
 275     </sect2>
 276
 277     <sect2 xml:id="kernel-config">
 278       <title>Kernel Configuration</title>
 279
 280       <para>&nbsp;</para>
 281     </sect2>
 282
 283     <sect2 xml:id="kernel-sysctl">
 284       <title>System Tuning and Controls</title>
 285
 286       <para revision="287037">The &man.uart.4; driver has been
 287         updated to allow tuning pulses per second captured in the
 288         CTS line during runtime, whereas previously only the DCD line
 289         could be used without rebuilding the kernel.</para>
 290     </sect2>
 291   </sect1>
 292
 293   <sect1 xml:id="drivers">
 294     <title>Devices and Drivers</title>
 295
 296     <para>This section covers changes and additions to devices and
 297       device drivers since &release.prev;.</para>
 298
 299     <sect2 xml:id="drivers-device">
 300       <title>Device Drivers</title>
 301
 302       <para>&nbsp;</para>
 303     </sect2>
 304
 305     <sect2 xml:id="drivers-storage">
 306       <title>Storage Drivers</title>
 307
 308       <para revision="288732" contrib="sponsor" sponsor="&ix;">The
 309         <acronym>CTL</acronym> High Availability implementation has
 310         been rewritten.</para>
 311
 312       <para revision="288810">The &man.ctl.4; driver has been updated
 313         to support CD-ROM and removable devices.</para>
 314     </sect2>
 315
 316     <sect2 xml:id="drivers-network">
 317       <title>Network Drivers</title>
 318
 319       <para revision="295524" contrib="sponsor"
 320         sponsor="&limelight;, &intelcorp;">The &man.ixgbe.4; driver
 321         has been updated to version 3.1.13-k.</para>
 322     </sect2>
 323   </sect1>
 324
 325   <sect1 xml:id="hardware">
 326     <title>Hardware Support</title>
 327
 328     <para>This section covers general hardware support for physical
 329       machines, hypervisors, and virtualization environments, as well
 330       as hardware changes and updates that do not otherwise fit in
 331       other sections of this document.</para>
 332
 333     <sect2 xml:id="hardware-support">
 334       <title>Hardware Support</title>
 335
 336       <para>&nbsp;</para>
 337     </sect2>
 338
 339     <sect2 xml:id="hardware-virtualization">
 340       <title>Virtualization Support</title>
 341
 342       <para revision="287802">The &man.xen.4; driver has been updated
 343         to include support for <literal>blkif</literal> indirect
 344         segment I/O.</para>
 345     </sect2>
 346
 347     <sect2 xml:id="hardware-arm">
 348       <title>ARM Support</title>
 349
 350       <para>&nbsp;</para>
 351     </sect2>
 352   </sect1>
 353
 354   <sect1 xml:id="storage">
 355     <title>Storage</title>
 356
 357     <para>This section covers changes and additions to file systems
 358       and other storage subsystems, both local and networked.</para>
 359
 360     <sect2 xml:id="storage-general">
 361       <title>General Storage</title>
 362
 363       <para>&nbsp;</para>
 364     </sect2>
 365
 366     <sect2 xml:id="storage-net">
 367       <title>Networked Storage</title>
 368
 369       <para>&nbsp;</para>
 370     </sect2>
 371
 372     <sect2 xml:id="storage-zfs">
 373       <title>ZFS</title>
 374
 375       <para revision="287665" contrib="sponsor"
 376         sponsor="&clusterhq;">The &man.zfs.8; <literal>l2arc</literal>
 377         code has been updated to take <literal>ashift</literal> into
 378         account when gathering buffers to be written to the
 379         <literal>l2arc</literal> device.</para>
 380     </sect2>
 381
 382     <sect2 xml:id="storage-geom">
 383       <title>&man.geom.4;</title>
 384
 385       <para>&nbsp;</para>
 386     </sect2>
 387   </sect1>
 388
 389   <sect1 xml:id="boot">
 390     <title>Boot Loader Changes</title>
 391
 392     <para>This section covers the boot loader, boot menu, and other
 393       boot-related changes.</para>
 394
 395     <sect2 xml:id="boot-loader">
 396       <title>Boot Loader Changes</title>
 397
 398       <para revision="294999" contrib="sponsor"
 399         sponsor="&multiplay;">Initial <acronym>ZFS</acronym> boot
 400         support has been added to the <acronym>EFI</acronym>
 401         implementation.</para>
 402
 403       <para revision="295475" contrib="sponsor"
 404         sponsor="&scaleengine;">The <acronym>UEFI</acronym> loader has
 405         been updated to support multiple <acronym>ZFS</acronym> boot
 406         environments, such as those provided by <filename
 407           role="package">sysutils/beadm</filename>.</para>
 408     </sect2>
 409
 410     <sect2 xml:id="boot-menu">
 411       <title>Boot Menu Changes</title>
 412
 413       <para>&nbsp;</para>
 414     </sect2>
 415   </sect1>
 416
 417   <sect1 xml:id="network">
 418     <title>Networking</title>
 419
 420     <para>This section describes changes that affect networking in
 421       &os;.</para>
 422
 423     <sect2 xml:id="network-protocols">
 424       <title>Network Protocols</title>
 425
 426       <para>&nbsp;</para>
 427     </sect2>
 428   </sect1>
 429
 430   <sect1 xml:id="ports">
 431     <title>Ports Collection and Package Infrastructure</title>
 432
 433     <para>This section covers changes to the &os;&nbsp;Ports
 434       Collection, package infrastructure, and package maintenance and
 435       installation tools.</para>
 436
 437     <sect2 xml:id="ports-infrastructure">
 438       <title>Infrastructure Changes</title>
 439
 440       <para>&nbsp;</para>
 441     </sect2>
 442
 443     <sect2 xml:id="ports-packages ">
 444       <title>Packaging Changes</title>
 445
 446       <para>&nbsp;</para>
 447     </sect2>
 448   </sect1>
 449
 450   <sect1 xml:id="doc">
 451     <title>Documentation</title>
 452
 453     <para>This section covers changes to the &os;&nbsp;Documentation
 454       Project sources and toolchain.</para>
 455
 456     <sect2 xml:id="doc-sources">
 457       <title>Documentation Source Changes</title>
 458
 459       <para>&nbsp;</para>
 460     </sect2>
 461
 462     <sect2 xml:id="doc-toolchain">
 463       <title>Documentation Toolchain Changes</title>
 464
 465       <para>&nbsp;</para>
 466     </sect2>
 467   </sect1>
 468
 469   <sect1 xml:id="releng">
 470     <title>Release Engineering and Integration</title>
 471
 472     <para>This section convers changes that are specific to the
 473       &os;&nbsp;Release Engineering processes.</para>
 474
 475     <sect2 xml:id="releng-changes">
 476       <title>Integration Changes</title>
 477
 478       <para>&nbsp;</para>
 479     </sect2>
 480   </sect1>
 481 </article>