audit_getloginuid(3) [debian man page]

AUDIT_GETLOGINUID(3)						  Linux Audit API					      AUDIT_GETLOGINUID(3)

NAME

       audit_getloginuid - Get a program's loginuid value

SYNOPSIS

       #include <libaudit.h>

       uid_t audit_getloginuid(void);

DESCRIPTION

       This function returns the task attribute loginuid.

RETURN VALUE

       This  function  returns	the  loginuid  value if it was set. It will return a -1 if loginuid was unset. However, since uid_t is an unsigned
       type, you will see the converted value instead of -1.

ERRORS

       This function returns -1 on failure. However, in the event of a real error, errno would be set. The function can set errno based  on  fail-
       ures of open, read, or strtoul.

SEE ALSO

       audit_setloginuid(3).

AUTHOR

       Steve Grubb

Red Hat 							     Oct 2006						      AUDIT_GETLOGINUID(3)

PAM_LOGINUID(8) 						 Linux-PAM Manual						   PAM_LOGINUID(8)

NAME

       pam_loginuid - Record user's login uid to the process attribute

SYNOPSIS

       pam_loginuid.so [require_auditd]

DESCRIPTION

       The pam_loginuid module sets the loginuid process attribute for the process that was authenticated. This is necessary for applications to
       be correctly audited. This PAM module should only be used for entry point applications like: login, sshd, gdm, vsftpd, crond and atd. There
       are probably other entry point applications besides these. You should not use it for applications like sudo or su as that defeats the
       purpose by changing the loginuid to the account they just switched to.

OPTIONS

       require_auditd
	   This option, when given, will cause this module to query the audit daemon status and deny logins if it is not running.

MODULE TYPES PROVIDED

       Only the session module type is provided.

RETURN VALUES

       PAM_SESSION_ERR
	   An error occurred during session management.

EXAMPLES

	   #%PAM-1.0
	   auth       required	   pam_unix.so
	   auth       required	   pam_nologin.so
	   account    required	   pam_unix.so
	   password   required	   pam_unix.so
	   session    required	   pam_unix.so
	   session    required	   pam_loginuid.so

SEE ALSO

       pam.conf(5), pam.d(5), pam(7), auditctl(8), auditd(8)

AUTHOR

       pam_loginuid was written by Steve Grubb <sgrubb@redhat.com>

Linux-PAM Manual						    06/04/2011							   PAM_LOGINUID(8)