Add the packet filtering files.
[dragonfly.git] / UPDATING
... / ...
CommitLineData
1$DragonFly: src/UPDATING,v 1.6 2003/11/18 00:34:20 dillon Exp $
2
3Updating Information for DragonFly users.
4
5This file should warn you of any pitfalls which you might need to work around
6when trying to update your DragonFly system.
7
8If you discover any problem, please contact the bugs@lists.dragonflybsd.org
9mailing list with the details.
10
11------------------------------------------------------------------------------
12
13> Compiling DragonFly
14---------------------
15
16Compiling DragonFly requires an ISO C90 or higher compliant compiler.
17Compilers which support this are, amongst others: The GNU C Compiler, The
18Intel C++ Compiler, and The TenDRA Compiler.
19
20You can do DragonFly buildworld/buildkernel/installworld/installkernel
21on FreeBSD-stable boxen as well as DragonFly boxen.
22
23Due to source tree reorganizations at various times header files may have
24moved or been deleted, leaving stale header files in /usr/include. This
25can also cause 'make depend' to fail due to make depend getting confused
26about old header files.
27
28The easiest way to deal with include file messes is to reinstall /usr/include
29from 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
36If your have trouble doing builds due to the make depend stage failing, the
37easiest 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
47If you are using 'config' manually, note that building kernels via the manual
48config / /usr/src/sys/compile/BLAH procedure only works reliably on an
49uptodate 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
55Kerberos IV (eBones) was removed from the tree, please consider moving to
56Kerberos 5 (Heimdal).
57
58> FreeBSD and DragonFly ports
59-----------------------------
60
61DragonFly will eventually have its own package management system but at the
62moment 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
65DragonFly has its own 'port overrides' hierarchy in /usr/dfports. You can
66check this out of the DragonFly cvs repository using:
67
68cd /usr
69cvs -R -d /cvs checkout dfports
70
71You may wish to use a consolidated distfiles directory, in which case you
72should make /usr/dfports/distfiles a softlink to your existing distfiles
73directory (typically /usr/ports/distfiles).
74
75Be 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
78build the port. Dragonfly should contain an override and you should see a
79warning message that the DragonFly override is being build instead when you
80build it from the FreeBSD ports.
81