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

В API glibc (начиная с версии 2.3) каждое поле меток времени определяется как структура timespec (мы рассмотрим ее, когда будем говорить о системном вызове utimensat() далее в этом разделе), которая представляет время в виде секундного и наносекундного компонентов. Соответствующие макроопределения позволяют увидеть второй компонент таких структур благодаря использованию традиционных имен полей (st_atime, st_mtime и st_ctime). Доступ к наносекундным компонентам можно получить с помощью таких имен полей, как st_atim.tv_nsec (для наносекундного компонента времени последнего доступа к файлу).

15.2.1. Изменение меток времени файла с помощью системных вызовов utime() и utimes()

Метки времени последнего доступа к файлу или его изменения, хранящиеся в индексном дескрипторе файла, можно явным образом изменить с помощью системного вызова utime() или другого из связанного набора системных вызовов. Такие программы, как tar(1) и unzip(1), используют эти системные вызовы для переустановки меток времени файла при распаковке архива.

#include

int utime(const char *pathname, const struct utimbuf *buf);

Возвращает 0 при успешном завершении и –1 при ошибке

Аргумент pathname идентифицирует файл, метки времени которого мы желаем изменить. Если этот аргумент является символической ссылкой, она разыменовывается. Аргумент buf может либо быть равен NULL, либо являться указателем на структуру utimbuf:

struct utimbuf {

time_t actime; /* Время доступа */

time_t modtime; /* Время изменения */

};

Поля в этой структуре приводят время в секундах, прошедшее с начала «эры UNIX» (см. раздел 10.1).

Характер работы системного вызова utime() определяется двумя различными случаями.

• Если для аргумента buf задано значение NULL, то для времени последнего доступа и для времени последнего изменения задается значение текущего времени. В данном случае либо действующий UID для процесса должен соответствовать идентификатору пользователя (владельца) для файла, либо процесс должен обладать правами на запись файла (что логично, поскольку процесс с разрешением на запись файла мог бы повлечь за собой другие системные вызовы, которые привели бы к побочному эффекту изменения этих меток времени файла), либо указанный процесс должен быть привилегированным (CAP_FOWNER или CAP_DAC_OVERRIDE). (Если точнее, то в Linux с UID файла сравнивается пользовательский идентификатор процесса в данной файловой системе, а не действующий UID, как описано в разделе 9.5.).

• Если аргумент buf определен как указатель на структуру utimbuf, то время последнего доступа и время изменения обновляются с применением значений соответствующих полей этой структуры. В таком случае действующий UID для процесса должен совпадать с UID для файла (обладать правами на запись файла здесь недостаточно), либо вызывающий процесс должен быть привилегирован (CAP_FOWNER).

Чтобы изменить только одну метку времени файла, следует сначала использовать системный вызов stat() для извлечения обеих меток, применить одно из значений времени для инициализации структуры utimbuf, а затем установить по желанию значение второй. Этот алгоритм продемонстрирован в приведенном ниже коде, который устанавливает для времени последнего изменения файла значение времени последнего доступа к нему:

struct stat sb;

struct utimbuf utb;

if (stat(pathname, &sb) == -1)

errExit("stat");

utb.actime = sb.st_atime; /* Оставить время доступа без изменений */

utb.modtime = sb.st_atime;

if (utime(pathname, &utb) == -1)

errExit("utime");

При успешном завершении вызова utime() для времени последнего изменения статуса всегда устанавливается значение текущего времени.

В Linux есть также заимствованный из системы BSD системный вызов utimes(), выполняющий задачу, сходную с задачей utime().

#include

int utimes(const char *pathname, const struct timeval tv[2]);

Возвращает 0 при успешном завершении и –1 при ошибке

Самым заметным различием между системными вызовами utime() и utimes() является то, что второй позволяет указывать значения времени с микросекундной точностью (структура timeval описана в разделе 10.1). Это обеспечивает (частичный) доступ к наносекундной точности, которую имеют метки времени в Linux 2.6. Новое время доступа к файлу указывается в поле tv[0], а новое время изменения файла — в tv[1].

Пример использования системного вызова utimes() есть в файле files/t_utimes.c, представленном в исходном коде к данной книге.

Библиотечные функции futimes() и lutimes() работают подобно системному вызову utimes(). Они отличаются от него аргументом, служащим для указания файла, метки времени которого следует изменить.

#include

int futimes(int fd, const struct timeval tv[2]);

int lutimes(const char *pathname, const struct timeval tv[2]);

Оба вызова возвращают 0 при успешном завершении и –1 при ошибке

Для функции futimes() файл указывается через открытый файловый дескриптор, fd.