Switch branches/tags
Nothing to show
Find file History
Helflym and tklauser unix: add support for aix/ppc64, gc implementation
This commit ports unix package for aix/ppc64 with gc implementation.

In order to merge as much as possible gc and gccgo implementation, the
mksyscall_aix_ppc64.pl creates three files.

zsyscall_aix_ppc64.go is common for both implementation. It has the main
syscall function and handles the pointer creations, type conversions
and the error if needed. It calls a function "call..." which is
available for each implementation.

zsyscall_aix_ppc64_gc.go is the gc part. It implements "call..."
functions using //go:cgo_import_dynamic and //go:linkname. It is
based on syscall.syscall6 function.

zsyscall_aix_ppc64_gccgo.go is the gccgo part. It implements "call..."
functions using cgo and C functions.

Some unavailable syscalls were also removed from the previous
implementation.

For aix/ppc, the script is left unchanged as aix/ppc won't be
implemented inside gc.

Change-Id: I3701095df31517c66f95874ba8e682967993090b
Reviewed-on: https://go-review.googlesource.com/c/143117
Run-TryBot: Tobias Klauser <tobias.klauser@gmail.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Tobias Klauser <tobias.klauser@gmail.com>
Latest commit 8f1d3d2 Oct 18, 2018
Permalink
..
Failed to load latest commit information.
linux unix: export sizeof consts Oct 4, 2018
.gitignore unix: add unix.test to .gitignore Dec 13, 2017
README.md unix: generate all Linux go files from source Apr 21, 2017
affinity_linux.go unix: fix cpuset size argument in sched_affinity syscall Feb 1, 2018
aliases.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
asm_aix_ppc64.s unix: add support for aix/ppc64, gc implementation Oct 19, 2018
asm_darwin_386.s unix: add gccgo support May 7, 2015
asm_darwin_amd64.s unix: add gccgo support May 7, 2015
asm_darwin_arm.s unix: add darwin/arm support May 18, 2015
asm_darwin_arm64.s unix: add darwin/arm64 support May 18, 2015
asm_dragonfly_amd64.s unix: address vet's finding of wrong argument size May 9, 2018
asm_freebsd_386.s unix: add gccgo support May 7, 2015
asm_freebsd_amd64.s unix: add gccgo support May 7, 2015
asm_freebsd_arm.s unix: add gccgo support May 7, 2015
asm_linux_386.s unix: add SyscallNoError and RawSyscallNoError on Linux Jan 3, 2018
asm_linux_amd64.s unix: add SyscallNoError and RawSyscallNoError on Linux Jan 3, 2018
asm_linux_arm.s unix: match seek argument size to signature on linux/arm Jan 10, 2018
asm_linux_arm64.s unix: fix typo in unix/asm_linux_arm64.s made in 28a7276 Jan 4, 2018
asm_linux_mips64x.s unix: add SyscallNoError and RawSyscallNoError on Linux Jan 3, 2018
asm_linux_mipsx.s unix: add SyscallNoError and RawSyscallNoError on Linux Jan 3, 2018
asm_linux_ppc64x.s unix: add SyscallNoError and RawSyscallNoError on Linux Jan 3, 2018
asm_linux_s390x.s unix: add SyscallNoError and RawSyscallNoError on Linux Jan 3, 2018
asm_netbsd_386.s unix: add gccgo support May 7, 2015
asm_netbsd_amd64.s unix: add gccgo support May 7, 2015
asm_netbsd_arm.s unix: add gccgo support May 7, 2015
asm_openbsd_386.s unix: add gccgo support May 7, 2015
asm_openbsd_amd64.s unix: add gccgo support May 7, 2015
asm_openbsd_arm.s unix: add openbsd/arm support (in theory) Aug 9, 2017
asm_solaris_amd64.s unix: fix vet warnings on solaris May 11, 2017
bluetooth_linux.go syscall: add bluetooth constants for linux Apr 8, 2016
cap_freebsd.go unix: add ErrnoName and SignalName May 4, 2018
constants.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
creds_test.go unix: fix TestSCMCredentials to not fail when root May 11, 2018
dev_aix_ppc.go unix: add Termio, Winsize, Statfs_t, TC[GS]ET, Mkdir and Mknod for AIX Sep 19, 2018
dev_aix_ppc64.go unix: add Termio, Winsize, Statfs_t, TC[GS]ET, Mkdir and Mknod for AIX Sep 19, 2018
dev_darwin.go unix: convert major/minor to uint64 before shifting in Mkdev on Darwi… Sep 12, 2017
dev_dragonfly.go unix: convert major/minor to uint64 before shifting in Mkdev on Darwi… Sep 12, 2017
dev_freebsd.go unix: convert major/minor to uint64 before shifting in Mkdev on Darwi… Sep 12, 2017
dev_linux.go unix: fix potential overflow in Mkdev on Linux Sep 12, 2017
dev_linux_test.go unix: fix or skip failing tests on android and iOS May 24, 2018
dev_netbsd.go unix: convert major/minor to uint64 before shifting in Mkdev on Darwi… Sep 12, 2017
dev_openbsd.go unix: add Major, Minor and Mkdev functions on OpenBSD Sep 12, 2017
dirent.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
endian_big.go unix: add mips and mipsle to endian files Apr 6, 2017
endian_little.go unix: add mips and mipsle to endian files Apr 6, 2017
env_unix.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
errors_freebsd_386.go unix: re-enable Capsicum on FreeBSD 386 Jul 28, 2017
errors_freebsd_amd64.go unix: re-enable Capsicum on FreeBSD 386 Jul 28, 2017
errors_freebsd_arm.go unix: fix freebsd/arm build, fix freebsd/{386,arm} tests Aug 8, 2017
example_test.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
export_test.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
fcntl.go unix: do not return non-nil error for 0 errno in FcntlInt Jun 27, 2018
fcntl_linux_32bit.go unix: add FcntlInt Apr 4, 2018
gccgo.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
gccgo_c.c unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
gccgo_linux_amd64.go all: single space after period Oct 25, 2017
ioctl.go unix: add Termio, Winsize, Statfs_t, TC[GS]ET, Mkdir and Mknod for AIX Sep 19, 2018
mkall.sh unix: add support for aix/ppc64, gc implementation Oct 19, 2018
mkerrors.sh unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
mkpost.go unix: add tpacket types and constants on Linux May 14, 2018
mksyscall.pl unix: use SyscallNoError and RawSyscallNoError on Linux only Jan 30, 2018
mksyscall_aix_ppc.pl unix: add support for aix/ppc64, gc implementation Oct 19, 2018
mksyscall_aix_ppc64.pl unix: add support for aix/ppc64, gc implementation Oct 19, 2018
mksyscall_solaris.pl unix: add marker comments to zsyscall_solaris_amd64.go Oct 11, 2018
mksysctl_openbsd.pl unix: re-add vm.* sysctl strings on openbsd/amd64 Oct 3, 2018
mksysnum_darwin.pl unix: generate all Linux go files from source Apr 21, 2017
mksysnum_dragonfly.pl unix: generate all Linux go files from source Apr 21, 2017
mksysnum_freebsd.pl unix: add NOSTD syscall numbers on FreeBSD Aug 20, 2018
mksysnum_netbsd.pl unix: unify memory functions on BSD Aug 17, 2017
mksysnum_openbsd.pl unix: generate all Linux go files from source Apr 21, 2017
mmap_unix_test.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
openbsd_pledge.go unix: update the OpenBSD pledge interface to handle execpromises Aug 10, 2018
openbsd_test.go unix: update the OpenBSD pledge interface to handle execpromises Aug 10, 2018
pagesize_unix.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
race.go all: single space after period Oct 25, 2017
race0.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
sockcmsg_linux.go all: single space after period Oct 25, 2017
sockcmsg_unix.go unix: export sizeof consts Oct 4, 2018
str.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
syscall.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
syscall_aix.go unix: add support for aix/ppc64, gc implementation Oct 19, 2018
syscall_aix_ppc.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
syscall_aix_ppc64.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
syscall_aix_test.go unix: add support for aix/ppc64, gc implementation Oct 19, 2018
syscall_bsd.go unix: implement RFCOMM sockets on Linux Jul 9, 2018
syscall_bsd_test.go unix: add MNT_* flags on OpenBSD Sep 25, 2018
syscall_darwin.go unix: add F*xattr on Darwin Aug 8, 2018
syscall_darwin_386.go all: single space after period Oct 25, 2017
syscall_darwin_amd64.go all: single space after period Oct 25, 2017
syscall_darwin_arm.go unix: add SYS___SYSCTL on darwin/arm Nov 21, 2017
syscall_darwin_arm64.go all: single space after period Oct 25, 2017
syscall_darwin_test.go unix: add tests for *xattr functions May 22, 2018
syscall_dragonfly.go unix: document IoctlSetWinsize and IoctlSetTermios and fix pointer li… Jul 24, 2018
syscall_dragonfly_amd64.go unix: unify NsecToTime{spec,val}, fix for times < 1970 Oct 25, 2017
syscall_freebsd.go unix: use pipe2 syscall on FreeBSD instead of pipe Aug 23, 2018
syscall_freebsd_386.go unix: unify NsecToTime{spec,val}, fix for times < 1970 Oct 25, 2017
syscall_freebsd_amd64.go unix: unify NsecToTime{spec,val}, fix for times < 1970 Oct 25, 2017
syscall_freebsd_arm.go unix: unify NsecToTime{spec,val}, fix for times < 1970 Oct 25, 2017
syscall_freebsd_test.go unix: add tests for *xattr functions May 22, 2018
syscall_linux.go unix: export sizeof consts Oct 4, 2018
syscall_linux_386.go unix: don't use deprecated syscalls on linux/arm64 Jun 19, 2018
syscall_linux_amd64.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
syscall_linux_amd64_gc.go x/sys/unix: move gccgo redeclared functions to separate files Dec 14, 2016
syscall_linux_arm.go Revert "unix: implement SyncFileRange for ARM" Sep 3, 2018
syscall_linux_arm64.go unix: don't use deprecated syscalls on linux/arm64 Jun 19, 2018
syscall_linux_gc.go unix: move gccgo redeclared *SyscallNoError functions to a separate file Feb 2, 2018
syscall_linux_gc_386.go unix: support compiling with gccgo on linux/386 Jun 11, 2018
syscall_linux_gccgo_386.go unix: support compiling with gccgo on linux/386 Jun 11, 2018
syscall_linux_gccgo_arm.go unix: support compiling with gccgo on linux/386 Jun 11, 2018
syscall_linux_mips64x.go unix: don't use deprecated syscalls on linux/arm64 Jun 19, 2018
syscall_linux_mipsx.go unix: implement pipe() on linux/mips Jul 27, 2018
syscall_linux_ppc64x.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
syscall_linux_riscv64.go unix: add support for linux/riscv64 Sep 6, 2018
syscall_linux_s390x.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
syscall_linux_sparc64.go unix: don't use deprecated syscalls on linux/arm64 Jun 19, 2018
syscall_linux_test.go unix: fix TestSchedSetaffinity for smt settings Sep 26, 2018
syscall_netbsd.go unix: use correctly aligned result buffer in SysctlClockinfo Oct 3, 2018
syscall_netbsd_386.go unix: unify NsecToTime{spec,val}, fix for times < 1970 Oct 25, 2017
syscall_netbsd_amd64.go unix: unify NsecToTime{spec,val}, fix for times < 1970 Oct 25, 2017
syscall_netbsd_arm.go unix: unify NsecToTime{spec,val}, fix for times < 1970 Oct 25, 2017
syscall_netbsd_test.go unix: add SysctlClockinfo on NetBSD Sep 27, 2018
syscall_openbsd.go unix: add SysctlUvmexp on OpenBSD Oct 3, 2018
syscall_openbsd_386.go unix: unify NsecToTime{spec,val}, fix for times < 1970 Oct 25, 2017
syscall_openbsd_amd64.go unix: update openbsd/amd64 to OpenBSD 6.3 May 22, 2018
syscall_openbsd_arm.go unix: unify NsecToTime{spec,val}, fix for times < 1970 Oct 25, 2017
syscall_openbsd_test.go unix: add SysctlUvmexp on OpenBSD Oct 3, 2018
syscall_solaris.go unix: document IoctlSetWinsize and IoctlSetTermios and fix pointer li… Jul 24, 2018
syscall_solaris_amd64.go unix: add sendfile support on Solaris Mar 29, 2018
syscall_solaris_test.go unix: add Select on Solaris Dec 22, 2017
syscall_test.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
syscall_unix.go unix: export sizeof consts Oct 4, 2018
syscall_unix_gc.go x/sys/unix: move gccgo redeclared functions to separate files Dec 14, 2016
syscall_unix_test.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
timestruct.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
timestruct_test.go unix: code for AIX ppc and ppc64, for gccgo Aug 28, 2018
types_aix.go unix: export sizeof consts Oct 4, 2018
types_darwin.go unix: export sizeof consts Oct 4, 2018
types_dragonfly.go unix: export sizeof consts Oct 4, 2018
types_freebsd.go unix: export sizeof consts Oct 4, 2018
types_netbsd.go unix: export sizeof consts Oct 4, 2018
types_openbsd.go unix: export sizeof consts Oct 4, 2018
types_solaris.go unix: export sizeof consts Oct 4, 2018
xattr_bsd.go unix: add *xattr functions on NetBSD Aug 10, 2018
xattr_test.go unix: add *xattr functions on NetBSD Aug 10, 2018
zerrors_aix_ppc.go unix: add Termio, Winsize, Statfs_t, TC[GS]ET, Mkdir and Mknod for AIX Sep 19, 2018
zerrors_aix_ppc64.go unix: add Termio, Winsize, Statfs_t, TC[GS]ET, Mkdir and Mknod for AIX Sep 19, 2018
zerrors_darwin_386.go unix: add symlink-safe *xattr functions on darwin May 23, 2018
zerrors_darwin_amd64.go unix: add symlink-safe *xattr functions on darwin May 23, 2018
zerrors_darwin_arm.go unix: add symlink-safe *xattr functions on darwin May 23, 2018
zerrors_darwin_arm64.go unix: add symlink-safe *xattr functions on darwin May 23, 2018
zerrors_dragonfly_amd64.go unix: add MNT_* flags on DragonflyBSD Sep 24, 2018
zerrors_freebsd_386.go unix: add additional file mode bit constants from sys/stat.h on FreeBSD Aug 16, 2018
zerrors_freebsd_amd64.go unix: add additional file mode bit constants from sys/stat.h on FreeBSD Aug 16, 2018
zerrors_freebsd_arm.go unix: add additional file mode bit constants from sys/stat.h on FreeBSD Aug 16, 2018
zerrors_linux_386.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zerrors_linux_amd64.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zerrors_linux_arm.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zerrors_linux_arm64.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zerrors_linux_mips.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zerrors_linux_mips64.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zerrors_linux_mips64le.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zerrors_linux_mipsle.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zerrors_linux_ppc64.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zerrors_linux_ppc64le.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zerrors_linux_riscv64.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zerrors_linux_s390x.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zerrors_linux_sparc64.go unix: convert errorList and signalList to new format for linux/sparc64 Oct 5, 2018
zerrors_netbsd_386.go unix: add additional rlimit resource constants on NetBSD Sep 26, 2018
zerrors_netbsd_amd64.go unix: add additional rlimit resource constants on NetBSD Sep 26, 2018
zerrors_netbsd_arm.go unix: add additional rlimit resource constants on NetBSD Sep 26, 2018
zerrors_openbsd_386.go unix: add MNT_* flags on OpenBSD Sep 25, 2018
zerrors_openbsd_amd64.go unix: add SysctlUvmexp on OpenBSD Oct 3, 2018
zerrors_openbsd_arm.go unix: add MNT_* flags on OpenBSD Sep 25, 2018
zerrors_solaris_amd64.go unix: add additional file mode bit constants from sys/stat.h on Solaris Aug 21, 2018
zptrace386_linux.go unix: single space after period in generated zptrace header Oct 27, 2017
zptracearm_linux.go unix: single space after period in generated zptrace header Oct 27, 2017
zptracemips_linux.go unix: single space after period in generated zptrace header Oct 27, 2017
zptracemipsle_linux.go unix: single space after period in generated zptrace header Oct 27, 2017
zsyscall_aix_ppc.go unix: add support for aix/ppc64, gc implementation Oct 19, 2018
zsyscall_aix_ppc64.go unix: add support for aix/ppc64, gc implementation Oct 19, 2018
zsyscall_aix_ppc64_gc.go unix: add support for aix/ppc64, gc implementation Oct 19, 2018
zsyscall_aix_ppc64_gccgo.go unix: add support for aix/ppc64, gc implementation Oct 19, 2018
zsyscall_darwin_386.go unix: add F*xattr on Darwin Aug 8, 2018
zsyscall_darwin_amd64.go unix: add F*xattr on Darwin Aug 8, 2018
zsyscall_darwin_arm.go unix: add F*xattr on Darwin Aug 8, 2018
zsyscall_darwin_arm64.go unix: add F*xattr on Darwin Aug 8, 2018
zsyscall_dragonfly_amd64.go unix: add Fchmodat on DragonflyBSD Mar 20, 2018
zsyscall_freebsd_386.go unix: use pipe2 syscall on FreeBSD instead of pipe Aug 23, 2018
zsyscall_freebsd_amd64.go unix: use pipe2 syscall on FreeBSD instead of pipe Aug 23, 2018
zsyscall_freebsd_arm.go unix: use pipe2 syscall on FreeBSD instead of pipe Aug 23, 2018
zsyscall_linux_386.go unix: add ClockGetres on Linux Sep 27, 2018
zsyscall_linux_amd64.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zsyscall_linux_arm.go unix: add ClockGetres on Linux Sep 27, 2018
zsyscall_linux_arm64.go unix: add ClockGetres on Linux Sep 27, 2018
zsyscall_linux_mips.go unix: add ClockGetres on Linux Sep 27, 2018
zsyscall_linux_mips64.go unix: add ClockGetres on Linux Sep 27, 2018
zsyscall_linux_mips64le.go unix: add ClockGetres on Linux Sep 27, 2018
zsyscall_linux_mipsle.go unix: add ClockGetres on Linux Sep 27, 2018
zsyscall_linux_ppc64.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zsyscall_linux_ppc64le.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zsyscall_linux_riscv64.go unix: add ClockGetres on Linux Sep 27, 2018
zsyscall_linux_s390x.go unix: add KexecFileLoad on linux/{amd64,ppc64x,s390x} Oct 5, 2018
zsyscall_linux_sparc64.go unix: don't use deprecated syscalls on linux/arm64 Jun 19, 2018
zsyscall_netbsd_386.go unix: add *xattr functions on NetBSD Aug 10, 2018
zsyscall_netbsd_amd64.go unix: add *xattr functions on NetBSD Aug 10, 2018
zsyscall_netbsd_arm.go unix: add *xattr functions on NetBSD Aug 10, 2018
zsyscall_openbsd_386.go unix: add Faccessat on OpenBSD Jun 13, 2018
zsyscall_openbsd_amd64.go unix: add Faccessat on OpenBSD Jun 13, 2018
zsyscall_openbsd_arm.go unix: add Faccessat on OpenBSD Jun 13, 2018
zsyscall_solaris_amd64.go unix: add marker comments to zsyscall_solaris_amd64.go Oct 11, 2018
zsysctl_openbsd_386.go unix: follow convention for generated code comment Jun 14, 2018
zsysctl_openbsd_amd64.go unix: re-add vm.* sysctl strings on openbsd/amd64 Oct 3, 2018
zsysctl_openbsd_arm.go unix: follow convention for generated code comment Jun 14, 2018
zsysnum_darwin_386.go unix: regenerate for macOS 10.13/iOS 11.1 Nov 6, 2017
zsysnum_darwin_amd64.go unix: regenerate for macOS 10.13/iOS 11.1 Nov 6, 2017
zsysnum_darwin_arm.go unix: regenerate for macOS 10.13/iOS 11.1 Nov 6, 2017
zsysnum_darwin_arm64.go unix: regenerate for macOS 10.13/iOS 11.1 Nov 6, 2017
zsysnum_dragonfly_amd64.go unix: sync with DragonFly BSD 4.8 kernel Apr 27, 2017
zsysnum_freebsd_386.go unix: add NOSTD syscall numbers on FreeBSD Aug 20, 2018
zsysnum_freebsd_amd64.go unix: add NOSTD syscall numbers on FreeBSD Aug 20, 2018
zsysnum_freebsd_arm.go unix: add NOSTD syscall numbers on FreeBSD Aug 20, 2018
zsysnum_linux_386.go unix: update Dockerfile to Linux 4.18, glibc 2.28 and Go 1.11beta3 Aug 14, 2018
zsysnum_linux_amd64.go unix: update Dockerfile to Linux 4.18, glibc 2.28 and Go 1.11beta3 Aug 14, 2018
zsysnum_linux_arm.go unix: update Dockerfile to Linux 4.18, glibc 2.28 and Go 1.11beta3 Aug 14, 2018
zsysnum_linux_arm64.go unix: update Dockerfile to Linux 4.18, glibc 2.28 and Go 1.11beta3 Aug 14, 2018
zsysnum_linux_mips.go unix: update Dockerfile to Linux 4.18, glibc 2.28 and Go 1.11beta3 Aug 14, 2018
zsysnum_linux_mips64.go unix: update Dockerfile to Linux 4.18, glibc 2.28 and Go 1.11beta3 Aug 14, 2018
zsysnum_linux_mips64le.go unix: update Dockerfile to Linux 4.18, glibc 2.28 and Go 1.11beta3 Aug 14, 2018
zsysnum_linux_mipsle.go unix: update Dockerfile to Linux 4.18, glibc 2.28 and Go 1.11beta3 Aug 14, 2018
zsysnum_linux_ppc64.go unix: update Dockerfile to Linux 4.18, glibc 2.28 and Go 1.11beta3 Aug 14, 2018
zsysnum_linux_ppc64le.go unix: update Dockerfile to Linux 4.18, glibc 2.28 and Go 1.11beta3 Aug 14, 2018
zsysnum_linux_riscv64.go unix: add support for linux/riscv64 Sep 6, 2018
zsysnum_linux_s390x.go unix: update Dockerfile to Linux 4.18, glibc 2.28 and Go 1.11beta3 Aug 14, 2018
zsysnum_linux_sparc64.go unix: follow convention for generated code comment Jun 14, 2018
zsysnum_netbsd_386.go unix: follow convention for generated code comment Jun 14, 2018
zsysnum_netbsd_amd64.go unix: follow convention for generated code comment Jun 14, 2018
zsysnum_netbsd_arm.go unix: follow convention for generated code comment Jun 14, 2018
zsysnum_openbsd_386.go unix: follow convention for generated code comment Jun 14, 2018
zsysnum_openbsd_amd64.go unix: fix OpenBSD codegen to include F_OK Aug 6, 2018
zsysnum_openbsd_arm.go unix: follow convention for generated code comment Jun 14, 2018
ztypes_aix_ppc.go unix: export sizeof consts Oct 4, 2018
ztypes_aix_ppc64.go unix: export sizeof consts Oct 4, 2018
ztypes_darwin_386.go unix: export sizeof consts Oct 4, 2018
ztypes_darwin_amd64.go unix: export sizeof consts Oct 4, 2018
ztypes_darwin_arm.go unix: export sizeof consts Oct 4, 2018
ztypes_darwin_arm64.go unix: export sizeof consts Oct 4, 2018
ztypes_dragonfly_amd64.go unix: export sizeof consts Oct 4, 2018
ztypes_freebsd_386.go unix: export sizeof consts Oct 4, 2018
ztypes_freebsd_amd64.go unix: export sizeof consts Oct 4, 2018
ztypes_freebsd_arm.go unix: export sizeof consts Oct 4, 2018
ztypes_linux_386.go unix: export sizeof consts Oct 4, 2018
ztypes_linux_amd64.go unix: export sizeof consts Oct 4, 2018
ztypes_linux_arm.go unix: export sizeof consts Oct 4, 2018
ztypes_linux_arm64.go unix: export sizeof consts Oct 4, 2018
ztypes_linux_mips.go unix: export sizeof consts Oct 4, 2018
ztypes_linux_mips64.go unix: export sizeof consts Oct 4, 2018
ztypes_linux_mips64le.go unix: export sizeof consts Oct 4, 2018
ztypes_linux_mipsle.go unix: export sizeof consts Oct 4, 2018
ztypes_linux_ppc64.go unix: export sizeof consts Oct 4, 2018
ztypes_linux_ppc64le.go unix: export sizeof consts Oct 4, 2018
ztypes_linux_riscv64.go unix: export sizeof consts Oct 4, 2018
ztypes_linux_s390x.go unix: export sizeof consts Oct 4, 2018
ztypes_linux_sparc64.go unix: export sizeof consts Oct 4, 2018
ztypes_netbsd_386.go unix: export sizeof consts Oct 4, 2018
ztypes_netbsd_amd64.go unix: export sizeof consts Oct 4, 2018
ztypes_netbsd_arm.go unix: export sizeof consts Oct 4, 2018
ztypes_openbsd_386.go unix: export sizeof consts Oct 4, 2018
ztypes_openbsd_amd64.go unix: export sizeof consts Oct 4, 2018
ztypes_openbsd_arm.go unix: export sizeof consts Oct 4, 2018
ztypes_solaris_amd64.go unix: export sizeof consts Oct 4, 2018

