From b.candler@pobox.com  Tue Aug  1 08:13:38 2006
Return-Path: <b.candler@pobox.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 1233116A4E7
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  1 Aug 2006 08:13:38 +0000 (UTC)
	(envelope-from b.candler@pobox.com)
Received: from rune.pobox.com (rune.pobox.com [208.210.124.79])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 69B3143D67
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  1 Aug 2006 08:13:34 +0000 (GMT)
	(envelope-from b.candler@pobox.com)
Received: from rune (localhost [127.0.0.1])
	by rune.pobox.com (Postfix) with ESMTP id 0C85D7AF31
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  1 Aug 2006 04:13:56 -0400 (EDT)
Received: from mappit.local.linnet.org (212-74-113-67.static.dsl.as9105.com [212.74.113.67])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by rune.sasl.smtp.pobox.com (Postfix) with ESMTP id DBC242274
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  1 Aug 2006 04:13:55 -0400 (EDT)
Received: from brian by mappit.local.linnet.org with local (Exim 4.61 (FreeBSD))
	(envelope-from <b.candler@pobox.com>)
	id 1G7pNc-000Mcu-FY
	for FreeBSD-gnats-submit@freebsd.org; Tue, 01 Aug 2006 09:13:32 +0100
Message-Id: <E1G7pNc-000Mcu-FY@mappit.local.linnet.org>
Date: Tue, 01 Aug 2006 09:13:32 +0100
From: Brian Candler <B.Candler@pobox.com>
Reply-To: Brian Candler <B.Candler@pobox.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: msgsnd(3) manpage doesn't define msgsz clearly
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         101145
>Category:       docs
>Synopsis:       msgsnd(3) manpage doesn't define msgsz clearly
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    ru
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Aug 01 08:20:06 GMT 2006
>Closed-Date:    Mon Oct 16 11:56:11 GMT 2006
>Last-Modified:  Mon Oct 16 12:00:53 GMT 2006
>Originator:     Brian Candler
>Release:        FreeBSD 5.4-RELEASE i386 and CURRENT
>Organization:
>Environment:


	
>Description:

msgsnd(3) page doesn't make it clear whether the 'msgsz' argument refers to
the length of the entire *msgp structure (mtype + mtext) or just to the
length of the data in mtext.

>How-To-Repeat:

man 3 msgsnd

>Fix:

The Linux manpage is clearer: it says

       The  mtext field is an array (or other structure) whose size is speci-
       fied by msgsz, a non-negative integer value.  Messages of zero  length
       (i.e.,  no  mtext  field)  are permitted.

But perhaps a simple fix for us is:

     mtype is an integer greater than 0 that can be used for selecting mes-
     sages (see msgrcv(3)); mtext is an array of msgsz bytes, which may be
     between 0 and the system limit (MSGMAX).
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: ru 
State-Changed-When: Thu Oct 12 11:43:02 UTC 2006 
State-Changed-Why:  
Fixed in HEAD, thanks; will merge into RELENG_6 soon. 


Responsible-Changed-From-To: freebsd-doc->ru 
Responsible-Changed-By: ru 
Responsible-Changed-When: Thu Oct 12 11:43:02 UTC 2006 
Responsible-Changed-Why:  

http://www.freebsd.org/cgi/query-pr.cgi?pr=101145 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/101145: commit references a PR
Date: Thu, 12 Oct 2006 11:43:47 +0000 (UTC)

 ru          2006-10-12 11:42:41 UTC
 
   FreeBSD src repository
 
   Modified files:
     lib/libc/gen         msgsnd.3 
   Log:
   Document what "msgsz" argument really denotes.  [1]
   
   Don't say that "msgsz" can be less than 0, it cannot
   as it's unsigned (POSIX has the same bug).
   
   PR:             docs/101145 [1]
   MFC after:      3 days
   
   Revision  Changes    Path
   1.21      +9 -4      src/lib/libc/gen/msgsnd.3
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: ru 
State-Changed-When: Mon Oct 16 11:55:52 UTC 2006 
State-Changed-Why:  
Merged into RELENG_6. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=101145 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/101145: commit references a PR
Date: Mon, 16 Oct 2006 11:55:58 +0000 (UTC)

 ru          2006-10-16 11:55:50 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_6)
     lib/libc/gen         msgsnd.3 
   Log:
   MFC: 1.21: Document what "msgsz" actually means.
   
   PR:             docs/101145
   Approved by:    re (hrs)
   
   Revision  Changes    Path
   1.20.2.1  +9 -4      src/lib/libc/gen/msgsnd.3
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
