Tree @debian/0.0_git20190412.9773273-1 (Download .tar.gz)
- ..
- linux
- .gitignore
- affinity_linux.go
- aliases.go
- asm_aix_ppc64.s
- asm_darwin_386.s
- asm_darwin_amd64.s
- asm_darwin_arm.s
- asm_darwin_arm64.s
- asm_dragonfly_amd64.s
- asm_freebsd_386.s
- asm_freebsd_amd64.s
- asm_freebsd_arm.s
- asm_freebsd_arm64.s
- asm_linux_386.s
- asm_linux_amd64.s
- asm_linux_arm.s
- asm_linux_arm64.s
- asm_linux_mips64x.s
- asm_linux_mipsx.s
- asm_linux_ppc64x.s
- asm_linux_s390x.s
- asm_netbsd_386.s
- asm_netbsd_amd64.s
- asm_netbsd_arm.s
- asm_netbsd_arm64.s
- asm_openbsd_386.s
- asm_openbsd_amd64.s
- asm_openbsd_arm.s
- asm_solaris_amd64.s
- bluetooth_linux.go
- cap_freebsd.go
- constants.go
- creds_test.go
- darwin_test.go
- dev_aix_ppc.go
- dev_aix_ppc64.go
- dev_darwin.go
- dev_dragonfly.go
- dev_freebsd.go
- dev_linux.go
- dev_linux_test.go
- dev_netbsd.go
- dev_openbsd.go
- dirent.go
- endian_big.go
- endian_little.go
- env_unix.go
- errors_freebsd_386.go
- errors_freebsd_amd64.go
- errors_freebsd_arm.go
- example_exec_test.go
- example_flock_test.go
- export_test.go
- fcntl.go
- fcntl_darwin.go
- fcntl_linux_32bit.go
- gccgo.go
- gccgo_c.c
- gccgo_linux_amd64.go
- ioctl.go
- mkall.sh
- mkasm_darwin.go
- mkerrors.sh
- mkpost.go
- mksyscall.go
- mksyscall_aix_ppc.go
- mksyscall_aix_ppc64.go
- mksyscall_solaris.go
- mksysctl_openbsd.pl
- mksysnum.go
- mmap_unix_test.go
- openbsd_pledge.go
- openbsd_test.go
- openbsd_unveil.go
- pagesize_unix.go
- race.go
- race0.go
- README.md
- sendfile_test.go
- sockcmsg_linux.go
- sockcmsg_unix.go
- str.go
- syscall.go
- syscall_aix.go
- syscall_aix_ppc.go
- syscall_aix_ppc64.go
- syscall_aix_test.go
- syscall_bsd.go
- syscall_bsd_test.go
- syscall_darwin.go
- syscall_darwin_386.go
- syscall_darwin_amd64.go
- syscall_darwin_arm.go
- syscall_darwin_arm64.go
- syscall_darwin_libSystem.go
- syscall_darwin_test.go
- syscall_dragonfly.go
- syscall_dragonfly_amd64.go
- syscall_freebsd.go
- syscall_freebsd_386.go
- syscall_freebsd_amd64.go
- syscall_freebsd_arm.go
- syscall_freebsd_arm64.go
- syscall_freebsd_test.go
- syscall_linux.go
- syscall_linux_386.go
- syscall_linux_amd64.go
- syscall_linux_amd64_gc.go
- syscall_linux_arm.go
- syscall_linux_arm64.go
- syscall_linux_gc.go
- syscall_linux_gc_386.go
- syscall_linux_gccgo_386.go
- syscall_linux_gccgo_arm.go
- syscall_linux_mips64x.go
- syscall_linux_mipsx.go
- syscall_linux_ppc64x.go
- syscall_linux_riscv64.go
- syscall_linux_s390x.go
- syscall_linux_sparc64.go
- syscall_linux_test.go
- syscall_netbsd.go
- syscall_netbsd_386.go
- syscall_netbsd_amd64.go
- syscall_netbsd_arm.go
- syscall_netbsd_arm64.go
- syscall_netbsd_test.go
- syscall_openbsd.go
- syscall_openbsd_386.go
- syscall_openbsd_amd64.go
- syscall_openbsd_arm.go
- syscall_openbsd_test.go
- syscall_solaris.go
- syscall_solaris_amd64.go
- syscall_solaris_test.go
- syscall_test.go
- syscall_unix.go
- syscall_unix_gc.go
- syscall_unix_gc_ppc64x.go
- syscall_unix_test.go
- timestruct.go
- timestruct_test.go
- types_aix.go
- types_darwin.go
- types_dragonfly.go
- types_freebsd.go
- types_netbsd.go
- types_openbsd.go
- types_solaris.go
- xattr_bsd.go
- xattr_test.go
- zerrors_aix_ppc.go
- zerrors_aix_ppc64.go
- zerrors_darwin_386.go
- zerrors_darwin_amd64.go
- zerrors_darwin_arm.go
- zerrors_darwin_arm64.go
- zerrors_dragonfly_amd64.go
- zerrors_freebsd_386.go
- zerrors_freebsd_amd64.go
- zerrors_freebsd_arm.go
- zerrors_freebsd_arm64.go
- zerrors_linux_386.go
- zerrors_linux_amd64.go
- zerrors_linux_arm.go
- zerrors_linux_arm64.go
- zerrors_linux_mips.go
- zerrors_linux_mips64.go
- zerrors_linux_mips64le.go
- zerrors_linux_mipsle.go
- zerrors_linux_ppc64.go
- zerrors_linux_ppc64le.go
- zerrors_linux_riscv64.go
- zerrors_linux_s390x.go
- zerrors_linux_sparc64.go
- zerrors_netbsd_386.go
- zerrors_netbsd_amd64.go
- zerrors_netbsd_arm.go
- zerrors_netbsd_arm64.go
- zerrors_openbsd_386.go
- zerrors_openbsd_amd64.go
- zerrors_openbsd_arm.go
- zerrors_solaris_amd64.go
- zptrace386_linux.go
- zptracearm_linux.go
- zptracemips_linux.go
- zptracemipsle_linux.go
- zsyscall_aix_ppc.go
- zsyscall_aix_ppc64.go
- zsyscall_aix_ppc64_gc.go
- zsyscall_aix_ppc64_gccgo.go
- zsyscall_darwin_386.1_11.go
- zsyscall_darwin_386.go
- zsyscall_darwin_386.s
- zsyscall_darwin_amd64.1_11.go
- zsyscall_darwin_amd64.go
- zsyscall_darwin_amd64.s
- zsyscall_darwin_arm.1_11.go
- zsyscall_darwin_arm.go
- zsyscall_darwin_arm.s
- zsyscall_darwin_arm64.1_11.go
- zsyscall_darwin_arm64.go
- zsyscall_darwin_arm64.s
- zsyscall_dragonfly_amd64.go
- zsyscall_freebsd_386.go
- zsyscall_freebsd_amd64.go
- zsyscall_freebsd_arm.go
- zsyscall_freebsd_arm64.go
- zsyscall_linux_386.go
- zsyscall_linux_amd64.go
- zsyscall_linux_arm.go
- zsyscall_linux_arm64.go
- zsyscall_linux_mips.go
- zsyscall_linux_mips64.go
- zsyscall_linux_mips64le.go
- zsyscall_linux_mipsle.go
- zsyscall_linux_ppc64.go
- zsyscall_linux_ppc64le.go
- zsyscall_linux_riscv64.go
- zsyscall_linux_s390x.go
- zsyscall_linux_sparc64.go
- zsyscall_netbsd_386.go
- zsyscall_netbsd_amd64.go
- zsyscall_netbsd_arm.go
- zsyscall_netbsd_arm64.go
- zsyscall_openbsd_386.go
- zsyscall_openbsd_amd64.go
- zsyscall_openbsd_arm.go
- zsyscall_solaris_amd64.go
- zsysctl_openbsd_386.go
- zsysctl_openbsd_amd64.go
- zsysctl_openbsd_arm.go
- zsysnum_darwin_386.go
- zsysnum_darwin_amd64.go
- zsysnum_darwin_arm.go
- zsysnum_darwin_arm64.go
- zsysnum_dragonfly_amd64.go
- zsysnum_freebsd_386.go
- zsysnum_freebsd_amd64.go
- zsysnum_freebsd_arm.go
- zsysnum_freebsd_arm64.go
- zsysnum_linux_386.go
- zsysnum_linux_amd64.go
- zsysnum_linux_arm.go
- zsysnum_linux_arm64.go
- zsysnum_linux_mips.go
- zsysnum_linux_mips64.go
- zsysnum_linux_mips64le.go
- zsysnum_linux_mipsle.go
- zsysnum_linux_ppc64.go
- zsysnum_linux_ppc64le.go
- zsysnum_linux_riscv64.go
- zsysnum_linux_s390x.go
- zsysnum_linux_sparc64.go
- zsysnum_netbsd_386.go
- zsysnum_netbsd_amd64.go
- zsysnum_netbsd_arm.go
- zsysnum_netbsd_arm64.go
- zsysnum_openbsd_386.go
- zsysnum_openbsd_amd64.go
- zsysnum_openbsd_arm.go
- ztypes_aix_ppc.go
- ztypes_aix_ppc64.go
- ztypes_darwin_386.go
- ztypes_darwin_amd64.go
- ztypes_darwin_arm.go
- ztypes_darwin_arm64.go
- ztypes_dragonfly_amd64.go
- ztypes_freebsd_386.go
- ztypes_freebsd_amd64.go
- ztypes_freebsd_arm.go
- ztypes_freebsd_arm64.go
- ztypes_linux_386.go
- ztypes_linux_amd64.go
- ztypes_linux_arm.go
- ztypes_linux_arm64.go
- ztypes_linux_mips.go
- ztypes_linux_mips64.go
- ztypes_linux_mips64le.go
- ztypes_linux_mipsle.go
- ztypes_linux_ppc64.go
- ztypes_linux_ppc64le.go
- ztypes_linux_riscv64.go
- ztypes_linux_s390x.go
- ztypes_linux_sparc64.go
- ztypes_netbsd_386.go
- ztypes_netbsd_amd64.go
- ztypes_netbsd_arm.go
- ztypes_netbsd_arm64.go
- ztypes_openbsd_386.go
- ztypes_openbsd_amd64.go
- ztypes_openbsd_arm.go
- ztypes_solaris_amd64.go
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 | # 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"`) 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, go ### New Build System (currently for `GOOS == "linux"`) 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, 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/programs 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 Go program located at `${GOOS}/mksysnum.go` (or `mksysnum_${GOOS}.go` for the old system). This program 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.go 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.go program 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 `#define`d 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.go` (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). |
History of unix @debian/0.0_git20190412.9773273-1
- New upstream version 0.0~git20190412.9773273 Anthony Fok 5 years ago
- New upstream version 0.0~git20181228.9a3f9b0 Anthony Fok 5 years ago
- New upstream version 0.0~git20181220.97b4c2a Anthony Fok 5 years ago
- New upstream version 0.0~git20181026.95b1ffb Felix Lechner 5 years ago
- New upstream version 0.0~git20180510.7dfd129 Anthony Fok 6 years ago
- New upstream version 0.0~git20180308.349b81f Anthony Fok 6 years ago
- New upstream version 0.0~git20180224.f6cff07 Anthony Fok 6 years ago
- New upstream version 0.0~git20180126.0.ff2a66f Felix Lechner 6 years ago
- New upstream version 0.0~git20170727.0.35ef448 Anthony Fok 6 years ago
- New upstream version 0.0~git20170630.0.4ed4d40 Anthony Fok 6 years ago
- New upstream version 0.0~git20161122.0.30237cf Martín Ferrari 7 years ago
- New upstream version 0.0~git20161017.0.002cbb5 Martín Ferrari 7 years ago
- New upstream version 0.0~git20161012.0.9bb9f09 Anthony Fok 7 years ago
- Imported Upstream version 0.0~git20160704.0.a408501 Martín Ferrari 7 years ago
- Imported Upstream version 0.0~git20160611.0.7f918dd Anthony Fok 7 years ago
- Imported Upstream version 0.0~git20160517.0.d4feaf1 Michael Hudson-Doyle 8 years ago
- Imported Upstream version 0.0~git20160421.0.b776ec3 Martín Ferrari 8 years ago
- Imported Upstream version 0.0~git20160415.0.f64b50f Anthony Fok 8 years ago
- Imported Upstream version 0.0~git20150612 Michael Stapelberg 8 years ago