Quelle  compiler.go   Sprache: unbekannt

// Copyright 2016 Google Inc. All rights reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package cc

import (
 "fmt"
 "path/filepath"
 "regexp"
 "slices"
 "strconv"
 "strings"

 "github.com/google/blueprint/depset"
 "github.com/google/blueprint/proptools"

 "android/soong/android"
 "android/soong/cc/config"
)

var (
 allowedManualInterfacePaths = []string{"vendor/", "hardware/"}
)

// This file contains the basic C/C++/assembly to .o compliation steps

type BaseCompilerProperties struct {
 // list of source files used to compile the C/C++ module.  May be .c, .cpp, or .S files.
 // srcs may reference the outputs of other modules that produce source files like genrule
 // or filegroup using the syntax ":module".
 Srcs proptools.Configurable[[]string] `android:"path,arch_variant"`

 // list of source files that should not be compiled with clang-tidy.
 Tidy_disabled_srcs []string `android:"path,arch_variant"`

 // list of source files that should not be compiled by clang-tidy when TIDY_TIMEOUT is set.
 Tidy_timeout_srcs []string `android:"path,arch_variant"`

 // list of source files that should not be used to build the C/C++ module.
 // This is most useful in the arch/multilib variants to remove non-common files
 Exclude_srcs proptools.Configurable[[]string] `android:"path,arch_variant"`

 // list of module-specific flags that will be used for C and C++ compiles.
 Cflags proptools.Configurable[[]string] `android:"arch_variant"`

 // list of module-specific flags that will be used for C++ compiles
 Cppflags proptools.Configurable[[]string] `android:"arch_variant"`

 // list of module-specific flags that will be used for C compiles
 Conlyflags []string `android:"arch_variant"`

 // list of module-specific flags that will be used for .S compiles
 Asflags []string `android:"arch_variant"`

 // list of module-specific flags that will be used for C and C++ compiles when
 // compiling with clang
 Clang_cflags []string `android:"arch_variant"`

 // list of module-specific flags that will be used for .S compiles when
 // compiling with clang
 Clang_asflags []string `android:"arch_variant"`

 // the instruction set architecture to use to compile the C/C++
 // module.
 Instruction_set *string `android:"arch_variant"`

 // list of directories relative to the root of the source tree that will
 // be added to the include path using -I.
 // If possible, don't use this.  If adding paths from the current directory use
 // local_include_dirs, if adding paths from other modules use export_include_dirs in
 // that module.
 Include_dirs proptools.Configurable[[]string] `android:"arch_variant,variant_prepend"`

 // list of directories relative to the Blueprints file that will
 // be added to the include path using -I
 Local_include_dirs proptools.Configurable[[]string] `android:"arch_variant,variant_prepend"`

 // Add the directory containing the Android.bp file to the list of include
 // directories. Defaults to true.
 Include_build_directory *bool

 // list of generated sources to compile. These are the names of gensrcs or
 // genrule modules.
 Generated_sources []string `android:"arch_variant"`

 // list of generated sources that should not be used to build the C/C++ module.
 // This is most useful in the arch/multilib variants to remove non-common files
 Exclude_generated_sources []string `android:"arch_variant"`

 // list of generated headers to add to the include path. These are the names
 // of genrule modules.
 Generated_headers proptools.Configurable[[]string] `android:"arch_variant,variant_prepend"`

 // Same as generated_headers, but the dependencies will be added based on the first supported
 // arch variant and the device os variant. This can be useful for creating a host tool that
 // embeds a copy of a device tool, that it then extracts and pushes to a device at runtime.
 Device_first_generated_headers proptools.Configurable[[]string] `android:"arch_variant,variant_prepend"`

 // pass -frtti instead of -fno-rtti
 Rtti *bool `android:"arch_variant"`

 // C standard version to use. Can be a specific version (such as "gnu11"),
 // "experimental" (which will use draft versions like C1x when available),
 // or the empty string (which will use the default).
 C_std *string

 // C++ standard version to use. Can be a specific version (such as
 // "gnu++11"), "experimental" (which will use draft versions like C++1z when
 // available), or the empty string (which will use the default).
 Cpp_std *string

 // if set to false, use -std=c++* instead of -std=gnu++*
 Gnu_extensions *bool

 // cc Build rules targeting BPF must set this to true. The correct fix is to
 // ban targeting bpf in cc rules instead use bpf_rules. (b/323415017)
 Bpf_target *bool

 // Add "-Xclang -verify" to the cflags and appends "touch $out" to
 // the clang command line.
 Clang_verify bool

 Yacc *YaccProperties
 Lex  *LexProperties

 Aidl struct {
  // List of aidl_library modules
  Libs []string

  // list of directories that will be added to the aidl include paths.
  Include_dirs []string

  // list of directories relative to the Blueprints file that will
  // be added to the aidl include paths.
  Local_include_dirs []string

  // whether to generate traces (for systrace) for this interface
  Generate_traces *bool

  // list of flags that will be passed to the AIDL compiler
  Flags []string
 }

 // Populated by aidl_interface CPP backend to let other modules (e.g. cc_cmake_snapshot)
 // access actual source files and not generated cpp intermediary sources.
 AidlInterface struct {
  // list of aidl_interface sources
  Sources []string `blueprint:"mutated"`

  // root directory of AIDL sources
  AidlRoot string `blueprint:"mutated"`

  // AIDL backend language (e.g. "cpp", "ndk")
  Lang string `blueprint:"mutated"`

  // list of flags passed to AIDL generator
  Flags []string `blueprint:"mutated"`
 } `blueprint:"mutated"`

 Renderscript struct {
  // list of directories that will be added to the llvm-rs-cc include paths
  Include_dirs []string

  // list of flags that will be passed to llvm-rs-cc
  Flags []string

  // Renderscript API level to target
  Target_api *string
 }

 Target struct {
  Vendor, Product struct {
   // list of source files that should only be used in vendor or
   // product variant of the C/C++ module.
   Srcs []string `android:"path"`

   // list of source files that should not be used to build vendor
   // or product variant of the C/C++ module.
   Exclude_srcs []string `android:"path"`

   // List of additional cflags that should be used to build vendor
   // or product variant of the C/C++ module.
   Cflags proptools.Configurable[[]string]

   // list of generated sources that should not be used to build
   // vendor or product variant of the C/C++ module.
   Exclude_generated_sources []string
  }
  Recovery struct {
   // list of source files that should only be used in the
   // recovery variant of the C/C++ module.
   Srcs []string `android:"path"`

   // list of source files that should not be used to
   // build the recovery variant of the C/C++ module.
   Exclude_srcs []string `android:"path"`

   // List of additional cflags that should be used to build the recovery
   // variant of the C/C++ module.
   Cflags []string

   // list of generated sources that should not be used to
   // build the recovery variant of the C/C++ module.
   Exclude_generated_sources []string
  }
  Ramdisk, Vendor_ramdisk struct {
   // list of source files that should not be used to
   // build the ramdisk variants of the C/C++ module.
   Exclude_srcs []string `android:"path"`

   // List of additional cflags that should be used to build the ramdisk
   // variants of the C/C++ module.
   Cflags []string
  }
  Platform struct {
   // List of additional cflags that should be used to build the platform
   // variant of the C/C++ module.
   Cflags []string
  }
 }

 Proto struct {
  // Link statically against the protobuf runtime
  Static *bool `android:"arch_variant"`
 } `android:"arch_variant"`

 // Build and link with OpenMP
 Openmp *bool `android:"arch_variant"`
}

