gecko-dev/build/moz.configure/windows.configure
serge-sans-paille d8a80fdff3 Bug 1915191 - Provide a minimal linter for configure help r=glandium,geckoview-reviewers,owlish
Currently makes sure all help message begins with an uppercase letter
and does *not* end with a dot.

Differential Revision: https://phabricator.services.mozilla.com/D220283
2024-11-07 10:43:43 +00:00

649 lines
21 KiB
Python

# -*- Mode: python; c-basic-offset: 4; indent-tabs-mode: nil; tab-width: 40 -*-
# vim: set filetype=python:
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.
option(
"--with-windows-version",
nargs=1,
default="603",
help="Windows SDK version to target. Win 8.1 (603) is currently "
"the minimum supported version",
)
@depends("--with-windows-version")
@imports(_from="__builtin__", _import="ValueError")
def valid_windows_version(value):
if not value:
die("Cannot build with --without-windows-version")
try:
version = int(value[0], 16)
if version in (0x603,):
return version
except ValueError:
pass
die("Invalid value for --with-windows-version (%s)", value[0])
option(env="WINDOWSSDKDIR", nargs=1, help="Directory containing the Windows SDK")
@depends(
"WINDOWSSDKDIR", "WINSYSROOT", winsysroot, target_windows_abi, host_windows_abi
)
def windows_sdk_dir(
value, winsysroot_env, winsysroot, target_windows_abi, host_windows_abi
):
if value:
if winsysroot_env:
die("WINDOWSSDKDIR and WINSYSROOT cannot be set together.")
if winsysroot:
die("WINDOWSSDKDIR cannot be set when using the bootstrapped WINSYSROOT")
return value
if target_windows_abi != "msvc" and host_windows_abi != "msvc":
return ()
if winsysroot:
return [os.path.join(winsysroot, "Windows Kits", "10")]
return set(
normalize_path(x[1])
for x in get_registry_values(
r"HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Kits\Installed Roots"
r"\KitsRoot*",
get_32_and_64_bit=True,
)
)
@imports("glob")
def get_sdk_dirs(sdk, subdir):
def get_dirs_containing(sdk, stem, subdir):
return [
os.path.dirname(p) for p in glob.glob(os.path.join(sdk, stem, "*", subdir))
]
def categorize(dirs):
return {os.path.basename(d): d for d in dirs}
include_dirs = categorize(get_dirs_containing(sdk, "Include", subdir))
lib_dirs = categorize(get_dirs_containing(sdk, "Lib", subdir))
valid_versions = sorted(set(include_dirs) & set(lib_dirs), reverse=True)
return [
namespace(
path=sdk,
lib=lib_dirs[vv],
include=include_dirs[vv],
)
for vv in valid_versions
]
@imports(_from="mozbuild.shellutil", _import="quote")
def valid_windows_sdk_dir_result(value):
if value:
return "0x%04x in %s" % (value.version, quote(value.path))
@depends(
target_windows_abi,
host_windows_abi,
windows_sdk_dir,
valid_windows_version,
"WINDOWSSDKDIR",
)
@checking("for Windows SDK", valid_windows_sdk_dir_result)
@imports(_from="__builtin__", _import="Exception")
@imports(_from="__builtin__", _import="open")
def valid_windows_sdk_dir(
target_windows_abi,
host_windows_abi,
windows_sdk_dir,
target_version,
windows_sdk_dir_env,
):
if target_windows_abi != "msvc" and host_windows_abi != "msvc":
return None
if windows_sdk_dir_env:
windows_sdk_dir_env = windows_sdk_dir_env[0]
sdks = {}
for d in windows_sdk_dir:
sdklist = get_sdk_dirs(d, "um")
for sdk in sdklist:
maxver = None
winsdkver = os.path.join(sdk.include, "um", "winsdkver.h")
with open(winsdkver) as fh:
for line in fh.readlines():
if line.startswith("#define"):
line = line.split(None, 2)
assert line.pop(0) == "#define"
if line.pop(0) == "WINVER_MAXVER":
maxver = line.pop(0)
break
if maxver:
try:
maxver = int(maxver, 0)
except Exception:
pass
else:
sdks[d] = maxver, sdk
break
if d == windows_sdk_dir_env and d not in sdks:
raise FatalCheckError(
"Error while checking the version of the SDK in "
"WINDOWSSDKDIR (%s). Please verify it contains a valid and "
"complete SDK installation." % windows_sdk_dir_env
)
valid_sdks = sorted(sdks, key=lambda x: sdks[x][0], reverse=True)
if valid_sdks:
biggest_version, sdk = sdks[valid_sdks[0]]
if not valid_sdks or biggest_version < target_version:
if windows_sdk_dir_env:
raise FatalCheckError(
"You are targeting Windows version 0x%04x, but your SDK only "
"supports up to version 0x%04x. Install and use an updated SDK, "
"or target a lower version using --with-windows-version. "
"Alternatively, try running the Windows SDK Configuration Tool "
"and selecting a newer SDK. See "
"https://developer.mozilla.org/En/Windows_SDK_versions for "
"details on fixing this." % (target_version, biggest_version)
)
raise FatalCheckError(
"Cannot find a Windows SDK for version >= 0x%04x." % target_version
)
return namespace(
path=sdk.path,
include=sdk.include,
lib=sdk.lib,
version=biggest_version,
)
@imports(_from="mozbuild.shellutil", _import="quote")
def valid_ucrt_sdk_dir_result(value):
if value:
return "%s in %s" % (value.version, quote(value.path))
@depends(windows_sdk_dir, "WINDOWSSDKDIR", target_windows_abi, host_windows_abi)
@checking("for Universal CRT SDK", valid_ucrt_sdk_dir_result)
@imports("os")
@imports(_import="mozpack.path", _as="mozpath")
def valid_ucrt_sdk_dir(
windows_sdk_dir, windows_sdk_dir_env, target_windows_abi, host_windows_abi
):
if target_windows_abi != "msvc" and host_windows_abi != "msvc":
return None
if windows_sdk_dir_env:
windows_sdk_dir_env = windows_sdk_dir_env[0]
sdks = {}
for d in windows_sdk_dir:
sdklist = get_sdk_dirs(d, "ucrt")
for sdk in sdklist:
version = os.path.basename(sdk.include)
# We're supposed to always find a version in the directory, because
# the 8.1 SDK, which doesn't have a version in the directory, doesn't
# contain the Universal CRT SDK. When the main SDK is 8.1, there
# is, however, supposed to be a reduced install of the SDK 10
# with the UCRT.
if version != "include":
sdks[d] = Version(version), sdk
break
if d == windows_sdk_dir_env and d not in sdks:
# When WINDOWSSDKDIR is set in the environment and we can't find the
# Universal CRT SDK, chances are this is a start-shell-msvc*.bat
# setup, where INCLUDE and LIB already contain the UCRT paths.
ucrt_includes = [
p
for p in os.environ.get("INCLUDE", "").split(";")
if os.path.basename(p).lower() == "ucrt"
]
ucrt_libs = [
p
for p in os.environ.get("LIB", "").split(";")
if os.path.basename(os.path.dirname(p)).lower() == "ucrt"
]
if ucrt_includes and ucrt_libs:
# Pick the first of each, since they are the ones that the
# compiler would look first. Assume they contain the SDK files.
include = os.path.dirname(ucrt_includes[0])
lib = os.path.dirname(os.path.dirname(ucrt_libs[0]))
path = os.path.dirname(os.path.dirname(include))
version = os.path.basename(include)
if version != "include" and mozpath.basedir(lib, [path]):
sdks[d] = (
Version(version),
namespace(
path=path,
include=include,
lib=lib,
),
)
continue
raise FatalCheckError(
"The SDK in WINDOWSSDKDIR (%s) does not contain the Universal "
"CRT." % windows_sdk_dir_env
)
valid_sdks = sorted(sdks, key=lambda x: sdks[x][0], reverse=True)
if not valid_sdks:
raise FatalCheckError(
"Cannot find the Universal CRT SDK. " "Please install it."
)
version, sdk = sdks[valid_sdks[0]]
minimum_ucrt_version = Version("10.0.17134.0")
if version < minimum_ucrt_version:
raise FatalCheckError(
"Latest Universal CRT SDK version found %s"
" and minimum required is %s. This or a later"
" version can be installed using the Visual"
" Studio installer." % (version, minimum_ucrt_version)
)
return namespace(
path=sdk.path,
include=sdk.include,
lib=sdk.lib,
version=version,
)
@depends(target_windows_abi, host_windows_abi, vc_toolchain_search_path)
@imports("os")
def vc_path(target_windows_abi, host_windows_abi, vc_toolchain_search_path):
if target_windows_abi != "msvc" and host_windows_abi != "msvc":
return
# In clang-cl builds, we need the headers and libraries from an MSVC installation.
vc_program = find_program("cl.exe", paths=vc_toolchain_search_path)
if not vc_program:
die("Cannot find a Visual C++ install for e.g. ATL headers.")
result = os.path.dirname(vc_program)
while True:
next, p = os.path.split(result)
if next == result:
die(
"Cannot determine the Visual C++ directory the compiler (%s) "
"is in" % vc_program
)
result = next
if p.lower() == "bin":
break
return os.path.normpath(result)
@depends(vc_path, valid_windows_sdk_dir, valid_ucrt_sdk_dir)
@imports("os")
def include_path(vc_path, windows_sdk_dir, ucrt_sdk_dir):
if not vc_path:
return
atlmfc_dir = os.path.join(vc_path, "atlmfc", "include")
if not os.path.isdir(atlmfc_dir):
die(
"Cannot find the ATL/MFC headers in the Visual C++ directory (%s). "
"Please install them." % vc_path
)
winrt_dir = os.path.join(windows_sdk_dir.include, "winrt")
if not os.path.isdir(winrt_dir):
die(
"Cannot find the WinRT headers in the Windows SDK directory (%s). "
"Please install them." % windows_sdk_dir.path
)
cppwinrt_dir = os.path.join(windows_sdk_dir.include, "cppwinrt")
if not os.path.isdir(cppwinrt_dir):
die(
"Cannot find the C++/WinRT headers in the Windows SDK directory (%s). "
"Please install them." % windows_sdk_dir.path
)
includes = []
include_env = os.environ.get("INCLUDE")
if include_env:
includes.append(include_env)
includes.extend(
(
os.path.join(vc_path, "include"),
atlmfc_dir,
os.path.join(windows_sdk_dir.include, "shared"),
os.path.join(windows_sdk_dir.include, "um"),
winrt_dir,
cppwinrt_dir,
os.path.join(ucrt_sdk_dir.include, "ucrt"),
)
)
# Set in the environment for old-configure
includes = ";".join(includes)
os.environ["INCLUDE"] = includes
return includes
set_config("INCLUDE", include_path)
# cppwinrt requires this on clang because of no coroutine support, which is okay
set_define("_SILENCE_CLANG_COROUTINE_MESSAGE", "")
@template
def lib_path_for(host_or_target):
@depends(
host_or_target,
dependable(host_or_target is host),
vc_path,
valid_windows_sdk_dir,
valid_ucrt_sdk_dir,
c_compiler,
)
@imports("os")
def lib_path(target, is_host, vc_path, windows_sdk_dir, ucrt_sdk_dir, compiler):
if not vc_path or target.os != "WINNT":
return
sdk_target = {
"x86": "x86",
"x86_64": "x64",
"arm": "arm",
"aarch64": "arm64",
}.get(target.cpu)
# MSVC2017 switched to use the same target naming as the sdk.
atlmfc_dir = os.path.join(vc_path, "atlmfc", "lib", sdk_target)
if not os.path.isdir(atlmfc_dir):
die(
"Cannot find the ATL/MFC libraries in the Visual C++ directory "
"(%s). Please install them." % vc_path
)
libs = []
lib_env = os.environ.get("LIB")
if lib_env and not is_host:
libs.extend(lib_env.split(";"))
libs.extend(
(
os.path.join(vc_path, "lib", sdk_target),
atlmfc_dir,
os.path.join(windows_sdk_dir.lib, "um", sdk_target),
os.path.join(ucrt_sdk_dir.lib, "ucrt", sdk_target),
)
)
if compiler.type == "clang-cl":
runtime_dir = check_cmd_output(
compiler.compiler,
"/clang:--print-runtime-dir",
*compiler.flags,
onerror=lambda: None,
).strip()
if runtime_dir and os.path.exists(runtime_dir):
# Put the clang runtime directory first, in case there is
# a different version in some of the other directories (notably,
# some versions of MSVC come with clang runtimes)
libs.insert(0, runtime_dir)
return libs
return lib_path
@depends_if(lib_path_for(target), when=target_is_windows)
@imports("os")
def lib_path(libs):
# Set in the environment for old-configure
libs = ";".join(libs)
os.environ["LIB"] = libs
return libs
set_config("LIB", lib_path)
lib_path_for_host = lib_path_for(host)
@depends_if(lib_path_for_host, when=host_is_windows)
@imports(_from="mozbuild.shellutil", _import="quote")
def host_linker_libpaths(libs):
return ["-LIBPATH:%s" % quote(l) for l in libs]
@depends_if(lib_path_for_host, when=host_is_windows)
@imports(_from="mozbuild.shellutil", _import="quote")
def host_linker_libpaths_bat(libs):
# .bat files need a different style of quoting. Batch quoting is actually
# not defined, and up to applications to handle, so it's not really clear
# what should be escaped and what not, but most paths should work just
# fine without escaping. And we don't care about double-quotes possibly
# having to be escaped because they're not allowed in file names on
# Windows.
return ['"-LIBPATH:%s"' % l for l in libs]
set_config("HOST_LINKER_LIBPATHS", host_linker_libpaths)
set_config("HOST_LINKER_LIBPATHS_BAT", host_linker_libpaths_bat)
@depends(valid_windows_sdk_dir, valid_ucrt_sdk_dir, host)
@imports(_from="os", _import="environ")
def sdk_bin_path(valid_windows_sdk_dir, valid_ucrt_sdk_dir, host):
if not valid_windows_sdk_dir:
return
vc_host = {
"x86": "x86",
"x86_64": "x64",
"aarch64": "arm64",
}.get(host.cpu)
# From version 10.0.15063.0 onwards the bin path contains the version number.
versioned_bin = (
"bin"
if valid_ucrt_sdk_dir.version < "10.0.15063.0"
else os.path.join("bin", str(valid_ucrt_sdk_dir.version))
)
result = [
environ["PATH"],
os.path.join(valid_windows_sdk_dir.path, versioned_bin, vc_host),
]
if vc_host == "x64":
result.append(os.path.join(valid_windows_sdk_dir.path, versioned_bin, "x86"))
return result
option(env="LINKER", nargs=1, when=target_is_windows, help="Path to the linker")
link = check_prog(
"LINKER",
("lld-link",),
input="LINKER",
when=target_is_windows,
paths=clang_search_path,
)
option(env="HOST_LINKER", nargs=1, when=host_is_windows, help="Path to the host linker")
host_link = check_prog(
"HOST_LINKER",
("lld-link",),
input="HOST_LINKER",
when=host_is_windows,
paths=clang_search_path,
)
option(
"--with-redist",
env="WIN32_REDIST_DIR",
nargs="?",
help="{Package|Don't package} redistributable MSVCRT",
)
@depends("--with-redist", "MOZ_AUTOMATION", c_compiler, vc_path, target)
@imports("os")
def win32_redist_dir(redist, automation, c_compiler, vc_path, target):
if len(redist):
if os.path.isdir(redist[0]):
return redist[0]
configure_error(f"Invalid Win32 Redist directory: {redist[0]}")
if redist or (
automation and redist.origin == "default" and c_compiler.type == "clang-cl"
):
if not vc_path:
configure_error("Cannot ship redistributable MSVCRT without MSVC")
# It would be too simple if the Redist dir had the same version number as
# the MSVC one.
base_redist_path = os.path.join(
os.path.dirname(os.path.dirname(os.path.dirname(vc_path))), "Redist", "MSVC"
)
redist_target = {
"x86": "x86",
"x86_64": "x64",
"aarch64": "arm64",
}.get(target.cpu)
if redist_target and os.path.isdir(base_redist_path):
versions = [Version(v) for v in os.listdir(base_redist_path)]
redist_path = os.path.join(
base_redist_path,
str(max(v for v in versions if v.major)),
redist_target,
)
if os.path.isdir(redist_path):
crt_path = max(p for p in os.listdir(redist_path) if p.endswith("CRT"))
if crt_path:
return os.path.join(redist_path, crt_path)
configure_error("Could not find redistributable MSVCRT files")
set_config("WIN32_REDIST_DIR", win32_redist_dir)
@template
def check_w32API_version():
# minimum version of toolkit libs used by mozilla
W32API_VERSION = Version("3.14")
# Check w32api version
try_compile(
includes=["w32api.h"],
check_msg=f"for w32api version >= {W32API_VERSION}",
body=f"""
#if (__W32API_MAJOR_VERSION < {W32API_VERSION.major}) || \
(__W32API_MAJOR_VERSION == {W32API_VERSION.major} && \
__W32API_MINOR_VERSION < {W32API_VERSION.minor})
#error "test failed."
#endif
""",
onerror=lambda: die(f"w32api version {W32API_VERSION} or higher required."),
when=target_is_windows & building_with_gnu_compatible_cc,
)
@depends(target)
def cpu_arch_macro_definition(target):
if target.cpu == "x86":
return "_X86_"
elif target.cpu == "x86_64":
return "_AMD64_"
elif target.cpu == "aarch64":
return "_ARM64_"
else:
return "_CPU_ARCH_NOT_DEFINED"
set_define(cpu_arch_macro_definition, True)
check_w32API_version()
# -Zc:sizedDealloc- disables C++14 global sized deallocation (see bug 1160146)
add_flag(
"-Zc:sizedDealloc-", compiler=cxx_compiler, when=~building_with_gnu_compatible_cc
)
set_define("_USE_MATH_DEFINES", True) # Otherwise Windows' math.h doesn't #define M_PI.
WINVER = dependable("0A00")
set_define("WINVER", depends(WINVER)(lambda WINVER: f"0x{WINVER}"))
set_define("_WIN32_WINNT", depends(WINVER)(lambda WINVER: f"0x{WINVER}"))
set_define("_WIN32_IE", "0x0A00")
with only_when(depends(c_compiler)(lambda c: c.type == "clang-cl")):
set_config("MSVC_C_RUNTIME_DLL", "vcruntime140.dll")
set_config(
"MSVC_C_RUNTIME_1_DLL",
"vcruntime140_1.dll",
when=depends(target)(lambda target: target.cpu != "x86"),
)
set_config("MSVC_CXX_RUNTIME_DLL", "msvcp140.dll")
# Disable warnings about using MSVC-specific secure CRT functions.
set_define("_CRT_SECURE_NO_WARNINGS", True)
set_define("_CRT_NONSTDC_NO_WARNINGS", True)
set_define("HAVE_SEH_EXCEPTIONS", True)
set_define("HAVE_IO_H", True)
def win32_subsystem_version():
return "10.0"
set_config(
"WIN32_CONSOLE_EXE_LDFLAGS",
"-SUBSYSTEM:CONSOLE,{}".format(win32_subsystem_version()),
)
set_config(
"WIN32_GUI_EXE_LDFLAGS",
"-SUBSYSTEM:WINDOWS,{}".format(win32_subsystem_version()),
)
add_flag("-Gy")
add_flag("-Zc:inline")
# VS2013+ supports -Gw for better linker optimizations.
# http://blogs.msdn.com/b/vcblog/archive/2013/09/11/introducing-gw-compiler-switch.aspx
# Disabled on ASan because it causes false-positive ODR violations.
add_flag("-Gw", when=~asan)
# String tail merging doesn't play nice with ASan's ODR checker.
add_linker_flag("-opt:nolldtailmerge", when=asan)
# Silence VS2017 15.5+ TR1 deprecation warnings hit by older gtest versions
add_flag("-D_SILENCE_TR1_NAMESPACE_DEPRECATION_WARNING", compiler=cxx_compiler)
with only_when(depends(target.cpu)(lambda cpu: cpu == "x86")):
add_linker_flag("-LARGEADDRESSAWARE")
add_linker_flag("-SAFESEH")
set_define("WIN32_LEAN_AND_MEAN", True)
# See http://support.microsoft.com/kb/143208 to use STL
set_define("NOMINMAX", True)
with only_when(target_is_windows & depends(c_compiler)(lambda c: c.type != "clang-cl")):
# strsafe.h on mingw uses macros for function deprecation that pollutes namespace
# causing problems with local implementations with the same name.
set_define("STRSAFE_NO_DEPRECATE", True)
set_config("WIN32_CONSOLE_EXE_LDFLAGS", "-mconsole")
set_config("WIN32_GUI_EXE_LDFLAGS", "-mwindows")
# Silence problematic clang warnings
add_flag("-Wno-incompatible-ms-struct", compiler=cxx_compiler)
add_linker_flag("-Wl,--no-insert-timestamp")
with only_when(depends(target.cpu)(lambda cpu: cpu == "x86")):
add_flag("-mstackrealign")
add_linker_flag("-Wl,--large-address-aware")