| // Copyright 2016 The Go Authors. All rights reserved. |
| // Use of this source code is governed by a BSD-style |
| // license that can be found in the LICENSE file. |
| |
| package ld |
| |
| import ( |
| "cmd/internal/sys" |
| "fmt" |
| "internal/buildcfg" |
| ) |
| |
| // A BuildMode indicates the sort of object we are building. |
| // |
| // Possible build modes are the same as those for the -buildmode flag |
| // in cmd/go, and are documented in 'go help buildmode'. |
| type BuildMode uint8 |
| |
| const ( |
| BuildModeUnset BuildMode = iota |
| BuildModeExe |
| BuildModePIE |
| BuildModeCArchive |
| BuildModeCShared |
| BuildModeShared |
| BuildModePlugin |
| ) |
| |
| func (mode *BuildMode) Set(s string) error { |
| badmode := func() error { |
| return fmt.Errorf("buildmode %s not supported on %s/%s", s, buildcfg.GOOS, buildcfg.GOARCH) |
| } |
| switch s { |
| default: |
| return fmt.Errorf("invalid buildmode: %q", s) |
| case "exe": |
| switch buildcfg.GOOS + "/" + buildcfg.GOARCH { |
| case "darwin/arm64", "windows/arm", "windows/arm64": // On these platforms, everything is PIE |
| *mode = BuildModePIE |
| default: |
| *mode = BuildModeExe |
| } |
| case "pie": |
| switch buildcfg.GOOS { |
| case "aix", "android", "linux", "windows", "darwin", "ios": |
| case "freebsd": |
| switch buildcfg.GOARCH { |
| case "amd64": |
| default: |
| return badmode() |
| } |
| default: |
| return badmode() |
| } |
| *mode = BuildModePIE |
| case "c-archive": |
| switch buildcfg.GOOS { |
| case "aix", "darwin", "ios", "linux": |
| case "freebsd": |
| switch buildcfg.GOARCH { |
| case "amd64": |
| default: |
| return badmode() |
| } |
| case "windows": |
| switch buildcfg.GOARCH { |
| case "amd64", "386", "arm", "arm64": |
| default: |
| return badmode() |
| } |
| default: |
| return badmode() |
| } |
| *mode = BuildModeCArchive |
| case "c-shared": |
| switch buildcfg.GOARCH { |
| case "386", "amd64", "arm", "arm64", "ppc64le", "riscv64", "s390x": |
| default: |
| return badmode() |
| } |
| *mode = BuildModeCShared |
| case "shared": |
| switch buildcfg.GOOS { |
| case "linux": |
| switch buildcfg.GOARCH { |
| case "386", "amd64", "arm", "arm64", "ppc64le", "s390x": |
| default: |
| return badmode() |
| } |
| default: |
| return badmode() |
| } |
| *mode = BuildModeShared |
| case "plugin": |
| switch buildcfg.GOOS { |
| case "linux": |
| switch buildcfg.GOARCH { |
| case "386", "amd64", "arm", "arm64", "s390x", "ppc64le": |
| default: |
| return badmode() |
| } |
| case "darwin": |
| switch buildcfg.GOARCH { |
| case "amd64", "arm64": |
| default: |
| return badmode() |
| } |
| case "freebsd": |
| switch buildcfg.GOARCH { |
| case "amd64": |
| default: |
| return badmode() |
| } |
| default: |
| return badmode() |
| } |
| *mode = BuildModePlugin |
| } |
| return nil |
| } |
| |
| func (mode *BuildMode) String() string { |
| switch *mode { |
| case BuildModeUnset: |
| return "" // avoid showing a default in usage message |
| case BuildModeExe: |
| return "exe" |
| case BuildModePIE: |
| return "pie" |
| case BuildModeCArchive: |
| return "c-archive" |
| case BuildModeCShared: |
| return "c-shared" |
| case BuildModeShared: |
| return "shared" |
| case BuildModePlugin: |
| return "plugin" |
| } |
| return fmt.Sprintf("BuildMode(%d)", uint8(*mode)) |
| } |
| |
| // LinkMode indicates whether an external linker is used for the final link. |
| type LinkMode uint8 |
| |
| const ( |
| LinkAuto LinkMode = iota |
| LinkInternal |
| LinkExternal |
| ) |
| |
| func (mode *LinkMode) Set(s string) error { |
| switch s { |
| default: |
| return fmt.Errorf("invalid linkmode: %q", s) |
| case "auto": |
| *mode = LinkAuto |
| case "internal": |
| *mode = LinkInternal |
| case "external": |
| *mode = LinkExternal |
| } |
| return nil |
| } |
| |
| func (mode *LinkMode) String() string { |
| switch *mode { |
| case LinkAuto: |
| return "auto" |
| case LinkInternal: |
| return "internal" |
| case LinkExternal: |
| return "external" |
| } |
| return fmt.Sprintf("LinkMode(%d)", uint8(*mode)) |
| } |
| |
| // mustLinkExternal reports whether the program being linked requires |
| // the external linker be used to complete the link. |
| func mustLinkExternal(ctxt *Link) (res bool, reason string) { |
| if ctxt.Debugvlog > 1 { |
| defer func() { |
| if res { |
| ctxt.Logf("external linking is forced by: %s\n", reason) |
| } |
| }() |
| } |
| |
| if sys.MustLinkExternal(buildcfg.GOOS, buildcfg.GOARCH) { |
| return true, fmt.Sprintf("%s/%s requires external linking", buildcfg.GOOS, buildcfg.GOARCH) |
| } |
| |
| if *flagMsan { |
| return true, "msan" |
| } |
| |
| if *flagAsan { |
| return true, "asan" |
| } |
| |
| // Internally linking cgo is incomplete on some architectures. |
| // https://golang.org/issue/14449 |
| if iscgo && ctxt.Arch.InFamily(sys.MIPS64, sys.MIPS, sys.RISCV64) { |
| return true, buildcfg.GOARCH + " does not support internal cgo" |
| } |
| if iscgo && (buildcfg.GOOS == "android" || buildcfg.GOOS == "dragonfly") { |
| // It seems that on Dragonfly thread local storage is |
| // set up by the dynamic linker, so internal cgo linking |
| // doesn't work. Test case is "go test runtime/cgo". |
| return true, buildcfg.GOOS + " does not support internal cgo" |
| } |
| if iscgo && buildcfg.GOOS == "windows" && buildcfg.GOARCH == "arm64" { |
| // windows/arm64 internal linking is not implemented. |
| return true, buildcfg.GOOS + "/" + buildcfg.GOARCH + " does not support internal cgo" |
| } |
| if iscgo && ctxt.Arch == sys.ArchPPC64 { |
| // Big Endian PPC64 cgo internal linking is not implemented for aix or linux. |
| return true, buildcfg.GOOS + " does not support internal cgo" |
| } |
| |
| // Some build modes require work the internal linker cannot do (yet). |
| switch ctxt.BuildMode { |
| case BuildModeCArchive: |
| return true, "buildmode=c-archive" |
| case BuildModeCShared: |
| return true, "buildmode=c-shared" |
| case BuildModePIE: |
| switch buildcfg.GOOS + "/" + buildcfg.GOARCH { |
| case "android/arm64": |
| case "linux/amd64", "linux/arm64", "linux/ppc64le": |
| case "windows/386", "windows/amd64", "windows/arm", "windows/arm64": |
| case "darwin/amd64", "darwin/arm64": |
| default: |
| // Internal linking does not support TLS_IE. |
| return true, "buildmode=pie" |
| } |
| case BuildModePlugin: |
| return true, "buildmode=plugin" |
| case BuildModeShared: |
| return true, "buildmode=shared" |
| } |
| if ctxt.linkShared { |
| return true, "dynamically linking with a shared library" |
| } |
| |
| if unknownObjFormat { |
| return true, "some input objects have an unrecognized file format" |
| } |
| |
| return false, "" |
| } |
| |
| // determineLinkMode sets ctxt.LinkMode. |
| // |
| // It is called after flags are processed and inputs are processed, |
| // so the ctxt.LinkMode variable has an initial value from the -linkmode |
| // flag and the iscgo, externalobj, and unknownObjFormat variables are set. |
| func determineLinkMode(ctxt *Link) { |
| extNeeded, extReason := mustLinkExternal(ctxt) |
| via := "" |
| |
| if ctxt.LinkMode == LinkAuto { |
| // The environment variable GO_EXTLINK_ENABLED controls the |
| // default value of -linkmode. If it is not set when the |
| // linker is called we take the value it was set to when |
| // cmd/link was compiled. (See make.bash.) |
| switch buildcfg.Getgoextlinkenabled() { |
| case "0": |
| ctxt.LinkMode = LinkInternal |
| via = "via GO_EXTLINK_ENABLED " |
| case "1": |
| ctxt.LinkMode = LinkExternal |
| via = "via GO_EXTLINK_ENABLED " |
| default: |
| if extNeeded || (iscgo && externalobj) { |
| ctxt.LinkMode = LinkExternal |
| } else { |
| ctxt.LinkMode = LinkInternal |
| } |
| } |
| } |
| |
| switch ctxt.LinkMode { |
| case LinkInternal: |
| if extNeeded { |
| Exitf("internal linking requested %sbut external linking required: %s", via, extReason) |
| } |
| case LinkExternal: |
| switch { |
| case buildcfg.GOARCH == "ppc64" && buildcfg.GOOS != "aix": |
| Exitf("external linking not supported for %s/ppc64", buildcfg.GOOS) |
| } |
| } |
| } |