Makefile.params revision 1.12 
1#	$NetBSD: Makefile.params,v 1.12 2014/08/03 09:19:34 apb Exp $
2#
3# Makefile fragment for printing build parameters.
4#
5# Public variables:
6#	RELEASEVARS
7#		List of variables whose value should be printed.
8#
9#	PRINT_PARAMS
10#		A command to print the desired variables and values
11#		to stdout, without any additional debugging information.
12#		Values are printed as single-quoted strings, with
13#		embedded quotes and newlines escaped in a way that's
14#		acceptable to sh(1).  Undefined values are printed
15#		as "(undefined)" (without quotation marks).
16#
17# Internal targets:
18# 	_params:
19#		Prints the names and values of all the variables
20#		listed in ${RELEASEVARS}.  The desired results may be
21#		redirected somewhere other than stdout, for example by
22#		setting _params_redirect='>&3'.	 stdout and stderr may
23#		contain unwanted debugging information, from make and
24#		the shell.
25#
26# Internal variables:
27#	_params_redirect:
28#		If set, this should be a shell redirection specification, such
29#		as '>&3', controlling where the output from "make _params" will
30#		be sent.
31#
32# Example:
33#	. ${NETBSDSRCDIR}/etc/Makefile.params
34#	show-params: .MAKE .PHONY # print params to stdout
35#		@${PRINT_PARAMS}
36#
37
38.include <bsd.own.mk>	# for some variables
39
40RELEASEVARS=	BSDOBJDIR BSDSRCDIR BUILDID BUILDINFO BUILDSEED \
41		DESTDIR DISTRIBVER EXTERNAL_TOOLCHAIN HAVE_GCC HAVE_GDB \
42		HAVE_LLVM HAVE_PCC INSTALLWORLDDIR \
43		KERNARCHDIR KERNCONFDIR KERNOBJDIR KERNSRCDIR \
44		MACHINE MACHINE_ARCH MAKE MAKECONF MAKEFLAGS \
45		MAKEOBJDIR MAKEOBJDIRPREFIX MAKEVERBOSE \
46		MKARZERO MKATF MKBFD MKBINUTILS MKCATPAGES \
47		MKCRYPTO MKCRYPTO_RC5 MKCTF MKCVS \
48		MKDEBUG MKDEBUGLIB MKDOC MKDTRACE MKDYNAMICROOT \
49		MKGCC MKGCCCMDS MKGDB \
50		MKHESIOD MKHTML MKIEEEFP MKINET6 MKINFO MKIPFILTER \
51		MKKERBEROS MKKYUA MKLDAP MKLINKLIB MKLINT MKLLVM \
52		MKMAN MKMANZ MKMDNS MKNLS MKNPF MKOBJ MKOBJDIRS \
53		MKPAM MKPCC MKPF MKPIC MKPICINSTALL MKPICLIB MKPOSTFIX \
54		MKPROFILE MKREPRO \
55		MKSHARE MKSKEY MKSOFTFLOAT MKSTATICLIB \
56		MKUNPRIVED MKUPDATE MKX11 MKYP \
57		NBUILDJOBS NETBSDSRCDIR \
58		NOCLEANDIR NODISTRIBDIRS NOINCLUDES \
59		OBJMACHINE \
60		RELEASEDIR RELEASEMACHINEDIR TOOLCHAIN_MISSING TOOLDIR \
61		USE_HESIOD USE_INET6 USE_JEMALLOC USE_KERBEROS USE_LDAP \
62		USE_PAM USE_SKEY USE_YP \
63		USETOOLS USR_OBJMACHINE \
64		X11SRCDIR X11FLAVOUR
65
66
67#
68# Duplicate the DISTRIBVER setting from src/etc/Makefile.
69#
70.ifndef DISTRIBVER
71DISTRIBVER!=	${HOST_SH} ${NETBSDSRCDIR}/sys/conf/osrelease.sh
72.endif
73
74#
75# _params does the printing.
76#
77_params_redirect?= # empty
78
79_params: .PHONY
80.for var in ${RELEASEVARS}
81.if defined(${var})
82	@printf "%20s = '%-s'\n" ${var} ${${var}:C/'/'\\\\''/gW:Q} \
83	    ${_params_redirect}
84.else
85	@printf "%20s = (undefined)\n" ${var} \
86	    ${_params_redirect}
87.endif
88.endfor
89
90# PRINT_PARAMS:
91#
92# The output from the "make _params" can include the following types of
93# unwanted lines:
94#
95#     make -j prints "--- _params ---";
96#
97#     if MAKEVERBOSE is set to 3 or more then make prints each "printf"
98#     command in addition to executing it;
99#
100#     if MAKEVERBOSE is set to 4 then the shell prints each command
101#     (prefixed with "+").
102#
103# So the resulting output can look like this:
104#
105#	--- _params ---
106#	+ echo 'printf "%20s = '\''%-s'\''\n" BSDOBJDIR /usr/obj'
107#	printf "%20s = '%-s'\n" BSDOBJDIR /usr/obj
108#	+ printf '%20s = '\''%-s'\''\n' BSDOBJDIR /usr/obj
109#	           BSDOBJDIR = '/usr/obj'
110#	+ echo 'printf "%20s = '\''%-s'\''\n" BSDSRCDIR /usr/src'
111#	printf "%20s = '%-s'\n" BSDSRCDIR /usr/src
112#	+ printf '%20s = '\''%-s'\''\n' BSDSRCDIR /usr/src
113#	           BSDSRCDIR = '/usr/src'
114#	[...]
115#
116# where what we want is just this:
117#
118#	           BSDOBJDIR = '/usr/obj'
119#	           BSDSRCDIR = '/usr/src'
120#	           [...]
121#
122# The shell redirections in ${PRINT_PARAMS} ensure that the unwanted
123# noise is discarded (via ">/dev/null"), while the desired information
124# ends up on the subshell's stdout (via ">&3" and "3>&1").  The value
125# of _params_redirect is passed in the environment instead of on the
126# command line, to prevent it from appearing in MAKEFLAGS (which would
127# appear in the output).
128#
129PRINT_PARAMS:=	(_params_redirect='>&3' ${MAKE} -f ${.PARSEDIR:Q}/${.PARSEFILE:Q} _params 3>&1 >/dev/null)
130