Debian Codegraph @

upstream/debian-trixie/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
6 .B #include <libaudit.h>
7 .sp
8 int audit_request_status(int fd);
9
10 .SH "DESCRIPTION"
11
12 .PP
13 audit_request_status requests that the kernel send status structure describing various settings. The audit_status structure is as follows:
14
15 .RS
16 .ta 4n 10n 24n
17 .nf
18
19 struct audit_status {
20 __u32 mask; /* Bit mask for valid entries */
21 __u32 enabled; /* 1 = enabled, 0 = disabled */
22 __u32 failure; /* Failure-to-log action */
23 __u32 pid; /* pid of auditd process */
24 __u32 rate_limit; /* messages rate limit (per second) */
25 __u32 backlog_limit; /* waiting messages limit */
26 __u32 lost; /* messages lost */
27 __u32 backlog; /* messages waiting in queue */
28 };
29 .fi
30 .ta
31 .RE
32
33 .SH "RETURN VALUE"
34
35 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.
36
37 .SH "SEE ALSO"
38
39 .BR audit_open (3),
40 .BR audit_get_reply (3),
41 .BR auditd (8).
42
43 .SH AUTHOR
44 Steve Grubb