Date: Tue, 17 Apr 2001 03:38:05 -0400 From: "John W. De Boskey" <jwd@bsdwins.com> To: Garrett Wollman <wollman@khavrinen.lcs.mit.edu> Cc: Current List <freebsd-current@FreeBSD.ORG> Subject: Re: FIO* doc added to tty.4 (review) Message-ID: <20010417033805.A40658@bsdwins.com> In-Reply-To: <200104170209.WAA02683@khavrinen.lcs.mit.edu>; from wollman@khavrinen.lcs.mit.edu on Mon, Apr 16, 2001 at 10:09:07PM -0400 References: <20010415222637.A507@FreeBSD.org> <200104170209.WAA02683@khavrinen.lcs.mit.edu>
next in thread | previous in thread | raw e-mail | index | archive | help
Hi,
I wondered about this. However, after looking around what
I found was that the FIO* requests seemed to be documented
in driver pages (and only a handful at that), and not
documented with ioctl.
Since I don't want to change the other existing driver
man pages, what if I add generic documentation to the
ioctl along with a comment saying to look at the individual
driver man pages for information specific to the driver.
ie: FIONREAD will succeed from a backgrounded process, but the
data read itself with hang (tty driver).
Thanks,
John
ps: Is cross-referencing #define values frowned upon? It would
be nice if "man -k FIONREAD" (for instance) would return
useful results.
----- Garrett Wollman's Original Message -----
> <<On Sun, 15 Apr 2001 22:26:37 -0700, "John W. De Boskey" <jwd@FreeBSD.ORG> said:
>
> > I've been doing some tty related work and found the FIO*
> > requests don't seem to be documented.
>
> > I've added some reasonable doc to tty.4 and put up the
> > the diff and html forms:
>
> As the initial letter suggests, they are generic file ioctls and not
> specific to the teletype driver. They should be described in the
> ioctl(2) manual page.
>
> -GAWollman
>
>
> To Unsubscribe: send mail to majordomo@FreeBSD.org
> with "unsubscribe freebsd-current" in the body of the message
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-current" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010417033805.A40658>