NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | AUTHOR | COLOPHON

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 
       ⟨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 2017-09-15.
       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 is not part of the original manual page),
       send a mail to man-pages@man7.org

Red Hat                           Oct 2006              AUDIT_SETLOGINUID(3)

Pages that refer to this page: audit_getloginuid(3)