getprojuser(3c)						       getprojuser(3c)

NAME    [Toc]    [Back]

     getprojuser, fgetprojuser - get a user's project IDs

SYNOPSIS    [Toc]    [Back]

     #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    [Toc]    [Back]

     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    [Toc]    [Back]

     /etc/projid    System project name	to project ID mappings.

     /etc/project   System project authorization file.

SEE ALSO    [Toc]    [Back]

     closeproj(3C), getdfltprojuser(3C), getprojall(3C), openproj(3C),
     projid(4),	projects(5).

DIAGNOSTICS    [Toc]    [Back]

     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    [Toc]    [Back]

     Both functions use	fopen(3S) and are thus subject to its limitations.

     Project information should	be (optionally)	obtained via NIS.


									PPPPaaaaggggeeee 1111