Майкл Джонсон - Разработка приложений в среде Linux. Второе издание

Ниже приведены интерфейсы, определяемые XPG2, SVID 2 и FSSTND 1.2.

#include

int utmpname(char * file);

struct utmp *getutent(void);

struct utmp *getutid(const struct utmp * id);

struct utmp *getutline(const struct utmp * line);

struct utmp *pututline(const struct utmp * ut);

void setutent(void);

void endutent(void);

void updwtmp(const char * file, const struct utmp * ut);

void logwtmp(const char * line, const char * name, const char * host);

Каждая запись в базе данных utmp или wtmp называется строкой. Все функции, возвращающие указатель на struct utmp, возвращают его на статические данные в случае успеха и NULL— в случае ошибки. Обратите внимание, что статические данные переписаны каждым новым вызовом на каждую функцию, возвращающую struct utmp. Также стандарт POSIX (для utmpx) требует очистки статических данных приложением перед началом какого-либо поиска.

Версии utmpx этих функций принимают struct utmpxвместо struct utmp, требуют включения utmpx.hи называются getutxent, getutxid, getutxline, pututxline, setutxentи endutxent, но в другом случае они идентичны версиям utmp этих функций в Linux. Функции utmpxname(), определенной POSIX, не существует, хотя некоторые платформы могут определять ее в любом случае (например, glibc).

Функция utmpname()используется для определения просматриваемой базы данных. Базой данных по умолчанию является utmp, но вместо этого функцию можно применять для указания на wtmp. Два предопределенных имени — это _PATH_UTMPдля файла utmp и _PATH_WTMPдля файла wtmp; для целей тестирования можно выбрать указатель на локальную копию. Функция utmpname()возвращает ноль в случае успеха и ненулевое значение в случае ошибки. Но успех может означать просто то, что имя файла удалось скопировать в библиотеку; это не означает, что база данных действительно существует в пути, предоставленном для нее.

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

Функция getutid()принимает struct utmpи рассматривает лишь один или два элемента. Если ut_typeявляется BOOT_TIME, OLD_TIMEили NEW_TIME, она возвращает следующую строку этого типа. Если ut_typeявляется INIT_PROCESS, LOGIN_PROCESS, USER_PROCESSили DEAD_PROCESS, тогда getutid()возвращает следующую строку, которая соответствует любому из типов, также имеющему значение ut_id, которое соответствует значению ut_idв struct utmp, передаваемой getutid(). Перед повторным вызовом потребуется удалить из struct utmpданные, возвращаемые getutid(); POSIX разрешает возвращать ту же строку, что и предыдущий вызов. Если соответствующих строк нет, возвращается NULL.