go/src/cmd/dist
Tobias Klauser ed1cf6ab3e cmd/link/internal/ld, internal/syscall/unix: use posix_fallocate on freebsd
The posix_fallocate system call is available since FreeBSD 9.0, see
https://man.freebsd.org/cgi/man.cgi?query=posix_fallocate

Change-Id: Ie65e0a44341909707617d3b0d9a4f1710c45b935
Reviewed-on: https://go-review.googlesource.com/c/go/+/478035
TryBot-Result: Gopher Robot <gobot@golang.org>
Auto-Submit: Tobias Klauser <tobias.klauser@gmail.com>
Run-TryBot: Tobias Klauser <tobias.klauser@gmail.com>
Reviewed-by: Cherry Mui <cherryyz@google.com>
Reviewed-by: Than McIntosh <thanm@google.com>
2023-03-27 19:14:57 +00:00
..
README
build.go cmd/dist: add openbsd/ppc64 as a known GOOS/GOARCH 2023-03-18 05:49:27 +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
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
exec_119.go
imports.go
main.go cmd/dist: add openbsd/ppc64 as a known GOOS/GOARCH 2023-03-18 05:49:27 +00:00
notgo117.go
quoted.go
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 hash/maphash: add purego implementation 2023-02-28 17:00:47 +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.