func NewBaseCompiler() *baseCompiler {
 return &baseCompiler{}
}

type baseCompiler struct {
 Properties BaseCompilerProperties
 Proto      android.ProtoProperties
 cFlagsDeps android.Paths
 pathDeps   android.Paths
 flags      builderFlags

 // Sources that were passed to the C/C++ compiler
 srcs android.Paths

 // Sources that were passed in the Android.bp file, including generated sources generated by
 // other modules and filegroups. May include source files that have not yet been translated to
 // C/C++ (.aidl, .proto, etc.)
 srcsBeforeGen android.Paths

 generatedSourceInfo
}

var _ compiler = (*baseCompiler)(nil)

type CompiledInterface interface {
 Srcs() android.Paths
}

func (compiler *baseCompiler) Srcs() android.Paths {
 return append(android.Paths{}, compiler.srcs...)
}

func (compiler *baseCompiler) appendCflags(flags []string) {
 compiler.Properties.Cflags.AppendSimpleValue(flags)
}

func (compiler *baseCompiler) appendAsflags(flags []string) {
 compiler.Properties.Asflags = append(compiler.Properties.Asflags, flags...)
}

func (compiler *baseCompiler) compilerProps() []interface{} {
 return []interface{}{&compiler.Properties, &compiler.Proto}
}

func (compiler *baseCompiler) baseCompilerProps() BaseCompilerProperties {
 return compiler.Properties
}

func includeBuildDirectory(prop *bool) bool {
 return proptools.BoolDefault(prop, true)
}

func (compiler *baseCompiler) includeBuildDirectory() bool {
 return includeBuildDirectory(compiler.Properties.Include_build_directory)
}

func (compiler *baseCompiler) compilerInit(ctx BaseModuleContext) {}

func (compiler *baseCompiler) compilerDeps(ctx DepsContext, deps Deps) Deps {
 deps.GeneratedSources = append(deps.GeneratedSources, compiler.Properties.Generated_sources...)
 deps.GeneratedSources = removeListFromList(deps.GeneratedSources, compiler.Properties.Exclude_generated_sources)
 deps.GeneratedHeaders = append(deps.GeneratedHeaders, compiler.Properties.Generated_headers.GetOrDefault(ctx, nil)...)
 deps.DeviceFirstGeneratedHeaders = append(deps.DeviceFirstGeneratedHeaders, compiler.Properties.Device_first_generated_headers.GetOrDefault(ctx, nil)...)
 deps.AidlLibs = append(deps.AidlLibs, compiler.Properties.Aidl.Libs...)

 android.ProtoDeps(ctx, &compiler.Proto)
 if compiler.hasSrcExt(ctx, ".proto") {
  deps = protoDeps(ctx, deps, &compiler.Proto, Bool(compiler.Properties.Proto.Static))
 }

 if Bool(compiler.Properties.Openmp) {
  deps.StaticLibs = append(deps.StaticLibs, "libomp")
 }

 return deps
}

