# Using cgo with the go command

To use cgo write normal Go code that imports a pseudo-package "C".
The Go code can then refer to types such as C.size_t, variables such
as C.stdout, or functions such as C.putchar.

If the import of "C" is immediately preceded by a comment, that
comment, called the preamble, is used as a header when compiling
the C parts of the package. For example:

	// #include <stdio.h>

pkg syscall (netbsd-arm64-cgo), const RLIMIT_STACK = 3
pkg syscall (netbsd-arm64-cgo), const RLIMIT_STACK ideal-int
pkg syscall (netbsd-arm64-cgo), const RTA_AUTHOR = 64
pkg syscall (netbsd-arm64-cgo), const RTA_AUTHOR ideal-int
pkg syscall (netbsd-arm64-cgo), const RTA_BRD = 128
pkg syscall (netbsd-arm64-cgo), const RTA_BRD ideal-int
pkg syscall (netbsd-arm64-cgo), const RTA_DST = 1

## For developers

Release notes should be added to `next` by editing existing files or creating
new files. **Do not add RELNOTE=yes comments in CLs.** Instead, add a file to
the CL (or ask the author to do so).

At the end of the development cycle, the files will be merged by being
concatenated in sorted order by pathname. Files in the directory matching the

pkg syscall (darwin-386), const RLIMIT_NOFILE = 8
pkg syscall (darwin-386), const RLIMIT_STACK = 3
pkg syscall (darwin-386), const RLIM_INFINITY = 9223372036854775807
pkg syscall (darwin-386), const RTAX_AUTHOR = 6
pkg syscall (darwin-386), const RTAX_BRD = 7
pkg syscall (darwin-386), const RTAX_DST = 0
pkg syscall (darwin-386), const RTAX_GATEWAY = 1
pkg syscall (darwin-386), const RTAX_GENMASK = 3

pkg syscall (freebsd-386-cgo), const RLIMIT_NOFILE ideal-int
pkg syscall (freebsd-386-cgo), const RLIMIT_STACK ideal-int
pkg syscall (freebsd-386-cgo), const RLIM_INFINITY ideal-int
pkg syscall (freebsd-386-cgo), const RTAX_AUTHOR ideal-int
pkg syscall (freebsd-386-cgo), const RTAX_BRD ideal-int
pkg syscall (freebsd-386-cgo), const RTAX_DST ideal-int
pkg syscall (freebsd-386-cgo), const RTAX_GATEWAY ideal-int

  - type: dropdown
    id: author-go-experience
    attributes:
      label: "Go Programming Experience"
      description: "Would you consider yourself a novice, intermediate, or experienced Go programmer?"
      options:
        - "Novice"
        - "Intermediate"
        - "Experienced"
      default: 1

  - type: input
    id: author-other-languages-experience
    attributes:

    attributes:
      label: "What is the path of the package that you would like to have removed?"
      description: |
        We can remove packages with a shared path prefix.
        For example, a request for 'github.com/author' would remove all pkg.go.dev pages with that package path prefix.
    validations:
      required: true
  - type: textarea
    id: package-owner
    attributes:
      label: "Are you the owner of this package?"

pkg syscall (freebsd-riscv64), const RLIM_INFINITY = 9223372036854775807 #53466
pkg syscall (freebsd-riscv64), const RLIM_INFINITY ideal-int #53466
pkg syscall (freebsd-riscv64), const RTAX_AUTHOR = 6 #53466
pkg syscall (freebsd-riscv64), const RTAX_AUTHOR ideal-int #53466
pkg syscall (freebsd-riscv64), const RTAX_BRD = 7 #53466
pkg syscall (freebsd-riscv64), const RTAX_BRD ideal-int #53466
pkg syscall (freebsd-riscv64), const RTAX_DST = 0 #53466

)

var debugDefine = flag.Bool("debug-define", false, "print relevant #defines")
var debugGcc = flag.Bool("debug-gcc", false, "print gcc invocations")

var nameToC = map[string]string{
	"schar":         "signed char",
	"uchar":         "unsigned char",
	"ushort":        "unsigned short",
	"uint":          "unsigned int",
	"ulong":         "unsigned long",
	"longlong":      "long long",
	"ulonglong":     "unsigned long long",

pkg syscall (darwin-arm64), const RLIM_INFINITY = 9223372036854775807
pkg syscall (darwin-arm64), const RLIM_INFINITY ideal-int
pkg syscall (darwin-arm64), const RTAX_AUTHOR = 6
pkg syscall (darwin-arm64), const RTAX_AUTHOR ideal-int
pkg syscall (darwin-arm64), const RTAX_BRD = 7
pkg syscall (darwin-arm64), const RTAX_BRD ideal-int
pkg syscall (darwin-arm64), const RTAX_DST = 0