getlogin(3C)                                         getlogin(3C)



NAME
     getlogin - gets login name

SYNOPSIS
     char *getlogin();

DESCRIPTION
     getlogin returns a pointer to the login name as found in
     /etc/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.  The correct
     procedure for determining the login name is to call cuserid
     or getlogin.  If getlogin fails, call getpwuid.

STATUS MESSAGES AND VALUES
     The getlogin command returns the null pointer if name is not
     found.

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

FILES
     /etc/utmp
          Temporary file

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
























January 1992                                                    1