README.md

Building sys/unix

The sys/unix package provides access to the raw system call interface of the underlying operating system. See: https://godoc.org/golang.org/x/sys/unix

Porting Go to a new architecture/OS combination or adding syscalls, types, or constants to an existing architecture/OS pair requires some manual effort; however, there are tools that automate much of the process.

Build Systems

There are currently two ways we generate the necessary files. We are currently migrating the build system to use containers so the builds are reproducible. This is being done on an OS-by-OS basis. Please update this documentation as components of the build system change.

Old Build System (currently for GOOS != "Linux" || GOARCH == "sparc64")

The old build system generates the Go files based on the C header files present on your system. This means that files for a given GOOS/GOARCH pair must be generated on a system with that OS and architecture. This also means that the generated code can differ from system to system, based on differences in the header files.

To avoid this, if you are using the old build system, only generate the Go files on an installation with unmodified header files. It is also important to keep track of which version of the OS the files were generated from (ex. Darwin 14 vs Darwin 15). This makes it easier to track the progress of changes and have each OS upgrade correspond to a single change.

To build the files for your current OS and architecture, make sure GOOS and GOARCH are set correctly and run mkall.sh. This will generate the files for your specific system. Running mkall.sh -n shows the commands that will be run.

Requirements: bash, perl, go

