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

Edit PageHistory Diff Info LikePages

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


getpw - Re-construct password line entry
!!SYNOPSIS


__#include
__ ''uid''__, char *__''buf''__);
__
!!DESCRIPTION


The __getpw()__ function re-constructs the password line
entry for the given user uid ''uid'' in the buffer
''buf''. The returned buffer contains a line of
format


__name:passwd:uid:gid:gecos:dir:shell__


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 __getpw()__ function returns 0 on success, or -1 if
an error occurs.
!!ERRORS


__ENOMEM__


Insufficient memory to allocate passwd
structure.
!!FILES


''/etc/passwd''


password database file
!!CONFORMING TO


SYSVr2.
!!BUGS


The __getpw__() function is dangerous as it may overflow
the provided buffer ''buf''. It is obsoleted by
__getpwuid__().
!!SEE ALSO


fgetpwent(3), getpwent(3), setpwent(3),
endpwent(3), getpwnam(3), getpwuid(3),
putpwent(3), passwd(5)
----

8 pages link to getpw(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