From owner-freebsd-current@FreeBSD.ORG  Wed Nov  3 21:56:11 2010
Return-Path: <owner-freebsd-current@FreeBSD.ORG>
Delivered-To: freebsd-current@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 631B21065672;
	Wed,  3 Nov 2010 21:56:11 +0000 (UTC)
	(envelope-from rmacklem@uoguelph.ca)
Received: from esa-annu.mail.uoguelph.ca (esa-annu.mail.uoguelph.ca
	[131.104.91.36])
	by mx1.freebsd.org (Postfix) with ESMTP id 904098FC08;
	Wed,  3 Nov 2010 21:56:10 +0000 (UTC)
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: ApwEAK920UyDaFvO/2dsb2JhbACDI583r1mRGIEigzFzBIUPhUaFCg
X-IronPort-AV: E=Sophos;i="4.58,291,1286164800"; d="scan'208";a="97701904"
Received: from erie.cs.uoguelph.ca (HELO zcs3.mail.uoguelph.ca)
	([131.104.91.206])
	by esa-annu-pri.mail.uoguelph.ca with ESMTP; 03 Nov 2010 17:56:09 -0400
Received: from zcs3.mail.uoguelph.ca (localhost.localdomain [127.0.0.1])
	by zcs3.mail.uoguelph.ca (Postfix) with ESMTP id 1E324B3F50;
	Wed,  3 Nov 2010 17:56:09 -0400 (EDT)
Date: Wed, 3 Nov 2010 17:56:09 -0400 (EDT)
From: Rick Macklem <rmacklem@uoguelph.ca>
To: John Baldwin <jhb@freebsd.org>
Message-ID: <1467533946.56814.1288821369058.JavaMail.root@erie.cs.uoguelph.ca>
In-Reply-To: <201011031317.36332.jhb@freebsd.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
X-Originating-IP: [99.225.56.115]
X-Mailer: Zimbra 6.0.7_GA_2476.RHEL4 (ZimbraWebClient - IE8
	(Win)/6.0.7_GA_2473.RHEL4_64)
Cc: mdf@freebsd.org, freebsd-current@freebsd.org,
	Andriy Gapon <avg@icyb.net.ua>
Subject: Re: MTX_DEF versus MTX_SPIN
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, 03 Nov 2010 21:56:11 -0000

> 
> > Is there any documentation on best practices for writing a FreeBSD
> > driver?
> 
> Not really. :-/
> 
Just a dumb obvious suggestion. Imho, there is no better doc. than some
well written code, so maybe someone familiar with the drivers can suggest
one (or two) that they consider well written and use the current conventions
as "examples"?

rick, who never trusts documentation anyhow;-)