package buildcfg

Import Path
	internal/buildcfg (on go.dev)

Dependency Relation
	imports 8 packages, and imported by 2 packages

Involved Source Files

	  d cfg.go
		Package buildcfg provides access to the build configuration
		described by the current environment. It is for use by build tools
		such as cmd/go or cmd/compile and for setting up go/build's Default context.
		
		Note that it does NOT provide access to the build configuration used to
		build the currently-running binary. For that, use runtime.GOOS etc
		as well as internal/goexperiment.

	    exp.go
	    zbootstrap.go
Package-Level Type Names (total 4, in which 3 are exported)

	/* sort exporteds by: alphabet | popularity */
	 type ExperimentFlags (struct)
		ExperimentFlags represents a set of GOEXPERIMENT flags relative to a baseline
		(platform-default) experiment configuration.

		Fields (total 21, in which 20 are exported)
			Flags goexperiment.Flags
			Flags.AliasTypeParams bool
				AliasTypeParams enables type parameters for alias types.
				Requires that gotypesalias=1 is set with GODEBUG.
				This flag will be removed with Go 1.25.

			Flags.Arenas bool
				Arenas causes the "arena" standard library package to be visible
				to the outside world.

			Flags.BoringCrypto bool
			Flags.CacheProg bool
				CacheProg adds support to cmd/go to use a child process to implement
				the build cache; see https://github.com/golang/go/issues/59719.

			Flags.CgoCheck2 bool
				CgoCheck2 enables an expensive cgo rule checker.
				When this experiment is enabled, cgo rule checks occur regardless
				of the GODEBUG=cgocheck setting provided at runtime.

			Flags.CoverageRedesign bool
				CoverageRedesign enables the new compiler-based code coverage
				tooling.

			Flags.FieldTrack bool
			Flags.HeapMinimum512KiB bool
				HeapMinimum512KiB reduces the minimum heap size to 512 KiB.
				
				This was originally reduced as part of PacerRedesign, but
				has been broken out to its own experiment that is disabled
				by default.

			Flags.LoopVar bool
				LoopVar changes loop semantics so that each iteration gets its own
				copy of the iteration variable.

			Flags.NewInliner bool
				NewInliner enables a new+improved version of the function
				inlining phase within the Go compiler.

			Flags.PreemptibleLoops bool
			Flags.RangeFunc bool
				RangeFunc enables range over func.

			Flags.RegabiArgs bool
				RegabiArgs enables register arguments/results in all
				compiled Go functions.
				
				Requires wrappers (to do ABI translation), and reflect (so
				reflection calls use registers).

			Flags.RegabiWrappers bool
				RegabiWrappers enables ABI wrappers for calling between
				ABI0 and ABIInternal functions. Without this, the ABIs are
				assumed to be identical so cross-ABI calls are direct.

			Flags.SpinbitMutex bool
				SpinbitMutex enables the new "spinbit" mutex implementation on supported
				platforms. See https://go.dev/issue/68578.

			Flags.StaticLockRanking bool
			Flags.SwissMap bool
				SwissMap enables the SwissTable-based map implementation.

			Flags.SyncHashTrieMap bool
				SyncHashTrieMap enables the HashTrieMap sync.Map implementation.

			Flags.Synctest bool
				Synctest enables the testing/synctest package.

			/* one unexported ... *//* one unexported: */
			baseline goexperiment.Flags
		Methods (total 3, all are exported)
			(*ExperimentFlags) All() []string
				All returns a list of all experiment settings.
				Disabled experiments appear in the list prefixed by "no".

			(*ExperimentFlags) Enabled() []string
				Enabled returns a list of enabled experiments, as
				lower-cased experiment names.

			(*ExperimentFlags) String() string
				String returns the canonical GOEXPERIMENT string to enable this experiment
				configuration. (Experiments in the same state as in the baseline are elided.)

		Implements (at least 5, in which 2 are exported)
			*ExperimentFlags : expvar.Var
			*ExperimentFlags : fmt.Stringer
			/* 3+ unexporteds ... *//* 3+ unexporteds: */
			*ExperimentFlags : context.stringer
			*ExperimentFlags : github.com/aws/smithy-go/middleware.stringer
			*ExperimentFlags : runtime.stringer
		As Outputs Of (at least one exported)
			func ParseGOEXPERIMENT(goos, goarch, goexp string) (*ExperimentFlags, error)
		As Types Of (only one, which is exported)
			  var Experiment

	 type Goarm64Features (struct)

		Fields (total 3, all are exported)
			Crypto bool
				ARM v8.0 Cryptographic Extension. It includes the following features:
				* FEAT_AES, which includes the AESD and AESE instructions.
				* FEAT_PMULL, which includes the PMULL, PMULL2 instructions.
				* FEAT_SHA1, which includes the SHA1* instructions.
				* FEAT_SHA256, which includes the SHA256* instructions.

			LSE bool
				Large Systems Extension

			Version string
		Methods (total 2, both are exported)
			( Goarm64Features) String() string
			( Goarm64Features) Supports(s string) bool
				Returns true if g supports giving ARM64 ISA
				Note that this function doesn't accept / test suffixes (like ",lse" or ",crypto")

		Implements (at least 5, in which 2 are exported)
			 Goarm64Features : expvar.Var
			 Goarm64Features : fmt.Stringer
			/* 3+ unexporteds ... *//* 3+ unexporteds: */
			 Goarm64Features : context.stringer
			 Goarm64Features : github.com/aws/smithy-go/middleware.stringer
			 Goarm64Features : runtime.stringer
		As Outputs Of (at least 2, in which 1 is exported)
			func ParseGoarm64(v string) (g Goarm64Features, e error)
			/* at least one unexported ... *//* at least one unexported: */
			func goarm64() (g Goarm64Features)
		As Types Of (only one, which is exported)
			  var GOARM64

	 type GoarmFeatures (struct)

		Fields (total 2, both are exported)
			SoftFloat bool
			Version int
		Methods (only one, which is exported)
			( GoarmFeatures) String() string
		Implements (at least 5, in which 2 are exported)
			 GoarmFeatures : expvar.Var
			 GoarmFeatures : fmt.Stringer
			/* 3+ unexporteds ... *//* 3+ unexporteds: */
			 GoarmFeatures : context.stringer
			 GoarmFeatures : github.com/aws/smithy-go/middleware.stringer
			 GoarmFeatures : runtime.stringer
		As Outputs Of (at least one unexported)
			/* at least one unexported ... *//* at least one unexported: */
			func goarm() (g GoarmFeatures)
		As Types Of (only one, which is exported)
			  var GOARM

	/* one unexported ... *//* one unexported: */
	 type gowasmFeatures (struct)

		Fields (total 2, both are exported)
			SatConv bool
			SignExt bool
		Methods (only one, which is exported)
			( gowasmFeatures) String() string
		Implements (at least 5, in which 2 are exported)
			 gowasmFeatures : expvar.Var
			 gowasmFeatures : fmt.Stringer
			/* 3+ unexporteds ... *//* 3+ unexporteds: */
			 gowasmFeatures : context.stringer
			 gowasmFeatures : github.com/aws/smithy-go/middleware.stringer
			 gowasmFeatures : runtime.stringer
		As Outputs Of (at least one unexported)
			/* at least one unexported ... *//* at least one unexported: */
			func gowasm() (f gowasmFeatures)
		As Types Of (only one, which is exported)
			  var GOWASM


