From owner-freebsd-doc@FreeBSD.ORG Tue Aug 1 08:20:09 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org 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 1E1C116A4DD for ; Tue, 1 Aug 2006 08:20:09 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5E13543D5E for ; Tue, 1 Aug 2006 08:20:07 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k718K7HD075071 for ; Tue, 1 Aug 2006 08:20:07 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k718K79n075070; Tue, 1 Aug 2006 08:20:07 GMT (envelope-from gnats) Resent-Date: Tue, 1 Aug 2006 08:20:07 GMT Resent-Message-Id: <200608010820.k718K79n075070@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Brian Candler Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1233116A4E7 for ; 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 ; 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 ; 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 ; 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 ) id 1G7pNc-000Mcu-FY for FreeBSD-gnats-submit@freebsd.org; Tue, 01 Aug 2006 09:13:32 +0100 Message-Id: Date: Tue, 01 Aug 2006 09:13:32 +0100 From: Brian Candler To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/101145: msgsnd(3) manpage doesn't define msgsz clearly X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Brian Candler List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 01 Aug 2006 08:20:09 -0000 >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: