Files in this directory are data for Go's API checker ("go tool api", in src/cmd/api).

Each file is a list of API features, one per line.

go1.txt (and similarly named files) are frozen once a version has been
shipped. Each file adds new lines but does not remove any.

except.txt lists features that may disappear without breaking true
compatibility.

Starting with go1.19.txt, each API feature line must end in "#nnnnn"

<p>
The formal grammar uses semicolons <code>";"</code> as terminators in
a number of productions. Go programs may omit most of these semicolons
using the following two rules:
</p>

<ol>
<li>
When the input is broken into tokens, a semicolon is automatically inserted
into the token stream immediately after a line's final token if that token is
<ul>
	<li>an
	    <a href="#Identifiers">identifier</a>
	</li>

	<li>an

%typemap(gotype) const char * "string"
%typemap(in) const char * %{
	$1 = malloc($input.n + 1);
	memcpy($1, $input.p, $input.n);
	$1[$input.n] = '\0';
%}
%typemap(freearg) const char * %{
	free($1);
%}

FILE *fopen(const char *name, const char *mode);
int fclose(FILE *);

pkg syscall (darwin-386), const SYS_FFSCTL = 245
pkg syscall (darwin-386), const SYS_FGETATTRLIST = 228
pkg syscall (darwin-386), const SYS_FGETXATTR = 235
pkg syscall (darwin-386), const SYS_FHOPEN = 248
pkg syscall (darwin-386), const SYS_FILEPORT_MAKEFD = 431
pkg syscall (darwin-386), const SYS_FILEPORT_MAKEPORT = 430
pkg syscall (darwin-386), const SYS_FLISTXATTR = 241

<p>
The formal syntax uses semicolons <code>";"</code> as terminators in
a number of productions. Go programs may omit most of these semicolons
using the following two rules:
</p>

<ol>
<li>
When the input is broken into tokens, a semicolon is automatically inserted
into the token stream immediately after a line's final token if that token is
<ul>
	<li>an
	    <a href="#Identifiers">identifier</a>
	</li>

	<li>an

pkg syscall (freebsd-386-cgo), const SYS_FFCLOCK_GETESTIMATE ideal-int
pkg syscall (freebsd-386-cgo), const SYS_FFCLOCK_SETESTIMATE ideal-int
pkg syscall (freebsd-386-cgo), const SYS_FHOPEN ideal-int
pkg syscall (freebsd-386-cgo), const SYS_FHSTAT ideal-int
pkg syscall (freebsd-386-cgo), const SYS_FHSTATFS ideal-int
pkg syscall (freebsd-386-cgo), const SYS_FLOCK ideal-int

func main() {
	if x := int(C.F()); x != 1 {
		fatal("x = %d, want 1", x)
	}

	// Open this file itself and verify that the first few characters are
	// as expected.
	f := Fopen("main.go", "r")
	if f.Swigcptr() == 0 {
		fatal("fopen failed")
	}
	if Fgetc(f) != '/' || Fgetc(f) != '/' || Fgetc(f) != ' ' || Fgetc(f) != 'C' {
		fatal("read unexpected characters")
	}
	if Fclose(f) != 0 {
		fatal("fclose failed")
	}

Atlantic/Bermuda Atlantic/Canary Atlantic/Cape_Verde Atlantic/Faeroe Atlantic/Faroe Atlantic/Jan_Mayen Atlantic/Madeira Atlantic/Reykjavik Atlantic/South_Georgia Atlantic/St_Helena Atlantic/Stanley Australia/ACT Australia/Adelaide Australia/Brisbane Australia/Broken_Hill Australia/Canberra Australia/Currie Australia/Darwin Australia/Eucla Australia/Hobart Australia/LHI Australia/Lindeman Australia/Lord_Howe Australia/Melbourne Australia/NSW Australia/North Australia/Perth Australia/Queensland Australia/South...

	}
	if _, err := os.Stat("/etc/alpine-release"); err == nil {
		t.Skip("setgid is broken with musl libc - go.dev/issue/39857")
	}
	testSetgid(t)
}

func TestSetgidStress(t *testing.T) {
	if runtime.GOOS == "android" {
		t.Skip("unsupported on Android")
	}
	if _, err := os.Stat("/etc/alpine-release"); err == nil {
		t.Skip("setgid is broken with musl libc - go.dev/issue/39857")
	}
	testSetgidStress(t)
}

pkg syscall (darwin-arm64), const SYS_FGETXATTR = 235
pkg syscall (darwin-arm64), const SYS_FGETXATTR ideal-int
pkg syscall (darwin-arm64), const SYS_FHOPEN = 248
pkg syscall (darwin-arm64), const SYS_FHOPEN ideal-int
pkg syscall (darwin-arm64), const SYS_FILEPORT_MAKEFD = 431
pkg syscall (darwin-arm64), const SYS_FILEPORT_MAKEFD ideal-int
pkg syscall (darwin-arm64), const SYS_FILEPORT_MAKEPORT = 430