#
#	GOOS=linux GOARCH=ppc64 bootstrap.bash
#
# this script cross-compiles a toolchain for that GOOS/GOARCH
# combination, leaving the resulting tree in ../../go-${GOOS}-${GOARCH}-bootstrap.
# That tree can be copied to a machine of the given target type
# and used as $GOROOT_BOOTSTRAP to bootstrap a local build.
#
# Only changes that have been committed to Git (at least locally,
# not necessary reviewed and submitted to master) are included in the tree.

	flag.BoolVar(&DebugV, "v", false, "print debug output")
	flag.Var(objabi.NewDebugFlag(&DebugFlags, nil), "d", "enable debugging settings; try -d help")
	objabi.AddVersionFlag() // -V
	objabi.Flagcount("S", "print assembly and machine code", &PrintOut)
}

// MultiFlag allows setting a value multiple times to collect a list, as in -I=dir1 -I=dir2.
type MultiFlag []string

func (m *MultiFlag) String() string {
	if len(*m) == 0 {
		return ""

pkg crypto/tls, type RecordHeaderError struct, Conn net.Conn
pkg debug/elf, const R_RISCV_32_PCREL = 57
pkg debug/elf, const R_RISCV_32_PCREL R_RISCV
pkg debug/pe, const IMAGE_FILE_MACHINE_ARMNT = 452
pkg debug/pe, const IMAGE_FILE_MACHINE_ARMNT ideal-int
pkg expvar, method (*Map) Delete(string)
pkg go/doc, const PreserveAST = 4
pkg go/doc, const PreserveAST Mode

pkg debug/pe, const IMAGE_FILE_MACHINE_AM33 = 467
pkg debug/pe, const IMAGE_FILE_MACHINE_AMD64 = 34404
pkg debug/pe, const IMAGE_FILE_MACHINE_ARM = 448
pkg debug/pe, const IMAGE_FILE_MACHINE_EBC = 3772
pkg debug/pe, const IMAGE_FILE_MACHINE_I386 = 332
pkg debug/pe, const IMAGE_FILE_MACHINE_IA64 = 512
pkg debug/pe, const IMAGE_FILE_MACHINE_M32R = 36929
pkg debug/pe, const IMAGE_FILE_MACHINE_MIPS16 = 614

pkg debug/elf, const EM_C166 = 116
pkg debug/elf, const EM_C166 Machine
pkg debug/elf, const EM_CDP = 215
pkg debug/elf, const EM_CDP Machine
pkg debug/elf, const EM_CE = 119
pkg debug/elf, const EM_CE Machine
pkg debug/elf, const EM_CLOUDSHIELD = 192
pkg debug/elf, const EM_CLOUDSHIELD Machine
pkg debug/elf, const EM_COGE = 216
pkg debug/elf, const EM_COGE Machine
pkg debug/elf, const EM_COOL = 217
pkg debug/elf, const EM_COOL Machine

pkg debug/pe, const IMAGE_COMDAT_SELECT_SAME_SIZE ideal-int #51868
pkg debug/pe, const IMAGE_FILE_MACHINE_LOONGARCH32 = 25138 #46229
pkg debug/pe, const IMAGE_FILE_MACHINE_LOONGARCH32 ideal-int #46229
pkg debug/pe, const IMAGE_FILE_MACHINE_LOONGARCH64 = 25188 #46229
pkg debug/pe, const IMAGE_FILE_MACHINE_LOONGARCH64 ideal-int #46229
pkg debug/pe, const IMAGE_SCN_CNT_CODE = 32 #51868

			// spurious blank caused by Split on "\n"
			output = output[1:]
			continue
		}
		t.Errorf("unexpected output: %q", output[0])
		output = output[1:]
	}

	// Checked printing.
	// Now check machine code layout.

	top := pList.Firstpc
	var text *obj.LSym
	ok = true
	ctxt.DiagFunc = func(format string, args ...interface{}) {
		t.Errorf(format, args...)
		ok = false
	}

pkg syscall (linux-arm-cgo), type Utsname struct
pkg syscall (linux-arm-cgo), type Utsname struct, Domainname [65]uint8
pkg syscall (linux-arm-cgo), type Utsname struct, Machine [65]uint8
pkg syscall (linux-arm-cgo), type Utsname struct, Nodename [65]uint8
pkg syscall (linux-arm-cgo), type Utsname struct, Release [65]uint8
pkg syscall (linux-arm-cgo), type Utsname struct, Sysname [65]uint8

describes the peculiarities that apply when writing assembly code to interact with Go.
</p>

<p>
The most important thing to know about Go's assembler is that it is not a direct representation of the underlying machine.
Some of the details map precisely to the machine, but some do not.
This is because the compiler suite (see
<a href="https://9p.io/sys/doc/compiler.html">this description</a>)
needs no assembler pass in the usual pipeline.

pkg debug/elf, const EM_MIPS_X Machine
pkg debug/elf, const EM_MMA Machine
pkg debug/elf, const EM_NCPU Machine
pkg debug/elf, const EM_NDR1 Machine
pkg debug/elf, const EM_NONE Machine
pkg debug/elf, const EM_PARISC Machine
pkg debug/elf, const EM_PCP Machine
pkg debug/elf, const EM_PPC Machine
pkg debug/elf, const EM_PPC64 Machine
pkg debug/elf, const EM_RCE Machine
pkg debug/elf, const EM_RH32 Machine