docs/82217: [PATCH] Documentation fix for msgrcv(3)

[Xin LI]

>Number:         82217
>Category:       docs
>Synopsis:       [PATCH] Documentation fix for msgrcv(3)
>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:   Tue Jun 14 08:50:21 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     Xin LI
>Release:        FreeBSD 5.4-RELEASE-p1 i386
>Organization:
The FreeBSD Simplified Chinese Project
>Environment:
System: FreeBSD tarsier.delphij.net 5.4-RELEASE-p1 FreeBSD 5.4-RELEASE-p1 #5: Fri May 13 10:17:03 CST 2005 delphij at tarsier.delphij.net:/usr/obj/usr/src/sys/TARSIER i386


>Description:
	When IPC_NOWAIT is set and there is no message, msgrcv should
fail with errno set to ENOMSG.  This behavior is implemented in our
system, and is defined in POSIX[1].

	The current msgrcv(3) manpage says that EAGAIN would be set,
however.

[1] http://www.opengroup.org/onlinepubs/009695399/functions/msgrcv.html

>How-To-Repeat:
>Fix:

	The attached patch should be applied to -HEAD (hopefully
before RELENG_6 branch :-)

--- patch-msgrcv begins here ---
Index: msgrcv.3
===================================================================
RCS file: /home/ncvs/src/lib/libc/gen/msgrcv.3,v
retrieving revision 1.19
diff -u -r1.19 msgrcv.3
--- msgrcv.3	2 Jul 2004 23:52:10 -0000	1.19
+++ msgrcv.3	14 Jun 2005 08:41:02 -0000
@@ -31,7 +31,7 @@
 .\" $FreeBSD: src/lib/libc/gen/msgrcv.3,v 1.19 2004/07/02 23:52:10 ru Exp $
 .\"
 .\"/
-.Dd November 24, 1997
+.Dd June 15, 2005
 .Dt MSGRCV 3
 .Os
 .Sh NAME
@@ -122,7 +122,7 @@
 will immediately return a value of -1, and set
 .Va errno
 to
-.Er EAGAIN .
+.Er ENOMSG .
 If
 .Dv IPC_NOWAIT
 is not set, the calling process will be blocked
@@ -206,7 +206,7 @@
 points to an invalid address.
 .It Bq Er EINTR
 The system call was interrupted by the delivery of a signal.
-.It Bq Er EAGAIN
+.It Bq Er ENOMSG
 There is no message of the requested type available on the message queue,
 and
 .Dv IPC_NOWAIT
--- patch-msgrcv ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted: