Unix Man (Справочное руководство)


UTIME(2)


UTIME(2)

НАЗВАНИЕ


utime - установка времени доступа и модификации файла

СИНТАКСИС

#include <sys/types.h>

int utime (path, times) char *path; struct utimbuf *times;

ОПИСАНИЕ


Системный вызов utime устанавливает времена доступа и модификации указанного файла. Аргумент path указывает маршрутное имя файла.

Если аргумент times равен NULL, в качестве времени доступа и модификации данного файла устанавливается текущее время. Чтобы использовать системный вызов utime таким образом, пользователь должен быть владельцем файла или иметь право на запись в данный файл.

Если аргумент times не равен NULL, он интерпретируется как указатель на структуру utimbuf, и времена доступа и модификации устанавливаются в соответствии со значениями, содержащимися в структуре. Таким способом использовать utime может только владелец файла или суперпользователь.

Время измеряется в секундах, начиная с 00:00:00 1 января 1970 года (по Гринвичу).

struct utimbuf { time_t actime; /* Время доступа */ time_t modtime; /* Время модификации */ };

Системный вызов utime завершается неудачей, если выполнено хотя бы одно из следующих условий:

[ENOENT] Указанный файл не существует. [ENOTDIR] Компонент маршрута не является каталогом. [EACCES] Нет права на поиск для компонента маршрута. [EPERM] Действующий идентификатор пользователя не является идентификатором суперпользователя или владельца файла и аргумент times не равен NULL. [EACCES] Действующий идентификатор пользователя не является идентификатором суперпользователя или владельца файла у аргумент times равен NULL и нет права на запись в файл. [EROFS] Файловая система, содержащая файл, подключена только на чтение. [EFAULT] Аргумент times не равен NULL и указывает за пределы отведенного процессу адресного пространства. [EFAULT] Аргумент path указывает за пределы отведенного процессу адресного пространства. [EINTR] Во время выполнения системного вызова перехвачен сигнал. [ENOLINK] Маршрутное имя path указывает на удаленный компьютер, связи с которым в данный момент нет. [EMULTIHOP] Компоненты path требуют многократного обращения к удаленным компьютерам.

СМ. ТАКЖЕ


.

ДИАГНОСТИКА


При успешном завершении результат равен 0; в случае ошибки возвращается -1, а переменной errno присваивается код ошибки.




Начало  Назад  Вперед



Книжный магазин