Re: Call for testing: emu10kx driver for Creative sound cards

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 ,