getgrnam()

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

Прототип:

#include <sys/types.h>
#include <grp.h>
                                       
struct group * getgrnam( const char *name );

Аргументы:

name

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

Библиотека:

libc

Описание:

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

---

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

---

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

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

Примеры:

/*
 * Print the name of all users in the group given in 
 * argv[1]
 */
#include <stdio.h>
#include <unistd.h>
#include <stdlib.h>
#include <sys/types.h>
#include <grp.h>
                                       
int main( int argc, char **argv )
{
    struct group    *g;
    char            **p;
                                       
    if ( (g = getgrnam( argv[1] )) == NULL )
    {
        fprintf( stderr, "getgrnam: %s failed\n", argv[1] );
        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(), getgrnam_r()

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