GETLOGIN
Section: C Library Functions (3)
Updated: August 1, 1992
Index
Return to Main Contents
NAME
getlogin - 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 ALSO
getpwent(3), utmp(5), ttyslot(3)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- FILES
-
- RETURN VALUE
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 17:20:40 GMT, March 25, 2025