xref: /netbsd/Makefile (revision 98fda941)
1#	$NetBSD: Makefile,v 1.315 2015/06/27 16:21:07 matt 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 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:          record the values of variables that might affect the
91#                    build.
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#                    if ${MKCOMPAT} != "no".
97#   do-compat-lib:   builds and installs prerequisites from compat/lib
98#                    if ${MKCOMPAT} != "no".
99#   do-build:        builds and installs the entire system.
100#   do-x11:          builds and installs X11 if ${MKX11} != "no"; either
101#                    X11R7 from src/external/mit/xorg if ${X11FLAVOUR} == "Xorg"
102#                    or X11R6 from src/x11
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 gnu 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} gnu/usr.bin/texinfo/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
241BUILDTARGETS+=	do-build
242.if ${MKEXTSRC} != "no"
243BUILDTARGETS+=	do-extsrc
244.endif
245BUILDTARGETS+=	do-obsolete
246
247#
248# Enforce proper ordering of some rules.
249#
250
251.ORDER:		${BUILDTARGETS}
252includes-lib:	.PHONY includes-include includes-sys
253includes-gnu:	.PHONY includes-lib
254
255#
256# Record the values of variables that might affect the build.
257# If no values have changed, avoid updating the timestamp
258# of the params file.
259#
260# This is referenced by _NETBSD_VERSION_DEPENDS in <bsd.own.mk>.
261#
262.include "${NETBSDSRCDIR}/etc/Makefile.params"
263CLEANDIRFILES+= params
264params: .EXEC
265	${_MKMSG_CREATE} params
266	@${PRINT_PARAMS} >${.TARGET}.new
267	@if cmp -s ${.TARGET}.new ${.TARGET} > /dev/null 2>&1; then \
268		: "params is unchanged" ; \
269		rm ${.TARGET}.new ; \
270	else \
271		: "params has changed or is new" ; \
272		mv ${.TARGET}.new ${.TARGET} ; \
273	fi
274
275#
276# Display current make(1) parameters
277#
278show-params: .PHONY .MAKE
279	@${PRINT_PARAMS}
280
281#
282# Build the system and install into DESTDIR.
283#
284
285START_TIME!=	date
286
287build: .PHONY .MAKE
288.if defined(BUILD_DONE)
289	@echo "Build already installed into ${DESTDIR}"
290.else
291	@echo "Build started at: ${START_TIME}"
292.for tgt in ${BUILDTARGETS}
293	${MAKEDIRTARGET} . ${tgt}
294.endfor
295	${MAKEDIRTARGET} etc install-etc-release
296	@echo   "Build started at:  ${START_TIME}"
297	@printf "Build finished at: " && date
298.endif
299
300#
301# Build a full distribution, but not a release (i.e. no sets into
302# ${RELEASEDIR}).  "buildworld" enforces a build to ${DESTDIR} != /
303#
304
305distribution buildworld: .PHONY .MAKE
306.if make(buildworld) && \
307    (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
308	@echo "Won't make ${.TARGET} with DESTDIR=/"
309	@false
310.endif
311	${MAKEDIRTARGET} . build NOPOSTINSTALL=1
312	${MAKEDIRTARGET} etc distribution INSTALL_DONE=1
313.if defined(DESTDIR) && ${DESTDIR} != "" && ${DESTDIR} != "/"
314	${MAKEDIRTARGET} . postinstall-fix-obsolete
315	${MAKEDIRTARGET} . postinstall-fix-obsolete_stand
316	${MAKEDIRTARGET} distrib/sets checkflist
317.endif
318	@echo   "make ${.TARGET} started at:  ${START_TIME}"
319	@printf "make ${.TARGET} finished at: " && date
320
321#
322# Install the distribution from $DESTDIR to $INSTALLWORLDDIR (defaults to `/')
323# If installing to /, ensures that the host's operating system is NetBSD and
324# the host's `uname -m` == ${MACHINE}.
325#
326
327HOST_UNAME_S!=	uname -s
328HOST_UNAME_M!=	uname -m
329
330installworld: .PHONY .MAKE
331.if (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
332	@echo "Can't make ${.TARGET} to DESTDIR=/"
333	@false
334.endif
335.if !defined(INSTALLWORLDDIR) || \
336    ${INSTALLWORLDDIR} == "" || ${INSTALLWORLDDIR} == "/"
337.if (${HOST_UNAME_S} != "NetBSD")
338	@echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_S} to NetBSD with INSTALLWORLDDIR=/"
339	@false
340.endif
341.if (${HOST_UNAME_M} != ${MACHINE})
342	@echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_M} to ${MACHINE} with INSTALLWORLDDIR=/"
343	@false
344.endif
345.endif
346	${MAKEDIRTARGET} distrib/sets installsets \
347		INSTALLDIR=${INSTALLWORLDDIR:U/} INSTALLSETS=${INSTALLSETS:Q}
348	${MAKEDIRTARGET} . postinstall-check DESTDIR=${INSTALLWORLDDIR}
349	@echo   "make ${.TARGET} started at:  ${START_TIME}"
350	@printf "make ${.TARGET} finished at: " && date
351
352#
353# Install modules from $DESTDIR to $INSTALLMODULESDIR
354#
355installmodules: .PHONY .MAKE
356.if (!defined(DESTDIR) || ${DESTDIR} == "" || ${DESTDIR} == "/")
357	@echo "Can't make ${.TARGET} to DESTDIR=/"
358	@false
359.endif
360.if !defined(INSTALLMODULESDIR) || \
361    ${INSTALLMODULESDIR} == "" || ${INSTALLMODULESDIR} == "/"
362.if (${HOST_UNAME_S} != "NetBSD")
363	@echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_S} to NetBSD with INSTALLMODULESDIR=/"
364	@false
365.endif
366.if (${HOST_UNAME_M} != ${MACHINE})
367	@echo "Won't cross-make ${.TARGET} from ${HOST_UNAME_M} to ${MACHINE} with INSTALLMODULESDIR=/"
368	@false
369.endif
370.endif
371	${MAKEDIRTARGET} sys/modules install DESTDIR=${INSTALLMODULESDIR:U/}
372	@echo   "make ${.TARGET} started at:  ${START_TIME}"
373	@printf "make ${.TARGET} finished at: " && date
374
375#
376# Create sets from $DESTDIR or $NETBSDSRCDIR into $RELEASEDIR
377#
378
379.for tgt in sets sourcesets syspkgs
380${tgt}: .PHONY .MAKE
381	${MAKEDIRTARGET} distrib/sets ${tgt}
382.endfor
383
384#
385# Build a release or snapshot (implies "make distribution").  Note that
386# in this case, the set lists will be checked before the tar files
387# are made.
388#
389
390release snapshot: .PHONY .MAKE
391	${MAKEDIRTARGET} . distribution
392	${MAKEDIRTARGET} etc release DISTRIBUTION_DONE=1
393	@echo   "make ${.TARGET} started at:  ${START_TIME}"
394	@printf "make ${.TARGET} finished at: " && date
395
396#
397# Create a CD-ROM image.
398#
399
400iso-image: .PHONY
401	${MAKEDIRTARGET} distrib iso_image
402	${MAKEDIRTARGET} etc iso-image
403	@echo   "make ${.TARGET} started at:  ${START_TIME}"
404	@printf "make ${.TARGET} finished at: " && date
405
406iso-image-source: .PHONY
407	${MAKEDIRTARGET} distrib iso_image CDSOURCE=true
408	${MAKEDIRTARGET} etc iso-image
409	@echo   "make ${.TARGET} started at:  ${START_TIME}"
410	@printf "make ${.TARGET} finished at: " && date
411
412#
413# Create bootable live images.
414#
415
416live-image: .PHONY
417	${MAKEDIRTARGET} etc live-image
418	@echo   "make ${.TARGET} started at:  ${START_TIME}"
419	@printf "make ${.TARGET} finished at: " && date
420
421#
422# Create bootable installation images.
423#
424
425install-image: .PHONY
426	${MAKEDIRTARGET} etc install-image
427	@echo   "make ${.TARGET} started at:  ${START_TIME}"
428	@printf "make ${.TARGET} finished at: " && date
429
430#
431# Special components of the "make build" process.
432#
433
434check-tools: .PHONY
435.if ${TOOLCHAIN_MISSING} != "no" && !defined(EXTERNAL_TOOLCHAIN)
436	@echo '*** WARNING:  Building on MACHINE=${MACHINE} with missing toolchain.'
437	@echo '*** May result in a failed build or corrupt binaries!'
438.elif defined(EXTERNAL_TOOLCHAIN)
439	@echo '*** Using external toolchain rooted at ${EXTERNAL_TOOLCHAIN}.'
440.endif
441.if defined(NBUILDJOBS)
442	@echo '*** WARNING: NBUILDJOBS is obsolete; use -j directly instead!'
443.endif
444
445# Delete or sanitise a leftover METALOG from a previous build.
446clean_METALOG: .PHONY .MAKE
447.if ${MKUPDATE} != "no"
448	${MAKEDIRTARGET} distrib/sets clean_METALOG
449.endif
450
451do-distrib-dirs: .PHONY .MAKE
452.if !defined(DESTDIR) || ${DESTDIR} == ""
453	${MAKEDIRTARGET} etc distrib-dirs DESTDIR=/
454.else
455	${MAKEDIRTARGET} etc distrib-dirs DESTDIR=${DESTDIR}
456.endif
457
458.for targ in cleandir obj includes
459do-${targ}: .PHONY ${targ}
460	@true
461.endfor
462
463do-tools: .PHONY .MAKE
464	${MAKEDIRTARGET} tools build_install
465
466do-lib: .PHONY .MAKE
467	${MAKEDIRTARGET} lib build_install
468
469do-compat-lib: .PHONY .MAKE
470	${MAKEDIRTARGET} compat build_install BOOTSTRAP_SUBDIRS="../../../lib"
471
472do-top-obj: .PHONY .MAKE
473	${MAKEDIRTARGET} . obj NOSUBDIR=
474
475do-tools-obj: .PHONY .MAKE
476	${MAKEDIRTARGET} tools obj
477
478do-build: .PHONY .MAKE
479.for targ in dependall install
480	${MAKEDIRTARGET} . ${targ} BUILD_tools=no BUILD_lib=no
481.endfor
482
483do-x11: .PHONY .MAKE
484.if ${MKX11} != "no"
485.if ${X11FLAVOUR} == "Xorg"
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	${MAKEDIRTARGET} x11 build
493.endif
494.else
495	@echo "MKX11 is not enabled"
496	@false
497.endif
498
499do-extsrc: .PHONY .MAKE
500.if ${MKEXTSRC} != "no"
501	${MAKEDIRTARGET} extsrc build
502.else
503	@echo "MKEXTSRC is not enabled"
504	@false
505.endif
506
507do-obsolete: .PHONY .MAKE
508	${MAKEDIRTARGET} etc install-obsolete-lists
509
510#
511# Speedup stubs for some subtrees that don't need to run these rules.
512# (Tells <bsd.subdir.mk> not to recurse for them.)
513#
514
515.for dir in bin etc distrib games libexec regress sbin usr.bin usr.sbin tools
516includes-${dir}: .PHONY
517	@true
518.endfor
519.for dir in etc distrib regress
520install-${dir}: .PHONY
521	@true
522.endfor
523
524#
525# XXX this needs to change when distrib Makefiles are recursion compliant
526# XXX many distrib subdirs need "cd etc && make snap_pre snap_kern" first...
527#
528dependall-distrib depend-distrib all-distrib: .PHONY
529	@true
530
531.include <bsd.obj.mk>
532.include <bsd.kernobj.mk>
533.include <bsd.subdir.mk>
534