getlogin(3C)
get login name
From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.
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.