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">
6 <!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "sponsor.ent">
8 <!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "vendor.ent">
11 <article xmlns="http://docbook.org/ns/docbook"
12 xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
15 <title>&os; &release.current; Release Notes</title>
18 <orgname>The &os; Project</orgname>
21 <pubdate>$FreeBSD$</pubdate>
39 <holder role="mailto:doc@FreeBSD.org">The &os; Documentation
43 <legalnotice xml:id="trademarks" role="trademarks">
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
63 <sect1 xml:id="intro">
64 <title>Introduction</title>
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>
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
77 xlink:href="&release.url;">&release.url;</uri>.</para>
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
85 xlink:href="&release.url;">&release.url;</uri>.</para>
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
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>
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>
108 <title>What's New</title>
110 <para>This section describes the most user-visible new or changed
111 features in &os; since &release.prev;.</para>
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
123 <sect2 xml:id="security">
124 <title>Security Advisories</title>
130 <sect2 xml:id="kernel">
131 <title>Kernel Changes</title>
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
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>
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>
151 <para revision="260857">The &man.virtio_blk.4; driver has been
152 updated to support unmapped I/O.</para>
154 <para revision="260858">The &man.virtio_scsi.4; driver has been
155 updated to support unmapped I/O.</para>
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>
163 <para revision="262967">Support for MegaRAID Fury cards has been
164 added to the &man.mfi.4; driver.</para>
166 <para revision="263024">The &man.aacraid.4; driver has been
167 updated to version 3.2.5.</para>
169 <para revision="263122">Support for &man.hwpmc.4; has been added
170 for &powerpc; 970 class processors.</para>
172 <para revision="263197">Support for ADT7460 and ADT7467 fan
173 controllers found in newer PowerBooks™ and
174 iBooks™ has been added to the &man.iicbus.4;
177 <para revision="263256">A panic triggered by removing
178 a &man.urtwn.4; device has been fixed.</para>
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>
184 <para revision="263869">Support for &amd; Family 16h sensor
185 devices has been added to &man.amdtemp.4;.</para>
187 <para revision="264522">Support for LUN-based CD changers has
188 been removed from the &man.cd.4; driver.</para>
190 <para revision="264734">Support for 9th generation HP host bus
191 adapter cards has been added to &man.ciss.4;.</para>
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
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>
202 <para revision="265610">The &man.uslcom.4; driver has been
203 updated to support 26 new devices.</para>
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>
215 <para>At this time, the &man.mfiutil.8; utility and
217 <application>MegaCLI</application> and
218 <application>StorCli</application> do not work with
219 &man.mrsas.4;.</para>
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™ enabled has been fixed.</para>
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
232 <para revision="266436">The &man.uart.4; driver has been
233 updated to include support for the &intel; Lynx Point
234 KT <acronym>AMT</acronym> serial port.</para>
236 <para revision="266718">A bug that would prevent
237 a &man.jail.8; from setting the correct IPv4 source address
238 with some operations that required
239 <literal>security.jail.allow_raw_sockets</literal> has been
242 <para revision="266911">The &man.hwpmc.4; driver has been
243 updated to support core events from the Atom™
244 Silvermont architecture.</para>
246 <para revision="267084">The &man.mfi.4; driver has been
247 updated to include support for unmapped I/O.</para>
249 <para revision="267457">The &man.hpt27xx.4; driver has been
250 updated with various vendor-supplied bug fixes.</para>
252 <sect3 xml:id="kernel-virtualization">
253 <title>Virtualization Support</title>
255 <para revision="259450">Support for µsoft; Hyper-V
256 has been added to &os;/i386 as loadable modules, however
257 not available in the <filename>GENERIC</filename> kernel
258 configuration.</para>
260 <para revision="261090">The &man.bhyve.4; hypervisor now
261 supports soft power-off functionality via the ACPI S5
264 <para revision="267399">Support for &os;/i386 guests has been
265 added to &man.bhyve.4;.</para>
267 <para revision="267427">Support for virtualized
268 <literal>XSAVE</literal> has been added to &man.bhyve.4;,
269 allowing guest operating systems to use
270 <literal>XSAVE</literal> and
271 <literal>XSAVE</literal>-enabled features, such as
272 <acronym>AVX</acronym>.</para>
275 <sect3 xml:id="kernel-arm">
276 <title>ARM Support</title>
278 <para revision="259355">The <filename>WANDBOARD</filename>
279 kernel configuration file has been added.</para>
281 <para revision="265067">Boot devices may now be specified by
282 setting a u-boot environment variable. If a boot device is
283 not specified, the probe mechanism will be used. To specify
284 the boot device, set the
285 <literal>loaderdev=<replaceable>device</replaceable></literal>
286 u-boot environment variable.</para>
288 <para revision="266000">The <literal>nexus(4)</literal> driver
289 has been updated to include <quote>Flattened Device
290 Tree</quote> support, replacing the &man.fdtbus.4; driver
291 in most cases.</para>
293 <para revision="266105">The &man.gpioiic.4; and
294 &man.gpioled.4; have been merged from &os;-CURRENT.</para>
296 <para revision="266379">The <literal>ZEDBOARD</literal> kernel
297 configuration file has been updated to include
298 <acronym>SMP</acronym> support.</para>
301 <sect3 xml:id="boot">
302 <title>Boot Loader Changes</title>
304 <para revision="262701">A kernel selection menu has been added
305 to &man.loader.8;. If the <quote>beastie menu</quote> is
306 enabled, the kernel to boot may be selected from the kernel
307 selection menu. Additional kernels may be listed in
308 &man.loader.conf.5; as a comma- or space-separated list. By
309 default, <literal>kernel</literal> and
310 <literal>kernel.old</literal> are listed.</para>
313 <sect3 xml:id="proc">
314 <title>Hardware Support</title>
319 <title>Multimedia Support</title>
325 <sect4 xml:id="net-if">
326 <title>Network Interface Support</title>
328 <para revision="259453">Support for Ralink RT5370 and
329 RT5372 chipsets has been added to the &man.run.4;
332 <para revision="260120">Firmware for the &man.run.4; driver
333 has been updated to version 0.33.</para>
335 <para revision="261868">Support for the Ralink RT3593
336 chipset has been added to the &man.run.4; driver.</para>
338 <para revision="261972">The &man.nve.4; driver is now
339 deprecated, and the &man.nfe.4; driver should be used
342 <para revision="262137">Support for the &man.axge.4; driver
343 has been added. This driver supports the ASIX AX88178A
344 and AX88179 USB ethernet adapters. The AX88178A supports
345 USB 2.0, and the AX88179 supports USB 2.0 and 3.0.</para>
347 <para revision="262363">The &man.urndis.4; driver has been
348 imported from OpenBSD.</para>
350 <para revision="264866">Support for multiple
351 transmitter/receiver queues has been added to the
352 &man.vmx.4; driver.</para>
355 <para>The &os; guest operating system must have
356 <acronym>MSIX</acronym> enabled as a prerequisite for
357 multiple queues.</para>
360 <para revision="265345">Support for the ASUS USB-N10 Nano
361 wireless card has been added to the &man.urtwn.4;
364 <para revision="266212">Transmission checksum offloading has
365 been disabled for the RTL8168C and RTL8168CP chipsets in
366 the &man.re.4; driver for TCP and UDP frames. This is
367 due to a report of UDP datagrams with IP options
368 generating corrupt frames.</para>
370 <para revision="266578">Preliminary support has been added
371 to the &man.urtwn.4; driver for the Realtek RTL8188EUS and
372 RTL8188ETV chipsets.</para>
374 <para revision="267694">A bug in the fast receiver buffer
375 recycle path has been fixed in the &man.cxgbe.4;
378 <para revision="267849" contrib="vendor"
379 vendor="&chelsio;">The bundled &man.cxgbe.4; firmware for
380 T4 and T5 cards has been updated to version
385 <sect3 xml:id="net-proto">
386 <title>Network Protocols</title>
388 <para revision="265946">Support for the UDP-Lite protocol
389 (RFC 3828) has been added to the IPv4 and IPv6
392 <para revision="267771">A bug in &man.sctp.4; that would allow
393 two listening sockets bound to the same port has been
397 <sect3 xml:id="disks">
398 <title>Disks and Storage</title>
400 <para revision="259328" contrib="sponsor" sponsor="&ff;">The
401 &man.geom.8; <literal>label</literal> class is now aware of
402 resized partitions. This corrects an issue where
403 <command>geom resize</command> would resize the partition,
404 but the label provider in <filename
405 class="directory">/dev/gptid/</filename> would not be
408 <para revision="260502">The &man.gmirror.8;
409 utility now has a <literal>resize</literal> command, making
410 it easier to resize the size of a mirror when all of its
411 components have been replaced.</para>
413 <para revision="265912">The &man.geom.8;
414 <literal>GEOM_PART</literal> class has been updated to
415 support automatic partition resizing. Changes to the
416 partition size are not saved to disk until
417 <command>gpart commit</command> is run, and prior to saving,
418 can be reverted with <command>gpart undo</command>.</para>
420 <para revision="268091">Support for the
421 <literal>disklabel64</literal> partitioning scheme has been
422 added to &man.gpart.8;.</para>
424 <para revision="266594">The <literal>radeonkms(4)</literal>
425 driver has been updated to include 32-bit &man.ioctl.2;
426 support, allowing 32-bit applications to run on a 64-bit
431 <title>File Systems</title>
433 <para revision="260178" contrib="vendor"
434 vendor="&netflix;">A new flag, <literal>-R</literal>,
435 has been added to the &man.fsck.ffs.8; utility. When used,
436 &man.fsck.ffs.8; will restart itself when too many critical
437 errors have been detected.</para>
439 <para revision="263407">The &man.zfs.8; filesystem has been
440 updated to implement <quote>bookmarks</quote>. See
441 &man.zfs.8; for further details.</para>
443 <para revision="266122">The &man.zfs.8; filesystem has been
444 updated to allow tuning the minimum <quote>ashift</quote>
445 value when creating new top-level virtual devices (vdevs).
446 To set the minimum ashift value, for example when creating
447 a &man.zpool.8; on <quote>Advanced Format</quote> drives,
448 set the <literal>vfs.zfs.min_auto_ashift</literal>
449 &man.sysctl.8; accordingly.</para>
451 <para revision="266612">The <literal>libzfs</literal> thread
452 pool <acronym>API</acronym> has been imported from
453 OpenSolaris, and adapted for &os;. This change allows
454 parallel disk scanning, which can reduce &man.zpool.8;
455 overall import time in some workloads.</para>
459 <sect2 xml:id="userland">
460 <title>Userland Changes</title>
462 <para revision="260177" contrib="sponsor"
463 sponsor="&netflix;">A new flag is added to &man.camcontrol.8;,
464 <literal>-b</literal>, which outputs the existing buses and
465 their parents.</para>
467 <para revision="262075">The &man.newsyslog.8; utility has been
468 updated to rotate files based on the actual file size instead
469 of the blocks on disk. This matches the behavior documented
470 in &man.newsyslog.conf.5;.</para>
472 <para revision="262384">The location of the &man.rctl.8;
473 configuration file can now be overridden in &man.rc.conf.5;.
474 To use a non-default location, set
475 <literal>rctl_rules</literal> in &man.rc.conf.5; to the
476 location of the file.</para>
478 <para revision="262855">The <application>ATF</application> test
479 suite has been updated to version 0.20.</para>
481 <para revision="263019">The <literal>libucl</literal> library
482 (Unified Configuration Library) has been merged from
485 <para revision="263020">The &man.pkg.7; bootstrapping utility
486 has been synced with the version in &os;-CURRENT.</para>
488 <para revision="263403">The &man.zfs.8; userland utility has
489 been updated to include aliases for
490 <command>snapshot</command>, which allows use of <command>zfs
491 list -t snap</command> and <command>zfs
492 snap</command>.</para>
494 <para revision="263405">The &man.zfs.8; userland utility has
495 been updated to include a new flag to <command>zfs
496 list</command>, <literal>-p</literal>, which when specified,
497 prints the output in a parsable format.</para>
499 <para revision="263783">The Blowfish password format
500 implementation updated. Support for $2b$ has
501 been added, allowing use of passwords greater than 256
502 characters long.</para>
504 <para revision="264497">The &man.iconv.3; library has been
505 updated to match NetBSD, providing several bug fixes.</para>
507 <para revision="265265">The &man.date.1; utility has been
508 updated to include a new flag, <literal>-R</literal>, which
509 prints the date and time output as specified in RFC
512 <para revision="265533">The &man.bc.1; utility has been updated
513 to version 1.1, in sync with the version in OpenBSD.</para>
515 <para revision="265604" contrib="vendor"
516 vendor="&netflix;">The &man.pmcstat.8; utility has been
517 updated to include a new flag, <literal>-a</literal>, which
518 when specified, produces a full stack track on the sampled
521 <para revision="265701">The &man.netstat.8; and &man.route.8;
522 utilities have been updated to include a shorthand equivalent
523 to the <literal>-f inet</literal> and <literal>-f
524 inet6</literal> address specifiers, <literal>-4</literal>
525 and <literal>-6</literal>, respectively.</para>
527 <para revision="265879">The &man.crypt.3; library now defaults
528 to SHA512 for password hashing.</para>
530 <para revision="266014">The &man.gvinum.8; utility has been
531 updated to allow forceful configuration reset with the
532 <literal>-f</literal> flag. Additionally, a bug that would
533 prevent <literal>-f</literal> from properly creating
534 a &man.gvinum.8; configuration has been fixed.</para>
536 <para revision="266029">The &man.login.conf.5; file now takes
537 precedence over the shell-specific environment files. In
538 particular, the <literal>PATH</literal>,
539 <literal>BLOCKSIZE</literal> variables are commented from
540 <filename>/usr/share/skel/dot.profile</filename>, and the
541 <literal>path</literal>, <literal>BLOCKSIZE</literal>, and
542 <literal>umask</literal> variables have been commented from
543 <filename>/usr/share/skel/dot.cshrc</filename>.</para>
545 <para revision="266272">The &man.binmiscctl.8; userland utility
546 and related image activator features have been merged from
549 <para revision="266279">The &man.ps.1; utility has been
550 updated to include the <literal>-J</literal> flag, used to
551 filter output by matching &man.jail.8; IDs and names.
552 Additionally, argument <literal>0</literal> can be used to
553 <literal>-J</literal> to only list processes running on the
556 <para revision="266280">The &man.top.1; utility has been updated
557 to filter by &man.jail.8; ID or name, in followup to the
558 &man.ps.1; change in <literal>r265229</literal>.</para>
560 <para revision="266610">The &man.gstat.8; utility has been
561 updated to include a new flag, <literal>-o</literal>. When
562 set, &man.gstat.8; will display statistics for operations
563 such as <literal>BIO_FLUSH</literal>.</para>
565 <para revision="266632">The &man.fetch.3; library has been
566 updated to look for root <acronym>SSL</acronym> certificates
567 in <filename class="directory">/usr/local/etc/ssl/</filename>
569 class="directory">/etc/ssl/</filename>.</para>
571 <para revision="266715">The &man.clang.1;/llvm suite has been
572 updated to version 3.4.1.</para>
574 <para revision="266816">The Blowfish password format
575 has been changed to $2b$ by default.</para>
577 <para revision="266888">The amount of data collected for
578 &man.hwpmc.4; has been updated to work with modern processors
579 and larger amounts of available memory.</para>
581 <para revision="266890">The &man.pmcstat.8; utility has been
582 updated to include a new flag, <literal>-l</literal>, which
583 ends event collection after the specified number of
586 <para revision="266953">The &man.mergemaster.8; utility has
587 been updated to avoid printing
588 <quote><filename>/var/tmp/temproot</filename>
589 disappeared</quote> if there is nothing to compare.</para>
591 <para revision="267056">The &os; installer, &man.bsdinstall.8;,
592 has been updated to include optional
593 &man.geli.8;-encrypted or &man.gmirror.8;-mirrored swap
594 devices when installing onto a full &man.zfs.8; filesystem.
595 Additionally, the parent &man.zfs.8; dataset is now configured
596 with <literal>lz4</literal> compression enabled.</para>
598 <para revision="267113">The default &man.newsyslog.conf.5; now
599 includes files in the
600 <filename>/etc/newsyslog.conf.d/</filename> and
601 <filename>/usr/local/etc/newsyslog.conf.d/</filename>
602 directories by default for &man.newsyslog.8;.</para>
604 <para revision="267161">The &man.realpath.1; utility has been
605 updated to return <literal>ENOTDIR</literal> on paths
606 components <quote>.</quote> and <quote>..</quote> that are
607 not directories, such as <filename
608 class="directory">/dev/null/.</filename> or <filename
609 class="directory">/dev/null/..</filename>.</para>
611 <para revision="267236">A new flag, <quote>onifconsole</quote>
612 has been added to <filename>/etc/ttys</filename>. This allows
613 the system to provide a login prompt via serial console if the
614 device is an active kernel console, otherwise it is equivalent
615 to <literal>off</literal>.</para>
617 <para revision="267341">Support for legacy
618 <acronym>PCI</acronym> devices has been removed from
619 &man.bhyve.8;.</para>
621 <para revision="267450">The &man.bhyve.8; userland utility
622 has been updated to include SMBIOS support. A new flag has
623 been added, <literal>-U</literal>, which allows specifying the
624 UUID of the guest in the System Information structure.</para>
626 <para revision="268161">The &man.mkimg.1; utility has been
627 merged from &os;-CURRENT.</para>
629 <para revision="267734">The &os; Project has migrated
630 from the <application>GNATS</application> bug tracking system
631 to <application>Bugzilla</application>. The &man.send-pr.1;
632 utility used for submitting problem reports has been replaced
633 with a stub shell script that instructs to use the Bugzilla
634 web interface.</para>
636 <para revision="267747">The &man.patch.1; utility has been
637 updated to include a <literal>--dry-run</literal> flag, which
638 is equivalent to <literal>--check</literal> and
639 <literal>-C</literal>.</para>
641 <para revision="267878">A bug in &man.bsdgrep.1; that would
642 prevent patterns from being matched under certain conditions
643 has been fixed.</para>
645 <sect3 xml:id="rc-scripts">
646 <title><filename>/etc/rc.d</filename> Scripts</title>
648 <para revision="264438">The <filename>network.subr</filename>
649 &man.rc.8; script has been updated to loosen the requirement
650 of listing network aliases in numeric order. Previously,
652 <literal>_alias<replaceable>2</replaceable></literal>
653 would not be created if
654 <literal>_alias<replaceable>1</replaceable></literal> was
659 <sect2 xml:id="contrib">
660 <title>Contributed Software</title>
662 <para revision="263285">The &man.xz.1; utility has been updated
663 to a post-5.0.5 snapshot.</para>
665 <para revision="263369" contrib="sponsor"
666 sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has
667 been updated to the r196322 snapshot.</para>
669 <para revision="264377"><application>OpenSSH</application> has
670 been updated to version 6.6p1.</para>
672 <para revision="264911">The &man.nc.1; utility has been updated
673 to match the version in OpenBSD 5.5.</para>
675 <para revision="266692"><application>Sendmail</application>
676 has been updated to 8.14.9.</para>
678 <para revision="267258"><application>OpenSSL</application> has
679 been updated to version 1.0.1h.</para>
681 <para revision="267477">The timezone database has been updated
682 to version tzdata2014e.</para>
685 <sect2 xml:id="ports">
686 <title>Ports/Packages Collection Infrastructure</title>
692 <sect2 xml:id="releng">
693 <title>Release Engineering and Integration</title>
695 <para revision="263028">The &man.services.mkdb.8; utility has
696 been updated to include endianness awareness, allowing the
697 <filename>services.db</filename> database to be created as
698 part of the release build, regardless of native- or
699 cross-built releases.</para>
703 <title>Documentation</title>
710 <sect1 xml:id="upgrade">
711 <title>Upgrading from Previous Releases of &os;</title>
713 <para arch="amd64,i386">Binary upgrades between RELEASE versions
714 (and snapshots of the various security branches) are supported
715 using the &man.freebsd-update.8; utility. The binary upgrade
716 procedure will update unmodified userland utilities, as well as
717 unmodified GENERIC or SMP kernels distributed as a part of an
718 official &os; release. The &man.freebsd-update.8; utility
719 requires that the host being upgraded have Internet
722 <para>Source-based upgrades (those based on recompiling the &os;
723 base system from source code) from previous versions are
724 supported, according to the instructions in
725 <filename>/usr/src/UPDATING</filename>.</para>
728 <para>Upgrading &os; should only be attempted after
729 backing up <emphasis>all</emphasis> data and configuration