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