From owner-freebsd-current  Tue Apr 17  0:38:51 2001
Delivered-To: freebsd-current@freebsd.org
Received: from bsdone.bsdwins.com (www.bsdwins.com [192.58.184.33])
	by hub.freebsd.org (Postfix) with ESMTP id 60EF737B422
	for <freebsd-current@FreeBSD.ORG>; Tue, 17 Apr 2001 00:38:48 -0700 (PDT)
	(envelope-from jwd@bsdwins.com)
Received: (from jwd@localhost)
	by bsdone.bsdwins.com (8.11.1/8.11.0) id f3H7c6o40747;
	Tue, 17 Apr 2001 03:38:06 -0400 (EDT)
	(envelope-from jwd)
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>
References: <20010415222637.A507@FreeBSD.org> <200104170209.WAA02683@khavrinen.lcs.mit.edu>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
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
Sender: owner-freebsd-current@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.ORG

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