New Build System (currently for GOOS == "Linux" && GOARCH != "sparc64")

The new build system uses a Docker container to generate the go files directly from source checkouts of the kernel and various system libraries. This means that on any platform that supports Docker, all the files using the new build system can be generated at once, and generated files will not change based on what the person running the scripts has installed on their computer.

The OS specific files for the new build system are located in the ${GOOS} directory, and the build is coordinated by the ${GOOS}/mkall.go program. When the kernel or system library updates, modify the Dockerfile at ${GOOS}/Dockerfile to checkout the new release of the source.

To build all the files under the new build system, you must be on an amd64/Linux system and have your GOOS and GOARCH set accordingly. Running mkall.sh will then generate all of the files for all of the GOOS/GOARCH pairs in the new build system. Running mkall.sh -n shows the commands that will be run.

Requirements: bash, perl, go, docker

Component files

This section describes the various files used in the code generation process. It also contains instructions on how to modify these files to add a new architecture/OS or to add additional syscalls, types, or constants. Note that if you are using the new build system, the scripts cannot be called normally. They must be called from within the docker container.

asm files

The hand-written assembly file at asm_${GOOS}_${GOARCH}.s implements system call dispatch. There are three entry points:

  func Syscall(trap, a1, a2, a3 uintptr) (r1, r2, err uintptr)
  func Syscall6(trap, a1, a2, a3, a4, a5, a6 uintptr) (r1, r2, err uintptr)
  func RawSyscall(trap, a1, a2, a3 uintptr) (r1, r2, err uintptr)

