| 1 |
.TH "AUDIT_REQUEST_STATUS" "3" "Oct 2006" "Red Hat" "Linux Audit API" |
| 2 |
.SH NAME |
| 3 |
audit_request_status \- Request status of the audit system |
| 4 |
.SH "SYNOPSIS" |
| 5 |
.nf |
| 6 |
.B #include <libaudit.h> |
| 7 |
.PP |
| 8 |
.BI "int audit_request_status(int " fd );" |
| 9 |
.fi |
| 10 |
|
| 11 |
.SH "DESCRIPTION" |
| 12 |
|
| 13 |
.PP |
| 14 |
audit_request_status requests that the kernel send status structure describing various settings on the descriptor given in \fIfd\fP. The audit_status structure is as follows: |
| 15 |
|
| 16 |
.RS |
| 17 |
.ta 4n 10n 24n |
| 18 |
.nf |
| 19 |
|
| 20 |
struct audit_status { |
| 21 |
__u32 mask; /* Bit mask for valid entries */ |
| 22 |
__u32 enabled; /* 1 = enabled, 0 = disabled */ |
| 23 |
__u32 failure; /* Failure-to-log action */ |
| 24 |
__u32 pid; /* pid of auditd process */ |
| 25 |
__u32 rate_limit; /* messages rate limit (per second) */ |
| 26 |
__u32 backlog_limit; /* waiting messages limit */ |
| 27 |
__u32 lost; /* messages lost */ |
| 28 |
__u32 backlog; /* messages waiting in queue */ |
| 29 |
}; |
| 30 |
.fi |
| 31 |
.ta |
| 32 |
.RE |
| 33 |
|
| 34 |
.SH "RETURN VALUE" |
| 35 |
|
| 36 |
The return value is <= 0 on error, otherwise it is the netlink sequence id number. This function can have any error that sendto would encounter. |
| 37 |
|
| 38 |
.SH "SEE ALSO" |
| 39 |
|
| 40 |
.BR audit_open (3), |
| 41 |
.BR audit_get_reply (3), |
| 42 |
.BR auditd (8). |
| 43 |
|
| 44 |
.SH AUTHOR |
| 45 |
Steve Grubb |