getlogin(3C)                                                   getlogin(3C)

NAME
     getlogin - get login name

SYNOPSIS
     #include <unistd.h>

     char *getlogin(void);

DESCRIPTION
     getlogin() returns a pointer to a string giving the login name as
     found in /var/adm/utmp. It may be used in conjunction with getpwnam()
     to locate the correct password file entry when the same user id is
     shared by several login names.

     If getlogin() is called within a process that is not attached to a
     terminal, it returns a null pointer.

RESULT
     getlogin() returns a null pointer if the login name is not found.

NOTES
     The return values point to static data whose content is overwritten by
     each call.

     The features of a current process can be ascertained as follows:

     getpwuid(geteuid()) returns the name associated with the effective
                         user ID of the process, getlogin() returns the
                         name associated with the current login activity,
                         and

     getpwuid(getuid())  returns the name associated with the real user ID
                         of the process.

FILES
     /var/adm/utmp

SEE ALSO
     getgrent(3C), getpwent(3C), cuserid(3S), utmp(4).
















Page 1                       Reliant UNIX 5.44                Printed 11/98