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 присваивается код ошибки.