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