Date: Mon, 10 Feb 2003 01:29:40 +0100 (CET) From: Per Hedeland <per@hedeland.org> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/48125: [PATCH] Incorrect errno strings in intro(2) Message-ID: <200302100029.h1A0TeaI009783@pluto.hedeland.org>
next in thread | raw e-mail | index | archive | help
>Number: 48125
>Category: docs
>Synopsis: [PATCH] Incorrect errno strings in intro(2)
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Sun Feb 09 16:30:13 PST 2003
>Closed-Date:
>Last-Modified:
>Originator: Per Hedeland
>Release: FreeBSD 5.0-RELEASE i386
>Organization:
None
>Environment:
System: FreeBSD pluto.hedeland.org 5.0-RELEASE FreeBSD 5.0-RELEASE #6: Sun Feb 9 19:32:16 CET 2003 per@pluto.hedeland.org:/usr/src/sys/i386/compile/PLUTO i386
>Description:
Several of the strings given in intro(2) a.k.a. 'man errno' do
not agree with what is actually output by programs using
perror() etc, making problem resolution unnecessarily difficult.
>How-To-Repeat:
Do something that generates the error message "Device not
configured." Try to find the corresponding errno value and
explanation via 'man errno', and fail. Grep errlst.c while
muttering the L-word.
>Fix:
Apply patch below against
$FreeBSD: src/lib/libc/sys/intro.2,v 1.36 2002/12/12 17:25:53 ru Exp $
--- /usr/src/lib/libc/sys/intro.2.ORIG Thu Dec 12 18:25:53 2002
+++ /usr/src/lib/libc/sys/intro.2 Mon Feb 10 01:06:23 2003
@@ -90,7 +90,7 @@
names as given in
.Aq Pa sys/errno.h .
.Bl -hang -width Ds
-.It Er 0 Em "Error 0" .
+.It Er 0 Em "Undefined error: 0" .
Not used.
.It Er 1 EPERM Em "Operation not permitted" .
An attempt was made to perform an operation limited to processes
@@ -102,7 +102,7 @@
.It Er 3 ESRCH Em "No such process" .
No process could be found corresponding to that specified by the given
process ID.
-.It Er 4 EINTR Em "Interrupted function call" .
+.It Er 4 EINTR Em "Interrupted system call" .
An asynchronous signal (such as
.Dv SIGINT
or
@@ -115,14 +115,14 @@
Some physical input or output error occurred.
This error will not be reported until a subsequent operation on the same file
descriptor and may be lost (over written) by any subsequent errors.
-.It Er 6 ENXIO Em "\&No such device or address" .
+.It Er 6 ENXIO Em "Device not configured" .
Input or output on a special file referred to a device that did not
exist, or
made a request beyond the limits of the device.
This error may also occur when, for example,
a tape drive is not online or no disk pack is
loaded on a drive.
-.It Er 7 E2BIG Em "Arg list too long" .
+.It Er 7 E2BIG Em "Argument list too long" .
The number of bytes used for the argument and environment
list of the new process exceeded the current limit
of 65536 bytes
@@ -161,9 +161,9 @@
.It Er 14 EFAULT Em "Bad address" .
The system detected an invalid address in attempting to
use an argument of a call.
-.It Er 15 ENOTBLK Em "Not a block device" .
+.It Er 15 ENOTBLK Em "Block device required" .
A block device operation was attempted on a non-block device or file.
-.It Er 16 EBUSY Em "Resource busy" .
+.It Er 16 EBUSY Em "Device busy" .
An attempt to use a system resource which was in use at the time
in a manner which would have conflicted with the request.
.It Er 17 EEXIST Em "File exists" .
@@ -171,7 +171,7 @@
for instance, as the new link name in a
.Xr link 2
function.
-.It Er 18 EXDEV Em "Improper link" .
+.It Er 18 EXDEV Em "Cross-device link" .
A hard link to a file on another file system
was attempted.
.It Er 19 ENODEV Em "Operation not supported by device" .
@@ -218,7 +218,7 @@
.if t 2\u\s-231\s+2\d
.if n 2.1E9
bytes).
-.It Er 28 ENOSPC Em "Device out of space" .
+.It Er 28 ENOSPC Em "No space left on device" .
A
.Xr write 2
to an ordinary file, the creation of a
@@ -246,7 +246,7 @@
.It Er 33 EDOM Em "Numerical argument out of domain" .
A numerical input argument was outside the defined domain of the mathematical
function.
-.It Er 34 ERANGE Em "Numerical result out of range" .
+.It Er 34 ERANGE Em "Result too large" .
A numerical result of the function was too large to fit in the
available space (perhaps exceeded precision).
.It Er 35 EAGAIN Em "Resource temporarily unavailable" .
@@ -309,7 +309,7 @@
.It Er 48 EADDRINUSE Em "Address already in use" .
Only one usage of each address is normally permitted.
.Pp
-.It Er 49 EADDRNOTAVAIL Em "Cannot assign requested address" .
+.It Er 49 EADDRNOTAVAIL Em "Can't assign requested address" .
Normally results from an attempt to create a socket with an
address not on this machine.
.It Er 50 ENETDOWN Em "Network is down" .
@@ -341,7 +341,7 @@
An request to send or receive data was disallowed because
the socket was not connected and (when sending on a datagram socket)
no address was supplied.
-.It Er 58 ESHUTDOWN Em "Cannot send after socket shutdown" .
+.It Er 58 ESHUTDOWN Em "Can't send after socket shutdown" .
A request to send data was disallowed because the socket
had already been shut down with a previous
.Xr shutdown 2
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200302100029.h1A0TeaI009783>