// Return true if the module is in the WarningAllowedProjects.
func warningsAreAllowed(subdir string) bool {
 subdir += "/"
 return android.HasAnyPrefix(subdir, config.WarningAllowedProjects)
}

func addToModuleList(ctx ModuleContext, key android.OnceKey, module string) {
 getNamedMapForConfig(ctx.Config(), key).Store(module, true)
}

func requiresGlobalIncludes(ctx ModuleContext) bool {
 return !(ctx.useSdk() || ctx.InVendorOrProduct()) || ctx.Host()
}

func useGnuExtensions(gnuExtensions *bool) bool {
 return proptools.BoolDefault(gnuExtensions, true)
}

func maybeReplaceGnuToC(gnuExtensions *bool, cStd string, cppStd string) (string, string) {
 if !useGnuExtensions(gnuExtensions) {
  cStd = gnuToCReplacer.Replace(cStd)
  cppStd = gnuToCReplacer.Replace(cppStd)
 }
 return cStd, cppStd
}

func parseCppStd(ctx ModuleContext, cppStdPtr *string) string {
 cppStd := String(cppStdPtr)
 switch cppStd {
 case "":
  return config.CppStdVersion(ctx)
 case "experimental":
  return config.ExperimentalCppStdVersion
 default:
  return cppStd
 }
}

func parseCStd(cStdPtr *string) string {
 cStd := String(cStdPtr)
 switch cStd {
 case "":
  return config.CStdVersion
 case "experimental":
  return config.ExperimentalCStdVersion
 default:
  return cStd
 }
}

func AddTargetFlags(ctx android.ModuleContext, flags Flags, tc config.Toolchain, version string, bpf, lfi bool) Flags {
 target := "-target " + tc.ClangTriple()
 if ctx.Os().Class == android.Device && !lfi {
  if version == "" || version == "current" {
   target += strconv.Itoa(android.FutureApiLevelInt)
  } else {
   apiLevel := nativeApiLevelOrPanic(ctx, version)
   target += strconv.Itoa(apiLevel.FinalOrFutureInt())
  }
 }

 // bpf targets don't need the default target triple. b/308826679
 if bpf {
  target = "--target=bpf"
 }

 flags.Global.CFlags = append(flags.Global.CFlags, target)
 flags.Global.AsFlags = append(flags.Global.AsFlags, target)
 flags.Global.LdFlags = append(flags.Global.LdFlags, target)

 return flags
}

