Sync usage with man page.
[netbsd-mini2440.git] / Makefile
bloba7770aaba3f73ac34ab5e76da92a61d25efbff97
1 # $NetBSD: Makefile,v 1.275 2009/11/30 16:13:22 uebayasi Exp $
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
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.
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).
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'.
34 # See mk.conf(5) for more details.
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 distribution', and then tars up the DESTDIR files
54 # into ${RELEASEDIR}/${RELEASEMACHINEDIR}, 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}/${RELEASEMACHINEDIR}/binary/sets
60 # from ${DESTDIR}
61 # sourcesets:
62 # Populate ${RELEASEDIR}/source/sets from ${NETBSDSRCDIR}
63 # syspkgs:
64 # Populate ${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/syspkgs
65 # from ${DESTDIR}
66 # iso-image:
67 # Create CD-ROM image in RELEASEDIR/iso.
68 # RELEASEDIR must already have been populated by `make release'
69 # or equivalent.
70 # iso-image-source:
71 # Create CD-ROM image with source in RELEASEDIR/iso.
72 # RELEASEDIR must already have been populated by
73 # `make release sourcesets' or equivalent.
75 # Targets invoked by `make build,' in order:
76 # cleandir: cleans the tree.
77 # do-top-obj: creates the top level object directory.
78 # do-tools-obj: creates object directories for the host toolchain.
79 # do-tools: builds host toolchain.
80 # obj: creates object directories.
81 # do-distrib-dirs: creates the distribution directories.
82 # includes: installs include files.
83 # do-tools-compat: builds the "libnbcompat" library; needed for some
84 # random host tool programs in the source tree.
85 # do-lib-csu: builds and installs prerequisites from lib/csu.
86 # do-libgcc: builds and installs prerequisites from
87 # gnu/lib/crtstuff${LIBGCC_EXT} (if necessary) and
88 # gnu/lib/libgcc${LIBGCC_EXT}.
89 # do-libpcc: builds and install prerequisites from
90 # external/bsd/pcc/crtstuff and external/bsd/pcc/libpcc.
91 # do-lib-libc: builds and installs prerequisites from lib/libc.
92 # do-lib: builds and installs prerequisites from lib.
93 # do-gnu-lib: builds and installs prerequisites from gnu/lib.
94 # do-external-lib: builds and installs prerequisites from external/lib.
95 # do-sys-rump-dev-lib: builds and installs prerequisites from sys/rump/dev/lib
96 # do-sys-rump-fs-lib: builds and installs prerequisites from sys/rump/fs/lib
97 # do-sys-rump-net-lib: builds and installs prerequisites from sys/rump/net/lib
98 # do-sys-modules: builds and installs kernel modules (used by rump binaries)
99 # do-ld.so: builds and installs prerequisites from libexec/ld.*_so.
100 # do-compat-lib-csu: builds and installs prerequisites from compat/lib/csu
101 # if ${MKCOMPAT} != "no".
102 # do-compat-libgcc: builds and installs prerequisites from
103 # compat/gnu/lib/crtstuff${LIBGCC_EXT} (if necessary) and
104 # compat/gnu/lib/libgcc${LIBGCC_EXT} if ${MKCOMPAT} != "no".
105 # do-compat-lib-libc: builds and installs prerequisites from compat/lib/libc
106 # if ${MKCOMPAT} != "no".
107 # do-build: builds and installs the entire system.
108 # do-x11: builds and installs X11 if ${MKX11} != "no"; either
109 # X11R7 from src/external/mit/xorg if ${X11FLAVOUR} == "Xorg"
110 # or X11R6 from src/x11
111 # do-extsrc: builds and installs extsrc if ${MKEXTSRC} != "no".
112 # do-obsolete: installs the obsolete sets (for the postinstall-* targets).
115 .if ${.MAKEFLAGS:M${.CURDIR}/share/mk} == ""
116 .MAKEFLAGS: -m ${.CURDIR}/share/mk
117 .endif
120 # If _SRC_TOP_OBJ_ gets set here, we will end up with a directory that may
121 # not be the top level objdir, because "make obj" can happen in the *middle*
122 # of "make build" (long after <bsd.own.mk> is calculated it). So, pre-set
123 # _SRC_TOP_OBJ_ here so it will not be added to ${.MAKEOVERRIDES}.
125 _SRC_TOP_OBJ_=
127 .include <bsd.own.mk>
130 # Sanity check: make sure that "make build" is not invoked simultaneously
131 # with a standard recursive target.
134 .if make(build) || make(release) || make(snapshot)
135 .for targ in ${TARGETS:Nobj:Ncleandir}
136 .if make(${targ}) && !target(.BEGIN)
137 .BEGIN:
138 @echo 'BUILD ABORTED: "make build" and "make ${targ}" are mutually exclusive.'
139 @false
140 .endif
141 .endfor
142 .endif
145 # _SUBDIR is used to set SUBDIR, after removing directories that have
146 # BUILD_${dir}=no, or that have no ${dir}/Makefile.
148 _SUBDIR= tools lib include gnu external crypto/external bin games
149 _SUBDIR+= libexec sbin usr.bin
150 _SUBDIR+= usr.sbin share rescue sys etc tests compat .WAIT distrib regress
152 .for dir in ${_SUBDIR}
153 .if "${dir}" == ".WAIT" \
154 || (${BUILD_${dir}:Uyes} != "no" && exists(${dir}/Makefile))
155 SUBDIR+= ${dir}
156 .endif
157 .endfor
159 .if exists(regress)
160 regression-tests: .PHONY .MAKE
161 @echo Running regression tests...
162 ${MAKEDIRTARGET} regress regress
163 .endif
165 .if ${MKUNPRIVED} != "no"
166 NOPOSTINSTALL= # defined
167 .endif
169 afterinstall: .PHONY .MAKE
170 .if ${MKMAN} != "no"
171 ${MAKEDIRTARGET} share/man makedb
172 .endif
173 .if (${MKUNPRIVED} != "no" && ${MKINFO} != "no")
174 ${MAKEDIRTARGET} gnu/usr.bin/texinfo/install-info infodir-meta
175 .endif
176 .if !defined(NOPOSTINSTALL)
177 ${MAKEDIRTARGET} . postinstall-check
178 .endif
180 _POSTINSTALL= ${.CURDIR}/usr.sbin/postinstall/postinstall
182 postinstall-check: .PHONY
183 @echo " === Post installation checks ==="
184 AWK=${TOOL_AWK:Q} MAKE=${MAKE:Q} ${HOST_SH} ${_POSTINSTALL} -s ${.CURDIR} -d ${DESTDIR}/ check; if [ $$? -gt 1 ]; then exit 1; fi
185 @echo " ================================"
187 postinstall-fix: .NOTMAIN .PHONY
188 @echo " === Post installation fixes ==="
189 AWK=${TOOL_AWK:Q} MAKE=${MAKE:Q} ${HOST_SH} ${_POSTINSTALL} -s ${.CURDIR} -d ${DESTDIR}/ fix
190 @echo " ==============================="
192 postinstall-fix-obsolete: .NOTMAIN .PHONY
193 @echo " === Removing obsolete files ==="
194 AWK=${TOOL_AWK:Q} MAKE=${MAKE:Q} ${HOST_SH} ${_POSTINSTALL} -s ${.CURDIR} -d ${DESTDIR}/ fix obsolete
195 @echo " ==============================="
199 # Targets (in order!) called by "make build".
201 .if defined(HAVE_GCC)
202 .if ${HAVE_GCC} == "3"
203 LIBGCC_EXT=3
204 .else
205 LIBGCC_EXT=4
206 .endif
207 .endif
209 BUILDTARGETS+= check-tools
210 .if ${MKUPDATE} == "no" && !defined(NOCLEANDIR)
211 BUILDTARGETS+= cleandir
212 .endif
213 .if ${MKOBJDIRS} != "no"
214 BUILDTARGETS+= do-top-obj
215 .endif
216 .if ${USETOOLS} == "yes" # {
217 .if ${MKOBJDIRS} != "no"
218 BUILDTARGETS+= do-tools-obj
219 .endif
220 BUILDTARGETS+= do-tools
221 .endif # USETOOLS # }
222 .if ${MKOBJDIRS} != "no"
223 BUILDTARGETS+= obj
224 .endif
225 BUILDTARGETS+= clean_METALOG
226 .if !defined(NODISTRIBDIRS)
227 BUILDTARGETS+= do-distrib-dirs
228 .endif
229 .if !defined(NOINCLUDES)
230 BUILDTARGETS+= includes
231 .endif
232 BUILDTARGETS+= do-tools-compat
233 BUILDTARGETS+= do-lib-csu
234 .if ${MKGCC} != "no"
235 BUILDTARGETS+= do-libgcc
236 .endif
237 .if ${MKPCC} != "no"
238 BUILDTARGET+= do-libpcc
239 .endif
240 BUILDTARGETS+= do-lib-libc
241 BUILDTARGETS+= do-lib do-gnu-lib do-external-lib
242 .if (${MACHINE} != "evbppc") && ${MKKMOD} != "no"
243 BUILDTARGETS+= do-sys-modules
244 .endif
245 BUILDTARGETS+= do-sys-rump-dev-lib do-sys-rump-fs-lib do-sys-rump-net-lib
246 .if ${MKCOMPAT} != "no"
247 BUILDTARGETS+= do-compat-lib-csu
248 BUILDTARGETS+= do-compat-libgcc
249 BUILDTARGETS+= do-compat-lib-libc
250 .endif
251 BUILDTARGETS+= do-ld.so
252 BUILDTARGETS+= do-build
253 .if ${MKX11} != "no"
254 BUILDTARGETS+= do-x11
255 .endif
256 .if ${MKEXTSRC} != "no"
257 BUILDTARGETS+= do-extsrc
258 .endif
259 BUILDTARGETS+= do-obsolete
262 # Enforce proper ordering of some rules.
265 .ORDER: ${BUILDTARGETS}
266 includes-lib: .PHONY includes-include includes-sys
267 includes-gnu: .PHONY includes-lib
270 # Build the system and install into DESTDIR.
273 START_TIME!= date
275 build: .PHONY .MAKE
276 .if defined(BUILD_DONE)
277 @echo "Build already installed into ${DESTDIR}"
278 .else
279 @echo "Build started at: ${START_TIME}"
280 .for tgt in ${BUILDTARGETS}
281 ${MAKEDIRTARGET} . ${tgt}
282 .endfor
283 ${MAKEDIRTARGET} etc install-etc-release
284 @echo "Build started at: ${START_TIME}"
285 @printf "Build finished at: " && date
286 .endif
289 # Build a full distribution, but not a release (i.e. no sets into
290 # ${RELEASEDIR}). "buildworld" enforces a build to ${DESTDIR} != /
293 distribution buildworld: .PHONY .MAKE
294 .if make(buildworld) && \
295 (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
296 @echo "Won't make ${.TARGET} with DESTDIR=/"
297 @false
298 .endif
299 ${MAKEDIRTARGET} . build NOPOSTINSTALL=1
300 ${MAKEDIRTARGET} etc distribution INSTALL_DONE=1
301 .if defined(DESTDIR) && ${DESTDIR} != "" && ${DESTDIR} != "/"
302 ${MAKEDIRTARGET} . postinstall-fix-obsolete
303 ${MAKEDIRTARGET} distrib/sets checkflist
304 .endif
305 @echo "make ${.TARGET} started at: ${START_TIME}"
306 @printf "make ${.TARGET} finished at: " && date
309 # Install the distribution from $DESTDIR to $INSTALLWORLDDIR (defaults to `/')
310 # If installing to /, ensures that the host's operating system is NetBSD and
311 # the host's `uname -m` == ${MACHINE}.
314 HOST_UNAME_S!= uname -s
315 HOST_UNAME_M!= uname -m
317 installworld: .PHONY .MAKE
318 .if (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
319 @echo "Can't make ${.TARGET} to DESTDIR=/"
320 @false
321 .endif
322 .if !defined(INSTALLWORLDDIR) || \
323 ${INSTALLWORLDDIR} == "" || ${INSTALLWORLDDIR} == "/"
324 .if (${HOST_UNAME_S} != "NetBSD")
325 @echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_S} to NetBSD with INSTALLWORLDDIR=/"
326 @false
327 .endif
328 .if (${HOST_UNAME_M} != ${MACHINE})
329 @echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_M} to ${MACHINE} with INSTALLWORLDDIR=/"
330 @false
331 .endif
332 .endif
333 ${MAKEDIRTARGET} distrib/sets installsets \
334 INSTALLDIR=${INSTALLWORLDDIR:U/} INSTALLSETS=
335 ${MAKEDIRTARGET} . postinstall-check DESTDIR=${INSTALLWORLDDIR}
336 @echo "make ${.TARGET} started at: ${START_TIME}"
337 @printf "make ${.TARGET} finished at: " && date
340 # Create sets from $DESTDIR or $NETBSDSRCDIR into $RELEASEDIR
343 .for tgt in sets sourcesets syspkgs
344 ${tgt}: .PHONY .MAKE
345 ${MAKEDIRTARGET} distrib/sets ${tgt}
346 .endfor
349 # Build a release or snapshot (implies "make distribution"). Note that
350 # in this case, the set lists will be checked before the tar files
351 # are made.
354 release snapshot: .PHONY .MAKE
355 ${MAKEDIRTARGET} . distribution
356 ${MAKEDIRTARGET} etc release DISTRIBUTION_DONE=1
357 @echo "make ${.TARGET} started at: ${START_TIME}"
358 @printf "make ${.TARGET} finished at: " && date
361 # Create a CD-ROM image.
364 iso-image: .PHONY
365 ${MAKEDIRTARGET} distrib iso_image
366 ${MAKEDIRTARGET} etc iso-image
367 @echo "make ${.TARGET} started at: ${START_TIME}"
368 @printf "make ${.TARGET} finished at: " && date
370 iso-image-source: .PHONY
371 ${MAKEDIRTARGET} distrib iso_image CDSOURCE=true
372 ${MAKEDIRTARGET} etc iso-image
373 @echo "make ${.TARGET} started at: ${START_TIME}"
374 @printf "make ${.TARGET} finished at: " && date
377 # Special components of the "make build" process.
380 check-tools: .PHONY
381 .if ${TOOLCHAIN_MISSING} != "no" && !defined(EXTERNAL_TOOLCHAIN)
382 @echo '*** WARNING: Building on MACHINE=${MACHINE} with missing toolchain.'
383 @echo '*** May result in a failed build or corrupt binaries!'
384 .elif defined(EXTERNAL_TOOLCHAIN)
385 @echo '*** Using external toolchain rooted at ${EXTERNAL_TOOLCHAIN}.'
386 .endif
387 .if defined(NBUILDJOBS)
388 @echo '*** WARNING: NBUILDJOBS is obsolete; use -j directly instead!'
389 .endif
391 # Delete or sanitise a leftover METALOG from a previous build.
392 clean_METALOG: .PHONY .MAKE
393 .if ${MKUPDATE} != "no"
394 ${MAKEDIRTARGET} distrib/sets clean_METALOG
395 .endif
397 do-distrib-dirs: .PHONY .MAKE
398 .if !defined(DESTDIR) || ${DESTDIR} == ""
399 ${MAKEDIRTARGET} etc distrib-dirs DESTDIR=/
400 .else
401 ${MAKEDIRTARGET} etc distrib-dirs DESTDIR=${DESTDIR}
402 .endif
404 .for targ in cleandir obj includes
405 do-${targ}: .PHONY ${targ}
406 @true
407 .endfor
409 .if defined(HAVE_GCC)
410 BUILD_CC_LIB= gnu/lib/crtstuff${LIBGCC_EXT}
411 BUILD_CC_LIB+= gnu/lib/libgcc${LIBGCC_EXT}
412 .elif defined(HAVE_PCC)
413 BUILD_CC_LIB+= external/bsd/pcc/crtstuff
414 BUILD_CC_LIB+= external/bsd/pcc/libpcc
415 .endif
417 .for dir in tools tools/compat lib/csu ${BUILD_CC_LIB} lib/libc lib/libdes lib gnu/lib external/lib crypto/external/lib sys/rump/dev/lib sys/rump/fs/lib sys/rump/net/lib sys/modules
418 do-${dir:S/\//-/g}: .PHONY .MAKE
419 .for targ in dependall install
420 ${MAKEDIRTARGET} ${dir} ${targ}
421 .endfor
422 .endfor
424 .if ${MKCOMPAT} != "no"
425 COMPAT_SUBDIR_LIST=lib/csu ${BUILD_CC_LIB} lib/libc
426 .for dir in ${COMPAT_SUBDIR_LIST}
427 do-compat-${dir:S/\//-/g}: .PHONY .MAKE
428 .for targ in obj dependall install
429 ${MAKEDIRTARGET} compat ${targ} BOOTSTRAP_SUBDIRS="../../../${dir}"
430 .endfor
431 .endfor
432 .endif
434 do-top-obj: .PHONY .MAKE
435 ${MAKEDIRTARGET} . obj NOSUBDIR=
437 do-tools-obj: .PHONY .MAKE
438 ${MAKEDIRTARGET} tools obj
440 do-libgcc: .PHONY .MAKE
441 .if defined(HAVE_GCC)
442 .if ${MKGCC} != "no"
443 .if (${HAVE_GCC} == "3" || ${HAVE_GCC} == "4")
444 ${MAKEDIRTARGET} . do-gnu-lib-crtstuff${LIBGCC_EXT}
445 .endif
446 ${MAKEDIRTARGET} . do-gnu-lib-libgcc${LIBGCC_EXT}
447 .endif
448 .endif
450 do-compat-libgcc: .PHONY .MAKE
451 .if defined(HAVE_GCC)
452 .if ${MKGCC} != "no"
453 ${MAKEDIRTARGET} . do-compat-gnu-lib-crtstuff${LIBGCC_EXT}
454 ${MAKEDIRTARGET} . do-compat-gnu-lib-libgcc${LIBGCC_EXT}
455 .endif
456 .endif
458 do-libpcc: .PHONY .MAKE
459 .if defined(HAVE_PCC)
460 .if ${MKPCC} != "no"
461 ${MAKEDIRTARGET} . do-pcc-lib-crtstuff
462 ${MAKEDIRTARGET} . do-pcc-lib-libpcc
463 .endif
464 .endif
466 do-ld.so: .PHONY .MAKE
467 .for targ in dependall install
468 .if (${OBJECT_FMT} == "a.out")
469 ${MAKEDIRTARGET} libexec/ld.aout_so ${targ}
470 .endif
471 .if (${OBJECT_FMT} == "ELF")
472 ${MAKEDIRTARGET} libexec/ld.elf_so ${targ}
473 .endif
474 .endfor
476 do-build: .PHONY .MAKE
477 .for targ in dependall install
478 ${MAKEDIRTARGET} . ${targ} BUILD_tools=no BUILD_lib=no
479 .endfor
481 do-x11: .PHONY .MAKE
482 .if ${MKX11} != "no"
483 .if ${X11FLAVOUR} == "Xorg"
484 ${MAKEDIRTARGET} external/mit/xorg build
485 .else
486 ${MAKEDIRTARGET} x11 build
487 .endif
488 .else
489 @echo "MKX11 is not enabled"
490 @false
491 .endif
493 do-extsrc: .PHONY .MAKE
494 .if ${MKEXTSRC} != "no"
495 ${MAKEDIRTARGET} extsrc build
496 .else
497 @echo "MKEXTSRC is not enabled"
498 @false
499 .endif
501 do-obsolete: .PHONY .MAKE
502 ${MAKEDIRTARGET} etc install-obsolete-lists
505 # Speedup stubs for some subtrees that don't need to run these rules.
506 # (Tells <bsd.subdir.mk> not to recurse for them.)
509 .for dir in bin etc distrib games libexec regress sbin usr.sbin tools
510 includes-${dir}: .PHONY
511 @true
512 .endfor
513 .for dir in etc distrib regress
514 install-${dir}: .PHONY
515 @true
516 .endfor
519 # XXX this needs to change when distrib Makefiles are recursion compliant
520 # XXX many distrib subdirs need "cd etc && make snap_pre snap_kern" first...
522 dependall-distrib depend-distrib all-distrib: .PHONY
523 @true
525 .include <bsd.sys.mk>
526 .include <bsd.obj.mk>
527 .include <bsd.kernobj.mk>
528 .include <bsd.subdir.mk>
530 build-docs: .PHONY ${.CURDIR}/BUILDING
531 ${.CURDIR}/BUILDING: doc/BUILDING.mdoc
532 ${_MKMSG_CREATE} ${.TARGET}
533 ${TOOL_GROFF} -mdoc -Tascii -P-bou $> >$@
537 # Display current make(1) parameters
539 params: .PHONY .MAKE
540 ${MAKEDIRTARGET} etc params