getgrgid()

Получить информацию о группе по идентификатору

Прототип:

#include <sys/types.h>
#include <grp.h>
struct group * getgrgid( gid_t gid );

Аргументы:

gid
Идентификатор группы, для которой требуется получить информацию.

Библиотека:

libc

Описание:

Функция getgrgid() позволяет процессу получить больше сведений о группе gid. Данная функция использует статическую область памяти, которая перезаписывается при каждом вызове.


Note: Функции getgrent(), getgrgid(), и getgrnam() делят между собой одну статическую область памяти.

Возвращаемое значение:

Указатель на объект типа struct group, содержащий запись из базы данных групп с совпадающим gid. При ошибке или невозможности найти запись с требуемым gid, будет возвращен NULL.

Примеры:

/*
* Print a list of all users in your group
*/
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <sys/types.h>
#include <grp.h>
int main( void )
{
struct group *g;
char **p;
if ( (g = getgrgid( getgid() )) == NULL )
{
fprintf( stderr, "getgrgid: NULL pointer\n" );
return (EXIT_FAILURE);
}
printf( "group name:%s\n", g->gr_name );
for ( p = g->gr_mem; *p != NULL; p++ )
{
printf( "\t%s\n", *p );
}
return (EXIT_SUCCESS);
}

Классификация:

POSIX 1003.1

Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Нет

Тематические ссылки:

struct group, getgrent(), getgrgid_r(), getgrnam()




Предыдущий раздел: Описание API системной библиотеки