audit_log_user_message − log a general user message


audit_fd,intaudit_log_user_message(int const char *hostname,
const char *addr, const char *tty, int result)

This function will log a message to the audit system using a
predefined message format. This function should be used by
all console apps that do not manipulate accounts or groups.
The function parameters are as follows:

audit_fd ‐ The fd returned by audit_open
type ‐ type of message, ex: AUDIT_USYS_CONFIG, AUDIT_USER_LOGIN
message ‐ the message text being sent
hostname ‐ the hostname if known, NULL if unknown
addr ‐ The network address of the user, NULL if unknown
tty ‐ The tty of the user, if NULL will attempt to figure out
result ‐ 1 is "success" and 0 is "failed"

It returns the sequence number which is > 0 on success or <=
0 on error.

This function returns ‐1 on failure. Examine errno for more


Steve Grubb