| // 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 ( |
| "github.com/google/blueprint" |
| |
| "android/soong/android" |
| ) |
| |
| type BinaryLinkerProperties struct { |
| // compile executable with -static |
| Static_executable *bool `android:"arch_variant"` |
| |
| // set the name of the output |
| Stem *string `android:"arch_variant"` |
| |
| // append to the name of the output |
| Suffix *string `android:"arch_variant"` |
| |
| // if set, add an extra objcopy --prefix-symbols= step |
| Prefix_symbols *string |
| |
| // if set, install a symlink to the preferred architecture |
| Symlink_preferred_arch *bool |
| |
| // install symlinks to the binary. Symlink names will have the suffix and the binary |
| // extension (if any) appended |
| Symlinks []string `android:"arch_variant"` |
| |
| DynamicLinker string `blueprint:"mutated"` |
| |
| // Names of modules to be overridden. Listed modules can only be other binaries |
| // (in Make or Soong). |
| // This does not completely prevent installation of the overridden binaries, but if both |
| // binaries would be installed by default (in PRODUCT_PACKAGES) the other binary will be removed |
| // from PRODUCT_PACKAGES. |
| Overrides []string |
| } |
| |
| func init() { |
| android.RegisterModuleType("cc_binary", binaryFactory) |
| android.RegisterModuleType("cc_binary_host", binaryHostFactory) |
| } |
| |
| // Module factory for binaries |
| func binaryFactory() android.Module { |
| module, _ := NewBinary(android.HostAndDeviceSupported) |
| return module.Init() |
| } |
| |
| // Module factory for host binaries |
| func binaryHostFactory() android.Module { |
| module, _ := NewBinary(android.HostSupported) |
| return module.Init() |
| } |
| |
| // |
| // Executables |
| // |
| |
| type binaryDecorator struct { |
| *baseLinker |
| *baseInstaller |
| stripper |
| |
| Properties BinaryLinkerProperties |
| |
| toolPath android.OptionalPath |
| |
| // Location of the linked, unstripped binary |
| unstrippedOutputFile android.Path |
| |
| // Names of symlinks to be installed for use in LOCAL_MODULE_SYMLINKS |
| symlinks []string |
| |
| // Output archive of gcno coverage information |
| coverageOutputFile android.OptionalPath |
| } |
| |
| var _ linker = (*binaryDecorator)(nil) |
| |
| func (binary *binaryDecorator) linkerProps() []interface{} { |
| return append(binary.baseLinker.linkerProps(), |
| &binary.Properties, |
| &binary.stripper.StripProperties) |
| |
| } |
| |
| func (binary *binaryDecorator) getStem(ctx BaseModuleContext) string { |
| stem := ctx.baseModuleName() |
| if String(binary.Properties.Stem) != "" { |
| stem = String(binary.Properties.Stem) |
| } |
| |
| return stem + String(binary.Properties.Suffix) |
| } |
| |
| func (binary *binaryDecorator) linkerDeps(ctx DepsContext, deps Deps) Deps { |
| deps = binary.baseLinker.linkerDeps(ctx, deps) |
| if ctx.toolchain().Bionic() { |
| if !Bool(binary.baseLinker.Properties.Nocrt) { |
| if !ctx.useSdk() { |
| if binary.static() { |
| deps.CrtBegin = "crtbegin_static" |
| } else { |
| deps.CrtBegin = "crtbegin_dynamic" |
| } |
| deps.CrtEnd = "crtend_android" |
| } else { |
| // TODO(danalbert): Add generation of crt objects. |
| // For `sdk_version: "current"`, we don't actually have a |
| // freshly generated set of CRT objects. Use the last stable |
| // version. |
| version := ctx.sdkVersion() |
| if version == "current" { |
| version = getCurrentNdkPrebuiltVersion(ctx) |
| } |
| |
| if binary.static() { |
| deps.CrtBegin = "ndk_crtbegin_static." + version |
| } else { |
| if binary.static() { |
| deps.CrtBegin = "ndk_crtbegin_static." + version |
| } else { |
| deps.CrtBegin = "ndk_crtbegin_dynamic." + version |
| } |
| deps.CrtEnd = "ndk_crtend_android." + version |
| } |
| } |
| } |
| |
| if binary.static() { |
| if ctx.selectedStl() == "libc++_static" { |
| deps.StaticLibs = append(deps.StaticLibs, "libm", "libc", "libdl") |
| } |
| // static libraries libcompiler_rt, libc and libc_nomalloc need to be linked with |
| // --start-group/--end-group along with libgcc. If they are in deps.StaticLibs, |
| // move them to the beginning of deps.LateStaticLibs |
| var groupLibs []string |
| deps.StaticLibs, groupLibs = filterList(deps.StaticLibs, |
| []string{"libc", "libc_nomalloc", "libcompiler_rt"}) |
| deps.LateStaticLibs = append(groupLibs, deps.LateStaticLibs...) |
| } |
| |
| if ctx.Os() == android.LinuxBionic && !binary.static() { |
| deps.DynamicLinker = "linker" |
| deps.LinkerFlagsFile = "host_bionic_linker_flags" |
| } |
| } |
| |
| if !binary.static() && inList("libc", deps.StaticLibs) { |
| ctx.ModuleErrorf("statically linking libc to dynamic executable, please remove libc\n" + |
| "from static libs or set static_executable: true") |
| } |
| |
| return deps |
| } |
| |
| func (binary *binaryDecorator) isDependencyRoot() bool { |
| return true |
| } |
| |
| func NewBinary(hod android.HostOrDeviceSupported) (*Module, *binaryDecorator) { |
| module := newModule(hod, android.MultilibFirst) |
| binary := &binaryDecorator{ |
| baseLinker: NewBaseLinker(module.sanitize), |
| baseInstaller: NewBaseInstaller("bin", "", InstallInSystem), |
| } |
| module.compiler = NewBaseCompiler() |
| module.linker = binary |
| module.installer = binary |
| return module, binary |
| } |
| |
| func (binary *binaryDecorator) linkerInit(ctx BaseModuleContext) { |
| binary.baseLinker.linkerInit(ctx) |
| |
| if !ctx.toolchain().Bionic() { |
| if ctx.Os() == android.Linux { |
| if binary.Properties.Static_executable == nil && ctx.Config().HostStaticBinaries() { |
| binary.Properties.Static_executable = BoolPtr(true) |
| } |
| } else { |
| // Static executables are not supported on Darwin or Windows |
| binary.Properties.Static_executable = nil |
| } |
| } |
| } |
| |
| func (binary *binaryDecorator) static() bool { |
| return Bool(binary.Properties.Static_executable) |
| } |
| |
| func (binary *binaryDecorator) staticBinary() bool { |
| return binary.static() |
| } |
| |
| func (binary *binaryDecorator) linkerFlags(ctx ModuleContext, flags Flags) Flags { |
| flags = binary.baseLinker.linkerFlags(ctx, flags) |
| |
| if ctx.Host() && !ctx.Windows() && !binary.static() { |
| if !ctx.Config().IsEnvTrue("DISABLE_HOST_PIE") { |
| flags.LdFlags = append(flags.LdFlags, "-pie") |
| } |
| } |
| |
| // MinGW spits out warnings about -fPIC even for -fpie?!) being ignored because |
| // all code is position independent, and then those warnings get promoted to |
| // errors. |
| if !ctx.Windows() { |
| flags.CFlags = append(flags.CFlags, "-fPIE") |
| } |
| |
| if ctx.toolchain().Bionic() { |
| if binary.static() { |
| // Clang driver needs -static to create static executable. |
| // However, bionic/linker uses -shared to overwrite. |
| // Linker for x86 targets does not allow coexistance of -static and -shared, |
| // so we add -static only if -shared is not used. |
| if !inList("-shared", flags.LdFlags) { |
| flags.LdFlags = append(flags.LdFlags, "-static") |
| } |
| |
| flags.LdFlags = append(flags.LdFlags, |
| "-nostdlib", |
| "-Bstatic", |
| "-Wl,--gc-sections", |
| ) |
| } else { |
| if flags.DynamicLinker == "" { |
| if binary.Properties.DynamicLinker != "" { |
| flags.DynamicLinker = binary.Properties.DynamicLinker |
| } else { |
| switch ctx.Os() { |
| case android.Android: |
| flags.DynamicLinker = "/system/bin/linker" |
| if flags.Toolchain.Is64Bit() { |
| flags.DynamicLinker += "64" |
| } |
| case android.LinuxBionic: |
| flags.DynamicLinker = "" |
| default: |
| ctx.ModuleErrorf("unknown dynamic linker") |
| } |
| } |
| |
| if ctx.Os() == android.LinuxBionic { |
| // Use the dlwrap entry point, but keep _start around so |
| // that it can be used by host_bionic_inject |
| flags.LdFlags = append(flags.LdFlags, |
| "-Wl,--entry=__dlwrap__start", |
| "-Wl,--undefined=_start", |
| ) |
| } |
| } |
| |
| flags.LdFlags = append(flags.LdFlags, |
| "-pie", |
| "-nostdlib", |
| "-Bdynamic", |
| "-Wl,--gc-sections", |
| "-Wl,-z,nocopyreloc", |
| ) |
| } |
| } else { |
| if binary.static() { |
| flags.LdFlags = append(flags.LdFlags, "-static") |
| } |
| if ctx.Darwin() { |
| flags.LdFlags = append(flags.LdFlags, "-Wl,-headerpad_max_install_names") |
| } |
| } |
| |
| return flags |
| } |
| |
| func (binary *binaryDecorator) link(ctx ModuleContext, |
| flags Flags, deps PathDeps, objs Objects) android.Path { |
| |
| fileName := binary.getStem(ctx) + flags.Toolchain.ExecutableSuffix() |
| outputFile := android.PathForModuleOut(ctx, fileName) |
| ret := outputFile |
| |
| var linkerDeps android.Paths |
| |
| sharedLibs := deps.SharedLibs |
| sharedLibs = append(sharedLibs, deps.LateSharedLibs...) |
| |
| if deps.LinkerFlagsFile.Valid() { |
| flags.LdFlags = append(flags.LdFlags, "$$(cat "+deps.LinkerFlagsFile.String()+")") |
| linkerDeps = append(linkerDeps, deps.LinkerFlagsFile.Path()) |
| } |
| |
| if flags.DynamicLinker != "" { |
| flags.LdFlags = append(flags.LdFlags, "-Wl,-dynamic-linker,"+flags.DynamicLinker) |
| } else if ctx.toolchain().Bionic() && !binary.static() { |
| flags.LdFlags = append(flags.LdFlags, "-Wl,--no-dynamic-linker") |
| } |
| |
| builderFlags := flagsToBuilderFlags(flags) |
| |
| if binary.stripper.needsStrip(ctx) { |
| // b/80093681, GNU strip/objcopy bug. |
| // Use llvm-{strip,objcopy} when clang lld is used. |
| builderFlags.stripUseLlvmStrip = binary.baseLinker.useClangLld(ctx) |
| strippedOutputFile := outputFile |
| outputFile = android.PathForModuleOut(ctx, "unstripped", fileName) |
| binary.stripper.strip(ctx, outputFile, strippedOutputFile, builderFlags) |
| } |
| |
| binary.unstrippedOutputFile = outputFile |
| |
| if String(binary.Properties.Prefix_symbols) != "" { |
| afterPrefixSymbols := outputFile |
| outputFile = android.PathForModuleOut(ctx, "unprefixed", fileName) |
| TransformBinaryPrefixSymbols(ctx, String(binary.Properties.Prefix_symbols), outputFile, |
| flagsToBuilderFlags(flags), afterPrefixSymbols) |
| } |
| |
| if Bool(binary.baseLinker.Properties.Use_version_lib) && ctx.Host() { |
| versionedOutputFile := outputFile |
| outputFile = android.PathForModuleOut(ctx, "unversioned", fileName) |
| binary.injectVersionSymbol(ctx, outputFile, versionedOutputFile) |
| } |
| |
| if ctx.Os() == android.LinuxBionic && !binary.static() { |
| injectedOutputFile := outputFile |
| outputFile = android.PathForModuleOut(ctx, "prelinker", fileName) |
| |
| if !deps.DynamicLinker.Valid() { |
| panic("Non-static host bionic modules must have a dynamic linker") |
| } |
| |
| binary.injectHostBionicLinkerSymbols(ctx, outputFile, deps.DynamicLinker.Path(), injectedOutputFile) |
| } |
| |
| linkerDeps = append(linkerDeps, deps.SharedLibsDeps...) |
| linkerDeps = append(linkerDeps, deps.LateSharedLibsDeps...) |
| linkerDeps = append(linkerDeps, objs.tidyFiles...) |
| linkerDeps = append(linkerDeps, flags.LdFlagsDeps...) |
| |
| TransformObjToDynamicBinary(ctx, objs.objFiles, sharedLibs, deps.StaticLibs, |
| deps.LateStaticLibs, deps.WholeStaticLibs, linkerDeps, deps.CrtBegin, deps.CrtEnd, true, |
| builderFlags, outputFile) |
| |
| objs.coverageFiles = append(objs.coverageFiles, deps.StaticLibObjs.coverageFiles...) |
| objs.coverageFiles = append(objs.coverageFiles, deps.WholeStaticLibObjs.coverageFiles...) |
| binary.coverageOutputFile = TransformCoverageFilesToLib(ctx, objs, builderFlags, binary.getStem(ctx)) |
| |
| return ret |
| } |
| |
| func (binary *binaryDecorator) install(ctx ModuleContext, file android.Path) { |
| binary.baseInstaller.install(ctx, file) |
| for _, symlink := range binary.Properties.Symlinks { |
| binary.symlinks = append(binary.symlinks, |
| symlink+String(binary.Properties.Suffix)+ctx.toolchain().ExecutableSuffix()) |
| } |
| |
| if Bool(binary.Properties.Symlink_preferred_arch) { |
| if String(binary.Properties.Stem) == "" && String(binary.Properties.Suffix) == "" { |
| ctx.PropertyErrorf("symlink_preferred_arch", "must also specify stem or suffix") |
| } |
| if ctx.TargetPrimary() { |
| binary.symlinks = append(binary.symlinks, ctx.baseModuleName()) |
| } |
| } |
| |
| for _, symlink := range binary.symlinks { |
| ctx.InstallSymlink(binary.baseInstaller.installDir(ctx), symlink, binary.baseInstaller.path) |
| } |
| |
| if ctx.Os().Class == android.Host { |
| binary.toolPath = android.OptionalPathForPath(binary.baseInstaller.path) |
| } |
| } |
| |
| func (binary *binaryDecorator) hostToolPath() android.OptionalPath { |
| return binary.toolPath |
| } |
| |
| func init() { |
| pctx.HostBinToolVariable("hostBionicSymbolsInjectCmd", "host_bionic_inject") |
| } |
| |
| var injectHostBionicSymbols = pctx.AndroidStaticRule("injectHostBionicSymbols", |
| blueprint.RuleParams{ |
| Command: "$hostBionicSymbolsInjectCmd -i $in -l $linker -o $out", |
| CommandDeps: []string{"$hostBionicSymbolsInjectCmd"}, |
| }, "linker") |
| |
| func (binary *binaryDecorator) injectHostBionicLinkerSymbols(ctx ModuleContext, in, linker android.Path, out android.WritablePath) { |
| ctx.Build(pctx, android.BuildParams{ |
| Rule: injectHostBionicSymbols, |
| Description: "inject host bionic symbols", |
| Input: in, |
| Implicit: linker, |
| Output: out, |
| Args: map[string]string{ |
| "linker": linker.String(), |
| }, |
| }) |
| } |