From owner-freebsd-arch@FreeBSD.ORG  Wed May 21 09:19:06 2003
Return-Path: <owner-freebsd-arch@FreeBSD.ORG>
Delivered-To: freebsd-arch@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id 5656B37B401; Wed, 21 May 2003 09:19:06 -0700 (PDT)
Received: from fledge.watson.org (fledge.watson.org [204.156.12.50])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 7A83A43F3F; Wed, 21 May 2003 09:19:05 -0700 (PDT)
	(envelope-from robert@fledge.watson.org)
Received: from fledge.watson.org (localhost [127.0.0.1])
	by fledge.watson.org (8.12.9/8.12.9) with ESMTP id h4LGIWOn079957;
	Wed, 21 May 2003 12:18:32 -0400 (EDT)
	(envelope-from robert@fledge.watson.org)
Received: from localhost (robert@localhost)h4LGIWcg079954;
	Wed, 21 May 2003 12:18:32 -0400 (EDT)
	(envelope-from robert@fledge.watson.org)
Date: Wed, 21 May 2003 12:18:32 -0400 (EDT)
From: Robert Watson <rwatson@FreeBSD.ORG>
X-Sender: robert@fledge.watson.org
To: Jeff Roberson <jroberson@chesapeake.net>
In-Reply-To: <20030521004947.X52717-100000@mail.chesapeake.net>
Message-ID: <Pine.NEB.3.96L.1030521121706.79561D-100000@fledge.watson.org>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
cc: Hiten Pandya <hmp@FreeBSD.ORG>
cc: jeff@FreeBSD.ORG
cc: des@FreeBSD.ORG
cc: arch@FreeBSD.ORG
Subject: Re: ALQ manual page review
X-BeenThere: freebsd-arch@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Discussion related to FreeBSD architecture
	<freebsd-arch.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-arch>,
	<mailto:freebsd-arch-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-arch>
List-Post: <mailto:freebsd-arch@freebsd.org>
List-Help: <mailto:freebsd-arch-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-arch>,
	<mailto:freebsd-arch-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 21 May 2003 16:19:06 -0000


On Wed, 21 May 2003, Jeff Roberson wrote:

> On Tue, 20 May 2003, Hiten Pandya wrote:
> 
> > Hi gang.
> >
> > I have written a manual page for the Asynchronous Logging Queues (ALQ)
> > facility, available in FreeBSD 5.x.  I have been trying to reach Jeff by
> > various methods of contact (IRC, mail etc) but I have not had a response
> > from him.
> >
> <...>
> The second sentence in the section describing alq_open() is a little bit
> confusing.  Please considering breaking it up.

Another thing that probably needs to appear in the man page is that the
credential associated with the thread invoking alq_open() is the
credential used to authorize the open().  Right now, alq_open() is invoked
only by a sysctl handler requiring privilege to invoke, so this is
fine--but the caller should be aware of this and avoid embaressing
circumstances (such as using a root privileged thread to open a queue on
behalf of an unprivileged process, etc). 

Robert N M Watson             FreeBSD Core Team, TrustedBSD Projects
robert@fledge.watson.org      Network Associates Laboratories