Synopsis
#include <unistd.h>
char *getlogin(void);
int getlogin_r(char *name, size_t namesize);
Status
Declared, not implemented
Conformance
IEEE Std 1003.1-2017
Description
The getlogin() function shall return a pointer to a string containing the user name associated by the login activity with
the controlling terminal of the current process. If getlogin() returns a non-null pointer, then that pointer points to the
name that the user logged in under, even if there are several login names with the same user ID.
The getlogin() function need not be thread-safe.
The getlogin_r() function shall put the name associated by the login activity with the controlling terminal of the
current process in the character array pointed to by name. The array is namesize _characters long and should have
space for the _name and the terminating null character. The maximum size of the login name is LOGIN_NAME_MAX.
If getlogin_r() is successful, name points to the name the user used at login, even if there are several login
names with the same user ID.
The getlogin() and getlogin_r() functions may make use of file descriptors 0, 1, and 2 to find the controlling
terminal of the current process, examining each in turn until the terminal is found. If in this case none of these three file
descriptors is open to the controlling terminal, these functions may fail. The method used to find the terminal associated with a
file descriptor may depend on the file descriptor being open to the actual terminal device, not /dev/tty.
Return value
Upon successful completion, getlogin() shall return a pointer to the login name or a null pointer if the user's login
name cannot be found. Otherwise, it shall return a null pointer and set errno to indicate the error.
The application shall not modify the string returned. The returned pointer might be invalidated or the string content might be
overwritten by a subsequent call to getlogin(). The returned pointer and the string content might also be invalidated if the
calling thread is terminated.
If successful, the getlogin_r() function shall return zero; otherwise, an error number shall be returned to indicate the
error.
Errors
These functions may fail if:
-
EMFILE- All file descriptors available to the process are currently open. -
ENFILE- The maximum allowable number of files is currently open in the system. -
ENOTTY- None of the file descriptors 0, 1, or 2 is open to the controlling terminal of the current process. -
ENXIO- The calling process has no controlling terminal.
The getlogin_r() function may fail if:
ERANGE- The value of namesize is smaller than the length of the string to be returned including the terminating null character.
Tests
Untested
Known bugs
None