Bug 1708422: part 3) Add some documentation to `mozInlineSpellChecker::CheckWordsAndA...
[gecko.git] / moz.configure
blob7ab99c1c2913fc140270acd13ba9c4efc8e71db9
1 # -*- Mode: python; indent-tabs-mode: nil; tab-width: 40 -*-
2 # vim: set filetype=python:
3 # This Source Code Form is subject to the terms of the Mozilla Public
4 # License, v. 2.0. If a copy of the MPL was not distributed with this
5 # file, You can obtain one at http://mozilla.org/MPL/2.0/.
7 include("build/moz.configure/init.configure")
9 # Note:
10 # - Gecko-specific options and rules should go in toolkit/moz.configure.
11 # - Firefox-specific options and rules should go in browser/moz.configure.
12 # - Fennec-specific options and rules should go in
13 #   mobile/android/moz.configure.
14 # - Spidermonkey-specific options and rules should go in js/moz.configure.
15 # - etc.
17 option(
18     "--enable-artifact-builds",
19     env="MOZ_ARTIFACT_BUILDS",
20     help="Download and use prebuilt binary artifacts.",
24 @depends("--enable-artifact-builds")
25 def artifact_builds(value):
26     if value:
27         return True
30 set_config("MOZ_ARTIFACT_BUILDS", artifact_builds)
32 imply_option(
33     "--enable-artifact-build-symbols",
34     depends(artifact_builds)(lambda v: False if v is None else None),
35     reason="--disable-artifact-builds",
38 option(
39     "--enable-artifact-build-symbols",
40     nargs="?",
41     choices=("full",),
42     help="Download symbols when artifact builds are enabled.",
46 @depends("--enable-artifact-build-symbols", "MOZ_AUTOMATION", target)
47 def enable_artifact_build_symbols(value, automation, target):
48     if len(value):
49         return value[0]
50     if bool(value):
51         if target.os == "Android" and not automation:
52             return "full"
53         return True
54     return None
57 set_config("MOZ_ARTIFACT_BUILD_SYMBOLS", enable_artifact_build_symbols)
60 @depends("--enable-artifact-builds")
61 def imply_disable_compile_environment(value):
62     if value:
63         return False
66 option(
67     env="MOZ_COPY_PDBS",
68     help="For builds that do not support symbols in the normal fashion,"
69     " generate and copy them into the resulting build archive.",
72 set_config("MOZ_COPY_PDBS", depends_if("MOZ_COPY_PDBS")(lambda _: True))
74 imply_option("--enable-compile-environment", imply_disable_compile_environment)
76 option("--disable-compile-environment", help="Disable compiler/library checks")
79 @depends("--disable-compile-environment")
80 def compile_environment(compile_env):
81     if compile_env:
82         return True
85 set_config("COMPILE_ENVIRONMENT", compile_environment)
86 add_old_configure_assignment("COMPILE_ENVIRONMENT", compile_environment)
88 option("--disable-tests", help="Do not build test libraries & programs")
91 @depends("--disable-tests")
92 def enable_tests(value):
93     if value:
94         return True
97 set_config("ENABLE_TESTS", enable_tests)
98 set_define("ENABLE_TESTS", enable_tests)
101 @depends(enable_tests)
102 def gtest_has_rtti(value):
103     if value:
104         return "0"
107 set_define("GTEST_HAS_RTTI", gtest_has_rtti)
110 @depends(target, enable_tests)
111 def linux_gtest_defines(target, enable_tests):
112     if enable_tests and target.os == "Android":
113         return namespace(os_linux_android=True, use_own_tr1_tuple=True, has_clone="0")
116 set_define("GTEST_OS_LINUX_ANDROID", linux_gtest_defines.os_linux_android)
117 set_define("GTEST_USE_OWN_TR1_TUPLE", linux_gtest_defines.use_own_tr1_tuple)
118 set_define("GTEST_HAS_CLONE", linux_gtest_defines.has_clone)
120 option(
121     "--enable-debug",
122     nargs="?",
123     help="Enable building with developer debug info "
124     "(using the given compiler flags).",
128 @depends("--enable-debug")
129 def moz_debug(debug):
130     if debug:
131         return bool(debug)
134 set_config("MOZ_DEBUG", moz_debug)
135 set_define("MOZ_DEBUG", moz_debug)
136 # Override any value MOZ_DEBUG may have from the environment when passing it
137 # down to old-configure.
138 add_old_configure_assignment("MOZ_DEBUG", depends("--enable-debug")(lambda x: bool(x)))
140 option(
141     "--with-debug-label",
142     nargs="+",
143     help="Debug DEBUG_<value> for each comma-separated value given",
147 @depends(moz_debug, "--with-debug-label")
148 def debug_defines(debug, labels):
149     if debug:
150         return ["DEBUG"] + ["DEBUG_%s" % label for label in labels]
151     return ["NDEBUG", "TRIMMED"]
154 set_config("MOZ_DEBUG_DEFINES", debug_defines)
156 option(env="MOZ_PGO", help="Build with profile guided optimizations")
158 set_config("MOZ_PGO", depends("MOZ_PGO")(lambda x: bool(x)))
161 imply_option("--enable-release", mozilla_official)
162 imply_option("--enable-release", depends_if("MOZ_AUTOMATION")(lambda x: True))
164 option(
165     "--enable-release",
166     default=milestone.is_release_or_beta,
167     help="{Build|Do not build} with more conservative, release "
168     "engineering-oriented options.{ This may slow down builds.|}",
172 @depends("--enable-release")
173 def developer_options(value):
174     if not value:
175         return True
178 add_old_configure_assignment("DEVELOPER_OPTIONS", developer_options)
179 set_config("DEVELOPER_OPTIONS", developer_options)
182 option(
183     env="MOZ_FETCHES_DIR",
184     nargs=1,
185     when="MOZ_AUTOMATION",
186     help="Directory containing fetched artifacts",
190 @depends("MOZ_FETCHES_DIR", when="MOZ_AUTOMATION")
191 def moz_fetches_dir(value):
192     if value:
193         return value[0]
196 @depends(host, milestone.is_nightly, "MOZ_AUTOMATION")
197 def bootstrap_default(host, is_nightly, automation):
198     if automation:
199         return False
200     if host.cpu == "aarch64" and host.os == "OSX" and is_nightly:
201         return True
204 option(
205     "--enable-bootstrap",
206     default=bootstrap_default,
207     help="{Automatically bootstrap or update some toolchains|Disable bootstrap or update of toolchains}",
211 @depends(developer_options, "--enable-bootstrap", moz_fetches_dir)
212 def bootstrap_search_path_order(developer_options, bootstrap, moz_fetches_dir):
213     if moz_fetches_dir:
214         log.debug("Prioritizing MOZ_FETCHES_DIR in toolchain path.")
215         return "prepend"
217     if bootstrap:
218         log.debug(
219             "Prioritizing mozbuild state dir in toolchain paths because "
220             "bootstrap mode is enabled."
221         )
222         return "prepend"
224     if developer_options:
225         log.debug(
226             "Prioritizing mozbuild state dir in toolchain paths because "
227             "you are not building in release mode."
228         )
229         return "prepend"
231     log.debug(
232         "Prioritizing system over mozbuild state dir in "
233         "toolchain paths because you are building in "
234         "release mode."
235     )
236     return "append"
239 toolchains_base_dir = moz_fetches_dir | mozbuild_state_path
242 @dependable
243 @imports("os")
244 @imports(_from="os", _import="environ")
245 def original_path():
246     return environ["PATH"].split(os.pathsep)
249 @template
250 def bootstrap_toolchain_tasks(host_or_target):
251     @depends(host_or_target, when="--enable-bootstrap")
252     @imports("os")
253     @imports(_from="mozbuild.toolchains", _import="toolchain_task_definitions")
254     @imports(_from="__builtin__", _import="Exception")
255     def bootstrap_toolchain_tasks(host_or_target):
256         prefix = {
257             ("x86", "GNU", "Linux"): "linux32",
258             ("x86_64", "GNU", "Linux"): "linux64",
259             ("aarch64", "GNU", "Linux"): "linux64-aarch64",
260             ("x86_64", "OSX", "Darwin"): "macosx64",
261             ("aarch64", "OSX", "Darwin"): "macosx64-aarch64",
262             ("x86_64", "WINNT", "WINNT"): "win64",
263         }.get((host_or_target.cpu, host_or_target.os, host_or_target.kernel))
264         if prefix:
265             try:
266                 return namespace(prefix=prefix, tasks=toolchain_task_definitions())
267             except Exception:
268                 return None
270     return bootstrap_toolchain_tasks
273 host_bootstrap_toolchain_tasks = bootstrap_toolchain_tasks(host)
274 target_bootstrap_toolchain_tasks = bootstrap_toolchain_tasks(target)
277 @template
278 def bootstrap_path(path, **kwargs):
279     when = kwargs.pop("when", None)
280     context = kwargs.pop("context", host)
281     if kwargs:
282         configure_error(
283             "bootstrap_path only takes `when` or `context` as keyword arguments"
284         )
286     path_parts = path.split("/")
287     bootstrap_toolchain_tasks = {
288         host: host_bootstrap_toolchain_tasks,
289         target: target_bootstrap_toolchain_tasks,
290     }[context]
292     @depends(
293         "--enable-bootstrap",
294         toolchains_base_dir,
295         bootstrap_toolchain_tasks,
296         shell,
297         check_build_environment,
298         when=when,
299     )
300     @imports("os")
301     @imports("subprocess")
302     @imports(_from="mozbuild.util", _import="ensureParentDir")
303     @imports(_from="__builtin__", _import="open")
304     @imports(_from="__builtin__", _import="Exception")
305     def bootstrap_path(bootstrap, toolchains_base_dir, tasks, shell, build_env):
306         def try_bootstrap(exists):
307             if not tasks:
308                 return False
309             label = "toolchain-{}-{}".format(
310                 tasks.prefix, path_parts[0].replace("_", "-")
311             )
312             task = tasks.tasks.get(label)
313             if not task:
314                 return False
315             task_index = task.optimization.get("index-search")
316             if not task_index:
317                 return False
318             task_index = task_index[0].split(".")[-1]
319             artifact = task.attributes["toolchain-artifact"]
320             # `mach artifact toolchain` doesn't support authentication for
321             # private artifacts.
322             if not artifact.startswith("public/"):
323                 return False
324             index_file = os.path.join(toolchains_base_dir, "indices", path_parts[0])
325             try:
326                 with open(index_file) as fh:
327                     index = fh.read().strip()
328             except Exception:
329                 index = None
330             if index == task_index and exists:
331                 return True
332             log.info(
333                 "%s bootstrapped toolchain in %s",
334                 "Updating" if exists else "Installing",
335                 os.path.join(toolchains_base_dir, path_parts[0]),
336             )
337             subprocess.run(
338                 [
339                     shell,
340                     os.path.join(build_env.topsrcdir, "mach"),
341                     "--log-no-times",
342                     "artifact",
343                     "toolchain",
344                     "--from-build",
345                     label,
346                 ],
347                 cwd=toolchains_base_dir,
348                 check=True,
349             )
350             ensureParentDir(index_file)
351             with open(index_file, "w") as fh:
352                 fh.write(task_index)
353             return True
355         path = os.path.join(toolchains_base_dir, *path_parts)
356         if bootstrap:
357             try:
358                 if not try_bootstrap(os.path.exists(path)):
359                     # If there aren't toolchain artifacts to use for this build,
360                     # don't return a path.
361                     return None
362             except Exception as e:
363                 log.error("%s", e)
364                 die("If you can't fix the above, retry with --disable-bootstrap.")
365         # We re-test whether the path exists because it may have been created by
366         # try_bootstrap. Automation will not have gone through the bootstrap
367         # process, but we want to return the path if it exists.
368         if os.path.exists(path):
369             return path
371     return bootstrap_path
374 @template
375 def bootstrap_search_path(path, paths=original_path, **kwargs):
376     @depends(
377         bootstrap_path(path, **kwargs),
378         bootstrap_search_path_order,
379         paths,
380         original_path,
381     )
382     def bootstrap_search_path(path, order, paths, original_path):
383         if paths is None:
384             paths = original_path
385         if not path:
386             return paths
387         if order == "prepend":
388             return [path] + paths
389         return paths + [path]
391     return bootstrap_search_path
394 # The execution model of the configure sandbox doesn't allow for
395 # check_prog to use bootstrap_search_path directly because check_prog
396 # comes first, so we use a trick to allow it. No use of check_prog
397 # happening before here won't allow bootstrap.
398 @template
399 def check_prog(*args, **kwargs):
400     kwargs["bootstrap_search_path"] = bootstrap_search_path
401     return check_prog(*args, **kwargs)
404 @depends(target, host)
405 def want_wine(target, host):
406     return target.kernel == "WINNT" and host.kernel != "WINNT"
409 wine = check_prog(
410     "WINE",
411     ["wine64", "wine"],
412     allow_missing=True,
413     when=want_wine,
414     bootstrap="wine/bin",
416 check_prog("WGET", ("wget",), allow_missing=True)
419 include("build/moz.configure/toolchain.configure", when="--enable-compile-environment")
421 include("build/moz.configure/pkg.configure")
422 # Make this assignment here rather than in pkg.configure to avoid
423 # requiring this file in unit tests.
424 add_old_configure_assignment("PKG_CONFIG", pkg_config)
426 include("build/moz.configure/memory.configure", when="--enable-compile-environment")
427 include("build/moz.configure/headers.configure", when="--enable-compile-environment")
428 include("build/moz.configure/warnings.configure", when="--enable-compile-environment")
429 include("build/moz.configure/flags.configure", when="--enable-compile-environment")
430 include("build/moz.configure/lto-pgo.configure", when="--enable-compile-environment")
431 # rust.configure is included by js/moz.configure.
433 option("--enable-valgrind", help="Enable Valgrind integration hooks")
435 valgrind_h = check_header("valgrind/valgrind.h", when="--enable-valgrind")
438 @depends("--enable-valgrind", valgrind_h)
439 def check_valgrind(valgrind, valgrind_h):
440     if valgrind:
441         if not valgrind_h:
442             die("--enable-valgrind specified but Valgrind is not installed")
443         return True
446 set_define("MOZ_VALGRIND", check_valgrind)
447 set_config("MOZ_VALGRIND", check_valgrind)
450 @depends(target, host)
451 def is_openbsd(target, host):
452     return target.kernel == "OpenBSD" or host.kernel == "OpenBSD"
455 option(
456     env="SO_VERSION",
457     nargs=1,
458     default="1.0",
459     when=is_openbsd,
460     help="Shared library version for OpenBSD systems",
464 @depends("SO_VERSION", when=is_openbsd)
465 def so_version(value):
466     return value
469 @template
470 def library_name_info_template(host_or_target):
471     assert host_or_target in {host, target}
472     compiler = {
473         host: host_c_compiler,
474         target: c_compiler,
475     }[host_or_target]
477     @depends(host_or_target, compiler, so_version)
478     def library_name_info_impl(host_or_target, compiler, so_version):
479         if host_or_target.kernel == "WINNT":
480             # There aren't artifacts for mingw builds, so it's OK that the
481             # results are inaccurate in that case.
482             if compiler and compiler.type != "clang-cl":
483                 return namespace(
484                     dll=namespace(prefix="", suffix=".dll"),
485                     lib=namespace(prefix="lib", suffix="a"),
486                     import_lib=namespace(prefix="lib", suffix="a"),
487                     obj=namespace(prefix="", suffix="o"),
488                 )
490             return namespace(
491                 dll=namespace(prefix="", suffix=".dll"),
492                 lib=namespace(prefix="", suffix="lib"),
493                 import_lib=namespace(prefix="", suffix="lib"),
494                 obj=namespace(prefix="", suffix="obj"),
495             )
497         elif host_or_target.kernel == "Darwin":
498             return namespace(
499                 dll=namespace(prefix="lib", suffix=".dylib"),
500                 lib=namespace(prefix="lib", suffix="a"),
501                 import_lib=namespace(prefix=None, suffix=""),
502                 obj=namespace(prefix="", suffix="o"),
503             )
504         elif so_version:
505             so = ".so.%s" % so_version
506         else:
507             so = ".so"
509         return namespace(
510             dll=namespace(prefix="lib", suffix=so),
511             lib=namespace(prefix="lib", suffix="a"),
512             import_lib=namespace(prefix=None, suffix=""),
513             obj=namespace(prefix="", suffix="o"),
514         )
516     return library_name_info_impl
519 host_library_name_info = library_name_info_template(host)
520 library_name_info = library_name_info_template(target)
522 set_config("DLL_PREFIX", library_name_info.dll.prefix)
523 set_config("DLL_SUFFIX", library_name_info.dll.suffix)
524 set_config("HOST_DLL_PREFIX", host_library_name_info.dll.prefix)
525 set_config("HOST_DLL_SUFFIX", host_library_name_info.dll.suffix)
526 set_config("LIB_PREFIX", library_name_info.lib.prefix)
527 set_config("LIB_SUFFIX", library_name_info.lib.suffix)
528 set_config("OBJ_SUFFIX", library_name_info.obj.suffix)
529 # Lots of compilation tests depend on this variable being present.
530 add_old_configure_assignment("OBJ_SUFFIX", library_name_info.obj.suffix)
531 set_config("IMPORT_LIB_SUFFIX", library_name_info.import_lib.suffix)
532 set_define(
533     "MOZ_DLL_PREFIX", depends(library_name_info.dll.prefix)(lambda s: '"%s"' % s)
535 set_define(
536     "MOZ_DLL_SUFFIX", depends(library_name_info.dll.suffix)(lambda s: '"%s"' % s)
538 set_config("WASM_OBJ_SUFFIX", "wasm")
540 # Make `profiling` available to this file even when js/moz.configure
541 # doesn't end up included.
542 profiling = dependable(False)
543 # Same for js_standalone
544 js_standalone = dependable(False)
545 # Same for fold_libs
546 fold_libs = dependable(False)
548 include(include_project_configure)
551 @depends("--help")
552 @imports(_from="mozbuild.backend", _import="backends")
553 def build_backends_choices(_):
554     return tuple(backends)
557 @deprecated_option("--enable-build-backend", nargs="+", choices=build_backends_choices)
558 def build_backend(backends):
559     if backends:
560         return tuple("+%s" % b for b in backends)
563 imply_option("--build-backends", build_backend)
566 @depends(
567     "--enable-artifact-builds",
568     "--disable-compile-environment",
569     "--enable-build-backend",
570     "--enable-project",
571     "--enable-application",
572     "--help",
574 @imports("sys")
575 def build_backend_defaults(
576     artifact_builds, compile_environment, requested_backends, project, application, _
578     if application:
579         project = application[0]
580     elif project:
581         project = project[0]
583     if "Tup" in requested_backends:
584         # As a special case, if Tup was requested, do not combine it with any
585         # Make based backend by default.
586         all_backends = []
587     elif artifact_builds:
588         all_backends = ["FasterMake+RecursiveMake"]
589     else:
590         all_backends = ["RecursiveMake", "FasterMake"]
591     # Normally, we'd use target.os == 'WINNT', but a dependency on target
592     # would require target to depend on --help, as well as host and shell,
593     # and this is not a can of worms we can open at the moment.
594     if sys.platform == "win32" and compile_environment and project != "mobile/android":
595         all_backends.append("VisualStudio")
596     return tuple(all_backends) or None
599 option(
600     "--build-backends",
601     nargs="+",
602     default=build_backend_defaults,
603     choices=build_backends_choices,
604     help="Build backends to generate",
608 @depends("--build-backends")
609 def build_backends(backends):
610     return backends
613 set_config("BUILD_BACKENDS", build_backends)
616 @depends(check_build_environment, build_backends)
617 @imports("glob")
618 def check_objdir_backend_reuse(build_env, backends):
619     # "Make based" might be RecursiveMake or a hybrid backend, so "Make" is
620     # intentionally vague for use with the substring match below.
621     incompatible_backends = (("Tup", "Make"), ("Make", "Tup"))
622     for backend_file in glob.iglob(
623         os.path.join(build_env.topobjdir, "backend.*Backend")
624     ):
625         for prev, curr in incompatible_backends:
626             if prev in backend_file and any(curr in b for b in backends):
627                 die(
628                     "The active objdir, %s, was previously "
629                     "used to build with a %s based backend. "
630                     "Change objdirs (by setting MOZ_OBJDIR in "
631                     "your mozconfig) or clobber to continue.\n",
632                     build_env.topobjdir,
633                     prev,
634                 )
637 option(
638     "--disable-gtest-in-build",
639     help="Force disable building the gtest libxul during the build.",
640     when="--enable-compile-environment",
643 # Determine whether to build the gtest xul. This happens in automation
644 # on Android and Desktop platforms with the exception of:
645 #  - Windows PGO, where linking xul-gtest.dll takes too long;
646 #  - Android other than x86_64, where gtest is not required.
647 @depends(
648     "MOZ_PGO",
649     build_project,
650     target,
651     "MOZ_AUTOMATION",
652     "--disable-gtest-in-build",
653     enable_tests,
654     when="--enable-compile-environment",
656 def build_gtest(pgo, build_project, target, automation, enabled, enable_tests):
657     if not enable_tests or not enabled:
658         return None
659     if (
660         automation
661         and build_project in ("browser", "comm/mail", "mobile/android")
662         and not (
663             (pgo and target.os == "WINNT")
664             or (target.os == "Android" and target.cpu != "x86_64")
665         )
666     ):
667         return True
670 set_config("LINK_GTEST_DURING_COMPILE", build_gtest)
672 # Localization
673 # ==============================================================
674 option(
675     "--enable-ui-locale",
676     default="en-US",
677     help="Select the user interface locale (default: en-US)",
680 set_config("MOZ_UI_LOCALE", depends("--enable-ui-locale")(lambda x: x))
682 # clang-plugin location
683 # ==============================================================
684 @depends(host_library_name_info, check_build_environment, when="--enable-clang-plugin")
685 def clang_plugin_path(library_name_info, build_env):
686     topobjdir = build_env.topobjdir
687     if topobjdir.endswith("/js/src"):
688         topobjdir = topobjdir[:-7]
689     return os.path.abspath(
690         os.path.join(
691             topobjdir,
692             "build",
693             "clang-plugin",
694             "%sclang-plugin%s"
695             % (library_name_info.dll.prefix, library_name_info.dll.suffix),
696         )
697     )
700 set_config("CLANG_PLUGIN", clang_plugin_path)
701 add_old_configure_assignment("CLANG_PLUGIN", clang_plugin_path)
704 # Awk detection
705 # ==============================================================
706 awk = check_prog("AWK", ("gawk", "mawk", "nawk", "awk"))
708 # Until the AWK variable is not necessary in old-configure
709 @depends(awk)
710 def awk_for_old_configure(value):
711     return value
714 add_old_configure_assignment("AWK", awk_for_old_configure)
717 # Perl detection
718 # ==============================================================
719 perl = check_prog("PERL", ("perl5", "perl"))
721 # Until the PERL variable is not necessary in old-configure
722 @depends(perl)
723 def perl_for_old_configure(value):
724     return value
727 add_old_configure_assignment("PERL", perl_for_old_configure)
730 @template
731 def perl_version_check(min_version):
732     @depends(perl)
733     @checking("for minimum required perl version >= %s" % min_version)
734     def get_perl_version(perl):
735         return Version(
736             check_cmd_output(
737                 perl,
738                 "-e",
739                 "print $]",
740                 onerror=lambda: die("Failed to get perl version."),
741             )
742         )
744     @depends(get_perl_version)
745     def check_perl_version(version):
746         if version < min_version:
747             die("Perl %s or higher is required.", min_version)
749     @depends(perl)
750     @checking("for full perl installation")
751     @imports("subprocess")
752     def has_full_perl_installation(perl):
753         ret = subprocess.call([perl, "-e", "use Config; exit(!-d $Config{archlib})"])
754         return ret == 0
756     @depends(has_full_perl_installation)
757     def require_full_perl_installation(has_full_perl_installation):
758         if not has_full_perl_installation:
759             die(
760                 "Cannot find Config.pm or $Config{archlib}. "
761                 "A full perl installation is required."
762             )
765 perl_version_check("5.006")
768 # GNU make detection
769 # ==============================================================
770 option(env="MAKE", nargs=1, help="Path to GNU make")
773 @depends("MAKE", host)
774 def possible_makes(make, host):
775     candidates = []
776     if host.kernel == "WINNT":
777         candidates.append("mingw32-make")
778     if make:
779         candidates.append(make[0])
780     if host.kernel == "WINNT":
781         candidates.extend(("make", "gmake"))
782     else:
783         candidates.extend(("gmake", "make"))
784     return candidates
787 check_prog("GMAKE", possible_makes)
789 # watchman detection
790 # ==============================================================
792 option(env="WATCHMAN", nargs=1, help="Path to the watchman program")
795 @depends(host, "WATCHMAN")
796 @checking("for watchman", callback=lambda w: w.path if w else "not found")
797 def watchman(host, prog):
798     # On Windows, `watchman` is only supported on 64-bit hosts.
799     if host.os == "WINNT" and host.cpu != "x86_64":
800         return
802     if not prog:
803         prog = find_program("watchman")
805     if not prog:
806         return
808     # `watchman version` will talk to the Watchman daemon service.
809     # This can hang due to permissions problems. e.g.
810     # https://github.com/facebook/watchman/issues/376. So use
811     # `watchman --version` to prevent a class of failures.
812     out = check_cmd_output(prog, "--version", onerror=lambda: None)
813     if out is None:
814         return
816     return namespace(path=prog, version=Version(out.strip()))
819 @depends_if(watchman)
820 @checking("for watchman version")
821 def watchman_version(w):
822     return w.version
825 set_config("WATCHMAN", watchman.path)
828 @depends_all(hg_version, hg_config, watchman)
829 @checking("for watchman Mercurial integration")
830 @imports("os")
831 def watchman_hg(hg_version, hg_config, watchman):
832     if hg_version < Version("3.8"):
833         return "no (Mercurial 3.8+ required)"
835     ext_enabled = False
836     mode_disabled = False
838     for k in ("extensions.fsmonitor", "extensions.hgext.fsmonitor"):
839         if k in hg_config and hg_config[k] != "!":
840             ext_enabled = True
842     mode_disabled = hg_config.get("fsmonitor.mode") == "off"
844     if not ext_enabled:
845         return "no (fsmonitor extension not enabled)"
846     if mode_disabled:
847         return "no (fsmonitor.mode=off disables fsmonitor)"
849     return True
852 # Miscellaneous programs
853 # ==============================================================
854 check_prog("XARGS", ("xargs",))
857 @depends(target)
858 def extra_programs(target):
859     if target.kernel == "Darwin":
860         return namespace(
861             DSYMUTIL=("dsymutil", "llvm-dsymutil"),
862             MKFSHFS=("newfs_hfs", "mkfs.hfsplus"),
863             HFS_TOOL=("hfsplus",),
864         )
865     if target.os == "GNU" and target.kernel == "Linux":
866         return namespace(RPMBUILD=("rpmbuild",))
869 check_prog("DSYMUTIL", extra_programs.DSYMUTIL, allow_missing=True)
870 check_prog("MKFSHFS", extra_programs.MKFSHFS, allow_missing=True)
871 check_prog("HFS_TOOL", extra_programs.HFS_TOOL, allow_missing=True)
872 check_prog("RPMBUILD", extra_programs.RPMBUILD, allow_missing=True)
875 @depends(target)
876 @imports("os")
877 def makensis_progs(target):
878     if target.kernel != "WINNT":
879         return
881     candidates = [
882         "makensis-3.01",
883         "makensis-3.0b3",
884         "makensis-3.0b1",
885         "makensis",
886     ]
888     # Look for nsis installed by msys environment. But only the 32-bit version.
889     # We use an absolute path and insert as the first entry so it is preferred
890     # over a 64-bit exe that may be in PATH.
891     if "MSYSTEM_PREFIX" in os.environ:
892         prefix = os.path.dirname(os.environ["MSYSTEM_PREFIX"])
893         candidates.insert(0, os.path.join(prefix, "mingw32", "bin", "makensis.exe"))
895     return tuple(candidates)
898 nsis = check_prog("MAKENSISU", makensis_progs, allow_missing=True)
900 # Make sure the version of makensis is up to date.
901 @depends(nsis, wine)
902 @checking("for NSIS version")
903 @imports("re")
904 def nsis_version(nsis, wine):
905     if not nsis:
906         return None
907     nsis_min_version = "3.0b1"
908     onerror = lambda: die("Failed to get nsis version.")
909     if wine and nsis.lower().endswith(".exe"):
910         out = check_cmd_output(wine, nsis, "-version", onerror=onerror)
911     else:
912         out = check_cmd_output(nsis, "-version", onerror=onerror)
914     m = re.search(r"(?<=v)[0-9]+\.[0-9]+((a|b|rc)[0-9]+)?", out)
916     if not m:
917         raise FatalCheckError("Unknown version of makensis")
918     ver = Version(m.group(0))
920     # Versions comparisons don't quite work well with beta versions, so ensure
921     # it works for the non-beta version.
922     if ver < nsis_min_version and (ver >= "3.0a" or ver < "3"):
923         raise FatalCheckError(
924             "To build the installer you must have NSIS"
925             " version %s or greater in your path" % nsis_min_version
926         )
928     return ver
931 # And that makensis is 32-bit (but only on Windows).
932 @depends_if(nsis, when=depends(host)(lambda h: h.kernel == "WINNT"))
933 @checking("for 32-bit NSIS")
934 def nsis_binary_type(nsis):
935     bin_type = windows_binary_type(nsis)
936     if bin_type != "win32":
937         raise FatalCheckError("%s is not a 32-bit Windows application" % nsis)
939     return "yes"
942 # And any flags we have to give to makensis
943 @depends(host)
944 def nsis_flags(host):
945     if host.kernel != "WINNT":
946         return "-nocd"
947     return ""
950 set_config("MAKENSISU_FLAGS", nsis_flags)
952 check_prog("7Z", ("7z", "7za"), allow_missing=True, when=target_is_windows)
953 check_prog("UPX", ("upx",), allow_missing=True, when=target_is_windows)
956 @depends(host_c_compiler, c_compiler, bindgen_config_paths)
957 def llvm_objdump(host_c_compiler, c_compiler, bindgen_config_paths):
958     clang = None
959     for compiler in (host_c_compiler, c_compiler):
960         if compiler and compiler.type == "clang":
961             clang = compiler.compiler
962             break
963         elif compiler and compiler.type == "clang-cl":
964             clang = os.path.join(os.path.dirname(compiler.compiler), "clang")
965             break
967     if not clang and bindgen_config_paths:
968         clang = bindgen_config_paths.clang_path
969     llvm_objdump = "llvm-objdump"
970     if clang:
971         out = check_cmd_output(
972             clang, "--print-prog-name=llvm-objdump", onerror=lambda: None
973         )
974         if out:
975             llvm_objdump = out.rstrip()
976     return (llvm_objdump,)
979 llvm_objdump = check_prog(
980     "LLVM_OBJDUMP",
981     llvm_objdump,
982     what="llvm-objdump",
983     when="--enable-compile-environment",
984     paths=clang_search_path,
987 add_old_configure_assignment("LLVM_OBJDUMP", llvm_objdump)
990 option("--enable-dtrace", help="Build with dtrace support")
992 dtrace = check_header(
993     "sys/sdt.h",
994     when="--enable-dtrace",
995     onerror=lambda: die("dtrace enabled but sys/sdt.h not found"),
998 set_config("HAVE_DTRACE", True, when=dtrace)
999 set_define("INCLUDE_MOZILLA_DTRACE", True, when=dtrace)
1000 add_old_configure_assignment("enable_dtrace", "yes", when=dtrace)
1003 option("--disable-icf", help="Disable Identical Code Folding")
1005 add_old_configure_assignment(
1006     "MOZ_DISABLE_ICF", "1", when=depends("--enable-icf")(lambda x: not x)
1010 option(
1011     "--enable-strip",
1012     when=compile_environment,
1013     help="Enable stripping of libs & executables",
1016 # This should be handled as a `when` once bug 1617793 is fixed.
1017 @depends("--enable-strip", c_compiler, when=compile_environment)
1018 def enable_strip(strip, c_compiler):
1019     if strip and c_compiler.type != "clang-cl":
1020         return True
1023 set_config("ENABLE_STRIP", enable_strip)
1025 option(
1026     "--disable-install-strip",
1027     when=compile_environment,
1028     help="Enable stripping of libs & executables when packaging",
1031 # This should be handled as a `when` once bug 1617793 is fixed.
1032 @depends("--enable-install-strip", c_compiler, when=compile_environment)
1033 def enable_install_strip(strip, c_compiler):
1034     if strip and c_compiler.type != "clang-cl":
1035         return True
1038 set_config("PKG_STRIP", enable_install_strip)
1041 @depends("--enable-strip", "--enable-install-strip", when=compile_environment)
1042 def strip(strip, install_strip):
1043     return strip or install_strip
1046 option(env="STRIP_FLAGS", nargs=1, when=strip, help="Flags for the strip command")
1049 @depends("STRIP_FLAGS", profiling, target, when=strip)
1050 def strip_flags(flags, profiling, target):
1051     if flags:
1052         return flags[0].split()
1053     if profiling:
1054         # Only strip debug info and symbols when profiling is enabled, keeping
1055         # local symbols.
1056         if target.kernel == "Darwin":
1057             return ["-S"]
1058         elif target.os == "Android":
1059             # The tooling we use with Android supports detached symbols, and the
1060             # size increase caused by local symbols are too much for mobile. So,
1061             # don't restrict the amount of stripping with a flag.
1062             return
1063         else:
1064             return ["--strip-debug"]
1065     # Otherwise strip everything we can, which happens without flags on non-Darwin.
1066     # On Darwin, it tries to strip things it can't, so we need to limit its scope.
1067     elif target.kernel == "Darwin":
1068         return ["-x", "-S"]
1071 set_config("STRIP_FLAGS", strip_flags)
1074 @depends(js_standalone, target)
1075 def system_zlib_default(js_standalone, target):
1076     return js_standalone and target.kernel != "WINNT"
1079 option(
1080     "--with-system-zlib",
1081     nargs="?",
1082     default=system_zlib_default,
1083     help="{Use|Do not use} system libz",
1087 @depends("--with-system-zlib")
1088 def deprecated_system_zlib_path(value):
1089     if len(value) == 1:
1090         die(
1091             "--with-system-zlib=PATH is not supported anymore. Please use "
1092             "--with-system-zlib and set any necessary pkg-config environment variable."
1093         )
1096 pkg_check_modules("MOZ_ZLIB", "zlib >= 1.2.3", when="--with-system-zlib")
1098 set_config("MOZ_SYSTEM_ZLIB", True, when="--with-system-zlib")
1099 add_old_configure_assignment("MOZ_SYSTEM_ZLIB", True, when="--with-system-zlib")
1102 # Please do not add configure checks from here on.
1104 # Fallthrough to autoconf-based configure
1105 include("build/moz.configure/old.configure")
1107 # JS Subconfigure.
1108 include("js/sub.configure", when=compile_environment & toolkit)
1111 @depends(check_build_environment, build_project)
1112 @imports("__sandbox__")
1113 @imports("glob")
1114 @imports(_from="os.path", _import="exists")
1115 def config_status_deps(build_env, build_project):
1117     topsrcdir = build_env.topsrcdir
1118     topobjdir = build_env.topobjdir
1120     if not topobjdir.endswith("js/src"):
1121         extra_deps = [os.path.join(topobjdir, ".mozconfig.json")]
1122     else:
1123         # mozconfig changes may impact js configure.
1124         extra_deps = [os.path.join(topobjdir[:-7], ".mozconfig.json")]
1126     confvars = os.path.join(topsrcdir, build_project, "confvars.sh")
1127     if exists(confvars):
1128         extra_deps.append(confvars)
1130     return (
1131         list(__sandbox__._all_paths)
1132         + extra_deps
1133         + [
1134             os.path.join(topsrcdir, "CLOBBER"),
1135             os.path.join(topsrcdir, "configure.in"),
1136             os.path.join(topsrcdir, "js", "src", "configure.in"),
1137             os.path.join(topsrcdir, "nsprpub", "configure"),
1138             os.path.join(topsrcdir, "config", "milestone.txt"),
1139             os.path.join(topsrcdir, "browser", "config", "version.txt"),
1140             os.path.join(topsrcdir, "browser", "config", "version_display.txt"),
1141             os.path.join(topsrcdir, "build", "build_virtualenv_packages.txt"),
1142             os.path.join(topsrcdir, "build", "common_virtualenv_packages.txt"),
1143             os.path.join(topsrcdir, "build", "mach_virtualenv_packages.txt"),
1144             os.path.join(topsrcdir, "python", "mozbuild", "mozbuild", "virtualenv.py"),
1145             os.path.join(topsrcdir, "testing", "mozbase", "packages.txt"),
1146             os.path.join(topsrcdir, "aclocal.m4"),
1147             os.path.join(topsrcdir, "old-configure.in"),
1148             os.path.join(topsrcdir, "js", "src", "aclocal.m4"),
1149             os.path.join(topsrcdir, "js", "src", "old-configure.in"),
1150         ]
1151         + glob.glob(os.path.join(topsrcdir, "build", "autoconf", "*.m4"))
1152     )
1155 set_config("CONFIG_STATUS_DEPS", config_status_deps)
1156 # Please do not add anything after setting config_dep_paths.