|
|
1.1 ! root 1: .\" @(#)getlogin.3 6.2 (Berkeley) 5/9/86 ! 2: .\" ! 3: .TH GETLOGIN 3 "May 9, 1986" ! 4: .AT 3 ! 5: .SH NAME ! 6: getlogin \- get login name ! 7: .SH SYNOPSIS ! 8: .B char *getlogin() ! 9: .SH DESCRIPTION ! 10: .I Getlogin ! 11: returns a pointer to the login name as found in ! 12: .IR /etc/utmp . ! 13: It may be used in conjunction with ! 14: .I getpwnam ! 15: to locate the correct password file entry when the same userid ! 16: is shared by several login names. ! 17: .PP ! 18: If ! 19: .I getlogin ! 20: is called within a process that is not attached to a ! 21: terminal, or if there is no entry in ! 22: .I /etc/utmp ! 23: for the process's terminal, ! 24: .I getlogin ! 25: returns a NULL pointer (0). ! 26: A reasonable procedure for determining the login name is to first call ! 27: .I getlogin ! 28: and if it fails, to call ! 29: .IR getpwuid ( getuid ()). ! 30: .SH FILES ! 31: /etc/utmp ! 32: .SH "SEE ALSO" ! 33: getpwent(3), utmp(5), ttyslot(3) ! 34: .SH DIAGNOSTICS ! 35: Returns a NULL pointer (0) if name not found. ! 36: .SH BUGS ! 37: The return values point to static data ! 38: whose content is overwritten by each call.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.