<resolv.h>: Include <netinet/in.h> for in_addr and sockaddr_in.
[dragonfly.git] / 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