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 требуют многократного обращения к удаленным компьютерам.

СМ. ТАКЖЕ
stat(2).

ДИАГНОСТИКА
При успешном завершении результат равен 0; в случае ошибки возвращается -1, а переменной errno присваивается код ошибки.