.\" @(#)getlogin.3 6.3 (Berkeley) %G%
getlogin \- get login name
returns a pointer to the login name as found in
It may be used in conjunction with
to locate the correct password file entry when the same userid
is shared by several login names.
is called within a process that is not attached to a
terminal, or if there is no entry in
for the process's terminal,
returns a NULL pointer (0).
A reasonable procedure for determining the login name is to first call
.IR getpwuid ( getuid ()).
getpwent(3), utmp(5), ttyslot(3)
Returns a NULL pointer (0) if name not found.
The return values point to static data
whose content is overwritten by each call.