2 # This Source Code Form is subject to the terms of the Mozilla Public
3 # License, v. 2.0. If a copy of the MPL was not distributed with this
4 # file, You can obtain one at http://mozilla.org/MPL/2.0/.
9 # Determines the platform and builds the macros needed to load the
10 # appropriate platform-specific .mk file, then defines all (most?)
11 # of the generic macros.
14 varize
= $(subst -,_
,$(subst a
,A
,$(subst b
,B
,$(subst c
,C
,$(subst d
,D
,$(subst e
,E
,$(subst f
,F
,$(subst g
,G
,$(subst h
,H
,$(subst i
,I
,$(subst j
,J
,$(subst k
,K
,$(subst l
,L
,$(subst m
,M
,$(subst n
,N
,$(subst o
,O
,$(subst p
,P
,$(subst q
,Q
,$(subst r
,R
,$(subst s
,S
,$(subst t
,T
,$(subst u
,U
,$(subst v
,V
,$(subst w
,W
,$(subst x
,X
,$(subst y
,Y
,$(subst z
,Z
,$1)))))))))))))))))))))))))))
16 # Define an include-at-most-once flag
17 ifdef INCLUDED_CONFIG_MK
18 $(error Do not
include config.mk twice
!)
20 INCLUDED_CONFIG_MK
= 1
22 EXIT_ON_ERROR
= set
-e
; # Shell loops continue past errors without this.
28 ifndef INCLUDED_AUTOCONF_MK
29 include $(DEPTH
)/config
/autoconf.mk
32 -include $(DEPTH
)/.mozconfig.mk
34 # MDDEPDIR is the subdirectory where dependency files are stored
37 ifndef EXTERNALLY_MANAGED_MAKE_FILE
38 # Import the automatically generated backend file. If this file doesn't exist,
39 # the backend hasn't been properly configured. We want this to be a fatal
40 # error, hence not using "-include".
41 ifndef STANDALONE_MAKEFILE
42 GLOBAL_DEPS
+= backend.mk
45 # Add e.g. `export:: $(EXPORT_TARGETS)` rules. The *_TARGETS variables are defined
47 $(foreach tier
,$(RUNNABLE_TIERS
),$(eval
$(tier
):: $($(call varize
,$(tier
))_TARGETS
)))
52 space
= $(NULL
) $(NULL
)
54 # Include defs.mk files that can be found in $(srcdir)/$(DEPTH),
55 # $(srcdir)/$(DEPTH-1), $(srcdir)/$(DEPTH-2), etc., and $(srcdir)
56 # where $(DEPTH-1) is one level less of depth, $(DEPTH-2), two, etc.
57 # i.e. for DEPTH=../../.., DEPTH-1 is ../.. and DEPTH-2 is ..
58 # These defs.mk files are used to define variables in a directory
59 # and all its subdirectories, recursively.
60 __depth
:= $(subst /, ,$(DEPTH
))
64 $(foreach __d
,$(__depth
) .
,$(eval __depth
= $(wordlist
2,$(words $(__depth
)),$(__depth
))$(eval
-include $(subst $(space
),/,$(strip $(srcdir) $(__depth
) defs.mk
)))))
68 # Sanity check some variables
80 # checks for internal spaces or trailing spaces in the variable
82 check-variable
= $(if
$(filter-out 0 1,$(words $($(x
))z
)),$(error Spaces are not allowed in
$(x
)))
84 $(foreach x
,$(CHECK_VARS
),$(check-variable
))
86 ifndef INCLUDED_FUNCTIONS_MK
87 include $(MOZILLA_DIR
)/config
/makefiles
/functions.mk
92 # FINAL_TARGET specifies the location into which we copy end-user-shipped
93 # build products (typelibs, components, chrome). It may already be specified by
96 # If XPI_NAME is set, the files will be shipped to $(DIST)/xpi-stage/$(XPI_NAME)
97 # instead of $(DIST)/bin. In both cases, if DIST_SUBDIR is set, the files will be
98 # shipped to a $(DIST_SUBDIR) subdirectory.
99 FINAL_TARGET ?
= $(if
$(XPI_NAME
),$(DIST
)/xpi-stage
/$(XPI_NAME
),$(DIST
)/bin
)$(DIST_SUBDIR
:%=/%)
100 # Override the stored value for the check to make sure that the variable is not
101 # redefined in the Makefile.in value.
102 FINAL_TARGET_FROZEN
:= '$(FINAL_TARGET)'
105 ACDEFINES
+= -DXPI_NAME
=$(XPI_NAME
)
108 CC
:= $(CC_WRAPPER
) $(CC
)
109 CXX
:= $(CXX_WRAPPER
) $(CXX
)
115 # Build using PIC by default
119 # Don't build SIMPLE_PROGRAMS with PGO, since they don't need it anyway,
120 # and we don't have the same build logic to re-link them in the second pass.
121 ifdef SIMPLE_PROGRAMS
122 NO_PROFILE_GUIDED_OPTIMIZE
= 1
125 # No sense in profiling unit tests
127 NO_PROFILE_GUIDED_OPTIMIZE
= 1
130 # Enable profile-based feedback
131 ifneq (1,$(NO_PROFILE_GUIDED_OPTIMIZE
))
132 ifdef MOZ_PROFILE_GENERATE
133 PGO_CFLAGS
+= -DNS_FREE_PERMANENT_DATA
=1
134 PGO_CFLAGS
+= $(if
$(filter $(notdir $<),$(notdir $(NO_PROFILE_GUIDED_OPTIMIZE
))),,$(PROFILE_GEN_CFLAGS
))
135 PGO_LDFLAGS
+= $(PROFILE_GEN_LDFLAGS
)
136 endif # MOZ_PROFILE_GENERATE
138 ifdef MOZ_PROFILE_USE
139 PGO_CFLAGS
+= $(if
$(filter $(notdir $<),$(notdir $(NO_PROFILE_GUIDED_OPTIMIZE
))),,$(PROFILE_USE_CFLAGS
))
140 PGO_LDFLAGS
+= $(PROFILE_USE_LDFLAGS
)
141 endif # MOZ_PROFILE_USE
142 endif # NO_PROFILE_GUIDED_OPTIMIZE
144 # Overloaded by comm builds to refer to $(commtopsrcdir), so that
145 # `mail` resolves in en-US builds and in repacks.
146 LOCALE_TOPDIR ?
= $(topsrcdir
)
148 -t
$(LOCALE_TOPDIR
) \
149 -f
$(MOZ_JAR_MAKER_FILE_FORMAT
) \
152 ifdef USE_EXTENSION_MANIFEST
153 MAKE_JARS_FLAGS
+= -e
156 TAR_CREATE_FLAGS
= -chf
159 # Default command macros; can be overridden in <arch>.mk.
167 -I
$(ABS_DIST
)/include \
170 include $(MOZILLA_DIR
)/config
/static-checking-config.mk
177 LDFLAGS
= $(MOZ_LTO_LDFLAGS
) $(COMPUTED_LDFLAGS
) $(PGO_LDFLAGS
)
179 COMPILE_CFLAGS
= $(MOZ_LTO_CFLAGS
) $(COMPUTED_CFLAGS
) $(PGO_CFLAGS
) $(_DEPEND_CFLAGS
) $(MK_COMPILE_DEFINES
)
180 COMPILE_CXXFLAGS
= $(MOZ_LTO_CFLAGS
) $(COMPUTED_CXXFLAGS
) $(PGO_CFLAGS
) $(_DEPEND_CFLAGS
) $(MK_COMPILE_DEFINES
)
181 COMPILE_CMFLAGS
= $(MOZ_LTO_CFLAGS
) $(OS_COMPILE_CMFLAGS
) $(MOZBUILD_CMFLAGS
)
182 COMPILE_CMMFLAGS
= $(MOZ_LTO_CFLAGS
) $(OS_COMPILE_CMMFLAGS
) $(MOZBUILD_CMMFLAGS
)
183 ASFLAGS
= $(COMPUTED_ASFLAGS
)
184 SFLAGS
= $(COMPUTED_SFLAGS
)
186 HOST_CFLAGS
= $(COMPUTED_HOST_CFLAGS
) $(_HOST_DEPEND_CFLAGS
)
187 HOST_CXXFLAGS
= $(COMPUTED_HOST_CXXFLAGS
) $(_HOST_DEPEND_CFLAGS
)
188 HOST_C_LDFLAGS
= $(COMPUTED_HOST_C_LDFLAGS
)
189 HOST_CXX_LDFLAGS
= $(COMPUTED_HOST_CXX_LDFLAGS
)
191 WASM_CFLAGS
= $(COMPUTED_WASM_CFLAGS
) $(_DEPEND_CFLAGS
) $(MK_COMPILE_DEFINES
)
192 WASM_CXXFLAGS
= $(COMPUTED_WASM_CXXFLAGS
) $(_DEPEND_CFLAGS
) $(MK_COMPILE_DEFINES
)
195 ifeq (Darwin
,$(OS_TARGET
))
196 # When linking on macOS, debug info is not linked along with the final binary,
197 # and the dwarf data stays in object files until they are "linked" with the
199 # With LTO, object files are temporary, and are not kept around, which
200 # means there's no object file for dsymutil to do its job. Consequently,
201 # there is no debug info for LTOed compilation units.
202 # The macOS linker has however an option to explicitly keep those object
203 # files, which dsymutil will then find.
204 # The catch is that the linker uses sequential numbers for those object
205 # files, and doesn't avoid conflicts from multiple linkers running at
206 # the same time. So in directories with multiple binaries, object files
207 # from the first linked binaries would be overwritten by those of the
208 # last linked binary. So we use a subdirectory containing the name of the
210 LDFLAGS
+= -Wl
,-object_path_lto
,$(@F
).lto.o
/
214 # We only add color flags if neither the flag to disable color
215 # (e.g. "-fno-color-diagnostics" nor a flag to control color
216 # (e.g. "-fcolor-diagnostics=never") is present.
217 define colorize_flags
218 ifeq (,$(filter $(COLOR_CFLAGS
:-f
%=-fno-
%),$$(1))$(findstring $(COLOR_CFLAGS
),$$(1)))
219 $(1) += $(COLOR_CFLAGS
)
223 color_flags_vars
:= \
232 ifdef MACH_STDOUT_ISATTY
234 # TODO Bug 1319166 - iTerm2 interprets some bytes sequences as a
235 # request to show a print dialog. Don't enable color on iTerm2 until
236 # a workaround is in place.
237 ifneq ($(TERM_PROGRAM
),iTerm.app
)
238 $(foreach var
,$(color_flags_vars
),$(eval
$(call colorize_flags
,$(var
))))
244 # Name of the binary code directories
250 # Export to propagate to cl and submake for third-party code.
251 # Eventually, we'll want to just use -I.
256 # Export to propagate to link.exe and submake for third-party code.
257 # Eventually, we'll want to just use -LIBPATH.
262 ifdef MOZ_USING_CCACHE
272 # Set link flags according to whether we want a console.
273 ifeq ($(OS_ARCH
),WINNT
)
275 ifeq ($(MOZ_WINCONSOLE
),1)
276 WIN32_EXE_LDFLAGS
+= $(WIN32_CONSOLE_EXE_LDFLAGS
)
277 else # MOZ_WINCONSOLE
278 WIN32_EXE_LDFLAGS
+= $(WIN32_GUI_EXE_LDFLAGS
)
281 # For setting subsystem version
282 WIN32_EXE_LDFLAGS
+= $(WIN32_CONSOLE_EXE_LDFLAGS
)
286 ifeq ($(OS_ARCH
),WINNT
)
287 ifneq (,$(filter msvc clang-cl
,$(CC_TYPE
)))
288 ifneq ($(CPU_ARCH
),x86
)
289 # Normal operation on 64-bit Windows needs 2 MB of stack. (Bug 582910)
290 # ASAN requires 6 MB of stack.
291 # Setting the stack to 8 MB to match the capability of other systems
292 # to deal with frame construction for unreasonably deep DOM trees
293 # with worst-case styling. This uses address space unnecessarily for
294 # non-main threads, but that should be tolerable on 64-bit systems.
296 WIN32_EXE_LDFLAGS
+= -STACK
:8388608
298 # Since this setting affects the default stack size for non-main
299 # threads, too, to avoid burning the address space, increase only
300 # 512 KB over the default. Just enough to be able to deal with
301 # reasonable styling applied to DOM trees whose depth is near what
302 # Blink's HTML parser can output, esp.
303 # layout/base/crashtests/507119.html (Bug 256180)
305 WIN32_EXE_LDFLAGS
+= -STACK
:1572864
307 # In debug builds, layout code has extra logging helpers on the stack,
308 # which can go over the 1.5MB limit on some deeply-nested crashtests.
309 WIN32_EXE_LDFLAGS
+= -STACK
:2097152
313 ifneq ($(CPU_ARCH
),x86
)
314 MOZ_PROGRAM_LDFLAGS
+= -Wl
,-Xlink
=-STACK
:8388608
316 MOZ_PROGRAM_LDFLAGS
+= -Wl
,-Xlink
=-STACK
:1572864
321 -include $(topsrcdir
)/$(MOZ_BUILD_APP
)/app-config.mk
323 ######################################################################
325 ifeq ($(OS_ARCH
),Darwin
)
327 NSDISTMODE
=absolute_symlink
332 NSINSTALL_PY
:= $(PYTHON3
) $(abspath
$(MOZILLA_DIR
)/config
/nsinstall.py
)
333 ifneq (,$(or
$(filter WINNT
,$(HOST_OS_ARCH
)),$(if
$(COMPILE_ENVIRONMENT
),,1)))
334 NSINSTALL
= $(NSINSTALL_PY
)
336 NSINSTALL
= $(DEPTH
)/config
/nsinstall
$(HOST_BIN_SUFFIX
)
340 ifeq (,$(CROSS_COMPILE
)$(filter-out WINNT
, $(OS_ARCH
)))
341 INSTALL
= $(NSINSTALL
) -t
345 # This isn't laid out as conditional directives so that NSDISTMODE can be
347 INSTALL
= $(if
$(filter copy
, $(NSDISTMODE
)), $(NSINSTALL
) -t
, $(if
$(filter absolute_symlink
, $(NSDISTMODE
)), $(NSINSTALL
) -L
$(PWD
), $(NSINSTALL
) -R
))
351 # The default for install_cmd is simply INSTALL
352 install_cmd ?
= $(INSTALL
) $(1)
354 # Use nsinstall in copy mode to install files on the system
355 SYSINSTALL
= $(NSINSTALL
) -t
356 # This isn't necessarily true, just here
357 sysinstall_cmd
= install_cmd
360 # Localization build automation
363 # Because you might wish to "make locales AB_CD=ab-CD", we don't hardcode
364 # MOZ_UI_LOCALE directly, but use an intermediate variable that can be
365 # overridden by the command line. (Besides, AB_CD is prettier).
366 AB_CD
= $(MOZ_UI_LOCALE
)
368 include $(MOZILLA_DIR
)/config
/AB_rCD.mk
370 # Many locales directories want this definition.
371 ACDEFINES
+= -DAB_CD
=$(AB_CD
)
373 EXPAND_LOCALE_SRCDIR
= $(if
$(filter en-US
,$(AB_CD
)),$(LOCALE_TOPDIR
)/$(1)/en-US
,$(REAL_LOCALE_MERGEDIR
)/$(subst /locales
,,$(1)))
376 LOCALE_RELATIVEDIR ?
= $(relativesrcdir
)
379 ifdef LOCALE_RELATIVEDIR
380 LOCALE_SRCDIR ?
= $(call EXPAND_LOCALE_SRCDIR
,$(LOCALE_RELATIVEDIR
))
384 MAKE_JARS_FLAGS
+= --relativesrcdir
=$(LOCALE_RELATIVEDIR
)
385 ifneq (en-US
,$(AB_CD
))
386 ifdef IS_LANGUAGE_REPACK
387 MAKE_JARS_FLAGS
+= --l10n-base
=$(REAL_LOCALE_MERGEDIR
)
390 MAKE_JARS_FLAGS
+= -c
$(LOCALE_SRCDIR
)
393 MAKE_JARS_FLAGS
+= -c
$(LOCALE_SRCDIR
)
394 endif # ! relativesrcdir
396 MERGE_FILE
= $(LOCALE_SRCDIR
)/$(1)
397 MERGE_RELATIVE_FILE
= $(call EXPAND_LOCALE_SRCDIR
,$(2))/$(1)
399 ifneq (WINNT
,$(OS_ARCH
))
400 RUN_TEST_PROGRAM
= $(DIST
)/bin
/run-mozilla.sh
403 # Enable verbose logs when not using `make -s`
404 ifeq (,$(findstring s
, $(filter-out --%, $(MAKEFLAGS
))))
405 export BUILD_VERBOSE_LOG
= 1