utime()

Записать время модификации файла или каталога

Прототип:

#include <sys/types.h>
#include <utime.h>
int utime( const char *path,
const struct utimbuf *times );

Аргументы:

path
Путевое имя файла, для которого необходимо получить или установить время модификации (изменения).
times
NULL, или указатель на структуру struct utimbuf, в которой будет сохранено время модификации.

Библиотека:

libc

Описание:

Функция utime() записывает время модификации файла или каталога, указанного в параметре path.

Если параметр times равен NULL, времена доступа и модификации файла или каталога будут установлены в значение текущего времени. Действующий (эффективный) идентификатор пользователя процесса (user ID) должен совпадать с идентификатором владельца файла или иметь права на запись в данный файл или каталог, или соответствующие привилегии для использования функции utime().

Если параметр times не равен NULL, то он интерпретируется как указатель на структуру struct utimbuf и времена доступа и модификации файла или каталога будут установлены в соответствии со значениями элементов этой структуры. Только владельцу файла или каталога и процессам с соответствующими привилегиями разрешено использовать функцию utime() подобным образом. Времена доступа и модификации берутся из полей и modtime структуры struct utimbuf.

Возвращаемое значение:

0
Успешное завершение.
-1
Возникла ошибка. Код ошибки записан в errno.

Коды ошибок:

EACCES
Отсутствует разрешение на поиск компонента пути path, либо параметр times равен NULL и эффективный user ID не соответствует владельцу файла, или нет прав на запись.
ENAMETOOLONG
Длина параметра path превышает значение PATH_MAX, или длина компонента путевого имени превышает значение NAME_MAX..
ENOENT
Компонент в пути path не является существующим именем файла, или path является пустой строкой.
ENOTDIR
Компонент пути path не является каталогом.
EPERM
Параметр times не равен NULL, а эффективный user ID имеет доступ на запись в файл, но не соответствует владельцу файла, или вызывающий процесс не имеет соответствующих привилегий.
EROFS
Файловая система, в которой находится файл, доступна только по чтению (read-only ФС).

Примеры:

#include <stdio.h>
#include <stdlib.h>
#include <utime.h>
int main( int argc, char *argv[] )
{
if ( (utime( argv[1], NULL ) != 0) && (argc > 1) )
{
printf( "Невозможно установить время для %s\n", argv[1] );
}
return (EXIT_SUCCESS);
}

Классификация:

POSIX 1003.1

Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

struct utimbuf, errno, futime()




Предыдущий раздел: Описание API системной библиотеки