From owner-freebsd-doc Sun Feb 9 16:30:22 2003 Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4562D37B401 for ; Sun, 9 Feb 2003 16:30:18 -0800 (PST) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id BA17D43FBD for ; Sun, 9 Feb 2003 16:30:13 -0800 (PST) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.6/8.12.6) with ESMTP id h1A0UDNS099735 for ; Sun, 9 Feb 2003 16:30:13 -0800 (PST) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.6/8.12.6/Submit) id h1A0UDD9099734; Sun, 9 Feb 2003 16:30:13 -0800 (PST) Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 209CF37B401 for ; Sun, 9 Feb 2003 16:29:46 -0800 (PST) Received: from pluto.hedeland.org (as1-2-8.mal.s.bonet.se [194.236.4.19]) by mx1.FreeBSD.org (Postfix) with ESMTP id 64B0643F3F for ; Sun, 9 Feb 2003 16:29:44 -0800 (PST) (envelope-from per@hedeland.org) Received: from pluto.hedeland.org (localhost [127.0.0.1]) by pluto.hedeland.org (8.12.6/8.12.6) with ESMTP id h1A0Tfpg009784 for ; Mon, 10 Feb 2003 01:29:41 +0100 (CET) (envelope-from per@pluto.hedeland.org) Received: (from per@localhost) by pluto.hedeland.org (8.12.6/8.12.6/Submit) id h1A0TeaI009783; Mon, 10 Feb 2003 01:29:40 +0100 (CET) Message-Id: <200302100029.h1A0TeaI009783@pluto.hedeland.org> Date: Mon, 10 Feb 2003 01:29:40 +0100 (CET) From: Per Hedeland Reply-To: Per Hedeland To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/48125: [PATCH] Incorrect errno strings in intro(2) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >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