HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/!!!intro.3c
________________________________________________________________
___ ___
g
getprdfent(3) getprdfent(3)
A call to setprdfent has the effect of rewinding the default control file to allow repeated searches.
endprdfent can be called to close the database when processing is complete.
putprdfnam puts a new or replaced default control entry pr with key name into the database. If the
prg.fd_name field is 0, the requested entry is deleted from the system default database. putprdfnam
locks the database for all update operations and performs an endprdfent after the update or failed
attempt.
APPLICATION USAGE
In a multithreaded application, these routines are safe to be called only from one dedicated thread. These
routines are not POSIX.1c async-cancel safe nor async-signal safe.
RETURN VALUE
getprdfent and getprdfnam return NULL pointers on EOF or error. putprdfnam returns 0 if it
cannot add or update the entry.
WARNINGS
Do not delete the system default entry.
NOTES
The value returned by getprdfent and getprdfnam refers to a structure that is overwritten by calls
to these routines. To retrieve an entry, modify it, and replace it in the database, copy the entry using
structure assignment and supply the modified buffer to putprdfnam.
Programs using these routines must be compiled with -lsec
.
FILES
/tcb/files/auth/system/default
System Defaults database
SEE ALSO
authcap(4), default(4), getprpwent(3), getprtcent(3), getdvagent(3).
Section 3−−328 − 2 − HP-UX Release 11i: December 2000
___
___