GNU
2017-09-15
Aliases: endpwent(3), endpwent(3), endpwent(3), endpwent(3), endpwent(3), endpwent(3), endpwent(3), endpwent(3), endpwent(3), endpwent(3), endpwent(3), endpwent(3), setpwent(3), setpwent(3), setpwent(3), setpwent(3), setpwent(3), setpwent(3), setpwent(3), setpwent(3), setpwent(3), setpwent(3), setpwent(3), setpwent(3)
man-pages-ru
Russian man pages from the Linux Documentation Project
manpages-dev
Manual pages about using GNU/Linux for development
man-pages
Linux kernel and C library user-space interface documentation
ИМЯ
getpwent, 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():
_XOPEN_SOURCE >= 500
|| /* начиная с glibc 2.19: */ _DEFAULT_SOURCE
|| /* версии gibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
|| /* начиная с glibc 2.19: */ _DEFAULT_SOURCE
|| /* версии gibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
ОПИСАНИЕ
Функция 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; /* программная оболочка */ };
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 locale |
setpwent(), endpwent() |
Безвредность в нитях | MT-Unsafe race:pwent locale |
В приведённой выше таблице pwent в race:pwgent означает, что если в нескольких нитях программы одновременно используются функции setpwent(), getpwent() или endpwent(), то может возникнуть состязательность по данным.
СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. Поле pw_gecos не определено в стандарте POSIX, но присутствует в большинстве реализаций.
СМОТРИТЕ ТАКЖЕ
REFERENCED BY
fgetpwent(3), getpw(3), getpwent_r(3), getpwnam(3), getspnam(3), putpwent(3), setaliasent(3), getent(1), nss(5), nsswitch.conf(5), hlfsd(8), gentoo(1), gentoo(1x), lcmaps_posix_enf.mod(8), ftpd(8), shadow(3), , mh-alias(5mh), mh-alias(5), pmcd(1), pmdapipe(1), xscreensaver(1), passwd(5), xs(1), crypt_gensalt(3), crypt_rn(3), crypt(5)