NAME

       audit_log_user_message - 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

Red Hat                                             July 2016                          AUDIT_LOG_USER_MESSAGE(3)