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")
124 SUBDIR+= ${dir}
125 .endif
126 .endfor
127
128 .if exists(regress)
129 regression-tests: .PHONY
130 @echo Running regression tests...
131 ${MAKEDIRTARGET} regress regress
132 .endif
133
134 .if ${MKUNPRIVED} != "no"
135 NOPOSTINSTALL= # defined
136 .endif
137
138 afterinstall: .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
151 postinstall-check: .PHONY
152 @echo " === Post installation checks ==="
153 ${HOST_SH} ${_POSTINSTALL} -s ${.CURDIR} -d ${DESTDIR}/ check
154 @echo " ================================"
155
156 postinstall-fix: .NOTMAIN .PHONY
157 @echo " === Post installation fixes ==="
158 ${HOST_SH} ${_POSTINSTALL} -s ${.CURDIR} -d ${DESTDIR}/ fix
159 @echo " ==============================="
160
161 postinstall-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"
171 LIBGCC_EXT=3
172 .else
173 LIBGCC_EXT=
174 .endif
175
176 BUILDTARGETS+= check-tools
177 .if ${MKUPDATE} == "no" && !defined(NOCLEANDIR)
178 BUILDTARGETS+= cleandir
179 .endif
180 .if ${MKOBJDIRS} != "no"
181 BUILDTARGETS+= obj
182 .endif
183 .if ${USETOOLS} == "yes"
184 BUILDTARGETS+= do-tools
185 .endif
186 .if !defined(NODISTRIBDIRS)
187 BUILDTARGETS+= do-distrib-dirs
188 .endif
189 .if !defined(NOINCLUDES)
190 BUILDTARGETS+= includes
191 .endif
192 BUILDTARGETS+= do-tools-compat
193 BUILDTARGETS+= do-lib-csu
194 .if ${MKGCC} != "no"
195 .if ${HAVE_GCC3} != "no"
196 BUILDTARGETS+= do-gnu-lib-crtstuff${LIBGCC_EXT}
197 .endif
198 BUILDTARGETS+= do-gnu-lib-libgcc${LIBGCC_EXT}
199 .endif
200 BUILDTARGETS+= do-lib-libc
201 BUILDTARGETS+= do-lib do-gnu-lib
202 BUILDTARGETS+= do-ld.so
203 BUILDTARGETS+= do-build
204 .if ${MKX11} != "no"
205 BUILDTARGETS+= do-x11
206 .endif
207 BUILDTARGETS+= do-obsolete
208
209 #
210 # Enforce proper ordering of some rules.
211 #
212
213 .ORDER: ${BUILDTARGETS}
214 includes-lib: .PHONY includes-include includes-sys
215 includes-gnu: .PHONY includes-lib
216
217 #
218 # Build the system and install into DESTDIR.
219 #
220
221 START_TIME!= date
222
223 build: .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
241 distribution 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
262 HOST_UNAME_S!= uname -s
263 HOST_UNAME_M!= uname -m
264
265 installworld: .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
302 release 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
312 check-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
323 do-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
331 do-${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
336 do-${dir:S/\//-/g}: .PHONY
337 .for targ in dependall install
338 ${MAKEDIRTARGET} ${dir} ${targ}
339 .endfor
340 .endfor
341
342 do-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
352 do-build: .PHONY
353 .for targ in dependall install
354 ${MAKEDIRTARGET} . ${targ} BUILD_tools=no BUILD_lib=no
355 .endfor
356
357 do-x11: .PHONY
358 ${MAKEDIRTARGET} x11 build
359
360 do-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
369 includes-${dir}: .PHONY
370 @true
371 .endfor
372 .for dir in etc distrib regress
373 install-${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 #
381 dependall-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
389 build-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 #
398 params: .PHONY
399 ${MAKEDIRTARGET} etc params
400