getprojall(3c)getprojall(3c)NAME
getprojall, fgetprojall - enumerate all project IDs
SYNOPSIS
#include <proj.h>
int getprojall(projid_t *buf, int len);
int fgetprojall(PROJ token, projid_t *buf, int len);
DESCRIPTION
The getprojall function stores information about all of the project IDs
known to the system into an array of projid_t structs pointed to by buf.
A maximum of len entries will be stored. The projid_t struct is defined
in <proj.h> and has the following format:
#define MAXPROJNAMELEN 32
typedef struct projid {
char proj_name[MAXPROJNAMELEN]; /* project name */
prid_t proj_id; /* project ID */
} projid_t;
Note that project names that have more than MAXPROJNAMELEN-1 characters
will be truncated. The proj_name field is always null-terminated.
The fgetprojall function is a variant of getprojall that uses a PROJ
token to make it more efficient for repeated use. Otherwise its
operation is identical. For more details on creating a PROJ token, see
openproj(3C).
FILES
/etc/projid System project name to project ID mappings.
SEE ALSOcloseproj(3C), getprojuser(3C), openproj(3C), projid(3C), projname(3C),
projid(4), projects(5).
DIAGNOSTICS
getprojall and fgetprojall both return the number of projid_t's stored
(which may be 0 if the none are defined for the system) or -1 if an error
occurred.
BUGS
All of the functions use fopen(3S) and are thus subject to its
limitations.
Project ID information should be (optionally) obtained via NIS.
Page 1
