Makefile revision 1.201 
1#	$NetBSD: Makefile,v 1.201 2003/04/03 00:41:50 mycroft 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 set to `no', will prevent building of manual pages.
23#   MKOBJDIRS, if not set to `no', will build object directories at
24#	an appropriate point in a build.
25#   MKSHARE, if set to `no', will prevent building and installing
26#	anything in /usr/share.
27#   UPDATE, if defined, 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# Targets:
35#   build:
36#	Builds a full release of NetBSD in DESTDIR, except for the
37#	/etc configuration files.
38#	If BUILD_DONE is set, this is an empty target.
39#   distribution:
40#	Builds a full release of NetBSD in DESTDIR, including the /etc
41#	configuration files.
42#   buildworld:
43#	As per `make distribution', except that it ensures that DESTDIR
44#	is not the root directory.
45#   installworld:
46#	Install the distribution from DESTDIR to INSTALLWORLDDIR (which
47#	defaults to the root directory).  Ensures that INSTALLWORLDDIR
48#	is the not root directory if cross compiling.
49#   release:
50#	Does a `make build', and then tars up the DESTDIR files
51#	into RELEASEDIR/${MACHINE}, in release(7) format.
52#	(See etc/Makefile for more information on this.)
53#   regression-tests:
54#	Runs the regression tests in "regress" on this host.
55#
56# Targets invoked by `make build,' in order:
57#   cleandir:        cleans the tree.
58#   obj:             creates object directories.
59#   do-tools:        builds host toolchain.
60#   do-distrib-dirs: creates the distribution directories.
61#   includes:        installs include files.
62#   do-lib-csu:      builds and installs prerequisites from lib/csu.
63#   do-lib-libc:     builds and installs prerequisites from lib/libc.
64#   do-lib-libcrypt: builds and installs prerequisites from lib/libcrypt.
65#   do-lib:          builds and installs prerequisites from lib.
66#   do-gnu-lib:      builds and installs prerequisites from gnu/lib.
67#   do-ld.so:        builds and installs prerequisites from libexec/ld.*_so.
68#   do-build:        builds and installs the entire system.
69#
70
71.if ${.MAKEFLAGS:M${.CURDIR}/share/mk} == ""
72.MAKEFLAGS: -m ${.CURDIR}/share/mk
73.endif
74
75#
76# If _SRC_TOP_OBJ_ gets set here, we will end up with a directory that may
77# not be the top level objdir, because "make obj" can happen in the *middle*
78# of "make build" (long after <bsd.own.mk> is calculated it).  So, pre-set
79# _SRC_TOP_OBJ_ here so it will not be added to ${.MAKEOVERRIDES}.
80#
81_SRC_TOP_OBJ_=
82
83.include <bsd.own.mk>
84
85#
86# Sanity check: make sure that "make build" is not invoked simultaneously
87# with a standard recursive target.
88#
89
90.if make(build) || make(release) || make(snapshot)
91.for targ in ${TARGETS:Nobj:Ncleandir}
92.if make(${targ}) && !target(.BEGIN)
93.BEGIN:
94	@echo 'BUILD ABORTED: "make build" and "make ${targ}" are mutually exclusive.'
95	@false
96.endif
97.endfor
98.endif
99
100_SUBDIR=	tools lib include gnu bin games libexec sbin usr.bin
101_SUBDIR+=	usr.sbin share rescue sys etc distrib regress
102
103#
104# Weed out directories that don't exist.
105#
106
107.for dir in ${_SUBDIR}
108.if exists(${dir}/Makefile) && (${BUILD_${dir}:Uyes} != "no")
109SUBDIR+=	${dir}
110.endif
111.endfor
112
113.if exists(regress)
114regression-tests:
115	@echo Running regression tests...
116	@(cd ${.CURDIR}/regress && ${MAKE} regress)
117.endif
118
119.if defined(UNPRIVED)
120NOPOSTINSTALL=	# defined
121.endif
122
123afterinstall:
124.if ${MKMAN} != "no"
125	(cd ${.CURDIR}/share/man && ${MAKE} makedb)
126.endif
127.if defined(UNPRIVED) && (${MKINFO} != "no")
128	(cd ${.CURDIR}/gnu/usr.bin/texinfo/install-info && ${MAKE} infodir-meta)
129.endif
130.if !defined(NOPOSTINSTALL)
131	(cd ${.CURDIR} && ${MAKE} postinstall-check)
132.endif
133
134postinstall-check:
135	@echo "   === Post installation checks ==="
136	sh ${.CURDIR}/etc/postinstall -s ${.CURDIR} -d ${DESTDIR}/ check
137	@echo "   ================================"
138
139postinstall-fix: .NOTMAIN
140	@echo "   === Post installation fixes ==="
141	sh ${.CURDIR}/etc/postinstall -s ${.CURDIR} -d ${DESTDIR}/ fix
142	@echo "   ================================"
143
144
145#
146# Targets (in order!) called by "make build".
147#
148
149BUILDTARGETS+=	check-tools
150.if !defined(UPDATE) && !defined(NOCLEANDIR)
151BUILDTARGETS+=	cleandir
152.endif
153.if ${MKOBJDIRS} != "no"
154BUILDTARGETS+=	obj
155.endif
156.if ${USETOOLS} == "yes"
157BUILDTARGETS+=	do-tools
158.endif
159.if !defined(NODISTRIBDIRS)
160BUILDTARGETS+=	do-distrib-dirs
161.endif
162.if !defined(NOINCLUDES)
163BUILDTARGETS+=	includes
164.endif
165BUILDTARGETS+=	do-lib-csu do-lib-libc do-lib-libcrypt do-lib do-gnu-lib do-ld.so do-build
166BUILDTARGETS+=	do-obsolete
167
168#
169# Enforce proper ordering of some rules.
170#
171
172.ORDER:		${BUILDTARGETS}
173includes-lib:	includes-include includes-sys
174includes-gnu:	includes-lib
175
176#
177# Build the system and install into DESTDIR.
178#
179
180START_TIME!=	date
181
182build:
183.if defined(BUILD_DONE)
184	@echo "Build already installed into ${DESTDIR}"
185.else
186	@echo "Build started at: ${START_TIME}"
187.for tgt in ${BUILDTARGETS}
188	@(cd ${.CURDIR} && ${MAKE} ${tgt})
189.endfor
190	@echo   "Build started at:  ${START_TIME}"
191	@printf "Build finished at: " && date
192.endif
193
194#
195# Build a full distribution, but not a release (i.e. no sets into
196# ${RELEASEDIR}).  "buildworld" enforces a build to ${DESTDIR} != /
197#
198
199distribution buildworld:
200.if make(buildworld) && \
201    (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
202	@echo "Won't make ${.TARGET} with DESTDIR=/"
203	@false
204.endif
205	(cd ${.CURDIR} && ${MAKE} NOPOSTINSTALL=1 build)
206	(cd ${.CURDIR}/etc && ${MAKE} INSTALL_DONE=1 distribution)
207.if defined(DESTDIR) && ${DESTDIR} != "" && ${DESTDIR} != "/"
208	(cd ${.CURDIR}/distrib/sets && ${MAKE} checkflist)
209.endif
210	@echo   "make ${.TARGET} started at:  ${START_TIME}"
211	@printf "make ${.TARGET} finished at: " && date
212
213#
214# Install the distribution from $DESTDIR to $INSTALLWORLDDIR (defaults to `/')
215# If installing to /, ensures that the host's operating system is NetBSD and
216# the host's `uname -m` == ${MACHINE}.
217#
218
219HOST_UNAME_S!=	uname -s
220HOST_UNAME_M!=	uname -m
221
222installworld:
223.if (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
224	@echo "Can't make ${.TARGET} to DESTDIR=/"
225	@false
226.endif
227.if !defined(INSTALLWORLDDIR) || \
228    ${INSTALLWORLDDIR} == "" || ${INSTALLWORLDDIR} == "/"
229.if (${HOST_UNAME_S} != "NetBSD")
230	@echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_S} to NetBSD with INSTALLWORLDDIR=/"
231	@false
232.endif
233.if (${HOST_UNAME_M} != ${MACHINE})
234	@echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_M} to ${MACHINE} with INSTALLWORLDDIR=/"
235	@false
236.endif
237.endif
238	(cd ${.CURDIR}/distrib/sets && \
239	    ${MAKE} INSTALLDIR=${INSTALLWORLDDIR:U/} INSTALLSETS= installsets)
240	(cd ${.CURDIR} && \
241	    ${MAKE} DESTDIR=${INSTALLWORLDDIR} postinstall-check)
242	@echo   "make ${.TARGET} started at:  ${START_TIME}"
243	@printf "make ${.TARGET} finished at: " && date
244
245#
246# Create sets from $DESTDIR into $RELEASEDIR
247#
248
249sets:
250	(cd ${.CURDIR}/distrib/sets && ${MAKE} maketars)
251
252#
253# Build a release or snapshot (implies "make build").  Note that
254# in this case, the set lists will be checked before the tar files
255# are made.
256#
257
258release snapshot:
259	(cd ${.CURDIR} && ${MAKE} NOPOSTINSTALL=1 build)
260	(cd ${.CURDIR}/etc && ${MAKE} INSTALL_DONE=1 release)
261	@echo   "make ${.TARGET} started at:  ${START_TIME}"
262	@printf "make ${.TARGET} finished at: " && date
263
264#
265# Special components of the "make build" process.
266#
267
268check-tools:
269.if ${TOOLCHAIN_MISSING} == "yes" && !defined(EXTERNAL_TOOLCHAIN)
270	@echo '*** WARNING:  Building on MACHINE=${MACHINE} with missing toolchain.'
271	@echo '*** May result in a failed build or corrupt binaries!'
272.elif defined(EXTERNAL_TOOLCHAIN)
273	@echo '*** Using external toolchain rooted at ${EXTERNAL_TOOLCHAIN}.'
274.endif
275.if defined(NBUILDJOBS)
276	@echo '*** WARNING: NBUILDJOBS is obsolete; use -j directly instead!'
277.endif
278
279do-distrib-dirs:
280.if !defined(DESTDIR) || ${DESTDIR} == ""
281	(cd ${.CURDIR}/etc && ${MAKE} DESTDIR=/ distrib-dirs)
282.else
283	(cd ${.CURDIR}/etc && ${MAKE} DESTDIR=${DESTDIR} distrib-dirs)
284.endif
285
286.for targ in cleandir obj includes
287do-${targ}: ${targ}
288	@true
289.endfor
290
291.for dir in tools lib/csu lib/libc lib/libcrypt lib gnu/lib
292do-${dir:S/\//-/}:
293.for targ in dependall install
294	(cd ${.CURDIR}/${dir} && ${MAKE} ${targ})
295.endfor
296.endfor
297
298do-ld.so:
299.for targ in dependall install
300.if (${OBJECT_FMT} == "a.out")
301	(cd ${.CURDIR}/libexec/ld.aout_so && ${MAKE} ${targ})
302.endif
303.if (${OBJECT_FMT} == "ELF")
304	(cd ${.CURDIR}/libexec/ld.elf_so && ${MAKE} ${targ})
305.endif
306.endfor
307
308do-build:
309.for targ in dependall install
310	(cd ${.CURDIR} && ${MAKE} ${targ} BUILD_tools=no BUILD_lib=no)
311.endfor
312
313do-obsolete:
314	(cd ${.CURDIR}/etc && ${MAKE} install-obsolete-lists)
315
316#
317# Speedup stubs for some subtrees that don't need to run these rules.
318# (Tells <bsd.subdir.mk> not to recurse for them.)
319#
320
321.for dir in bin etc distrib games libexec regress sbin usr.sbin tools
322includes-${dir}:
323	@true
324.endfor
325.for dir in etc distrib regress
326install-${dir}:
327	@true
328.endfor
329
330#
331# XXX this needs to change when distrib Makefiles are recursion compliant
332# XXX many distrib subdirs need "cd etc && make snap_pre snap_kern" first...
333#
334dependall-distrib depend-distrib all-distrib:
335	@true
336
337.include <bsd.obj.mk>
338.include <bsd.subdir.mk>
339
340build-docs: ${.CURDIR}/BUILDING
341${.CURDIR}/BUILDING: doc/BUILDING.mdoc
342	groff -mdoc -Tascii -P-b -P-u -P-o $> >$@
343