utime

ИМЯ

utime, utimes - изменить последнее время доступа и изменения к inode

LIBRARY

Standard C library ( libc, -lc)

СИНТАКСИС

#include <utime.h>

int utime(const char *filename,
          const struct utimbuf *_Nullable times);

#include <sys/time.h>

int utimes(const char *filename,
          const struct timeval times[_Nullable 2]);

ОПИСАНИЕ

Замечание: современным приложениям лучше использовать интерфейсы, описанные в utimensat(2). The utime() system call changes the access and modification times of the inode specified by filename to the actime and modtime fields of times respectively. The status change time (ctime) will be set to the current time, even if the other time stamps don't actually change. Если значение times равно NULL, то время доступа и изменения файла устанавливаются в текущее время. Изменение временных меток разрешено если: процесс имеет соответствующие права или эффективный пользовательский идентификатор равен пользовательскому идентификатору файла, или значение times равно NULL и процесс имеет права на запись в файл. Структура utimbuf выглядит так:

struct utimbuf {
    time_t actime;       /* время доступа */
    time_t modtime;      /* время изменения */
};

Системный вызов utime() позволяет указывать временные метки с точностью до 1 секунды. Системный вызов utimes() выполняет подобное действие, но аргумент times указывает на массив, а не на структуру. Элементы массива представляют собой структуры timeval, с помощью которых можно указывать временные метки с точностью до 1 микросекунды . Структура timeval:

struct timeval {
    long tv_sec;        /* секунды */
    long tv_usec;       /* микросекунды */
};

В times[0] задаётся новое время доступа, а в times[1] новое время изменения. Если значение times равно NULL, то аналогично utime(), время доступа и изменения файла устанавливаются в текущее время.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

On success, zero is returned. On error, -1 is returned, and errno is set to indicate the error.

ОШИБКИ

EACCES

Запрещён поиск в одном из каталогов пути path (см. также path_resolution(7)).

EACCES

Значение times равно NULL, эффективный пользовательский идентификатор вызывающего процесса не совпадает с владельцем файла, вызывающий не имеет права на запись в файл, и у вызывающего нет привилегий (Linux: не имеет мандата CAP_DAC_OVERRIDE или CAP_FOWNER).

ENOENT

Файл filename не существует.

EPERM

Значение times не равно NULL, эффективный пользовательский идентификатор вызывающего процесса не совпадает с владельцем файла и у вызывающего нет привилегий (Linux: не имеет мандата CAP_FOWNER).

EROFS

path располагается на файловой системе, доступной только для чтения.

СТАНДАРТЫ

utime(): SVr4, POSIX.1-2001. В POSIX.1-2008 вызов utime() помечен как устаревший. utimes(): 4.3BSD, POSIX.1-2001.

ЗАМЕЧАНИЯ

В Linux нельзя изменять временные метки у недосягаемых (immutable) файлов или задавать временные метки, отличные от текущего времени для файлов, в которые можно только дописывать.

СМ. ТАКЖЕ

chattr(1), touch(1), futimesat(2), stat(2), utimensat(2), futimens(3), futimes(3), inode(7)

ПЕРЕВОД

Русский перевод этой страницы руководства был сделан Azamat Hackimov <[email protected]>, Dmitriy Ovchinnikov <[email protected]>, Dmitry Bolkhovskikh <[email protected]>, Katrin Kutepova <[email protected]>, Yuri Kozlov <[email protected]> и Иван Павлов <[email protected]> Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на [email protected]