


      GETLOGIN(3C)                (UNIX 5.0)               GETLOGIN(3C)



      NAME
           getlogin - get login name

      SYNTAX
           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 to call getlogin and if it fails to call getpwuid.

      FILES
           /etc/utmp

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

      DIAGNOSTICS
           Returns the NULL pointer if name not found.

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


























      Page 1                                         (73 A2 02MTA REV1)



