getlogin(3C)            LIBRARY FUNCTIONS            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 pro-
     cedure 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 the NULL pointer if the login name is not found.

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
























                                                                1