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