From owner-freebsd-current@FreeBSD.ORG Tue May 23 21:58:35 2006 Return-Path: X-Original-To: freebsd-current@FreeBSD.org Delivered-To: freebsd-current@FreeBSD.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8872016A988; Tue, 23 May 2006 21:58:35 +0000 (UTC) (envelope-from imp@bsdimp.com) Received: from harmony.bsdimp.com (vc4-2-0-87.dsl.netrack.net [199.45.160.85]) by mx1.FreeBSD.org (Postfix) with ESMTP id 289FF43D45; Tue, 23 May 2006 21:58:35 +0000 (GMT) (envelope-from imp@bsdimp.com) Received: from localhost (localhost.village.org [IPv6:::1] (may be forged)) by harmony.bsdimp.com (8.13.4/8.13.4) with ESMTP id k4NLu7SO095905; Tue, 23 May 2006 15:56:07 -0600 (MDT) (envelope-from imp@bsdimp.com) Date: Tue, 23 May 2006 15:56:06 -0600 (MDT) Message-Id: <20060523.155606.71179350.imp@bsdimp.com> To: scottl@samsco.org From: Warner Losh In-Reply-To: <20060523.134540.28877846.imp@bsdimp.com> References: <44735620.9080403@samsco.org> <20060523.132355.21838169.imp@bsdimp.com> <20060523.134540.28877846.imp@bsdimp.com> X-Mailer: Mew version 3.3 on Emacs 21.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Cc: freebsd-multimedia@FreeBSD.org, des@des.no, freebsd-current@FreeBSD.org, Alexander@Leidinger.net Subject: Re: Call for testing: emu10kx driver for Creative sound cards X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 23 May 2006 21:58:38 -0000 This is what I'm thinking of adding to the sysctl.8 man page. Please let me know if there's a better place for it. This is indented to be the initial proposal for sysctl use by drivers, so if the results of discussions change it, I'll update. Warner Index: sysctl.8 =================================================================== RCS file: /home/imp/FreeBSD/CVS/src/sbin/sysctl/sysctl.8,v retrieving revision 1.60 diff -c -r1.60 sysctl.8 *** sysctl.8 18 Nov 2005 10:32:12 -0000 1.60 --- sysctl.8 23 May 2006 21:53:11 -0000 *************** *** 292,297 **** --- 292,311 ---- The .Fl w option has been deprecated and is silently ignored. + .Pp + Sysctl nodes provided by drivers should not be considered to be + permanant unless they are documented in the driver's man page. + Names which start with _ denote a tree or node which is considered + impermanant and should not be relied up by code elsewhere in the + system. + Driver writers should use the sysctl infrastructure provided by + .Xr device_get_sysctl_ctx 9 + and + .Xr device_get_sysctl_tree 9 + for their sysctls. + Drivers should migrate from past interfaces to this new interface, but + provide, where needed, backwards compatibility shims. + These facilities export the sysctl as dev...attribute. .Sh SEE ALSO .Xr sysctl 3 , .Xr loader.conf 5 ,