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="260431">A new &man.sysctl.8;,
134 <literal>kern.panic_reboot_wait_time</literal>, has been
135 added, which allows controlling how long the system will wait
136 after &man.panic.9; before rebooting.</para>
138 <para revision="262861">The &man.vt.4; driver has been merged
139 from &os;-CURRENT. To enable &man.vt.4;, enter
140 <literal>set kern.vty=vt</literal> at the &man.loader.8;
141 prompt during boot, or add <literal>kern.vty=vt</literal> to
142 &man.loader.conf.5; and reboot the system.</para>
144 <para revision="263122">Support for &man.hwpmc.4; has been added
145 for &powerpc; 970 class processors.</para>
147 <para revision="263197">Support for ADT7460 and ADT7467 fan
148 controllers found in newer PowerBooks™ and
149 iBooks™ has been added to the &man.iicbus.4;
152 <para revision="263256">A panic triggered by removing
153 a &man.urtwn.4; device has been fixed.</para>
155 <para revision="263799">A potential deadlock in the &man.usb.4;
156 stack triggered by detaching USB devices that create character
157 devices has been fixed.</para>
159 <para revision="263869">Support for &amd; Family 16h sensor
160 devices has been added to &man.amdtemp.4;.</para>
162 <para revision="265610">The &man.uslcom.4; driver has been
163 updated to support 26 new devices.</para>
165 <para revision="266165">A kernel bug that inhibited proper
166 functionality of the <literal>dev.cpu.0.freq</literal>
167 &man.sysctl.8; on &intel; processors with Turbo
168 Boost™ enabled has been fixed.</para>
170 <para revision="266436">The &man.uart.4; driver has been
171 updated to include support for the &intel; Lynx Point
172 KT <acronym>AMT</acronym> serial port.</para>
174 <para revision="266594">The <literal>radeonkms(4)</literal>
175 driver has been updated to include 32-bit &man.ioctl.2;
176 support, allowing 32-bit applications to run on a 64-bit
179 <para revision="266718">A bug that would prevent
180 a &man.jail.8; from setting the correct IPv4 source address
181 with some operations that required
182 <literal>security.jail.allow_raw_sockets</literal> has been
185 <para revision="266911">The &man.hwpmc.4; driver has been
186 updated to support core events from the Atom™
187 Silvermont architecture.</para>
189 <para revision="268046">The &man.oce.4; driver has been updated
190 with vendor-supplied fixes for big endian support, and 20GB/s
191 and 25GB/s link speeds.</para>
193 <para revision="270630">The &os; virtual memory subsystem
194 has been updated to implement <quote>fast path</quote> for
195 the page fault handler.</para>
197 <para revision="271069">The &man.asmc.4; driver has been updated
198 to support the &apple; Mac Mini 3,1.</para>
200 <para revision="271111">The &os;/&arch.powerpc64; default kernel
201 configuration, <filename>GENERIC64</filename>, has been
202 updated to enable the &man.vt.4; console driver for the
203 Sony® Playstation 3™ platform.</para>
205 <para revision="271116" contrib="sponsor" sponsor="&ff;">The
206 &os;/&arch.powerpc; <literal>ofwfb</literal> driver, used to
207 provide a graphics console when the &man.vt.4; console driver
208 is used, has been modified to work with the <filename
209 role="package">x11-drivers/xf86-video-scfb</filename>
213 <para>If using an <acronym>ATI</acronym> graphics card with
214 the &man.vt.4; driver, the <filename
215 role="package">x11-servers/xorg-server</filename> package
216 must be updated to version 1.12.4_8 or newer.</para>
219 <para revision="271128" contrib="sponsor" sponsor="&ff;">Several
220 performance enchancements to the &man.vt.4; driver have been
221 merged from &os;-CURRENT.</para>
223 <para revision="271153">The default stack size
224 (<literal>KSTACK_PAGES</literal>) has been increased from
225 <literal>4</literal> to <literal>8</literal> for the
226 &arch.powerpc64; architecture.</para>
228 <para revision="271205">The &os;/&arch.powerpc; ATI driver
229 has been updated to support enabling and disabling the
230 Radeon 9700 backlight, found in the
231 &apple; PowerBook™ G4.</para>
233 <sect3 xml:id="kernel-virtualization">
234 <title>Virtualization Support</title>
236 <para revision="259450">Support for µsoft; Hyper-V
237 has been added to &os;/i386 as loadable modules, however
238 not available in the <filename>GENERIC</filename> kernel
239 configuration.</para>
241 <para revision="261090">The &man.bhyve.4; hypervisor now
242 supports soft power-off functionality via the ACPI S5
245 <para revision="267399">Support for &os;/i386 guests has been
246 added to &man.bhyve.4;.</para>
248 <para revision="267427">Support for virtualized
249 <literal>XSAVE</literal> has been added to &man.bhyve.4;,
250 allowing guest operating systems to use
251 <literal>XSAVE</literal> and
252 <literal>XSAVE</literal>-enabled features, such as
253 <acronym>AVX</acronym>.</para>
255 <para revision="268932">The &man.bhyve.4; hypervisor now
256 supports booting from a &man.zfs.8; filesystem.</para>
258 <para revision="268933">A new driver, &man.virtio_random.4;,
259 has been added, which allows &os; virtual machines to
260 harvest entropy from the hypervisor.</para>
262 <para revision="270159">The &man.bhyve.4; hypervisor has been
263 synced with the version in &os;-CURRENT.</para>
265 <para>A number of enhancements have been added, and several
266 bug fixes, including:</para>
270 <para>Post-mortem debugging has been added when
271 a guest virtual machine exits with an
272 <quote><acronym>EPT</acronym> Misconfiguration</quote>
277 <para>The hypervisor &man.virtio.4; <acronym>API</acronym>
278 has been expanded from 32- to 64-bit.</para>
282 <para>Support for identifying capabilities of the virtual
283 <acronym>CPU</acronym> has been added.</para>
287 <para>Support for emulating legacy x86 task
288 switching has been added.</para>
292 <para>Support to list the VT-x features in base kernel
293 &man.dmesg.8; has been added.</para>
297 <para>Support for extended PCI configuration space
298 has been added.</para>
303 <sect3 xml:id="kernel-arm">
304 <title>ARM Support</title>
306 <para revision="259355">The <filename>WANDBOARD</filename>
307 kernel configuration file has been added.</para>
309 <para revision="265067">Boot devices may now be specified by
310 setting a u-boot environment variable. If a boot device is
311 not specified, the probe mechanism will be used. To specify
312 the boot device, set the
313 <literal>loaderdev=<replaceable>device</replaceable></literal>
314 u-boot environment variable.</para>
316 <para revision="266000">The <literal>nexus(4)</literal> driver
317 has been updated to include <quote>Flattened Device
318 Tree</quote> support, replacing the &man.fdtbus.4; driver
319 in most cases.</para>
321 <para revision="266105">The &man.gpioiic.4; and
322 &man.gpioled.4; have been merged from &os;-CURRENT.</para>
324 <para>Support for hardware floating point was added to the
325 kernel, and enabled by default in the configuration files
326 for all platforms that contain the required hardware.</para>
328 <para><application>C++</application> exception handling now
329 works with <application>GCC</application>.</para>
331 <para>Support for <acronym>SMP</acronym> was added to the
332 kernel, and enabled by default in the configuration files
333 for all platforms that contain multi-core CPUs.</para>
335 <para>Support was added for:</para>
339 <para>CHROMEBOOK (Samsung Exynos 5250)</para>
343 <para>COLIBRI (Freescale Vybrid)</para>
347 <para>COSMIC (Freescale Vybrid)</para>
351 <para>IMX53-QSB (Freescale i.MX53)</para>
355 <para>QUARTZ (Freescale Vybrid)</para>
359 <para>RADXA (Rockchip rk30xx)</para>
363 <para>WANDBOARD (Freescale i.MX6)</para>
367 <para>An <acronym>I2C</acronym> driver was added for
368 the RaspberryPi.</para>
370 <para>Drivers have been added to support <acronym>TI</acronym>
371 platforms, such as BEAGLEBONE and PANDABOARD:</para>
375 <para>PRUSS (Programmable Realtime Unit Subsystem)</para>
379 <para>MBOX (Mailbox hardware)</para>
383 <para>SDHCI (new faster driver for
384 <acronym>MMC</acronym>/<acronym>SD</acronym>
389 <para>PPS (Pulse Per Second input on a
390 <acronym>GPIO</acronym>/timer pin)</para>
394 <para>PWM (Pulse Width Modulation output)</para>
398 <para>ADC (Analog to Digital converter)</para>
403 <sect3 xml:id="boot">
404 <title>Boot Loader Changes</title>
406 <para revision="262701">A kernel selection menu has been added
407 to &man.loader.8;. If the <quote>beastie menu</quote> is
408 enabled, the kernel to boot may be selected from the kernel
409 selection menu. Additional kernels may be listed in
410 &man.loader.conf.5; as a comma- or space-separated list. By
411 default, <literal>kernel</literal> and
412 <literal>kernel.old</literal> are listed.</para>
414 <para revision="271130" contrib="sponsor" sponsor="&ff;">The
415 <filename class="directory">sys/boot/</filename> sources
416 have been rearranged, moving &man.libstand.3; to a directory
417 indicating the library is built as 32-bit.</para>
419 <para revision="271135" contrib="sponsor" sponsor="&ff;">The
420 &man.libstand.3; library has been updated to produce
421 a 64-bit shared library for the &os;/&arch.amd64; and
422 &os;/&arch.powerpc64; architectures.</para>
424 <para revision="271135" contrib="sponsor"
425 sponsor="&ff;">Initial support for <acronym>UEFI</acronym>
426 boot has been added.</para>
428 <para revision="271136" contrib="sponsor" sponsor="&ff;">Three
429 new files are installed to <filename
430 class="directory">/boot</filename>, supporting
431 <acronym>UEFI</acronym> boot:</para>
435 <para><filename>boot1.efi</filename>: The
436 <acronym>UEFI</acronym> first stage bootstrap
441 <para><filename>boot1.efifat</filename>:
442 A <acronym>FAT</acronym> filesystem image containing
443 an <acronym>EFI</acronym> system partition.</para>
447 <para><filename>loader.efi</filename>: The third stage
448 bootstrap file.</para>
453 <sect3 xml:id="proc">
454 <title>Hardware Support</title>
459 <title>Multimedia Support</title>
465 <sect4 xml:id="net-if">
466 <title>Network Interface Support</title>
468 <para revision="259453">Support for Ralink RT5370 and
469 RT5372 chipsets has been added to the &man.run.4;
472 <para revision="260120">Firmware for the &man.run.4; driver
473 has been updated to version 0.33.</para>
475 <para revision="261868">Support for the Ralink RT3593
476 chipset has been added to the &man.run.4; driver.</para>
478 <para revision="261972">The &man.nve.4; driver is now
479 deprecated, and the &man.nfe.4; driver should be used
482 <para revision="262137">Support for the &man.axge.4; driver
483 has been added. This driver supports the ASIX AX88178A
484 and AX88179 USB ethernet adapters. The AX88178A supports
485 USB 2.0, and the AX88179 supports USB 2.0 and 3.0.</para>
487 <para revision="262363">The &man.urndis.4; driver has been
488 imported from OpenBSD.</para>
490 <para revision="264866">Support for multiple
491 transmitter/receiver queues has been added to the
492 &man.vmx.4; driver.</para>
495 <para>The &os; guest operating system must have
496 <acronym>MSIX</acronym> enabled as a prerequisite for
497 multiple queues.</para>
500 <para revision="265345">Support for the ASUS USB-N10 Nano
501 wireless card has been added to the &man.urtwn.4;
504 <para revision="266212">Transmission checksum offloading has
505 been disabled for the RTL8168C and RTL8168CP chipsets in
506 the &man.re.4; driver for TCP and UDP frames. This is
507 due to a report of UDP datagrams with IP options
508 generating corrupt frames.</para>
510 <para revision="266578">Preliminary support has been added
511 to the &man.urtwn.4; driver for the Realtek RTL8188EUS and
512 RTL8188ETV chipsets.</para>
514 <para revision="267694">A bug in the fast receiver buffer
515 recycle path has been fixed in the &man.cxgbe.4;
518 <para revision="267849" contrib="vendor"
519 vendor="&chelsio;">The bundled &man.cxgbe.4; firmware for
520 T4 and T5 cards has been updated to version
523 <para revision="269196">The &man.em.4; driver has been
524 updated to version 7.4.2.</para>
526 <para revision="269975">The &man.ixgbe.4; tunables have been
527 renamed to match their &man.sysctl.8; counterparts:</para>
529 <informaltable frame="none" pgwide="0">
531 <colspec colwidth="1*"/>
532 <colspec colwidth="1*"/>
535 <entry>Old Name</entry>
536 <entry>New Name</entry>
542 <entry><literal>hw.ixgbe.enable_aim</literal></entry>
543 <entry><literal>hw.ix.enable_aim</literal></entry>
547 <entry><literal>hw.ixgbe.max_interrupt_rate</literal></entry>
548 <entry><literal>hw.ix.max_interrupt_rate</literal></entry>
552 <entry><literal>hw.ixgbe.rx_process_limit</literal></entry>
553 <entry><literal>hw.ix.rx_process_limit</literal></entry>
557 <entry><literal>hw.ixgbe.tx_process_limit</literal></entry>
558 <entry><literal>hw.ix.tx_process_limit</literal></entry>
562 <entry><literal>hw.ixgbe.enable_msix</literal></entry>
563 <entry><literal>hw.ix.enable_msix</literal></entry>
567 <entry><literal>hw.ixgbe.num_queues</literal></entry>
568 <entry><literal>hw.ix.num_queues</literal></entry>
572 <entry><literal>hw.ixgbe.txd</literal></entry>
573 <entry><literal>hw.ix.txd</literal></entry>
577 <entry><literal>hw.ixgbe.rxd</literal></entry>
578 <entry><literal>hw.ix.rxd</literal></entry>
582 <entry><literal>hw.ixgbe.unsupported_sfp</literal></entry>
583 <entry><literal>hw.ix.unsupported_sfp</literal></entry>
589 <para>Be sure to update &man.loader.conf.5; if using the
590 old tunables before upgrading to
591 &os; &release.current;.</para>
593 <para revision="270061">The &man.if.nf10bmac.4; driver has
594 been merged from &os;-CURRENT to support the NetFPGA-10G
595 Embedded CPU Ethernet Core.</para>
597 <para revision="270297">The &man.cxgbe.4; driver has been
598 updated to support &man.netmap.4; for the T5 10G/40G
601 <para revision="270509">The &man.vtnet.4; driver has been
602 updated to support &man.netmap.4;.</para>
604 <para revision="270514">The &man.urtwn.4; driver has been
605 updated to support the ASUS USB-AC51 wireless card.</para>
607 <para revision="270631">The &intel; XL710 ethernet
608 controller driver, <literal>ixlv(4)</literal>, has been
609 merged from &os;-CURRENT.</para>
613 <sect3 xml:id="net-proto">
614 <title>Network Protocols</title>
616 <para revision="265946">Support for the UDP-Lite protocol
617 (RFC 3828) has been added to the IPv4 and IPv6
620 <para revision="267771">A bug in &man.sctp.4; that would allow
621 two listening sockets bound to the same port has been
624 <para contrib="sponsor" sponsor="&ix;">Kernel RPC code, which
625 is a base of NFS server took multiple optimizations, that
626 significantly improved its performance and
627 <acronym>SMP</acronym> scapability.</para>
629 <para revision="269065" contrib="sponsor" sponsor="&ff;">The
630 <acronym>iSCSI</acronym> initiator has been updated to
631 support redirection handling when an
632 <acronym>iSCSI</acronym> device is configured with multiple
633 <acronym>IP</acronym> addresses across different network
634 interfaces. Previously, clients connecting to
635 such <acronym>iSCSI</acronym> devices could require
636 additional client-side configuration.</para>
638 <para revision="265523" contrib="sponsor" sponsor="&ff;">A new
640 <literal>kern.iscsi.fail_on_disconnection</literal>, has
641 been added, which allows <acronym>iSCSI</acronym> clients to
642 remove the attached disk device when the connection to the
643 target is dropped, where previously I/O would stop until the
644 connection is restored.</para>
646 <para revision="265524" contrib="sponsor" sponsor="&ff;">The
647 <acronym>iSCSI</acronym> transmit code has been optimized
648 to coalesce <acronym>PDUs</acronym> and avoid lock
651 <para revision="265524" contrib="sponsor"
652 sponsor="&ix;">Several performance optimizations have been
653 made to the <acronym>iSCSI</acronym> subsystem, including
654 deferring wakeup until enough data has been received to
655 read or write a file, reducing <acronym>CPU</acronym> usage
656 and throughput performance with large I/O workloads.</para>
658 <para revision="263720" contrib="sponsor"
659 sponsor="&ff;">Support for hostname- and IP-based access
660 restriction has been added to the <acronym>iSCSI</acronym>
661 &man.ctld.8; daemon.</para>
664 <sect3 xml:id="disks">
665 <title>Disks and Storage</title>
667 <para revision="260385" contrib="sponsor" sponsor="&ix;">The
668 &man.geom.4; subsystem has been updated to support I/O
669 direct dispatch. When safety requirements are met, it
670 enables avoiding passing I/O requests to GEOM
671 <literal>g_up</literal>/<literal>g_down</literal> thread,
672 executing them directly in the caller context, avoiding
674 <literal>g_up</literal>/<literal>g_down</literal> threads,
675 plus avoid several context switches per I/O.</para>
677 <para revision="260385" contrib="sponsor" sponsor="&ix;">The
678 &man.geom.4; RAID driver has been
679 updated to support unmapped I/O.</para>
681 <para revision="260387" contrib="sponsor" sponsor="&ix;">The
682 &man.cam.4; subsystem has been updated to support
683 finer-grained locking, direct dispatch and multi-queue,
684 which combined with &man.geom.4; direct dispatch, reduces
685 lock congestion and improves <acronym>SMP</acronym>
686 scalability of the SCSI/ATA stack.</para>
688 <para revision="260478">The &man.geom.8;
689 <literal>GEOM_MULTIPATH</literal> class has been updated to
690 support automatic live partition resizing.</para>
692 <para revision="260857">The &man.virtio_blk.4; driver has been
693 updated to support unmapped I/O.</para>
695 <para revision="260858">The &man.virtio_scsi.4; driver has
696 been updated to support unmapped I/O.</para>
698 <para revision="264522">Support for LUN-based CD changers has
699 been removed from the &man.cd.4; driver.</para>
701 <para revision="264732">Support for
702 <literal>BIO_DELETE</literal> has been added to &man.zfs.8;
703 <literal>zvol</literal> volumes.</para>
705 <para revision="264734">Support for 9th generation HP host bus
706 adapter cards has been added to &man.ciss.4;.</para>
708 <para revision="265388" contrib="sponsor" sponsor="&lsi;">The
709 &man.mpr.4; device has been added,
710 providing support for LSI Fusion-MPT 3 12Gb SCSI/SATA
713 <para revision="265678">A new <literal>zvol</literal> property
714 <literal>volmode</literal> and &man.sysctl.8;
715 <literal>vfs.zfs.vol.mode</literal> has been added to allow
716 switching <literal>zvol</literal> between three different
717 ways of exposing it to a user: <literal>geom</literal>,
718 <literal>dev</literal> and <literal>none</literal>.</para>
720 <para revision="265922" contrib="sponsor" sponsor="&lsi;">The
721 &man.mrsas.4; driver has been added, providing support for
722 LSI MegaRAID SAS controllers. The &man.mfi.4; driver will
723 attach to the controller, by default. To enable
724 &man.mrsas.4; add <literal>hw.mfi.mrsas_enable=1</literal>
725 to <filename>/boot/loader.conf</filename>, which turns off
726 &man.mfi.4; device probing.</para>
729 <para>At this time, the &man.mfiutil.8; utility and the &os;
730 version of <application>MegaCLI</application> and
731 <application>StorCli</application> do not work with
732 &man.mrsas.4;.</para>
735 <para revision="266608">Fixed accounting of
736 <literal>BIO_FLUSH</literal> operation in &man.geom.8;
737 <literal>GEOM_DISK</literal> class</para>
739 <para revision="266610">The &man.gstat.8; utility now has an
740 <literal>-o</literal> option, to display
741 <quote>other</quote> operations, such as
742 <literal>BIO_FLUSH</literal>.</para>
744 <para revision="267084">The &man.mfi.4; driver has been
745 updated to include support for unmapped I/O.</para>
747 <para revision="267457">The &man.hpt27xx.4; driver has been
748 updated with various vendor-supplied bug fixes.</para>
750 <para revision="270130" contrib="sponsor"
751 sponsor="&citrix.rd;">Support for unmapped I/O has been
752 added to the &man.xen.4; <literal>blkfront</literal>
755 <para revision="259328" contrib="sponsor" sponsor="&ff;">The
756 &man.geom.8; <literal>label</literal> class is now aware of
757 resized partitions. This corrects an issue where
758 <command>geom resize</command> would resize the partition,
759 but the label provider in <filename
760 class="directory">/dev/gptid/</filename> would not be
763 <para revision="260502">The &man.gmirror.8;
764 utility now has a <literal>resize</literal> command, making
765 it easier to resize the size of a mirror when all of its
766 components have been replaced.</para>
768 <para revision="262967">Support for MegaRAID Fury cards has
769 been added to the &man.mfi.4; driver.</para>
771 <para revision="263024">The &man.aacraid.4; driver has been
772 updated to version 3.2.5.</para>
774 <para revision="265536">The <literal>GEOM_VINUM</literal>
775 option is now able to be built both directly into the kernel
776 or as a &man.kldload.8; loadable module.</para>
778 <para revision="265912">The &man.geom.8;
779 <literal>GEOM_PART</literal> class has been updated to
780 support automatic partition resizing. Changes to the
781 partition size are not saved to disk until
782 <command>gpart commit</command> is run, and prior to saving,
783 can be reverted with <command>gpart undo</command>.</para>
785 <para revision="266220">The &man.geom.uncompress.4; module is
786 built by default which, similar to &man.geom.uzip.4;,
787 provides support for compressed, read-only disk
790 <para revision="268091">Support for the
791 <literal>disklabel64</literal> partitioning scheme has been
792 added to &man.gpart.8;.</para>
794 <para revision="270552">A new &man.sysctl.8; and
795 &man.loader.8; tunable,
796 <literal>kern.geom.part.mbr.enforce_chs</literal> has been
797 added to the &man.geom.8; <literal>MBR</literal> partition
798 class. When set to a non-zero value,
799 <literal>GEOM_PART_MBR</literal> will automatically
800 recalculate the user-specified offset and size for alignment
801 with the disk geometry.</para>
803 <para contrib="sponsor" sponsor="&ix;">Many improvements to
804 the CAM Target Layer (CTL):</para>
807 <para>Support for <literal>UNMAP</literal>, <literal>WRITE
808 SAME</literal>, <literal>COMPARE AND WRITE</literal>,
809 <literal>XCOPY</literal> and some other SCSI commands
810 was added to support VMWare VAAI and Microsoft ODX
811 storage acceleration.</para>
814 <para revision="265642">The
815 <literal>READ</literal>/<literal>WRITE</literal> size
816 limitations were removed by supporting multiple
817 data moves per command.</para>
820 <para revision="268556">Finer-grained per-LUN locking and
821 multiple worker threads for better
822 <acronym>SMP</acronym> scapability.</para>
825 <para revision="269297">Memory consumption reduced by
826 several times by disabling some never used
827 functionality.</para>
830 <para revision="269298">The maximum number of
831 <acronym>SCSI</acronym> ports increased from 32 to
835 <para revision="269429">Improved <literal>zvol</literal>
836 integration for better performance.</para>
840 <para revision="270810" contrib="vendor"
841 vendor="&highpoint;">The &man.hptnr.4; driver has been
842 updated to version 1.0.1.</para>
844 <para revision="271234">The &man.mrsas.4; driver has been
845 added to the <filename>GENERIC</filename> kernel
846 configuration on &arch.amd64; and &arch.i386;
847 architectures.</para>
851 <title>File Systems</title>
853 <para revision="260338">The
854 <literal>vfs.zfs.zio.use_uma</literal> &man.sysctl.8; has
855 been re-enabled. On multi-CPU machines with enough RAM,
856 this can easily double &man.zfs.8; performance or reduce CPU
857 usage in half. It was originally disabled due to memory and
858 <acronym>KVA</acronym> exhaustion problem reports, which
859 should be resolved due to several change in the VM
862 <para revision="260178" contrib="vendor"
863 vendor="&netflix;">A new flag, <literal>-R</literal>,
864 has been added to the &man.fsck.ffs.8; utility. When used,
865 &man.fsck.ffs.8; will restart itself when too many critical
866 errors have been detected.</para>
868 <para revision="263407">The &man.zfs.8; filesystem has been
869 updated to implement <quote>bookmarks</quote>. See
870 &man.zfs.8; for further details.</para>
872 <para revision="266122">The &man.zfs.8; filesystem has been
873 updated to allow tuning the minimum <quote>ashift</quote>
874 value when creating new top-level virtual devices (vdevs).
875 To set the minimum ashift value, for example when creating
876 a &man.zpool.8; on <quote>Advanced Format</quote> drives,
877 set the <literal>vfs.zfs.min_auto_ashift</literal>
878 &man.sysctl.8; accordingly.</para>
880 <para revision="266612">The <literal>libzfs</literal> thread
881 pool <acronym>API</acronym> has been imported from
882 OpenSolaris, and adapted for &os;. This change allows
883 parallel disk scanning, which can reduce &man.zpool.8;
884 overall import time in some workloads.</para>
886 <para revision="269651">The &man.restore.8; utility has been
887 updated to prevent assertion failures when restoring
888 a <acronym>UFS</acronym> filesystem dump to
889 a <acronym>ZFS</acronym> filesystem by writing restored
890 files in block sizes that are a multiple of 1024.</para>
892 <para revision="269774">Two &man.sysctl.8;s have been added
893 to the &man.zfs.8; filesystem:</para>
898 <literal>vfs.zfs.mg_fragmentation_threshold</literal>: The
899 percentage of the metaslab group size that should be
900 considered eligible for allocation, unless all metaslab
901 groups within the metaslab class have also crossed this
907 <literal>vfs.zfs.metaslab.fragmentation_threshold</literal>: The
908 maximum percentage of metaslab fragmentation level to
909 keep their active state</para>
913 <para revision="269846">The default &man.zfs.8;
914 <acronym>ARC</acronym> hash table size has been increased,
915 and a new &man.loader.8; tunable,
916 <literal>vfs.zfs.arc_average_blocksize</literal>, has been
917 added. Previously, the hash table could be too small, which
918 would lead to long hash chains and limit performance for
920 <literal>vfs.zfs.arc_average_blocksize</literal> tunable
921 allows overriding the default block size. The previous
922 default was 65536, and default of the new &man.loader.8;
923 tunable is 8192.</para>
925 <para revision="270157">The Fast File System
926 (<acronym>FFS</acronym>) has been updated to support
927 multi-threaded soft updates. Previously, soft updates were
928 handled by a single thread, and as of this change, now have
929 one thread per <acronym>FFS</acronym> mountpoint.</para>
931 <para revision="270892" contrib="sponsor" sponsor="&ff;">The
932 new filesystem automount facility, &man.autofs.5;, has been
933 merged from &os;-CURRENT. The new &man.autofs.5; facility
934 is similar to that found in other &unix;-like operating
935 systems, such as OS X™ and Solaris™. The
936 &man.autofs.5; facility uses a &sun;-compatible
937 &man.auto.master.5; configuration file, and is administered
938 with the &man.automount.8; userland utility, and the
939 &man.automountd.8; and &man.autounmountd.8; daemons.</para>
943 <sect2 xml:id="userland">
944 <title>Userland Changes</title>
946 <para revision="260177" contrib="sponsor"
947 sponsor="&netflix;">A new flag is added to &man.camcontrol.8;,
948 <literal>-b</literal>, which outputs the existing buses and
949 their parents.</para>
951 <para revision="262075">The &man.newsyslog.8; utility has been
952 updated to rotate files based on the actual file size instead
953 of the blocks on disk. This matches the behavior documented
954 in &man.newsyslog.conf.5;.</para>
956 <para revision="262384">The location of the &man.rctl.8;
957 configuration file can now be overridden in &man.rc.conf.5;.
958 To use a non-default location, set
959 <literal>rctl_rules</literal> in &man.rc.conf.5; to the
960 location of the file.</para>
962 <para revision="262855">The <application>ATF</application> test
963 suite has been updated to version 0.20. The test suite is
964 disabled by default in &os; 10.1, and can be enabled by
965 adding <literal>WITH_TESTS=yes</literal> to
966 &man.src.conf.5;.</para>
968 <para revision="263019">The <literal>libucl</literal> library
969 (Unified Configuration Library) has been merged from
972 <para revision="263020">The &man.pkg.7; bootstrapping utility
973 has been synced with the version in &os;-CURRENT.</para>
975 <para revision="263403">The &man.zfs.8; userland utility has
976 been updated to include aliases for
977 <command>snapshot</command>, which allows use of <command>zfs
978 list -t snap</command> and <command>zfs
979 snap</command>.</para>
981 <para revision="263405">The &man.zfs.8; userland utility has
982 been updated to include a new flag to <command>zfs
983 list</command>, <literal>-p</literal>, which when specified,
984 prints the output in a parsable format.</para>
986 <para revision="263783">The Blowfish password format
987 implementation updated. Support for $2b$ has
988 been added, allowing use of passwords greater than 256
989 characters long.</para>
991 <para revision="264497">The &man.iconv.3; library has been
992 updated to match NetBSD, providing several bug fixes.</para>
994 <para revision="265265">The &man.date.1; utility has been
995 updated to include a new flag, <literal>-R</literal>, which
996 prints the date and time output as specified in RFC
999 <para revision="265533">The &man.bc.1; utility has been updated
1000 to version 1.1, in sync with the version in OpenBSD.</para>
1002 <para revision="265604" contrib="vendor"
1003 vendor="&netflix;">The &man.pmcstat.8; utility has been
1004 updated to include a new flag, <literal>-a</literal>, which
1005 when specified, produces a full stack track on the sampled
1008 <para revision="265701">The &man.netstat.8; and &man.route.8;
1009 utilities have been updated to include a shorthand equivalent
1010 to the <literal>-f inet</literal> and <literal>-f
1011 inet6</literal> address specifiers, <literal>-4</literal>
1012 and <literal>-6</literal>, respectively.</para>
1014 <para revision="265879">The &man.crypt.3; library now defaults
1015 to SHA512 for password hashing.</para>
1017 <para revision="266014">The &man.gvinum.8; utility has been
1018 updated to allow forceful configuration reset with the
1019 <literal>-f</literal> flag. Additionally, a bug that would
1020 prevent <literal>-f</literal> from properly creating
1021 a &man.gvinum.8; configuration has been fixed.</para>
1023 <para revision="266029">The &man.login.conf.5; file now takes
1024 precedence over the shell-specific environment files. In
1025 particular, the <literal>PATH</literal>,
1026 <literal>BLOCKSIZE</literal> variables are commented from
1027 <filename>/usr/share/skel/dot.profile</filename>, and the
1028 <literal>path</literal>, <literal>BLOCKSIZE</literal>, and
1029 <literal>umask</literal> variables have been commented from
1030 <filename>/usr/share/skel/dot.cshrc</filename>.</para>
1032 <para revision="266272">The &man.binmiscctl.8; userland utility
1033 and related image activator features have been merged from
1034 &os;-CURRENT.</para>
1036 <para revision="266279">The &man.ps.1; utility has been
1037 updated to include the <literal>-J</literal> flag, used to
1038 filter output by matching &man.jail.8; IDs and names.
1039 Additionally, argument <literal>0</literal> can be used to
1040 <literal>-J</literal> to only list processes running on the
1043 <para revision="266280">The &man.top.1; utility has been updated
1044 to filter by &man.jail.8; ID or name, in followup to the
1045 &man.ps.1; change in <literal>r265229</literal>.</para>
1047 <para revision="266610">The &man.gstat.8; utility has been
1048 updated to include a new flag, <literal>-o</literal>. When
1049 set, &man.gstat.8; will display statistics for operations
1050 such as <literal>BIO_FLUSH</literal>.</para>
1052 <para revision="266632">The &man.fetch.3; library has been
1053 updated to look for root <acronym>SSL</acronym> certificates
1054 in <filename class="directory">/usr/local/etc/ssl/</filename>
1056 class="directory">/etc/ssl/</filename>.</para>
1058 <para revision="266715">The &man.clang.1;/llvm suite has been
1059 updated to version 3.4.1.</para>
1061 <para revision="266816">The Blowfish password format
1062 has been changed to $2b$ by default.</para>
1064 <para revision="266888">The amount of data collected for
1065 &man.hwpmc.4; has been updated to work with modern processors
1066 and larger amounts of available memory.</para>
1068 <para revision="266890">The &man.pmcstat.8; utility has been
1069 updated to include a new flag, <literal>-l</literal>, which
1070 ends event collection after the specified number of
1073 <para revision="266953">The &man.mergemaster.8; utility has
1074 been updated to avoid printing
1075 <quote><filename>/var/tmp/temproot</filename>
1076 disappeared</quote> if there is nothing to compare.</para>
1078 <para revision="267056">The &os; installer, &man.bsdinstall.8;,
1079 has been updated to include optional
1080 &man.geli.8;-encrypted or &man.gmirror.8;-mirrored swap
1081 devices when installing onto a full &man.zfs.8; filesystem.
1082 Additionally, the parent &man.zfs.8; dataset is now configured
1083 with <literal>lz4</literal> compression enabled.</para>
1085 <para revision="267113">The default &man.newsyslog.conf.5; now
1086 includes files in the
1087 <filename>/etc/newsyslog.conf.d/</filename> and
1088 <filename>/usr/local/etc/newsyslog.conf.d/</filename>
1089 directories by default for &man.newsyslog.8;.</para>
1091 <para revision="267161">The &man.realpath.1; utility has been
1092 updated to return <literal>ENOTDIR</literal> on paths
1093 components <quote>.</quote> and <quote>..</quote> that are
1094 not directories, such as <filename
1095 class="directory">/dev/null/.</filename> or <filename
1096 class="directory">/dev/null/..</filename>.</para>
1098 <para revision="267236">A new flag, <quote>onifconsole</quote>
1099 has been added to <filename>/etc/ttys</filename>. This allows
1100 the system to provide a login prompt via serial console if the
1101 device is an active kernel console, otherwise it is equivalent
1102 to <literal>off</literal>.</para>
1104 <para revision="267341">Support for legacy
1105 <acronym>PCI</acronym> devices has been removed from
1106 &man.bhyve.8;.</para>
1108 <para revision="267450">The &man.bhyve.8; userland utility
1109 has been updated to include SMBIOS support. A new flag has
1110 been added, <literal>-U</literal>, which allows specifying the
1111 UUID of the guest in the System Information structure.</para>
1113 <para revision="267734">The &os; Project has migrated
1114 from the <application>GNATS</application> bug tracking system
1115 to <application>Bugzilla</application>. The &man.send-pr.1;
1116 utility used for submitting problem reports has been replaced
1117 with a stub shell script that instructs to use the Bugzilla
1118 web interface.</para>
1120 <para revision="267747">The &man.patch.1; utility has been
1121 updated to include a <literal>--dry-run</literal> flag, which
1122 is equivalent to <literal>--check</literal> and
1123 <literal>-C</literal>.</para>
1125 <para revision="267878">A bug in &man.bsdgrep.1; that would
1126 prevent patterns from being matched under certain conditions
1127 has been fixed.</para>
1129 <para revision="267979">The &man.procstat.1; utility has been
1130 updated to include two new flags, <literal>-r</literal> and
1131 <literal>-H</literal>. When <literal>-r</literal> is
1132 specified, &man.procstat.1; will print current resource usage
1133 about the process(es). When <literal>-H</literal> is
1134 specified, &man.procstat.1; will print information about
1135 threads rather than the process(es).</para>
1138 <para>The <literal>-H</literal> flag is currently only used
1139 with <literal>-r</literal> to display resource usage for
1140 individual threads, rather than the entire process.</para>
1143 <para revision="268019">The &man.sed.1; utility has been
1144 updated to include a new flag, <literal>-u</literal>, which
1145 enables unbuffered output when specified.</para>
1147 <para revision="268161">The &man.mkimg.1; utility has been
1148 merged from &os;-CURRENT.</para>
1150 <para revision="268700" contrib="sponsor"
1151 sponsor="&spectralogic;">The &man.camcontrol.8; has been
1152 updated to include a new <literal>persist</literal> command,
1153 which allows issuing <command>SCSI PERSISTENT RESERVE
1154 IN</command> and <command>SCSI PERSISTENT RESERVE
1155 OUT</command>.</para>
1157 <para revision="268791">The &man.gstat.8; utility has been
1158 updated to include a new flag, <literal>-p</literal>, which
1159 displays only physical providers when specified.</para>
1161 <para revision="268903">The &man.kldstat.8; utility has been
1162 updated to allow <literal>-q</literal> to be specified when
1163 also specifying <literal>-n
1164 <replaceable>module.ko</replaceable></literal>.</para>
1166 <para revision="269177">The &man.mkimg.1; utility has been
1167 updated to include support for both fixed- and
1168 dynamically-allocated images for the <acronym>VHD</acronym>
1169 and <acronym>VMDK</acronym> formats.</para>
1171 <para revision="269220">The &man.random.4; entropy collection
1172 script, <filename>/usr/libexec/save-entropy</filename>, no
1173 longer runs within &man.jail.8; environments.</para>
1175 <para revision="269397">The &man.bhyve.8; wrapper script,
1176 <filename>/usr/share/examples/bhyve/vmrun.sh</filename>,
1177 has been synced with &os;-CURRENT.</para>
1179 <para>This update includes:</para>
1183 <para>A new flag, <literal>-e</literal>, has been added,
1184 which is used to set &man.loader.8; environment
1189 <para>A new flag, <literal>-C</literal>, has been added,
1190 which is used to specify the guest console device.</para>
1194 <para>A new flag, <literal>-H</literal>, has been added,
1195 which is used to pass the host path to
1196 &man.bhyveload.8;.</para>
1200 <para>Support for multiple disk and &man.tap.4; devices
1201 has been added.</para>
1205 <para>The <literal>-I</literal> flag has been
1210 <para revision="269398">The &man.nfsd.8; server update to 4.1,
1211 adding support for RFC5661, has merged from
1212 &os;-CURRENT.</para>
1214 <para revision="269432" arch="ia64">The serial terminals
1215 <filename>ttyu0</filename> and <filename>ttyu1</filename> have
1216 been updated to <literal>onifconsole</literal> by default in
1217 &man.ttys.5;, which either can be the serial console,
1218 depending on the platform.</para>
1220 <para revision="269800">The &man.ping6.8; utility has been
1221 updated to reset <literal>itimer</literal> when the maximum
1222 number of packets to send have been reached. This prevents
1223 &man.ping6.8; from exiting when the interval in set to a small
1224 value and a low number of packets to send has been
1227 <para revision="269805">The &man.jail.8; utility has been
1228 updated to support extra &man.ifconfig.8; arguments for the
1229 <literal>ip4.addr</literal> and <literal>ip6.addr</literal>
1230 parameters. This change allows &man.carp.4; interfaces to
1231 be used within the &man.jail.8;.</para>
1233 <para revision="269946">Support for generating and compiling
1234 <acronym>USDT</acronym> <application>DTrace</application>
1235 probes has been improved. <application>DTrace</application>
1236 <acronym>USDT</acronym> files are now handled similar to
1237 &man.lex.1; and &man.yacc.1; files, meaning support for
1238 handling <application>D</application> files as part of the
1239 build process is built into the <literal>SRCS</literal>
1240 &man.make.1; environment variable.</para>
1242 <para revision="269968">The &man.iscsictl.8; utility has been
1243 updated to include a new flag, <literal>-M</literal>, which
1244 allows modifying the <acronym>iSCSI</acronym> session
1245 parameters without requiring the session to be removed and
1248 <para revision="270043">The &man.mount.nfs.8; utility has been
1249 updated to support specifying the NFS version as
1250 a <literal>key=<replaceable>value</replaceable></literal> pair
1251 argument to the <literal>-o</literal> flag. For example, to
1252 specify NFS version 4, the syntax to use is
1253 <literal>-o vers=4</literal>.</para>
1255 <para revision="270242" contrib="sponsor"
1256 sponsor="&spectralogic;">The &man.devd.8; client socket type
1257 has been changed to <literal>SOCK_SEQPACKET</literal>,
1258 providing sequential packet support.</para>
1260 <para revision="270401">Support for the <quote>account</quote>
1261 facility has been added to the &man.pam.group.8;
1264 <para revision="270890">The &man.pathchk.1; utility has been
1265 updated to ensure bytes greater than or equal to 128 are
1266 considered non-portable.</para>
1268 <para revision="270997" contrib="vendor" vendor="&freenas;">The
1269 &man.zdb.8; utility is now included in the set of applications
1270 installed in the <filename
1271 class="directory">/rescue</filename> environment, making it
1272 possible to examine &man.zfs.8; filesystems when <filename
1273 class="directory">/usr</filename> is unavailable.</para>
1275 <para>Several <literal>libc</literal> improvements have been
1276 merged from illumos™ and &apple;, providing better
1277 internationalization support and &posix; compliance.</para>
1279 <sect3 xml:id="rc-scripts">
1280 <title><filename>/etc/rc.d</filename> Scripts</title>
1282 <para revision="264438">The <filename>network.subr</filename>
1283 &man.rc.8; script has been updated to loosen the requirement
1284 of listing network aliases in numeric order. Previously,
1286 <literal>_alias<replaceable>2</replaceable></literal>
1287 would not be created if
1288 <literal>_alias<replaceable>1</replaceable></literal> was
1291 <para revision="268098">The &man.service.8; utility has been
1292 updated to check that the &man.rc.d.8; directory exists
1293 before traversing the directory.</para>
1295 <para revision="259141">A regression introduced in
1296 &os; 10.0-RELEASE that would prevent proper IPv6
1297 allocation via the &man.jail.8; &man.rc.8; startup script
1298 has been fixed.</para>
1300 <para revision="264438">The &man.rc.8; restriction requiring
1301 &man.mdconfig.8; devices defined in &man.rc.conf.5; to be
1302 listed sequentially has been removed.</para>
1304 <para revision="262566">The &man.sshd.8; &man.rc.d.8; startup
1305 script now generates <literal>ED25519</literal> &man.sshd.8;
1306 host keys if keys do not already exist when
1307 <literal>ssh_keygen_alg()</literal> is invoked.</para>
1309 <para revision="271095">Support for &man.vt.4; keyboard maps
1310 has been added to the <filename>syscons</filename>
1311 &man.rc.d.8; startup script.</para>
1313 <para revision="271260">Support for subdirectories within
1315 class="directory">/etc/rc.conf.d/<replaceable>service</replaceable>/</filename>
1316 has been added the &man.rc.d.8;. This allows creating
1317 separate configuration files for services such as
1318 <filename>netif</filename>, for example, where each network
1319 interface can have a separate configuration file.</para>
1323 <sect2 xml:id="contrib">
1324 <title>Contributed Software</title>
1326 <para revision="263285">The &man.xz.1; utility has been updated
1327 to a post-5.0.5 snapshot.</para>
1329 <para revision="264377"><application>OpenSSH</application> has
1330 been updated to version 6.6p1.</para>
1332 <para revision="264911">The &man.nc.1; utility has been updated
1333 to match the version in OpenBSD 5.5.</para>
1335 <para revision="266692"><application>Sendmail</application>
1336 has been updated to 8.14.9.</para>
1338 <para revision="268515">The &man.file.1; utility and
1339 &man.libmagic.3; library have been updated to 5.19.</para>
1341 <para revision="268899">The &man.byacc.1; parser has been
1342 updated to version 20140422.</para>
1344 <para revision="269024" contrib="sponsor"
1345 sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has
1346 been updated to the r202189 snapshot.</para>
1348 <para revision="269257">The &man.unbound.8; caching resolver and
1349 <literal>ldns</literal> have been updated to version
1352 <para revision="269686"><application>OpenSSL</application> has
1353 been updated to version 1.0.1i.</para>
1355 <para revision="269847">The <quote>lite</quote> version of
1356 <application>Subversion</application> included in the
1357 &os; base system and its dependencies have been
1362 <para><application>apr</application> has been
1363 updated to version 1.5.1.</para>
1367 <para><application>apr-util</application> has been
1368 updated to version 1.5.3.</para>
1372 <para><application>serf</application> has been
1373 updated to version 1.3.7.</para>
1377 <para><application>svnlite</application> has been
1378 updated to version 1.8.10.</para>
1382 <para revision="270026">The &man.nvi.1; editor has been
1383 update to version 2.1.2-c80f493b038.</para>
1385 <para revision="270031">The &man.fparseln.3; library has
1386 been updated to version 1.7.</para>
1388 <para revision="270415">The <application>lukemftpd</application>
1389 <acronym>FTP</acronym> server has been removed from the
1390 &os; base system.</para>
1392 <para revision="270817">The timezone database has been updated
1393 to version tzdata2014f.</para>
1396 <sect2 xml:id="ports">
1397 <title>Ports/Packages Collection Infrastructure</title>
1403 <sect2 xml:id="releng">
1404 <title>Release Engineering and Integration</title>
1406 <para revision="263028">The &man.services.mkdb.8; utility has
1407 been updated to include endianness awareness, allowing the
1408 <filename>services.db</filename> database to be created as
1409 part of the release build, regardless of native- or
1410 cross-built releases.</para>
1413 <sect2 xml:id="doc">
1414 <title>Documentation</title>
1421 <sect1 xml:id="upgrade">
1422 <title>Upgrading from Previous Releases of &os;</title>
1424 <para arch="amd64,i386">Binary upgrades between RELEASE versions
1425 (and snapshots of the various security branches) are supported
1426 using the &man.freebsd-update.8; utility. The binary upgrade
1427 procedure will update unmodified userland utilities, as well as
1428 unmodified <filename>GENERIC</filename> kernel distributed as
1429 a part of an official &os; release. The &man.freebsd-update.8;
1430 utility requires that the host being upgraded have Internet
1431 connectivity.</para>
1433 <para>Source-based upgrades (those based on recompiling the &os;
1434 base system from source code) from previous versions are
1435 supported, according to the instructions in
1436 <filename>/usr/src/UPDATING</filename>.</para>
1439 <para>Upgrading &os; should only be attempted after
1440 backing up <emphasis>all</emphasis> data and configuration