From owner-freebsd-current@FreeBSD.ORG  Wed May 24 15:29:02 2006
Return-Path: <owner-freebsd-current@FreeBSD.ORG>
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 B99DA16A7B5;
	Wed, 24 May 2006 15:29:02 +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 6DAE143D88;
	Wed, 24 May 2006 15:28:49 +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 k4OFR0SU011266;
	Wed, 24 May 2006 09:27:00 -0600 (MDT) (envelope-from imp@bsdimp.com)
Date: Wed, 24 May 2006 09:26:59 -0600 (MDT)
Message-Id: <20060524.092659.74738447.imp@bsdimp.com>
To: Yuriy.Tsibizov@gfk.ru
From: Warner Losh <imp@bsdimp.com>
In-Reply-To: <D6B2C454E5A77B4D8DA0B863D3D6D492CC3458@demon.hhp.local>
References: <D6B2C454E5A77B4D8DA0B863D3D6D492CC3458@demon.hhp.local>
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
	<freebsd-current.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>, 
	<mailto:freebsd-current-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-current>
List-Post: <mailto:freebsd-current@freebsd.org>
List-Help: <mailto:freebsd-current-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>,
	<mailto:freebsd-current-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 24 May 2006 15:29:04 -0000

From: "Yuriy Tsibizov" <Yuriy.Tsibizov@gfk.ru>
Subject: RE: Call for testing: emu10kx driver for Creative sound cards
Date: Wed, 24 May 2006 14:39:57 +0400

> > + .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.
> 
> Should sound drivers (pcm* device) be documented as an exception from this? 
> They use snd_sysctl_tree_top() to get tree OID under hw.snd.pcmX and 
> snd_sysctl_tree() to get their context.

No.  They should not.  They should provide the old compatibility stuff
in the old place, but also provide it in the correct place.

Warner