kcred_getgroups Kernel Service

Purpose

Copies the concurrent group set from a credentials structure.

Syntax

#include <sys/cred.h>

int kcred_getgroups ( crp, ngroups, groups )
struct ucred * cr;
int ngroups;
gid_t * groups;

Parameters

Item	Description
crp	Pointer to a credentials structure
ngroups	Size of the array of group ID values
groups	Array of group ID values

Description

The kcred_getgroups kernel service returns up to ngroups concurrent group set members from the credentials structure pointed to by crp. crp must be a valid referenced credentials structure.

Execution Environment

The kcred_getgroups kernel service can be called from the process environment only.

Return Values

Item	Description
>= 0	The number of concurrent groups copied to groups.
-1	An error has occurred.