GETLOGIN(3C)         INTERACTIVE UNIX System         GETLOGIN(3C)



          NAME
               getlogin - get login name

          SYNOPSIS
               char *getlogin ( );

          DESCRIPTION
               The getlogin function 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 pro-
               cedure 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 is not found.

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


























          Rev. C Software Development Set                            Page 1