chromium/build/build_config.h

// Copyright 2012 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

// This file doesn't belong to any GN target by design for faster build and
// less developer overhead.

// This file adds build flags about the OS we're currently building on. They are
// defined directly in this file instead of via a `buildflag_header` target in a
// GN file for faster build. They are defined using the corresponding OS defines
// (e.g. OS_WIN) which are also defined in this file (except for OS_CHROMEOS,
// which is set by the build system). These defines are deprecated and should
// NOT be used directly. For example:
//    Please Use: #if BUILDFLAG(IS_WIN)
//    Deprecated: #if defined(OS_WIN)
//
//  Operating System:
//    IS_AIX / IS_ANDROID / IS_ASMJS / IS_CHROMEOS / IS_FREEBSD / IS_FUCHSIA /
//    IS_IOS / IS_IOS_MACCATALYST / IS_IOS_VISION / IS_IOS_WATCH / IS_LINUX /
//    IS_MAC / IS_NACL / IS_NETBSD / IS_OPENBSD / IS_QNX / IS_SOLARIS / IS_WIN
//  Operating System family:
//    IS_APPLE: MAC or IOS or IOS_MACCATALYST or IOS_VISION or IOS_WATCH
//    IS_IOS: IOS or IOS_MACCATALYST or IOS_VISION or IOS_WATCH
//    IS_BSD: FREEBSD or NETBSD or OPENBSD
//    IS_POSIX: AIX or ANDROID or ASMJS or CHROMEOS or FREEBSD or IOS
//              or IOS_MACCATALYST or IOS_VISION or IOS_WATCH or LINUX or MAC
//              or NACL or NETBSD or OPENBSD or QNX or SOLARIS

// This file also adds defines specific to the platform, architecture etc.
//
//  Platform:
//    IS_OZONE
//
//  Compiler:
//    COMPILER_MSVC / COMPILER_GCC
//
//  Processor:
//    ARCH_CPU_ARM64 / ARCH_CPU_ARMEL / ARCH_CPU_LOONGARCH32 /
//    ARCH_CPU_LOONGARCH64 / ARCH_CPU_MIPS / ARCH_CPU_MIPS64 /
//    ARCH_CPU_MIPS64EL / ARCH_CPU_MIPSEL / ARCH_CPU_PPC64 / ARCH_CPU_S390 /
//    ARCH_CPU_S390X / ARCH_CPU_X86 / ARCH_CPU_X86_64 / ARCH_CPU_RISCV64
//  Processor family:
//    ARCH_CPU_ARM_FAMILY: ARMEL or ARM64
//    ARCH_CPU_LOONGARCH_FAMILY: LOONGARCH32 or LOONGARCH64
//    ARCH_CPU_MIPS_FAMILY: MIPS64EL or MIPSEL or MIPS64 or MIPS
//    ARCH_CPU_PPC64_FAMILY: PPC64
//    ARCH_CPU_S390_FAMILY: S390 or S390X
//    ARCH_CPU_X86_FAMILY: X86 or X86_64
//    ARCH_CPU_RISCV_FAMILY: Riscv64
//  Processor features:
//    ARCH_CPU_31_BITS / ARCH_CPU_32_BITS / ARCH_CPU_64_BITS
//    ARCH_CPU_BIG_ENDIAN / ARCH_CPU_LITTLE_ENDIAN

#ifndef BUILD_BUILD_CONFIG_H_
#define BUILD_BUILD_CONFIG_H_

#include "build/buildflag.h"  // IWYU pragma: export

// Clangd does not detect BUILDFLAG_INTERNAL_* indirect usage, so mark the
// header as "always_keep" to avoid "unused include" warning.
//
// IWYU pragma: always_keep

