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