xref: /freebsd/share/mk/bsd.opts.mk (revision 63a938566d524836885917d95bd491aa4400b181)
1# $FreeBSD$
2#
3# Option file for src builds.
4#
5# Users define WITH_FOO and WITHOUT_FOO on the command line or in /etc/src.conf
6# and /etc/make.conf files. These translate in the build system to MK_FOO={yes,no}
7# with (usually) sensible defaults.
8#
9# Makefiles must include bsd.opts.mk after defining specific MK_FOO options that
10# are applicable for that Makefile (typically there are none, but sometimes there
11# are exceptions). Recursive makes usually add MK_FOO=no for options that they wish
12# to omit from that make.
13#
14# Makefiles must include bsd.mkopt.mk before they test the value of any MK_FOO
15# variable.
16#
17# Makefiles may also assume that this file is included by bsd.own.mk should it
18# need variables defined there prior to the end of the Makefile where
19# bsd.{subdir,lib.bin}.mk is traditionally included.
20#
21# The old-style YES_FOO and NO_FOO are being phased out. No new instances of them
22# should be added. Old instances should be removed since they were just to
23# bridge the gap between FreeBSD 4 and FreeBSD 5.
24#
25# Makefiles should never test WITH_FOO or WITHOUT_FOO directly (although an
26# exception is made for _WITHOUT_SRCONF which turns off this mechanism
27# completely).
28#
29
30.if !target(__<bsd.opts.mk>__)
31__<bsd.opts.mk>__:
32
33.if !defined(_WITHOUT_SRCCONF)
34#
35# Define MK_* variables (which are either "yes" or "no") for users
36# to set via WITH_*/WITHOUT_* in /etc/src.conf and override in the
37# make(1) environment.
38# These should be tested with `== "no"' or `!= "no"' in makefiles.
39# The NO_* variables should only be set by makefiles for variables
40# that haven't been converted over.
41#
42
43# Only these options are used by bsd.*.mk. KERBEROS and OPENSSH are
44# unfortunately needed to support statically linking the entire
45# tree. su(1) wouldn't link since it depends on PAM which depends on
46# ssh libraries when building with OPENSSH, and likewise for KERBEROS.
47
48# All other variables used to build /usr/src live in src.opts.mk
49# and variables from both files are documented in src.conf(5).
50
51__DEFAULT_YES_OPTIONS = \
52    ASSERT_DEBUG \
53    DEBUG_FILES \
54    DOCCOMPRESS \
55    INCLUDES \
56    INSTALLLIB \
57    KERBEROS \
58    MAKE_CHECK_USE_SANDBOX \
59    MAN \
60    MANCOMPRESS \
61    NIS \
62    NLS \
63    OPENSSH \
64    PROFILE \
65    SSP \
66    SYMVER \
67    TESTS \
68    TOOLCHAIN \
69    WARNS
70
71__DEFAULT_NO_OPTIONS = \
72    CCACHE_BUILD \
73    CTF \
74    INSTALL_AS_USER \
75    STALE_STAGED
76
77__DEFAULT_DEPENDENT_OPTIONS = \
78    MAKE_CHECK_USE_SANDBOX/TESTS \
79    STAGING_MAN/STAGING \
80    STAGING_PROG/STAGING \
81    STALE_STAGED/STAGING \
82
83
84.include <bsd.mkopt.mk>
85
86#
87# Supported NO_* options (if defined, MK_* will be forced to "no",
88# regardless of user's setting).
89#
90# These are transitional and will disappaer in the FreeBSD 12.
91#
92.for var in \
93    CTF \
94    DEBUG_FILES \
95    INSTALLLIB \
96    MAN \
97    PROFILE \
98    WARNS
99.if defined(NO_${var})
100.warning "NO_${var} is defined, but deprecated. Please use MK_${var}=no instead."
101MK_${var}:=no
102.endif
103.endfor
104
105.include <bsd.cpu.mk>
106
107.endif # !_WITHOUT_SRCCONF
108
109.endif
110