Date: Wed, 12 Nov 2008 20:35:54 GMT From: Robert Watson <rwatson@FreeBSD.org> To: Perforce Change Reviews <perforce@freebsd.org> Subject: PERFORCE change 152893 for review Message-ID: <200811122035.mACKZsw3063617@repoman.freebsd.org>
next in thread | raw e-mail | index | archive | help
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.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200811122035.mACKZsw3063617>