aboutsummaryrefslogtreecommitdiffhomepage
path: root/vendor/golang.org/x/sys/unix/README.md
diff options
context:
space:
mode:
authorNathan Dench <ndenc2@gmail.com>2019-05-24 15:16:44 +1000
committerNathan Dench <ndenc2@gmail.com>2019-05-24 15:16:44 +1000
commit107c1cdb09c575aa2f61d97f48d8587eb6bada4c (patch)
treeca7d008643efc555c388baeaf1d986e0b6b3e28c /vendor/golang.org/x/sys/unix/README.md
parent844b5a68d8af4791755b8f0ad293cc99f5959183 (diff)
downloadterraform-provider-statuscake-107c1cdb09c575aa2f61d97f48d8587eb6bada4c.tar.gz
terraform-provider-statuscake-107c1cdb09c575aa2f61d97f48d8587eb6bada4c.tar.zst
terraform-provider-statuscake-107c1cdb09c575aa2f61d97f48d8587eb6bada4c.zip
Upgrade to 0.12
Diffstat (limited to 'vendor/golang.org/x/sys/unix/README.md')
-rw-r--r--vendor/golang.org/x/sys/unix/README.md20
1 files changed, 10 insertions, 10 deletions
diff --git a/vendor/golang.org/x/sys/unix/README.md b/vendor/golang.org/x/sys/unix/README.md
index bc6f603..eb2f78a 100644
--- a/vendor/golang.org/x/sys/unix/README.md
+++ b/vendor/golang.org/x/sys/unix/README.md
@@ -14,7 +14,7 @@ migrating the build system to use containers so the builds are reproducible.
14This is being done on an OS-by-OS basis. Please update this documentation as 14This is being done on an OS-by-OS basis. Please update this documentation as
15components of the build system change. 15components of the build system change.
16 16
17### Old Build System (currently for `GOOS != "Linux" || GOARCH == "sparc64"`) 17### Old Build System (currently for `GOOS != "linux"`)
18 18
19The old build system generates the Go files based on the C header files 19The old build system generates the Go files based on the C header files
20present on your system. This means that files 20present on your system. This means that files
@@ -32,9 +32,9 @@ To build the files for your current OS and architecture, make sure GOOS and
32GOARCH are set correctly and run `mkall.sh`. This will generate the files for 32GOARCH are set correctly and run `mkall.sh`. This will generate the files for
33your specific system. Running `mkall.sh -n` shows the commands that will be run. 33your specific system. Running `mkall.sh -n` shows the commands that will be run.
34 34
35Requirements: bash, perl, go 35Requirements: bash, go
36 36
37### New Build System (currently for `GOOS == "Linux" && GOARCH != "sparc64"`) 37### New Build System (currently for `GOOS == "linux"`)
38 38
39The new build system uses a Docker container to generate the go files directly 39The new build system uses a Docker container to generate the go files directly
40from source checkouts of the kernel and various system libraries. This means 40from source checkouts of the kernel and various system libraries. This means
@@ -52,14 +52,14 @@ system and have your GOOS and GOARCH set accordingly. Running `mkall.sh` will
52then generate all of the files for all of the GOOS/GOARCH pairs in the new build 52then generate all of the files for all of the GOOS/GOARCH pairs in the new build
53system. Running `mkall.sh -n` shows the commands that will be run. 53system. Running `mkall.sh -n` shows the commands that will be run.
54 54
55Requirements: bash, perl, go, docker 55Requirements: bash, go, docker
56 56
57## Component files 57## Component files
58 58
59This section describes the various files used in the code generation process. 59This section describes the various files used in the code generation process.
60It also contains instructions on how to modify these files to add a new 60It also contains instructions on how to modify these files to add a new
61architecture/OS or to add additional syscalls, types, or constants. Note that 61architecture/OS or to add additional syscalls, types, or constants. Note that
62if you are using the new build system, the scripts cannot be called normally. 62if you are using the new build system, the scripts/programs cannot be called normally.
63They must be called from within the docker container. 63They must be called from within the docker container.
64 64
65### asm files 65### asm files
@@ -81,8 +81,8 @@ each GOOS/GOARCH pair.
81 81
82### mksysnum 82### mksysnum
83 83
84Mksysnum is a script located at `${GOOS}/mksysnum.pl` (or `mksysnum_${GOOS}.pl` 84Mksysnum is a Go program located at `${GOOS}/mksysnum.go` (or `mksysnum_${GOOS}.go`
85for the old system). This script takes in a list of header files containing the 85for the old system). This program takes in a list of header files containing the
86syscall number declarations and parses them to produce the corresponding list of 86syscall number declarations and parses them to produce the corresponding list of
87Go numeric constants. See `zsysnum_${GOOS}_${GOARCH}.go` for the generated 87Go numeric constants. See `zsysnum_${GOOS}_${GOARCH}.go` for the generated
88constants. 88constants.
@@ -92,14 +92,14 @@ new installation of the target OS (or updating the source checkouts for the
92new build system). However, depending on the OS, you make need to update the 92new build system). However, depending on the OS, you make need to update the
93parsing in mksysnum. 93parsing in mksysnum.
94 94
95### mksyscall.pl 95### mksyscall.go
96 96
97The `syscall.go`, `syscall_${GOOS}.go`, `syscall_${GOOS}_${GOARCH}.go` are 97The `syscall.go`, `syscall_${GOOS}.go`, `syscall_${GOOS}_${GOARCH}.go` are
98hand-written Go files which implement system calls (for unix, the specific OS, 98hand-written Go files which implement system calls (for unix, the specific OS,
99or the specific OS/Architecture pair respectively) that need special handling 99or the specific OS/Architecture pair respectively) that need special handling
100and list `//sys` comments giving prototypes for ones that can be generated. 100and list `//sys` comments giving prototypes for ones that can be generated.
101 101
102The mksyscall.pl script takes the `//sys` and `//sysnb` comments and converts 102The mksyscall.go program takes the `//sys` and `//sysnb` comments and converts
103them into syscalls. This requires the name of the prototype in the comment to 103them into syscalls. This requires the name of the prototype in the comment to
104match a syscall number in the `zsysnum_${GOOS}_${GOARCH}.go` file. The function 104match a syscall number in the `zsysnum_${GOOS}_${GOARCH}.go` file. The function
105prototype can be exported (capitalized) or not. 105prototype can be exported (capitalized) or not.
@@ -160,7 +160,7 @@ signal numbers, and constants. Generated by `mkerrors.sh` (see above).
160### `zsyscall_${GOOS}_${GOARCH}.go` 160### `zsyscall_${GOOS}_${GOARCH}.go`
161 161
162A file containing all the generated syscalls for a specific GOOS and GOARCH. 162A file containing all the generated syscalls for a specific GOOS and GOARCH.
163Generated by `mksyscall.pl` (see above). 163Generated by `mksyscall.go` (see above).
164 164
165### `zsysnum_${GOOS}_${GOARCH}.go` 165### `zsysnum_${GOOS}_${GOARCH}.go`
166 166