From ac3cf56d336d37357da320d1885a197bc4cfcacd Mon Sep 17 00:00:00 2001 From: Giles Lean Date: Tue, 6 Apr 2010 10:28:55 -0700 Subject: [PATCH] syscall package: document that errno is zeroed on success This is a documentation enhancement only, without any code change. The rationale for documenting this precisely is that Unix programmers who "know" that errno's value is undefined after a successful system call may be surprised otherwise and search to be sure that a zero errno may be relied upon after successful calls. R=r, rsc1, rsc CC=golang-dev https://golang.org/cl/812044 --- src/pkg/syscall/syscall.go | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/pkg/syscall/syscall.go b/src/pkg/syscall/syscall.go index 372149bf2c..46f5c98764 100644 --- a/src/pkg/syscall/syscall.go +++ b/src/pkg/syscall/syscall.go @@ -9,6 +9,8 @@ // packages rather than this one if you can. // For details of the functions and data types in this package consult // the manuals for the appropriate operating system. +// These calls return errno == 0 to indicate success; otherwise +// errno is an operating system error number describing the failure. package syscall func Syscall(trap, a1, a2, a3 uintptr) (r1, r2, err uintptr) -- 2.50.0