Imported Upstream version 2.4.3
[platform/upstream/audit.git] / docs / audit_get_reply.3
1 .TH "AUDIT_GET_REPLY" "3" "Oct 2006" "Red Hat" "Linux Audit API"
2 .SH NAME
3 audit_get_reply \- Get the audit system's reply
4 .SH SYNOPSIS
5 .B #include <libaudit.h>
6 .sp
7 int audit_get_reply(int fd, struct audit_reply *rep, reply_t block, int peek);
8
9 .SH "DESCRIPTION"
10 This function gets the next data packet sent on the audit netlink socket. This function is usually called after sending a command to the audit system. fd should be an open file descriptor returned by audit_open. rep should be a data structure to put the reply in. block is of type reply_t which is either: GET_REPLY_BLOCKING and GET_REPLY_NONBLOCKING. peek, if non-zero, gets the data without dequeueing it from the netlink socket.
11
12 .SH "RETURN VALUE"
13
14 This function returns \-1 on error, 0 if error response received, and positive value on success.
15
16 .SH "SEE ALSO"
17
18 .BR audit_open (3).
19
20 .SH AUTHOR
21 Steve Grubb