// A set of macros to use for platform detection.
#if defined(__native_client__)
// __native_client__ must be first, so that other OS_ defines are not set.
#define OS_NACL
#elif defined(ANDROID)
#define OS_ANDROID
#elif defined(__APPLE__)
// Only include TargetConditionals after testing ANDROID as some Android builds
// on the Mac have this header available and it's not needed unless the target
// is really an Apple platform.
#include <TargetConditionals.h>
#if defined(TARGET_OS_IPHONE) && TARGET_OS_IPHONE
#define OS_IOS
// Catalyst is the technology that allows running iOS apps on macOS. These
// builds are both OS_IOS and OS_IOS_MACCATALYST.
#if defined(TARGET_OS_MACCATALYST) && TARGET_OS_MACCATALYST
#define OS_IOS_MACCATALYST
#endif  // defined(TARGET_OS_MACCATALYST) && TARGET_OS_MACCATALYST
#if defined(TARGET_OS_VISION) && TARGET_OS_VISION
#define OS_IOS_VISION
#endif  // defined(TARGET_OS_VISION) && TARGET_OS_VISION
#if defined(TARGET_OS_WATCH) && TARGET_OS_WATCH
#define OS_IOS_WATCH
#endif  // defined(TARGET_OS_WATCH) && TARGET_OS_WATCH
#else
#define OS_MAC
#endif  // defined(TARGET_OS_IPHONE) && TARGET_OS_IPHONE
#elif defined(__linux__)
#if !defined(OS_CHROMEOS)
// Do not define OS_LINUX on Chrome OS build.
// The OS_CHROMEOS macro is defined in GN.
#define OS_LINUX
#endif  // !defined(OS_CHROMEOS)
// Include a system header to pull in features.h for glibc/uclibc macros.
#include <assert.h>
#if defined(__GLIBC__) && !defined(__UCLIBC__)
// We really are using glibc, not uClibc pretending to be glibc.
#define LIBC_GLIBC
#endif
#elif defined(_WIN32)
#define OS_WIN
#elif defined(__Fuchsia__)
#define OS_FUCHSIA
#elif defined(__FreeBSD__)
#define OS_FREEBSD
#elif defined(__NetBSD__)
#define OS_NETBSD
#elif defined(__OpenBSD__)
#define OS_OPENBSD
#elif defined(__sun)
#define OS_SOLARIS
#elif defined(__QNXNTO__)
#define OS_QNX
#elif defined(_AIX)
#define OS_AIX
#elif defined(__asmjs__) || defined(__wasm__)
#define OS_ASMJS
#elif defined(__MVS__)
#define OS_ZOS
#else
#error Please add support for your platform in build/build_config.h
#endif
// NOTE: Adding a new port? Please follow
// https://chromium.googlesource.com/chromium/src/+/main/docs/new_port_policy.md

#if defined(OS_MAC) || defined(OS_IOS)
#define OS_APPLE
#endif

// For access to standard BSD features, use OS_BSD instead of a
// more specific macro.
#if defined(OS_FREEBSD) || defined(OS_NETBSD) || defined(OS_OPENBSD)
#define OS_BSD
#endif

// For access to standard POSIXish features, use OS_POSIX instead of a
// more specific macro.
#if defined(OS_AIX) || defined(OS_ANDROID) || defined(OS_ASMJS) ||  \
    defined(OS_FREEBSD) || defined(OS_IOS) || defined(OS_LINUX) ||  \
    defined(OS_CHROMEOS) || defined(OS_MAC) || defined(OS_NACL) ||  \
    defined(OS_NETBSD) || defined(OS_OPENBSD) || defined(OS_QNX) || \
    defined(OS_SOLARIS) || defined(OS_ZOS)
#define OS_POSIX
#endif

// OS build flags
#if defined(OS_AIX)
#define BUILDFLAG_INTERNAL_IS_AIX
#else
#define BUILDFLAG_INTERNAL_IS_AIX()
#endif

#if defined(OS_ANDROID)
#define BUILDFLAG_INTERNAL_IS_ANDROID
#else
#define BUILDFLAG_INTERNAL_IS_ANDROID()
#endif

#if defined(OS_APPLE)
#define BUILDFLAG_INTERNAL_IS_APPLE
#else
#define BUILDFLAG_INTERNAL_IS_APPLE()
#endif

#if defined(OS_ASMJS)
#define BUILDFLAG_INTERNAL_IS_ASMJS
#else
#define BUILDFLAG_INTERNAL_IS_ASMJS()
#endif

#if defined(OS_BSD)
#define BUILDFLAG_INTERNAL_IS_BSD
#else
#define BUILDFLAG_INTERNAL_IS_BSD()
#endif

#if defined(OS_CHROMEOS)
#define BUILDFLAG_INTERNAL_IS_CHROMEOS
#else
#define BUILDFLAG_INTERNAL_IS_CHROMEOS()
#endif

#if defined(OS_FREEBSD)
#define BUILDFLAG_INTERNAL_IS_FREEBSD
#else
#define BUILDFLAG_INTERNAL_IS_FREEBSD()
#endif

#if defined(OS_FUCHSIA)
#define BUILDFLAG_INTERNAL_IS_FUCHSIA
#else
#define BUILDFLAG_INTERNAL_IS_FUCHSIA()
#endif

#if defined(OS_IOS)
#define BUILDFLAG_INTERNAL_IS_IOS
#else
#define BUILDFLAG_INTERNAL_IS_IOS()
#endif

