Scroll to navigation

futimes(3) Library Functions Manual futimes(3)

ИМЯ

futimes, lutimes - изменяют метки времени файла

БИБЛИОТЕКА

Стандартная библиотека языка C (libc, -lc)

СИНТАКСИС

#include <sys/time.h>
int futimes(int fd, const struct timeval tv[2]);
int lutimes(const char *filename, const struct timeval tv[2]);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

futimes(), lutimes():


Начиная с glibc 2.19:
_DEFAULT_SOURCE
В версии glibc 2.19 и более ранних:
_BSD_SOURCE

ОПИСАНИЕ

Функция futimes() изменяет время доступа и изменения файла также как это делает utimes(2); единственное отличие в том, что файл чьи временные метки изменяются, указывается в виде файлового дескриптора, fd, а не в виде пути.

Функция lutimes() изменяет время доступа и изменения файла также как это делает utimes(2); единственное отличие в том, что если filename является символьной ссылкой, то ссылка не разыменовывается — изменяются метки времени самой ссылки.

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

При успешном выполнении возвращается 0. При ошибке возвращается -1, а в errno содержится код ошибки.

ОШИБКИ

Возникают те же ошибки что и для utimes(2), а также дополнительно для futimes():

Значение fd не является правильным файловым дескриптором.
Нет доступа к файловой системе /proc.

Для lutimes() может возникать следующая дополнительная ошибка:

Ядро не поддерживает этот вызов; требуется Linux версии 2.6.22 или новее.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

Интерфейс Атрибут Значение
futimes(), lutimes() Безвредность в нитях MT-Safe

СТАНДАРТЫ

Linux, BSD.

ИСТОРИЯ

glibc 2.3.
glibc 2.6.

ПРИМЕЧАНИЯ

lutimes() is implemented using the utimensat(2) system call.

СМОТРИТЕ ТАКЖЕ

utime(2), utimensat(2), symlink(7)

ПЕРЕВОД

Русский перевод этой страницы руководства разработал(и) Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.

2 мая 2024 г. Справочные страницы Linux 6.8