getlogin(3c)               DG/UX 4.30                getlogin(3c)



     NAME
          getlogin - get login name

     SYNOPSIS
          char *getlogin ( );

     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, 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
          /etc/utmp

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

     DIAGNOSTICS
          Returns the NULL pointer if the login name cannot be
          determined.  The login name cannot be determined if the
          process is not attached to a terminal, as is the case for
          processes started at the system console.

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























     Licensed material--property of copyright holder(s)         Page 1