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 ]>
  11 <article xmlns="http://docbook.org/ns/docbook"
  12   xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
  13
  14   <info>
  15     <title>&os; &release.current; Release Notes</title>
  16
  17     <author>
  18       <orgname>The &os; Project</orgname>
  19     </author>
  20
  21     <pubdate>$FreeBSD$</pubdate>
  22
  23     <copyright>
  24       <year>2000</year>
  25       <year>2001</year>
  26       <year>2002</year>
  27       <year>2003</year>
  28       <year>2004</year>
  29       <year>2005</year>
  30       <year>2006</year>
  31       <year>2007</year>
  32       <year>2008</year>
  33       <year>2009</year>
  34       <year>2010</year>
  35       <year>2011</year>
  36       <year>2012</year>
  37       <year>2013</year>
  38       <year>2014</year>
  39       <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
  40         Project</holder>
  41     </copyright>
  42
  43     <legalnotice xml:id="trademarks" role="trademarks">
  44       &tm-attrib.freebsd;
  45       &tm-attrib.ibm;
  46       &tm-attrib.ieee;
  47       &tm-attrib.intel;
  48       &tm-attrib.sparc;
  49       &tm-attrib.general;
  50     </legalnotice>
  51
  52     <abstract>
  53       <para>The release notes for &os; &release.current; contain
  54         a summary of the changes made to the &os; base system on the
  55         &release.branch; development line.  This document lists
  56         applicable security advisories that were issued since the last
  57         release, as well as significant changes to the &os; kernel and
  58         userland.  Some brief remarks on upgrading are also
  59         presented.</para>
  60     </abstract>
  61   </info>
  62
  63   <sect1 xml:id="intro">
  64     <title>Introduction</title>
  65
  66     <para>This document contains the release notes for &os;
  67       &release.current;.  It describes recently added, changed, or
  68       deleted features of &os;.  It also provides some notes on
  69       upgrading from previous versions of &os;.</para>
  70
  71     <para releasetype="current">The &release.type; distribution to
  72       which these release notes apply represents the latest point
  73       along the &release.branch; development branch since
  74       &release.branch; was created.  Information regarding pre-built,
  75       binary &release.type; distributions along this branch can be
  76       found at <uri
  77         xlink:href="&release.url;">&release.url;</uri>.</para>
  78
  79     <para releasetype="snapshot">The &release.type; distribution to
  80       which these release notes apply represents a point along the
  81       &release.branch; development branch between &release.prev; and
  82       the future &release.next;.  Information regarding pre-built,
  83       binary &release.type; distributions along this branch can be
  84       found at <uri
  85         xlink:href="&release.url;">&release.url;</uri>.</para>
  86
  87     <para releasetype="release">This distribution of &os;
  88       &release.current; is a &release.type; distribution.  It can be
  89       found at <uri xlink:href="&release.url;">&release.url;</uri> or
  90       any of its mirrors.  More information on obtaining this (or
  91       other) &release.type; distributions of &os; can be found in the
  92       <link
  93         xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
  94           &os;</quote> appendix</link> to the <link
  95         xlink:href="&url.books.handbook;/">&os;
  96         Handbook</link>.</para>
  97
  98     <para>All users are encouraged to consult the release errata
  99       before installing &os;.  The errata document is updated with
 100       <quote>late-breaking</quote> information discovered late in the
 101       release cycle or after the release.  Typically, it contains
 102       information on known bugs, security advisories, and corrections
 103       to documentation.  An up-to-date copy of the errata for &os;
 104       &release.current; can be found on the &os; Web site.</para>
 105   </sect1>
 106
 107   <sect1 xml:id="new">
 108     <title>What's New</title>
 109
 110     <para>This section describes the most user-visible new or changed
 111       features in &os; since &release.prev;.</para>
 112
 113     <para>Typical release note items document recent security
 114       advisories issued after &release.prev;, new drivers or hardware
 115       support, new commands or options, major bug fixes, or
 116       contributed software upgrades.  They may also list changes to
 117       major ports/packages or release engineering practices.  Clearly
 118       the release notes cannot list every single change made to &os;
 119       between releases; this document focuses primarily on security
 120       advisories, user-visible changes, and major architectural
 121       improvements.</para>
 122
 123     <sect2 xml:id="security">
 124       <title>Security Advisories</title>
 125
 126       <para>&nbsp;</para>
 127
 128     </sect2>
 129
 130     <sect2 xml:id="kernel">
 131       <title>Kernel Changes</title>
 132
 133       <para revision="260338">The
 134         <literal>vfs.zfs.zio.use_uma</literal> &man.sysctl.8; has been
 135         re-enabled.  On multi-CPU machines with enough RAM, this can
 136         easily double &man.zfs.8; performance or reduce CPU usage in
 137         half.  It was originally disabled due to memory and
 138         <acronym>KVA</acronym> exhaustion problem reports, which
 139         should be resolved due to several change in the VM
 140         subsystem.</para>
 141
 142       <para revision="260385" contrib="sponsor" sponsor="&ix;">The
 143         &man.geom.4; RAID driver has been
 144         updated to support unmapped I/O.</para>
 145
 146       <para revision="260431">A new &man.sysctl.8;,
 147         <literal>kern.panic_reboot_wait_time</literal>, has been
 148         added, which allows controlling how long the system will wait
 149         after &man.panic.9; before rebooting.</para>
 150
 151       <para revision="260857">The &man.virtio_blk.4; driver has been
 152         updated to support unmapped I/O.</para>
 153
 154       <para revision="260858">The &man.virtio_scsi.4; driver has been
 155         updated to support unmapped I/O.</para>
 156
 157       <para revision="262861">The &man.vt.4; driver has been merged
 158         from &os;-CURRENT.  To enable &man.vt.4;, enter
 159         <literal>set kern.vty=vt</literal> at the &man.loader.8;
 160         prompt during boot, or add <literal>kern.vty=vt</literal> to
 161         &man.loader.conf.5; and reboot the system.</para>
 162
 163       <para revision="262967">Support for MegaRAID Fury cards has been
 164         added to the &man.mfi.4; driver.</para>
 165
 166       <para revision="263024">The &man.aacraid.4; driver has been
 167         updated to version 3.2.5.</para>
 168
 169       <para revision="263122">Support for &man.hwpmc.4; has been added
 170         for &powerpc;&nbsp;970 class processors.</para>
 171
 172       <para revision="263197">Support for ADT7460 and ADT7467 fan
 173         controllers found in newer PowerBooks&trade; and
 174         iBooks&trade; has been added to the &man.iicbus.4;
 175         driver.</para>
 176
 177       <para revision="263256">A panic triggered by removing
 178         a &man.urtwn.4; device has been fixed.</para>
 179
 180       <para revision="263799">A potential deadlock in the &man.usb.4;
 181         stack triggered by detaching USB devices that create character
 182         devices has been fixed.</para>
 183
 184       <para revision="263869">Support for &amd;&nbsp;Family 16h sensor
 185         devices has been added to &man.amdtemp.4;.</para>
 186
 187       <para revision="264522">Support for LUN-based CD changers has
 188         been removed from the &man.cd.4; driver.</para>
 189
 190       <para revision="264734">Support for 9th generation HP host bus
 191         adapter cards has been added to &man.ciss.4;.</para>
 192
 193       <para revision="265388" contrib="sponsor" sponsor="&lsi;">The
 194         &man.mpr.4; device has been added,
 195         providing support for LSI Fusion-MPT 3 12Gb SCSI/SATA
 196         controllers.</para>
 197
 198       <para revision="265536">The <literal>GEOM_VINUM</literal> option
 199         is now able to be built both directly into the kernel or as
 200         a &man.kldload.8; loadable module.</para>
 201
 202       <para revision="265610">The &man.uslcom.4; driver has been
 203         updated to support 26 new devices.</para>
 204
 205       <para revision="265922" contrib="sponsor" sponsor="&lsi;">The
 206         &man.mrsas.4; driver has been added,
 207         providing support for LSI MegaRAID SAS controllers.  The
 208         &man.mfi.4; driver will attach to the controller, by default.
 209         To enable &man.mrsas.4; add
 210         <literal>hw.mfi.mrsas_enable=1</literal> to
 211         <filename>/boot/loader.conf</filename>, which turns off
 212         &man.mfi.4; device probing.</para>
 213
 214       <note>
 215         <para>At this time, the &man.mfiutil.8; utility and
 216           the &os; version of
 217           <application>MegaCLI</application> and
 218           <application>StorCli</application> do not work with
 219           &man.mrsas.4;.</para>
 220       </note>
 221
 222       <para revision="266165">A kernel bug that inhibited proper
 223         functionality of the <literal>dev.cpu.0.freq</literal>
 224         &man.sysctl.8; on &intel; processors with Turbo
 225         Boost&trade; enabled has been fixed.</para>
 226
 227         <para revision="266220">The &man.geom.uncompress.4; module is
 228           built by default which, similar to &man.geom.uzip.4;,
 229           provides support for compressed, read-only disk
 230           images.</para>
 231
 232         <para revision="266436">The &man.uart.4; driver has been
 233           updated to include support for the &intel;&nbsp;Lynx Point
 234           KT <acronym>AMT</acronym> serial port.</para>
 235
 236       <sect3 xml:id="kernel-virtualization">
 237         <title>Virtualization Support</title>
 238
 239         <para revision="259450">Support for &microsoft; Hyper-V
 240           has been added to &os;/i386 as loadable modules, however
 241           not available in the <filename>GENERIC</filename> kernel
 242           configuration.</para>
 243
 244         <para revision="261090">The &man.bhyve.4; hypervisor now
 245           supports soft power-off functionality via the ACPI S5
 246           state.</para>
 247       </sect3>
 248
 249       <sect3 xml:id="kernel-arm">
 250         <title>ARM Support</title>
 251
 252         <para revision="259355">The <filename>WANDBOARD</filename>
 253           kernel configuration file has been added.</para>
 254
 255         <para revision="265067">Boot devices may now be specified by
 256           setting a u-boot environment variable.  If a boot device is
 257           not specified, the probe mechanism will be used.  To specify
 258           the boot device, set the
 259           <literal>loaderdev=<replaceable>device</replaceable></literal>
 260           u-boot environment variable.</para>
 261
 262         <para revision="266000">The <literal>nexus(4)</literal> driver
 263           has been updated to include <quote>Flattened Device
 264             Tree</quote> support, replacing the &man.fdtbus.4; driver
 265           in most cases.</para>
 266
 267         <para revision="266105">The &man.gpioiic.4; and
 268           &man.gpioled.4; have been merged from &os;-CURRENT.</para>
 269
 270         <para revision="266379">The <literal>ZEDBOARD</literal> kernel
 271           configuration file has been updated to include
 272           <acronym>SMP</acronym> support.</para>
 273       </sect3>
 274
 275       <sect3 xml:id="boot">
 276         <title>Boot Loader Changes</title>
 277
 278         <para revision="262701">A kernel selection menu has been added
 279           to &man.loader.8;.  If the <quote>beastie menu</quote> is
 280           enabled, the kernel to boot may be selected from the kernel
 281           selection menu.  Additional kernels may be listed in
 282           &man.loader.conf.5; as a comma- or space-separated list.  By
 283           default, <literal>kernel</literal> and
 284           <literal>kernel.old</literal> are listed.</para>
 285       </sect3>
 286
 287       <sect3 xml:id="proc">
 288         <title>Hardware Support</title>
 289
 290         <para>&nbsp;</para>
 291
 292         <sect4 xml:id="mm">
 293           <title>Multimedia Support</title>
 294
 295           <para>&nbsp;</para>
 296
 297         </sect4>
 298
 299         <sect4 xml:id="net-if">
 300           <title>Network Interface Support</title>
 301
 302           <para revision="259453">Support for Ralink RT5370 and
 303             RT5372 chipsets has been added to the &man.run.4;
 304             driver.</para>
 305
 306           <para revision="260120">Firmware for the &man.run.4; driver
 307             has been updated to version 0.33.</para>
 308
 309           <para revision="261868">Support for the Ralink RT3593
 310             chipset has been added to the &man.run.4; driver.</para>
 311
 312           <para revision="261972">The &man.nve.4; driver is now
 313             deprecated, and the &man.nfe.4; driver should be used
 314             instead.</para>
 315
 316           <para revision="262137">Support for the &man.axge.4; driver
 317             has been added.  This driver supports the ASIX AX88178A
 318             and AX88179 USB ethernet adapters.  The AX88178A supports
 319             USB 2.0, and the AX88179 supports USB 2.0 and 3.0.</para>
 320
 321           <para revision="262363">The &man.urndis.4; driver has been
 322             imported from OpenBSD.</para>
 323
 324           <para revision="264866">Support for multiple
 325             transmitter/receiver queues has been added to the
 326             &man.vmx.4; driver.</para>
 327
 328           <note>
 329             <para>The &os;&nbsp;guest operating system must have
 330               <acronym>MSIX</acronym> enabled as a prerequisite for
 331               multiple queues.</para>
 332           </note>
 333
 334           <para revision="265345">Support for the ASUS USB-N10 Nano
 335             wireless card has been added to the &man.urtwn.4;
 336             driver.</para>
 337
 338           <para revision="266212">Transmission checksum offloading has
 339             been disabled for the RTL8168C and RTL8168CP chipsets in
 340             the &man.re.4; driver for TCP and UDP frames.  This is
 341             due to a report of UDP datagrams with IP options
 342             generating corrupt frames.</para>
 343
 344           <para revision="266578">Preliminary support has been added
 345             to the &man.urtwn.4; driver for the Realtek RTL8188EUS and
 346             RTL8188ETV chipsets.</para>
 347         </sect4>
 348       </sect3>
 349
 350       <sect3 xml:id="net-proto">
 351         <title>Network Protocols</title>
 352
 353         <para revision="265946">Support for the UDP-Lite protocol
 354           (RFC 3828) has been added to the IPv4 and IPv6
 355           stacks.</para>
 356       </sect3>
 357
 358       <sect3 xml:id="disks">
 359         <title>Disks and Storage</title>
 360
 361         <para revision="259328" contrib="sponsor" sponsor="&ff;">The
 362           &man.geom.8; <literal>label</literal> class is now aware of
 363           resized partitions.  This corrects an issue where
 364           <command>geom resize</command> would resize the partition,
 365           but the label provider in <filename
 366             class="directory">/dev/gptid/</filename> would not be
 367           resized.</para>
 368
 369         <para revision="260502">The &man.gmirror.8;
 370           utility now has a <literal>resize</literal> command, making
 371           it easier to resize the size of a mirror when all of its
 372           components have been replaced.</para>
 373
 374         <para revision="265912">The &man.geom.8;
 375           <literal>GEOM_PART</literal> class has been updated to
 376           support automatic partition resizing.  Changes to the
 377           partition size are not saved to disk until
 378           <command>gpart commit</command> is run, and prior to saving,
 379           can be reverted with <command>gpart undo</command>.</para>
 380
 381         <para revision="268091">Support for the
 382           <literal>disklabel64</literal> partitioning scheme has been
 383           added to &man.gpart.8;.</para>
 384
 385         <para revision="266594">The <literal>radeonkms(4)</literal>
 386           driver has been updated to include 32-bit &man.ioctl.2;
 387           support, allowing 32-bit applications to run on a 64-bit
 388           system.</para>
 389       </sect3>
 390
 391       <sect3 xml:id="fs">
 392         <title>File Systems</title>
 393
 394         <para revision="260178" contrib="vendor"
 395           vendor="&netflix;">A new flag, <literal>-R</literal>,
 396           has been added to the &man.fsck.ffs.8; utility.  When used,
 397           &man.fsck.ffs.8; will restart itself when too many critical
 398           errors have been detected.</para>
 399
 400         <para revision="263407">The &man.zfs.8; filesystem has been
 401           updated to implement <quote>bookmarks</quote>.  See
 402           &man.zfs.8; for further details.</para>
 403
 404         <para revision="266122">The &man.zfs.8; filesystem has been
 405           updated to allow tuning the minimum <quote>ashift</quote>
 406           value when creating new top-level virtual devices (vdevs).
 407           To set the minimum ashift value, for example when creating
 408           a &man.zpool.8; on <quote>Advanced Format</quote> drives,
 409           set the <literal>vfs.zfs.min_auto_ashift</literal>
 410           &man.sysctl.8; accordingly.</para>
 411       </sect3>
 412     </sect2>
 413
 414     <sect2 xml:id="userland">
 415       <title>Userland Changes</title>
 416
 417       <para revision="260177" contrib="sponsor"
 418         sponsor="&netflix;">A new flag is added to &man.camcontrol.8;,
 419         <literal>-b</literal>, which outputs the existing buses and
 420         their parents.</para>
 421
 422       <para revision="262075">The &man.newsyslog.8; utility has been
 423         updated to rotate files based on the actual file size instead
 424         of the blocks on disk.  This matches the behavior documented
 425         in &man.newsyslog.conf.5;.</para>
 426
 427       <para revision="262384">The location of the &man.rctl.8;
 428         configuration file can now be overridden in &man.rc.conf.5;.
 429         To use a non-default location, set
 430         <literal>rctl_rules</literal> in &man.rc.conf.5; to the
 431         location of the file.</para>
 432
 433       <para revision="262855">The <application>ATF</application> test
 434         suite has been updated to version 0.20.</para>
 435
 436       <para revision="263019">The <literal>libucl</literal> library
 437         (Unified Configuration Library) has been merged from
 438         &os;-CURRENT.</para>
 439
 440       <para revision="263020">The &man.pkg.7; bootstrapping utility
 441         has been synced with the version in &os;-CURRENT.</para>
 442
 443       <para revision="263403">The &man.zfs.8; userland utility has
 444         been updated to include aliases for
 445         <command>snapshot</command>, which allows use of <command>zfs
 446           list -t snap</command> and <command>zfs
 447           snap</command>.</para>
 448
 449       <para revision="263405">The &man.zfs.8; userland utility has
 450         been updated to include a new flag to <command>zfs
 451           list</command>, <literal>-p</literal>, which when specified,
 452         prints the output in a parsable format.</para>
 453
 454       <para revision="263508">The &man.clang.1;/llvm suite has been
 455         updated to version 3.4.</para>
 456
 457       <para revision="263783">The Blowfish password format
 458         implementation updated.  Support for &dollar;2b&dollar; has
 459         been added, allowing use of passwords greater than 256
 460         characters long.</para>
 461
 462       <para revision="264497">The &man.iconv.3; library has been
 463         updated to match NetBSD, providing several bug fixes.</para>
 464
 465       <para revision="265265">The &man.date.1; utility has been
 466         updated to include a new flag, <literal>-R</literal>, which
 467         prints the date and time output as specified in RFC
 468         2822.</para>
 469
 470       <para revision="265533">The &man.bc.1; utility has been updated
 471         to version 1.1, in sync with the version in OpenBSD.</para>
 472
 473       <para revision="265604" contrib="vendor"
 474         vendor="&netflix;">The &man.pmcstat.8; utility has been
 475         updated to include a new flag, <literal>-a</literal>, which
 476         when specified, produces a full stack track on the sampled
 477         points.</para>
 478
 479       <para revision="265701">The &man.netstat.8; and &man.route.8;
 480         utilities have been updated to include a shorthand equivalent
 481         to the <literal>-f inet</literal> and <literal>-f
 482           inet6</literal> address specifiers, <literal>-4</literal>
 483         and <literal>-6</literal>, respectively.</para>
 484
 485       <para revision="265879">The &man.crypt.3; library now defaults
 486         to SHA512 for password hashing.</para>
 487
 488       <para revision="266014">The &man.gvinum.8; utility has been
 489         updated to allow forceful configuration reset with the
 490         <literal>-f</literal> flag.  Additionally, a bug that would
 491         prevent <literal>-f</literal> from properly creating
 492         a &man.gvinum.8; configuration has been fixed.</para>
 493
 494       <para revision="266029">The &man.login.conf.5; file now takes
 495         precedence over the shell-specific environment files.  In
 496         particular, the <literal>PATH</literal>,
 497         <literal>BLOCKSIZE</literal> variables are commented from
 498         <filename>/usr/share/skel/dot.profile</filename>, and the
 499         <literal>path</literal>, <literal>BLOCKSIZE</literal>, and
 500         <literal>umask</literal> variables have been commented from
 501         <filename>/usr/share/skel/dot.cshrc</filename>.</para>
 502
 503       <para revision="266272">The &man.binmiscctl.8; userland utility
 504         and related image activator features have been merged from
 505         &os;-CURRENT.</para>
 506
 507       <para revision="266279">The &man.ps.1; utility has been
 508         updated to include the <literal>-J</literal> flag, used to
 509         filter output by matching &man.jail.8; IDs and names.
 510         Additionally, argument <literal>0</literal> can be used to
 511         <literal>-J</literal> to only list processes running on the
 512         host system.</para>
 513
 514       <para revision="266280">The &man.top.1; utility has been updated
 515         to filter by &man.jail.8; ID or name, in followup to the
 516         &man.ps.1; change in <literal>r265229</literal>.</para>
 517
 518       <para revision="266890">The &man.pmcstat.8; utility has been
 519         updated to include a new flag, <literal>-l</literal>, which
 520         ends event collection after the specified number of
 521         seconds.</para>
 522
 523       <para revision="267113">The default &man.newsyslog.conf.5; now
 524         includes files in the
 525         <filename>/etc/newsyslog.conf.d/</filename> and
 526         <filename>/usr/local/etc/newsyslog.conf.d/</filename>
 527         directories by default for &man.newsyslog.8;.</para>
 528
 529       <para revision="267236">A new flag, <quote>onifconsole</quote>
 530         has been added to <filename>/etc/ttys</filename>.  This allows
 531         the system to provide a login prompt via serial console if the
 532         device is an active kernel console, otherwise it is equivalent
 533         to <literal>off</literal>.</para>
 534
 535       <para revision="268161">The &man.mkimg.1; utility has been
 536         merged from &os;-CURRENT.</para>
 537
 538       <sect3 xml:id="rc-scripts">
 539         <title><filename>/etc/rc.d</filename> Scripts</title>
 540
 541         <para revision="264438">The <filename>network.subr</filename>
 542           &man.rc.8; script has been updated to loosen the requirement
 543           of listing network aliases in numeric order.  Previously,
 544           a network alias of
 545           <literal>_alias<replaceable>2</replaceable></literal>
 546           would not be created if
 547           <literal>_alias<replaceable>1</replaceable></literal> was
 548           not defined.</para>
 549       </sect3>
 550     </sect2>
 551
 552     <sect2 xml:id="contrib">
 553       <title>Contributed Software</title>
 554
 555       <para revision="263285">The &man.xz.1; utility has been updated
 556         to a post-5.0.5 snapshot.</para>
 557
 558       <para revision="263369" contrib="sponsor"
 559         sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has
 560         been updated to the r196322 snapshot.</para>
 561
 562       <para revision="264377"><application>OpenSSH</application> has
 563         been updated to version 6.6p1.</para>
 564
 565       <para revision="264911">The &man.nc.1; utility has been updated
 566         to match the version in OpenBSD 5.5.</para>
 567
 568       <para revision="265983">The timezone database has been updated
 569         to version tzdata2014c.</para>
 570
 571       <para revision="266692"><application>Sendmail</application>
 572         has been updated to 8.14.9.</para>
 573
 574       <para revision="267258"><application>OpenSSL</application> has
 575         been updated to version 1.0.1h.</para>
 576     </sect2>
 577
 578     <sect2 xml:id="ports">
 579       <title>Ports/Packages Collection Infrastructure</title>
 580
 581       <para>&nbsp;</para>
 582
 583     </sect2>
 584
 585     <sect2 xml:id="releng">
 586       <title>Release Engineering and Integration</title>
 587
 588       <para revision="263028">The &man.services.mkdb.8; utility has
 589         been updated to include endianness awareness, allowing the
 590         <filename>services.db</filename> database to be created as
 591         part of the release build, regardless of native- or
 592         cross-built releases.</para>
 593     </sect2>
 594
 595     <sect2 xml:id="doc">
 596       <title>Documentation</title>
 597
 598       <para>&nbsp;</para>
 599
 600     </sect2>
 601   </sect1>
 602
 603   <sect1 xml:id="upgrade">
 604     <title>Upgrading from Previous Releases of &os;</title>
 605
 606     <para arch="amd64,i386">Binary upgrades between RELEASE versions
 607       (and snapshots of the various security branches) are supported
 608       using the &man.freebsd-update.8; utility.  The binary upgrade
 609       procedure will update unmodified userland utilities, as well as
 610       unmodified GENERIC or SMP kernels distributed as a part of an
 611       official &os; release.  The &man.freebsd-update.8; utility
 612       requires that the host being upgraded have Internet
 613       connectivity.</para>
 614
 615     <para>Source-based upgrades (those based on recompiling the &os;
 616       base system from source code) from previous versions are
 617       supported, according to the instructions in
 618       <filename>/usr/src/UPDATING</filename>.</para>
 619
 620     <important>
 621       <para>Upgrading &os; should only be attempted after
 622         backing up <emphasis>all</emphasis> data and configuration
 623         files.</para>
 624     </important>
 625   </sect1>
 626 </article>