getutid()

Найти запись в файле данных о пользователях

Прототип:

#include <utmp.h>
                                       
struct utmp * getutid( struct utmp *id );

Аргументы:

id: Указатель на структуру utmp, которую требуется найти в файле данных о пользователях.

Описание:

Функция getutid() начинает поиск от текущей позиции в файле utmp, и производит его до тех пор, пока не найдет требуемую запись:

Если id->ut_type является одним из следующих: RUN_LVL, BOOT_TIME, OLD_TIME, или NEW_TIME, то функция ищет запись с тем же ut_type.
Если id->ut_type является INIT_PROCESS, LOGIN_PROCESS, USER_PROCESS, илиc DEAD_PROCESS, getutid() ищет первую запись с тем же ut_type и полем ut_id, которое совпадает с id->ut_id.

Если getutid() достигнет EOF, не найдя при этом совпадение, она завершит выполнение.

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

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

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

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

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

Unix

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

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

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

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

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

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

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

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

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