Skip site navigation (1)Skip section navigation (2)
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>