AUDIT_SETLOGINUID(3)           Linux Audit API          AUDIT_SETLOGINUID(3)

NAME         top

       audit_setloginuid - Set a program's loginuid value

SYNOPSIS         top

       #include <libaudit.h>

       int audit_setloginuid(uid_t uid);

DESCRIPTION         top

       This function sets the task attribute loginuid with the value of uid.
       The loginuid value may only be set by programs with the
       CAP_AUDIT_CONTROL capability. This normally means the root account.

       The loginuid value is part of the task structure and is inheritted by
       child processes. It is used to track what account a user gained
       system access with. All system entry point programs should set this
       value right before changing to the uid of the user granted access so
       that audit events are properly attributed to the that user.

RETURN VALUE         top

       This function returns 0 on success and non-zero otherwise.

SEE ALSO         top

       audit_getloginuid(3), pam_loginuid(8).

AUTHOR         top

       Steve Grubb

COLOPHON         top

       This page is part of the audit (Linux Audit) project.  Information
       about the project can be found at 
       ⟨⟩.  If you have a bug report
       for this manual page, send it to  This page
       was obtained from the project's upstream Git repository
       ⟨⟩ on 2018-10-29.
       (At that time, the date of the most recent commit that was found in
       the repository was 2018-10-15.)  If you discover any rendering prob‐
       lems in this HTML version of the page, or you believe there is a bet‐
       ter or more up-to-date source for the page, or you have corrections
       or improvements to the information in this COLOPHON (which is not
       part of the original manual page), send a mail to

Red Hat                           Oct 2006              AUDIT_SETLOGINUID(3)

Pages that refer to this page: audit_getloginuid(3)