Style(9) cleanup.
[dragonfly.git] / UPDATING
CommitLineData
fb12f484 1$DragonFly: src/UPDATING,v 1.6 2003/11/18 00:34:20 dillon Exp $
984263bc 2
5e0ae0d4 3Updating Information for DragonFly users.
984263bc 4
5e0ae0d4
JR
5This file should warn you of any pitfalls which you might need to work around
6when trying to update your DragonFly system.
984263bc 7
5e0ae0d4
JR
8If you discover any problem, please contact the bugs@lists.dragonflybsd.org
9mailing list with the details.
984263bc 10
5e0ae0d4 11------------------------------------------------------------------------------
984263bc 12
5e0ae0d4
JR
13> Compiling DragonFly
14---------------------
984263bc 15
5e0ae0d4
JR
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.
984263bc 19
fb12f484
MD
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.
984263bc 51
5e0ae0d4
JR
52> Kerberos IV
53-------------
984263bc 54
5e0ae0d4
JR
55Kerberos IV (eBones) was removed from the tree, please consider moving to
56Kerberos 5 (Heimdal).
984263bc 57
892096eb
MD
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
a7dd4e91 65DragonFly has its own 'port overrides' hierarchy in /usr/dfports. You can
892096eb
MD
66check this out of the DragonFly cvs repository using:
67
68cd /usr
a7dd4e91 69cvs -R -d /cvs checkout dfports
892096eb
MD
70
71You may wish to use a consolidated distfiles directory, in which case you
a7dd4e91 72should make /usr/dfports/distfiles a softlink to your existing distfiles
892096eb
MD
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.
984263bc 81