Add a reference for /usr/share/examples/rconfig to the rconfig manual page.
[dragonfly.git] / Makefile
blob3d5485c26706e9fdf3a86eec524230d4461ddffa
2 # $FreeBSD: src/Makefile,v 1.234.2.19 2003/04/16 09:59:40 ru Exp $
3 # $DragonFly: src/Makefile,v 1.25 2008/07/14 03:49:58 dillon Exp $
5 # The user-driven targets are:
7 # buildworld - Rebuild *everything*, including glue to help do
8 # upgrades.
9 # quickworld - Skip bootstrap, build and cross-build tool steps
10 # realquickworld - Skip above steps, plus depend
11 # crossworld - Just do the bootstrap, build, and cross-build steps
12 # installworld - Install everything built by "buildworld".
13 # world - buildworld + installworld.
14 # buildkernel - Rebuild the kernel and the kernel-modules from scratch
15 # using build/bootstrap/cross tools from the last
16 # buildworld.
17 # nativekernel - Rebuild the kernel and the kernel-modules from scratch
18 # using native tools.
19 # quickkernel - rebuild the kernel quickly (build or native), skip
20 # the make depend step and do not clean out the obj
21 # modules.
22 # installkernel - Install the kernel and the kernel-modules.
23 # reinstallkernel - Reinstall the kernel and the kernel-modules.
24 # kernel - buildkernel + installkernel.
25 # update - Convenient way to update your source tree (cvs).
26 # preupgrade - Certain upgrades may have to be done before installworld.
27 # installworld will complain if they have not been done. This
28 # target will do those upgrades... typically the addition of
29 # new special groups and users used by installed utilities.
30 # upgrade - Upgrade the files in /etc and also setup the rest
31 # of the system for DragonFly. ex. two compilers
32 # most - Build user commands, no libraries or include files.
33 # installmost - Install user commands, no libraries or include files.
35 # This makefile is simple by design. The DragonFly make automatically reads
36 # /usr/share/mk/sys.mk unless the -m argument is specified on the
37 # command line. By keeping this makefile simple, it doesn't matter too
38 # much how different the installed mk files are from those in the source
39 # tree. This makefile executes a child make process, forcing it to use
40 # the mk files from the source tree which are supposed to DTRT.
42 # The user-driven targets (as listed above) are implemented in Makefile.inc1.
44 # If you want to build your system from source be sure that /usr/obj has
45 # at least 800MB of diskspace available.
47 # For individuals wanting to build from the sources currently on their
48 # system, the simple instructions are:
50 # 1. `cd /usr/src' (or to the directory containing your source tree).
51 # 2. `make world'
53 # For individuals wanting to upgrade their sources (even if only a
54 # delta of a few days):
56 # 1. `cd /usr/src' (or to the directory containing your source tree).
57 # 2. `make buildworld'
58 # 3. `make buildkernel KERNCONF=YOUR_KERNEL_HERE' (default is GENERIC).
59 # 4. `make installkernel KERNCONF=YOUR_KERNEL_HERE' (default is GENERIC).
60 # 5. `make installworld'
61 # 6. `make upgrade'
62 # 7. `reboot'
64 # See src/UPDATING `COMMON ITEMS' for more complete information.
66 # If TARGET_ARCH=arch (e.g. amd64) is specified you can
67 # cross build world for other architectures using the buildworld target,
68 # and once the world is built you can cross build a kernel using the
69 # buildkernel target.
71 # Define the user-driven targets. These are listed here in alphabetical
72 # order, but that's not important.
74 TGTS= all all-man buildkernel quickkernel nativekernel \
75 buildworld crossworld quickworld realquickworld checkdpadd clean \
76 cleandepend cleandir depend distribute distributeworld everything \
77 hierarchy install installcheck installkernel \
78 reinstallkernel installmost installworld libraries lint maninstall \
79 manlint mk most obj objlink regress rerelease tags update \
80 _obj _includes _libraries _depend _worldtmp \
81 _bootstrap-tools _obj _build-tools _cross-tools
83 BITGTS= files includes
84 BITGTS:=${BITGTS} ${BITGTS:S/^/build/} ${BITGTS:S/^/install/}
86 .ORDER: buildworld installworld
87 .ORDER: buildworld distributeworld
88 .ORDER: buildworld buildkernel
89 .ORDER: buildworld nativekernel
90 .ORDER: buildworld quickkernel
91 .ORDER: buildkernel installkernel
92 .ORDER: buildkernel reinstallkernel
93 .ORDER: quickworld installworld
94 .ORDER: quickworld distributeworld
95 .ORDER: quickworld buildkernel
96 .ORDER: quickworld nativekernel
97 .ORDER: quickworld quickkernel
98 .ORDER: quickkernel installkernel
99 .ORDER: quickkernel reinstallkernel
101 PATH= /sbin:/bin:/usr/sbin:/usr/bin
102 MAKE= PATH=${PATH} make -m ${.CURDIR}/share/mk -f Makefile.inc1
105 # Handle the user-driven targets, using the source relative mk files.
107 ${TGTS} ${BITGTS}:
108 @cd ${.CURDIR}; \
109 ${MAKE} ${.TARGET}
111 # Set a reasonable default
112 .MAIN: all
114 STARTTIME!= LC_ALL=C date
116 # world
118 # Attempt to rebuild and reinstall *everything*, with reasonable chance of
119 # success, regardless of how old your existing system is.
121 world:
122 @echo "--------------------------------------------------------------"
123 @echo ">>> elf make world started on ${STARTTIME}"
124 @echo "--------------------------------------------------------------"
125 .if target(pre-world)
126 @echo
127 @echo "--------------------------------------------------------------"
128 @echo ">>> Making 'pre-world' target"
129 @echo "--------------------------------------------------------------"
130 @cd ${.CURDIR}; ${MAKE} pre-world
131 .endif
132 @cd ${.CURDIR}; ${MAKE} buildworld
133 @cd ${.CURDIR}; ${MAKE} -B installworld
134 .if target(post-world)
135 @echo
136 @echo "--------------------------------------------------------------"
137 @echo ">>> Making 'post-world' target"
138 @echo "--------------------------------------------------------------"
139 @cd ${.CURDIR}; ${MAKE} post-world
140 .endif
141 @echo
142 @echo "--------------------------------------------------------------"
143 @printf ">>> elf make world completed on `LC_ALL=C date`\n (started ${STARTTIME})\n"
144 @echo "--------------------------------------------------------------"
147 # kernel
149 # Short hand for `make buildkernel installkernel'
151 kernel: buildkernel installkernel
154 # A simple test target used as part of the test to see if make supports
155 # the -m argument. Also test that make will only evaluate a conditional
156 # as far as is necessary to determine its value.
158 test:
159 .if defined(notdef)
160 .undef notdef
161 .if defined(notdef) && ${notdef:U}
162 .endif
163 .endif
166 # Upgrade the installed make to the current version using the installed
167 # headers, libraries and build tools. This is required on installed versions
168 # prior to 2.2.5 in which the installed make doesn't support the -m argument.
170 make:
171 @echo
172 @echo "--------------------------------------------------------------"
173 @echo " Upgrading the installed make"
174 @echo "--------------------------------------------------------------"
175 @cd ${.CURDIR}/usr.bin/make; \
176 make obj && make depend && make all && make install
179 # Handle the upgrade of /etc
182 preupgrade:
183 @cd ${.CURDIR}/etc; make -m ${.CURDIR}/share/mk preupgrade
185 upgrade: upgrade_etc
188 # Handle post-installworld updating of static files (e.g. like /etc/rc)
190 upgrade_etc:
191 @cd ${.CURDIR}/etc; make -m ${.CURDIR}/share/mk upgrade_etc
194 # Convenient targets for use by the CVS repository meister.
196 update_preview_tag: iamoncrater
197 cvs -d /cvs rtag -a -F DragonFly_Preview src
199 update_release1_2_slip_tag: iamoncrater
200 cvs -d /cvs rtag -a -F -rDragonFly_RELEASE_1_2 DragonFly_RELEASE_1_2_Slip src
202 update_release1_4_slip_tag: iamoncrater
203 cvs -d /cvs rtag -a -F -rDragonFly_RELEASE_1_4 DragonFly_RELEASE_1_4_Slip src
205 update_release1_6_slip_tag: iamoncrater
206 cvs -d /cvs rtag -a -F -rDragonFly_RELEASE_1_6 DragonFly_RELEASE_1_6_Slip src
208 update_release1_8_slip_tag: iamoncrater
209 cvs -d /cvs rtag -a -F -rDragonFly_RELEASE_1_8 DragonFly_RELEASE_1_8_Slip src
211 update_release1_10_slip_tag: iamoncrater
212 cvs -d /cvs rtag -a -F -rDragonFly_RELEASE_1_10 DragonFly_RELEASE_1_10_Slip src
214 update_release1_12_slip_tag: iamoncrater
215 cvs -d /cvs rtag -a -F -rDragonFly_RELEASE_1_12 DragonFly_RELEASE_1_12_Slip src
217 update_release2_0_slip_tag: iamoncrater
218 cvs -d /cvs rtag -a -F -rDragonFly_RELEASE_2_0 DragonFly_RELEASE_2_0_Slip src
220 iamoncrater:
221 @ [ "`hostname`" = "crater.dragonflybsd.org" ] || \
222 (echo "You are not on the master cvs host"; exit 1)
225 # Build compatibility overrides
227 .ifdef CCVER
228 .if ${CCVER} == "gcc2"
229 CCVER= gcc34
230 .endif
231 .endif