UPDATING

   1 # Updating Information for DragonFly users.
   2 #
   3 #
   4 # This file should warn you of any pitfalls which you might need to work around
   5 # when trying to update your DragonFly system.  The information below is
   6 # in reverse-time order, with the latest information at the top.
   7 #
   8 # If you discover any problem, please contact the bugs@lists.dragonflybsd.org
   9 # mailing list with the details.
  10
  11 +-----------------------------------------------------------------------+
  12 +         UPGRADING DRAGONFLY FROM 5.2 TO LATER VERSIONS                +
  13 +-----------------------------------------------------------------------+
  14
  15 DIGI, RP AND SI DRIVERS REMOVED
  16 -------------------------------
  17
  18 The digi(4), rp(4) and si(4) serial drivers have been removed. None of
  19 them were in our default kernel configuration file. The sicontrol(8)
  20 utility was removed, too.
  21
  22 MKINITRD COMMAND REMOVED
  23 ------------------------
  24
  25 The mkinitrd(8) command is removed and its functionality is replaced by
  26 the new "initrd" make target.  After rebooting into the new world and
  27 verifying everything works, execute "make initrd" to upgrade the rescue
  28 tools and initrd image.
  29
  30 IPSEC, IPSEC_ESP AND IPSEC_DEBUG REMOVED FROM VKERNEL64 CONFIG
  31 --------------------------------------------------------------
  32
  33 IPsec has been removed from the system. Of our standard kernel
  34 configurations, only the virtual kernel one had it. People running
  35 vkernels with configuration files derived from our VKERNEL64 will
  36 have to remove these options manually.
  37
  38 +-----------------------------------------------------------------------+
  39 +         UPGRADING DRAGONFLY FROM 5.0 TO LATER VERSIONS                +
  40 +-----------------------------------------------------------------------+
  41
  42 VIRTIO_PCI REMOVED FROM KERNEL CONFIG
  43 -------------------------------------
  44
  45 The "device virtio_pci" line in X86_64_GENERIC has been removed. People
  46 with configuration files derived from it have to remove it manually.
  47
  48 VARIOUS 'R' COMMANDS AND DAEMONS REMOVED
  49 ----------------------------------------
  50
  51 rcp(1), rlogin(1), rlogind(8), rsh(1) and rshd(8) have been removed.
  52 For those that still need them, there is the net/bsdrcmds port.
  53
  54 VARIOUS FORMER OPTIONS REMOVED
  55 ------------------------------
  56
  57 Various former kernel configuration options which had been no-ops for
  58 some time were completely removed: SYSVMSG, SYSVSEM, SYSVSHM, P1003_1B,
  59 _KPOSIX_VERSION and DSCHED_FQ. Users that have any of these still in
  60 their kernel configuration files have to remove them.
  61
  62 BOOTSTRAPPING LIMITED FROM PRE 4.4
  63 ----------------------------------
  64
  65 Upgrading to 5.1 and later versions now require at least 4.4 in
  66 preparations for upcoming base compilers updates.
  67
  68 IF_PPP, PPPD, IF_FAITH, AND FAITHD REMOVED
  69 ------------------------------------------
  70
  71 if_ppp has been replaced by "user ppp", i.e. ppp(8) and tun(4). It had
  72 already been removed from our default kernel configuration before 5.0,
  73 so only people with custom configurations based on earlier X86_64_GENERIC
  74 will have to remove it manually.
  75
  76 The faith(4) interface has been completely removed after it had also
  77 been removed from our default kernel configuration.
  78
  79 +-----------------------------------------------------------------------+
  80 +         UPGRADING DRAGONFLY FROM 4.8 TO LATER VERSIONS                +
  81 +-----------------------------------------------------------------------+
  82
  83 FFS_ROOT OPTION DISABLED
  84 ------------------------
  85
  86 The FFS_ROOT option has been made a no-op and will be completely removed
  87 at some point in the future. Users with a custom kernel configuration
  88 can remove this option from it now.
  89
  90 +-----------------------------------------------------------------------+
  91 +         UPGRADING DRAGONFLY FROM 4.6 TO LATER VERSIONS                +
  92 +-----------------------------------------------------------------------+
  93
  94 DSA OPENSSH KEYS DEPRECATED
  95 ---------------------------
  96
  97 Note that DSA OpenSSH keys were deprecated in the 4.6 to 4.8 release.
  98 If you are upgrading from a release older than 4.8 and use DSA OpenSSH
  99 keys, please update your private/public key pair or risk locking
 100 yourself out.
 101
 102 AHC, AHD, AIC, NCV, NSP AND STG DRIVERS REMOVED
 103 -----------------------------------------------
 104
 105 They were all in our X86_64_GENERIC kernel configuration file, along with
 106 the AHC_REG_PRETTY_PRINT and AHD_REG_PRETTY_PRINT options, so any custom
 107 configuration files derived from it need adjustment.
 108
 109 PORTAL FILE SYSTEM REMOVED
 110 --------------------------
 111
 112 It has been broken for a long time now.
 113
 114 BINUTILS 2.27 REPLACES 2.24, PRIMARY
 115 ------------------------------------
 116
 117 The oldest of the two versions of Binutils, version 2.24, was removed
 118 and replaced with Binutils 2.27.  It becomes the primary version version
 119 of binutils and version 2.25 becomes the alternate.
 120
 121 The accepted values of BINUTILSVER are now "binutils227" (default) and
 122 "binutils225".  The building of Binutils 2.25 can be prevented by setting
 123 NO_ALTBINUTILS=yes in make.conf.
 124
 125 COMPAT_43 KERNEL OPTION REMOVED
 126 -------------------------------
 127
 128 It was commented out in our default configs for several years now, but
 129 might still be present in custom configs created before Nov. 2011.
 130
 131 OPENSSL REMOVED
 132 ---------------
 133
 134 OpenSSL has been removed from base and replaced with a private version of
 135 LibreSSL.  The previously installed OpenSSL libraries, headers, and man
 136 pages will remain on the system unless the "make upgrade" command is
 137 specifically instructed to remove them.  To do this, define
 138 REMOVE_OPENSSL_FILES for the upgrade command, e.g.
 139 "make upgrade REMOVE_OPENSSL_FILES=yes"
 140
 141 28-Oct-2016: openssl has been replaced by ressl.  It is recommended that any
 142 stale OpenSSL files be removed to avoid configuration scripts from using
 143 the stale and potentially vulnerable version, but all binaries that are
 144 dynamically linked to the OpenSSL libraries should be rebuilt first to
 145 avoid breakage.
 146
 147 OPENSSH HPN REMOVED
 148 -------------------
 149
 150 It has become too cumbersome to maintain HPN patches in OpenSSH in base.
 151 To use OpenSSH in base remove HPN config, if you have added it.
 152 Check files below for HPN config, see a few lines below.
 153   /etc/ssh/ssh_config, /etc/ssh/sshd_config, ~/.ssh/config
 154 sshd(8) will fail to start if HPN config is used.
 155
 156 NOTE: HPN config in sshd_config will prohibit remote access to host using ssh.
 157
 158 HPN config:
 159 HPNDisabled
 160 HPNBufferSize
 161 TcpRcvBuf
 162 TcpRcvBufPoll
 163 NoneEnabled
 164 NoneSwitch
 165 cipher MTR-AES-CTR
 166 cipher NONE
 167
 168 OpenSSH HPN is a patch set to OpenSSH providing higher performance under some
 169 circumstances, especially for networking.
 170 If HPN functionality is needed, install security/openssh from dports.
 171
 172 CS, EX AND VX DRIVERS REMOVED
 173 -----------------------------
 174
 175 The cs(4), ex(4) and vx(4) drivers have been removed. They were very
 176 old and its doubtful they ever worked properly in x86_64 but they were
 177 in X86_64_GENERIC, so custom configurations derived from it have to be
 178 adjusted.
 179
 180 +-----------------------------------------------------------------------+
 181 +         UPGRADING DRAGONFLY FROM 4.4 TO LATER VERSIONS                +
 182 +-----------------------------------------------------------------------+
 183
 184 AMD REMOVED
 185 -----------
 186
 187 The am-utils automounter suite has been removed. It stopped working
 188 at some point and was never fixed. autofs(5) and the associated
 189 userland has been brought in from FreeBSD and replaces it.
 190
 191 AN DRIVER REMOVED
 192 -----------------
 193
 194 The an(4) driver has been removed. It was in the X86_64_GENERIC kernel
 195 config file, so any configurations derived from it have to be adjusted.
 196
 197 /DEV/DRI GROUP CHANGED
 198 ----------------------
 199
 200 The default group assigned to /dev/dri entries has been changed
 201 from 'wheel' to 'video' with the id of '44'. If you want to have
 202 access to the dri devices please add yourself to the video group
 203 with:
 204
 205 # pw groupmod video -m $USER
 206
 207 +-----------------------------------------------------------------------+
 208 +         UPGRADING DRAGONFLY FROM 4.2 TO LATER VERSIONS                +
 209 +-----------------------------------------------------------------------+
 210
 211 DSCHED REMOVED
 212 --------------
 213
 214 dsched(4) has been removed and one of its kernel options, DSCHED_FQ, was
 215 in our default kernel config file. So the DSCHED_FQ option has been turned
 216 into a no-op for now and can be removed from custom configurations.
 217
 218 EST DRIVER REMOVED, COMPILE_ET AND LIBCOM_ERR TOO
 219 -------------------------------------------------
 220
 221 The est(4) driver has been removed. All CPUs it supported (except one)
 222 were 32 bits only. Those who are still using the Core 2 Duo T7500 should
 223 report back if there are any issues with this CPU and our regular ACPI
 224 P-state support.
 225
 226 Also, compile_et(1) and com_err(3) have been removed as well. They
 227 should have been removed along with kerberos support, back in 2009.
 228
 229 SEVERAL LOCALES RENAMED
 230 -----------------------
 231
 232 Several locales were using obsolete and misleading names, and thus have
 233 been adjusted to current standards. Any users of the following locales
 234 need to select alternates:
 235
 236 DFLY 4.2 locale            DFLY 4.4 alterative locale
 237 ---------------            ------------------------------------
 238 mn_MN.UTF-8                mn_Cyrl_MN.UTF-8
 239 no_NO.UTF-8                nb_NO.UTF-8      or nn_NO.UTF-8
 240 no_NO.ISO8859-1            nb_NO.ISO8869-1  or nn_NO.ISO8859-1
 241 no_NO.ISO8859-15           nb_NO.ISO8859-15 or nn_NO.ISO8859-15
 242 sr_YU.UTF-8                sr_Cyrl_RS.UTF-8 or sr_Latn_RS.UTF-8
 243 sr_YU.ISO8859-5            sr_Cyrl_RS.ISO8859-5
 244 sr_YU.ISO8859-2            sr_Latn_RS.ISO8859-2
 245 zh_CN.GBK                  zh_Hans_CN.GBK
 246 zh_CN.UTF-8                zh_Hans_CN.UTF-8
 247 zh_CN.eucCN                zh_Hans_CN.eucCN
 248 zh_CN.GB2312               zh_Hans_CH.GB2312
 249 zh_CN.GB18030              zh_Hans_CH.GB18030
 250 zh_HK.Big5HKSCS            zh_Hant_HK.Big5HKSCS
 251 zh_HK.UTF_8                zh_Hant_HK.UTF-8
 252 zh_TW.Big5                 zh_Hant_TW.Big5
 253 zh_TW.UTF-8                zh_Hant_TW.UTF-8
 254
 255 +-----------------------------------------------------------------------+
 256 +         UPGRADING DRAGONFLY FROM 4.0 TO LATER VERSIONS                +
 257 +-----------------------------------------------------------------------+
 258
 259 BINUTILS 2.25 REPLACES 2.22, PRIMARY
 260 ------------------------------------
 261
 262 The oldest of the two versions of Binutils, version 2.22, was removed
 263 and replaced with Binutils 2.25.  It becomes the primary version version
 264 of binutils and version 2.24 becomes the alternate.  There are 8 current
 265 CVE written against 2.24, so for security reasons version 2.25 should
 266 always be used.
 267
 268 The accepted values of BINUTILSVER are now "binutils225" (default) and
 269 "binutils224".  The building of Binutils 2.24 can be prevented by setting
 270 NO_ALTBINUTILS=yes in make.conf.
 271
 272 LOADER OPTIONS CHANGED
 273 ----------------------
 274
 275 Right after the development branch started, the Fred art accompanying the
 276 loader menu was improved.  The line between Fred and the menu was removed
 277 by default (but can optionally be returned) and the placement shifted as
 278 a result.  The drawing was improved, and the colored version was improved,
 279 changing the eyes and wing color from white to red.  A new color version
 280 of Fred was added, one with a blue scheme.
 281
 282 The loader menu defaults have changed since release 4.0:  The vertical
 283 line was removed, the loader is displayed in color by default*, and the
 284 blue scheme is used.
 285
 286 The loader.conf changes are:
 287 loader_color:   option has been removed
 288 loader_plain:   option has been added, it changed menu to monochrome
 289 fred_is_red:    changes color scheme from blue to red
 290 fred_is_blue:   option existed only on 4.1, it has been removed
 291 fred_separated: Adds line between Fred and menu (as seen previously)
 292
 293 * If loader.conf defines "console" as "comconsole" or "console" is defined
 294   in the environment as "comconsole" then color will not be displayed,
 295   even if loader_plain value is "NO".
 296
 297 SENDMAIL REMOVED FROM BASE
 298 --------------------------
 299
 300 The only Mail Transfer Agent provided now is DragonFly Mail Agent (dma).
 301 If the system being upgraded is still configured to use the sendmail
 302 binaries from base, the "make upgrade" command will fail.
 303
 304 The administrator must change /etc/mail/mailer.conf to switch the
 305 mailwrapper to dma or a DPorts-based MTA prior to running the upgrade
 306 command that permanently removes sendmail executables and could
 307 potentially break a running mail server.
 308
 309 Refer: http://www.dragonflybsd.com/docs/docs/newhandbook/mta/ for
 310 detailed instructions on how to configure the MTA selection.
 311
 312 _KPOSIX_VERSION and P1003_1B OPTIONS REMOVED
 313 --------------------------------------------
 314
 315 The _KPOSIX_VERSION and P1003_1B kernel options have been changed to
 316 no-ops. They can be removed from custom kernel configurations.
 317
 318 SOUND SYSTEM UPDATED FROM FreeBSD 11-CURRENT
 319 --------------------------------------------
 320
 321 Many more sound devices may be detected.
 322
 323 If the default device choosen isn't to your liking, setting the sysctl
 324 hw.snd.default_unit to a different number will change it.
 325
 326 SCTP SUPPORT DROPPED
 327 --------------------
 328
 329 Support for the SCTP protocol has been removed.
 330
 331 OLD USB DRIVERS REMOVED
 332 -----------------------
 333
 334 The old USB stack, along with the kernel config option "device oldusb"
 335 and the make.conf variable "WANT_OLDUSB" have been removed. This means
 336 that for custom kernel configuration files which were derived from a
 337 GENERIC or X86_64_GENERIC file prior to making the usb4bsd stack default,
 338 various (old USB stack specific) devices will now complain about being
 339 unknown:
 340
 341   * oldusb      (obviously)
 342   * natausb     (not yet ported to usb4bsd)
 343   * rue         (not yet ported to usb4bsd)
 344   * ugen        (no longer needed in usb4bsd)
 345   * urio        (not yet ported to usb4bsd)
 346   * uscanner    (no longer needed in usb4bsd)
 347
 348 They should be removed or commented out in such custom kernel configs.
 349
 350 GCC 5
 351 -----
 352
 353 The GCC 4.4 compiler has been retired.  It has been replaced by a GCC 5.1.
 354 The following make.conf variables no longer work: NO_GCC44, NO_OBJC, and
 355 NO_CXX.  The latter was never documented and the latest versions of GCC are
 356 partially written in C++ so a C++ compiler is no longer optional.  In
 357 practical terms it has not been optional for many years as other base
 358 components are also written in C++.  The resource savings by avoiding
 359 building Objective-C compiler is so small, the complexity added by NO_OBJC
 360 internally was deemed a bad tradeoff so that is the reason for its removal.
 361 Also note that no "info" pages are installed with GCC 5.  After this entry
 362 was originally written, all info pages were removed from DragonFly.
 363
 364 GCC 5.1 has been designated as the primary compiler.  As such, there is a
 365 new make.conf variable, NO_ALTCOMPILER.  It will block the rebuilding of
 366 the designated secondary compiler, GCC 4.7.  However, while DPorts
 367 primarily uses GCC 5 to build ports now, it still uses GCC 4.7 as well, so
 368 if building ports from source is desired, don't block building of the
 369 secondary compiler.
 370
 371 +-----------------------------------------------------------------------+
 372 +         UPGRADING DRAGONFLY FROM 3.8 TO LATER VERSIONS                +
 373 +-----------------------------------------------------------------------+
 374
 375 SMP AND DEVICE_POLLING OPTIONS MADE UNKNOWN
 376 -------------------------------------------
 377
 378 DEVICE_POLLING was replaced by IFPOLL_ENABLE and the former SMP code is
 379 the default now (even on single-core systems), both for, like, 21 months.
 380 We kept the options around as no-ops as a convenience, to allow people
 381 using the same config for the then current release and the then current
 382 master. That period is now over, so any configs still having those
 383 options have to be adjusted.
 384
 385 SYSVIPC SYSCALLS MADE NON-OPTIONAL
 386 ----------------------------------
 387
 388 The code related to the SYSVMSG, SYSVSEM and SYSVSHM kernel options is
 389 now compiled in by default. The options are no-ops for now.
 390
 391 DEFAULT DRIVER CHANGED FOR LSI "THUNDERBOLT" SERIES RAID CONTROLLERS
 392 --------------------------------------------------------------------
 393
 394 The default driver for those controllers is now mrsas(4) due to reports
 395 of file system corruption using the mfi(4) driver. The whole issue (and
 396 how to deal with potential problems when switching) was explained here:
 397
 398 http://lists.dragonflybsd.org/pipermail/users/2014-July/128703.html
 399
 400 A tunable is provided for letting those controllers still attach via
 401 the mfi(4) driver, hw.mrsas.mfi_enable (see mrsas(4) manual page).
 402
 403 OLDER NETWORK DRIVERS MOVED TO I386 ONLY
 404 ----------------------------------------
 405
 406 The following drivers have been made i386 only: ed(4), sr(4), ng_sync_ar
 407 and ng_sync_sr. ed(4) used to be in X86_64_GENERIC, so it has to be
 408 removed in kernel configs derived from X86_64_GENERIC.
 409
 410 +-----------------------------------------------------------------------+
 411 +         UPGRADING DRAGONFLY FROM 3.6 TO LATER VERSIONS                +
 412 +-----------------------------------------------------------------------+
 413
 414 UPDATE FROM MOST RECENT 3.6
 415 ---------------------------
 416
 417 Versions of 3.6 built before June 25th have a bug where installworld might
 418 crash during installation of the new initrd.  Upgrade to the latest version
 419 of 3.6 before updating to 3.8 or later.
 420
 421 ATM, IPX, NCP AND NWFS SUPPORT DROPPED
 422 --------------------------------------
 423
 424 Support for the IPX and NCP network protocols and for mouting NetWare
 425 file systems has been dropped. Dito for ATM protocol support.
 426
 427 INITRD IMAGES NOW INSTALLED BY DEFAULT
 428 --------------------------------------
 429
 430 An initial ramdisk image is now installed in /boot/kernel/initrd.img.gz
 431
 432 Older images installed under the file name of initrd.img will be removed
 433 automatically by the make upgrade process.
 434
 435 USB4BSD IS NOW THE DEFAULT USB STACK
 436 ------------------------------------
 437
 438 To get back to the old stack, put "WANT_OLDUSB=yes" in /etc/make.conf and
 439 replace "device usb" with "device oldusb" in the kernel configuration.
 440
 441 MORE ISA SUPPORT DROPPED
 442 ------------------------
 443
 444 ISA support has been dropped from the following drivers: adv(4), an(4),
 445 ar(4), cs(4), digi(4), ed(4), ep(4), ex(4), fe(4), lnc(4), sbni(4),
 446 si(4), sn(4), and stg(4).
 447
 448 +-----------------------------------------------------------------------+
 449 +         UPGRADING DRAGONFLY FROM 3.4 TO LATER VERSIONS                +
 450 +-----------------------------------------------------------------------+
 451
 452 ABI CHANGE
 453 ----------
 454
 455 Installed third-party software (dports) will have to be rebuilt after upgrade,
 456 or reinstalled from binary packages.
 457
 458 UPDATING FROM 3.4 TO 3.6
 459 ------------------------
 460
 461 This only applies for this specific upgrade due to locale changes; it is
 462 not needed for upgrades after 3.6.  Please update in this order:
 463
 464 make buildworld
 465 make buildkernel
 466 make installworld
 467 make installkernel
 468 *reboot*
 469 make upgrade
 470
 471 See this mailing list post for details:
 472 http://lists.dragonflybsd.org/pipermail/users/2013-September/090163.html
 473
 474 CYRIX OPTIONS REMOVED
 475 ---------------------
 476
 477 The following Cyrix related options have been removed: CPU_BTB_EN,
 478 CPU_CYRIX_NO_LOCK, CPU_DIRECT_MAPPED_CACHE, CPU_DISABLE_5X86_LSSER,
 479 CPU_FASTER_5X86_FPU, CPU_IORT, CPU_LOOP_EN, CPU_RSTK_EN, CPU_SUSP_HLT,
 480 CYRIX_CACHE_WORKS, and CYRIX_CACHE_REALLY_WORKS
 481
 482 ISA SUPPORT REMOVED FROM RP(4)
 483 ------------------------------
 484
 485 ISA support has been removed from the rp(4) driver. It is now PCI only.
 486
 487 +-----------------------------------------------------------------------+
 488 +         UPGRADING DRAGONFLY FROM 3.2 TO LATER VERSIONS                +
 489 +-----------------------------------------------------------------------+
 490
 491 COMPAT_SUNOS OPTION REMOVED
 492 ---------------------------
 493
 494 The COMPAT_SUNOS option has been removed. It was meant to provide binary
 495 compatibility with SunOS 4.x for the sparc32 port of 4.4BSD.
 496
 497 ISA SOUND CARD SUPPORT REMOVED
 498 ------------------------------
 499
 500 The following modules have been removed (all for ISA sound cards):
 501 snd_ad1816.ko, snd_ess.ko, snd_mss.ko, snd_sb8.ko, snd_sb16.ko, snd_sbc.ko
 502
 503 GCC 4.7
 504 -------
 505
 506 DragonFly has switched base compilers.  GCC 4.7 is now the default
 507 compiler and GCC 4.4 is the alternative compiler.  The "NO_GCC47" make
 508 variable ceases to work now.
 509
 510 Users who wish to build only GCC 4.7 have to use NO_GCC44 in the
 511 /etc/make.conf to prohibit GCC 4.4 from building.  However, using it is
 512 highly discouraged.  There are a few packages in pkgsrc that do not build
 513 with GCC 4.7 and the new "DPorts" system uses GCC 4.4 by default.  At
 514 this time, it is recommended to keep both compilers on the base system.
 515
 516 SMP OPTION REMOVED
 517 ------------------
 518
 519 The SMP kernel option has been made a no-op. All kernels now feature SMP
 520 support. If you have 'options SMP' in your kernel config, you can as well
 521 remove it.
 522
 523 DEVICE_POLLING OPTION REPLACED BY IFPOLL_ENABLE OPTION, KTR_POLLING REMOVED
 524 ---------------------------------------------------------------------------
 525
 526 The DEVICE_POLLING kernel option has been made a no-op and it has been
 527 replaced by IFPOLL_ENABLE.  If you have 'options DEVICE_POLLING' in your
 528 kernel config, you need to change it to IFPOLL_ENABLE.
 529
 530 Also, the KTR_POLLING kernel option has been removed, so it must be
 531 removed from kernel configs that have it.
 532
 533 BUSLOGIC, CYCLADES AND STALLION ISA SUPPORT REMOVED
 534 ---------------------------------------------------
 535
 536 The bt(4) driver for Buslogic SCSI adapters has been made PCI only. ISA
 537 cards will no longer be detected.
 538
 539 The same has been done for Stallion multiport serial controllers. stli(4)
 540 has been completely removed (along with the stlload(8) and stlstty(8)
 541 utilities) and stl(4) was changed to support only PCI cards. Similarly,
 542 ISA support was removed from cy(4) too. All these drivers are i386 only.
 543
 544 COMPAT_OLDISA OPTION GONE
 545 -------------------------
 546
 547 The i386 specific COMPAT_OLDISA kernel option has been removed, since
 548 nothing needs it anymore.
 549
 550 +-----------------------------------------------------------------------+
 551 +         UPGRADING DRAGONFLY FROM 3.0 TO LATER VERSIONS                +
 552 +-----------------------------------------------------------------------+
 553
 554 APIC_IO OPTION REMOVED
 555 ----------------------
 556
 557 The APIC_IO kernel option is no longer accepted after having been without
 558 effect for a while. The hw.ioapic_enable tunable now serves its purpose.
 559 If you have 'options APIC_IO' in your kernel config, you'll have to
 560 remove it.
 561
 562 WATCHDOG_ENABLE & HW_WDOG OPTIONS REMOVED
 563 -----------------------------------------
 564
 565 The wdog framework is now compiled into our kernels by default, so the
 566 options are no longer needed.
 567
 568 DOSCMD(1) REMOVED
 569 -----------------
 570
 571 doscmd(1) has been removed. It was i386 only. The doscmd(1) specific
 572 NO_X make.conf option was removed too.
 573
 574 GCC 4.7
 575 -------
 576
 577 GCC 4.7 has been brought in and replaces GCC 4.1 as DragonFly's non-
 578 default compiler in base (default is still GCC 4.4).
 579
 580 Users who wish to build only GCC 4.4 have to replace NO_GCC41 with
 581 NO_GCC47 in /etc/make.conf.
 582
 583 USB4BSD
 584 -------
 585
 586 A new USB stack (from FreeBSD) has been brought in. The following
 587 modules have been ported so far: usb, uhci, ohci, ehci, xhci, umass,
 588 usfs, uether, if_axe, if_udav, ukbd, ums, uep, uhid, usb_quirk,
 589 and uaudio.
 590
 591 It is not yet the default. To activate it, WANT_USB4BSD=yes has to
 592 be put in make.conf and device "usb4bsd" (quotes needed) has to
 593 replace device usb in the kernel config. After that, a full
 594 build/install/upgrade cycle is needed.
 595
 596 Note that this is experimental and incomplete, but we are interested
 597 in hearing about issues with it, of course.
 598
 599 ISA SUPPORT REMOVED FROM AIC-6260/6360 DRIVER
 600 ---------------------------------------------
 601
 602 ISA adapter support was dropped from the aic(4) driver.
 603
 604 +-----------------------------------------------------------------------+
 605 +         UPGRADING DRAGONFLY FROM 2.10 TO LATER VERSIONS               +
 606 +-----------------------------------------------------------------------+
 607
 608 SEVERAL ISA DRIVERS REMOVED
 609 ---------------------------
 610
 611 The following ISA only drivers have been removed along with a couple of
 612 associated userland tools:
 613
 614 aha(4)
 615 asc(4) & sasc(1)
 616 ctx
 617 dgb(4)
 618 el(4)
 619 gpib
 620 gsc(4) & sgsc(1)
 621 ie(4)
 622 labpc(4)
 623 le(4)
 624 mse(4)
 625 rc(4)
 626 rdp(4)
 627 spigot
 628 tw(4) & xten(1) & xtend(8)
 629 wl(4) & wlconfig(8)
 630 wt(4)
 631
 632 Note that two of these drivers (aha(4) and ie(4)) are in our GENERIC
 633 config and one (aha(4)) is in our X86_64_GENERIC kernel configuration
 634 file.
 635
 636 If buildkernel complains about any of these drivers, just remove them
 637 from your kernel configuration.
 638
 639 BINUTILS 2.20
 640 -------------
 641 Binutils 2.20 has been removed in favor of Binutils 2.22.  The accepted
 642 values of BINUTILSVERS are now binutils221 and binutils222 (default).
 643
 644 BUILDWORLD/-KERNEL PARALLELIZATION WORK
 645 ---------------------------------------
 646 Due to changes in the way we build with more than one make job, you
 647 will have to update install(1) and mkdir(1) prior to buildworld if you
 648 want to build with 'make -j':
 649
 650 cd /usr/src/usr.bin/xinstall; make; make install; make clean
 651 cd /usr/src/bin/mkdir; make; make install; make clean
 652
 653 DMA(8) UPGRADE
 654 --------------
 655 dma(8) has been upgraded to v0.7 which no longer supports the
 656 /etc/dma/virtusertable. Some of its functionality has been replaced
 657 with the MASQUERADE keyword and the EMAIL environment variable (see
 658 the dma(8) manual page).
 659
 660 +-----------------------------------------------------------------------+
 661 +         UPGRADING DRAGONFLY FROM 2.8 TO LATER VERSIONS                +
 662 +-----------------------------------------------------------------------+
 663
 664 GCC 4.4 & BINUTILS 2.21
 665 -----------------------
 666
 667 GCC 4.4 has been made DragonFly's default compiler and Binutils 2.21 has
 668 been made DragonFly's default Binutils.
 669
 670 That means that any settings that set CCVER to 'gcc44' are not needed
 671 anymore. Instead, CCVER can be set to 'gcc41' to go back to using
 672 GCC 4.1.
 673
 674 It also means that 'binutils221' as a value for BINUTILSVER has no
 675 effect anymore. 2.17 has been removed and 'binutils220' is available
 676 as an option.
 677
 678 The NO_GCC44 option has been removed and will not affect the build
 679 anymore. There is now a NO_GCC41 option that will prevent GCC 4.1 from
 680 building in a similar fashion.
 681
 682 Note that you must do a full buildworld/buildkernel for upgrading.
 683
 684 pkg_radd settings
 685 -----------------
 686
 687 The config file for pkg_radd has moved from /etc/settings.conf to
 688 /etc/pkg_radd.conf.  Save the contents of settings.conf before upgrading
 689 if this is needed.  This warning only applies if /etc/settings.conf
 690 exists.  pkg_radd will continue to work with defaults.
 691
 692 +-----------------------------------------------------------------------+
 693 +         20100927                                                      +
 694 +         UPGRADING DRAGONFLY FROM 2.6 to 2.8 or HEAD                   +
 695 +-----------------------------------------------------------------------+
 696
 697 OpenSSL
 698 --------
 699
 700 OpenSSL has been upgraded, and SHLIB_MAJOR was bumped for libssh and libcrypto.
 701 This shouldn't break any 3rd-party software, but you'll need to recompile your
 702 3rd-party software if you want it to link against the new version of OpenSSL.
 703
 704 Loader
 705 -------
 706
 707 A new loader (dloader) has been added which better handles booting from
 708 multiple kernel/module versions.
 709
 710 To upgrade (Only for this upgrade, for post 2.8 upgrades see GENERAL below)
 711
 712         cd /usr/src
 713         make buildworld
 714         make installworld
 715         make upgrade
 716         make buildkernel KERNCONF=<KERNELNAME>
 717         make installkernel KERNCONF=<KERNELNAME>
 718
 719 Note that you must installworld and run the 'upgrade' target before
 720 installing the new kernel.
 721
 722 BIND
 723 -----
 724
 725 BIND has been removed from the base system.  The ldns and drill tools have
 726 been added for basic functionality.  Use 'drill' where you would normally
 727 use nslookup or dig, or install BIND from pkgsrc.  It's available as
 728 net/bind95, net/bind96, or net/bind97 as of this writing.
 729
 730 This only affects older systems upgrading to 2.8.  New 2.8+ installs
 731 include BIND as a pkgsrc package.
 732
 733 +-----------------------------------------------------------------------+
 734 +         UPGRADING DRAGONFLY ON AN EXISTING DRAGONFLY SYSTEM           +
 735 +                               GENERAL                                 +
 736 +-----------------------------------------------------------------------+
 737
 738 Instructions on how to obtain and maintain DragonFly source code using git
 739 are in the development(7) manual page.
 740
 741 To upgrade a DragonFly system from sources you run the following sequence:
 742
 743         cd /usr/src
 744         make buildworld
 745         make buildkernel KERNCONF=<KERNELNAME>
 746         make installkernel KERNCONF=<KERNELNAME>
 747         make installworld
 748
 749 You will also want to run the 'upgrade' target to upgrade your /etc and the
 750 rest of your system.  The upgrade target is aware of stale files created by
 751 older DragonFly installations and should delete them automatically.
 752
 753         make upgrade
 754
 755 See the build(7) manual page for further information.
 756
 757 Once you've done a full build of the world and kernel you can do incremental
 758 upgrades of either by using the 'quickworld' and 'quickkernel' targets
 759 instead of 'buildworld' and 'buildkernel'.  If you have any problems with
 760 the quick targets, try updating your repo first, and then a full buildworld
 761 and buildkernel as shown above, before asking for help.
 762
 763 +-----------------------------------------------------------------------+
 764 +         UPGRADING FROM DRAGONFLY <= 2.0 TO DRAGONFLY >= 2.1           +
 765 +-----------------------------------------------------------------------+
 766
 767 In 2.1 kernel and modules has moved to boot directory.  For most cases
 768 this is handled automatically by 'make upgrade'.  A few cases needs manual
 769 intervention:
 770
 771  * When installing a kernel without first doing a make buildworld,
 772    installworld and upgrade to the same DESTDIR as kernel:
 773    make DESTDIR/boot directory and move kernel and modules into this boot
 774    directory; also move kernel.old and modules.old.
 775    Typical example is vkernel(7), use (no modules used):
 776
 777         cd /var/vkernel
 778         mkdir boot
 779         chflags noschg kernel
 780         mv kernel kernel.old boot
 781         chflags schg boot/kernel
 782
 783  * When using a boot-only partition, /boot/loader.rc needs to be edited:
 784    delete occurrences of '/boot/'.
 785    These occurences can normally be deleted in any case, see loader(8).
 786
 787 +-----------------------------------------------------------------------+
 788 +         UPGRADING FROM DRAGONFLY <= 1.8 TO DRAGONFLY >= 1.9           +
 789 +-----------------------------------------------------------------------+
 790
 791 In 1.9 major changes to the disk management infrastructure have taken
 792 place.  make upgrade may not catch all of your disk devices in /dev,
 793 so after upgrading be sure to cd /dev; ./MAKEDEV <blah> where <blah>
 794 are all of your disk devices.  HOWEVER, from late 2.3 on we run devfs
 795 and MAKEDEV no longer exists.
 796
 797 The biggest changes in 1.9 are:
 798
 799 (1) That whole-slice devices such as da0s1 no longer share the same device
 800     id as partition c devices such as da0s1c.
 801
 802 (2) The whole-disk device (e.g. da0) is full raw access to the disk,
 803     with no snooping or reserved sectors.  Consequently you cannot run
 804     disklabel on this device.  Instead you must run disklabel on a
 805     whole-slice device.
 806
 807 (3) The 'compatibility' partitions now use slice 0 in the device name,
 808     so instead of da0a you must specify da0s0a.  Also, as per (1) above,
 809     accessing the disklabel for the compatibility partitions must be
 810     done via slice 0 (da0s0).
 811
 812 (4) Many device drivers that used to fake up labels, such as CD, ACD, VN,
 813     and CCD now run through the disk management layer and are assigned
 814     real disk management devices.   VN and CCD in particular do not usually
 815     use a MBR and disklabels must be accessed through the compatibility
 816     slice 0.  Your /etc/ccd.conf file still specifies 'ccd0', though, you
 817     don't name it 'ccd0s0' in the config file.
 818
 819 Generally speaking, you have to get used to running fdisk and disklabel on
 820 the correctly specified device names.  A lot of the wiggle, such as running
 821 disklabel on a partition, has been removed.
 822
 823 +-----------------------------------------------------------------------+
 824 +         UPGRADING FROM OLDER VERSIONS OF DRAGONFLY OR FREEBSD         +
 825 +-----------------------------------------------------------------------+
 826
 827 > Kerberos IV
 828 -------------
 829
 830 Kerberos IV (eBones) was removed from the tree, please consider moving to
 831 Kerberos 5 (Heimdal).
 832
 833 > Package Management System
 834 ---------------------------
 835
 836 Starting with the 1.4 release, DragonFly uses NetBSD's pkgsrc package
 837 management system.  The necessary tools to build and maintain packages
 838 are provided in /usr/pkg/bin and /usr/pkg/sbin.  Make sure that these
 839 directories are in your PATH variable.
 840
 841 In order to obtain a reasonably current snapshot of the pkgsrc tree, use
 842 the tarball from NetBSD:
 843
 844         fetch -o /tmp/pkgsrc.tar.gz ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc.tar.gz
 845         cd /usr; tar -xzf /tmp/pkgsrc.tar.gz; chown -R root:wheel pkgsrc
 846
 847 This tree can then be kept up to date with cvs update:
 848
 849         cd /usr/pkgsrc; cvs up
 850
 851 NOTE! If you upgraded from a pre-1.4 system to 1.4 or later, you need to
 852 build and install the pkgsrc bootstrap manually:
 853
 854         cd /usr/pkgsrc/bootstrap
 855         ./bootstrap --pkgdbdir /var/db/pkg --prefix /usr/pkg
 856
 857 +-----------------------------------------------------------------------+
 858 +         UPGRADING DRAGONFLY ON AN EXISTING DRAGONFLY SYSTEM           +
 859 +         UPDATING FROM PRE-1.2 SYSTEMS OR FreeBSD 4.x TO               +
 860 +         DRAGONFLY 1.3+ (EITHER PREVIEW or HEAD)                       +
 861 +-----------------------------------------------------------------------+
 862
 863 The compatibility shims for the build environment have been removed, you
 864 have to update to DragonFly 1.2 release branch first.
 865
 866 The default PAM configuration has moved from /etc/pam.conf to /etc/pam.d/.
 867 The existing configuration can be converted using /etc/pam.d/convert.sh.
 868 Entries in /etc/pam.d/ override entries in /etc/pam.conf. In addition
 869 the pam_skey.so module was retired, you have to remove it manually from
 870 your configuration, when you convert it.
 871
 872 > Required user and group IDs when upgrading from either FreeBSD or DragonFly
 873 ---------------------
 874
 875 The following users may be missing from your password file.  Use vipw and
 876 add any that are missing:
 877
 878 smmsp:*:25:25::0:0:Sendmail Submission User:/var/spool/clientmqueue:/sbin/nologin
 879 _pflogd:*:64:64::0:0:pflogd privsep user:/var/empty:/sbin/nologin
 880
 881 The following groups may be missing from your group file.  Use vi /etc/group
 882 and add any that are missing:
 883
 884 smmsp:*:25:
 885 authpf:*:63:
 886 _pflogd:*:64:
 887
 888
 889 > Upgrading to DragonFly from FreeBSD
 890 ---------------------
 891
 892 You can build the DragonFly world and DragonFly kernels on a FreeBSD-4.x or
 893 FreeBSD-5.x machine and then install DragonFly over FreeBSD, replacing
 894 FreeBSD.  Note that the DragonFly buildworld target does not try to reuse
 895 make depend information, it starts from scratch, so no pre-cleaning of the
 896 object hierarchy is necessary.
 897
 898         # get the CVS repository (it is placed in /home/dcvs, 500MB).
 899         # Please use the -h option and a mirror site to pull the
 900         # initial repository, but feel free to use the main repository
 901         # machine to pull updates.
 902         cvsup /usr/share/examples/cvsup/DragonFly-cvs-supfile
 903         # install the source from the CVS hierarchy (remove preexisting
 904         # FreeBSD src first) (500MB)
 905         cd /usr
 906         rm -rf src
 907         cvs -R -d /home/dcvs checkout -P src
 908
 909         # build it (500MB used in /usr/obj)
 910         #
 911         cd /usr/src
 912         make buildworld
 913         make buildkernel KERNCONF=<KERNELNAME>
 914
 915 Once you have built DragonFly you have to install it over FreeBSD.  Since
 916 DragonFly does not track changes made by FreeBSD to its include file
 917 hierarchy and include file pollution can cause all sorts of unexpected
 918 compilation issues to come up, it is best to wipe your include hierarchy
 919 prior to installing DragonFly.  Note that you should not wipe any installed
 920 FreeBSD header files or binaries until after you have successfully completed
 921 the build steps above.
 922
 923         rm -rf /usr/include
 924         mkdir /usr/include
 925         make installkernel KERNCONF=<KERNELNAME>
 926         make installworld
 927
 928 Then you need to upgrade your system.  DragonFly's 'make upgrade' target
 929 will unconditionally upgrade the /etc files that sysops do not usually
 930 mess around with, such as the files in /etc/rc.d.  It will also remove any
 931 obsolete files such as utilities and manpages that have been removed from
 932 the system since the version you're coming from.  If you are unsure we
 933 recommend that you make a backup of at least your /etc before applying
 934 this step.  Note that DragonFly's RC system is basically RCNG from
 935 FreeBSD-5, but there are some differences in the contents of the RC files.
 936
 937         make upgrade
 938
 939 NOTE! Never do a 'make upgrade' before 'make installworld' has been run.
 940 Doing so might leave your system in an unusable state.
 941
 942 Finally we recommend that you do an 'ls -lta BLAH' for /bin, /sbin, /usr/bin,
 943 /usr/bin, and /usr/lib, and remove any stale files that you find.  Please
 944 report these files to the DragonFly developers so that they can be added to
 945 the 'upgrade' target.
 946