getlogin(3C)        (C Programming Language Utilities)         getlogin(3C)


   NAME
         getlogin - get login name

   SYNOPSIS
         #include <stdlib.h>

         char *getlogin (void);

   DESCRIPTION
         getlogin returns a pointer to 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.  The correct procedure for
         determining the login name is to call cuserid, or to call getlogin
         and if it fails to call getpwuid.

   FILES
         /var/adm/utmp

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

   DIAGNOSTICS
         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.






















   8/91                                                                 Page 1