From 722e1e4797b51df8a2062d9f28c03e3836d2f411 Mon Sep 17 00:00:00 2001 From: Giles Lean Date: Tue, 6 Apr 2010 10:28:55 -0700 Subject: 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 http://codereview.appspot.com/812044 Committer: Russ Cox --- 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 372149bf2..46f5c9876 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) -- cgit v1.2.3