The first and second are the standard ones; they differ only in how many arguments can be passed to the kernel. The third is for low-level use by the ForkExec wrapper. Unlike the first two, it does not call into the scheduler to let it know that a system call is running.

When porting Go to an new architecture/OS, this file must be implemented for each GOOS/GOARCH pair.

mksysnum

Mksysnum is a script located at ${GOOS}/mksysnum.pl (or mksysnum_${GOOS}.pl for the old system). This script takes in a list of header files containing the syscall number declarations and parses them to produce the corresponding list of Go numeric constants. See zsysnum_${GOOS}_${GOARCH}.go for the generated constants.

Adding new syscall numbers is mostly done by running the build on a sufficiently new installation of the target OS (or updating the source checkouts for the new build system). However, depending on the OS, you make need to update the parsing in mksysnum.

mksyscall.pl

The syscall.go, syscall_${GOOS}.go, syscall_${GOOS}_${GOARCH}.go are hand-written Go files which implement system calls (for unix, the specific OS, or the specific OS/Architecture pair respectively) that need special handling and list //sys comments giving prototypes for ones that can be generated.

The mksyscall.pl script takes the //sys and //sysnb comments and converts them into syscalls. This requires the name of the prototype in the comment to match a syscall number in the zsysnum_${GOOS}_${GOARCH}.go file. The function prototype can be exported (capitalized) or not.

