UTIME(2) UTIME(2)
НАЗВАНИЕ
utime - установка времени доступа и модификации файла
СИНТАКСИС
#include
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 присваивает-
ся код ошибки.
|