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>
659 <sect3 xml:id="disks">
660 <title>Disks and Storage</title>
662 <para revision="260385" contrib="sponsor" sponsor="&ix;">The
663 &man.geom.4; subsystem has been updated to support I/O
664 direct dispatch. When safety requirements are met, it
665 enables avoiding passing I/O requests to GEOM
666 <literal>g_up</literal>/<literal>g_down</literal> thread,
667 executing them directly in the caller context, avoiding
669 <literal>g_up</literal>/<literal>g_down</literal> threads,
670 plus avoid several context switches per I/O.</para>
672 <para revision="260385" contrib="sponsor" sponsor="&ix;">The
673 &man.geom.4; RAID driver has been
674 updated to support unmapped I/O.</para>
676 <para revision="260387" contrib="sponsor" sponsor="&ix;">The
677 &man.cam.4; subsystem has been updated to support
678 finer-grained locking, direct dispatch and multi-queue,
679 which combined with &man.geom.4; direct dispatch, reduces
680 lock congestion and improves <acronym>SMP</acronym>
681 scalability of the SCSI/ATA stack.</para>
683 <para revision="260478">The &man.geom.8;
684 <literal>GEOM_MULTIPATH</literal> class has been updated to
685 support automatic live partition resizing.</para>
687 <para revision="260857">The &man.virtio_blk.4; driver has been
688 updated to support unmapped I/O.</para>
690 <para revision="260858">The &man.virtio_scsi.4; driver has
691 been updated to support unmapped I/O.</para>
693 <para revision="264522">Support for LUN-based CD changers has
694 been removed from the &man.cd.4; driver.</para>
696 <para revision="264732">Support for
697 <literal>BIO_DELETE</literal> has been added to &man.zfs.8;
698 <literal>zvol</literal> volumes.</para>
700 <para revision="264734">Support for 9th generation HP host bus
701 adapter cards has been added to &man.ciss.4;.</para>
703 <para revision="265388" contrib="sponsor" sponsor="&lsi;">The
704 &man.mpr.4; device has been added,
705 providing support for LSI Fusion-MPT 3 12Gb SCSI/SATA
708 <para revision="265678">A new <literal>zvol</literal> property
709 <literal>volmode</literal> and &man.sysctl.8;
710 <literal>vfs.zfs.vol.mode</literal> has been added to allow
711 switching <literal>zvol</literal> between three different
712 ways of exposing it to a user: <literal>geom</literal>,
713 <literal>dev</literal> and <literal>none</literal>.</para>
715 <para revision="265922" contrib="sponsor" sponsor="&lsi;">The
716 &man.mrsas.4; driver has been added, providing support for
717 LSI MegaRAID SAS controllers. The &man.mfi.4; driver will
718 attach to the controller, by default. To enable
719 &man.mrsas.4; add <literal>hw.mfi.mrsas_enable=1</literal>
720 to <filename>/boot/loader.conf</filename>, which turns off
721 &man.mfi.4; device probing.</para>
724 <para>At this time, the &man.mfiutil.8; utility and the &os;
725 version of <application>MegaCLI</application> and
726 <application>StorCli</application> do not work with
727 &man.mrsas.4;.</para>
730 <para revision="266608">Fixed accounting of
731 <literal>BIO_FLUSH</literal> operation in &man.geom.8;
732 <literal>GEOM_DISK</literal> class</para>
734 <para revision="266610">The &man.gstat.8; utility now has an
735 <literal>-o</literal> option, to display
736 <quote>other</quote> operations, such as
737 <literal>BIO_FLUSH</literal>.</para>
739 <para revision="267084">The &man.mfi.4; driver has been
740 updated to include support for unmapped I/O.</para>
742 <para revision="267457">The &man.hpt27xx.4; driver has been
743 updated with various vendor-supplied bug fixes.</para>
745 <para revision="270130" contrib="sponsor"
746 sponsor="&citrix.rd;">Support for unmapped I/O has been
747 added to the &man.xen.4; <literal>blkfront</literal>
750 <para revision="259328" contrib="sponsor" sponsor="&ff;">The
751 &man.geom.8; <literal>label</literal> class is now aware of
752 resized partitions. This corrects an issue where
753 <command>geom resize</command> would resize the partition,
754 but the label provider in <filename
755 class="directory">/dev/gptid/</filename> would not be
758 <para revision="260502">The &man.gmirror.8;
759 utility now has a <literal>resize</literal> command, making
760 it easier to resize the size of a mirror when all of its
761 components have been replaced.</para>
763 <para revision="262967">Support for MegaRAID Fury cards has
764 been added to the &man.mfi.4; driver.</para>
766 <para revision="263024">The &man.aacraid.4; driver has been
767 updated to version 3.2.5.</para>
769 <para revision="265536">The <literal>GEOM_VINUM</literal>
770 option is now able to be built both directly into the kernel
771 or as a &man.kldload.8; loadable module.</para>
773 <para revision="265912">The &man.geom.8;
774 <literal>GEOM_PART</literal> class has been updated to
775 support automatic partition resizing. Changes to the
776 partition size are not saved to disk until
777 <command>gpart commit</command> is run, and prior to saving,
778 can be reverted with <command>gpart undo</command>.</para>
780 <para revision="266220">The &man.geom.uncompress.4; module is
781 built by default which, similar to &man.geom.uzip.4;,
782 provides support for compressed, read-only disk
785 <para revision="268091">Support for the
786 <literal>disklabel64</literal> partitioning scheme has been
787 added to &man.gpart.8;.</para>
789 <para revision="270552">A new &man.sysctl.8; and
790 &man.loader.8; tunable,
791 <literal>kern.geom.part.mbr.enforce_chs</literal> has been
792 added to the &man.geom.8; <literal>MBR</literal> partition
793 class. When set to a non-zero value,
794 <literal>GEOM_PART_MBR</literal> will automatically
795 recalculate the user-specified offset and size for alignment
796 with the disk geometry.</para>
798 <para contrib="sponsor" sponsor="&ix;">Many improvements to
799 the CAM Target Layer (CTL):</para>
802 <para>Support for <literal>UNMAP</literal>, <literal>WRITE
803 SAME</literal>, <literal>COMPARE AND WRITE</literal>,
804 <literal>XCOPY</literal> and some other SCSI commands
805 was added to support VMWare VAAI and Microsoft ODX
806 storage acceleration.</para>
809 <para revision="265642">The
810 <literal>READ</literal>/<literal>WRITE</literal> size
811 limitations were removed by supporting multiple
812 data moves per command.</para>
815 <para revision="268556">Finer-grained per-LUN locking and
816 multiple worker threads for better
817 <acronym>SMP</acronym> scapability.</para>
820 <para revision="269297">Memory consumption reduced by
821 several times by disabling some never used
822 functionality.</para>
825 <para revision="269298">The maximum number of
826 <acronym>SCSI</acronym> ports increased from 32 to
830 <para revision="269429">Improved <literal>zvol</literal>
831 integration for better performance.</para>
835 <para revision="270810" contrib="vendor"
836 vendor="&highpoint;">The &man.hptnr.4; driver has been
837 updated to version 1.0.1.</para>
839 <para revision="271234">The &man.mrsas.4; driver has been
840 added to the <filename>GENERIC</filename> kernel
841 configuration on &arch.amd64; and &arch.i386;
842 architectures.</para>
846 <title>File Systems</title>
848 <para revision="260338">The
849 <literal>vfs.zfs.zio.use_uma</literal> &man.sysctl.8; has
850 been re-enabled. On multi-CPU machines with enough RAM,
851 this can easily double &man.zfs.8; performance or reduce CPU
852 usage in half. It was originally disabled due to memory and
853 <acronym>KVA</acronym> exhaustion problem reports, which
854 should be resolved due to several change in the VM
857 <para revision="260178" contrib="vendor"
858 vendor="&netflix;">A new flag, <literal>-R</literal>,
859 has been added to the &man.fsck.ffs.8; utility. When used,
860 &man.fsck.ffs.8; will restart itself when too many critical
861 errors have been detected.</para>
863 <para revision="263407">The &man.zfs.8; filesystem has been
864 updated to implement <quote>bookmarks</quote>. See
865 &man.zfs.8; for further details.</para>
867 <para revision="266122">The &man.zfs.8; filesystem has been
868 updated to allow tuning the minimum <quote>ashift</quote>
869 value when creating new top-level virtual devices (vdevs).
870 To set the minimum ashift value, for example when creating
871 a &man.zpool.8; on <quote>Advanced Format</quote> drives,
872 set the <literal>vfs.zfs.min_auto_ashift</literal>
873 &man.sysctl.8; accordingly.</para>
875 <para revision="266612">The <literal>libzfs</literal> thread
876 pool <acronym>API</acronym> has been imported from
877 OpenSolaris, and adapted for &os;. This change allows
878 parallel disk scanning, which can reduce &man.zpool.8;
879 overall import time in some workloads.</para>
881 <para revision="269651">The &man.restore.8; utility has been
882 updated to prevent assertion failures when restoring
883 a <acronym>UFS</acronym> filesystem dump to
884 a <acronym>ZFS</acronym> filesystem by writing restored
885 files in block sizes that are a multiple of 1024.</para>
887 <para revision="269774">Two &man.sysctl.8;s have been added
888 to the &man.zfs.8; filesystem:</para>
893 <literal>vfs.zfs.mg_fragmentation_threshold</literal>: The
894 percentage of the metaslab group size that should be
895 considered eligible for allocation, unless all metaslab
896 groups within the metaslab class have also crossed this
902 <literal>vfs.zfs.metaslab.fragmentation_threshold</literal>: The
903 maximum percentage of metaslab fragmentation level to
904 keep their active state</para>
908 <para revision="269846">The default &man.zfs.8;
909 <acronym>ARC</acronym> hash table size has been increased,
910 and a new &man.loader.8; tunable,
911 <literal>vfs.zfs.arc_average_blocksize</literal>, has been
912 added. Previously, the hash table could be too small, which
913 would lead to long hash chains and limit performance for
915 <literal>vfs.zfs.arc_average_blocksize</literal> tunable
916 allows overriding the default block size. The previous
917 default was 65536, and default of the new &man.loader.8;
918 tunable is 8192.</para>
920 <para revision="270157">The Fast File System
921 (<acronym>FFS</acronym>) has been updated to support
922 multi-threaded soft updates. Previously, soft updates were
923 handled by a single thread, and as of this change, now have
924 one thread per <acronym>FFS</acronym> mountpoint.</para>
926 <para revision="270892" contrib="sponsor" sponsor="&ff;">The
927 new filesystem automount facility, &man.autofs.5;, has been
928 merged from &os;-CURRENT. The new &man.autofs.5; facility
929 is similar to that found in other &unix;-like operating
930 systems, such as OS X™ and Solaris™. The
931 &man.autofs.5; facility uses a &sun;-compatible
932 &man.auto.master.5; configuration file, and is administered
933 with the &man.automount.8; userland utility, and the
934 &man.automountd.8; and &man.autounmountd.8; daemons.</para>
938 <sect2 xml:id="userland">
939 <title>Userland Changes</title>
941 <para revision="260177" contrib="sponsor"
942 sponsor="&netflix;">A new flag is added to &man.camcontrol.8;,
943 <literal>-b</literal>, which outputs the existing buses and
944 their parents.</para>
946 <para revision="262075">The &man.newsyslog.8; utility has been
947 updated to rotate files based on the actual file size instead
948 of the blocks on disk. This matches the behavior documented
949 in &man.newsyslog.conf.5;.</para>
951 <para revision="262384">The location of the &man.rctl.8;
952 configuration file can now be overridden in &man.rc.conf.5;.
953 To use a non-default location, set
954 <literal>rctl_rules</literal> in &man.rc.conf.5; to the
955 location of the file.</para>
957 <para revision="262855">The <application>ATF</application> test
958 suite has been updated to version 0.20. The test suite is
959 disabled by default in &os; 10.1, and can be enabled by
960 adding <literal>WITH_TESTS=yes</literal> to
961 &man.src.conf.5;.</para>
963 <para revision="263019">The <literal>libucl</literal> library
964 (Unified Configuration Library) has been merged from
967 <para revision="263020">The &man.pkg.7; bootstrapping utility
968 has been synced with the version in &os;-CURRENT.</para>
970 <para revision="263403">The &man.zfs.8; userland utility has
971 been updated to include aliases for
972 <command>snapshot</command>, which allows use of <command>zfs
973 list -t snap</command> and <command>zfs
974 snap</command>.</para>
976 <para revision="263405">The &man.zfs.8; userland utility has
977 been updated to include a new flag to <command>zfs
978 list</command>, <literal>-p</literal>, which when specified,
979 prints the output in a parsable format.</para>
981 <para revision="263783">The Blowfish password format
982 implementation updated. Support for $2b$ has
983 been added, allowing use of passwords greater than 256
984 characters long.</para>
986 <para revision="264497">The &man.iconv.3; library has been
987 updated to match NetBSD, providing several bug fixes.</para>
989 <para revision="265265">The &man.date.1; utility has been
990 updated to include a new flag, <literal>-R</literal>, which
991 prints the date and time output as specified in RFC
994 <para revision="265533">The &man.bc.1; utility has been updated
995 to version 1.1, in sync with the version in OpenBSD.</para>
997 <para revision="265604" contrib="vendor"
998 vendor="&netflix;">The &man.pmcstat.8; utility has been
999 updated to include a new flag, <literal>-a</literal>, which
1000 when specified, produces a full stack track on the sampled
1003 <para revision="265701">The &man.netstat.8; and &man.route.8;
1004 utilities have been updated to include a shorthand equivalent
1005 to the <literal>-f inet</literal> and <literal>-f
1006 inet6</literal> address specifiers, <literal>-4</literal>
1007 and <literal>-6</literal>, respectively.</para>
1009 <para revision="265879">The &man.crypt.3; library now defaults
1010 to SHA512 for password hashing.</para>
1012 <para revision="266014">The &man.gvinum.8; utility has been
1013 updated to allow forceful configuration reset with the
1014 <literal>-f</literal> flag. Additionally, a bug that would
1015 prevent <literal>-f</literal> from properly creating
1016 a &man.gvinum.8; configuration has been fixed.</para>
1018 <para revision="266029">The &man.login.conf.5; file now takes
1019 precedence over the shell-specific environment files. In
1020 particular, the <literal>PATH</literal>,
1021 <literal>BLOCKSIZE</literal> variables are commented from
1022 <filename>/usr/share/skel/dot.profile</filename>, and the
1023 <literal>path</literal>, <literal>BLOCKSIZE</literal>, and
1024 <literal>umask</literal> variables have been commented from
1025 <filename>/usr/share/skel/dot.cshrc</filename>.</para>
1027 <para revision="266272">The &man.binmiscctl.8; userland utility
1028 and related image activator features have been merged from
1029 &os;-CURRENT.</para>
1031 <para revision="266279">The &man.ps.1; utility has been
1032 updated to include the <literal>-J</literal> flag, used to
1033 filter output by matching &man.jail.8; IDs and names.
1034 Additionally, argument <literal>0</literal> can be used to
1035 <literal>-J</literal> to only list processes running on the
1038 <para revision="266280">The &man.top.1; utility has been updated
1039 to filter by &man.jail.8; ID or name, in followup to the
1040 &man.ps.1; change in <literal>r265229</literal>.</para>
1042 <para revision="266610">The &man.gstat.8; utility has been
1043 updated to include a new flag, <literal>-o</literal>. When
1044 set, &man.gstat.8; will display statistics for operations
1045 such as <literal>BIO_FLUSH</literal>.</para>
1047 <para revision="266632">The &man.fetch.3; library has been
1048 updated to look for root <acronym>SSL</acronym> certificates
1049 in <filename class="directory">/usr/local/etc/ssl/</filename>
1051 class="directory">/etc/ssl/</filename>.</para>
1053 <para revision="266715">The &man.clang.1;/llvm suite has been
1054 updated to version 3.4.1.</para>
1056 <para revision="266816">The Blowfish password format
1057 has been changed to $2b$ by default.</para>
1059 <para revision="266888">The amount of data collected for
1060 &man.hwpmc.4; has been updated to work with modern processors
1061 and larger amounts of available memory.</para>
1063 <para revision="266890">The &man.pmcstat.8; utility has been
1064 updated to include a new flag, <literal>-l</literal>, which
1065 ends event collection after the specified number of
1068 <para revision="266953">The &man.mergemaster.8; utility has
1069 been updated to avoid printing
1070 <quote><filename>/var/tmp/temproot</filename>
1071 disappeared</quote> if there is nothing to compare.</para>
1073 <para revision="267056">The &os; installer, &man.bsdinstall.8;,
1074 has been updated to include optional
1075 &man.geli.8;-encrypted or &man.gmirror.8;-mirrored swap
1076 devices when installing onto a full &man.zfs.8; filesystem.
1077 Additionally, the parent &man.zfs.8; dataset is now configured
1078 with <literal>lz4</literal> compression enabled.</para>
1080 <para revision="267113">The default &man.newsyslog.conf.5; now
1081 includes files in the
1082 <filename>/etc/newsyslog.conf.d/</filename> and
1083 <filename>/usr/local/etc/newsyslog.conf.d/</filename>
1084 directories by default for &man.newsyslog.8;.</para>
1086 <para revision="267161">The &man.realpath.1; utility has been
1087 updated to return <literal>ENOTDIR</literal> on paths
1088 components <quote>.</quote> and <quote>..</quote> that are
1089 not directories, such as <filename
1090 class="directory">/dev/null/.</filename> or <filename
1091 class="directory">/dev/null/..</filename>.</para>
1093 <para revision="267236">A new flag, <quote>onifconsole</quote>
1094 has been added to <filename>/etc/ttys</filename>. This allows
1095 the system to provide a login prompt via serial console if the
1096 device is an active kernel console, otherwise it is equivalent
1097 to <literal>off</literal>.</para>
1099 <para revision="267341">Support for legacy
1100 <acronym>PCI</acronym> devices has been removed from
1101 &man.bhyve.8;.</para>
1103 <para revision="267450">The &man.bhyve.8; userland utility
1104 has been updated to include SMBIOS support. A new flag has
1105 been added, <literal>-U</literal>, which allows specifying the
1106 UUID of the guest in the System Information structure.</para>
1108 <para revision="267734">The &os; Project has migrated
1109 from the <application>GNATS</application> bug tracking system
1110 to <application>Bugzilla</application>. The &man.send-pr.1;
1111 utility used for submitting problem reports has been replaced
1112 with a stub shell script that instructs to use the Bugzilla
1113 web interface.</para>
1115 <para revision="267747">The &man.patch.1; utility has been
1116 updated to include a <literal>--dry-run</literal> flag, which
1117 is equivalent to <literal>--check</literal> and
1118 <literal>-C</literal>.</para>
1120 <para revision="267878">A bug in &man.bsdgrep.1; that would
1121 prevent patterns from being matched under certain conditions
1122 has been fixed.</para>
1124 <para revision="267979">The &man.procstat.1; utility has been
1125 updated to include two new flags, <literal>-r</literal> and
1126 <literal>-H</literal>. When <literal>-r</literal> is
1127 specified, &man.procstat.1; will print current resource usage
1128 about the process(es). When <literal>-H</literal> is
1129 specified, &man.procstat.1; will print information about
1130 threads rather than the process(es).</para>
1133 <para>The <literal>-H</literal> flag is currently only used
1134 with <literal>-r</literal> to display resource usage for
1135 individual threads, rather than the entire process.</para>
1138 <para revision="268019">The &man.sed.1; utility has been
1139 updated to include a new flag, <literal>-u</literal>, which
1140 enables unbuffered output when specified.</para>
1142 <para revision="268161">The &man.mkimg.1; utility has been
1143 merged from &os;-CURRENT.</para>
1145 <para revision="268700" contrib="sponsor"
1146 sponsor="&spectralogic;">The &man.camcontrol.8; has been
1147 updated to include a new <literal>persist</literal> command,
1148 which allows issuing <command>SCSI PERSISTENT RESERVE
1149 IN</command> and <command>SCSI PERSISTENT RESERVE
1150 OUT</command>.</para>
1152 <para revision="268791">The &man.gstat.8; utility has been
1153 updated to include a new flag, <literal>-p</literal>, which
1154 displays only physical providers when specified.</para>
1156 <para revision="268903">The &man.kldstat.8; utility has been
1157 updated to allow <literal>-q</literal> to be specified when
1158 also specifying <literal>-n
1159 <replaceable>module.ko</replaceable></literal>.</para>
1161 <para revision="269177">The &man.mkimg.1; utility has been
1162 updated to include support for both fixed- and
1163 dynamically-allocated images for the <acronym>VHD</acronym>
1164 and <acronym>VMDK</acronym> formats.</para>
1166 <para revision="269220">The &man.random.4; entropy collection
1167 script, <filename>/usr/libexec/save-entropy</filename>, no
1168 longer runs within &man.jail.8; environments.</para>
1170 <para revision="269397">The &man.bhyve.8; wrapper script,
1171 <filename>/usr/share/examples/bhyve/vmrun.sh</filename>,
1172 has been synced with &os;-CURRENT.</para>
1174 <para>This update includes:</para>
1178 <para>A new flag, <literal>-e</literal>, has been added,
1179 which is used to set &man.loader.8; environment
1184 <para>A new flag, <literal>-C</literal>, has been added,
1185 which is used to specify the guest console device.</para>
1189 <para>A new flag, <literal>-H</literal>, has been added,
1190 which is used to pass the host path to
1191 &man.bhyveload.8;.</para>
1195 <para>Support for multiple disk and &man.tap.4; devices
1196 has been added.</para>
1200 <para>The <literal>-I</literal> flag has been
1205 <para revision="269398">The &man.nfsd.8; server update to 4.1,
1206 adding support for RFC5661, has merged from
1207 &os;-CURRENT.</para>
1209 <para revision="269432" arch="ia64">The serial terminals
1210 <filename>ttyu0</filename> and <filename>ttyu1</filename> have
1211 been updated to <literal>onifconsole</literal> by default in
1212 &man.ttys.5;, which either can be the serial console,
1213 depending on the platform.</para>
1215 <para revision="269800">The &man.ping6.8; utility has been
1216 updated to reset <literal>itimer</literal> when the maximum
1217 number of packets to send have been reached. This prevents
1218 &man.ping6.8; from exiting when the interval in set to a small
1219 value and a low number of packets to send has been
1222 <para revision="269805">The &man.jail.8; utility has been
1223 updated to support extra &man.ifconfig.8; arguments for the
1224 <literal>ip4.addr</literal> and <literal>ip6.addr</literal>
1225 parameters. This change allows &man.carp.4; interfaces to
1226 be used within the &man.jail.8;.</para>
1228 <para revision="269946">Support for generating and compiling
1229 <acronym>USDT</acronym> <application>DTrace</application>
1230 probes has been improved. <application>DTrace</application>
1231 <acronym>USDT</acronym> files are now handled similar to
1232 &man.lex.1; and &man.yacc.1; files, meaning support for
1233 handling <application>D</application> files as part of the
1234 build process is built into the <literal>SRCS</literal>
1235 &man.make.1; environment variable.</para>
1237 <para revision="269968">The &man.iscsictl.8; utility has been
1238 updated to include a new flag, <literal>-M</literal>, which
1239 allows modifying the <acronym>iSCSI</acronym> session
1240 parameters without requiring the session to be removed and
1243 <para revision="270043">The &man.mount.nfs.8; utility has been
1244 updated to support specifying the NFS version as
1245 a <literal>key=<replaceable>value</replaceable></literal> pair
1246 argument to the <literal>-o</literal> flag. For example, to
1247 specify NFS version 4, the syntax to use is
1248 <literal>-o vers=4</literal>.</para>
1250 <para revision="270242" contrib="sponsor"
1251 sponsor="&spectralogic;">The &man.devd.8; client socket type
1252 has been changed to <literal>SOCK_SEQPACKET</literal>,
1253 providing sequential packet support.</para>
1255 <para revision="270401">Support for the <quote>account</quote>
1256 facility has been added to the &man.pam.group.8;
1259 <para revision="270890">The &man.pathchk.1; utility has been
1260 updated to ensure bytes greater than or equal to 128 are
1261 considered non-portable.</para>
1263 <para revision="270997" contrib="vendor" vendor="&freenas;">The
1264 &man.zdb.8; utility is now included in the set of applications
1265 installed in the <filename
1266 class="directory">/rescue</filename> environment, making it
1267 possible to examine &man.zfs.8; filesystems when <filename
1268 class="directory">/usr</filename> is unavailable.</para>
1270 <para>Several <literal>libc</literal> improvements have been
1271 merged from illumos™ and &apple;, providing better
1272 internationalization support and &posix; compliance.</para>
1274 <sect3 xml:id="rc-scripts">
1275 <title><filename>/etc/rc.d</filename> Scripts</title>
1277 <para revision="264438">The <filename>network.subr</filename>
1278 &man.rc.8; script has been updated to loosen the requirement
1279 of listing network aliases in numeric order. Previously,
1281 <literal>_alias<replaceable>2</replaceable></literal>
1282 would not be created if
1283 <literal>_alias<replaceable>1</replaceable></literal> was
1286 <para revision="268098">The &man.service.8; utility has been
1287 updated to check that the &man.rc.d.8; directory exists
1288 before traversing the directory.</para>
1290 <para revision="259141">A regression introduced in
1291 &os; 10.0-RELEASE that would prevent proper IPv6
1292 allocation via the &man.jail.8; &man.rc.8; startup script
1293 has been fixed.</para>
1295 <para revision="264438">The &man.rc.8; restriction requiring
1296 &man.mdconfig.8; devices defined in &man.rc.conf.5; to be
1297 listed sequentially has been removed.</para>
1299 <para revision="262566">The &man.sshd.8; &man.rc.d.8; startup
1300 script now generates <literal>ED25519</literal> &man.sshd.8;
1301 host keys if keys do not already exist when
1302 <literal>ssh_keygen_alg()</literal> is invoked.</para>
1304 <para revision="271095">Support for &man.vt.4; keyboard maps
1305 has been added to the <filename>syscons</filename>
1306 &man.rc.d.8; startup script.</para>
1308 <para revision="271260">Support for subdirectories within
1310 class="directory">/etc/rc.conf.d/<replaceable>service</replaceable>/</filename>
1311 has been added the &man.rc.d.8;. This allows creating
1312 separate configuration files for services such as
1313 <filename>netif</filename>, for example, where each network
1314 interface can have a separate configuration file.</para>
1318 <sect2 xml:id="contrib">
1319 <title>Contributed Software</title>
1321 <para revision="263285">The &man.xz.1; utility has been updated
1322 to a post-5.0.5 snapshot.</para>
1324 <para revision="264377"><application>OpenSSH</application> has
1325 been updated to version 6.6p1.</para>
1327 <para revision="264911">The &man.nc.1; utility has been updated
1328 to match the version in OpenBSD 5.5.</para>
1330 <para revision="266692"><application>Sendmail</application>
1331 has been updated to 8.14.9.</para>
1333 <para revision="268515">The &man.file.1; utility and
1334 &man.libmagic.3; library have been updated to 5.19.</para>
1336 <para revision="268899">The &man.byacc.1; parser has been
1337 updated to version 20140422.</para>
1339 <para revision="269024" contrib="sponsor"
1340 sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has
1341 been updated to the r202189 snapshot.</para>
1343 <para revision="269257">The &man.unbound.8; caching resolver and
1344 <literal>ldns</literal> have been updated to version
1347 <para revision="269686"><application>OpenSSL</application> has
1348 been updated to version 1.0.1i.</para>
1350 <para revision="269847">The <quote>lite</quote> version of
1351 <application>Subversion</application> included in the
1352 &os; base system and its dependencies have been
1357 <para><application>apr</application> has been
1358 updated to version 1.5.1.</para>
1362 <para><application>apr-util</application> has been
1363 updated to version 1.5.3.</para>
1367 <para><application>serf</application> has been
1368 updated to version 1.3.7.</para>
1372 <para><application>svnlite</application> has been
1373 updated to version 1.8.10.</para>
1377 <para revision="270026">The &man.nvi.1; editor has been
1378 update to version 2.1.2-c80f493b038.</para>
1380 <para revision="270031">The &man.fparseln.3; library has
1381 been updated to version 1.7.</para>
1383 <para revision="270415">The <application>lukemftpd</application>
1384 <acronym>FTP</acronym> server has been removed from the
1385 &os; base system.</para>
1387 <para revision="270817">The timezone database has been updated
1388 to version tzdata2014f.</para>
1391 <sect2 xml:id="ports">
1392 <title>Ports/Packages Collection Infrastructure</title>
1398 <sect2 xml:id="releng">
1399 <title>Release Engineering and Integration</title>
1401 <para revision="263028">The &man.services.mkdb.8; utility has
1402 been updated to include endianness awareness, allowing the
1403 <filename>services.db</filename> database to be created as
1404 part of the release build, regardless of native- or
1405 cross-built releases.</para>
1408 <sect2 xml:id="doc">
1409 <title>Documentation</title>
1416 <sect1 xml:id="upgrade">
1417 <title>Upgrading from Previous Releases of &os;</title>
1419 <para arch="amd64,i386">Binary upgrades between RELEASE versions
1420 (and snapshots of the various security branches) are supported
1421 using the &man.freebsd-update.8; utility. The binary upgrade
1422 procedure will update unmodified userland utilities, as well as
1423 unmodified <filename>GENERIC</filename> kernel distributed as
1424 a part of an official &os; release. The &man.freebsd-update.8;
1425 utility requires that the host being upgraded have Internet
1426 connectivity.</para>
1428 <para>Source-based upgrades (those based on recompiling the &os;
1429 base system from source code) from previous versions are
1430 supported, according to the instructions in
1431 <filename>/usr/src/UPDATING</filename>.</para>
1434 <para>Upgrading &os; should only be attempted after
1435 backing up <emphasis>all</emphasis> data and configuration