Makefile revision 1.338 1 # $NetBSD: Makefile,v 1.338 2023/09/08 12:01:56 riastradh 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 # NOBINARIES will not build binaries, only includes and libraries
34 #
35 # See mk.conf(5) for more details.
36 #
37 #
38 # Targets:
39 # build:
40 # Builds a full release of NetBSD in DESTDIR, except for the
41 # /etc configuration files.
42 # If BUILD_DONE is set, this is an empty target.
43 # distribution:
44 # Builds a full release of NetBSD in DESTDIR, including the /etc
45 # configuration files.
46 # buildworld:
47 # As per `make distribution', except that it ensures that DESTDIR
48 # is not the root directory.
49 # installworld:
50 # Install the distribution from DESTDIR to INSTALLWORLDDIR (which
51 # defaults to the root directory). Ensures that INSTALLWORLDDIR
52 # is not the root directory if cross compiling.
53 # release:
54 # Does a `make distribution', and then tars up the DESTDIR files
55 # into ${RELEASEDIR}/${RELEASEMACHINEDIR}, in release(7) format.
56 # (See etc/Makefile for more information on this.)
57 # regression-tests:
58 # Runs the regression tests in "regress" on this host.
59 # sets:
60 # Populate ${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/sets
61 # from ${DESTDIR}
62 # sourcesets:
63 # Populate ${RELEASEDIR}/source/sets from ${NETBSDSRCDIR}
64 # syspkgs:
65 # Populate ${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/syspkgs
66 # from ${DESTDIR}
67 # iso-image:
68 # Create CD-ROM image in RELEASEDIR/images.
69 # RELEASEDIR must already have been populated by `make release'
70 # or equivalent.
71 # iso-image-source:
72 # Create CD-ROM image with source in RELEASEDIR/images.
73 # RELEASEDIR must already have been populated by
74 # `make release sourcesets' or equivalent.
75 # live-image:
76 # Create bootable live image for emulators or USB stick etc.
77 # in RELEASEDIR/liveimage.
78 # RELEASEDIR must already have been populated by `make release'
79 # or equivalent.
80 # install-image:
81 # Create bootable installation image for USB stick etc.
82 # in RELEASEDIR/installimage.
83 # RELEASEDIR must already have been populated by `make release'
84 # or equivalent.
85 #
86 # Targets invoked by `make build,' in order:
87 # cleandir: cleans the tree.
88 # do-top-obj: creates the top level object directory.
89 # do-tools-obj: creates object directories for the host toolchain.
90 # do-tools: builds host toolchain.
91 # params: create params file with various make(1) parameters.
92 # show-params: show various make(1) parameters.
93 # obj: creates object directories.
94 # do-distrib-dirs: creates the distribution directories.
95 # includes: installs include files.
96 # do-lib: builds and installs prerequisites from lib.
97 # do-compat-lib: builds and installs prerequisites from compat/lib
98 # if ${MKCOMPAT} != "no".
99 # do-x11: builds and installs X11 tools and libraries
100 # from src/external/mit/xorg if ${MKX11} != "no".
101 # do-build: builds and installs the entire system.
102 # do-obsolete: installs the obsolete sets (for the postinstall-* targets).
103 #
104
105 .if ${.MAKEFLAGS:M${.CURDIR}/share/mk} == ""
106 .MAKEFLAGS: -m ${.CURDIR}/share/mk
107 .endif
108
109 #
110 # If _SRC_TOP_OBJ_ gets set here, we will end up with a directory that may
111 # not be the top level objdir, because "make obj" can happen in the *middle*
112 # of "make build" (long after <bsd.own.mk> is calculated it). So, pre-set
113 # _SRC_TOP_OBJ_ here so it will not be added to ${.MAKEOVERRIDES}.
114 #
115 _SRC_TOP_OBJ_=
116
117 .include <bsd.own.mk>
118
119 #
120 # Sanity check: make sure that "make build" is not invoked simultaneously
121 # with a standard recursive target.
122 #
123
124 .if make(build) || make(release) || make(snapshot)
125 .for targ in ${TARGETS:Nobj:Ncleandir}
126 .if make(${targ}) && !target(.BEGIN)
127 .BEGIN:
128 @echo 'BUILD ABORTED: "make build" and "make ${targ}" are mutually exclusive.'
129 @false
130 .endif
131 .endfor
132 .endif
133
134 #
135 # _SUBDIR is used to set SUBDIR, after removing directories that have
136 # BUILD_${dir}=no, or that have no ${dir}/Makefile.
137 #
138 _SUBDIR= tools .WAIT lib
139 .if ${MKLLVM} != "no"
140 _SUBDIR+= external/bsd/compiler_rt
141 .endif
142 _SUBDIR+= include external crypto/external bin
143 _SUBDIR+= games libexec sbin usr.bin
144 _SUBDIR+= usr.sbin share sys etc tests compat
145 _SUBDIR+= .WAIT rescue .WAIT distrib regress
146
147 .for dir in ${_SUBDIR}
148 .if "${dir}" == ".WAIT" \
149 || (${BUILD_${dir}:Uyes} != "no" && exists(${dir}/Makefile))
150 SUBDIR+= ${dir}
151 .endif
152 .endfor
153
154 .if exists(regress)
155 regression-tests: .PHONY .MAKE
156 @echo Running regression tests...
157 ${MAKEDIRTARGET} regress regress
158 .endif
159
160 .if ${MKUNPRIVED} != "no"
161 NOPOSTINSTALL= # defined
162 .endif
163
164 afterinstall: .PHONY .MAKE
165 .if ${MKMAN} != "no"
166 ${MAKEDIRTARGET} share/man makedb
167 .endif
168 .if (${MKUNPRIVED} != "no" && ${MKINFO} != "no")
169 ${MAKEDIRTARGET} external/gpl2/texinfo/bin/install-info infodir-meta
170 .endif
171 .if !defined(NOPOSTINSTALL)
172 ${MAKEDIRTARGET} . postinstall-check
173 .endif
174
175 _POSTINSTALL= ${:!cd ${.CURDIR}/usr.sbin/postinstall && \
176 ${MAKE} -v .OBJDIR!}/postinstall \
177 -m ${MACHINE} -a ${MACHINE_ARCH}
178 _POSTINSTALL_ENV= \
179 AWK=${TOOL_AWK:Q} \
180 DB=${TOOL_DB:Q} \
181 HOST_SH=${HOST_SH:Q} \
182 MAKE=${MAKE:Q} \
183 PWD_MKDB=${TOOL_PWD_MKDB:Q} \
184 SED=${TOOL_SED:Q} \
185 STAT=${TOOL_STAT:Q}
186
187 .if ${MKX11} != "no"
188 _POSTINSTALL_X11=-x ${X11SRCDIR:Q}
189 .endif
190
191 postinstall-check: .PHONY
192 @echo " === Post installation checks ==="
193 ${_POSTINSTALL_ENV} ${HOST_SH} ${_POSTINSTALL} -s ${.CURDIR} ${_POSTINSTALL_X11} -d ${DESTDIR:C/^\/$//}/ check; if [ $$? -gt 1 ]; then exit 1; fi
194 @echo " ================================"
195
196 postinstall-fix: .NOTMAIN .PHONY
197 @echo " === Post installation fixes ==="
198 ${_POSTINSTALL_ENV} ${HOST_SH} ${_POSTINSTALL} -s ${.CURDIR} ${_POSTINSTALL_X11} -d ${DESTDIR:C/^\/$//}/ fix
199 @echo " ==============================="
200
201 postinstall-fix-obsolete: .NOTMAIN .PHONY
202 @echo " === Removing obsolete files ==="
203 ${_POSTINSTALL_ENV} ${HOST_SH} ${_POSTINSTALL} -s ${.CURDIR} ${_POSTINSTALL_X11} -d ${DESTDIR:C/^\/$//}/ fix obsolete
204 @echo " ==============================="
205
206 postinstall-fix-obsolete_stand: .NOTMAIN .PHONY
207 @echo " === Removing obsolete files ==="
208 ${_POSTINSTALL_ENV} ${HOST_SH} ${_POSTINSTALL} -s ${.CURDIR} ${_POSTINSTALL_X11} -d ${DESTDIR:C/^\/$//}/ fix obsolete_stand
209 ${_POSTINSTALL_ENV} ${HOST_SH} ${_POSTINSTALL} -s ${.CURDIR} ${_POSTINSTALL_X11} -d ${DESTDIR:C/^\/$//}/ fix obsolete_stand_debug
210 @echo " ==============================="
211
212
213 #
214 # Targets (in order!) called by "make build".
215 #
216 BUILDTARGETS+= check-tools
217 .if ${MKUPDATE} == "no" && !defined(NOCLEANDIR)
218 BUILDTARGETS+= cleandir
219 .endif
220 .if ${MKOBJDIRS} != "no"
221 BUILDTARGETS+= do-top-obj
222 .endif
223 .if ${USETOOLS} == "yes" # {
224 .if ${MKOBJDIRS} != "no"
225 BUILDTARGETS+= do-tools-obj
226 .endif
227 BUILDTARGETS+= do-tools
228 .endif # USETOOLS # }
229 BUILDTARGETS+= params
230 .if ${MKOBJDIRS} != "no"
231 BUILDTARGETS+= obj
232 .endif
233 BUILDTARGETS+= clean_METALOG
234 .if !defined(NODISTRIBDIRS)
235 BUILDTARGETS+= do-distrib-dirs
236 .endif
237 .if !defined(NOINCLUDES)
238 BUILDTARGETS+= includes
239 .endif
240 BUILDTARGETS+= do-lib
241 BUILDTARGETS+= do-compat-lib
242 .if ${MKLLVM} != "no"
243 BUILDTARGETS+= do-sanitizer
244 .if ${MKSANITIZER:Uno} == "yes"
245 BUILDTARGETS+= do-sanitizer-tools
246 .endif
247 .endif
248 .if ${MKX11} != "no"
249 BUILDTARGETS+= do-x11
250 .endif
251 .if !defined(NOBINARIES)
252 BUILDTARGETS+= do-build
253 BUILDTARGETS+= do-obsolete
254 .endif
255
256 #
257 # Enforce proper ordering of some rules.
258 #
259
260 .ORDER: ${BUILDTARGETS}
261 includes-lib: .PHONY includes-include includes-sys
262
263 #
264 # Record the values of variables that might affect the build.
265 # If no values have changed, avoid updating the timestamp
266 # of the params file.
267 #
268 # This is referenced by _NETBSD_VERSION_DEPENDS in <bsd.own.mk>.
269 #
270 .include "${NETBSDSRCDIR}/etc/Makefile.params"
271 CLEANDIRFILES+= params
272 params: .EXEC
273 ${_MKMSG_CREATE} params
274 @${PRINT_PARAMS} >${.TARGET}.new
275 @if cmp -s ${.TARGET}.new ${.TARGET} > /dev/null 2>&1; then \
276 : "params is unchanged" ; \
277 rm ${.TARGET}.new ; \
278 else \
279 : "params has changed or is new" ; \
280 mv ${.TARGET}.new ${.TARGET} ; \
281 fi
282
283 #
284 # Display current make(1) parameters
285 #
286 show-params: .PHONY .MAKE
287 @${PRINT_PARAMS}
288
289 #
290 # Build the system and install into DESTDIR.
291 #
292
293 START_TIME!= date
294
295 build: .PHONY .MAKE
296 .if defined(BUILD_DONE)
297 @echo "Build already installed into ${DESTDIR}"
298 .else
299 @echo "Build started at: ${START_TIME}"
300 .for tgt in ${BUILDTARGETS}
301 ${MAKEDIRTARGET} . ${tgt}
302 .endfor
303 ${MAKEDIRTARGET} etc install-etc-release
304 @echo "Build started at: ${START_TIME}"
305 @printf "Build finished at: " && date
306 .endif
307
308 #
309 # Build a full distribution, but not a release (i.e. no sets into
310 # ${RELEASEDIR}). "buildworld" enforces a build to ${DESTDIR} != /
311 #
312
313 distribution buildworld: .PHONY .MAKE
314 .if make(buildworld) && \
315 (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
316 @echo "Won't make ${.TARGET} with DESTDIR=/"
317 @false
318 .endif
319 ${MAKEDIRTARGET} . build NOPOSTINSTALL=1
320 ${MAKEDIRTARGET} etc distribution INSTALL_DONE=1
321 .if defined(DESTDIR) && ${DESTDIR} != "" && ${DESTDIR} != "/"
322 ${MAKEDIRTARGET} . postinstall-fix-obsolete
323 ${MAKEDIRTARGET} . postinstall-fix-obsolete_stand
324 ${MAKEDIRTARGET} distrib/sets checkflist
325 .endif
326 @echo "make ${.TARGET} started at: ${START_TIME}"
327 @printf "make ${.TARGET} finished at: " && date
328
329 #
330 # Install the distribution from $DESTDIR to $INSTALLWORLDDIR (defaults to `/')
331 # If installing to /, ensures that the host's operating system is NetBSD and
332 # the host's `uname -m` == ${MACHINE}.
333 #
334
335 HOST_UNAME_S!= uname -s
336 HOST_UNAME_M!= uname -m
337
338 installworld: .PHONY .MAKE
339 .if (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
340 @echo "Can't make ${.TARGET} to DESTDIR=/"
341 @false
342 .endif
343 .if !defined(INSTALLWORLDDIR) || \
344 ${INSTALLWORLDDIR} == "" || ${INSTALLWORLDDIR} == "/"
345 .if (${HOST_UNAME_S} != "NetBSD")
346 @echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_S} to NetBSD with INSTALLWORLDDIR=/"
347 @false
348 .endif
349 .if (${HOST_UNAME_M} != ${MACHINE})
350 @echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_M} to ${MACHINE} with INSTALLWORLDDIR=/"
351 @false
352 .endif
353 .endif
354 ${MAKEDIRTARGET} distrib/sets installsets \
355 INSTALLDIR=${INSTALLWORLDDIR:U/} INSTALLSETS=${INSTALLSETS:Q}
356 ${MAKEDIRTARGET} . postinstall-check DESTDIR=${INSTALLWORLDDIR}
357 @echo "make ${.TARGET} started at: ${START_TIME}"
358 @printf "make ${.TARGET} finished at: " && date
359
360 #
361 # Install modules from $DESTDIR to $INSTALLMODULESDIR
362 #
363 installmodules: .PHONY .MAKE
364 .if (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
365 @echo "Can't make ${.TARGET} to DESTDIR=/"
366 @false
367 .endif
368 .if !defined(INSTALLMODULESDIR) || \
369 ${INSTALLMODULESDIR} == "" || ${INSTALLMODULESDIR} == "/"
370 .if (${HOST_UNAME_S} != "NetBSD")
371 @echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_S} to NetBSD with INSTALLMODULESDIR=/"
372 @false
373 .endif
374 .if (${HOST_UNAME_M} != ${MACHINE})
375 @echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_M} to ${MACHINE} with INSTALLMODULESDIR=/"
376 @false
377 .endif
378 .endif
379 ${MAKEDIRTARGET} sys/modules install DESTDIR=${INSTALLMODULESDIR:U/}
380 @echo "make ${.TARGET} started at: ${START_TIME}"
381 @printf "make ${.TARGET} finished at: " && date
382
383 #
384 # Create sets from $DESTDIR or $NETBSDSRCDIR into $RELEASEDIR
385 #
386
387 .for tgt in sets sourcesets syspkgs
388 ${tgt}: .PHONY .MAKE
389 ${MAKEDIRTARGET} distrib/sets ${tgt}
390 .endfor
391
392 #
393 # Build a release or snapshot (implies "make distribution"). Note that
394 # in this case, the set lists will be checked before the tar files
395 # are made.
396 #
397
398 release snapshot: .PHONY .MAKE
399 ${MAKEDIRTARGET} . distribution
400 ${MAKEDIRTARGET} etc release DISTRIBUTION_DONE=1
401 @echo "make ${.TARGET} started at: ${START_TIME}"
402 @printf "make ${.TARGET} finished at: " && date
403
404 #
405 # Create a CD-ROM image.
406 #
407
408 iso-image: .PHONY
409 ${MAKEDIRTARGET} distrib iso_image
410 ${MAKEDIRTARGET} etc iso-image
411 @echo "make ${.TARGET} started at: ${START_TIME}"
412 @printf "make ${.TARGET} finished at: " && date
413
414 iso-image-source: .PHONY
415 ${MAKEDIRTARGET} distrib iso_image CDSOURCE=true
416 ${MAKEDIRTARGET} etc iso-image
417 @echo "make ${.TARGET} started at: ${START_TIME}"
418 @printf "make ${.TARGET} finished at: " && date
419
420 #
421 # Create bootable live images.
422 #
423
424 live-image: .PHONY
425 ${MAKEDIRTARGET} etc live-image
426 @echo "make ${.TARGET} started at: ${START_TIME}"
427 @printf "make ${.TARGET} finished at: " && date
428
429 #
430 # Create bootable installation images.
431 #
432
433 install-image: .PHONY
434 ${MAKEDIRTARGET} etc install-image
435 @echo "make ${.TARGET} started at: ${START_TIME}"
436 @printf "make ${.TARGET} finished at: " && date
437
438 #
439 # Special components of the "make build" process.
440 #
441
442 check-tools: .PHONY
443 .if ${TOOLCHAIN_MISSING} != "no" && !defined(EXTERNAL_TOOLCHAIN)
444 @echo '*** WARNING: Building on MACHINE=${MACHINE} with missing toolchain.'
445 @echo '*** May result in a failed build or corrupt binaries!'
446 .elif defined(EXTERNAL_TOOLCHAIN)
447 @echo '*** Using external toolchain rooted at ${EXTERNAL_TOOLCHAIN}.'
448 .endif
449
450 # Delete or sanitise a leftover METALOG from a previous build.
451 clean_METALOG: .PHONY .MAKE
452 .if ${MKUPDATE} != "no"
453 ${MAKEDIRTARGET} distrib/sets clean_METALOG
454 .endif
455
456 do-distrib-dirs: .PHONY .MAKE
457 .if !defined(DESTDIR) || ${DESTDIR} == ""
458 ${MAKEDIRTARGET} etc distrib-dirs DESTDIR=/
459 .else
460 ${MAKEDIRTARGET} etc distrib-dirs DESTDIR=${DESTDIR}
461 .endif
462
463 .for targ in cleandir obj includes
464 do-${targ}: .PHONY ${targ}
465 @true
466 .endfor
467
468 do-tools: .PHONY .MAKE
469 ${MAKEDIRTARGET} tools build_install
470
471 do-lib: .PHONY .MAKE
472 ${MAKEDIRTARGET} lib build_install
473
474 do-compat-lib: .PHONY .MAKE
475 ${MAKEDIRTARGET} compat build_install BOOTSTRAP_SUBDIRS="../../../lib"
476
477 do-sanitizer: .PHONY .MAKE
478 ${MAKEDIRTARGET} external/bsd/compiler_rt build_install
479
480 do-sanitizer-tools: .PHONY .MAKE
481 .if !exists(${TOOLDIR}/lib/clang) && ${HAVE_LLVM:Uno} == "yes"
482 mkdir -p ${TOOLDIR}/lib/clang
483 cd ${DESTDIR}/usr/lib/clang && \
484 ${TOOL_PAX} -rw . ${TOOLDIR}/lib/clang
485 .endif
486
487 do-top-obj: .PHONY .MAKE
488 ${MAKEDIRTARGET} . obj NOSUBDIR=
489
490 do-tools-obj: .PHONY .MAKE
491 ${MAKEDIRTARGET} tools obj
492
493 do-build: .PHONY .MAKE
494 .for targ in dependall install
495 ${MAKEDIRTARGET} . ${targ} BUILD_tools=no BUILD_lib=no
496 .endfor
497
498 do-x11: .PHONY .MAKE
499 .if ${MKX11} != "no"
500 ${MAKEDIRTARGET} external/mit/xorg/tools all
501 ${MAKEDIRTARGET} external/mit/xorg/lib build_install
502 .if ${MKCOMPATX11} != "no"
503 ${MAKEDIRTARGET} compat build_install BOOTSTRAP_SUBDIRS="../../../external/mit/xorg/lib"
504 .endif
505 .else
506 @echo "MKX11 is not enabled"
507 @false
508 .endif
509
510 do-obsolete: .PHONY .MAKE
511 ${MAKEDIRTARGET} etc install-obsolete-lists
512
513 #
514 # Speedup stubs for some subtrees that don't need to run these rules.
515 # (Tells <bsd.subdir.mk> not to recurse for them.)
516 #
517
518 .for dir in bin etc distrib games libexec regress sbin usr.bin usr.sbin tools
519 includes-${dir}: .PHONY
520 @true
521 .endfor
522 .for dir in etc distrib regress
523 install-${dir}: .PHONY
524 @true
525 .endfor
526
527 #
528 # XXX this needs to change when distrib Makefiles are recursion compliant
529 # XXX many distrib subdirs need "cd etc && make snap_pre snap_kern" first...
530 #
531 dependall-distrib depend-distrib all-distrib: .PHONY
532 @true
533
534 .include <bsd.obj.mk>
535 .include <bsd.kernobj.mk>
536 .include <bsd.subdir.mk>
537 .include <bsd.clean.mk>
538