From owner-cvs-all Sun Jan 10 21:02:50 1999 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id VAA03558 for cvs-all-outgoing; Sun, 10 Jan 1999 21:02:50 -0800 (PST) (envelope-from owner-cvs-all@FreeBSD.ORG) Received: from dingo.cdrom.com (castles351.castles.com [208.214.167.51]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id VAA03550 for ; Sun, 10 Jan 1999 21:02:47 -0800 (PST) (envelope-from mike@dingo.cdrom.com) Received: from dingo.cdrom.com (LOCALHOST [127.0.0.1]) by dingo.cdrom.com (8.9.1/8.8.8) with ESMTP id UAA86420; Sun, 10 Jan 1999 20:58:54 -0800 (PST) (envelope-from mike@dingo.cdrom.com) Message-Id: <199901110458.UAA86420@dingo.cdrom.com> X-Mailer: exmh version 2.0.2 2/24/98 To: Brian Somers cc: Mike Smith , committers@FreeBSD.ORG Subject: Re: sysctl descriptions In-reply-to: Your message of "Sun, 10 Jan 1999 21:49:43 GMT." <199901102149.VAA00631@keep.lan.Awfulhak.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Date: Sun, 10 Jan 1999 20:58:53 -0800 From: Mike Smith Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk > > > FWIW, I back Pouls opinion. What's so special about sysctls that > > > makes them even need the description field in the first place - let > > > alone actually compiling it in ? > > > > What's special about them is that they are the presentation form of > > kernel tunable values. They're fronted directly to the user. > > I don't see what the difference is between the use of sysctl and the > use of say kbdcontrol or mixer. That's fairly obvious. > If I want to find out how to use the > stuff that mixer changes, I ``man mixer''. Sysctl tweaks the way the > kernel behaves. If I want information, I ``man sysctl''. That's because what mixer and vidcontrol do is directly related to the programs; they derive no metainformation from the kernel. OTOH, sysctl is just a framework for manipulating data using metadata derived from the kernel. > The point is that the sysctl documentation should be found in the > same place as the rest of the system documentation. Since it's quite clear you really haven't grasped the core of the problem, I'll present you with a simple example, and you can explain to me how you propose to deal with it. I have a driver for a new peripheral. It's from a vendor that doesn't want to distribute source code, so the driver comes as a KLD module. The driver has a number of tuning options, which are exposed via the sysctl MIB. Please explain how I am to find documentation for these tuning options in the system manpages. Suggest how your approach is better than, for example, being able to directly ascertain what it is that the tuning options do using the same tool that I plan to use to adjust them. -- \\ Sometimes you're ahead, \\ Mike Smith \\ sometimes you're behind. \\ mike@smith.net.au \\ The race is long, and in the \\ msmith@freebsd.org \\ end it's only with yourself. \\ msmith@cdrom.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message