#if defined(OS_IOS_MACCATALYST)
#define BUILDFLAG_INTERNAL_IS_IOS_MACCATALYST
#else
#define BUILDFLAG_INTERNAL_IS_IOS_MACCATALYST()
#endif

#if defined(OS_IOS_VISION)
#define BUILDFLAG_INTERNAL_IS_IOS_VISION
#else
#define BUILDFLAG_INTERNAL_IS_IOS_VISION()
#endif

#if defined(OS_IOS_WATCH)
#define BUILDFLAG_INTERNAL_IS_IOS_WATCH
#else
#define BUILDFLAG_INTERNAL_IS_IOS_WATCH()
#endif

#if defined(OS_LINUX)
#define BUILDFLAG_INTERNAL_IS_LINUX()
#else
#define BUILDFLAG_INTERNAL_IS_LINUX
#endif

#if defined(OS_MAC)
#define BUILDFLAG_INTERNAL_IS_MAC
#else
#define BUILDFLAG_INTERNAL_IS_MAC()
#endif

#if defined(OS_NACL)
#define BUILDFLAG_INTERNAL_IS_NACL
#else
#define BUILDFLAG_INTERNAL_IS_NACL()
#endif

#if defined(OS_NETBSD)
#define BUILDFLAG_INTERNAL_IS_NETBSD
#else
#define BUILDFLAG_INTERNAL_IS_NETBSD()
#endif

#if defined(OS_OPENBSD)
#define BUILDFLAG_INTERNAL_IS_OPENBSD
#else
#define BUILDFLAG_INTERNAL_IS_OPENBSD()
#endif

#if defined(OS_POSIX)
#define BUILDFLAG_INTERNAL_IS_POSIX()
#else
#define BUILDFLAG_INTERNAL_IS_POSIX
#endif

#if defined(OS_QNX)
#define BUILDFLAG_INTERNAL_IS_QNX
#else
#define BUILDFLAG_INTERNAL_IS_QNX()
#endif

#if defined(OS_SOLARIS)
#define BUILDFLAG_INTERNAL_IS_SOLARIS
#else
#define BUILDFLAG_INTERNAL_IS_SOLARIS()
#endif

#if defined(OS_WIN)
#define BUILDFLAG_INTERNAL_IS_WIN
#else
#define BUILDFLAG_INTERNAL_IS_WIN()
#endif

#if defined(USE_OZONE)
#define BUILDFLAG_INTERNAL_IS_OZONE()
#else
#define BUILDFLAG_INTERNAL_IS_OZONE
#endif

// Compiler detection. Note: clang masquerades as GCC on POSIX and as MSVC on
// Windows.
#if defined(__GNUC__)
#define COMPILER_GCC
#elif defined(_MSC_VER)
#define COMPILER_MSVC
#else
#error Please add support for your compiler in build/build_config.h
#endif

