getutent()

Считать следующую запись из файла данных о пользователях

Прототип:

#include <utmp.h>
struct utmp * getutent( void );

Библиотека:

libc

Описание:

Функция getutent() считывает следующую запись из файла информации о пользователях. Если файл на данный момент не открыт, getutent() открывает его. Если функция достигнет EOF, она завершит выполнение.

Возвращаемое значение:

Указатель на структуру utmp следующей записи, или NULL, если файл не может быть открыт для чтения или достигнут EOF.

Переменные окружения:

_PATH_UTMP
Определяет файл информации о пользователях.

Классификация:

Unix

Безопасность использования
Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Да

Предостережения:

Самая последняя запись сохраняется в статической структуре. Скопируйте ее перед дальнейшим доступом.

При каждом вызове getutid() или getutline(), процедура проверяет статическую структуру перед выполнением дополнительных операций ввода/вывода. Если содержимое статической структуры соответствует тому, что она ищет, функция прекращает поиск. По этой причине, используйте getutline() для поиска нескольких вхождений, обнуляйте статическую область после каждого успешного вызова, или getutline() будет возвращать одинаковую структуру при каждом вызове.

Есть одно исключение из правила обнуления структуры до выполнения дальнейшего чтения: неявное чтение, выполняемое pututline() (если она обнаруживает, что она еще не в нужном месте в файле) не повреждает содержимое статической структуры, возвращаемой процедурами getutent(), getutid() или getutline(), если вы просто изменили это содержимое и передали указатель обратно в pututline().

Эти процедуры используют стандартный буферизованный ввод, однако pututline() использует небуферизованную нестандартную запись, чтобы избежать состояния гонки между процессами, пытающимися изменить файлы utmp и wtmp.

Тематические ссылки:

endutent(), getutid(), getutline(), pututline(), setutent(), struct utmp, utmpname()

login в Справочнике по Утилитам




Предыдущий раздел: Описание API системной библиотеки