Package-Level Functions (total 21, in which 5 are exported)

	 func Check()
		Check exits the program with a fatal error if Error is non-nil.

	 func Getgoextlinkenabled() string
	 func GOGOARCH() (name, value string)
		GOGOARCH returns the name and value of the GO$GOARCH setting.
		For example, if GOARCH is "amd64" it might return "GOAMD64", "v2".

	 func ParseGoarm64(v string) (g Goarm64Features, e error)
	 func ParseGOEXPERIMENT(goos, goarch, goexp string) (*ExperimentFlags, error)
		ParseGOEXPERIMENT parses a (GOOS, GOARCH, GOEXPERIMENT)
		configuration tuple and returns the enabled and baseline experiment
		flag sets.
		
		TODO(mdempsky): Move to internal/goexperiment.

	/* 16 unexporteds ... *//* 16 unexporteds: */
	 func envOr(key, value string) string
	 func experimentTags() []string
	 func expList(exp, base *goexperiment.Flags, all bool) []string
		expList returns the list of lower-cased experiment names for
		experiments that differ from base. base may be nil to indicate no
		experiments. If all is true, then include all experiment flags,
		regardless of base.

	 func goamd64() int
	 func goarm() (g GoarmFeatures)
	 func goarm64() (g Goarm64Features)
	 func gofips140() string
	 func gogoarchTags() []string
	 func gomips() string
	 func gomips64() string
	 func goppc64() int
	 func goriscv64() int
	 func gowasm() (f gowasmFeatures)
	 func isFIPSVersion(v string) bool
		isFIPSVersion reports whether v is a valid FIPS version,
		of the form vX.Y.Z.

	 func skipNum(s string) (rest string, ok bool)
		skipNum skips the leading text matching [0-9]+
		in s, returning the rest and whether such text was found.

	 func toolTags() []string
