Date: Tue, 23 May 2006 15:56:06 -0600 (MDT) From: Warner Losh <imp@bsdimp.com> To: scottl@samsco.org 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 Message-ID: <20060523.155606.71179350.imp@bsdimp.com> 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>
next in thread | previous in thread | raw e-mail | index | archive | help
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.<driver-name>.<unit>.attribute. .Sh SEE ALSO .Xr sysctl 3 , .Xr loader.conf 5 ,
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20060523.155606.71179350.imp>