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