Debian Codegraph @

upstream/debian-unstable/man8/audisp-af_unix.8

raw
1 .TH AUDISP-AF_UNIX "8" "Aug 2025" "Red Hat" "System Administration Utilities"
2 .SH NAME
3 audisp-af_unix \- plugin to push audit events to an af_unix socket
4 .SH SYNOPSIS
5 .B audisp-af_unix
6 [ \fIOPTIONS\fP ]
7 .SH DESCRIPTION
8 \fBaudisp-af_unix\fP is a plugin for the audit event dispatcher that sends audit events to an af_unix socket where other applications can read events. The
9 .B args
10 line of the
11 .B af_unix.conf
12 file expects three arguments: access mode, socket path, and output format, and optionally a fourth argument specifying the queue depth. The access mode determines the permissions for the socket and defaults to 0640. The socket path specifies where the socket will be created, with the default location being /run/audit/audispd_events. The output format determines the format in which events are delivered to the socket and supports two options: "string" and "binary". The "string" format delivers events in a human-readable form, while the "binary" format delivers events in their binary representation, which is essential for applications that need to process events in binary and reconstruct headers accurately. If the output format is not specified, the plugin defaults to the "string" format. If no queue depth is specified, it defaults to 512.
13
14 The
15 .B af_unix.conf
16 file must also include the line \fBformat = binary\fP. This setting specifies the input format that the \fBaudisp-af_unix\fP plugin expects from the audit event dispatcher. It ensures that the input delivered to the plugin is in binary format, enabling the plugin to reconstruct headers in their proper binary structure.
17
18 When the plugin is sent \fBSIGUSR1\fP, it writes a state report to \fBaf_unix.state\fP.
19
20 .SH FILES
21 /etc/audit/plugins/af_unix.conf
22 /run/audit/audispd_events
23 /run/audit/af_unix.state
24 /etc/audit/auditd.conf
25 .SH "SEE ALSO"
26 .BR auditd.conf (8),
27 .BR auditd-plugins (5).
28 .SH AUTHOR
29 Steve Grubb