// Create a Flags struct that collects the compile flags from global values,
// per-target values, module type values, and per-module Blueprints properties
func (compiler *baseCompiler) compilerFlags(ctx ModuleContext, flags Flags, deps PathDeps) Flags {
 tc := ctx.toolchain()
 modulePath := ctx.ModuleDir()

 reuseObjs := false
 if len(ctx.GetDirectDepsProxyWithTag(reuseObjTag)) > 0 {
  reuseObjs = true
 }

 // If a reuseObjTag dependency exists then this module is reusing the objects (generally the shared variant
 // reusing objects from the static variant), and doesn't need to compile any sources of its own.
 if !reuseObjs {
  srcs := compiler.Properties.Srcs.GetOrDefault(ctx, nil)
  exclude_srcs := compiler.Properties.Exclude_srcs.GetOrDefault(ctx, nil)
  compiler.srcsBeforeGen = android.PathsForModuleSrcExcludes(ctx, srcs, exclude_srcs)
  compiler.srcsBeforeGen = append(compiler.srcsBeforeGen, deps.GeneratedSources...)
 }

 for _, lfiDep := range ctx.GetDirectDepsProxyWithTag(LFIDepTag) {
  lfiInfo, ok := android.OtherModuleProvider(ctx, lfiDep, lfiInfoProvider)
  if !ok {
   ctx.ModuleErrorf("Expected lfi dep %s(%s) to provide lfi info", ctx.OtherModuleName(lfiDep), ctx.OtherModuleSubDir(lfiDep))
   continue
  }
  compiler.srcsBeforeGen = append(compiler.srcsBeforeGen, lfiInfo.srcs...)
 }

 cflags := compiler.Properties.Cflags.GetOrDefault(ctx, nil)
 cppflags := compiler.Properties.Cppflags.GetOrDefault(ctx, nil)
 vendorcflags := compiler.Properties.Target.Vendor.Cflags.GetOrDefault(ctx, nil)
 productcflags := compiler.Properties.Target.Product.Cflags.GetOrDefault(ctx, nil)
 CheckBadCompilerFlags(ctx, "cflags", cflags)
 CheckBadCompilerFlags(ctx, "cppflags", cppflags)
 CheckBadCompilerFlags(ctx, "conlyflags", compiler.Properties.Conlyflags)
 CheckBadCompilerFlags(ctx, "asflags", compiler.Properties.Asflags)
 CheckBadCompilerFlags(ctx, "vendor.cflags", vendorcflags)
 CheckBadCompilerFlags(ctx, "product.cflags", productcflags)
 CheckBadCompilerFlags(ctx, "recovery.cflags", compiler.Properties.Target.Recovery.Cflags)
 CheckBadCompilerFlags(ctx, "ramdisk.cflags", compiler.Properties.Target.Ramdisk.Cflags)
 CheckBadCompilerFlags(ctx, "vendor_ramdisk.cflags", compiler.Properties.Target.Vendor_ramdisk.Cflags)
 CheckBadCompilerFlags(ctx, "platform.cflags", compiler.Properties.Target.Platform.Cflags)

 esc := proptools.NinjaAndShellEscapeList

 flags.Local.CFlags = append(flags.Local.CFlags, esc(cflags)...)
 flags.Local.CppFlags = append(flags.Local.CppFlags, esc(cppflags)...)
 flags.Local.ConlyFlags = append(flags.Local.ConlyFlags, esc(compiler.Properties.Conlyflags)...)
 flags.Local.AsFlags = append(flags.Local.AsFlags, esc(compiler.Properties.Asflags)...)
 flags.Local.YasmFlags = append(flags.Local.YasmFlags, esc(compiler.Properties.Asflags)...)

 flags.Yacc = compiler.Properties.Yacc
 flags.Lex = compiler.Properties.Lex

 flags.ClangVerify = compiler.Properties.Clang_verify
 if compiler.Properties.Clang_verify {
  flags.Local.CFlags = append(flags.Local.CFlags, "-Xclang", "-verify")
 }

 // Include dir cflags
 localIncludeDirs := android.PathsForModuleSrc(ctx, compiler.Properties.Local_include_dirs.GetOrDefault(ctx, nil))
 if len(localIncludeDirs) > 0 {
  f := includeDirsToFlags(localIncludeDirs)
  flags.Local.CommonFlags = append(flags.Local.CommonFlags, f)
  flags.Local.YasmFlags = append(flags.Local.YasmFlags, f)
 }
 rootIncludeDirs := android.PathsForSource(ctx, compiler.Properties.Include_dirs.GetOrDefault(ctx, nil))
 if len(rootIncludeDirs) > 0 {
  f := includeDirsToFlags(rootIncludeDirs)
  flags.Local.CommonFlags = append(flags.Local.CommonFlags, f)
  flags.Local.YasmFlags = append(flags.Local.YasmFlags, f)
 }

 if compiler.includeBuildDirectory() {
  flags.Local.CommonFlags = append(flags.Local.CommonFlags, "-I"+modulePath)
  flags.Local.YasmFlags = append(flags.Local.YasmFlags, "-I"+modulePath)
 }

 if requiresGlobalIncludes(ctx) {
  flags.SystemIncludeFlags = append(flags.SystemIncludeFlags,
   "${config.CommonGlobalIncludes}",
   tc.IncludeFlags())
 }

 if ctx.useSdk() {
  // The NDK headers are installed to a common sysroot. While a more
  // typical Soong approach would be to only make the headers for the
  // library you're using available, we're trying to emulate the NDK
  // behavior here, and the NDK always has all the NDK headers available.
  flags.SystemIncludeFlags = append(flags.SystemIncludeFlags,
   "--sysroot "+getNdkSysrootBase(ctx).String())
 } else if ctx.Device() {
  flags.Global.CommonFlags = append(flags.Global.CFlags, "-nostdlibinc")
 }

 if ctx.InVendorOrProduct() {
  flags.Global.CommonFlags = append(flags.Global.CommonFlags, "-D__ANDROID_VNDK__")
  if ctx.inVendor() {
   flags.Global.CommonFlags = append(flags.Global.CommonFlags, "-D__ANDROID_VENDOR__")
  } else if ctx.inProduct() {
   flags.Global.CommonFlags = append(flags.Global.CommonFlags, "-D__ANDROID_PRODUCT__")
  }

  // Define __ANDROID_VENDOR_API__ for both product and vendor variants
  // because they both use the same LLNDK libraries.
  vendorApiLevel := ctx.Config().VendorApiLevel()
  if vendorApiLevel == "" {
   // TODO(b/314036847): This is a fallback for UDC targets.
   // This must be a build failure when UDC is no longer built
   // from this source tree.
   vendorApiLevel = ctx.Config().PlatformSdkVersion().String()
  }
  flags.Global.CommonFlags = append(flags.Global.CommonFlags, "-D__ANDROID_VENDOR_API__="+vendorApiLevel)
 }

 if ctx.inRecovery() {
  flags.Global.CommonFlags = append(flags.Global.CommonFlags, "-D__ANDROID_RECOVERY__")
 }

 if ctx.inRecovery() || ctx.inRamdisk() || ctx.inVendorRamdisk() {
  flags.Global.CommonFlags = append(flags.Global.CommonFlags, "-D__ANDROID_RAMDISK__")
 }

 if ctx.apexVariationName() != "" {
  flags.Global.CommonFlags = append(flags.Global.CommonFlags, "-D__ANDROID_APEX__")

  // As APEX modules ship to a variety of ARM64 devices, some with PAC/BTI and some without,
  // enable both mitigations to ensure that devices which support PAC/BTI benefit from it,
  // and devices which don't still have stack-protector enabled.
  //
  // PAC/BTI instructions are encoded in the NOP space, so this should not present any
  // compatibility issues when pushed to hardware which does not support these instructions.
  // Similarly, enabling stack-protector alongside PAC/BTI does not present any compatibility
  // issues.
  //
  // LFI has a minimal libc that does not include __stack_chk_fail so it cannot use
  // '-fstack-protector'. We already forced the LFI target to enable PAC/BTI for all LFI
  // modules.
  if ctx.Arch().ArchType == android.Arm64 && !ctx.Target().LFI {
   // Some of these flags are intentionally duplicated from globals as some
   // targets disable them. Duplicating them here ensures that no matter the
   // build target for APEXes, these flags are enabled.
   flags.Global.CFlags = append(flags.Global.CFlags, "-fstack-protector-strong")
   flags.Global.CFlags = append(flags.Global.CFlags, "-mbranch-protection=standard")
  }
 }

 if ctx.Target().NativeBridge == android.NativeBridgeEnabled {
  flags.Global.CommonFlags = append(flags.Global.CommonFlags, "-D__ANDROID_NATIVE_BRIDGE__")
 }

 instructionSet := String(compiler.Properties.Instruction_set)
 if flags.RequiredInstructionSet != "" {
  instructionSet = flags.RequiredInstructionSet
 }
 instructionSetFlags, err := tc.InstructionSetFlags(instructionSet)
 if err != nil {
  ctx.ModuleErrorf("%s", err)
 }

 if !ctx.DeviceConfig().BuildBrokenClangCFlags() && len(compiler.Properties.Clang_cflags) != 0 {
  ctx.PropertyErrorf("clang_cflags", "property is deprecated, see Changes.md file")
 } else {
  CheckBadCompilerFlags(ctx, "clang_cflags", compiler.Properties.Clang_cflags)
 }
 if !ctx.DeviceConfig().BuildBrokenClangAsFlags() && len(compiler.Properties.Clang_asflags) != 0 {
  ctx.PropertyErrorf("clang_asflags", "property is deprecated, see Changes.md file")
 } else {
  CheckBadCompilerFlags(ctx, "clang_asflags", compiler.Properties.Clang_asflags)
 }

 flags.Local.CFlags = config.ClangFilterUnknownCflags(flags.Local.CFlags)
 if !ctx.DeviceConfig().BuildBrokenClangCFlags() {
  flags.Local.CFlags = append(flags.Local.CFlags, esc(compiler.Properties.Clang_cflags)...)
 }
 if !ctx.DeviceConfig().BuildBrokenClangAsFlags() {
  flags.Local.AsFlags = append(flags.Local.AsFlags, esc(compiler.Properties.Clang_asflags)...)
 }
 flags.Local.CppFlags = config.ClangFilterUnknownCflags(flags.Local.CppFlags)
 flags.Local.ConlyFlags = config.ClangFilterUnknownCflags(flags.Local.ConlyFlags)
 flags.Local.LdFlags = config.ClangFilterUnknownCflags(flags.Local.LdFlags)

 flags = AddTargetFlags(ctx, flags, tc, ctx.minSdkVersion(), Bool(compiler.Properties.Bpf_target), ctx.isLFIVariation())

 hod := "Host"
 if ctx.Os().Class == android.Device {
  hod = "Device"
 }

 flags.Global.CommonFlags = append(flags.Global.CommonFlags, instructionSetFlags)
 flags.Global.ConlyFlags = append([]string{"${config.CommonGlobalConlyflags}"}, flags.Global.ConlyFlags...)
 flags.Global.CppFlags = append([]string{fmt.Sprintf("${config.%sGlobalCppflags}", hod)}, flags.Global.CppFlags...)

 flags.Global.AsFlags = append(flags.Global.AsFlags, tc.Asflags())
 flags.Global.CppFlags = append([]string{"${config.CommonGlobalCppflags}"}, flags.Global.CppFlags...)

 // bpf targets don't need the target specific toolchain cflags. b/308826679
 if !proptools.Bool(compiler.Properties.Bpf_target) {
  flags.Global.CommonFlags = append(flags.Global.CommonFlags, tc.Cflags())
 }
 flags.Global.CommonFlags = append(flags.Global.CommonFlags,
  "${config.CommonGlobalCflags}",
  fmt.Sprintf("${config.%sGlobalCflags}", hod))

 if ctx.testBinary() || ctx.testLibrary() {
  flags.Global.CommonFlags = append(flags.Global.CommonFlags, "${config.TestsCflags}")
 }

 if android.IsThirdPartyPath(modulePath) {
  flags.Global.CommonFlags = append(flags.Global.CommonFlags, "${config.ExternalCflags}")
 }

 if Bool(compiler.Properties.Rtti) {
  flags.Local.CppFlags = append(flags.Local.CppFlags, "-frtti")
 } else {
  flags.Local.CppFlags = append(flags.Local.CppFlags, "-fno-rtti")
 }

 flags.Global.AsFlags = append(flags.Global.AsFlags, "${config.CommonGlobalAsflags}")

 flags.Global.CppFlags = append(flags.Global.CppFlags, tc.Cppflags())

 flags.Global.YasmFlags = append(flags.Global.YasmFlags, tc.YasmFlags())

 // bpf targets don't need the target specific toolchain cflags. b/308826679
 if !proptools.Bool(compiler.Properties.Bpf_target) {
  flags.Global.CommonFlags = append(flags.Global.CommonFlags, tc.ToolchainCflags())
 }

 cStd := parseCStd(compiler.Properties.C_std)
 cppStd := parseCppStd(ctx, compiler.Properties.Cpp_std)

 cStd, cppStd = maybeReplaceGnuToC(compiler.Properties.Gnu_extensions, cStd, cppStd)

 flags.Local.ConlyFlags = append([]string{"-std=" + cStd}, flags.Local.ConlyFlags...)
 flags.Local.CppFlags = append([]string{"-std=" + cppStd}, flags.Local.CppFlags...)

 if ctx.inVendor() {
  flags.Local.CFlags = append(flags.Local.CFlags, esc(vendorcflags)...)
 }

 if ctx.inProduct() {
  flags.Local.CFlags = append(flags.Local.CFlags, esc(productcflags)...)
 }

 if ctx.inRecovery() {
  flags.Local.CFlags = append(flags.Local.CFlags, esc(compiler.Properties.Target.Recovery.Cflags)...)
 }

 if ctx.inVendorRamdisk() {
  flags.Local.CFlags = append(flags.Local.CFlags, esc(compiler.Properties.Target.Vendor_ramdisk.Cflags)...)
 }
 if ctx.inRamdisk() {
  flags.Local.CFlags = append(flags.Local.CFlags, esc(compiler.Properties.Target.Ramdisk.Cflags)...)
 }
 if !ctx.useSdk() {
  flags.Local.CFlags = append(flags.Local.CFlags, esc(compiler.Properties.Target.Platform.Cflags)...)
 }

 // We can enforce some rules more strictly in the code we own. strict
 // indicates if this is code that we can be stricter with. If we have
 // rules that we want to apply to *our* code (but maybe can't for
 // vendor/device specific things), we could extend this to be a ternary
 // value.
 strict := true
 if strings.HasPrefix(modulePath, "external/") {
  strict = false
 }

 // Can be used to make some annotations stricter for code we can fix
 // (such as when we mark functions as deprecated).
 if strict {
  flags.Global.CFlags = append(flags.Global.CFlags, "-DANDROID_STRICT")
 }

 if compiler.hasSrcExt(ctx, ".proto") {
  flags = protoFlags(ctx, flags, &compiler.Proto)
 }

 if compiler.hasSrcExt(ctx, ".y") || compiler.hasSrcExt(ctx, ".yy") {
  flags.Local.CommonFlags = append(flags.Local.CommonFlags,
   "-I"+android.PathForModuleGen(ctx, "yacc", ctx.ModuleDir()).String())
 }

 if len(compiler.Properties.Aidl.Libs) > 0 &&
  (len(compiler.Properties.Aidl.Include_dirs) > 0 || len(compiler.Properties.Aidl.Local_include_dirs) > 0) {
  ctx.ModuleErrorf("aidl.libs and (aidl.include_dirs or aidl.local_include_dirs) can't be set at the same time. For aidl headers, please only use aidl.libs prop")
 }

 if compiler.hasAidl(ctx, deps) {
  flags.aidlFlags = append(flags.aidlFlags, compiler.Properties.Aidl.Flags...)
  if len(compiler.Properties.Aidl.Local_include_dirs) > 0 {
   localAidlIncludeDirs := android.PathsForModuleSrc(ctx, compiler.Properties.Aidl.Local_include_dirs)
   flags.aidlFlags = append(flags.aidlFlags, includeDirsToFlags(localAidlIncludeDirs))
   for _, includeDir := range localAidlIncludeDirs {
    flags.aidlFlagsDeps = append(flags.aidlFlagsDeps, ctx.GlobFiles(filepath.Join(includeDir.String(), "**/*.aidl"), nil)...)
   }
  }
  if len(compiler.Properties.Aidl.Include_dirs) > 0 {
   rootAidlIncludeDirs := android.PathsForSource(ctx, compiler.Properties.Aidl.Include_dirs)
   flags.aidlFlags = append(flags.aidlFlags, includeDirsToFlags(rootAidlIncludeDirs))
   for _, includeDir := range rootAidlIncludeDirs {
    flags.aidlFlagsDeps = append(flags.aidlFlagsDeps, ctx.GlobFilesOutsideModuleDir(filepath.Join(includeDir.String(), "**/*.aidl"), nil)...)
   }
  }

  var rootAidlIncludeDirs android.Paths
  var aidlLibraryHdrs []depset.DepSet[android.Path]
  for _, aidlLibraryInfo := range deps.AidlLibraryInfos {
   rootAidlIncludeDirs = append(rootAidlIncludeDirs, aidlLibraryInfo.IncludeDirs.ToList()...)
   aidlLibraryHdrs = append(aidlLibraryHdrs, aidlLibraryInfo.Hdrs)
  }
  if len(rootAidlIncludeDirs) > 0 {
   flags.aidlFlags = append(flags.aidlFlags, includeDirsToFlags(rootAidlIncludeDirs))
   hdrs := depset.New(depset.PREORDER, nil, aidlLibraryHdrs).ToList()
   flags.aidlFlagsDeps = append(flags.aidlFlagsDeps, hdrs...)
  }

  if proptools.BoolDefault(compiler.Properties.Aidl.Generate_traces, true) {
   flags.aidlFlags = append(flags.aidlFlags, "-t")
  }

  aidlMinSdkVersion := ctx.minSdkVersion()
  if aidlMinSdkVersion == "" {
   aidlMinSdkVersion = "platform_apis"
  }
  flags.aidlFlags = append(flags.aidlFlags, "--min_sdk_version="+aidlMinSdkVersion)

  if compiler.hasSrcExt(ctx, ".aidl") {
   flags.Local.CommonFlags = append(flags.Local.CommonFlags,
    "-I"+android.PathForModuleGen(ctx, "aidl").String())
  }
  if len(deps.AidlLibraryInfos) > 0 {
   flags.Local.CommonFlags = append(flags.Local.CommonFlags,
    "-I"+android.PathForModuleGen(ctx, "aidl_library").String())
  }
 }

 if compiler.hasSrcExt(ctx, ".rscript") || compiler.hasSrcExt(ctx, ".fs") {
  flags = rsFlags(ctx, flags, &compiler.Properties)
 }

 if compiler.hasSrcExt(ctx, ".sysprop") {
  flags.Local.CommonFlags = append(flags.Local.CommonFlags,
   "-I"+android.PathForModuleGen(ctx, "sysprop", "include").String())
 }

 if len(compiler.srcsBeforeGen) > 0 {
  module := ctx.ModuleDir() + "/Android.bp:" + ctx.ModuleName()
  if inList("-Wno-error", flags.Local.CFlags) || inList("-Wno-error", flags.Local.CppFlags) {
   ctx.getOrCreateMakeVarsInfo().UsingWnoError = module
  } else if !inList("-Werror", flags.Local.CFlags) && !inList("-Werror", flags.Local.CppFlags) {
   if warningsAreAllowed(ctx.ModuleDir()) {
    ctx.getOrCreateMakeVarsInfo().WarningsAllowed = module
   } else {
    flags.Local.CFlags = append([]string{"-Werror"}, flags.Local.CFlags...)
   }
  }
 }

 if Bool(compiler.Properties.Openmp) {
  flags.Local.CFlags = append(flags.Local.CFlags, "-fopenmp")
 }

 if ctx.optimizeForSize() {
  flags.Local.CFlags = append(flags.Local.CFlags, "-Oz")
  if !ctx.Config().IsEnvFalse("THINLTO_USE_MLGO") {
   if ctx.Arch().ArchType == android.Arm64 {
    flags.Local.LdFlags = append(flags.Local.LdFlags, "-Wl,-mllvm,-enable-ml-inliner=release")
    flags.Local.LdFlags = append(flags.Local.LdFlags, "-Wl,-mllvm,-ml-inliner-model-selector=arm64-mixed")
   }
  }
 }

 // Exclude directories from manual binder interface allowed list.
 //TODO(b/145621474): Move this check into IInterface.h when clang-tidy no longer uses absolute paths.
 if android.HasAnyPrefix(ctx.ModuleDir(), allowedManualInterfacePaths) {
  flags.Local.CFlags = append(flags.Local.CFlags, "-DDO_NOT_CHECK_MANUAL_BINDER_INTERFACES")
 }

 flags.NoOverrideFlags = append(flags.NoOverrideFlags, "${config.NoOverrideGlobalCflags}")

 if flags.Toolchain.Is64Bit() {
  flags.NoOverrideFlags = append(flags.NoOverrideFlags, "${config.NoOverride64GlobalCflags}")
 }

 if ctx.testBinary() || ctx.testLibrary() {
  flags.NoOverrideFlags = append(flags.NoOverrideFlags, "${config.NoOverrideTestsGlobalCflags}")
 }

 if android.IsThirdPartyPath(ctx.ModuleDir()) {
  flags.NoOverrideFlags = append(flags.NoOverrideFlags, "${config.NoOverrideExternalGlobalCflags}")
 }

 return flags
}

