Documentation
¶
Index ¶
- Constants
- Variables
- func ASanSupported(goos, goarch string) bool
- func BuildModeSupported(compiler, buildmode, goos, goarch string) bool
- func FuzzInstrumented(goos, goarch string) bool
- func FuzzSupported(goos, goarch string) bool
- func InternalLinkPIESupported(goos, goarch string) bool
- func MSanSupported(goos, goarch string) bool
- func MustLinkExternal(goos, goarch string) bool
- func RaceDetectorSupported(goos, goarch string) bool
- type Arch
- type ArchFamily
Constants ¶
const ExecArgLengthLimit = (30 << 10)
ExecArgLengthLimit is the number of bytes we can safely pass as arguments to an exec.Command.
Windows has a limit of 32 KB. To be conservative and not worry about whether that includes spaces or not, just use 30 KB. Darwin's limit is less clear. The OS claims 256KB, but we've seen failures with arglen as small as 50KB.
Variables ¶
var Arch386 = &Arch{ Name: "386", Family: I386, ByteOrder: binary.LittleEndian, PtrSize: 4, RegSize: 4, MinLC: 1, Alignment: 1, CanMergeLoads: true, }
var ArchAMD64 = &Arch{ Name: "amd64", Family: AMD64, ByteOrder: binary.LittleEndian, PtrSize: 8, RegSize: 8, MinLC: 1, Alignment: 1, CanMergeLoads: true, }
var ArchARM = &Arch{ Name: "arm", Family: ARM, ByteOrder: binary.LittleEndian, PtrSize: 4, RegSize: 4, MinLC: 4, Alignment: 4, CanMergeLoads: false, }
var ArchARM64 = &Arch{ Name: "arm64", Family: ARM64, ByteOrder: binary.LittleEndian, PtrSize: 8, RegSize: 8, MinLC: 4, Alignment: 1, CanMergeLoads: true, }
var ArchLoong64 = &Arch{ Name: "loong64", Family: Loong64, ByteOrder: binary.LittleEndian, PtrSize: 8, RegSize: 8, MinLC: 4, Alignment: 8, CanMergeLoads: false, }
var ArchMIPS = &Arch{ Name: "mips", Family: MIPS, ByteOrder: binary.BigEndian, PtrSize: 4, RegSize: 4, MinLC: 4, Alignment: 4, CanMergeLoads: false, }
var ArchMIPS64 = &Arch{ Name: "mips64", Family: MIPS64, ByteOrder: binary.BigEndian, PtrSize: 8, RegSize: 8, MinLC: 4, Alignment: 8, CanMergeLoads: false, }
var ArchMIPS64LE = &Arch{ Name: "mips64le", Family: MIPS64, ByteOrder: binary.LittleEndian, PtrSize: 8, RegSize: 8, MinLC: 4, Alignment: 8, CanMergeLoads: false, }
var ArchMIPSLE = &Arch{ Name: "mipsle", Family: MIPS, ByteOrder: binary.LittleEndian, PtrSize: 4, RegSize: 4, MinLC: 4, Alignment: 4, CanMergeLoads: false, }
var ArchPPC64 = &Arch{ Name: "ppc64", Family: PPC64, ByteOrder: binary.BigEndian, PtrSize: 8, RegSize: 8, MinLC: 4, Alignment: 1, CanMergeLoads: false, }
var ArchPPC64LE = &Arch{ Name: "ppc64le", Family: PPC64, ByteOrder: binary.LittleEndian, PtrSize: 8, RegSize: 8, MinLC: 4, Alignment: 1, CanMergeLoads: true, }
var ArchRISCV64 = &Arch{ Name: "riscv64", Family: RISCV64, ByteOrder: binary.LittleEndian, PtrSize: 8, RegSize: 8, MinLC: 4, Alignment: 8, CanMergeLoads: false, }
var ArchS390X = &Arch{ Name: "s390x", Family: S390X, ByteOrder: binary.BigEndian, PtrSize: 8, RegSize: 8, MinLC: 2, Alignment: 1, CanMergeLoads: true, }
var ArchWasm = &Arch{ Name: "wasm", Family: Wasm, ByteOrder: binary.LittleEndian, PtrSize: 8, RegSize: 8, MinLC: 1, Alignment: 1, CanMergeLoads: false, }
var Archs = [...]*Arch{ Arch386, ArchAMD64, ArchARM, ArchARM64, ArchLoong64, ArchMIPS, ArchMIPSLE, ArchMIPS64, ArchMIPS64LE, ArchPPC64, ArchPPC64LE, ArchRISCV64, ArchS390X, ArchWasm, }
Functions ¶
func ASanSupported ¶
ASanSupported reports whether goos/goarch supports the address sanitizer option. There is a copy of this function in misc/cgo/testsanitizers/cc_test.go.
func BuildModeSupported ¶
BuildModeSupported reports whether goos/goarch supports the given build mode using the given compiler.
func FuzzInstrumented ¶
FuzzInstrumented reports whether fuzzing on goos/goarch uses coverage instrumentation. (FuzzInstrumented implies FuzzSupported.)
func FuzzSupported ¶
FuzzSupported reports whether goos/goarch supports fuzzing ('go test -fuzz=.').
func MSanSupported ¶
MSanSupported reports whether goos/goarch supports the memory sanitizer option. There is a copy of this function in misc/cgo/testsanitizers/cc_test.go.
func MustLinkExternal ¶
MustLinkExternal reports whether goos/goarch requires external linking. (This is the opposite of internal/testenv.CanInternalLink. Keep them in sync.)
func RaceDetectorSupported ¶
RaceDetectorSupported reports whether goos/goarch supports the race detector. There is a copy of this function in cmd/dist/test.go. Race detector only supports 48-bit VMA on arm64. But it will always return true for arm64, because we don't have VMA size information during the compile time.
Types ¶
type Arch ¶
type Arch struct {
Name string
Family ArchFamily
ByteOrder binary.ByteOrder
// PtrSize is the size in bytes of pointers and the
// predeclared "int", "uint", and "uintptr" types.
PtrSize int
// RegSize is the size in bytes of general purpose registers.
RegSize int
// MinLC is the minimum length of an instruction code.
MinLC int
// Alignment is maximum alignment required by the architecture
// for any (compiler-generated) load or store instruction.
// Loads or stores smaller than Alignment must be naturally aligned.
// Loads or stores larger than Alignment need only be Alignment-aligned.
Alignment int8
// CanMergeLoads reports whether the backend optimization passes
// can combine adjacent loads into a single larger, possibly unaligned, load.
// Note that currently the optimizations must be able to handle little endian byte order.
CanMergeLoads bool
}
Arch represents an individual architecture.
func (*Arch) InFamily ¶
func (a *Arch) InFamily(xs ...ArchFamily) bool
InFamily reports whether a is a member of any of the specified architecture families.
type ArchFamily ¶
type ArchFamily byte
ArchFamily represents a family of one or more related architectures. For example, ppc64 and ppc64le are both members of the PPC64 family.
const ( NoArch ArchFamily = iota AMD64 ARM ARM64 I386 Loong64 MIPS MIPS64 PPC64 RISCV64 S390X Wasm )
Source Files