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