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