Call for testing: emu10kx driver for Creative sound cards
imp at bsdimp.com
Tue May 23 21:58:39 UTC 2006
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.
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 ----
option has been deprecated and is silently ignored.
+ 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
+ Driver writers should use the sysctl infrastructure provided by
+ .Xr device_get_sysctl_ctx 9
+ .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 ,
More information about the freebsd-multimedia