if (res!= NULL) /* Если значение 'res' было установлено предыдущим вызовом */
memset(res, 0, sizeof(struct utmpx));
res = getutxline(&ut);
Библиотека glibc не выполняет подобного кэширования, но для обеспечения портируемости все равно следует выполнять данное обнуление.
Функции getutx*() возвращают указатель на статически выделенную структуру, поэтому не могут быть реентерабельными. Библиотека GNU языка C предоставляет такие версии традиционных функций для работы со структурой utmp (getutent_r(), getutid_r() и getutline_r()), но подобных аналогов для utmpx не существует (реентерабельные функции не предусмотрены в стандарте SUSv3).
Функции getutx*() по умолчанию работают со стандартным файлом utmp. Чтобы использовать другой файл (например, wtmp), следует вызвать функцию utmpxname() и указать нужный путь.
#define _GNU_SOURCE
#include
int utmpxname(const char *
Возвращает 0 при успешном завершении или -1 при ошибке
Функция utmpxname() всего лишь записывает копию переданного ей пути. Она не занимается открытием файлов, но закрывает открытые предыдущими вызовами. Это значит, что utmpxname() не возвращает ошибки, если указать неверный путь. Ошибка произойдет позже, когда одна из функций вида getutx*() не сможет открыть заданный файл (то есть будет возвращено значение NULL, а errno будет присвоено значение ENOENT).
Функция utmpxname() не входит в стандарт SUSv3, но большинство реализаций UNIX предоставляют либо ее, либо один из аналогов utmpname().
Программа, представленная в листинге 40.2, выводит содержимое файла формата utmpx с помощью некоторых из рассмотренных выше функций.
Листинг 40.2. Вывод содержимого файла формата utmpx
loginacct/dump_utmpx.c
#define _GNU_SOURCE
#include
#include
#include
#include "tlpi_hdr.h"
int
main(int argc, char *argv[])
{
struct utmpx *ut;
if (argc > 1 && strcmp(argv[1], "-help") == 0)
usageErr("%s [utmp-pathname]\n", argv[0]);
if (argc > 1) /* Если указан другой файл, используем его */
if (utmpxname(argv[1]) == -1)
errExit("utmpxname");
setutxent();
printf("user type PID line id host date/time\n");
while ((ut = getutxent())!= NULL) { /* Последовательный поиск до конца файла */
printf("%-8s", ut->ut_user);
printf("%-9.9s",
(ut->ut_type == EMPTY)? "EMPTY":
(ut->ut_type == RUN_LVL)? "RUN_LVL":
(ut->ut_type == BOOT_TIME)? "BOOT_TIME":
(ut->ut_type == NEW_TIME)? "NEW_TIME":
(ut->ut_type == OLD_TIME)? "OLD_TIME":
(ut->ut_type == INIT_PROCESS)? "INIT_PR":
(ut->ut_type == LOGIN_PROCESS)? "LOGIN_PR":
(ut->ut_type == USER_PROCESS)? "USER_PR":
(ut->ut_type == DEAD_PROCESS)? "DEAD_PR": "???");
printf("%5ld %-6.6s %-3.5s %-9.9s", (long) ut->ut_pid,
ut->ut_line, ut->ut_id, ut->ut_host);
printf("%s", ctime((time_t *) &(ut->ut_tv.tv_sec)));
}
endutxent();
exit(EXIT_SUCCESS);
}
loginacct/dump_utmpx.c
Листинг сессии, приведенный ниже, демонстрирует результаты работы этой программы на примере файла /var/run/utmp (используется по умолчанию, если не вызвать функцию utmpxname()):
$ ./dump_utmpx
user type PID line id host date/time
LOGIN LOGIN_PR 1761 tty1 1 Sat Oct 23 09:29:37 2010
LOGIN LOGIN_PR 1762 tty2 2 Sat Oct 23 09:29:37 2010
lynley USER_PR 10482 tty3 3 Sat Oct 23 10:19:43 2010
david USER_PR 9664 tty4 4 Sat Oct 23 10:07:50 2010
liz USER_PR 1985 tty5 5 Sat Oct 23 10:50:12 2010
mtk USER_PR 10111 pts/0 /0 Sat Oct 23 09:30:57 2010
Здесь не приводится большая часть вывода, чтобы сделать его более лаконичным. Строчки со значениями с tty1 по tty5 относятся ко входу в систему из виртуальных консолей (/dev/tty[1–6]). Последняя строка описывает сессию xterm в псевдотерминале.
Вывод содержимого файла /var/log/wtmp, приведенный ниже, показывает, что при входе в систему и выходе из нее в данный файл добавляется две записи (все остальные строки, выведенные программой, выброшены). Выполнив последовательный поиск по файлу wtmp (с помощью функции getutxline()), можно отфильтровать эти записи по полю ut_line.
$ ./dump_utmpx /var/log/wtmp
user type PID line id host date/time
lynley USER_PR 10482 tty3 3 Sat Oct 23 10:19:43 2010
DEAD_PR 10482 tty3 3 2.4.20-4G Sat Oct 23 10:32:54 2010
Функция getlogin() возвращает имя пользователя, который работает в контролирующем терминале вызывающего процесса. Она использует информацию, хранящуюся в файле utmp.
#include
char *getlogin(void);
Возвращает указатель на строку с именем пользователя или NULL при ошибке
Чтобы получить имя терминала, связанного со стандартным вводом вызывающего процесса, функция getlogin() выполняет вызов ttyname() (см. раздел 58.10). Затем она ищет в файле utmp запись, значение ut_line которой совпадает с этим именем. Если такая запись нашлась, то getlogin() возвращает ее поле ut_user.