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>&nbsp;</para>
 170     </sect2>
 171
 172     <sect2 xml:id="userland-contrib">
 173       <title>Contributed Software</title>
 174
 175       <para>&nbsp;</para>
 176     </sect2>
 177
 178     <sect2 xml:id="userland-installer">
 179       <title>Installation and Configuration Tools</title>
 180
 181       <para>&nbsp;</para>
 182     </sect2>
 183
 184     <sect2 xml:id="userland-rc">
 185       <title><filename class="directory">/etc/rc.d</filename>
 186         Scripts</title>
 187
 188       <para>&nbsp;</para>
 189     </sect2>
 190
 191     <sect2 xml:id="userland-periodic">
 192       <title><filename class="directory">/etc/periodic</filename>
 193         Scripts</title>
 194
 195       <para>&nbsp;</para>
 196     </sect2>
 197
 198     <sect2 xml:id="userland-libraries">
 199       <title>Runtime Libraries and API</title>
 200
 201       <para>&nbsp;</para>
 202     </sect2>
 203
 204     <sect2 xml:id="userland-abi">
 205       <title>ABI Compatibility</title>
 206
 207       <para>&nbsp;</para>
 208     </sect2>
 209   </sect1>
 210
 211   <sect1 xml:id="kernel">
 212     <title>Kernel</title>
 213
 214     <para>This section covers changes to kernel configurations, system
 215       tuning, and system control parameters that are not otherwise
 216       categorized.</para>
 217
 218     <sect2 xml:id="kernel-bugfix">
 219       <title>Kernel Bug Fixes</title>
 220
 221       <para>&nbsp;</para>
 222     </sect2>
 223
 224     <sect2 xml:id="kernel-config">
 225       <title>Kernel Configuration</title>
 226
 227       <para>&nbsp;</para>
 228     </sect2>
 229
 230     <sect2 xml:id="kernel-sysctl">
 231       <title>System Tuning and Controls</title>
 232
 233       <para>&nbsp;</para>
 234     </sect2>
 235   </sect1>
 236
 237   <sect1 xml:id="drivers">
 238     <title>Devices and Drivers</title>
 239
 240     <para>This section covers changes and additions to devices and
 241       device drivers since &release.prev;.</para>
 242
 243     <sect2 xml:id="drivers-device">
 244       <title>Device Drivers</title>
 245
 246       <para>&nbsp;</para>
 247     </sect2>
 248
 249     <sect2 xml:id="drivers-storage">
 250       <title>Storage Drivers</title>
 251
 252       <para>&nbsp;</para>
 253     </sect2>
 254
 255     <sect2 xml:id="drivers-network">
 256       <title>Network Drivers</title>
 257
 258       <para>&nbsp;</para>
 259     </sect2>
 260   </sect1>
 261
 262   <sect1 xml:id="hardware">
 263     <title>Hardware Support</title>
 264
 265     <para>This section covers general hardware support for physical
 266       machines, hypervisors, and virtualization environments, as well
 267       as hardware changes and updates that do not otherwise fit in
 268       other sections of this document.</para>
 269
 270     <sect2 xml:id="hardware-support">
 271       <title>Hardware Support</title>
 272
 273       <para>&nbsp;</para>
 274     </sect2>
 275
 276     <sect2 xml:id="hardware-virtualization">
 277       <title>Virtualization Support</title>
 278
 279       <para>&nbsp;</para>
 280     </sect2>
 281
 282     <sect2 xml:id="hardware-arm">
 283       <title>ARM Support</title>
 284
 285       <para>&nbsp;</para>
 286     </sect2>
 287   </sect1>
 288
 289   <sect1 xml:id="storage">
 290     <title>Storage</title>
 291
 292     <para>This section covers changes and additions to file systems
 293       and other storage subsystems, both local and networked.</para>
 294
 295     <sect2 xml:id="storage-general">
 296       <title>General Storage</title>
 297
 298       <para>&nbsp;</para>
 299     </sect2>
 300
 301     <sect2 xml:id="storage-net">
 302       <title>Networked Storage</title>
 303
 304       <para>&nbsp;</para>
 305     </sect2>
 306
 307     <sect2 xml:id="storage-zfs">
 308       <title>ZFS</title>
 309
 310       <para>&nbsp;</para>
 311     </sect2>
 312
 313     <sect2 xml:id="storage-geom">
 314       <title>&man.geom.4;</title>
 315
 316       <para>&nbsp;</para>
 317     </sect2>
 318   </sect1>
 319
 320   <sect1 xml:id="boot">
 321     <title>Boot Loader Changes</title>
 322
 323     <para>This section covers the boot loader, boot menu, and other
 324       boot-related changes.</para>
 325
 326     <sect2 xml:id="boot-loader">
 327       <title>Boot Loader Changes</title>
 328
 329       <para>&nbsp;</para>
 330     </sect2>
 331
 332     <sect2 xml:id="boot-menu">
 333       <title>Boot Menu Changes</title>
 334
 335       <para>&nbsp;</para>
 336     </sect2>
 337   </sect1>
 338
 339   <sect1 xml:id="network">
 340     <title>Networking</title>
 341
 342     <para>This section describes changes that affect networking in
 343       &os;.</para>
 344
 345     <sect2 xml:id="network-protocols">
 346       <title>Network Protocols</title>
 347
 348       <para>&nbsp;</para>
 349     </sect2>
 350   </sect1>
 351
 352   <sect1 xml:id="ports">
 353     <title>Ports Collection and Package Infrastructure</title>
 354
 355     <para>This section covers changes to the &os;&nbsp;Ports
 356       Collection, package infrastructure, and package maintenance and
 357       installation tools.</para>
 358
 359     <sect2 xml:id="ports-infrastructure">
 360       <title>Infrastructure Changes</title>
 361
 362       <para>&nbsp;</para>
 363     </sect2>
 364
 365     <sect2 xml:id="ports-packages ">
 366       <title>Packaging Changes</title>
 367
 368       <para>&nbsp;</para>
 369     </sect2>
 370   </sect1>
 371
 372   <sect1 xml:id="doc">
 373     <title>Documentation</title>
 374
 375     <para>This section covers changes to the &os;&nbsp;Documentation
 376       Project sources and toolchain.</para>
 377
 378     <sect2 xml:id="doc-sources">
 379       <title>Documentation Source Changes</title>
 380
 381       <para>&nbsp;</para>
 382     </sect2>
 383
 384     <sect2 xml:id="doc-toolchain">
 385       <title>Documentation Toolchain Changes</title>
 386
 387       <para>&nbsp;</para>
 388     </sect2>
 389   </sect1>
 390
 391   <sect1 xml:id="releng">
 392     <title>Release Engineering and Integration</title>
 393
 394     <para>This section convers changes that are specific to the
 395       &os;&nbsp;Release Engineering processes.</para>
 396
 397     <sect2 xml:id="releng-changes">
 398       <title>Integration Changes</title>
 399
 400       <para>&nbsp;</para>
 401     </sect2>
 402   </sect1>
 403 </article>