// Processor architecture detection.  For more info on what's defined, see:
//   http://msdn.microsoft.com/en-us/library/b0084kay.aspx
//   http://www.agner.org/optimize/calling_conventions.pdf
//   or with gcc, run: "echo | gcc -E -dM -"
#if defined(_M_X64) || defined(__x86_64__)
#define ARCH_CPU_X86_FAMILY
#define ARCH_CPU_X86_64
#define ARCH_CPU_64_BITS
#define ARCH_CPU_LITTLE_ENDIAN
#elif defined(_M_IX86) || defined(__i386__)
#define ARCH_CPU_X86_FAMILY
#define ARCH_CPU_X86
#define ARCH_CPU_32_BITS
#define ARCH_CPU_LITTLE_ENDIAN
#elif defined(__s390x__)
#define ARCH_CPU_S390_FAMILY
#define ARCH_CPU_S390X
#define ARCH_CPU_64_BITS
#define ARCH_CPU_BIG_ENDIAN
#elif defined(__s390__)
#define ARCH_CPU_S390_FAMILY
#define ARCH_CPU_S390
#define ARCH_CPU_31_BITS
#define ARCH_CPU_BIG_ENDIAN
#elif (defined(__PPC64__) || defined(__PPC__)) && defined(__BIG_ENDIAN__)
#define ARCH_CPU_PPC64_FAMILY
#define ARCH_CPU_PPC64
#define ARCH_CPU_64_BITS
#define ARCH_CPU_BIG_ENDIAN
#elif defined(__PPC64__)
#define ARCH_CPU_PPC64_FAMILY
#define ARCH_CPU_PPC64
#define ARCH_CPU_64_BITS
#define ARCH_CPU_LITTLE_ENDIAN
#elif defined(__ARMEL__)
#define ARCH_CPU_ARM_FAMILY
#define ARCH_CPU_ARMEL
#define ARCH_CPU_32_BITS
#define ARCH_CPU_LITTLE_ENDIAN
#elif defined(__aarch64__) || defined(_M_ARM64)
#define ARCH_CPU_ARM_FAMILY
#define ARCH_CPU_ARM64
#define ARCH_CPU_64_BITS
#define ARCH_CPU_LITTLE_ENDIAN
#elif defined(__pnacl__) || defined(__asmjs__) || defined(__wasm__)
#define ARCH_CPU_32_BITS
#define ARCH_CPU_LITTLE_ENDIAN
#elif defined(__MIPSEL__)
#if defined(__LP64__)
#define ARCH_CPU_MIPS_FAMILY
#define ARCH_CPU_MIPS64EL
#define ARCH_CPU_64_BITS
#define ARCH_CPU_LITTLE_ENDIAN
#else
#define ARCH_CPU_MIPS_FAMILY
#define ARCH_CPU_MIPSEL
#define ARCH_CPU_32_BITS
#define ARCH_CPU_LITTLE_ENDIAN
#endif
#elif defined(__MIPSEB__)
#if defined(__LP64__)
#define ARCH_CPU_MIPS_FAMILY
#define ARCH_CPU_MIPS64
#define ARCH_CPU_64_BITS
#define ARCH_CPU_BIG_ENDIAN
#else
#define ARCH_CPU_MIPS_FAMILY
#define ARCH_CPU_MIPS
#define ARCH_CPU_32_BITS
#define ARCH_CPU_BIG_ENDIAN
#endif
#elif defined(__loongarch__)
#define ARCH_CPU_LOONGARCH_FAMILY
#define ARCH_CPU_LITTLE_ENDIAN
#if __loongarch_grlen == 64
#define ARCH_CPU_LOONGARCH64
#define ARCH_CPU_64_BITS
#else
#define ARCH_CPU_LOONGARCH32
#define ARCH_CPU_32_BITS
#endif
#elif defined(__riscv) && (__riscv_xlen == 64)
#define ARCH_CPU_RISCV_FAMILY
#define ARCH_CPU_RISCV64
#define ARCH_CPU_64_BITS
#define ARCH_CPU_LITTLE_ENDIAN
#else
#error Please add support for your architecture in build/build_config.h
#endif

// Type detection for wchar_t.
#if defined(OS_WIN)
#define WCHAR_T_IS_16_BIT
#elif defined(OS_FUCHSIA)
#define WCHAR_T_IS_32_BIT
#elif defined(OS_POSIX) && defined(COMPILER_GCC) && defined(__WCHAR_MAX__) && \
    (__WCHAR_MAX__ == 0x7fffffff || __WCHAR_MAX__ == 0xffffffff)
#define WCHAR_T_IS_32_BIT
#elif defined(OS_POSIX) && defined(COMPILER_GCC) && defined(__WCHAR_MAX__) && \
    (__WCHAR_MAX__ == 0x7fff || __WCHAR_MAX__ == 0xffff)
// On Posix, we'll detect short wchar_t, but projects aren't guaranteed to
// compile in this mode (in particular, Chrome doesn't). This is intended for
// other projects using base who manage their own dependencies and make sure
// short wchar works for them.
#define WCHAR_T_IS_16_BIT
#else
#error Please add support for your compiler in build/build_config.h
#endif

#if defined(OS_ANDROID)
// The compiler thinks std::string::const_iterator and "const char*" are
// equivalent types.
#define STD_STRING_ITERATOR_IS_CHAR_POINTER
// The compiler thinks std::u16string::const_iterator and "char16*" are
// equivalent types.
#define BASE_STRING16_ITERATOR_IS_CHAR16_POINTER
#endif

// Architecture-specific feature detection.

#if !defined(CPU_ARM_NEON)
#if defined(__arm__)
#if !defined(__ARMEB__) && !defined(__ARM_EABI__) && !defined(__EABI__) && \
    !defined(__VFP_FP__) && !defined(_WIN32_WCE) && !defined(ANDROID)
#error Chromium does not support middle endian architecture
#endif
#if defined(__ARM_NEON__)
#define CPU_ARM_NEON
#endif
#endif  // defined(__arm__)
#endif  // !defined(CPU_ARM_NEON)

#if !defined(HAVE_MIPS_MSA_INTRINSICS)
#if defined(__mips_msa) && defined(__mips_isa_rev) && (__mips_isa_rev >= 5)
#define HAVE_MIPS_MSA_INTRINSICS
#endif
#endif

#endif  // BUILD_BUILD_CONFIG_H_