getlogin(3C)           UNIX System V(C Development Set)            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.























10/89                                                                    Page 1