NAME |SYNOPSIS |DESCRIPTION |RETURN VALUE |ERRORS |SEE ALSO |AUTHOR |COLOPHON | |
AUDIT_LOG_...OMM_MESSAGE(3) Linux Audit APIAUDIT_LOG_...OMM_MESSAGE(3)audit_log_user_comm_message - log a user message from a console app
#include <libaudit.h>intaudit_log_user_comm_message(intaudit_fd,int"type,constchar*"message,constchar*"comm,constchar*"hostname,constchar*"addr,constchar*"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 non-ELF console apps that do not manipulate accounts, groups, or need to log execution of a script. An example would be a Python script recording an event. The function parameters are as follows:audit_fd - The fd returned by audit_opentype - type of message, ex: AUDIT_USYS_CONFIG, AUDIT_USER_LOGINmessage - the message text being sentcomm - the program command line name, NULL if unknownhostname - the hostname if known, NULL if unknownaddr - The network address of the user, NULL if unknowntty - The tty of the user, if NULL will attempt to figure outresult - 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 info.
audit_log_user_message(3),audit_log_acct_message(3),audit_log_user_avc_message(3),audit_log_semanage_message(3).
Steve Grubb
This page is part of theaudit (Linux Audit) project. Information about the project can be found at ⟨http://people.redhat.com/sgrubb/audit/⟩. If you have a bug report for this manual page, send it to linux-audit@redhat.com. This page was obtained from the project's upstream Git repository ⟨https://github.com/linux-audit/audit-userspace.git⟩ on 2025-08-11. (At that time, the date of the most recent commit that was found in the repository was 2025-08-09.) If you discover any rendering problems in this HTML version of the page, or you believe there is a better or more up-to-date source for the page, or you have corrections or improvements to the information in this COLOPHON (which isnot part of the original manual page), send a mail to man-pages@man7.orgRed Hat July 2016AUDIT_LOG_...OMM_MESSAGE(3)Pages that refer to this page: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_message(3)
HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH. | ![]() |