# getlogin(3)

    NAME
         getlogin - get login name

    SYNOPSIS
         #include <unistd.h>

         char *getlogin(void)

    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,  or  if  there  is  no  entry  in  /etc/utmp  for the process's
         terminal, getlogin returns a null pointer.  A  reasonable  procedure  for
         determining  the login name is to first call getlogin and if it fails, to
         call getpwuid(getuid()).

    FILES
         /etc/utmp

    SEE ALSO
         getpwent(3), utmp(5), ttyslot(3)

    DIAGNOSTICS
         Returns a null pointer if the name cannot be found.

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