Date: Wed, 21 May 2003 00:57:10 -0400 (EDT) From: Jeff Roberson <jroberson@chesapeake.net> To: Hiten Pandya <hmp@FreeBSD.ORG> Cc: des@FreeBSD.ORG Subject: Re: ALQ manual page review Message-ID: <20030521004947.X52717-100000@mail.chesapeake.net> In-Reply-To: <20030520203418.GA92706@perrin.int.nxad.com>
next in thread | previous in thread | raw e-mail | index | archive | help
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. > Sorry Hiten, I'm pretty well occupied lately. I was just telling mini that I need to get back to you on this. Anyway, I have a few comments. The ae_flags are for internal use only. Consumers of the API should not modify them. The second sentence in the section describing alq_open() is a little bit confusing. Please considering breaking it up. You should probably say 'with the "alqget" wait message'. The wait channel is not so important to the consumer of the API. You might want to go into a little detail about how alq_get() and alq_post() are intended as a more effecient way to do alq_write(). They save the memcpy into the ale. Thanks! Jeff > Viewing copy is available: > > http://people.FreeBSD.ORG/~hmp/manpages/alq.9.pdf > http://people.FreeBSD.ORG/~hmp/manpages/alq.9.txt > > Groff copy of the manual page: > > http://people.FreeBSD.ORG/~hmp/manpages/alq.9 > > The manual page has been reviewed by my mentor (des@). > Commands and suggestions welcome. > > Thanking in anticipation. > > -- Hiten (hmp@FreeBSD.ORG) >
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030521004947.X52717-100000>