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