Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 29 Jul 2001 10:16:42 +0930
From:      Greg Lehey <grog@FreeBSD.org>
To:        Warner Losh <imp@harmony.village.org>
Cc:        Brooks Davis <brooks@one-eyed-alien.net>, Mike Smith <msmith@FreeBSD.org>, Peter Wemm <peter@wemm.org>, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org
Subject:   Re: cvs commit: src/sys/conf param.c src/sys/kern subr_param.c kern_mib.c src/sys/sys systm.h
Message-ID:  <20010729101642.D68202@wantadilla.lemis.com>
In-Reply-To: <200107282249.f6SMnLw25589@harmony.village.org>; from imp@harmony.village.org on Sat, Jul 28, 2001 at 04:49:21PM -0600
References:  <20010728140844.B27582@Odin.AC.HMC.Edu> <20010727162625.7262738FE@overcee.netplex.com.au> <200107282058.f6SKvwJ02435@mass.dis.org> <20010728140844.B27582@Odin.AC.HMC.Edu> <200107282249.f6SMnLw25589@harmony.village.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On Saturday, 28 July 2001 at 16:49:21 -0600, Warner Losh wrote:
> In message <20010728140844.B27582@Odin.AC.HMC.Edu> Brooks Davis writes:
>> One suggestion here.  It would be nice if this file listed every tunable
>> even if they are documented elseware.  Just a simple "see pcic(4)" or
>> was ever would be nice.  That way there's one place to start when you
>> go "WTF is this hw.ata.wc thing?"
>
> Well, there's always:
>
> hw.ata
> 	see ata(4)
>
> hw.pcic
> 	see pcic(4)
>
> hw.something-else
> 	The something else option controls when something happens.

It does seem to make sense to have a cross-reference in sysctl(8).  I
think it needs to be more than this level, too.  More like:

hw.ata	          sysctls relating to the ATA driver.  See ata(4).
hw.ata.ata_dma	  Control DMA transfers.
hw.ata.wc	  Control write caching
hw.ata.tags	  Control tagged queueing
hw.ata.atapi_dma  Control DMA for ATAPI CD-ROMs.

etc.  Just referring to another man page doesn't give an adequate
overview.

Greg
--
See complete headers for address and phone numbers

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010729101642.D68202>