func (compiler *baseCompiler) hasSrcExt(ctx BaseModuleContext, ext string) bool {
 for _, src := range compiler.srcsBeforeGen {
  if src.Ext() == ext {
   return true
  }
 }
 for _, src := range compiler.Properties.Srcs.GetOrDefault(ctx, nil) {
  if filepath.Ext(src) == ext {
   return true
  }
 }

 return false
}

var invalidDefineCharRegex = regexp.MustCompile("[^a-zA-Z0-9_]")

// makeDefineString transforms a name of an APEX module into a value to be used as value for C define
// For example, com.android.foo => COM_ANDROID_FOO
func makeDefineString(name string) string {
 return invalidDefineCharRegex.ReplaceAllString(strings.ToUpper(name), "_")
}

var gnuToCReplacer = strings.NewReplacer("gnu", "c")

func ndkPathDeps(ctx ModuleContext) android.Paths {
 if ctx.Module().(*Module).IsSdkVariant() {
  // The NDK sysroot timestamp file depends on all the NDK sysroot header files
  // for compiling src to obj files.
  return android.Paths{getNdkHeadersTimestampFile(ctx)}
 }
 return nil
}

func (compiler *baseCompiler) hasAidl(ctx BaseModuleContext, deps PathDeps) bool {
 return len(deps.AidlLibraryInfos) > 0 || compiler.hasSrcExt(ctx, ".aidl")
}

