7.2.1 getid: Get the identity attributes of this principal

 

SYNOPSIS

#include <oskit/principal.h>

oskit_error_t oskit_principal_getid(oskit_principal_t *p, [out] oskit_identity_t *out_id);

DIRECTION

filesystem library client OS

DESCRIPTION

This method returns the identity attributes of this principal. out_id is a pointer to an oskit_identity_t structure defined as follows:

struct oskit_identity  {

	    	oskit_uid_t uid;		/* effective user id */
		oskit_gid_t gid;		/* effective group id */
		oskit_u32_t ngroups;		/* number of groups */
		oskit_u32_t *groups;		/* supplemental groups */
	 

};

PARAMETERS

p

The principal whose identity is desired.

out_id

The identity attributes of this principal.

RETURNS

Returns 0 on success, or an error code specified in <oskit/error.h>, on error.