getpwent.3c (2010 09)

getpwent(3C) getpwent(3C)

• The user ID is an integer value between -2 and

UID_MAX inclusive.

• The group ID is an integer value between 0 and

UID_MAX inclusive.

Users of

getpwuid_r() and getpwnam_r() should note that these interfaces now conform with

POSIX.1c. getpwent_r(), setpwent_r(), endpwent_r() and fgetpwent_r()

are obsolescent

interfaces. These interfaces and the old prototypes of

getpwuid_r() and getpwnam_r() are sup-

ported for compatibility with existing DCE applications only.

The interfaces

getpwuid(), getpwnam(), getpwent()

, setpwent(), endpwent(),

fgetpwent(), getpwuid_r() and getpwnam_r() use the Dynamic Name Service Switch. See

nsswitch.conf(4). An application that uses these interfaces cannot be fully archive bound.

HP-UX 11i Version 3 is the last release to support trusted systems functionality.

EXAMPLE

The following code excerpt prints name and uid of a user logged in on this terminal:

struct passwd pwd;

struct passwd *result;

char logBuffer [1024];

char pwdBuffer [1024];

if (getlogin_r (loginBuffer, 1024) == 0)

if (getpwnam_r (logBuffer, &pwd, pwdBuffer, 1024, &result) == 0)

printf ("Name = %s; uid = %d\n", pwd.pw_name, pwd.pw_uid);

DEPENDENCIES

NFS

Files

/var/yp/domainname /passwd.byname

/var/yp/domainname /passwd.byuid

/var/nis/hostname /passwd.org_dir

AUTHOR

getpwent(), getpwuid(), getpwnam(), setpwent(), endpwent(), and fgetpwent() were

developed by Sun and HP.

FILES

/etc/passwd System Password ﬁle