Re: [PATCH] msgsnd(2): msg_bytes -> msg_qbytes

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Thu, Apr 29, 2010 at 1:59 AM, Michael Witten <mfwitten@xxxxxxxxx> wrote:
> Mihail Paraschivescu <paraschivescu_mihail@xxxxxxxxx> reported
> here:
>
>    http://marc.info/?l=linux-man&m=127160667709342&w=2
>    http://www.spinics.net/lists/linux-man/msg01271.html
>
> the following:
>
>    "The queue capacity is defined by the msg_bytes field in
>    the associated data structure for the message queue."
>
>    If I'm not wrong, the exact name of that field in the
>    msqid_ds structure is msg_qbytes. The same thing appears
>    also on the online [POSIX] manual pages, I checked it
>    already.
>
> I provided a detailed confirmation with quotes from the
> Linux kernel sources:
>
>    http://marc.info/?l=linux-man&m=127181601631737&w=2
>    http://www.spinics.net/lists/linux-man/msg01273.html
>
> This patch (requested by Mihail) makes the correction and
> removes unnecessary implementation details.

Michael, thanks for this patch, but see my notes in the thread:

Subject: Re: Man page typo
To: Michael Witten <mfwitten@xxxxxxxxx>
Cc: Mihai Paraschivescu <paraschivescu_mihail@xxxxxxxxx>,
linux-man@xxxxxxxxxxxxxxx

I don't think this patch is needed (other than the part that fixes the
file names).

Cheers,

Michael

> ---
>  man2/msgop.2 |   16 ++++++++--------
>  1 files changed, 8 insertions(+), 8 deletions(-)
>
> diff --git a/man2/msgop.2 b/man2/msgop.2
> index 2b29cac..f236c5a 100644
> --- a/man2/msgop.2
> +++ b/man2/msgop.2
> @@ -102,14 +102,14 @@ by
>  .PP
>  If sufficient space is available in the queue,
>  .BR msgsnd ()
> -succeeds immediately.
> +succeeds immediately;
> -(The queue capacity is defined by the
> -.I msg_bytes
> -field in the associated data structure for the message queue.
> -During queue creation this field is initialized to
> -.B MSGMNB
> -bytes, but this limit can be modified using
> -.BR msgctl (2).)
> +the queue capacity can be queried and set via
> +.BR msgctl (2)
> +by using the
> +.I msg_qbytes
> +field of that function's
> +.I msqid_ds
> +pointer parameter.
>  If insufficient space is available in the queue, then the default
>  behavior of
>  .BR msgsnd ()
> --
> 1.7.1
>
>



-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface" http://blog.man7.org/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux