go/src/cmd/dist
Ian Lance Taylor 508f445a28 cmd/dist: skip static linking tests for linux boringcrypto
Otherwise we get warnings from the C linker.

Fixes #59422

Change-Id: I61843dbe5245da0185b0f23dc4b774767fffed40
Reviewed-on: https://go-review.googlesource.com/c/go/+/482315
TryBot-Result: Gopher Robot <gobot@golang.org>
Reviewed-by: Ian Lance Taylor <iant@google.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
Run-TryBot: Ian Lance Taylor <iant@golang.org>
Auto-Submit: Ian Lance Taylor <iant@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2023-04-05 00:47:58 +00:00
..
README cmd/dist: update to assume Go 1.17.13 as minimal Go bootstrap version 2022-11-21 17:16:41 +00:00
build.go cmd/dist: mark openbsd-mips64 and openbsd-ppc64 broken 2023-04-04 19:08:36 +00:00
build_test.go cmd/link/internal/ld: move more of mustLinkExternal into internal/platform 2023-03-02 16:34:21 +00:00
buildgo.go cmd/dist: reproducibility fixes 2023-03-13 16:47:12 +00:00
buildruntime.go cmd/dist: use strings.Builder 2022-09-08 14:33:38 +00:00
buildtag.go
buildtag_test.go
buildtool.go cmd/link/internal/ld, internal/syscall/unix: use posix_fallocate on freebsd 2023-03-27 19:14:57 +00:00
doc.go
exec_118.go cmd/dist: add old style build tags 2022-09-17 02:56:44 +00:00
exec_119.go cmd/dist: add old style build tags 2022-09-17 02:56:44 +00:00
imports.go
main.go cmd/dist: add openbsd/ppc64 as a known GOOS/GOARCH 2023-03-18 05:49:27 +00:00
notgo117.go all: use Go 1.17.13 for bootstrap 2022-10-17 19:46:59 +00:00
quoted.go all: add missing copyright header 2022-11-09 14:05:53 +00:00
supported_test.go cmd/dist, internal/platform: test agreement on supported build modes 2023-01-31 16:54:46 +00:00
sys_default.go
sys_windows.go
test.go cmd/dist: skip static linking tests for linux boringcrypto 2023-04-05 00:47:58 +00:00
util.go cmd/dist: default to GOARM=7 on all non-arm systems 2023-02-23 17:50:29 +00:00
util_gc.go
util_gccgo.go
vfp_arm.s
vfp_default.s

README

This program, dist, is the bootstrapping tool for the Go distribution.

As of Go 1.5, dist and other parts of the compiler toolchain are written
in Go, making bootstrapping a little more involved than in the past.
The approach is to build the current release of Go with an earlier one.

The process to install Go 1.x, for x ≥ 20, is:

1. Build cmd/dist with Go 1.17.13.
2. Using dist, build Go 1.x compiler toolchain with Go 1.17.13.
3. Using dist, rebuild Go 1.x compiler toolchain with itself.
4. Using dist, build Go 1.x cmd/go (as go_bootstrap) with Go 1.x compiler toolchain.
5. Using go_bootstrap, build the remaining Go 1.x standard library and commands.

NOTE: During the transition from the old C-based toolchain to the Go-based one,
step 2 also builds the parts of the toolchain written in C, and step 3 does not
recompile those.

Because of backward compatibility, although the steps above say Go 1.17.13,
in practice any release ≥ Go 1.17.13 but < Go 1.x will work as the bootstrap base.

See golang.org/s/go15bootstrap for more details.

Compared to Go 1.4 and earlier, dist will also take over much of what used to
be done by make.bash/make.bat/make.rc and all of what used to be done by
run.bash/run.bat/run.rc, because it is nicer to implement that logic in Go
than in three different scripting languages simultaneously.