Makefile revision 1.236 1 # $NetBSD: Makefile,v 1.236 2004/08/28 00:18:38 thorpej Exp $
2
3 #
4 # This is the top-level makefile for building NetBSD. For an outline of
5 # how to build a snapshot or release, as well as other release engineering
6 # information, see http://www.NetBSD.org/developers/releng/index.html
7 #
8 # Not everything you can set or do is documented in this makefile. In
9 # particular, you should review the files in /usr/share/mk (especially
10 # bsd.README) for general information on building programs and writing
11 # Makefiles within this structure, and see the comments in src/etc/Makefile
12 # for further information on installation and release set options.
13 #
14 # Variables listed below can be set on the make command line (highest
15 # priority), in /etc/mk.conf (middle priority), or in the environment
16 # (lowest priority).
17 #
18 # Variables:
19 # DESTDIR is the target directory for installation of the compiled
20 # software. It defaults to /. Note that programs are built against
21 # libraries installed in DESTDIR.
22 # MKMAN, if `no', will prevent building of manual pages.
23 # MKOBJDIRS, if not `no', will build object directories at
24 # an appropriate point in a build.
25 # MKSHARE, if `no', will prevent building and installing
26 # anything in /usr/share.
27 # MKUPDATE, if not `no', will avoid a `make cleandir' at the start of
28 # `make build', as well as having the effects listed in
29 # /usr/share/mk/bsd.README.
30 # NOCLEANDIR, if defined, will avoid a `make cleandir' at the start
31 # of the `make build'.
32 # NOINCLUDES will avoid the `make includes' usually done by `make build'.
33 #
34 # See mk.conf(5) for more details.
35 #
36 #
37 # Targets:
38 # build:
39 # Builds a full release of NetBSD in DESTDIR, except for the
40 # /etc configuration files.
41 # If BUILD_DONE is set, this is an empty target.
42 # distribution:
43 # Builds a full release of NetBSD in DESTDIR, including the /etc
44 # configuration files.
45 # buildworld:
46 # As per `make distribution', except that it ensures that DESTDIR
47 # is not the root directory.
48 # installworld:
49 # Install the distribution from DESTDIR to INSTALLWORLDDIR (which
50 # defaults to the root directory). Ensures that INSTALLWORLDDIR
51 # is the not root directory if cross compiling.
52 # release:
53 # Does a `make build', and then tars up the DESTDIR files
54 # into RELEASEDIR/${MACHINE}, in release(7) format.
55 # (See etc/Makefile for more information on this.)
56 # regression-tests:
57 # Runs the regression tests in "regress" on this host.
58 # sets:
59 # Populate ${RELEASEDIR}/${MACHINE}/binary/sets from ${DESTDIR}
60 # sourcesets:
61 # Populate ${RELEASEDIR}/source/sets from ${NETBSDSRCDIR}
62 #
63 # Targets invoked by `make build,' in order:
64 # cleandir: cleans the tree.
65 # obj: creates object directories.
66 # do-tools: builds host toolchain.
67 # do-distrib-dirs: creates the distribution directories.
68 # includes: installs include files.
69 # do-tools-compat: builds the "libnbcompat" library; needed for some
70 # random host tool programs in the source tree.
71 # do-gnu-lib-crtstuff3: builds and installs prerequisites from
72 # gnu/lib/crtstuff3
73 # do-gnu-lib-libgcc3: builds and installs prerequisites from gnu/lib/libgcc3
74 # do-lib-csu: builds and installs prerequisites from lib/csu.
75 # do-lib-libc: builds and installs prerequisites from lib/libc.
76 # do-lib: builds and installs prerequisites from lib.
77 # do-gnu-lib: builds and installs prerequisites from gnu/lib.
78 # do-ld.so: builds and installs prerequisites from libexec/ld.*_so.
79 # do-build: builds and installs the entire system.
80 # do-x11: builds and installs X11R6 from src/x11 if ${MKX11} != "no"
81 # do-obsolete: installs the obsolete sets (for the postinstall-* targets).
82 #
83
84 .if ${.MAKEFLAGS:M${.CURDIR}/share/mk} == ""
85 .MAKEFLAGS: -m ${.CURDIR}/share/mk
86 .endif
87
88 #
89 # If _SRC_TOP_OBJ_ gets set here, we will end up with a directory that may
90 # not be the top level objdir, because "make obj" can happen in the *middle*
91 # of "make build" (long after <bsd.own.mk> is calculated it). So, pre-set
92 # _SRC_TOP_OBJ_ here so it will not be added to ${.MAKEOVERRIDES}.
93 #
94 _SRC_TOP_OBJ_=
95
96 .include <bsd.own.mk>
97
98 #
99 # Sanity check: make sure that "make build" is not invoked simultaneously
100 # with a standard recursive target.
101 #
102
103 .if make(build) || make(release) || make(snapshot)
104 .for targ in ${TARGETS:Nobj:Ncleandir}
105 .if make(${targ}) && !target(.BEGIN)
106 .BEGIN:
107 @echo 'BUILD ABORTED: "make build" and "make ${targ}" are mutually exclusive.'
108 @false
109 .endif
110 .endfor
111 .endif
112
113 _SUBDIR= tools lib include gnu bin games libexec sbin usr.bin
114 _SUBDIR+= usr.sbin share rescue sys etc .WAIT distrib regress
115
116 #
117 # Weed out directories that don't exist.
118 #
119
120 .for dir in ${_SUBDIR}
121 .if exists(${dir}/Makefile) && (${BUILD_${dir}:Uyes} != "no")
122 SUBDIR+= ${dir}
123 .endif
124 .endfor
125
126 .if exists(regress)
127 regression-tests: .PHONY
128 @echo Running regression tests...
129 ${MAKEDIRTARGET} regress regress
130 .endif
131
132 .if ${MKUNPRIVED} != "no"
133 NOPOSTINSTALL= # defined
134 .endif
135
136 afterinstall: .PHONY
137 .if ${MKMAN} != "no"
138 ${MAKEDIRTARGET} share/man makedb
139 .endif
140 .if (${MKUNPRIVED} != "no" && ${MKINFO} != "no")
141 ${MAKEDIRTARGET} gnu/usr.bin/texinfo/install-info infodir-meta
142 .endif
143 .if !defined(NOPOSTINSTALL)
144 ${MAKEDIRTARGET} . postinstall-check
145 .endif
146
147 postinstall-check: .PHONY
148 @echo " === Post installation checks ==="
149 ${HOST_SH} ${.CURDIR}/etc/postinstall -s ${.CURDIR} -d ${DESTDIR}/ check
150 @echo " ================================"
151
152 postinstall-fix: .NOTMAIN .PHONY
153 @echo " === Post installation fixes ==="
154 ${HOST_SH} ${.CURDIR}/etc/postinstall -s ${.CURDIR} -d ${DESTDIR}/ fix
155 @echo " ==============================="
156
157 postinstall-fix-obsolete: .NOTMAIN .PHONY
158 @echo " === Removing obsolete files ==="
159 ${HOST_SH} ${.CURDIR}/etc/postinstall -s ${.CURDIR} -d ${DESTDIR}/ fix obsolete
160 @echo " ==============================="
161
162
163 #
164 # Targets (in order!) called by "make build".
165 #
166 .if ${USE_TOOLS_TOOLCHAIN} == "no"
167 LIBGCC_EXT=3
168 .else
169 LIBGCC_EXT=
170 .endif
171
172 BUILDTARGETS+= check-tools
173 .if ${MKUPDATE} == "no" && !defined(NOCLEANDIR)
174 BUILDTARGETS+= cleandir
175 .endif
176 .if ${MKOBJDIRS} != "no"
177 BUILDTARGETS+= obj
178 .endif
179 .if ${USETOOLS} == "yes"
180 BUILDTARGETS+= do-tools
181 .endif
182 .if !defined(NODISTRIBDIRS)
183 BUILDTARGETS+= do-distrib-dirs
184 .endif
185 .if !defined(NOINCLUDES)
186 BUILDTARGETS+= includes
187 .endif
188 BUILDTARGETS+= do-tools-compat
189 BUILDTARGETS+= do-lib-csu
190 .if ${MKGCC} != "no"
191 BUILDTARGETS+= do-gnu-lib-crtstuff${LIBGCC_EXT}
192 BUILDTARGETS+= do-gnu-lib-libgcc${LIBGCC_EXT}
193 .endif
194 BUILDTARGETS+= do-lib-libc
195 BUILDTARGETS+= do-lib do-gnu-lib
196 BUILDTARGETS+= do-ld.so
197 BUILDTARGETS+= do-build
198 .if ${MKX11} != "no"
199 BUILDTARGETS+= do-x11
200 .endif
201 BUILDTARGETS+= do-obsolete
202
203 #
204 # Enforce proper ordering of some rules.
205 #
206
207 .ORDER: ${BUILDTARGETS}
208 includes-lib: .PHONY includes-include includes-sys
209 includes-gnu: .PHONY includes-lib
210
211 #
212 # Build the system and install into DESTDIR.
213 #
214
215 START_TIME!= date
216
217 build: .PHONY
218 .if defined(BUILD_DONE)
219 @echo "Build already installed into ${DESTDIR}"
220 .else
221 @echo "Build started at: ${START_TIME}"
222 .for tgt in ${BUILDTARGETS}
223 ${MAKEDIRTARGET} . ${tgt}
224 .endfor
225 ${MAKEDIRTARGET} etc install-etc-release
226 @echo "Build started at: ${START_TIME}"
227 @printf "Build finished at: " && date
228 .endif
229
230 #
231 # Build a full distribution, but not a release (i.e. no sets into
232 # ${RELEASEDIR}). "buildworld" enforces a build to ${DESTDIR} != /
233 #
234
235 distribution buildworld: .PHONY
236 .if make(buildworld) && \
237 (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
238 @echo "Won't make ${.TARGET} with DESTDIR=/"
239 @false
240 .endif
241 ${MAKEDIRTARGET} . build NOPOSTINSTALL=1
242 ${MAKEDIRTARGET} etc distribution INSTALL_DONE=1
243 .if defined(DESTDIR) && ${DESTDIR} != "" && ${DESTDIR} != "/"
244 ${MAKEDIRTARGET} . postinstall-fix-obsolete
245 ${MAKEDIRTARGET} distrib/sets checkflist
246 .endif
247 @echo "make ${.TARGET} started at: ${START_TIME}"
248 @printf "make ${.TARGET} finished at: " && date
249
250 #
251 # Install the distribution from $DESTDIR to $INSTALLWORLDDIR (defaults to `/')
252 # If installing to /, ensures that the host's operating system is NetBSD and
253 # the host's `uname -m` == ${MACHINE}.
254 #
255
256 HOST_UNAME_S!= uname -s
257 HOST_UNAME_M!= uname -m
258
259 installworld: .PHONY
260 .if (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
261 @echo "Can't make ${.TARGET} to DESTDIR=/"
262 @false
263 .endif
264 .if !defined(INSTALLWORLDDIR) || \
265 ${INSTALLWORLDDIR} == "" || ${INSTALLWORLDDIR} == "/"
266 .if (${HOST_UNAME_S} != "NetBSD")
267 @echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_S} to NetBSD with INSTALLWORLDDIR=/"
268 @false
269 .endif
270 .if (${HOST_UNAME_M} != ${MACHINE})
271 @echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_M} to ${MACHINE} with INSTALLWORLDDIR=/"
272 @false
273 .endif
274 .endif
275 ${MAKEDIRTARGET} distrib/sets installsets \
276 INSTALLDIR=${INSTALLWORLDDIR:U/} INSTALLSETS=
277 ${MAKEDIRTARGET} . postinstall-check DESTDIR=${INSTALLWORLDDIR}
278 @echo "make ${.TARGET} started at: ${START_TIME}"
279 @printf "make ${.TARGET} finished at: " && date
280
281 #
282 # Create sets from $DESTDIR or $NETBSDSRCDIR into $RELEASEDIR
283 #
284
285 .for tgt in sets sourcesets
286 ${tgt}: .PHONY
287 ${MAKEDIRTARGET} distrib/sets ${tgt}
288 .endfor
289
290 #
291 # Build a release or snapshot (implies "make build"). Note that
292 # in this case, the set lists will be checked before the tar files
293 # are made.
294 #
295
296 release snapshot: .PHONY
297 ${MAKEDIRTARGET} . build NOPOSTINSTALL=1
298 ${MAKEDIRTARGET} etc release INSTALL_DONE=1
299 @echo "make ${.TARGET} started at: ${START_TIME}"
300 @printf "make ${.TARGET} finished at: " && date
301
302 #
303 # Special components of the "make build" process.
304 #
305
306 check-tools: .PHONY
307 .if ${TOOLCHAIN_MISSING} != "no" && !defined(EXTERNAL_TOOLCHAIN)
308 @echo '*** WARNING: Building on MACHINE=${MACHINE} with missing toolchain.'
309 @echo '*** May result in a failed build or corrupt binaries!'
310 .elif defined(EXTERNAL_TOOLCHAIN)
311 @echo '*** Using external toolchain rooted at ${EXTERNAL_TOOLCHAIN}.'
312 .endif
313 .if defined(NBUILDJOBS)
314 @echo '*** WARNING: NBUILDJOBS is obsolete; use -j directly instead!'
315 .endif
316
317 do-distrib-dirs: .PHONY
318 .if !defined(DESTDIR) || ${DESTDIR} == ""
319 ${MAKEDIRTARGET} etc distrib-dirs DESTDIR=/
320 .else
321 ${MAKEDIRTARGET} etc distrib-dirs DESTDIR=${DESTDIR}
322 .endif
323
324 .for targ in cleandir obj includes
325 do-${targ}: .PHONY ${targ}
326 @true
327 .endfor
328
329 .for dir in tools tools/compat lib/csu gnu/lib/crtstuff${LIBGCC_EXT} gnu/lib/libgcc${LIBGCC_EXT} lib/libc lib/libdes lib gnu/lib
330 do-${dir:S/\//-/g}: .PHONY
331 .for targ in dependall install
332 ${MAKEDIRTARGET} ${dir} ${targ}
333 .endfor
334 .endfor
335
336 do-ld.so: .PHONY
337 .for targ in dependall install
338 .if (${OBJECT_FMT} == "a.out")
339 ${MAKEDIRTARGET} libexec/ld.aout_so ${targ}
340 .endif
341 .if (${OBJECT_FMT} == "ELF")
342 ${MAKEDIRTARGET} libexec/ld.elf_so ${targ}
343 .endif
344 .endfor
345
346 do-build: .PHONY
347 .for targ in dependall install
348 ${MAKEDIRTARGET} . ${targ} BUILD_tools=no BUILD_lib=no
349 .endfor
350
351 do-x11: .PHONY
352 ${MAKEDIRTARGET} x11 build
353
354 do-obsolete: .PHONY
355 ${MAKEDIRTARGET} etc install-obsolete-lists
356
357 #
358 # Speedup stubs for some subtrees that don't need to run these rules.
359 # (Tells <bsd.subdir.mk> not to recurse for them.)
360 #
361
362 .for dir in bin etc distrib games libexec regress sbin usr.sbin tools
363 includes-${dir}: .PHONY
364 @true
365 .endfor
366 .for dir in etc distrib regress
367 install-${dir}: .PHONY
368 @true
369 .endfor
370
371 #
372 # XXX this needs to change when distrib Makefiles are recursion compliant
373 # XXX many distrib subdirs need "cd etc && make snap_pre snap_kern" first...
374 #
375 dependall-distrib depend-distrib all-distrib: .PHONY
376 @true
377
378 .include <bsd.sys.mk>
379 .include <bsd.obj.mk>
380 .include <bsd.kernobj.mk>
381 .include <bsd.subdir.mk>
382
383 build-docs: .PHONY ${.CURDIR}/BUILDING
384 ${.CURDIR}/BUILDING: doc/BUILDING.mdoc
385 ${_MKMSG_CREATE} ${.TARGET}
386 ${TOOL_GROFF} -mdoc -Tascii -P-bou $> >$@
387
388
389 #
390 # Display current make(1) parameters
391 #
392 params: .PHONY
393 ${MAKEDIRTARGET} etc params
394