audit_submit.3 (159248) | audit_submit.3 (168777) |
---|---|
1.\" 2.\" Copyright (c) 2006 Christian S.J. Peron 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" --- 13 unchanged lines hidden (view full) --- 22.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 26.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 27.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28.\" POSSIBILITY OF SUCH DAMAGE. 29.\" | 1.\" 2.\" Copyright (c) 2006 Christian S.J. Peron 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" --- 13 unchanged lines hidden (view full) --- 22.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 26.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 27.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28.\" POSSIBILITY OF SUCH DAMAGE. 29.\" |
30.\" $P4: //depot/projects/trustedbsd/openbsm/libbsm/audit_submit.3#8 $ | 30.\" $P4: //depot/projects/trustedbsd/openbsm/libbsm/audit_submit.3#11 $ |
31.\" 32.Dd May 29, 2006 33.Dt audit_submit 3 34.Os 35.Sh NAME 36.Nm audit_submit | 31.\" 32.Dd May 29, 2006 33.Dt audit_submit 3 34.Os 35.Sh NAME 36.Nm audit_submit |
37.Nd general purpose audit record submission | 37.Nd "general purpose audit record submission" |
38.Sh LIBRARY 39.Lb libbsm 40.Sh SYNOPSIS | 38.Sh LIBRARY 39.Lb libbsm 40.Sh SYNOPSIS |
41.In stdio.h | 41.In bsm/libbsm.h |
42.Ft int | 42.Ft int |
43.Fn audit_submit "short au_event" "au_id_t auid" "char status" "int reterr" "const char * restrict format" ... | 43.Fo audit_submit 44.Fa "short au_event" "au_id_t auid" "char status" 45.Fa "int reterr" "const char * restrict format" ... 46.Fc |
44.Sh DESCRIPTION 45The | 47.Sh DESCRIPTION 48The |
46.Nm | 49.Fn audit_submit |
47function provides a generic programming interface for audit record submission. 48This audit record will contain a header, subject token, an optional text token, 49return token, and a trailer. 50The header will contain the event class specified by 51.Fa au_event . 52The subject token will be generated based on 53.Fa au_ctx . 54The return token is dependant on the --- 6 unchanged lines hidden (view full) --- 61Text token output is under the control of a 62.Fa format 63string that specifies how subsequent arguments (or arguments accessed via the 64variable-length argument facilities of 65.Xr stdarg 3 ) 66are converted for output. 67If 68.Fa format | 50function provides a generic programming interface for audit record submission. 51This audit record will contain a header, subject token, an optional text token, 52return token, and a trailer. 53The header will contain the event class specified by 54.Fa au_event . 55The subject token will be generated based on 56.Fa au_ctx . 57The return token is dependant on the --- 6 unchanged lines hidden (view full) --- 64Text token output is under the control of a 65.Fa format 66string that specifies how subsequent arguments (or arguments accessed via the 67variable-length argument facilities of 68.Xr stdarg 3 ) 69are converted for output. 70If 71.Fa format |
69is NULL, then no text token is created in the audit record. | 72is 73.Dv NULL , 74then no text token is created in the audit record. |
70.Pp 71It should be noted that | 75.Pp 76It should be noted that |
72.Nm | 77.Fn audit_submit |
73assumes that 74.Xr setaudit 2 , 75or | 78assumes that 79.Xr setaudit 2 , 80or |
76.Xr setaudit_addr 2 | 81.Xr setaudit_addr 2 |
77has already been called. 78As a direct result, the terminal ID for the 79subject will be retrieved from the kernel via 80.Xr getaudit 2 , 81or 82.Xr getaudit_addr 2 . 83.Sh EXAMPLES 84.Bd -literal -offset indent --- 26 unchanged lines hidden (view full) --- 111.Ed 112.Sh SEE ALSO 113.Xr auditon 2 , 114.Xr getaudit 2 , 115.Xr libbsm 3 , 116.Xr stdarg 3 117.Sh HISTORY 118The | 82has already been called. 83As a direct result, the terminal ID for the 84subject will be retrieved from the kernel via 85.Xr getaudit 2 , 86or 87.Xr getaudit_addr 2 . 88.Sh EXAMPLES 89.Bd -literal -offset indent --- 26 unchanged lines hidden (view full) --- 116.Ed 117.Sh SEE ALSO 118.Xr auditon 2 , 119.Xr getaudit 2 , 120.Xr libbsm 3 , 121.Xr stdarg 3 122.Sh HISTORY 123The |
119.Nm | 124.Fn audit_submit |
120function first appeared in OpenBSM version 1.0. | 125function first appeared in OpenBSM version 1.0. |
121OpenBSM 1.0 was introduced in FreeBSD 7.0. | 126OpenBSM 1.0 was introduced in 127.Fx 7.0 . |
122.Sh AUTHORS 123The | 128.Sh AUTHORS 129The |
124.Nm | 130.Fn audit_submit |
125function was written by 126.An Christian S.J. Peron Aq csjp@FreeBSD.org . | 131function was written by 132.An Christian S.J. Peron Aq csjp@FreeBSD.org . |