Adding a new syscall often just requires adding a new //sys function prototype with the desired arguments and a capitalized name so it is exported. However, if you want the interface to the syscall to be different, often one will make an unexported //sys prototype, an then write a custom wrapper in syscall_${GOOS}.go.

types files

For each OS, there is a hand-written Go file at ${GOOS}/types.go (or types_${GOOS}.go on the old system). This file includes standard C headers and creates Go type aliases to the corresponding C types. The file is then fed through godef to get the Go compatible definitions. Finally, the generated code is fed though mkpost.go to format the code correctly and remove any hidden or private identifiers. This cleaned-up code is written to ztypes_${GOOS}_${GOARCH}.go.

The hardest part about preparing this file is figuring out which headers to include and which symbols need to be #defined to get the actual data structures that pass through to the kernel system calls. Some C libraries preset alternate versions for binary compatibility and translate them on the way in and out of system calls, but there is almost always a #define that can get the real ones. See types_darwin.go and linux/types.go for examples.

To add a new type, add in the necessary include statement at the top of the file (if it is not already there) and add in a type alias line. Note that if your type is significantly different on different architectures, you may need some #if/#elif macros in your include statements.

mkerrors.sh

This script is used to generate the system's various constants. This doesn't just include the error numbers and error strings, but also the signal numbers an a wide variety of miscellaneous constants. The constants come from the list of include files in the includes_${uname} variable. A regex then picks out the desired #define statements, and generates the corresponding Go constants. The error numbers and strings are generated from #include <errno.h>, and the signal numbers and strings are generated from #include <signal.h>. All of these constants are written to zerrors_${GOOS}_${GOARCH}.go via a C program, _errors.c, which prints out all the constants.

To add a constant, add the header that includes it to the appropriate variable. Then, edit the regex (if necessary) to match the desired constant. Avoid making the regex too broad to avoid matching unintended constants.

Generated files

zerror_${GOOS}_${GOARCH}.go

A file containing all of the system's generated error numbers, error strings, signal numbers, and constants. Generated by mkerrors.sh (see above).

zsyscall_${GOOS}_${GOARCH}.go

A file containing all the generated syscalls for a specific GOOS and GOARCH. Generated by mksyscall.pl (see above).

zsysnum_${GOOS}_${GOARCH}.go

A list of numeric constants for all the syscall number of the specific GOOS and GOARCH. Generated by mksysnum (see above).

ztypes_${GOOS}_${GOARCH}.go

A file containing Go types for passing into (or returning from) syscalls. Generated by godefs and the types file (see above).