Читаем Linux API. Исчерпывающее руководство полностью

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 *file);

Возвращает 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

40.5. Получение имени текущего пользователя: getlogin()

Функция getlogin() возвращает имя пользователя, который работает в контролирующем терминале вызывающего процесса. Она использует информацию, хранящуюся в файле utmp.

#include

char *getlogin(void);

Возвращает указатель на строку с именем пользователя или NULL при ошибке

Чтобы получить имя терминала, связанного со стандартным вводом вызывающего процесса, функция getlogin() выполняет вызов ttyname() (см. раздел 58.10). Затем она ищет в файле utmp запись, значение ut_line которой совпадает с этим именем. Если такая запись нашлась, то getlogin() возвращает ее поле ut_user.