getprojuser(3c)getprojuser(3c)NAME
getprojuser, fgetprojuser - get a user's project IDs
SYNOPSIS
#include <proj.h>
int getprojuser(const char *name, projid_t *buf, int len);
int fgetprojuser(PROJ token, const char *name, projid_t *buf, int len);
DESCRIPTION
The getprojuser function searches the project file for the user name and
stores information about the projects for which name is authorized into
an array of projid_t structs. The array is pointed to by buf and is
assumed to have room for a maximum of len entries. 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 fgetprojuser function is a variant of getprojuser 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.
/etc/project System project authorization file.
SEE ALSOcloseproj(3C), getdfltprojuser(3C), getprojall(3C), openproj(3C),
projid(4), projects(5).
DIAGNOSTICS
getprojuser and fgetprojuser both return the number of projid_t's stored
(which may be 0 if the user was not found or if the user is not
authorized for any projects) or -1 if an error occurred.
BUGS
Both functions use fopen(3S) and are thus subject to its limitations.
Project information should be (optionally) obtained via NIS.
Page 1
