getlogin(3C)                                         getlogin(3C)



     NAME
          getlogin - get 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.

     FILES
          /etc/utmp

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

     DIAGNOSTICS
          getlogin returns the NULL pointer if name is not found.

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


























     Page 1                                        (last mod. 1/14/87)