Debian Codegraph @

docs/audit_reset_backlog_wait_time_actual.3

raw
1 .TH "AUDIT_RESET_BACKLOG_WAIT_TIME_ACTUAL" "3" "July 2025" "Red Hat" "Linux Audit API"
2 .SH NAME
3 audit_reset_backlog_wait_time_actual \- reset backlog wait time actual counter
4 .SH SYNOPSIS
5 .B #include <libaudit.h>
6 .sp
7 .BI "int audit_reset_backlog_wait_time_actual(int " fd ");"
8 .SH DESCRIPTION
9 .BR audit_reset_backlog_wait_time_actual ()
10 resets the kernel's running total of how long system calls have waited for
11 space in the audit event queue. The
12 .I fd
13 must be an open audit netlink socket. This call is useful when administrators
14 enable backlog waiting via the
15 .BR audit_set_backlog_wait_time (3)
16 option to preserve events in tight memory situations. Periodically clearing
17 the counter allows detection of renewed backlog waiting after changing the
18 queue size or wait time. The kernel must support the
19 .BR AUDIT_STATUS_BACKLOG_WAIT_TIME_ACTUAL
20 field for this call to succeed.
21 .SH RETURN VALUE
22 The return value is <= 0 on error, otherwise it is the netlink sequence id number.
23 .SH SEE ALSO
24 .BR audit_set_backlog_wait_time (3),
25 .BR audit_open (3),
26 .BR auditctl (8).
27 .SH AUTHOR
28 Steve Grubb