From owner-p4-projects@FreeBSD.ORG Wed Nov 12 20:35:55 2008 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id 3CC8B1065679; Wed, 12 Nov 2008 20:35:55 +0000 (UTC) Delivered-To: perforce@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 001C51065670 for ; Wed, 12 Nov 2008 20:35:54 +0000 (UTC) (envelope-from bb+lists.freebsd.perforce@cyrus.watson.org) Received: from repoman.freebsd.org (repoman.freebsd.org [IPv6:2001:4f8:fff6::29]) by mx1.freebsd.org (Postfix) with ESMTP id DFCC68FC28 for ; Wed, 12 Nov 2008 20:35:54 +0000 (UTC) (envelope-from bb+lists.freebsd.perforce@cyrus.watson.org) Received: from repoman.freebsd.org (localhost [127.0.0.1]) by repoman.freebsd.org (8.14.3/8.14.3) with ESMTP id mACKZsAR063619 for ; Wed, 12 Nov 2008 20:35:54 GMT (envelope-from bb+lists.freebsd.perforce@cyrus.watson.org) Received: (from perforce@localhost) by repoman.freebsd.org (8.14.3/8.14.3/Submit) id mACKZsw3063617 for perforce@freebsd.org; Wed, 12 Nov 2008 20:35:54 GMT (envelope-from bb+lists.freebsd.perforce@cyrus.watson.org) Date: Wed, 12 Nov 2008 20:35:54 GMT Message-Id: <200811122035.mACKZsw3063617@repoman.freebsd.org> X-Authentication-Warning: repoman.freebsd.org: perforce set sender to bb+lists.freebsd.perforce@cyrus.watson.org using -f From: Robert Watson To: Perforce Change Reviews Cc: Subject: PERFORCE change 152893 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: Wed, 12 Nov 2008 20:35:55 -0000 http://perforce.freebsd.org/chv.cgi?CH=152893 Change 152893 by rwatson@rwatson_cinnamon on 2008/11/12 20:35:13 Add man page for au_bsm_to_errno() and au_errno_to_bsm(). Affected files ... .. //depot/projects/trustedbsd/openbsm/libbsm/Makefile.am#7 edit .. //depot/projects/trustedbsd/openbsm/libbsm/Makefile.in#11 edit .. //depot/projects/trustedbsd/openbsm/libbsm/au_errno.3#1 add .. //depot/projects/trustedbsd/openbsm/libbsm/au_token.3#16 edit .. //depot/projects/trustedbsd/openbsm/libbsm/libbsm.3#14 edit Differences ... ==== //depot/projects/trustedbsd/openbsm/libbsm/Makefile.am#7 (text+ko) ==== @@ -1,5 +1,5 @@ # -# $P4: //depot/projects/trustedbsd/openbsm/libbsm/Makefile.am#6 $ +# $P4: //depot/projects/trustedbsd/openbsm/libbsm/Makefile.am#7 $ # if USE_NATIVE_INCLUDES @@ -31,6 +31,7 @@ man3_MANS = \ au_class.3 \ au_control.3 \ + au_errno.3 \ au_event.3 \ au_free_token.3 \ au_io.3 \ ==== //depot/projects/trustedbsd/openbsm/libbsm/Makefile.in#11 (text+ko) ==== @@ -15,7 +15,7 @@ @SET_MAKE@ # -# $P4: //depot/projects/trustedbsd/openbsm/libbsm/Makefile.in#10 $ +# $P4: //depot/projects/trustedbsd/openbsm/libbsm/Makefile.in#11 $ # VPATH = @srcdir@ @@ -205,6 +205,7 @@ man3_MANS = \ au_class.3 \ au_control.3 \ + au_errno.3 \ au_event.3 \ au_free_token.3 \ au_io.3 \ ==== //depot/projects/trustedbsd/openbsm/libbsm/au_token.3#16 (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_token.3#15 $ +.\" $P4: //depot/projects/trustedbsd/openbsm/libbsm/au_token.3#16 $ .\" .Dd April 19, 2005 .Dt AU_TOKEN 3 @@ -209,6 +209,15 @@ These interfaces support the allocation of BSM audit tokens, represented by .Vt token_t , for various data types. +.Pp +.Xr au_errno_to_bsm 3 +must be used to convert local +.Xr errno 2 +errors to BSM error numbers before they are passed to +.Fn au_to_return , +.Fn au_to_return32 , +and +.Fn au_to_return64 . .Sh RETURN VALUES On success, a pointer to a .Vt token_t @@ -221,6 +230,7 @@ will be returned, and an error condition returned via .Va errno . .Sh SEE ALSO +.Xr au_errno_to_bsm 3 , .Xr libbsm 3 .Sh HISTORY The OpenBSM implementation was created by McAfee Research, the security ==== //depot/projects/trustedbsd/openbsm/libbsm/libbsm.3#14 (text+ko) ==== @@ -23,9 +23,9 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $P4: //depot/projects/trustedbsd/openbsm/libbsm/libbsm.3#13 $ +.\" $P4: //depot/projects/trustedbsd/openbsm/libbsm/libbsm.3#14 $ .\" -.Dd April 19, 2005 +.Dd November 12, 2008 .Dt LIBBSM 3 .Os .Sh NAME @@ -201,6 +201,12 @@ .Xr au_user 3 , .Xr audit_class 5 , .Xr audit_control 5 +.Ss Audit Error Interfaces +These functions convert between BSM and local +.Xr errno 2 +error numbers, and must be used to interpret and generate BSM return tokens: +.Xr au_bsm_to_errno 3 , +.Xr au_errno_to_bsm 3 . .Sh HISTORY The OpenBSM implementation was created by McAfee Research, the security division of McAfee Inc., under contract to Apple Computer, Inc., in 2004.