getgrgid_r()

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

Прототип:

#include <sys/types.h>
#include <grp.h>
                                       
int getgrgid_r( gid_t gid,
                struct group *grp, 
                char *buffer, 
                size_t bufsize,
                struct group **result );

Аргументы:

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

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

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

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