func (compiler *baseCompiler) compile(ctx ModuleContext, flags Flags, deps PathDeps) Objects {
 pathDeps := deps.GeneratedDeps
 pathDeps = append(pathDeps, ndkPathDeps(ctx)...)

 buildFlags := flagsToBuilderFlags(flags)

 srcs := slices.Clone(compiler.srcsBeforeGen)

 srcs, genDeps, info := genSources(ctx, deps.AidlLibraryInfos, srcs, buildFlags)
 pathDeps = append(pathDeps, genDeps...)

 compiler.pathDeps = pathDeps
 compiler.generatedSourceInfo = info
 compiler.cFlagsDeps = flags.CFlagsDeps

 // Save src, buildFlags and context
 compiler.srcs = srcs

 // Compile files listed in c.Properties.Srcs into objects
 objs := compileObjs(ctx, buildFlags, "", srcs,
  append(android.PathsForModuleSrc(ctx, compiler.Properties.Tidy_disabled_srcs), compiler.generatedSources...),
  android.PathsForModuleSrc(ctx, compiler.Properties.Tidy_timeout_srcs),
  pathDeps, compiler.cFlagsDeps, ctx.getSharedFlags())

 if ctx.Failed() {
  return Objects{}
 }

 return objs
}

// Compile a list of source files into objects a specified subdirectory
func compileObjs(ctx android.ModuleContext, flags builderFlags, subdir string,
 srcFiles, noTidySrcs, timeoutTidySrcs, pathDeps android.Paths, cFlagsDeps android.Paths,
 sharedFlags *SharedFlags) Objects {

 return transformSourceToObj(ctx, subdir, srcFiles, noTidySrcs, timeoutTidySrcs, flags, pathDeps, cFlagsDeps,
  sharedFlags)
}

