View Source: getpwnam(3) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages

GETPWNAM
!!!GETPWNAM
NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
FILES
CONFORMING TO
SEE ALSO
----
!!NAME


getpwnam, getpwuid - get password file entry
!!SYNOPSIS


__#include
__ ''name''__);
struct passwd *getpwuid(uid_t__ ''uid''__);
__
!!DESCRIPTION


The __getpwnam()__ function returns a pointer to a
structure containing the broken out fields of a line from
''/etc/passwd'' for the entry that matches the user name
''name''.


The __getpwuid()__ function returns a pointer to a
structure containing the broken out fields of a line from
''/etc/passwd'' for the entry that matches the user uid
''uid''.


The ''passwd'' structure is defined in
'''' as follows:


struct passwd {
char    *pw_name;       /* user name */
char    *pw_passwd;     /* user password */
uid_t   pw_uid;         /* user id */
gid_t   pw_gid;         /* group id */
char    *pw_gecos;      /* real name */
char    *pw_dir;        /* home directory */
char    *pw_shell;      /* shell program */
};
!!RETURN VALUE


The __getpwnam()__ and __getpwuid()__ functions return
a pointer to the passwd structure, or NULL if the matching
entry is not found or an error occurs.
!!ERRORS


__ENOMEM__


Insufficient memory to allocate passwd
structure.
!!FILES


''/etc/passwd''


password database file
!!CONFORMING TO


SVID 3, POSIX, BSD 4.3
!!SEE ALSO


fgetpwent(3), getgrnam(3), getpwent(3),
setpwent(3), endpwent(3), getpw(3),
putpwent(3), passwd(5)
----

9 pages link to getpwnam(3):

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

Last edited on Tuesday, June 4, 2002 12:24:23 am by "perry"

Edit PageHistory Diff Info LikePages