The following functions are provided to assist developers in working with projects. The functions use entries that describe user projects in the project database.
See man pages section 3: Extended Library Functions, Volume 3 for additional information on these functions.
Close the project database and deallocate resources when processing is complete.
Returns a pointer to a structure containing an entry in the project database. Rather than using nsswitch.conf, fgetprojent() reads a line from a stream.
Check the validity of the project keyword, look up the project, and return a pointer to the project structure if found.
Search the project database for an entry with the number that specifies the project ID.
Search the project database for an entry with the string that specifies project name.
Returns a pointer to a structure containing an entry in the project database.
Check whether the specified user is permitted to use the specified project.
Calling process joins the target project by creating a new task in the target project.
Rewind the project database to allow repeated searches.
Reentrant functions getprojent(), getprojbyname(), getprojbyid(), getdefaultproj(), and inproj() use buffers supplied by the caller to store returned results. These functions are safe for use in both single-threaded applications and multithreaded applications.
Reentrant functions require three additional arguments:
proj
buffer
bufsize
The proj argument must be a pointer to a project structure allocated by the caller. On successful completion, these functions return the project entry in this structure. Storage referenced by the project structure is allocated from the memory specified by the buffer argument. bufsize specifies the size in number of bytes.
If an incorrect buffer size is used, getprojent() returns NULL and sets errno to ERANGE.