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

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).
HP-UX 11i Version 2: August 2003 − 2 − Hewlett-Packard Company Section 3−−395