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