getgroups()

Get the supplementary group IDs of the calling process

Synopsis:

#include <sys/types.h>
#include <unistd.h>

int getgroups( int gidsetsize, 
               gid_t grouplist[] );

Arguments:

gidsetsize: The size of the grouplist array.
grouplist: An array that the function can fill in with the process's supplementary group IDs.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

The getgroups() function fills the array grouplist with the supplementary group IDs of the calling process. The values of array entries with indices greater than or equal to the returned value are undefined.

Returns:

The number of supplementary groups IDs; this value is zero if NGROUPS_MAX is zero. A value of -1 indicates an error (errno is set).

Errors:

EINVAL: The gidsetsize argument isn't equal to zero, and is less than the number of supplementary group IDs.

Examples:

/*
 * Print the supplementary group IDs of
 * the calling process.
 */
#include <stdio.h>
#include <stdlib.h>
#include <sys/types.h>
#include <unistd.h>

int main( void )
  {
    int     gidsize;
    gid_t   *grouplist;
    int     i;

    gidsize = getgroups( 0, NULL );
    grouplist = malloc( gidsize * sizeof( gid_t ) );
    getgroups( gidsize, grouplist );
    for( i = 0; i < gidsize; i++ )
      printf( "%d\n", ( int ) grouplist[i] );
    return EXIT_SUCCESS;
  }

Classification:

POSIX 1003.1

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes