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
 412         <para revision="266612">The <literal>libzfs</literal> thread
 413           pool <acronym>API</acronym> has been imported from
 414           OpenSolaris, and adapted for &os;.  This change allows
 415           parallel disk scanning, which can reduce &man.zpool.8;
 416           overall import time in some workloads.</para>
 417       </sect3>
 418     </sect2>
 419
 420     <sect2 xml:id="userland">
 421       <title>Userland Changes</title>
 422
 423       <para revision="260177" contrib="sponsor"
 424         sponsor="&netflix;">A new flag is added to &man.camcontrol.8;,
 425         <literal>-b</literal>, which outputs the existing buses and
 426         their parents.</para>
 427
 428       <para revision="262075">The &man.newsyslog.8; utility has been
 429         updated to rotate files based on the actual file size instead
 430         of the blocks on disk.  This matches the behavior documented
 431         in &man.newsyslog.conf.5;.</para>
 432
 433       <para revision="262384">The location of the &man.rctl.8;
 434         configuration file can now be overridden in &man.rc.conf.5;.
 435         To use a non-default location, set
 436         <literal>rctl_rules</literal> in &man.rc.conf.5; to the
 437         location of the file.</para>
 438
 439       <para revision="262855">The <application>ATF</application> test
 440         suite has been updated to version 0.20.</para>
 441
 442       <para revision="263019">The <literal>libucl</literal> library
 443         (Unified Configuration Library) has been merged from
 444         &os;-CURRENT.</para>
 445
 446       <para revision="263020">The &man.pkg.7; bootstrapping utility
 447         has been synced with the version in &os;-CURRENT.</para>
 448
 449       <para revision="263403">The &man.zfs.8; userland utility has
 450         been updated to include aliases for
 451         <command>snapshot</command>, which allows use of <command>zfs
 452           list -t snap</command> and <command>zfs
 453           snap</command>.</para>
 454
 455       <para revision="263405">The &man.zfs.8; userland utility has
 456         been updated to include a new flag to <command>zfs
 457           list</command>, <literal>-p</literal>, which when specified,
 458         prints the output in a parsable format.</para>
 459
 460       <para revision="263508">The &man.clang.1;/llvm suite has been
 461         updated to version 3.4.</para>
 462
 463       <para revision="263783">The Blowfish password format
 464         implementation updated.  Support for &dollar;2b&dollar; has
 465         been added, allowing use of passwords greater than 256
 466         characters long.</para>
 467
 468       <para revision="264497">The &man.iconv.3; library has been
 469         updated to match NetBSD, providing several bug fixes.</para>
 470
 471       <para revision="265265">The &man.date.1; utility has been
 472         updated to include a new flag, <literal>-R</literal>, which
 473         prints the date and time output as specified in RFC
 474         2822.</para>
 475
 476       <para revision="265533">The &man.bc.1; utility has been updated
 477         to version 1.1, in sync with the version in OpenBSD.</para>
 478
 479       <para revision="265604" contrib="vendor"
 480         vendor="&netflix;">The &man.pmcstat.8; utility has been
 481         updated to include a new flag, <literal>-a</literal>, which
 482         when specified, produces a full stack track on the sampled
 483         points.</para>
 484
 485       <para revision="265701">The &man.netstat.8; and &man.route.8;
 486         utilities have been updated to include a shorthand equivalent
 487         to the <literal>-f inet</literal> and <literal>-f
 488           inet6</literal> address specifiers, <literal>-4</literal>
 489         and <literal>-6</literal>, respectively.</para>
 490
 491       <para revision="265879">The &man.crypt.3; library now defaults
 492         to SHA512 for password hashing.</para>
 493
 494       <para revision="266014">The &man.gvinum.8; utility has been
 495         updated to allow forceful configuration reset with the
 496         <literal>-f</literal> flag.  Additionally, a bug that would
 497         prevent <literal>-f</literal> from properly creating
 498         a &man.gvinum.8; configuration has been fixed.</para>
 499
 500       <para revision="266029">The &man.login.conf.5; file now takes
 501         precedence over the shell-specific environment files.  In
 502         particular, the <literal>PATH</literal>,
 503         <literal>BLOCKSIZE</literal> variables are commented from
 504         <filename>/usr/share/skel/dot.profile</filename>, and the
 505         <literal>path</literal>, <literal>BLOCKSIZE</literal>, and
 506         <literal>umask</literal> variables have been commented from
 507         <filename>/usr/share/skel/dot.cshrc</filename>.</para>
 508
 509       <para revision="266272">The &man.binmiscctl.8; userland utility
 510         and related image activator features have been merged from
 511         &os;-CURRENT.</para>
 512
 513       <para revision="266279">The &man.ps.1; utility has been
 514         updated to include the <literal>-J</literal> flag, used to
 515         filter output by matching &man.jail.8; IDs and names.
 516         Additionally, argument <literal>0</literal> can be used to
 517         <literal>-J</literal> to only list processes running on the
 518         host system.</para>
 519
 520       <para revision="266280">The &man.top.1; utility has been updated
 521         to filter by &man.jail.8; ID or name, in followup to the
 522         &man.ps.1; change in <literal>r265229</literal>.</para>
 523
 524       <para revision="266610">The &man.gstat.8; utility has been
 525         updated to include a new flag, <literal>-o</literal>.  When
 526         set, &man.gstat.8; will display statistics for operations
 527         such as <literal>BIO_FLUSH</literal>.</para>
 528
 529       <para revision="266890">The &man.pmcstat.8; utility has been
 530         updated to include a new flag, <literal>-l</literal>, which
 531         ends event collection after the specified number of
 532         seconds.</para>
 533
 534       <para revision="267113">The default &man.newsyslog.conf.5; now
 535         includes files in the
 536         <filename>/etc/newsyslog.conf.d/</filename> and
 537         <filename>/usr/local/etc/newsyslog.conf.d/</filename>
 538         directories by default for &man.newsyslog.8;.</para>
 539
 540       <para revision="267236">A new flag, <quote>onifconsole</quote>
 541         has been added to <filename>/etc/ttys</filename>.  This allows
 542         the system to provide a login prompt via serial console if the
 543         device is an active kernel console, otherwise it is equivalent
 544         to <literal>off</literal>.</para>
 545
 546       <para revision="268161">The &man.mkimg.1; utility has been
 547         merged from &os;-CURRENT.</para>
 548
 549       <sect3 xml:id="rc-scripts">
 550         <title><filename>/etc/rc.d</filename> Scripts</title>
 551
 552         <para revision="264438">The <filename>network.subr</filename>
 553           &man.rc.8; script has been updated to loosen the requirement
 554           of listing network aliases in numeric order.  Previously,
 555           a network alias of
 556           <literal>_alias<replaceable>2</replaceable></literal>
 557           would not be created if
 558           <literal>_alias<replaceable>1</replaceable></literal> was
 559           not defined.</para>
 560       </sect3>
 561     </sect2>
 562
 563     <sect2 xml:id="contrib">
 564       <title>Contributed Software</title>
 565
 566       <para revision="263285">The &man.xz.1; utility has been updated
 567         to a post-5.0.5 snapshot.</para>
 568
 569       <para revision="263369" contrib="sponsor"
 570         sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has
 571         been updated to the r196322 snapshot.</para>
 572
 573       <para revision="264377"><application>OpenSSH</application> has
 574         been updated to version 6.6p1.</para>
 575
 576       <para revision="264911">The &man.nc.1; utility has been updated
 577         to match the version in OpenBSD 5.5.</para>
 578
 579       <para revision="265983">The timezone database has been updated
 580         to version tzdata2014c.</para>
 581
 582       <para revision="266692"><application>Sendmail</application>
 583         has been updated to 8.14.9.</para>
 584
 585       <para revision="267258"><application>OpenSSL</application> has
 586         been updated to version 1.0.1h.</para>
 587     </sect2>
 588
 589     <sect2 xml:id="ports">
 590       <title>Ports/Packages Collection Infrastructure</title>
 591
 592       <para>&nbsp;</para>
 593
 594     </sect2>
 595
 596     <sect2 xml:id="releng">
 597       <title>Release Engineering and Integration</title>
 598
 599       <para revision="263028">The &man.services.mkdb.8; utility has
 600         been updated to include endianness awareness, allowing the
 601         <filename>services.db</filename> database to be created as
 602         part of the release build, regardless of native- or
 603         cross-built releases.</para>
 604     </sect2>
 605
 606     <sect2 xml:id="doc">
 607       <title>Documentation</title>
 608
 609       <para>&nbsp;</para>
 610
 611     </sect2>
 612   </sect1>
 613
 614   <sect1 xml:id="upgrade">
 615     <title>Upgrading from Previous Releases of &os;</title>
 616
 617     <para arch="amd64,i386">Binary upgrades between RELEASE versions
 618       (and snapshots of the various security branches) are supported
 619       using the &man.freebsd-update.8; utility.  The binary upgrade
 620       procedure will update unmodified userland utilities, as well as
 621       unmodified GENERIC or SMP kernels distributed as a part of an
 622       official &os; release.  The &man.freebsd-update.8; utility
 623       requires that the host being upgraded have Internet
 624       connectivity.</para>
 625
 626     <para>Source-based upgrades (those based on recompiling the &os;
 627       base system from source code) from previous versions are
 628       supported, according to the instructions in
 629       <filename>/usr/src/UPDATING</filename>.</para>
 630
 631     <important>
 632       <para>Upgrading &os; should only be attempted after
 633         backing up <emphasis>all</emphasis> data and configuration
 634         files.</para>
 635     </important>
 636   </sect1>
 637 </article>