PERFORCE change 152893 for review
Robert Watson
rwatson at FreeBSD.org
Wed Nov 12 12:35:55 PST 2008
http://perforce.freebsd.org/chv.cgi?CH=152893
Change 152893 by rwatson at 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.
More information about the p4-projects
mailing list