Makefile revision 1.162 
1#	$NetBSD: Makefile,v 1.162 2002/02/14 19:17:32 tv Exp $
2
3# This is the top-level makefile for building NetBSD. For an outline of
4# how to build a snapshot or release, as well as other release engineering
5# information, see http://www.netbsd.org/developers/releng/index.html
6#
7# Not everything you can set or do is documented in this makefile. In
8# particular, you should review the files in /usr/share/mk (especially
9# bsd.README) for general information on building programs and writing
10# Makefiles within this structure, and see the comments in src/etc/Makefile
11# for further information on installation and release set options.
12#
13# Variables listed below can be set on the make command line (highest
14# priority), in /etc/mk.conf (middle priority), or in the environment
15# (lowest priority).
16#
17# Variables:
18#   DESTDIR is the target directory for installation of the compiled
19#	software. It defaults to /. Note that programs are built against
20#	libraries installed in DESTDIR.
21#   MKMAN, if set to `no', will prevent building of manual pages.
22#   MKOBJDIRS, if not set to `no', will build object directories at 
23#	an appropriate point in a build.
24#   MKSHARE, if set to `no', will prevent building and installing
25#	anything in /usr/share.
26#   NBUILDJOBS is the number of jobs to start in parallel during a
27#	`make build'. It defaults to 1.
28#   UPDATE, if defined, will avoid a `make cleandir' at the start of
29#     `make build', as well as having the effects listed in
30#     /usr/share/mk/bsd.README.
31#   NOCLEANDIR, if defined, will avoid a `make cleandir' at the start
32#     of the `make build'.
33#   NOINCLUDES will avoid the `make includes' usually done by `make build'.
34#
35# Targets:
36#   build:
37#	Builds a full release of NetBSD in DESTDIR.  If BUILD_DONE is
38#	set, this is an empty target.
39#   release:
40#	Does a `make build,' and then tars up the DESTDIR files
41#	into RELEASEDIR, in release(7) format. (See etc/Makefile for
42#	more information on this.)
43#   regression-tests:
44#	Runs the regression tests in "regress" on this host.
45#
46# Targets invoked by `make build,' in order:
47#   cleandir:        cleans the tree.
48#   obj:             creates object directories.
49#   do-tools:        builds host toolchain.
50#   do-distrib-dirs: creates the distribution directories.
51#   includes:        installs include files.
52#   do-lib-csu:      builds and installs prerequisites from lib/csu.
53#   do-lib:          builds and installs prerequisites from lib.
54#   do-gnu-lib:      builds and installs prerequisites from gnu/lib.
55#   do-build:        builds and installs the entire system.
56
57.if ${.MAKEFLAGS:M${.CURDIR}/share/mk} == ""
58.MAKEFLAGS: -m ${.CURDIR}/share/mk
59.endif
60
61.include <bsd.own.mk>
62
63# Sanity check: make sure that "make build" is not invoked simultaneously
64# with a standard recursive target.
65
66.if make(build) || make(release) || make(snapshot)
67.for targ in ${TARGETS:Nobj:Ncleandir}
68.if make(${targ}) && !target(.BEGIN)
69.BEGIN:
70	@echo 'BUILD ABORTED: "make build" and "make ${targ}" are mutually exclusive.'
71	@false
72.endif
73.endfor
74.endif
75
76.if defined(NBUILDJOBS)
77.if !target(.BEGIN)
78.BEGIN:
79	@echo 'NBUILDJOBS is currently broken; see PR toolchain/14837.'
80	@false
81.endif
82#_J=		-j${NBUILDJOBS}
83.endif
84
85_SUBDIR=	tools lib include gnu bin games libexec sbin usr.bin \
86		usr.sbin share sys etc distrib regress
87
88# Weed out directories that don't exist.
89
90.for dir in ${_SUBDIR}
91.if exists(${dir}/Makefile) && (${BUILD_${dir}:Uyes} != "no")
92SUBDIR+=	${dir}
93.endif
94.endfor
95
96.if exists(regress)
97regression-tests:
98	@echo Running regression tests...
99	@(cd ${.CURDIR}/regress && ${MAKE} regress)
100.endif
101
102whatis.db:
103.if ${MKMAN} != "no"
104	(cd ${.CURDIR}/share/man && ${MAKE} makedb)
105.endif
106
107# XXX I wish there was a more rational place to do this, but I can't
108# think of one. There is no one place the info/dir file gets generated.
109infodir-meta:
110.if defined(UNPRIVED) && (${MKINFO} != "no")
111	echo "${DESTDIR}/usr/share/info/dir type=file mode=0644 uname=root gname=wheel" | \
112		sed -e 's|^/|./|g' -e 's|//|/|g' >>${METALOG}
113.endif
114
115afterinstall: whatis.db infodir-meta
116
117# Targets (in order!) called by "make build".
118
119BUILDTARGETS+=	check-tools
120.if !defined(UPDATE) && !defined(NOCLEANDIR)
121BUILDTARGETS+=	cleandir
122.endif
123.if ${MKOBJDIRS} != "no"
124BUILDTARGETS+=	obj
125.endif
126.if ${USETOOLS} == "yes"
127BUILDTARGETS+=	do-tools
128.endif
129.if !defined(NODISTRIBDIRS)
130BUILDTARGETS+=	do-distrib-dirs
131.endif
132.if !defined(NOINCLUDES)
133BUILDTARGETS+=	includes
134.endif
135BUILDTARGETS+=	do-lib-csu do-lib do-gnu-lib do-build
136
137# Enforce proper ordering of some rules.
138
139.ORDER:		${BUILDTARGETS}
140includes-lib:	includes-include includes-sys
141includes-gnu:	includes-lib
142
143# Build the system and install into DESTDIR.
144
145build:
146.if defined(BUILD_DONE)
147	@echo "Build already installed into ${DESTDIR}"
148.else
149	@echo -n "Build started at: " && date
150.for tgt in ${BUILDTARGETS}
151	@(cd ${.CURDIR} && ${MAKE} ${_J} ${tgt})
152.endfor
153	@echo -n "Build finished at: " && date
154.endif
155
156# Build a full distribution, but not a release (i.e. no sets into
157# ${RELEASEDIR}).
158
159distribution: build
160	(cd ${.CURDIR}/etc && ${MAKE} INSTALL_DONE=1 distribution)
161
162# Build a release or snapshot (implies "make build").
163
164release snapshot: build
165	(cd ${.CURDIR}/etc && ${MAKE} INSTALL_DONE=1 release)
166
167# Special components of the "make build" process.
168
169check-tools:
170.if defined(USE_NEW_TOOLCHAIN) && (${USE_NEW_TOOLCHAIN} != "nowarn")
171	@echo '*** WARNING:  Building on MACHINE=${MACHINE} with USE_NEW_TOOLCHAIN.'
172	@echo '*** This platform is not yet verified to work with the new toolchain,'
173	@echo '*** and may result in a failed build or corrupt binaries!'
174.endif
175
176do-distrib-dirs:
177.if !defined(DESTDIR) || ${DESTDIR} == ""
178	(cd ${.CURDIR}/etc && ${MAKE} DESTDIR=/ distrib-dirs)
179.else
180	(cd ${.CURDIR}/etc && ${MAKE} DESTDIR=${DESTDIR} distrib-dirs)
181.endif
182
183.for dir in tools lib/csu lib gnu/lib
184do-${dir:S/\//-/}:
185.for targ in dependall install
186	(cd ${.CURDIR}/${dir} && ${MAKE} ${_J} ${targ})
187.endfor
188.endfor
189
190do-build:
191.for targ in dependall install
192	(cd ${.CURDIR} && ${MAKE} ${_J} ${targ} BUILD_tools=no BUILD_lib=no)
193.endfor
194
195# Speedup stubs for some subtrees that don't need to run these rules.
196# (Tells <bsd.subdir.mk> not to recurse for them.)
197
198.for dir in bin etc distrib games libexec regress sbin usr.sbin tools
199includes-${dir}:
200	@true
201.endfor
202.for dir in etc distrib regress
203install-${dir}:
204	@true
205.endfor
206
207# XXX this needs to change when distrib Makefiles are recursion compliant
208dependall-distrib depend-distrib all-distrib:
209	@true
210
211clean:
212	rm -f METALOG
213
214.include <bsd.obj.mk>
215.include <bsd.subdir.mk>
216
217build-docs: ${.CURDIR}/BUILDING
218${.CURDIR}/BUILDING: BUILDING.mdoc
219	groff -mdoc -Tascii -P-b -P-u -P-o $> >$@
220