Debian Codegraph @

upstream/debian-unstable/man3/audit_request_status.3

raw
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