Other Alias
setpwent, endpwentОБЗОР
#include <sys/types.h>
#include <pwd.h>
struct passwd *getpwent(void);
void setpwent(void);
void endpwent(void);
Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):
getpwent(), setpwent(), endpwent():
- _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
ОПИСАНИЕ
Функция getpwent() возвращает указатель на структуру, содержащую разделённую на поля запись базы данных паролей (например, локального файла паролей /etc/passwd, NIS и LDAP). При первом вызове getpwent() возвращает первую запись; при следующих последовательно возвращаются остальные записи.Функция setpwent() возвращается к началу базы данных паролей.
Функция endpwent() используется для закрытия базы данных паролей при завершении процесса обработки.
Структура passwd определена в <pwd.h> следующим образом:
struct passwd {
char *pw_name; /* имя пользователя */
char *pw_passwd; /* пароль пользователя */
uid_t pw_uid; /* идентификатор пользователя */
gid_t pw_gid; /* идентификатор группы */
char *pw_gecos; /* информация о пользователе */
char *pw_dir; /* домашний каталог */
char *pw_shell; /* программная оболочка */
};
Подробней о полях этой структуры смотрите в passwd(5).
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Функция getpwent() возвращает указатель на структуру passwd или NULL, если подходящих записей не найдено или возникла ошибка. При ошибке errno устанавливается в соответствующее значение. Если нужно проверять переменную errno после вызова, то перед этим нужно присвоить ей нулевое значение.Возвращаемое значение может указывать на статическую область и может быть перезаписано при последующих вызовах getpwent(), getpwnam(3) или getpwuid(3) (не передавайте полученный указатель free(3)).
ОШИБКИ
- EINTR
- Поступил сигнал; смотрите signal(7).
- EIO
- Ошибка ввода-вывода.
- EMFILE
- Было достигнуто ограничение по количеству открытых файловых дескрипторов на процесс.
- ENFILE
- Достигнуто максимальное количество открытых файлов в системе.
- ENOMEM
- Недостаточно памяти для структуры passwd.
- ERANGE
- Недостаточно места в буфере.
ФАЙЛЫ
- /etc/passwd
- файл, содержащий локальную базу паролей
АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).| Интерфейс | Атрибут | Значение |
| getpwent() | безвредность в нитях |
MT-Unsafe race:pwent
race:pwentbuf локаль |
|
setpwent(),
endpwent() | безвредность в нитях | небезопасно (MT-Unsafe race:pwent locale) |
В приведённой выше таблице pwent в race:pwgent означает, что если в нескольких нитях программы одновременно используются функции setpwent(), getpwent() или endpwent(), то может возникнуть состязательность по данным.