article.xml revision 270551
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 270551 2014-08-25 11:46:46Z 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="260338">The 134 <literal>vfs.zfs.zio.use_uma</literal> &man.sysctl.8; has been 135 re-enabled. On multi-CPU machines with enough RAM, this can 136 easily double &man.zfs.8; performance or reduce CPU usage in 137 half. It was originally disabled due to memory and 138 <acronym>KVA</acronym> exhaustion problem reports, which 139 should be resolved due to several change in the VM 140 subsystem.</para> 141 142 <para revision="260385" contrib="sponsor" sponsor="&ix;">The 143 &man.geom.4; RAID driver has been 144 updated to support unmapped I/O.</para> 145 146 <para revision="260431">A new &man.sysctl.8;, 147 <literal>kern.panic_reboot_wait_time</literal>, has been 148 added, which allows controlling how long the system will wait 149 after &man.panic.9; before rebooting.</para> 150 151 <para revision="260857">The &man.virtio_blk.4; driver has been 152 updated to support unmapped I/O.</para> 153 154 <para revision="260858">The &man.virtio_scsi.4; driver has been 155 updated to support unmapped I/O.</para> 156 157 <para revision="262861">The &man.vt.4; driver has been merged 158 from &os;-CURRENT. To enable &man.vt.4;, enter 159 <literal>set kern.vty=vt</literal> at the &man.loader.8; 160 prompt during boot, or add <literal>kern.vty=vt</literal> to 161 &man.loader.conf.5; and reboot the system.</para> 162 163 <para revision="262967">Support for MegaRAID Fury cards has been 164 added to the &man.mfi.4; driver.</para> 165 166 <para revision="263024">The &man.aacraid.4; driver has been 167 updated to version 3.2.5.</para> 168 169 <para revision="263122">Support for &man.hwpmc.4; has been added 170 for &powerpc; 970 class processors.</para> 171 172 <para revision="263197">Support for ADT7460 and ADT7467 fan 173 controllers found in newer PowerBooks™ and 174 iBooks™ has been added to the &man.iicbus.4; 175 driver.</para> 176 177 <para revision="263256">A panic triggered by removing 178 a &man.urtwn.4; device has been fixed.</para> 179 180 <para revision="263799">A potential deadlock in the &man.usb.4; 181 stack triggered by detaching USB devices that create character 182 devices has been fixed.</para> 183 184 <para revision="263869">Support for &amd; Family 16h sensor 185 devices has been added to &man.amdtemp.4;.</para> 186 187 <para revision="264522">Support for LUN-based CD changers has 188 been removed from the &man.cd.4; driver.</para> 189 190 <para revision="264734">Support for 9th generation HP host bus 191 adapter cards has been added to &man.ciss.4;.</para> 192 193 <para revision="265388" contrib="sponsor" sponsor="&lsi;">The 194 &man.mpr.4; device has been added, 195 providing support for LSI Fusion-MPT 3 12Gb SCSI/SATA 196 controllers.</para> 197 198 <para revision="265536">The <literal>GEOM_VINUM</literal> option 199 is now able to be built both directly into the kernel or as 200 a &man.kldload.8; loadable module.</para> 201 202 <para revision="265610">The &man.uslcom.4; driver has been 203 updated to support 26 new devices.</para> 204 205 <para revision="265922" contrib="sponsor" sponsor="&lsi;">The 206 &man.mrsas.4; driver has been added, 207 providing support for LSI MegaRAID SAS controllers. The 208 &man.mfi.4; driver will attach to the controller, by default. 209 To enable &man.mrsas.4; add 210 <literal>hw.mfi.mrsas_enable=1</literal> to 211 <filename>/boot/loader.conf</filename>, which turns off 212 &man.mfi.4; device probing.</para> 213 214 <note> 215 <para>At this time, the &man.mfiutil.8; utility and 216 the &os; version of 217 <application>MegaCLI</application> and 218 <application>StorCli</application> do not work with 219 &man.mrsas.4;.</para> 220 </note> 221 222 <para revision="266165">A kernel bug that inhibited proper 223 functionality of the <literal>dev.cpu.0.freq</literal> 224 &man.sysctl.8; on &intel; processors with Turbo 225 Boost™ enabled has been fixed.</para> 226 227 <para revision="266220">The &man.geom.uncompress.4; module is 228 built by default which, similar to &man.geom.uzip.4;, 229 provides support for compressed, read-only disk 230 images.</para> 231 232 <para revision="266436">The &man.uart.4; driver has been 233 updated to include support for the &intel; Lynx Point 234 KT <acronym>AMT</acronym> serial port.</para> 235 236 <para revision="266718">A bug that would prevent 237 a &man.jail.8; from setting the correct IPv4 source address 238 with some operations that required 239 <literal>security.jail.allow_raw_sockets</literal> has been 240 fixed.</para> 241 242 <sect3 xml:id="kernel-virtualization"> 243 <title>Virtualization Support</title> 244 245 <para revision="259450">Support for µsoft; Hyper-V 246 has been added to &os;/i386 as loadable modules, however 247 not available in the <filename>GENERIC</filename> kernel 248 configuration.</para> 249 250 <para revision="261090">The &man.bhyve.4; hypervisor now 251 supports soft power-off functionality via the ACPI S5 252 state.</para> 253 </sect3> 254 255 <sect3 xml:id="kernel-arm"> 256 <title>ARM Support</title> 257 258 <para revision="259355">The <filename>WANDBOARD</filename> 259 kernel configuration file has been added.</para> 260 261 <para revision="265067">Boot devices may now be specified by 262 setting a u-boot environment variable. If a boot device is 263 not specified, the probe mechanism will be used. To specify 264 the boot device, set the 265 <literal>loaderdev=<replaceable>device</replaceable></literal> 266 u-boot environment variable.</para> 267 268 <para revision="266000">The <literal>nexus(4)</literal> driver 269 has been updated to include <quote>Flattened Device 270 Tree</quote> support, replacing the &man.fdtbus.4; driver 271 in most cases.</para> 272 273 <para revision="266105">The &man.gpioiic.4; and 274 &man.gpioled.4; have been merged from &os;-CURRENT.</para> 275 276 <para revision="266379">The <literal>ZEDBOARD</literal> kernel 277 configuration file has been updated to include 278 <acronym>SMP</acronym> support.</para> 279 </sect3> 280 281 <sect3 xml:id="boot"> 282 <title>Boot Loader Changes</title> 283 284 <para revision="262701">A kernel selection menu has been added 285 to &man.loader.8;. If the <quote>beastie menu</quote> is 286 enabled, the kernel to boot may be selected from the kernel 287 selection menu. Additional kernels may be listed in 288 &man.loader.conf.5; as a comma- or space-separated list. By 289 default, <literal>kernel</literal> and 290 <literal>kernel.old</literal> are listed.</para> 291 </sect3> 292 293 <sect3 xml:id="proc"> 294 <title>Hardware Support</title> 295 296 <para> </para> 297 298 <sect4 xml:id="mm"> 299 <title>Multimedia Support</title> 300 301 <para> </para> 302 303 </sect4> 304 305 <sect4 xml:id="net-if"> 306 <title>Network Interface Support</title> 307 308 <para revision="259453">Support for Ralink RT5370 and 309 RT5372 chipsets has been added to the &man.run.4; 310 driver.</para> 311 312 <para revision="260120">Firmware for the &man.run.4; driver 313 has been updated to version 0.33.</para> 314 315 <para revision="261868">Support for the Ralink RT3593 316 chipset has been added to the &man.run.4; driver.</para> 317 318 <para revision="261972">The &man.nve.4; driver is now 319 deprecated, and the &man.nfe.4; driver should be used 320 instead.</para> 321 322 <para revision="262137">Support for the &man.axge.4; driver 323 has been added. This driver supports the ASIX AX88178A 324 and AX88179 USB ethernet adapters. The AX88178A supports 325 USB 2.0, and the AX88179 supports USB 2.0 and 3.0.</para> 326 327 <para revision="262363">The &man.urndis.4; driver has been 328 imported from OpenBSD.</para> 329 330 <para revision="264866">Support for multiple 331 transmitter/receiver queues has been added to the 332 &man.vmx.4; driver.</para> 333 334 <note> 335 <para>The &os; guest operating system must have 336 <acronym>MSIX</acronym> enabled as a prerequisite for 337 multiple queues.</para> 338 </note> 339 340 <para revision="265345">Support for the ASUS USB-N10 Nano 341 wireless card has been added to the &man.urtwn.4; 342 driver.</para> 343 344 <para revision="266212">Transmission checksum offloading has 345 been disabled for the RTL8168C and RTL8168CP chipsets in 346 the &man.re.4; driver for TCP and UDP frames. This is 347 due to a report of UDP datagrams with IP options 348 generating corrupt frames.</para> 349 350 <para revision="266578">Preliminary support has been added 351 to the &man.urtwn.4; driver for the Realtek RTL8188EUS and 352 RTL8188ETV chipsets.</para> 353 </sect4> 354 </sect3> 355 356 <sect3 xml:id="net-proto"> 357 <title>Network Protocols</title> 358 359 <para revision="265946">Support for the UDP-Lite protocol 360 (RFC 3828) has been added to the IPv4 and IPv6 361 stacks.</para> 362 </sect3> 363 364 <sect3 xml:id="disks"> 365 <title>Disks and Storage</title> 366 367 <para revision="259328" contrib="sponsor" sponsor="&ff;">The 368 &man.geom.8; <literal>label</literal> class is now aware of 369 resized partitions. This corrects an issue where 370 <command>geom resize</command> would resize the partition, 371 but the label provider in <filename 372 class="directory">/dev/gptid/</filename> would not be 373 resized.</para> 374 375 <para revision="260502">The &man.gmirror.8; 376 utility now has a <literal>resize</literal> command, making 377 it easier to resize the size of a mirror when all of its 378 components have been replaced.</para> 379 380 <para revision="265912">The &man.geom.8; 381 <literal>GEOM_PART</literal> class has been updated to 382 support automatic partition resizing. Changes to the 383 partition size are not saved to disk until 384 <command>gpart commit</command> is run, and prior to saving, 385 can be reverted with <command>gpart undo</command>.</para> 386 387 <para revision="268091">Support for the 388 <literal>disklabel64</literal> partitioning scheme has been 389 added to &man.gpart.8;.</para> 390 391 <para revision="266594">The <literal>radeonkms(4)</literal> 392 driver has been updated to include 32-bit &man.ioctl.2; 393 support, allowing 32-bit applications to run on a 64-bit 394 system.</para> 395 </sect3> 396 397 <sect3 xml:id="fs"> 398 <title>File Systems</title> 399 400 <para revision="260178" contrib="vendor" 401 vendor="&netflix;">A new flag, <literal>-R</literal>, 402 has been added to the &man.fsck.ffs.8; utility. When used, 403 &man.fsck.ffs.8; will restart itself when too many critical 404 errors have been detected.</para> 405 406 <para revision="263407">The &man.zfs.8; filesystem has been 407 updated to implement <quote>bookmarks</quote>. See 408 &man.zfs.8; for further details.</para> 409 410 <para revision="266122">The &man.zfs.8; filesystem has been 411 updated to allow tuning the minimum <quote>ashift</quote> 412 value when creating new top-level virtual devices (vdevs). 413 To set the minimum ashift value, for example when creating 414 a &man.zpool.8; on <quote>Advanced Format</quote> drives, 415 set the <literal>vfs.zfs.min_auto_ashift</literal> 416 &man.sysctl.8; accordingly.</para> 417 418 <para revision="266612">The <literal>libzfs</literal> thread 419 pool <acronym>API</acronym> has been imported from 420 OpenSolaris, and adapted for &os;. This change allows 421 parallel disk scanning, which can reduce &man.zpool.8; 422 overall import time in some workloads.</para> 423 </sect3> 424 </sect2> 425 426 <sect2 xml:id="userland"> 427 <title>Userland Changes</title> 428 429 <para revision="260177" contrib="sponsor" 430 sponsor="&netflix;">A new flag is added to &man.camcontrol.8;, 431 <literal>-b</literal>, which outputs the existing buses and 432 their parents.</para> 433 434 <para revision="262075">The &man.newsyslog.8; utility has been 435 updated to rotate files based on the actual file size instead 436 of the blocks on disk. This matches the behavior documented 437 in &man.newsyslog.conf.5;.</para> 438 439 <para revision="262384">The location of the &man.rctl.8; 440 configuration file can now be overridden in &man.rc.conf.5;. 441 To use a non-default location, set 442 <literal>rctl_rules</literal> in &man.rc.conf.5; to the 443 location of the file.</para> 444 445 <para revision="262855">The <application>ATF</application> test 446 suite has been updated to version 0.20.</para> 447 448 <para revision="263019">The <literal>libucl</literal> library 449 (Unified Configuration Library) has been merged from 450 &os;-CURRENT.</para> 451 452 <para revision="263020">The &man.pkg.7; bootstrapping utility 453 has been synced with the version in &os;-CURRENT.</para> 454 455 <para revision="263403">The &man.zfs.8; userland utility has 456 been updated to include aliases for 457 <command>snapshot</command>, which allows use of <command>zfs 458 list -t snap</command> and <command>zfs 459 snap</command>.</para> 460 461 <para revision="263405">The &man.zfs.8; userland utility has 462 been updated to include a new flag to <command>zfs 463 list</command>, <literal>-p</literal>, which when specified, 464 prints the output in a parsable format.</para> 465 466 <para revision="263783">The Blowfish password format 467 implementation updated. Support for $2b$ has 468 been added, allowing use of passwords greater than 256 469 characters long.</para> 470 471 <para revision="264497">The &man.iconv.3; library has been 472 updated to match NetBSD, providing several bug fixes.</para> 473 474 <para revision="265265">The &man.date.1; utility has been 475 updated to include a new flag, <literal>-R</literal>, which 476 prints the date and time output as specified in RFC 477 2822.</para> 478 479 <para revision="265533">The &man.bc.1; utility has been updated 480 to version 1.1, in sync with the version in OpenBSD.</para> 481 482 <para revision="265604" contrib="vendor" 483 vendor="&netflix;">The &man.pmcstat.8; utility has been 484 updated to include a new flag, <literal>-a</literal>, which 485 when specified, produces a full stack track on the sampled 486 points.</para> 487 488 <para revision="265701">The &man.netstat.8; and &man.route.8; 489 utilities have been updated to include a shorthand equivalent 490 to the <literal>-f inet</literal> and <literal>-f 491 inet6</literal> address specifiers, <literal>-4</literal> 492 and <literal>-6</literal>, respectively.</para> 493 494 <para revision="265879">The &man.crypt.3; library now defaults 495 to SHA512 for password hashing.</para> 496 497 <para revision="266014">The &man.gvinum.8; utility has been 498 updated to allow forceful configuration reset with the 499 <literal>-f</literal> flag. Additionally, a bug that would 500 prevent <literal>-f</literal> from properly creating 501 a &man.gvinum.8; configuration has been fixed.</para> 502 503 <para revision="266029">The &man.login.conf.5; file now takes 504 precedence over the shell-specific environment files. In 505 particular, the <literal>PATH</literal>, 506 <literal>BLOCKSIZE</literal> variables are commented from 507 <filename>/usr/share/skel/dot.profile</filename>, and the 508 <literal>path</literal>, <literal>BLOCKSIZE</literal>, and 509 <literal>umask</literal> variables have been commented from 510 <filename>/usr/share/skel/dot.cshrc</filename>.</para> 511 512 <para revision="266272">The &man.binmiscctl.8; userland utility 513 and related image activator features have been merged from 514 &os;-CURRENT.</para> 515 516 <para revision="266279">The &man.ps.1; utility has been 517 updated to include the <literal>-J</literal> flag, used to 518 filter output by matching &man.jail.8; IDs and names. 519 Additionally, argument <literal>0</literal> can be used to 520 <literal>-J</literal> to only list processes running on the 521 host system.</para> 522 523 <para revision="266280">The &man.top.1; utility has been updated 524 to filter by &man.jail.8; ID or name, in followup to the 525 &man.ps.1; change in <literal>r265229</literal>.</para> 526 527 <para revision="266610">The &man.gstat.8; utility has been 528 updated to include a new flag, <literal>-o</literal>. When 529 set, &man.gstat.8; will display statistics for operations 530 such as <literal>BIO_FLUSH</literal>.</para> 531 532 <para revision="266632">The &man.fetch.3; library has been 533 updated to look for root <acronym>SSL</acronym> certificates 534 in <filename class="directory">/usr/local/etc/ssl/</filename> 535 before <filename 536 class="directory">/etc/ssl/</filename>.</para> 537 538 <para revision="266715">The &man.clang.1;/llvm suite has been 539 updated to version 3.4.1.</para> 540 541 <para revision="266816">The Blowfish password format 542 has been changed to $2b$ by default.</para> 543 544 <para revision="266888">The amount of data collected for 545 &man.hwpmc.4; has been updated to work with modern processors 546 and larger amounts of available memory.</para> 547 548 <para revision="266890">The &man.pmcstat.8; utility has been 549 updated to include a new flag, <literal>-l</literal>, which 550 ends event collection after the specified number of 551 seconds.</para> 552 553 <para revision="267113">The default &man.newsyslog.conf.5; now 554 includes files in the 555 <filename>/etc/newsyslog.conf.d/</filename> and 556 <filename>/usr/local/etc/newsyslog.conf.d/</filename> 557 directories by default for &man.newsyslog.8;.</para> 558 559 <para revision="267236">A new flag, <quote>onifconsole</quote> 560 has been added to <filename>/etc/ttys</filename>. This allows 561 the system to provide a login prompt via serial console if the 562 device is an active kernel console, otherwise it is equivalent 563 to <literal>off</literal>.</para> 564 565 <para revision="268161">The &man.mkimg.1; utility has been 566 merged from &os;-CURRENT.</para> 567 568 <sect3 xml:id="rc-scripts"> 569 <title><filename>/etc/rc.d</filename> Scripts</title> 570 571 <para revision="264438">The <filename>network.subr</filename> 572 &man.rc.8; script has been updated to loosen the requirement 573 of listing network aliases in numeric order. Previously, 574 a network alias of 575 <literal>_alias<replaceable>2</replaceable></literal> 576 would not be created if 577 <literal>_alias<replaceable>1</replaceable></literal> was 578 not defined.</para> 579 </sect3> 580 </sect2> 581 582 <sect2 xml:id="contrib"> 583 <title>Contributed Software</title> 584 585 <para revision="263285">The &man.xz.1; utility has been updated 586 to a post-5.0.5 snapshot.</para> 587 588 <para revision="263369" contrib="sponsor" 589 sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has 590 been updated to the r196322 snapshot.</para> 591 592 <para revision="264377"><application>OpenSSH</application> has 593 been updated to version 6.6p1.</para> 594 595 <para revision="264911">The &man.nc.1; utility has been updated 596 to match the version in OpenBSD 5.5.</para> 597 598 <para revision="265983">The timezone database has been updated 599 to version tzdata2014c.</para> 600 601 <para revision="266692"><application>Sendmail</application> 602 has been updated to 8.14.9.</para> 603 604 <para revision="267258"><application>OpenSSL</application> has 605 been updated to version 1.0.1h.</para> 606 </sect2> 607 608 <sect2 xml:id="ports"> 609 <title>Ports/Packages Collection Infrastructure</title> 610 611 <para> </para> 612 613 </sect2> 614 615 <sect2 xml:id="releng"> 616 <title>Release Engineering and Integration</title> 617 618 <para revision="263028">The &man.services.mkdb.8; utility has 619 been updated to include endianness awareness, allowing the 620 <filename>services.db</filename> database to be created as 621 part of the release build, regardless of native- or 622 cross-built releases.</para> 623 </sect2> 624 625 <sect2 xml:id="doc"> 626 <title>Documentation</title> 627 628 <para> </para> 629 630 </sect2> 631 </sect1> 632 633 <sect1 xml:id="upgrade"> 634 <title>Upgrading from Previous Releases of &os;</title> 635 636 <para arch="amd64,i386">Binary upgrades between RELEASE versions 637 (and snapshots of the various security branches) are supported 638 using the &man.freebsd-update.8; utility. The binary upgrade 639 procedure will update unmodified userland utilities, as well as 640 unmodified GENERIC or SMP kernels distributed as a part of an 641 official &os; release. The &man.freebsd-update.8; utility 642 requires that the host being upgraded have Internet 643 connectivity.</para> 644 645 <para>Source-based upgrades (those based on recompiling the &os; 646 base system from source code) from previous versions are 647 supported, according to the instructions in 648 <filename>/usr/src/UPDATING</filename>.</para> 649 650 <important> 651 <para>Upgrading &os; should only be attempted after 652 backing up <emphasis>all</emphasis> data and configuration 653 files.</para> 654 </important> 655 </sect1> 656</article> 657