audit_log_user_message - Man Page
log a general user message
Synopsis
#include <libaudit.h>
int audit_log_user_message(int audit_fd, int type, const char *message, const char *hostname, const char *addr, const char *tty, int result)
Description
This function will log a message to the audit system using a predefined message format. This function should be used by all ELF console apps that do not manipulate accounts or groups. If the application is written in Python or another interpreter, then use the audit_log_user_comm_message function instead. 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"
Return Value
It returns the sequence number which is > 0 on success or <= 0 on error.
Errors
This function returns -1 on failure. Examine errno for more info.
See Also
audit_log_user_comm_message(3), audit_log_acct_message(3), audit_log_user_avc_message(3), audit_log_semanage_message(3).
Author
Steve Grubb
Referenced By
audit_encode_nv_string(3), audit_log_acct_message(3), audit_log_semanage_message(3), audit_log_user_avc_message(3), audit_log_user_command(3), audit_log_user_comm_message(3).