article.xml revision 271031
1<?xml version="1.0" encoding="iso-8859-1"?> 2<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" 3 "../../../share/xml/freebsd50.dtd" [ 4<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent"> 5 %release; 6<!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "sponsor.ent"> 7 %sponsor; 8<!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "vendor.ent"> 9 %vendor; 10]> 11<article xmlns="http://docbook.org/ns/docbook" 12 xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"> 13 14 <info> 15 <title>&os; &release.current; Release Notes</title> 16 17 <author> 18 <orgname>The &os; Project</orgname> 19 </author> 20 21 <pubdate>$FreeBSD: stable/10/release/doc/en_US.ISO8859-1/relnotes/article.xml 271031 2014-09-03 16:46:25Z gjb $</pubdate> 22 23 <copyright> 24 <year>2000</year> 25 <year>2001</year> 26 <year>2002</year> 27 <year>2003</year> 28 <year>2004</year> 29 <year>2005</year> 30 <year>2006</year> 31 <year>2007</year> 32 <year>2008</year> 33 <year>2009</year> 34 <year>2010</year> 35 <year>2011</year> 36 <year>2012</year> 37 <year>2013</year> 38 <year>2014</year> 39 <holder role="mailto:doc@FreeBSD.org">The &os; Documentation 40 Project</holder> 41 </copyright> 42 43 <legalnotice xml:id="trademarks" role="trademarks"> 44 &tm-attrib.freebsd; 45 &tm-attrib.ibm; 46 &tm-attrib.ieee; 47 &tm-attrib.intel; 48 &tm-attrib.sparc; 49 &tm-attrib.general; 50 </legalnotice> 51 52 <abstract> 53 <para>The release notes for &os; &release.current; contain 54 a summary of the changes made to the &os; base system on the 55 &release.branch; development line. This document lists 56 applicable security advisories that were issued since the last 57 release, as well as significant changes to the &os; kernel and 58 userland. Some brief remarks on upgrading are also 59 presented.</para> 60 </abstract> 61 </info> 62 63 <sect1 xml:id="intro"> 64 <title>Introduction</title> 65 66 <para>This document contains the release notes for &os; 67 &release.current;. It describes recently added, changed, or 68 deleted features of &os;. It also provides some notes on 69 upgrading from previous versions of &os;.</para> 70 71 <para releasetype="current">The &release.type; distribution to 72 which these release notes apply represents the latest point 73 along the &release.branch; development branch since 74 &release.branch; was created. Information regarding pre-built, 75 binary &release.type; distributions along this branch can be 76 found at <uri 77 xlink:href="&release.url;">&release.url;</uri>.</para> 78 79 <para releasetype="snapshot">The &release.type; distribution to 80 which these release notes apply represents a point along the 81 &release.branch; development branch between &release.prev; and 82 the future &release.next;. Information regarding pre-built, 83 binary &release.type; distributions along this branch can be 84 found at <uri 85 xlink:href="&release.url;">&release.url;</uri>.</para> 86 87 <para releasetype="release">This distribution of &os; 88 &release.current; is a &release.type; distribution. It can be 89 found at <uri xlink:href="&release.url;">&release.url;</uri> or 90 any of its mirrors. More information on obtaining this (or 91 other) &release.type; distributions of &os; can be found in the 92 <link 93 xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining 94 &os;</quote> appendix</link> to the <link 95 xlink:href="&url.books.handbook;/">&os; 96 Handbook</link>.</para> 97 98 <para>All users are encouraged to consult the release errata 99 before installing &os;. The errata document is updated with 100 <quote>late-breaking</quote> information discovered late in the 101 release cycle or after the release. Typically, it contains 102 information on known bugs, security advisories, and corrections 103 to documentation. An up-to-date copy of the errata for &os; 104 &release.current; can be found on the &os; Web site.</para> 105 </sect1> 106 107 <sect1 xml:id="new"> 108 <title>What's New</title> 109 110 <para>This section describes the most user-visible new or changed 111 features in &os; since &release.prev;.</para> 112 113 <para>Typical release note items document recent security 114 advisories issued after &release.prev;, new drivers or hardware 115 support, new commands or options, major bug fixes, or 116 contributed software upgrades. They may also list changes to 117 major ports/packages or release engineering practices. Clearly 118 the release notes cannot list every single change made to &os; 119 between releases; this document focuses primarily on security 120 advisories, user-visible changes, and major architectural 121 improvements.</para> 122 123 <sect2 xml:id="security"> 124 <title>Security Advisories</title> 125 126 <para> </para> 127 128 </sect2> 129 130 <sect2 xml:id="kernel"> 131 <title>Kernel Changes</title> 132 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> 137 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> 143 144 <para revision="263122">Support for &man.hwpmc.4; has been added 145 for &powerpc; 970 class processors.</para> 146 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; 150 driver.</para> 151 152 <para revision="263256">A panic triggered by removing 153 a &man.urtwn.4; device has been fixed.</para> 154 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> 158 159 <para revision="263869">Support for &amd; Family 16h sensor 160 devices has been added to &man.amdtemp.4;.</para> 161 162 <para revision="265610">The &man.uslcom.4; driver has been 163 updated to support 26 new devices.</para> 164 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> 169 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> 173 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 177 system.</para> 178 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 183 fixed.</para> 184 185 <para revision="266911">The &man.hwpmc.4; driver has been 186 updated to support core events from the Atom™ 187 Silvermont architecture.</para> 188 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> 192 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> 196 197 <sect3 xml:id="kernel-virtualization"> 198 <title>Virtualization Support</title> 199 200 <para revision="259450">Support for µsoft; Hyper-V 201 has been added to &os;/i386 as loadable modules, however 202 not available in the <filename>GENERIC</filename> kernel 203 configuration.</para> 204 205 <para revision="261090">The &man.bhyve.4; hypervisor now 206 supports soft power-off functionality via the ACPI S5 207 state.</para> 208 209 <para revision="267399">Support for &os;/i386 guests has been 210 added to &man.bhyve.4;.</para> 211 212 <para revision="267427">Support for virtualized 213 <literal>XSAVE</literal> has been added to &man.bhyve.4;, 214 allowing guest operating systems to use 215 <literal>XSAVE</literal> and 216 <literal>XSAVE</literal>-enabled features, such as 217 <acronym>AVX</acronym>.</para> 218 219 <para revision="268932">The &man.bhyve.4; hypervisor now 220 supports booting from a &man.zfs.8; filesystem.</para> 221 222 <para revision="268933">A new driver, &man.virtio_random.4;, 223 has been added, which allows &os; virtual machines to 224 harvest entropy from the hypervisor.</para> 225 226 <para revision="270159">The &man.bhyve.4; hypervisor has been 227 synced with the version in &os;-CURRENT.</para> 228 229 <para>A number of enhancements have been added, and several 230 bug fixes, including:</para> 231 232 <itemizedlist> 233 <listitem> 234 <para>Post-mortem debugging has been added when 235 a guest virtual machine exits with an 236 <quote><acronym>EPT</acronym> Misconfiguration</quote> 237 error.</para> 238 </listitem> 239 240 <listitem> 241 <para>The hypervisor &man.virtio.4; <acronym>API</acronym> 242 has been expanded from 32- to 64-bit.</para> 243 </listitem> 244 245 <listitem> 246 <para>Support for identifying capabilities of the virtual 247 <acronym>CPU</acronym> has been added.</para> 248 </listitem> 249 250 <listitem> 251 <para>Support for emulating legacy x86 task 252 switching has been added.</para> 253 </listitem> 254 255 <listitem> 256 <para>Support to list the VT-x features in base kernel 257 &man.dmesg.8; has been added.</para> 258 </listitem> 259 260 <listitem> 261 <para>Support for extended PCI configuration space 262 has been added.</para> 263 </listitem> 264 </itemizedlist> 265 </sect3> 266 267 <sect3 xml:id="kernel-arm"> 268 <title>ARM Support</title> 269 270 <para revision="259355">The <filename>WANDBOARD</filename> 271 kernel configuration file has been added.</para> 272 273 <para revision="265067">Boot devices may now be specified by 274 setting a u-boot environment variable. If a boot device is 275 not specified, the probe mechanism will be used. To specify 276 the boot device, set the 277 <literal>loaderdev=<replaceable>device</replaceable></literal> 278 u-boot environment variable.</para> 279 280 <para revision="266000">The <literal>nexus(4)</literal> driver 281 has been updated to include <quote>Flattened Device 282 Tree</quote> support, replacing the &man.fdtbus.4; driver 283 in most cases.</para> 284 285 <para revision="266105">The &man.gpioiic.4; and 286 &man.gpioled.4; have been merged from &os;-CURRENT.</para> 287 288 <para>Support for hardware floating point was added to the 289 kernel, and enabled by default in the configuration files 290 for all platforms that contain the required hardware.</para> 291 292 <para><application>C++</application> exception handling now 293 works with <application>GCC</application>.</para> 294 295 <para>Support for <acronym>SMP</acronym> was added to the 296 kernel, and enabled by default in the configuration files 297 for all platforms that contain multi-core CPUs.</para> 298 299 <para>Support was added for:</para> 300 301 <itemizedlist> 302 <listitem> 303 <para>CHROMEBOOK (Samsung Exynos 5250)</para> 304 </listitem> 305 306 <listitem> 307 <para>COLIBRI (Freescale Vybrid)</para> 308 </listitem> 309 310 <listitem> 311 <para>COSMIC (Freescale Vybrid)</para> 312 </listitem> 313 314 <listitem> 315 <para>IMX53-QSB (Freescale i.MX53)</para> 316 </listitem> 317 318 <listitem> 319 <para>QUARTZ (Freescale Vybrid)</para> 320 </listitem> 321 322 <listitem> 323 <para>RADXA (Rockchip rk30xx)</para> 324 </listitem> 325 326 <listitem> 327 <para>WANDBOARD (Freescale i.MX6)</para> 328 </listitem> 329 </itemizedlist> 330 331 <para>An <acronym>I2C</acronym> driver was added for 332 the RaspberryPi.</para> 333 334 <para>Drivers have been added to support <acronym>TI</acronym> 335 platforms, such as BEAGLEBONE and PANDABOARD:</para> 336 337 <itemizedlist> 338 <listitem> 339 <para>PRUSS (Programmable Realtime Unit Subsystem)</para> 340 </listitem> 341 342 <listitem> 343 <para>MBOX (Mailbox hardware)</para> 344 </listitem> 345 346 <listitem> 347 <para>SDHCI (new faster driver for 348 <acronym>MMC</acronym>/<acronym>SD</acronym> 349 storage)</para> 350 </listitem> 351 352 <listitem> 353 <para>PPS (Pulse Per Second input on a 354 <acronym>GPIO</acronym>/timer pin)</para> 355 </listitem> 356 357 <listitem> 358 <para>PWM (Pulse Width Modulation output)</para> 359 </listitem> 360 361 <listitem> 362 <para>ADC (Analog to Digital converter)</para> 363 </listitem> 364 </itemizedlist> 365 </sect3> 366 367 <sect3 xml:id="boot"> 368 <title>Boot Loader Changes</title> 369 370 <para revision="262701">A kernel selection menu has been added 371 to &man.loader.8;. If the <quote>beastie menu</quote> is 372 enabled, the kernel to boot may be selected from the kernel 373 selection menu. Additional kernels may be listed in 374 &man.loader.conf.5; as a comma- or space-separated list. By 375 default, <literal>kernel</literal> and 376 <literal>kernel.old</literal> are listed.</para> 377 </sect3> 378 379 <sect3 xml:id="proc"> 380 <title>Hardware Support</title> 381 382 <para> </para> 383 384 <sect4 xml:id="mm"> 385 <title>Multimedia Support</title> 386 387 <para> </para> 388 389 </sect4> 390 391 <sect4 xml:id="net-if"> 392 <title>Network Interface Support</title> 393 394 <para revision="259453">Support for Ralink RT5370 and 395 RT5372 chipsets has been added to the &man.run.4; 396 driver.</para> 397 398 <para revision="260120">Firmware for the &man.run.4; driver 399 has been updated to version 0.33.</para> 400 401 <para revision="261868">Support for the Ralink RT3593 402 chipset has been added to the &man.run.4; driver.</para> 403 404 <para revision="261972">The &man.nve.4; driver is now 405 deprecated, and the &man.nfe.4; driver should be used 406 instead.</para> 407 408 <para revision="262137">Support for the &man.axge.4; driver 409 has been added. This driver supports the ASIX AX88178A 410 and AX88179 USB ethernet adapters. The AX88178A supports 411 USB 2.0, and the AX88179 supports USB 2.0 and 3.0.</para> 412 413 <para revision="262363">The &man.urndis.4; driver has been 414 imported from OpenBSD.</para> 415 416 <para revision="264866">Support for multiple 417 transmitter/receiver queues has been added to the 418 &man.vmx.4; driver.</para> 419 420 <note> 421 <para>The &os; guest operating system must have 422 <acronym>MSIX</acronym> enabled as a prerequisite for 423 multiple queues.</para> 424 </note> 425 426 <para revision="265345">Support for the ASUS USB-N10 Nano 427 wireless card has been added to the &man.urtwn.4; 428 driver.</para> 429 430 <para revision="266212">Transmission checksum offloading has 431 been disabled for the RTL8168C and RTL8168CP chipsets in 432 the &man.re.4; driver for TCP and UDP frames. This is 433 due to a report of UDP datagrams with IP options 434 generating corrupt frames.</para> 435 436 <para revision="266578">Preliminary support has been added 437 to the &man.urtwn.4; driver for the Realtek RTL8188EUS and 438 RTL8188ETV chipsets.</para> 439 440 <para revision="267694">A bug in the fast receiver buffer 441 recycle path has been fixed in the &man.cxgbe.4; 442 driver.</para> 443 444 <para revision="267849" contrib="vendor" 445 vendor="&chelsio;">The bundled &man.cxgbe.4; firmware for 446 T4 and T5 cards has been updated to version 447 1.11.27.0.</para> 448 449 <para revision="269196">The &man.em.4; driver has been 450 updated to version 7.4.2.</para> 451 452 <para revision="269975">The &man.ixgbe.4; tunables have been 453 renamed to match their &man.sysctl.8; counterparts:</para> 454 455 <informaltable frame="none" pgwide="0"> 456 <tgroup cols="2"> 457 <colspec colwidth="1*"/> 458 <colspec colwidth="1*"/> 459 <thead> 460 <row> 461 <entry>Old Name</entry> 462 <entry>New Name</entry> 463 </row> 464 </thead> 465 466 <tbody> 467 <row> 468 <entry><literal>hw.ixgbe.enable_aim</literal></entry> 469 <entry><literal>hw.ix.enable_aim</literal></entry> 470 </row> 471 472 <row> 473 <entry><literal>hw.ixgbe.max_interrupt_rate</literal></entry> 474 <entry><literal>hw.ix.max_interrupt_rate</literal></entry> 475 </row> 476 477 <row> 478 <entry><literal>hw.ixgbe.rx_process_limit</literal></entry> 479 <entry><literal>hw.ix.rx_process_limit</literal></entry> 480 </row> 481 482 <row> 483 <entry><literal>hw.ixgbe.tx_process_limit</literal></entry> 484 <entry><literal>hw.ix.tx_process_limit</literal></entry> 485 </row> 486 487 <row> 488 <entry><literal>hw.ixgbe.enable_msix</literal></entry> 489 <entry><literal>hw.ix.enable_msix</literal></entry> 490 </row> 491 492 <row> 493 <entry><literal>hw.ixgbe.num_queues</literal></entry> 494 <entry><literal>hw.ix.num_queues</literal></entry> 495 </row> 496 497 <row> 498 <entry><literal>hw.ixgbe.txd</literal></entry> 499 <entry><literal>hw.ix.txd</literal></entry> 500 </row> 501 502 <row> 503 <entry><literal>hw.ixgbe.rxd</literal></entry> 504 <entry><literal>hw.ix.rxd</literal></entry> 505 </row> 506 507 <row> 508 <entry><literal>hw.ixgbe.unsupported_sfp</literal></entry> 509 <entry><literal>hw.ix.unsupported_sfp</literal></entry> 510 </row> 511 </tbody> 512 </tgroup> 513 </informaltable> 514 515 <para>Be sure to update &man.loader.conf.5; if using the 516 old tunables before upgrading to 517 &os; &release.current;.</para> 518 519 <para revision="270061">The &man.if.nf10bmac.4; driver has 520 been merged from &os;-CURRENT to support the NetFPGA-10G 521 Embedded CPU Ethernet Core.</para> 522 523 <para revision="270297">The &man.cxgbe.4; driver has been 524 updated to support &man.netmap.4; for the T5 10G/40G 525 cards.</para> 526 527 <para revision="270509">The &man.vtnet.4; driver has been 528 updated to support &man.netmap.4;.</para> 529 530 <para revision="270514">The &man.urtwn.4; driver has been 531 updated to support the ASUS USB-AC51 wireless card.</para> 532 533 <para revision="270631">The &intel; XL710 ethernet 534 controller driver, <literal>ixlv(4)</literal>, has been 535 merged from &os;-CURRENT.</para> 536 </sect4> 537 </sect3> 538 539 <sect3 xml:id="net-proto"> 540 <title>Network Protocols</title> 541 542 <para revision="265946">Support for the UDP-Lite protocol 543 (RFC 3828) has been added to the IPv4 and IPv6 544 stacks.</para> 545 546 <para revision="267771">A bug in &man.sctp.4; that would allow 547 two listening sockets bound to the same port has been 548 fixed.</para> 549 550 <para contrib="sponsor" sponsor="&ix;">Kernel RPC code, which 551 is a base of NFS server took multiple optimizations, that 552 significantly improved its performance and 553 <acronym>SMP</acronym> scapability.</para> 554 555 <para revision="269065" contrib="sponsor" sponsor="&ff;">The 556 <acronym>iSCSI</acronym> initiator has been updated to 557 support redirection handling when an 558 <acronym>iSCSI</acronym> device is configured with multiple 559 <acronym>IP</acronym> addresses across different network 560 interfaces. Previously, clients connecting to 561 such <acronym>iSCSI</acronym> devices could require 562 additional client-side configuration.</para> 563 564 <para>New kernel-based iSCSI target and initiator code took 565 many fixes and performance optimizations.</para> 566 </sect3> 567 568 <sect3 xml:id="disks"> 569 <title>Disks and Storage</title> 570 571 <para revision="260385" contrib="sponsor" sponsor="&ix;">The 572 &man.geom.4; subsystem has been updated to support I/O 573 direct dispatch. When safety requirements are met, it 574 allows to avoid passing I/O requests to GEOM 575 <literal>g_up</literal>/<literal>g_down</literal> thread, 576 executing them directly in the caller context. That allows 577 to avoid CPU bottlenecks in 578 <literal>g_up</literal>/<literal>g_down</literal> threads, 579 plus avoid several context switches per I/O.</para> 580 581 <para revision="260385" contrib="sponsor" sponsor="&ix;">The 582 &man.geom.4; RAID driver has been 583 updated to support unmapped I/O.</para> 584 585 <para revision="260387" contrib="sponsor" sponsor="&ix;">The 586 &man.cam.4; subsystem has been updated to support 587 finer-grained locking, direct dispatch and multi-queue. 588 Combined with &man.geom.4; direct dispatch that allows to 589 reduce lock congestion and improve <acronym>SMP</acronym> 590 scalability of the SCSI/ATA stack.</para> 591 592 <para revision="260478">The &man.geom.8; 593 <literal>GEOM_MULTIPATH</literal> class has been updated to 594 support automatic live partition resizing.</para> 595 596 <para revision="260857">The &man.virtio_blk.4; driver has been 597 updated to support unmapped I/O.</para> 598 599 <para revision="260858">The &man.virtio_scsi.4; driver has 600 been updated to support unmapped I/O.</para> 601 602 <para revision="264522">Support for LUN-based CD changers has 603 been removed from the &man.cd.4; driver.</para> 604 605 <para revision="264732">Support for 606 <literal>BIO_DELETE</literal> has been added to &man.zfs.8; 607 <literal>zvol</literal> volumes.</para> 608 609 <para revision="264734">Support for 9th generation HP host bus 610 adapter cards has been added to &man.ciss.4;.</para> 611 612 <para revision="265388" contrib="sponsor" sponsor="&lsi;">The 613 &man.mpr.4; device has been added, 614 providing support for LSI Fusion-MPT 3 12Gb SCSI/SATA 615 controllers.</para> 616 617 <para revision="265678">A new <literal>zvol</literal> property 618 <literal>volmode</literal> and &man.sysctl.8; 619 <literal>vfs.zfs.vol.mode</literal> has been added to allow 620 switching <literal>zvol</literal> between three different 621 ways of exposing it to a user: <literal>geom</literal>, 622 <literal>dev</literal> and <literal>none</literal>.</para> 623 624 <para revision="265922" contrib="sponsor" sponsor="&lsi;">The 625 &man.mrsas.4; driver has been added, providing support for 626 LSI MegaRAID SAS controllers. The &man.mfi.4; driver will 627 attach to the controller, by default. To enable 628 &man.mrsas.4; add <literal>hw.mfi.mrsas_enable=1</literal> 629 to <filename>/boot/loader.conf</filename>, which turns off 630 &man.mfi.4; device probing.</para> 631 632 <note> 633 <para>At this time, the &man.mfiutil.8; utility and the &os; 634 version of <application>MegaCLI</application> and 635 <application>StorCli</application> do not work with 636 &man.mrsas.4;.</para> 637 </note> 638 639 <para revision="266608">Fixed accounting of 640 <literal>BIO_FLUSH</literal> operation in &man.geom.8; 641 <literal>GEOM_DISK</literal> class</para> 642 643 <para revision="266610">The &man.gstat.8; utility now has an 644 <literal>-o</literal> option, to display 645 <quote>other</quote> operations, such as 646 <literal>BIO_FLUSH</literal>.</para> 647 648 <para revision="267084">The &man.mfi.4; driver has been 649 updated to include support for unmapped I/O.</para> 650 651 <para revision="267457">The &man.hpt27xx.4; driver has been 652 updated with various vendor-supplied bug fixes.</para> 653 654 <para revision="270130" contrib="sponsor" 655 sponsor="&citrix.rd;">Support for unmapped I/O has been 656 added to the &man.xen.4; <literal>blkfront</literal> 657 driver.</para> 658 659 <para revision="259328" contrib="sponsor" sponsor="&ff;">The 660 &man.geom.8; <literal>label</literal> class is now aware of 661 resized partitions. This corrects an issue where 662 <command>geom resize</command> would resize the partition, 663 but the label provider in <filename 664 class="directory">/dev/gptid/</filename> would not be 665 resized.</para> 666 667 <para revision="260502">The &man.gmirror.8; 668 utility now has a <literal>resize</literal> command, making 669 it easier to resize the size of a mirror when all of its 670 components have been replaced.</para> 671 672 <para revision="262967">Support for MegaRAID Fury cards has 673 been added to the &man.mfi.4; driver.</para> 674 675 <para revision="263024">The &man.aacraid.4; driver has been 676 updated to version 3.2.5.</para> 677 678 <para revision="265536">The <literal>GEOM_VINUM</literal> 679 option is now able to be built both directly into the kernel 680 or as a &man.kldload.8; loadable module.</para> 681 682 <para revision="265912">The &man.geom.8; 683 <literal>GEOM_PART</literal> class has been updated to 684 support automatic partition resizing. Changes to the 685 partition size are not saved to disk until 686 <command>gpart commit</command> is run, and prior to saving, 687 can be reverted with <command>gpart undo</command>.</para> 688 689 <para revision="266220">The &man.geom.uncompress.4; module is 690 built by default which, similar to &man.geom.uzip.4;, 691 provides support for compressed, read-only disk 692 images.</para> 693 694 <para revision="268091">Support for the 695 <literal>disklabel64</literal> partitioning scheme has been 696 added to &man.gpart.8;.</para> 697 698 <para revision="270552">A new &man.sysctl.8; and 699 &man.loader.8; tunable, 700 <literal>kern.geom.part.mbr.enforce_chs</literal> has been 701 added to the &man.geom.8; <literal>MBR</literal> partition 702 class. When set to a non-zero value, 703 <literal>GEOM_PART_MBR</literal> will automatically 704 recalculate the user-specified offset and size for alignment 705 with the disk geometry.</para> 706 707 <para contrib="sponsor" sponsor="&ix;">Many improvements to 708 the CAM Target Layer (CTL):</para> 709 <itemizedlist> 710 <listitem> 711 <para>Support for <literal>UNMAP</literal>, <literal>WRITE 712 SAME</literal>, <literal>COMPARE AND WRITE</literal>, 713 <literal>XCOPY</literal> and some other SCSI commands 714 was added to support VMWare VAAI and Microsoft ODX 715 storage acceleration.</para> 716 </listitem> 717 <listitem> 718 <para revision="265642">The 719 <literal>READ</literal>/<literal>WRITE</literal> size 720 limitations were removed by supporting multiple 721 data moves per command.</para> 722 </listitem> 723 <listitem> 724 <para revision="268556">Finer-grained per-LUN locking and 725 multiple worker threads for better 726 <acronym>SMP</acronym> scapability.</para> 727 </listitem> 728 <listitem> 729 <para revision="269297">Memory consumption reduced by 730 several times by disabling some never used 731 functionality.</para> 732 </listitem> 733 <listitem> 734 <para revision="269298">The maximum number of 735 <acronym>SCSI</acronym> ports increased from 32 to 736 128</para> 737 </listitem> 738 <listitem> 739 <para revision="269429">Improved <literal>zvol</literal> 740 integration for better performance.</para> 741 </listitem> 742 </itemizedlist> 743 </sect3> 744 745 <sect3 xml:id="fs"> 746 <title>File Systems</title> 747 748 <para revision="260338">The 749 <literal>vfs.zfs.zio.use_uma</literal> &man.sysctl.8; has 750 been re-enabled. On multi-CPU machines with enough RAM, 751 this can easily double &man.zfs.8; performance or reduce CPU 752 usage in half. It was originally disabled due to memory and 753 <acronym>KVA</acronym> exhaustion problem reports, which 754 should be resolved due to several change in the VM 755 subsystem.</para> 756 757 <para revision="260178" contrib="vendor" 758 vendor="&netflix;">A new flag, <literal>-R</literal>, 759 has been added to the &man.fsck.ffs.8; utility. When used, 760 &man.fsck.ffs.8; will restart itself when too many critical 761 errors have been detected.</para> 762 763 <para revision="263407">The &man.zfs.8; filesystem has been 764 updated to implement <quote>bookmarks</quote>. See 765 &man.zfs.8; for further details.</para> 766 767 <para revision="266122">The &man.zfs.8; filesystem has been 768 updated to allow tuning the minimum <quote>ashift</quote> 769 value when creating new top-level virtual devices (vdevs). 770 To set the minimum ashift value, for example when creating 771 a &man.zpool.8; on <quote>Advanced Format</quote> drives, 772 set the <literal>vfs.zfs.min_auto_ashift</literal> 773 &man.sysctl.8; accordingly.</para> 774 775 <para revision="266612">The <literal>libzfs</literal> thread 776 pool <acronym>API</acronym> has been imported from 777 OpenSolaris, and adapted for &os;. This change allows 778 parallel disk scanning, which can reduce &man.zpool.8; 779 overall import time in some workloads.</para> 780 781 <para revision="269651">The &man.restore.8; utility has been 782 updated to prevent assertion failures when restoring 783 a <acronym>UFS</acronym> filesystem dump to 784 a <acronym>ZFS</acronym> filesystem by writing restored 785 files in block sizes that are a multiple of 1024.</para> 786 787 <para revision="269774">Two &man.sysctl.8;s have been added 788 to the &man.zfs.8; filesystem:</para> 789 790 <itemizedlist> 791 <listitem> 792 <para> 793 <literal>vfs.zfs.mg_fragmentation_threshold</literal>: The 794 percentage of the metaslab group size that should be 795 considered eligible for allocation, unless all metaslab 796 groups within the metaslab class have also crossed this 797 threshold.</para> 798 </listitem> 799 800 <listitem> 801 <para> 802 <literal>vfs.zfs.metaslab.fragmentation_threshold</literal>: The 803 maximum percentage of metaslab fragmentation level to 804 keep their active state</para> 805 </listitem> 806 </itemizedlist> 807 808 <para revision="269846">The default &man.zfs.8; 809 <acronym>ARC</acronym> hash table size has been increased, 810 and a new &man.loader.8; tunable, 811 <literal>vfs.zfs.arc_average_blocksize</literal>, has been 812 added. Previously, the hash table could be too small, which 813 would lead to long hash chains and limit performance for 814 cached reads. The 815 <literal>vfs.zfs.arc_average_blocksize</literal> tunable 816 allows overriding the default block size. The previous 817 default was 65536, and default of the new &man.loader.8; 818 tunable is 8192.</para> 819 820 <para revision="270157">The Fast File System 821 (<acronym>FFS</acronym>) has been updated to support 822 multi-threaded soft updates. Previously, soft updates were 823 handled by a single thread, and as of this change, now have 824 one thread per <acronym>FFS</acronym> mountpoint.</para> 825 </sect3> 826 </sect2> 827 828 <sect2 xml:id="userland"> 829 <title>Userland Changes</title> 830 831 <para revision="260177" contrib="sponsor" 832 sponsor="&netflix;">A new flag is added to &man.camcontrol.8;, 833 <literal>-b</literal>, which outputs the existing buses and 834 their parents.</para> 835 836 <para revision="262075">The &man.newsyslog.8; utility has been 837 updated to rotate files based on the actual file size instead 838 of the blocks on disk. This matches the behavior documented 839 in &man.newsyslog.conf.5;.</para> 840 841 <para revision="262384">The location of the &man.rctl.8; 842 configuration file can now be overridden in &man.rc.conf.5;. 843 To use a non-default location, set 844 <literal>rctl_rules</literal> in &man.rc.conf.5; to the 845 location of the file.</para> 846 847 <para revision="262855">The <application>ATF</application> test 848 suite has been updated to version 0.20.</para> 849 850 <para revision="263019">The <literal>libucl</literal> library 851 (Unified Configuration Library) has been merged from 852 &os;-CURRENT.</para> 853 854 <para revision="263020">The &man.pkg.7; bootstrapping utility 855 has been synced with the version in &os;-CURRENT.</para> 856 857 <para revision="263403">The &man.zfs.8; userland utility has 858 been updated to include aliases for 859 <command>snapshot</command>, which allows use of <command>zfs 860 list -t snap</command> and <command>zfs 861 snap</command>.</para> 862 863 <para revision="263405">The &man.zfs.8; userland utility has 864 been updated to include a new flag to <command>zfs 865 list</command>, <literal>-p</literal>, which when specified, 866 prints the output in a parsable format.</para> 867 868 <para revision="263783">The Blowfish password format 869 implementation updated. Support for $2b$ has 870 been added, allowing use of passwords greater than 256 871 characters long.</para> 872 873 <para revision="264497">The &man.iconv.3; library has been 874 updated to match NetBSD, providing several bug fixes.</para> 875 876 <para revision="265265">The &man.date.1; utility has been 877 updated to include a new flag, <literal>-R</literal>, which 878 prints the date and time output as specified in RFC 879 2822.</para> 880 881 <para revision="265533">The &man.bc.1; utility has been updated 882 to version 1.1, in sync with the version in OpenBSD.</para> 883 884 <para revision="265604" contrib="vendor" 885 vendor="&netflix;">The &man.pmcstat.8; utility has been 886 updated to include a new flag, <literal>-a</literal>, which 887 when specified, produces a full stack track on the sampled 888 points.</para> 889 890 <para revision="265701">The &man.netstat.8; and &man.route.8; 891 utilities have been updated to include a shorthand equivalent 892 to the <literal>-f inet</literal> and <literal>-f 893 inet6</literal> address specifiers, <literal>-4</literal> 894 and <literal>-6</literal>, respectively.</para> 895 896 <para revision="265879">The &man.crypt.3; library now defaults 897 to SHA512 for password hashing.</para> 898 899 <para revision="266014">The &man.gvinum.8; utility has been 900 updated to allow forceful configuration reset with the 901 <literal>-f</literal> flag. Additionally, a bug that would 902 prevent <literal>-f</literal> from properly creating 903 a &man.gvinum.8; configuration has been fixed.</para> 904 905 <para revision="266029">The &man.login.conf.5; file now takes 906 precedence over the shell-specific environment files. In 907 particular, the <literal>PATH</literal>, 908 <literal>BLOCKSIZE</literal> variables are commented from 909 <filename>/usr/share/skel/dot.profile</filename>, and the 910 <literal>path</literal>, <literal>BLOCKSIZE</literal>, and 911 <literal>umask</literal> variables have been commented from 912 <filename>/usr/share/skel/dot.cshrc</filename>.</para> 913 914 <para revision="266272">The &man.binmiscctl.8; userland utility 915 and related image activator features have been merged from 916 &os;-CURRENT.</para> 917 918 <para revision="266279">The &man.ps.1; utility has been 919 updated to include the <literal>-J</literal> flag, used to 920 filter output by matching &man.jail.8; IDs and names. 921 Additionally, argument <literal>0</literal> can be used to 922 <literal>-J</literal> to only list processes running on the 923 host system.</para> 924 925 <para revision="266280">The &man.top.1; utility has been updated 926 to filter by &man.jail.8; ID or name, in followup to the 927 &man.ps.1; change in <literal>r265229</literal>.</para> 928 929 <para revision="266610">The &man.gstat.8; utility has been 930 updated to include a new flag, <literal>-o</literal>. When 931 set, &man.gstat.8; will display statistics for operations 932 such as <literal>BIO_FLUSH</literal>.</para> 933 934 <para revision="266632">The &man.fetch.3; library has been 935 updated to look for root <acronym>SSL</acronym> certificates 936 in <filename class="directory">/usr/local/etc/ssl/</filename> 937 before <filename 938 class="directory">/etc/ssl/</filename>.</para> 939 940 <para revision="266715">The &man.clang.1;/llvm suite has been 941 updated to version 3.4.1.</para> 942 943 <para revision="266816">The Blowfish password format 944 has been changed to $2b$ by default.</para> 945 946 <para revision="266888">The amount of data collected for 947 &man.hwpmc.4; has been updated to work with modern processors 948 and larger amounts of available memory.</para> 949 950 <para revision="266890">The &man.pmcstat.8; utility has been 951 updated to include a new flag, <literal>-l</literal>, which 952 ends event collection after the specified number of 953 seconds.</para> 954 955 <para revision="266953">The &man.mergemaster.8; utility has 956 been updated to avoid printing 957 <quote><filename>/var/tmp/temproot</filename> 958 disappeared</quote> if there is nothing to compare.</para> 959 960 <para revision="267056">The &os; installer, &man.bsdinstall.8;, 961 has been updated to include optional 962 &man.geli.8;-encrypted or &man.gmirror.8;-mirrored swap 963 devices when installing onto a full &man.zfs.8; filesystem. 964 Additionally, the parent &man.zfs.8; dataset is now configured 965 with <literal>lz4</literal> compression enabled.</para> 966 967 <para revision="267113">The default &man.newsyslog.conf.5; now 968 includes files in the 969 <filename>/etc/newsyslog.conf.d/</filename> and 970 <filename>/usr/local/etc/newsyslog.conf.d/</filename> 971 directories by default for &man.newsyslog.8;.</para> 972 973 <para revision="267161">The &man.realpath.1; utility has been 974 updated to return <literal>ENOTDIR</literal> on paths 975 components <quote>.</quote> and <quote>..</quote> that are 976 not directories, such as <filename 977 class="directory">/dev/null/.</filename> or <filename 978 class="directory">/dev/null/..</filename>.</para> 979 980 <para revision="267236">A new flag, <quote>onifconsole</quote> 981 has been added to <filename>/etc/ttys</filename>. This allows 982 the system to provide a login prompt via serial console if the 983 device is an active kernel console, otherwise it is equivalent 984 to <literal>off</literal>.</para> 985 986 <para revision="267341">Support for legacy 987 <acronym>PCI</acronym> devices has been removed from 988 &man.bhyve.8;.</para> 989 990 <para revision="267450">The &man.bhyve.8; userland utility 991 has been updated to include SMBIOS support. A new flag has 992 been added, <literal>-U</literal>, which allows specifying the 993 UUID of the guest in the System Information structure.</para> 994 995 <para revision="267734">The &os; Project has migrated 996 from the <application>GNATS</application> bug tracking system 997 to <application>Bugzilla</application>. The &man.send-pr.1; 998 utility used for submitting problem reports has been replaced 999 with a stub shell script that instructs to use the Bugzilla 1000 web interface.</para> 1001 1002 <para revision="267747">The &man.patch.1; utility has been 1003 updated to include a <literal>--dry-run</literal> flag, which 1004 is equivalent to <literal>--check</literal> and 1005 <literal>-C</literal>.</para> 1006 1007 <para revision="267878">A bug in &man.bsdgrep.1; that would 1008 prevent patterns from being matched under certain conditions 1009 has been fixed.</para> 1010 1011 <para revision="267979">The &man.procstat.1; utility has been 1012 updated to include two new flags, <literal>-r</literal> and 1013 <literal>-H</literal>. When <literal>-r</literal> is 1014 specified, &man.procstat.1; will print current resource usage 1015 about the process(es). When <literal>-H</literal> is 1016 specified, &man.procstat.1; will print information about 1017 threads rather than the process(es).</para> 1018 1019 <note> 1020 <para>The <literal>-H</literal> flag is currently only used 1021 with <literal>-r</literal> to display resource usage for 1022 individual threads, rather than the entire process.</para> 1023 </note> 1024 1025 <para revision="268019">The &man.sed.1; utility has been 1026 updated to include a new flag, <literal>-u</literal>, which 1027 enables unbuffered output when specified.</para> 1028 1029 <para revision="268161">The &man.mkimg.1; utility has been 1030 merged from &os;-CURRENT.</para> 1031 1032 <para revision="268700" contrib="sponsor" 1033 sponsor="&spectralogic;">The &man.camcontrol.8; has been 1034 updated to include a new <literal>persist</literal> command, 1035 which allows issuing <command>SCSI PERSISTENT RESERVE 1036 IN</command> and <command>SCSI PERSISTENT RESERVE 1037 OUT</command>.</para> 1038 1039 <para revision="268791">The &man.gstat.8; utility has been 1040 updated to include a new flag, <literal>-p</literal>, which 1041 displays only physical providers when specified.</para> 1042 1043 <para revision="268903">The &man.kldstat.8; utility has been 1044 updated to allow <literal>-q</literal> to be specified when 1045 also specifying <literal>-n 1046 <replaceable>module.ko</replaceable></literal>.</para> 1047 1048 <para revision="269177">The &man.mkimg.1; utility has been 1049 updated to include support for both fixed- and 1050 dynamically-allocated images for the <acronym>VHD</acronym> 1051 and <acronym>VMDK</acronym> formats.</para> 1052 1053 <para revision="269220">The &man.random.4; entropy collection 1054 script, <filename>/usr/libexec/save-entropy</filename>, no 1055 longer runs within &man.jail.8; environments.</para> 1056 1057 <para revision="269397">The &man.bhyve.8; wrapper script, 1058 <filename>/usr/share/examples/bhyve/vmrun.sh</filename>, 1059 has been synced with &os;-CURRENT.</para> 1060 1061 <para>This update includes:</para> 1062 1063 <itemizedlist> 1064 <listitem> 1065 <para>A new flag, <literal>-e</literal>, has been added, 1066 which is used to set &man.loader.8; environment 1067 variables.</para> 1068 </listitem> 1069 1070 <listitem> 1071 <para>A new flag, <literal>-C</literal>, has been added, 1072 which is used to specify the guest console device.</para> 1073 </listitem> 1074 1075 <listitem> 1076 <para>A new flag, <literal>-H</literal>, has been added, 1077 which is used to pass the host path to 1078 &man.bhyveload.8;.</para> 1079 </listitem> 1080 1081 <listitem> 1082 <para>Support for multiple disk and &man.tap.4; devices 1083 has been added.</para> 1084 </listitem> 1085 1086 <listitem> 1087 <para>The <literal>-I</literal> flag has been 1088 removed.</para> 1089 </listitem> 1090 </itemizedlist> 1091 1092 <para revision="269398">The &man.nfsd.8; server update to 4.1, 1093 adding support for RFC5661, has merged from 1094 &os;-CURRENT.</para> 1095 1096 <para revision="269432" arch="ia64">The serial terminals 1097 <filename>ttyu0</filename> and <filename>ttyu1</filename> have 1098 been updated to <literal>onifconsole</literal> by default in 1099 &man.ttys.5;, which either can be the serial console, 1100 depending on the platform.</para> 1101 1102 <para revision="269800">The &man.ping6.8; utility has been 1103 updated to reset <literal>itimer</literal> when the maximum 1104 number of packets to send have been reached. This prevents 1105 &man.ping6.8; from exiting when the interval in set to a small 1106 value and a low number of packets to send has been 1107 specified.</para> 1108 1109 <para revision="269805">The &man.jail.8; utility has been 1110 updated to support extra &man.ifconfig.8; arguments for the 1111 <literal>ip4.addr</literal> and <literal>ip6.addr</literal> 1112 parameters. This change allows &man.carp.4; interfaces to 1113 be used within the &man.jail.8;.</para> 1114 1115 <para revision="269946">Support for generating and compiling 1116 <acronym>USDT</acronym> <application>DTrace</application> 1117 probes has been improved. <application>DTrace</application> 1118 <acronym>USDT</acronym> files are now handled similar to 1119 &man.lex.1; and &man.yacc.1; files, meaning support for 1120 handling <application>D</application> files as part of the 1121 build process is built into the <literal>SRCS</literal> 1122 &man.make.1; environment variable.</para> 1123 1124 <para revision="269968">The &man.iscsictl.8; utility has been 1125 updated to include a new flag, <literal>-M</literal>, which 1126 allows modifying the <acronym>iSCSI</acronym> session 1127 parameters without requiring the session to be removed and 1128 added back.</para> 1129 1130 <para revision="270043">The &man.mount.nfs.8; utility has been 1131 updated to support specifying the NFS version as 1132 a <literal>key=<replaceable>value</replaceable></literal> pair 1133 argument to the <literal>-o</literal> flag. For example, to 1134 specify NFS version 4, the syntax to use is 1135 <literal>-o vers=4</literal>.</para> 1136 1137 <para revision="270242" contrib="sponsor" 1138 sponsor="&spectralogic;">The &man.devd.8; client socket type 1139 has been changed to <literal>SOCK_SEQPACKET</literal>, 1140 providing sequential packet support.</para> 1141 1142 <para revision="270401">Support for the <quote>account</quote> 1143 facility has been added to the &man.pam.group.8; 1144 module.</para> 1145 1146 <sect3 xml:id="rc-scripts"> 1147 <title><filename>/etc/rc.d</filename> Scripts</title> 1148 1149 <para revision="264438">The <filename>network.subr</filename> 1150 &man.rc.8; script has been updated to loosen the requirement 1151 of listing network aliases in numeric order. Previously, 1152 a network alias of 1153 <literal>_alias<replaceable>2</replaceable></literal> 1154 would not be created if 1155 <literal>_alias<replaceable>1</replaceable></literal> was 1156 not defined.</para> 1157 1158 <para revision="268098">The &man.service.8; utility has been 1159 updated to check that the &man.rc.d.8; directory exists 1160 before traversing the directory.</para> 1161 </sect3> 1162 </sect2> 1163 1164 <sect2 xml:id="contrib"> 1165 <title>Contributed Software</title> 1166 1167 <para revision="263285">The &man.xz.1; utility has been updated 1168 to a post-5.0.5 snapshot.</para> 1169 1170 <para revision="264377"><application>OpenSSH</application> has 1171 been updated to version 6.6p1.</para> 1172 1173 <para revision="264911">The &man.nc.1; utility has been updated 1174 to match the version in OpenBSD 5.5.</para> 1175 1176 <para revision="266692"><application>Sendmail</application> 1177 has been updated to 8.14.9.</para> 1178 1179 <para revision="268515">The &man.file.1; utility and 1180 &man.libmagic.3; library have been updated to 5.19.</para> 1181 1182 <para revision="268899">The &man.byacc.1; parser has been 1183 updated to version 20140422.</para> 1184 1185 <para revision="269024" contrib="sponsor" 1186 sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has 1187 been updated to the r202189 snapshot.</para> 1188 1189 <para revision="269257">The &man.unbound.8; caching resolver and 1190 <literal>ldns</literal> have been updated to version 1191 1.4.22.</para> 1192 1193 <para revision="269686"><application>OpenSSL</application> has 1194 been updated to version 1.0.1i.</para> 1195 1196 <para revision="269847">The <quote>lite</quote> version of 1197 <application>Subversion</application> included in the 1198 &os; base system and its dependencies have been 1199 updated:</para> 1200 1201 <itemizedlist> 1202 <listitem> 1203 <para><application>apr</application> has been 1204 updated to version 1.5.1.</para> 1205 </listitem> 1206 1207 <listitem> 1208 <para><application>apr-util</application> has been 1209 updated to version 1.5.3.</para> 1210 </listitem> 1211 1212 <listitem> 1213 <para><application>serf</application> has been 1214 updated to version 1.3.7.</para> 1215 </listitem> 1216 1217 <listitem> 1218 <para><application>svnlite</application> has been 1219 updated to version 1.8.10.</para> 1220 </listitem> 1221 </itemizedlist> 1222 1223 <para revision="270026">The &man.nvi.1; editor has been 1224 update to version 2.1.2-c80f493b038.</para> 1225 1226 <para revision="270031">The &man.fparseln.3; library has 1227 been updated to version 1.7.</para> 1228 1229 <para revision="270415">The <application>lukemftpd</application> 1230 <acronym>FTP</acronym> server has been removed from the 1231 &os; base system.</para> 1232 1233 <para revision="270817">The timezone database has been updated 1234 to version tzdata2014f.</para> 1235 </sect2> 1236 1237 <sect2 xml:id="ports"> 1238 <title>Ports/Packages Collection Infrastructure</title> 1239 1240 <para> </para> 1241 1242 </sect2> 1243 1244 <sect2 xml:id="releng"> 1245 <title>Release Engineering and Integration</title> 1246 1247 <para revision="263028">The &man.services.mkdb.8; utility has 1248 been updated to include endianness awareness, allowing the 1249 <filename>services.db</filename> database to be created as 1250 part of the release build, regardless of native- or 1251 cross-built releases.</para> 1252 </sect2> 1253 1254 <sect2 xml:id="doc"> 1255 <title>Documentation</title> 1256 1257 <para> </para> 1258 1259 </sect2> 1260 </sect1> 1261 1262 <sect1 xml:id="upgrade"> 1263 <title>Upgrading from Previous Releases of &os;</title> 1264 1265 <para arch="amd64,i386">Binary upgrades between RELEASE versions 1266 (and snapshots of the various security branches) are supported 1267 using the &man.freebsd-update.8; utility. The binary upgrade 1268 procedure will update unmodified userland utilities, as well as 1269 unmodified <filename>GENERIC</filename> kernel distributed as 1270 a part of an official &os; release. The &man.freebsd-update.8; 1271 utility requires that the host being upgraded have Internet 1272 connectivity.</para> 1273 1274 <para>Source-based upgrades (those based on recompiling the &os; 1275 base system from source code) from previous versions are 1276 supported, according to the instructions in 1277 <filename>/usr/src/UPDATING</filename>.</para> 1278 1279 <important> 1280 <para>Upgrading &os; should only be attempted after 1281 backing up <emphasis>all</emphasis> data and configuration 1282 files.</para> 1283 </important> 1284 </sect1> 1285</article> 1286