getpwent(3) - Russkiy

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

ОПИСАНИЕ

Функция 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 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, но присутствует в большинстве реализаций.