Server for Information Technologies Сервер поддерживается
Центром Информационных Технологий
(095) 932-9212, 932-9213, 939-0783
E-mail: info@citforum.ru
Сервер содержит море(!) аналитической информации CIT Forum CD-ROM

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

Comments: info@citmgu.ru
Designed by Andrey Novikov
Copyright © CIT
Обновлено: 13.03.2015