docs/101145: msgsnd(3) manpage doesn't define msgsz clearly

[Brian Candler]

>Number:         101145
>Category:       docs
>Synopsis:       msgsnd(3) manpage doesn't define msgsz clearly
>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 Aug 01 08:20:06 GMT 2006
>Closed-Date:
>Last-Modified:
>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:
>Unformatted: