git: 9a62cdc01327 - main - intro.2 as errno.2: Use the name macro for errno
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Sat, 04 May 2024 14:58:18 UTC
The branch main has been updated by imp:
URL: https://cgit.FreeBSD.org/src/commit/?id=9a62cdc0132720c439313707b5e339dc348b0d45
commit 9a62cdc0132720c439313707b5e339dc348b0d45
Author: Alexander Ziaee <concussious@runbox.com>
AuthorDate: 2024-05-04 14:54:21 +0000
Commit: Warner Losh <imp@FreeBSD.org>
CommitDate: 2024-05-04 14:56:10 +0000
intro.2 as errno.2: Use the name macro for errno
Reviewed by: imp
Pull Request: https://github.com/freebsd/freebsd-src/pull/1192
---
lib/libsys/intro.2 | 13 +++++++------
1 file changed, 7 insertions(+), 6 deletions(-)
diff --git a/lib/libsys/intro.2 b/lib/libsys/intro.2
index f10312c1962a..008936b278ae 100644
--- a/lib/libsys/intro.2
+++ b/lib/libsys/intro.2
@@ -32,8 +32,9 @@
.Dt INTRO 2
.Os
.Sh NAME
-.Nm intro
-.Nd introduction to system calls and error numbers
+.Nm intro ,
+.Nm errno
+.Nd introduction to system calls and their error numbers
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
@@ -333,7 +334,7 @@ Table of currently available system calls.
.Sh ERRORS
Nearly all of the system calls provide an error number referenced via
the external identifier
-.Va errno .
+.Nm errno .
This identifier is defined in
.In sys/errno.h
as:
@@ -349,7 +350,7 @@ For the initial thread and
non-threaded processes,
.Va __error()
returns a pointer to a global
-.Va errno
+.Nm errno
variable that is compatible with the previous definition.
.Pp
When a system call detects an error,
@@ -357,12 +358,12 @@ it returns an integer value
indicating failure
.Pq usually -1
and sets the variable
-.Va errno
+.Nm errno
accordingly.
This allows interpretation of the failure on receiving
-1 and to take action accordingly.
Successful calls never set
-.Va errno ;
+.Nm errno ;
once set, it remains until another error occurs.
It should only be examined after an error.
Note that a number of system calls overload the meanings of these