PERFORCE change 75877 for review
rwatson at FreeBSD.org
Sun Apr 24 14:26:01 GMT 2005
Change 75877 by rwatson at rwatson_paprika on 2005/04/24 14:25:15
Merge in additional man page contents from the version of audit.2
found in the trustedbsd_audit3 tree.
Pointed out by: wsalamon
Affected files ...
.. //depot/projects/trustedbsd/openbsm/man/audit.2#2 edit
==== //depot/projects/trustedbsd/openbsm/man/audit.2#2 (text+ko) ====
@@ -1,4 +1,4 @@
+.\" Copyright (c) 2005 Tom Rhodes
.\" Copyright (c) 2005 Robert N. M. Watson
.\" All rights reserved.
@@ -10,7 +10,7 @@
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
@@ -37,19 +37,32 @@
.Fn audit "const char *record" "u_int length"
-submits a completed BSM audit record,
-pointed to by
-bytes, to the system audit log.
+submits a completed BSM audit record to the system audit log.
-This system call required appropriate privilege to complete.
+is a pointer to the the specific event to be recorded and
+is the size in bytes of the data to be written.
.Sh RETURN VALUES
-returns 0 on success, or returns -1 on failure, providing additional error
-.Va errno .
+system call will fail and the data never written if:
+.Bl -tag -width Er
+.It Bq Er EFAULT
+argument is beyond the allocated address space of the process.
+.It Bq Er EINVAL
+The token ID is invalid or
+is larger than
+.Vt MAXAUDITDATA .
+.It Bq Er EPERM
+The process does not have sufficient permission to complete
.Sh SEE ALSO
.Xr auditon 2 ,
.Xr getauid 2 ,
@@ -66,11 +79,19 @@
The Basic Security Module (BSM) interface to audit records and audit event
stream format were defined by Sun Microsystems.
+This manual page was written by
+.An Tom Rhodes Aq trhodes at FreeBSD.org .
The OpenBSM implementation was created by McAfee Research, the security
division of McAfee Inc., under contract to Apple Computer Inc. in 1994.
It was subsequently adopted by the TrustedBSD Project as the foundation for
the OpenBSM distribution.
+function first appeared in
To Unsubscribe: send mail to majordomo at trustedbsd.org
with "unsubscribe trustedbsd-cvs" in the body of the message
More information about the trustedbsd-cvs