GETLOGIN(3)GETLOGIN(3)NAMEgetlogin - get login name
SYNOPSIS
#include <libc.h> /* POSIX applications #include <unistd.h> */
char *getlogin(void);
DESCRIPTION
Getlogin returns a pointer to a string giving a login name associated
with the user process. The login name is found in /etc/utmp. It may
be used in conjunction with getpwnam to locate the correct password
file entry when the same userid is shared by several login names.
If getlogin is called within a process that is not attached to a
terminal, or if there is no entry in /etc/utmp for the process's
terminal, getlogin returns a NULL pointer (0). A reasonable procedure
for determining the login name is to first call getlogin and if it
fails, to call getpwuid(getuid()).
The return values point to static data whose content is overwritten by
each call.
FILES
/etc/utmp
RETURN VALUE
A successful call returns a pointer to a string containing the user's
login name, or a NULL pointer if the user's login name cannot be found.
SEE ALSOgetpwent(3), utmp(5), ttyslot(3)7th Edition August 1, 1992 GETLOGIN(3)