From owner-p4-projects@FreeBSD.ORG Sun Mar 5 09:34:18 2006 Return-Path: X-Original-To: p4-projects@freebsd.org Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id B30AA16A423; Sun, 5 Mar 2006 09:34:17 +0000 (GMT) X-Original-To: perforce@freebsd.org Delivered-To: perforce@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 80BE016A420 for ; Sun, 5 Mar 2006 09:34:17 +0000 (GMT) (envelope-from brueffer@freebsd.org) Received: from repoman.freebsd.org (repoman.freebsd.org [216.136.204.115]) by mx1.FreeBSD.org (Postfix) with ESMTP id 49FD643D49 for ; Sun, 5 Mar 2006 09:34:17 +0000 (GMT) (envelope-from brueffer@freebsd.org) Received: from repoman.freebsd.org (localhost [127.0.0.1]) by repoman.freebsd.org (8.13.1/8.13.1) with ESMTP id k259YHke038740 for ; Sun, 5 Mar 2006 09:34:17 GMT (envelope-from brueffer@freebsd.org) Received: (from perforce@localhost) by repoman.freebsd.org (8.13.1/8.13.1/Submit) id k259YHh0038737 for perforce@freebsd.org; Sun, 5 Mar 2006 09:34:17 GMT (envelope-from brueffer@freebsd.org) Date: Sun, 5 Mar 2006 09:34:17 GMT Message-Id: <200603050934.k259YHh0038737@repoman.freebsd.org> X-Authentication-Warning: repoman.freebsd.org: perforce set sender to brueffer@freebsd.org using -f From: Christian Brueffer To: Perforce Change Reviews Cc: Subject: PERFORCE change 92770 for review X-BeenThere: p4-projects@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: p4 projects tree changes List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 05 Mar 2006 09:34:18 -0000 http://perforce.freebsd.org/chv.cgi?CH=92770 Change 92770 by brueffer@brueffer_serenity on 2006/03/05 09:33:24 Fixes. Affected files ... .. //depot/projects/trustedbsd/openbsm/libbsm/au_open.3#3 edit Differences ... ==== //depot/projects/trustedbsd/openbsm/libbsm/au_open.3#3 (text+ko) ==== @@ -23,7 +23,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $P4: //depot/projects/trustedbsd/openbsm/libbsm/au_open.3#2 $ +.\" $P4: //depot/projects/trustedbsd/openbsm/libbsm/au_open.3#3 $ .\" .Dd March 4, 2006 .Dt AU_OPEN 3 @@ -66,8 +66,8 @@ .Pp The .Fn au_close -is used to commit an audit record to the system audit log, or abandon the -record. +function is used to commit an audit record to the system audit log, or +abandon the record. In either cases, all resources associated with the record will be released. The .Va keep @@ -82,6 +82,7 @@ and a trailer added to the end. Committing a record to the system audit log requires privilege. .Pp +The .Fn au_close_buffer function writes the resulting record to an in-memory buffer of size .Va *buflen ; @@ -93,7 +94,7 @@ The function .Fn au_open returns a non-negative audit record descriptor number on success, or a -negative value on failure, along with error information in. +negative value on failure, along with error information in .Va errno . .Pp The functions @@ -119,7 +120,7 @@ It was subsequently adopted by the TrustedBSD Project as the foundation for the OpenBSM distribution. .Sh BUGS -There is currently no interface to extract a single token without wrapping +There is currently no interface to extract a single token without it being automatically wrapped in a header and trailer. .Pp Currently, @@ -134,4 +135,4 @@ .Fn au_open would reserve resources necessary to commit any submitted record, releasing them on -.Fn au_close. +.Fn au_close .