Package-Level Variables (total 19, all are exported)

	  var Error error
		Error is one of the errors found (if any) in the build configuration.

	  var Experiment ExperimentFlags
		Experiment contains the toolchain experiments enabled for the
		current build.
		
		(This is not necessarily the set of experiments the compiler itself
		was built with.)
		
		experimentBaseline specifies the experiment flags that are enabled by
		default in the current toolchain. This is, in effect, the "control"
		configuration and any variation from this is an experiment.

	  var FramePointerEnabled bool
		FramePointerEnabled enables the use of platform conventions for
		saving frame pointers.
		
		This used to be an experiment, but now it's always enabled on
		platforms that support it.
		
		Note: must agree with runtime.framepointer_enabled.

	  var GO386 string
	  var GO_LDSO string
	  var GOAMD64 int
	  var GOARCH string
	  var GOARM GoarmFeatures
	  var GOARM64 Goarm64Features
	  var GOFIPS140 string
	  var GOMIPS string
	  var GOMIPS64 string
	  var GOOS string
	  var GOPPC64 int
	  var GORISCV64 int
	  var GOROOT string // cached for efficiency
	  var GOWASM gowasmFeatures
	  var ToolTags []string
	  var Version string
Package-Level Constants (total 16, in which 10 are exported)

	const DefaultGO386 = "sse2"
	const DefaultGOAMD64 = "v1"
	const DefaultGOARM = "7"
	const DefaultGOARM64 = "v8.0"
	const DefaultGOEXPERIMENT = ""
		DefaultGOEXPERIMENT is the embedded default GOEXPERIMENT string.
		It is not guaranteed to be canonical.

	const DefaultGOFIPS140 = "off"
	const DefaultGOMIPS = "hardfloat"
	const DefaultGOMIPS64 = "hardfloat"
	const DefaultGOPPC64 = "power8"
	const DefaultGORISCV64 = "rva20u64"
	/* 6 unexporteds ... *//* 6 unexporteds: */
	const defaultGO_EXTLINK_ENABLED = ""
	const defaultGO_LDSO = ""
	const defaultGOARCH string = "amd64"
	const defaultGOEXPERIMENT = ""
	const defaultGOOS string = "linux"
	const version = "go1.24.5"

The pages are generated with Golds v0.7.6. (GOOS=linux GOARCH=amd64)