go/src/cmd/dist
Manlio Perillo 805b4d5636 cmd/dist: wait for exit in bgwait after a fatal error
Currently, when a command scheduled by bgrun fails, bgwait returns to
the caller even in case the fatal error was detected.

In case of a syntax error in one of the standard packages, as an
example, the runInstall function will try to read the generated archive
file, only to fail since the file does not exist.  Since the runInstall
function is called in a goroutine, cmd/dist will continue to report
errors until all background goroutines are done.

Update the bgwait function to wait until program termination in case of
a fatal error, since returning to the caller (with an error, as an
example) will cause cmd/dist to report an additional error during the
next build phase.

Fixes #45410

Change-Id: If89976abad70f8d6ec79b2a5a1f2306e9c034c5a
Reviewed-on: https://go-review.googlesource.com/c/go/+/320311
Run-TryBot: Ian Lance Taylor <iant@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Ian Lance Taylor <iant@golang.org>
Trust: Dmitri Shuralyov <dmitshur@golang.org>
2021-11-09 21:58:03 +00:00
..
README
build.go cmd/dist: implement //go:build parsing 2021-10-28 03:35:04 +00:00
buildgo.go
buildruntime.go cmd/go: add GOAMD64 environment variable 2021-09-16 17:44:44 +00:00
buildtag.go cmd/dist: implement //go:build parsing 2021-10-28 03:35:04 +00:00
buildtool.go cmd: move internal/str back to cmd/go 2021-10-27 16:39:27 +00:00
doc.go
exec.go cmd/dist: consistently set PWD when executing a command in a different directory 2021-09-30 20:30:12 +00:00
imports.go
main.go
sys_default.go all: go fmt std cmd (but revert vendor) 2021-02-20 03:54:50 +00:00
sys_windows.go cmd/dist: add windows/arm64 support 2021-02-19 00:05:03 +00:00
test.go crypto/x509: use the platform verifier on iOS 2021-11-06 00:29:44 +00:00
test_linux.go all: go fmt std cmd (but revert vendor) 2021-02-20 03:54:50 +00:00
util.go cmd/dist: wait for exit in bgwait after a fatal error 2021-11-09 21:58:03 +00:00
util_gc.go all: use more precise build tags 2021-02-23 19:55:03 +00:00
util_gccgo.go all: go fmt std cmd (but revert vendor) 2021-02-20 03:54:50 +00:00
vfp_arm.s all: add //go:build lines to assembly files 2021-05-13 09:12:17 +00:00
vfp_default.s all: add //go:build lines to assembly files 2021-05-13 09:12:17 +00:00

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 ≥ 5, is:

1. Build cmd/dist with Go 1.4.
2. Using dist, build Go 1.x compiler toolchain with Go 1.4.
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.4,
in practice any release ≥ Go 1.4 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.