From owner-svn-src-all@FreeBSD.ORG  Wed Jan 26 09:37:14 2011
Return-Path: <owner-svn-src-all@FreeBSD.ORG>
Delivered-To: svn-src-all@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id A81021065670;
	Wed, 26 Jan 2011 09:37:14 +0000 (UTC)
	(envelope-from rwatson@FreeBSD.org)
Received: from cyrus.watson.org (cyrus.watson.org [65.122.17.42])
	by mx1.freebsd.org (Postfix) with ESMTP id 848598FC1A;
	Wed, 26 Jan 2011 09:37:14 +0000 (UTC)
Received: from fledge.watson.org (fledge.watson.org [65.122.17.41])
	by cyrus.watson.org (Postfix) with ESMTPS id E122746B8A;
	Wed, 26 Jan 2011 04:37:13 -0500 (EST)
Date: Wed, 26 Jan 2011 09:37:13 +0000 (GMT)
From: Robert Watson <rwatson@FreeBSD.org>
X-X-Sender: robert@fledge.watson.org
To: Matthew D Fleming <mdf@FreeBSD.org>
In-Reply-To: <201101251739.p0PHdqKX044842@svn.freebsd.org>
Message-ID: <alpine.BSF.2.00.1101260929430.44308@fledge.watson.org>
References: <201101251739.p0PHdqKX044842@svn.freebsd.org>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
Cc: svn-src-head@freebsd.org, svn-src-all@freebsd.org,
	src-committers@freebsd.org
Subject: Re: svn commit: r217830 - head/share/man/man9
X-BeenThere: svn-src-all@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "SVN commit messages for the entire src tree \(except for &quot;
	user&quot; and &quot; projects&quot; \)" <svn-src-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-all>,
	<mailto:svn-src-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-all>
List-Post: <mailto:svn-src-all@freebsd.org>
List-Help: <mailto:svn-src-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-all>,
	<mailto:svn-src-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 26 Jan 2011 09:37:14 -0000

On Tue, 25 Jan 2011, Matthew D Fleming wrote:

> .Dv SBUF_AUTOEXTEND .
> .Pp
> The
> +.Fn sbuf_new_for_sysctl
> +function will set up an sbuf with a drain function to use
> +.Fn SYSCTL_OUT
> +when the internal buffer fills.
> +The sysctl old buffer will be wired, which allows for doing an
> +.Fn sbuf_printf
> +while holding a mutex.
> +.Pp
> +The
> .Fn sbuf_delete
> function clears the
> .Fa sbuf

Hmm.  Is this description missing mention of how wiring failures are handled? 
(Also, it should probably mention that this call can sleep for potentially 
quite long periods of time, even if sbuf_printf (and friends) can't).

Robert