From owner-freebsd-doc@FreeBSD.ORG  Fri Aug 25 17:37:36 2006
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: doc@FreeBSD.org
Delivered-To: freebsd-doc@FreeBSD.ORG
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id CE65716A4ED
	for <doc@FreeBSD.org>; Fri, 25 Aug 2006 17:37:36 +0000 (UTC)
	(envelope-from devon.odell@coyotepoint.com)
Received: from mail13.simplicato.com (mail13.simplicato.com [207.99.47.68])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 9E1EA43DAA
	for <doc@FreeBSD.org>; Fri, 25 Aug 2006 17:37:35 +0000 (GMT)
	(envelope-from devon.odell@coyotepoint.com)
Received: from mail13.simplicato.com (localhost [127.0.0.1])
	by mail13.simplicato.com (Postfix) with ESMTP id ACD7777AD39
	for <doc@FreeBSD.org>; Fri, 25 Aug 2006 13:37:34 -0400 (EDT)
Received: from [10.0.0.13] (dcha-205-231-27-066.taconic.net [205.231.27.66])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by mail13.simplicato.com (Postfix) with ESMTP id 7AA0577AD02
	for <doc@FreeBSD.org>; Fri, 25 Aug 2006 13:37:34 -0400 (EDT)
Message-ID: <44EF355D.5050208@coyotepoint.com>
Date: Fri, 25 Aug 2006 13:37:33 -0400
From: "Devon H. O'Dell" <devon.odell@coyotepoint.com>
User-Agent: Thunderbird 1.5 (X11/20060317)
MIME-Version: 1.0
To: doc@FreeBSD.org
Content-Type: multipart/mixed; boundary="------------080702060407090002080704"
Cc: 
Subject: Fix for ithread.9
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 25 Aug 2006 17:37:36 -0000

This is a multi-part message in MIME format.
--------------080702060407090002080704
Content-Type: text/plain; charset=ISO-8859-15; format=flowed
Content-Transfer-Encoding: 7bit

Hey All,

I was discussing UMA with Robert Watson yesterday; specifically its 
usage implications in an interrupt context. He suggested adding some 
information to ithread(9) specifying semantics for memory allocation in 
an interrupt context. So I came up with this tiny patch, shot it jhb@'s 
way, he reviewed it and told me to shoot it this way.

So here it is, apparently ready to be committed.

Thanks,

--dho

--------------080702060407090002080704
Content-Type: text/plain;
 name="interrupt_sleep.patch"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="interrupt_sleep.patch"

--- share/man/man9/ithread.9	Mon Jul  5 13:12:52 2004
+++ share/man/man9/ithread.9	Thu Aug 24 11:04:35 2006
@@ -202,6 +202,10 @@
 and
 .Dv INTR_ENTROPY
 flags are not valid for software interrupt handlers.
+.Pp
+It is not permitted to sleep in an interrupt thread; hence, any memory
+or zone allocations in an interrupt thread should be specified with the
+M_NOWAIT flag set. Any allocation errors must be handled thereafter.
 .Sh RETURN VALUES
 The
 .Fn ithread_add_handler ,
@@ -340,7 +344,9 @@
 .El
 .Sh SEE ALSO
 .Xr kthread 9 ,
-.Xr swi 9
+.Xr malloc 9 ,
+.Xr swi 9 ,
+.Xr uma 9
 .Sh HISTORY
 Interrupt threads and their corresponding API first appeared in
 .Fx 5.0 .

--------------080702060407090002080704--