Linux Man на русском

  User    Syst    Libr    Device    Files    Other    Admin  



   setpwent - получает запись из файла паролей

setpwent(3) получает запись из файла паролей

Other Alias

getpwent, 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(), то может возникнуть состязательность по данным.


СООТВЕТСТВИЕ СТАНДАРТАМ

POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. Поле pw_gecos не определено в стандарте POSIX, но присутствует в большинстве реализаций.