Blame docs/audit_open.3

Packit f0d170
.TH "AUDIT_OPEN" "3" "Oct 2006" "Red Hat" "Linux Audit API"
Packit f0d170
.SH NAME
Packit f0d170
audit_open \- Open a audit netlink socket connection
Packit f0d170
.SH "SYNOPSIS"
Packit f0d170
.B #include <libaudit.h>
Packit f0d170
.sp
Packit f0d170
int audit_open (void);
Packit f0d170
Packit f0d170
.SH "DESCRIPTION"
Packit f0d170
Packit f0d170
audit_open creates a NETLINK_AUDIT socket for communication with the kernel part of the Linux Audit Subsystem. The audit system uses the ACK feature of netlink. This means that every message to the kernel will return a netlink status packet even if the operation succeeds.
Packit f0d170
Packit f0d170
.SH "RETURN VALUE"
Packit f0d170
Packit f0d170
Returns \-1 if an error occurs; otherwise, the return value is a descriptor referencing the socket.
Packit f0d170
Packit f0d170
.SH ERRORS
Packit f0d170
Packit f0d170
The
Packit f0d170
.BR audit_open ()
Packit f0d170
function may fail and set
Packit f0d170
.I errno
Packit f0d170
for any of the errors specified for the
Packit f0d170
.BR socket (2)
Packit f0d170
and
Packit f0d170
.BR fcntl (2)
Packit f0d170
routines.
Packit f0d170
Packit f0d170
.SH "SEE ALSO"
Packit f0d170
Packit f0d170
.BR netlink (7).
Packit f0d170
Packit f0d170
.SH AUTHOR
Packit f0d170
Steve Grubb