Linux API. Исчерпывающее руководство

Поскольку функции getpwnam() и getpwuid() возвращают указатель на статически выделенную структуру, они являются нереентерабельными. На самом деле ситуация складывается еще сложнее, поскольку возвращаемая структура passwd содержит указатели на другую информацию (например, поле pw_name), которая также является статически выделенной. (Реентерабельность объясняется в подразделе 21.1.2.) Такие же утверждения справедливы для функций getgrnam() и getgrgid(), которые мы вскоре рассмотрим.

В SUSv3 указывается эквивалентный набор реентерабельных функций — getpwnam_r(), getpwuid_r(), getgrnam_r() и getgrgid_r(), включающих в качестве аргументов как структуру passwd (или group), так и область буфера для хранения других структур, на которые указывают поля структуры passwd (group). Количество байтов, требуемое для этого дополнительного буфера, может быть получено с помощью вызова sysconf(_SC_GETPW_R_SIZE_MAX) (или sysconf(_SC_GETGR_R_SIZE_MAX) для функций, имеющих отношение к группам). Дополнительные сведения об этих функциях можно найти на страницах руководства.

В соответствии с положениями SUSv3, если нужная запись passwd не может быть найдена, функции getpwnam() и getpwuid() должны возвратить значение NULL, оставив значение errno в неизменном виде. Таким образом, можно различить ошибку и случаи «запись не найдена», используя следующий код:

struct passwd *pwd;

errno = 0;

pwd = getpwnam(name);

if (pwd == NULL) {

if (errno == 0)

/* Запись не найдена */;

else

/* Ошибка */;

}

Однако некоторые реализации UNIX не соответствуют [требованиям] SUSv3 по этому вопросу. Если нужная запись passwd не найдена, эти функции возвращают значение NULL и устанавливают для errno ненулевое значение, например ENOENT или ESRCH. До выхода версии 2.7 библиотека glibc выдавала в таком случае ошибку ENOENT, но, начиная с версии 2.7, она стала отвечать требованиям SUSv3. Эти расхождения в реализациях возникли отчасти из-за того, что в POSIX.1-1990 данным функциям не требовалось устанавливать для errno значения при ошибке и позволялось устанавливать значение в случае «запись не найдена». В результате при использовании этих функций стало совершенно невозможно портируемым образом отличить ошибку от ситуации «запись не найдена».

Извлечение записей из файла групп

Записи из файла групп извлекаются с помощью функций getgrnam() и getgrgid().

#include

struct group *getgrnam(const char *name);

struct group *getgrgid(gid_t gid);

Обе функции при успешном завершении возвращают указатель, при ошибке — NULL. Описание для случая «запись не найдена» дается в тексте подраздела

Функция getgrnam() осуществляет поиск информации о группе по имени группы, а функция getgrgid() — по идентификатору группы. Обе функции возвращают указатель на структуру следующего типа:

struct group {

char *gr_name; /* Имя группы */

char *gr_passwd; /* Зашифрованный пароль (в режиме без теневых паролей) */

gid_t gr_gid; /* Идентификатор группы */

char **gr_mem; /* Массив указателей на имена участников группы,

перечисленных в /etc/group, завершающийся значением NULL */

};

Поле gr_passwd структуры group в SUSv3 не указано, но доступно в большинстве реализаций UNIX.

Как и в случае рассмотренных выше соответствующих функций работы с записями в файле паролей, эта структура перезаписывается при каждом вызове одной из этих функций.

Если функции не могут найти запись, соответствующую группе, они демонстрируют такие же варианты поведения, которые были рассмотрены для функций getpwnam() и getpwuid().

Пример программы

Один из примеров наиболее частого применения рассмотренных в этом разделе функций — преобразование символьных имен пользователя и группы в их числовые идентификаторы и наоборот. В листинге 8.1 показано это преобразование в виде четырех функций: userNameFromId(), userIdFromName(), groupNameFromId() и groupIdFromName(). Для удобства вызывающего функции userIdFromName() и groupIdFromName() также позволяют аргументу name быть числовой строкой в чистом виде. В этом случае строка преобразуется непосредственно в число и возвращается вызвавшему функцию коду. Эти функции будут использоваться в некоторых примерах программ, которые мы рассмотрим далее в книге.

Листинг 8.1. Функции для преобразования идентификаторов пользователей и групп в имена пользователей и групп и наоборот

users_groups/ugid_functions.c

#include

#include

#include

#include "ugid_functions.h" /* Объявление определяемых здесь функций */

char * /* Возвращает имя, соответствующее 'uid', или NULL при ошибке */

userNameFromId(uid_t uid)

{

struct passwd *pwd;

pwd = getpwuid(uid);

return (pwd == NULL)? NULL: pwd->pw_name;

}

uid_t /* Возвращает идентификатор пользователя,

соответствующего 'name', или –1 при ошибке */

userIdFromName(const char *name)

{

struct passwd *pwd;

uid_t u;

char *endptr;

if (name == NULL || *name == '\0') /* Возвращает ошибку, если передан NULL*/