// Properties for rust_bindgen related to generating rust bindings.
// This exists here so these properties can be included in a cc_default
// which can be used in both cc and rust modules.
type RustBindgenClangProperties struct {
 // list of directories relative to the Blueprints file that will
 // be added to the include path using -I
 Local_include_dirs proptools.Configurable[[]string] `android:"arch_variant,variant_prepend"`

 // list of static libraries that provide headers for this binding.
 Static_libs proptools.Configurable[[]string] `android:"arch_variant,variant_prepend"`

 // list of shared libraries that provide headers for this binding.
 Shared_libs proptools.Configurable[[]string] `android:"arch_variant"`

 // List of libraries which export include paths required for this module
 Header_libs proptools.Configurable[[]string] `android:"arch_variant,variant_prepend"`

 // list of clang flags required to correctly interpret the headers.
 Cflags proptools.Configurable[[]string] `android:"arch_variant"`

 // list of c++ specific clang flags required to correctly interpret the headers.
 // This is provided primarily to make sure cppflags defined in cc_defaults are pulled in.
 Cppflags proptools.Configurable[[]string] `android:"arch_variant"`

 // C standard version to use. Can be a specific version (such as "gnu11"),
 // "experimental" (which will use draft versions like C1x when available),
 // or the empty string (which will use the default).
 //
 // If this is set, the file extension will be ignored and this will be used as the std version value. Setting this
 // to "default" will use the build system default version. This cannot be set at the same time as cpp_std.
 C_std *string

 // C++ standard version to use. Can be a specific version (such as
 // "gnu++11"), "experimental" (which will use draft versions like C++1z when
 // available), or the empty string (which will use the default).
 //
 // If this is set, the file extension will be ignored and this will be used as the std version value. Setting this
 // to "default" will use the build system default version. This cannot be set at the same time as c_std.
 Cpp_std *string

 //TODO(b/161141999) Add support for headers from cc_library_header modules.
}