getgrnam_r()

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

Прототип:

#include <sys/types.h>
#include <grp.h>
                                       
int getgrnam_r( const char *name, 
                struct group *grp, 
                char *buffer, 
                size_t bufsize, 
                struct group **result );

Аргументы:

name: Имя группы, для которой требуется получить информацию.
grp: Указатель на структуру struct group где функция может хранить информацию о группе.
buffer: Область памяти, из которой выделять любую требуемую память.
bufsize: The size of the buffer.
result: Адрес указателя, который функция getgrgid_r() устанавливает в тот же указатель, что и grp при успешном завершени, или в NULL если функция не смогла найти группу.

Если определено _POSIX_THREAD_SAFE_FUNCTIONS, getgrnam_r() обновляет структуру struct group, на которую указывает grp и сохраняет указатель на эту структуру в result. Структура содержит запись из базы данных групп с совпадающим name.

Данная функция выделяет память, указанную в struct group из области памяти buffer, размером bufsize символов. Существует возможность задать максимальный размер, необходимый для buffer путем вызова sysconf() с аргументом _SC_GETGR_R_SIZE_MAX.

Функция getgrnam_r() сохраняет NULL указатель в области памяти, на которую указвает result при ошибке или если запрашиваемая запись не была найдена.