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