HP-UX Reference (11i v3 07/02) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

551

552

553

554

555

556

557

558

559

560

getpwent(3C) getpwent(3C)

The following ﬁelds have numerical limitations as noted:

• 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