Vendor import TrustedBSD OpenBSM 1.0 alpha 14, with the following change

history notes since the last import:

OpenBSM 1.0 alpha 14

- Fix endian issues when processing IPv6 addresses for extended subject
  and process tokens.
- gcc41 warnings clean.
- Teach audit_submit(3) about getaudit_addr(2).
- Add support for zonename tokens.

OpenBSM 1.0 alpha 13

- compat/clock_gettime.h now provides a compatibility implementation of
  clock_gettime(), which fixes building on Mac OS X.
- Countless man page improvements, markup fixes, content fixs, etc.
- XML printing support via "praudit -x".
- audit.log.5 expanded to include additional BSM token types.
- Added encoding and decoding routines for process64_ex, process32_ex,
  subject32_ex, header64, and attr64 tokens.
- Additional audit event identifiers for listen, mlockall/munlockall,
  getpath, POSIX message queues, and mandatory access control.

Approved by:	re (bmah)
MFC after:	3 weeks
Obtained from:	TrustedBSD Project

1 files changed, 17 insertions, 11 deletions

diff --git a/contrib/openbsm/libbsm/audit_submit.3 b/contrib/openbsm/libbsm/audit_submit.3
index 9e4d230..46cb217 100644
--- a/contrib/openbsm/libbsm/audit_submit.3
+++ b/contrib/openbsm/libbsm/audit_submit.3
@@ -27,23 +27,26 @@
 .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\" $P4: //depot/projects/trustedbsd/openbsm/libbsm/audit_submit.3#8 $
+.\" $P4: //depot/projects/trustedbsd/openbsm/libbsm/audit_submit.3#11 $
 .\"
 .Dd May 29, 2006
 .Dt audit_submit 3
 .Os
 .Sh NAME
 .Nm audit_submit
-.Nd general purpose audit record submission
+.Nd "general purpose audit record submission"
 .Sh LIBRARY
 .Lb libbsm
 .Sh SYNOPSIS
-.In stdio.h
+.In bsm/libbsm.h
 .Ft int
-.Fn audit_submit "short au_event" "au_id_t auid" "char status" "int reterr" "const char * restrict format" ...
+.Fo audit_submit
+.Fa "short au_event" "au_id_t auid" "char status"
+.Fa "int reterr" "const char * restrict format" ...
+.Fc
 .Sh DESCRIPTION
 The
-.Nm
+.Fn audit_submit
 function provides a generic programming interface for audit record submission.
 This audit record will contain a header, subject token, an optional text token,
 return token, and a trailer.
@@ -66,14 +69,16 @@ variable-length argument facilities of
 are converted for output.
 If
 .Fa format
-is NULL, then no text token is created in the audit record.
+is
+.Dv NULL ,
+then no text token is created in the audit record.
 .Pp
 It should be noted that
-.Nm
+.Fn audit_submit
 assumes that
 .Xr setaudit 2 ,
 or
-.Xr setaudit_addr 2 
+.Xr setaudit_addr 2
 has already been called.
 As a direct result, the terminal ID for the
 subject will be retrieved from the kernel via
@@ -116,11 +121,12 @@ trailer,94
 .Xr stdarg 3
 .Sh HISTORY
 The
-.Nm
+.Fn audit_submit
 function first appeared in OpenBSM version 1.0.
-OpenBSM 1.0 was introduced in FreeBSD 7.0.
+OpenBSM 1.0 was introduced in
+.Fx 7.0 .
 .Sh AUTHORS
 The
-.Nm
+.Fn audit_submit
 function was written by
 .An Christian S.J. Peron Aq csjp@FreeBSD.org .