article.xml revision 270554
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 270554 2014-08-25 13:15:17Z 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 <para revision="266911">The &man.hwpmc.4; driver has been 243 updated to support core events from the Atom™ 244 Silvermont architecture.</para> 245 246 <sect3 xml:id="kernel-virtualization"> 247 <title>Virtualization Support</title> 248 249 <para revision="259450">Support for µsoft; Hyper-V 250 has been added to &os;/i386 as loadable modules, however 251 not available in the <filename>GENERIC</filename> kernel 252 configuration.</para> 253 254 <para revision="261090">The &man.bhyve.4; hypervisor now 255 supports soft power-off functionality via the ACPI S5 256 state.</para> 257 </sect3> 258 259 <sect3 xml:id="kernel-arm"> 260 <title>ARM Support</title> 261 262 <para revision="259355">The <filename>WANDBOARD</filename> 263 kernel configuration file has been added.</para> 264 265 <para revision="265067">Boot devices may now be specified by 266 setting a u-boot environment variable. If a boot device is 267 not specified, the probe mechanism will be used. To specify 268 the boot device, set the 269 <literal>loaderdev=<replaceable>device</replaceable></literal> 270 u-boot environment variable.</para> 271 272 <para revision="266000">The <literal>nexus(4)</literal> driver 273 has been updated to include <quote>Flattened Device 274 Tree</quote> support, replacing the &man.fdtbus.4; driver 275 in most cases.</para> 276 277 <para revision="266105">The &man.gpioiic.4; and 278 &man.gpioled.4; have been merged from &os;-CURRENT.</para> 279 280 <para revision="266379">The <literal>ZEDBOARD</literal> kernel 281 configuration file has been updated to include 282 <acronym>SMP</acronym> support.</para> 283 </sect3> 284 285 <sect3 xml:id="boot"> 286 <title>Boot Loader Changes</title> 287 288 <para revision="262701">A kernel selection menu has been added 289 to &man.loader.8;. If the <quote>beastie menu</quote> is 290 enabled, the kernel to boot may be selected from the kernel 291 selection menu. Additional kernels may be listed in 292 &man.loader.conf.5; as a comma- or space-separated list. By 293 default, <literal>kernel</literal> and 294 <literal>kernel.old</literal> are listed.</para> 295 </sect3> 296 297 <sect3 xml:id="proc"> 298 <title>Hardware Support</title> 299 300 <para> </para> 301 302 <sect4 xml:id="mm"> 303 <title>Multimedia Support</title> 304 305 <para> </para> 306 307 </sect4> 308 309 <sect4 xml:id="net-if"> 310 <title>Network Interface Support</title> 311 312 <para revision="259453">Support for Ralink RT5370 and 313 RT5372 chipsets has been added to the &man.run.4; 314 driver.</para> 315 316 <para revision="260120">Firmware for the &man.run.4; driver 317 has been updated to version 0.33.</para> 318 319 <para revision="261868">Support for the Ralink RT3593 320 chipset has been added to the &man.run.4; driver.</para> 321 322 <para revision="261972">The &man.nve.4; driver is now 323 deprecated, and the &man.nfe.4; driver should be used 324 instead.</para> 325 326 <para revision="262137">Support for the &man.axge.4; driver 327 has been added. This driver supports the ASIX AX88178A 328 and AX88179 USB ethernet adapters. The AX88178A supports 329 USB 2.0, and the AX88179 supports USB 2.0 and 3.0.</para> 330 331 <para revision="262363">The &man.urndis.4; driver has been 332 imported from OpenBSD.</para> 333 334 <para revision="264866">Support for multiple 335 transmitter/receiver queues has been added to the 336 &man.vmx.4; driver.</para> 337 338 <note> 339 <para>The &os; guest operating system must have 340 <acronym>MSIX</acronym> enabled as a prerequisite for 341 multiple queues.</para> 342 </note> 343 344 <para revision="265345">Support for the ASUS USB-N10 Nano 345 wireless card has been added to the &man.urtwn.4; 346 driver.</para> 347 348 <para revision="266212">Transmission checksum offloading has 349 been disabled for the RTL8168C and RTL8168CP chipsets in 350 the &man.re.4; driver for TCP and UDP frames. This is 351 due to a report of UDP datagrams with IP options 352 generating corrupt frames.</para> 353 354 <para revision="266578">Preliminary support has been added 355 to the &man.urtwn.4; driver for the Realtek RTL8188EUS and 356 RTL8188ETV chipsets.</para> 357 </sect4> 358 </sect3> 359 360 <sect3 xml:id="net-proto"> 361 <title>Network Protocols</title> 362 363 <para revision="265946">Support for the UDP-Lite protocol 364 (RFC 3828) has been added to the IPv4 and IPv6 365 stacks.</para> 366 </sect3> 367 368 <sect3 xml:id="disks"> 369 <title>Disks and Storage</title> 370 371 <para revision="259328" contrib="sponsor" sponsor="&ff;">The 372 &man.geom.8; <literal>label</literal> class is now aware of 373 resized partitions. This corrects an issue where 374 <command>geom resize</command> would resize the partition, 375 but the label provider in <filename 376 class="directory">/dev/gptid/</filename> would not be 377 resized.</para> 378 379 <para revision="260502">The &man.gmirror.8; 380 utility now has a <literal>resize</literal> command, making 381 it easier to resize the size of a mirror when all of its 382 components have been replaced.</para> 383 384 <para revision="265912">The &man.geom.8; 385 <literal>GEOM_PART</literal> class has been updated to 386 support automatic partition resizing. Changes to the 387 partition size are not saved to disk until 388 <command>gpart commit</command> is run, and prior to saving, 389 can be reverted with <command>gpart undo</command>.</para> 390 391 <para revision="268091">Support for the 392 <literal>disklabel64</literal> partitioning scheme has been 393 added to &man.gpart.8;.</para> 394 395 <para revision="266594">The <literal>radeonkms(4)</literal> 396 driver has been updated to include 32-bit &man.ioctl.2; 397 support, allowing 32-bit applications to run on a 64-bit 398 system.</para> 399 </sect3> 400 401 <sect3 xml:id="fs"> 402 <title>File Systems</title> 403 404 <para revision="260178" contrib="vendor" 405 vendor="&netflix;">A new flag, <literal>-R</literal>, 406 has been added to the &man.fsck.ffs.8; utility. When used, 407 &man.fsck.ffs.8; will restart itself when too many critical 408 errors have been detected.</para> 409 410 <para revision="263407">The &man.zfs.8; filesystem has been 411 updated to implement <quote>bookmarks</quote>. See 412 &man.zfs.8; for further details.</para> 413 414 <para revision="266122">The &man.zfs.8; filesystem has been 415 updated to allow tuning the minimum <quote>ashift</quote> 416 value when creating new top-level virtual devices (vdevs). 417 To set the minimum ashift value, for example when creating 418 a &man.zpool.8; on <quote>Advanced Format</quote> drives, 419 set the <literal>vfs.zfs.min_auto_ashift</literal> 420 &man.sysctl.8; accordingly.</para> 421 422 <para revision="266612">The <literal>libzfs</literal> thread 423 pool <acronym>API</acronym> has been imported from 424 OpenSolaris, and adapted for &os;. This change allows 425 parallel disk scanning, which can reduce &man.zpool.8; 426 overall import time in some workloads.</para> 427 </sect3> 428 </sect2> 429 430 <sect2 xml:id="userland"> 431 <title>Userland Changes</title> 432 433 <para revision="260177" contrib="sponsor" 434 sponsor="&netflix;">A new flag is added to &man.camcontrol.8;, 435 <literal>-b</literal>, which outputs the existing buses and 436 their parents.</para> 437 438 <para revision="262075">The &man.newsyslog.8; utility has been 439 updated to rotate files based on the actual file size instead 440 of the blocks on disk. This matches the behavior documented 441 in &man.newsyslog.conf.5;.</para> 442 443 <para revision="262384">The location of the &man.rctl.8; 444 configuration file can now be overridden in &man.rc.conf.5;. 445 To use a non-default location, set 446 <literal>rctl_rules</literal> in &man.rc.conf.5; to the 447 location of the file.</para> 448 449 <para revision="262855">The <application>ATF</application> test 450 suite has been updated to version 0.20.</para> 451 452 <para revision="263019">The <literal>libucl</literal> library 453 (Unified Configuration Library) has been merged from 454 &os;-CURRENT.</para> 455 456 <para revision="263020">The &man.pkg.7; bootstrapping utility 457 has been synced with the version in &os;-CURRENT.</para> 458 459 <para revision="263403">The &man.zfs.8; userland utility has 460 been updated to include aliases for 461 <command>snapshot</command>, which allows use of <command>zfs 462 list -t snap</command> and <command>zfs 463 snap</command>.</para> 464 465 <para revision="263405">The &man.zfs.8; userland utility has 466 been updated to include a new flag to <command>zfs 467 list</command>, <literal>-p</literal>, which when specified, 468 prints the output in a parsable format.</para> 469 470 <para revision="263783">The Blowfish password format 471 implementation updated. Support for $2b$ has 472 been added, allowing use of passwords greater than 256 473 characters long.</para> 474 475 <para revision="264497">The &man.iconv.3; library has been 476 updated to match NetBSD, providing several bug fixes.</para> 477 478 <para revision="265265">The &man.date.1; utility has been 479 updated to include a new flag, <literal>-R</literal>, which 480 prints the date and time output as specified in RFC 481 2822.</para> 482 483 <para revision="265533">The &man.bc.1; utility has been updated 484 to version 1.1, in sync with the version in OpenBSD.</para> 485 486 <para revision="265604" contrib="vendor" 487 vendor="&netflix;">The &man.pmcstat.8; utility has been 488 updated to include a new flag, <literal>-a</literal>, which 489 when specified, produces a full stack track on the sampled 490 points.</para> 491 492 <para revision="265701">The &man.netstat.8; and &man.route.8; 493 utilities have been updated to include a shorthand equivalent 494 to the <literal>-f inet</literal> and <literal>-f 495 inet6</literal> address specifiers, <literal>-4</literal> 496 and <literal>-6</literal>, respectively.</para> 497 498 <para revision="265879">The &man.crypt.3; library now defaults 499 to SHA512 for password hashing.</para> 500 501 <para revision="266014">The &man.gvinum.8; utility has been 502 updated to allow forceful configuration reset with the 503 <literal>-f</literal> flag. Additionally, a bug that would 504 prevent <literal>-f</literal> from properly creating 505 a &man.gvinum.8; configuration has been fixed.</para> 506 507 <para revision="266029">The &man.login.conf.5; file now takes 508 precedence over the shell-specific environment files. In 509 particular, the <literal>PATH</literal>, 510 <literal>BLOCKSIZE</literal> variables are commented from 511 <filename>/usr/share/skel/dot.profile</filename>, and the 512 <literal>path</literal>, <literal>BLOCKSIZE</literal>, and 513 <literal>umask</literal> variables have been commented from 514 <filename>/usr/share/skel/dot.cshrc</filename>.</para> 515 516 <para revision="266272">The &man.binmiscctl.8; userland utility 517 and related image activator features have been merged from 518 &os;-CURRENT.</para> 519 520 <para revision="266279">The &man.ps.1; utility has been 521 updated to include the <literal>-J</literal> flag, used to 522 filter output by matching &man.jail.8; IDs and names. 523 Additionally, argument <literal>0</literal> can be used to 524 <literal>-J</literal> to only list processes running on the 525 host system.</para> 526 527 <para revision="266280">The &man.top.1; utility has been updated 528 to filter by &man.jail.8; ID or name, in followup to the 529 &man.ps.1; change in <literal>r265229</literal>.</para> 530 531 <para revision="266610">The &man.gstat.8; utility has been 532 updated to include a new flag, <literal>-o</literal>. When 533 set, &man.gstat.8; will display statistics for operations 534 such as <literal>BIO_FLUSH</literal>.</para> 535 536 <para revision="266632">The &man.fetch.3; library has been 537 updated to look for root <acronym>SSL</acronym> certificates 538 in <filename class="directory">/usr/local/etc/ssl/</filename> 539 before <filename 540 class="directory">/etc/ssl/</filename>.</para> 541 542 <para revision="266715">The &man.clang.1;/llvm suite has been 543 updated to version 3.4.1.</para> 544 545 <para revision="266816">The Blowfish password format 546 has been changed to $2b$ by default.</para> 547 548 <para revision="266888">The amount of data collected for 549 &man.hwpmc.4; has been updated to work with modern processors 550 and larger amounts of available memory.</para> 551 552 <para revision="266890">The &man.pmcstat.8; utility has been 553 updated to include a new flag, <literal>-l</literal>, which 554 ends event collection after the specified number of 555 seconds.</para> 556 557 <para revision="266953">The &man.mergemaster.8; utility has 558 been updated to avoid printing 559 <quote><filename>/var/tmp/temproot</filename> 560 disappeared</quote> if there is nothing to compare.</para> 561 562 <para revision="267113">The default &man.newsyslog.conf.5; now 563 includes files in the 564 <filename>/etc/newsyslog.conf.d/</filename> and 565 <filename>/usr/local/etc/newsyslog.conf.d/</filename> 566 directories by default for &man.newsyslog.8;.</para> 567 568 <para revision="267236">A new flag, <quote>onifconsole</quote> 569 has been added to <filename>/etc/ttys</filename>. This allows 570 the system to provide a login prompt via serial console if the 571 device is an active kernel console, otherwise it is equivalent 572 to <literal>off</literal>.</para> 573 574 <para revision="268161">The &man.mkimg.1; utility has been 575 merged from &os;-CURRENT.</para> 576 577 <sect3 xml:id="rc-scripts"> 578 <title><filename>/etc/rc.d</filename> Scripts</title> 579 580 <para revision="264438">The <filename>network.subr</filename> 581 &man.rc.8; script has been updated to loosen the requirement 582 of listing network aliases in numeric order. Previously, 583 a network alias of 584 <literal>_alias<replaceable>2</replaceable></literal> 585 would not be created if 586 <literal>_alias<replaceable>1</replaceable></literal> was 587 not defined.</para> 588 </sect3> 589 </sect2> 590 591 <sect2 xml:id="contrib"> 592 <title>Contributed Software</title> 593 594 <para revision="263285">The &man.xz.1; utility has been updated 595 to a post-5.0.5 snapshot.</para> 596 597 <para revision="263369" contrib="sponsor" 598 sponsor="&darpa_afrl;">The &man.lldb.1; debugging library has 599 been updated to the r196322 snapshot.</para> 600 601 <para revision="264377"><application>OpenSSH</application> has 602 been updated to version 6.6p1.</para> 603 604 <para revision="264911">The &man.nc.1; utility has been updated 605 to match the version in OpenBSD 5.5.</para> 606 607 <para revision="265983">The timezone database has been updated 608 to version tzdata2014c.</para> 609 610 <para revision="266692"><application>Sendmail</application> 611 has been updated to 8.14.9.</para> 612 613 <para revision="267258"><application>OpenSSL</application> has 614 been updated to version 1.0.1h.</para> 615 </sect2> 616 617 <sect2 xml:id="ports"> 618 <title>Ports/Packages Collection Infrastructure</title> 619 620 <para> </para> 621 622 </sect2> 623 624 <sect2 xml:id="releng"> 625 <title>Release Engineering and Integration</title> 626 627 <para revision="263028">The &man.services.mkdb.8; utility has 628 been updated to include endianness awareness, allowing the 629 <filename>services.db</filename> database to be created as 630 part of the release build, regardless of native- or 631 cross-built releases.</para> 632 </sect2> 633 634 <sect2 xml:id="doc"> 635 <title>Documentation</title> 636 637 <para> </para> 638 639 </sect2> 640 </sect1> 641 642 <sect1 xml:id="upgrade"> 643 <title>Upgrading from Previous Releases of &os;</title> 644 645 <para arch="amd64,i386">Binary upgrades between RELEASE versions 646 (and snapshots of the various security branches) are supported 647 using the &man.freebsd-update.8; utility. The binary upgrade 648 procedure will update unmodified userland utilities, as well as 649 unmodified GENERIC or SMP kernels distributed as a part of an 650 official &os; release. The &man.freebsd-update.8; utility 651 requires that the host being upgraded have Internet 652 connectivity.</para> 653 654 <para>Source-based upgrades (those based on recompiling the &os; 655 base system from source code) from previous versions are 656 supported, according to the instructions in 657 <filename>/usr/src/UPDATING</filename>.</para> 658 659 <important> 660 <para>Upgrading &os; should only be attempted after 661 backing up <emphasis>all</emphasis> data and configuration 662 files.</para> 663 </important> 664 </sect1> 665</article> 666