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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

541

542

543

544

545

546

547

548

549

550

getspent(3C) getspent(3C)

The routines getspent() , getspnam() and getspnam_r()

depend on the conﬁguration of the

/etc/nsswitch.conf

ﬁle. See nsswitch.conf(4). Entries may reside in any repository speciﬁed in

/etc/nsswitch.conf

. These routines use the switch for the

passwd database; for example, an entry

/etc/nsswitch.conf

would contain "passwd: nis files"

Programs using these routines must be compiled with

-lsec.

APPLICATION USAGE

In a multithreaded application, on systems not converted to trusted mode,

getspnam,

getspnam_r() ,

getspent() , setspent() , endspent() and fgetspent()

are thread-safe, but not async-cancel-

safe. A cancellation point may occur when a thread is executing any of these interfaces. On systems which

have been converted to trusted mode, only

fgetspent()

is thread-safe.

RETURN VALUE

If an EOF or error is encountered while reading,

getspnam() , getspnam_r() , getspent(), and

fgetspent() return a NULL pointer. Otherwise, the return value points to a valid

spwd structure. In

the case of

getspnam() , getspent() , and

fgetspent() , the spwd structure resides in an internal

area. In the case of

getspnam_r() , the

spwd structure resides in the spwd structure pointed to by the

result argument.

FILES

/etc/passwd system password ﬁle.

/etc/shadow shadow password ﬁle.

/tcb/files/auth/*/*

protected password database, for trusted systems.