GETPWENT(3)

НАЗВАНИЕ
getpwent, setpwent, endpwent - получают запись из файла паролей

СИНТАКСИС
#include <pwd.h>
#include <sys/types.h>

struct passwd *getpwent(void);

void setpwent(void);

void endpwent(void);

ОПИСАНИЕ
Функция getpwent() возвращает указатель на структуру, содержащую поля строки из файла /etc/passwd. При первом вызове возвращается первая запись; далее возвращаются последующие записи.

Функция setpwent() устанавливает позицию чтения/записи в начало файла /etc/passwd.

Функция endpwent() закрывает файл /etc/passwd.

Структура passwd определена в <pwd.h> следующим образом:

    struct passwd {
            char    *pw_name;		/* имя пользователя */
            char    *pw_passwd;		/* пароль пользователя */
            uid_t   pw_uid;			/* id пользователя */
            gid_t   pw_gid;			/* id группы */
            char    *pw_gecos;      	/* настоящее имя */
            char    *pw_dir;  		/* домашний каталог */
            char    *pw_shell;      	/* программа-оболочка */
    };

ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ
Функция getpwent() возвращает структуру passwd или NULL, если записей больше нет или если произошла ошибка.

НАЙДЕННЫЕ ОШИБКИ

ENOMEM
    (недостаточно памяти для размещения структуры passwd).

ФАЙЛЫ

/etc/passwd
    (файл базы данных паролей).

СООТВЕТСТВИЕ СТАНДАРТАМ
SVID 3, BSD 4.3

СМ. ТАКЖЕ
fgetpwent(3), getpwnam(3), getpwuid(3), getpw(3), putpwent(3), passwd (5)