Move IFF_PROMISC and IFF_POLLING from ifnet.ipending to ifnet.if_flags,
[dragonfly.git] / UPDATING
1 $DragonFly: src/UPDATING,v 1.6 2003/11/18 00:34:20 dillon Exp $
2
3 Updating Information for DragonFly users.
4
5 This file should warn you of any pitfalls which you might need to work around
6 when trying to update your DragonFly system.
7
8 If you discover any problem, please contact the bugs@lists.dragonflybsd.org
9 mailing list with the details.
10
11 ------------------------------------------------------------------------------
12
13 > Compiling DragonFly
14 ---------------------
15
16 Compiling DragonFly requires an ISO C90 or higher compliant compiler.
17 Compilers which support this are, amongst others: The GNU C Compiler, The
18 Intel C++ Compiler, and The TenDRA Compiler.
19
20 You can do DragonFly buildworld/buildkernel/installworld/installkernel
21 on FreeBSD-stable boxen as well as DragonFly boxen.
22
23 Due to source tree reorganizations at various times header files may have
24 moved or been deleted, leaving stale header files in /usr/include.  This
25 can also cause 'make depend' to fail due to make depend getting confused
26 about old header files.
27
28 The easiest way to deal with include file messes is to reinstall /usr/include
29 from scratch as follows:
30
31         rm -rf /usr/include     # safer to type this verses /usr/include/*
32         mkdir /usr/include
33         cd /usr/src
34         make installincludes
35
36 If your have trouble doing builds due to the make depend stage failing, the
37 easiest solution is to wipe your object tree and rebuild/reinstall.
38
39         rm -rf /usr/obj         # safer to type this verses /usr/obj/*
40         mkdir /usr/obj
41         cd /usr/src
42         make buildkernel KERNCONF=<KERNELNAME>
43         make installkernel
44         make buildworld
45         make installworld
46
47 If you are using 'config' manually, note that building kernels via the manual
48 config / /usr/src/sys/compile/BLAH procedure only works reliably on an
49 uptodate DragonFly box.  The official way to build kernels is via the
50 'make buildkernel KERNCONf=<KERNELNAME>' target from /usr/src.
51
52 > Kerberos IV
53 -------------
54
55 Kerberos IV (eBones) was removed from the tree, please consider moving to
56 Kerberos 5 (Heimdal).
57
58 > FreeBSD and DragonFly ports
59 -----------------------------
60
61 DragonFly will eventually have its own package management system but at the
62 moment we leverage off of the FreeBSD ports system.  You should maintain
63 /usr/ports from the FreeBSD cvs repository via cvsup just like you do now.
64
65 DragonFly has its own 'port overrides' hierarchy in /usr/dfports.  You can
66 check this out of the DragonFly cvs repository using:
67
68 cd /usr
69 cvs -R -d /cvs checkout dfports
70
71 You may wish to use a consolidated distfiles directory, in which case you
72 should make /usr/dfports/distfiles a softlink to your existing distfiles
73 directory (typically /usr/ports/distfiles).
74
75 Be sure that you have installed 'relpath' from the DragonFly sources
76 (/usr/src/usr.bin/relpath) as well as the updated /usr/share/mk files from
77 /usr/src/share/mk.  As a test you can cd into /usr/ports/sysutils/cpdup and
78 build the port.  Dragonfly should contain an override and you should see a
79 warning message that the DragonFly override is being build instead when you
80 build it from the FreeBSD ports.
81