ИМЯ

       futimesat - изменяет временные отметки файла, определяемого относительно файлового дескриптора каталога

LIBRARY

       Standard C library (libc, -lc)

СИНТАКСИС

       #include <fcntl.h>            /* определения констант AT_* */
       #include <sys/time.h>

       [[deprecated]] int futimesat(int dirfd, const char *pathname,
                                    const struct timeval times[2]);

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

       futimesat():
           _GNU_SOURCE

ОПИСАНИЕ

       Данный системный вызов устарел. Используйте вместо него utimensat(2).

       Системный  вызов  futimesat()  работает  также  как  системный  вызов  utimes(2), за исключением случаев,
       описанных в данной справочной странице.

       Если в pathname задан относительный путь, то он считается относительно  каталога,  на  который  ссылается
       файловый  дескриптор  dirfd  (а  не относительно текущего рабочего каталога вызывающего процесса, как это
       делается в utimes(2)).

       Если в pathname задан относительный путь и  dirfd  равно  специальному  значению  AT_FDCWD,  то  pathname
       рассматривается относительно текущего рабочего каталога вызывающего процесса (как utimes(2)).

       If  pathname  is  absolute,  then  dirfd  is ignored.  (See openat(2) for an explanation of why the dirfd
       argument is useful.)

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

       При успешном выполнении futimesat() возвращает 0; при ошибке — -1, а в errno задаётся причина ошибки.

ОШИБКИ

       В futimesat() могут возникнуть те же ошибки, что и в utimes(2). Также,  в  futimesat()  могут  возникнуть
       следующие ошибки:

       EBADF  В  pathname  содержится  относительный  путь,  но  значение  dirfd не равно AT_FDCWD и не является
              правильным файловым дескриптором.

       ENOTDIR
              Значение pathname содержит относительный путь и dirfd содержит файловый дескриптор, указывающий на
              файл, а не на каталог.

ВЕРСИИ

       futimesat()  was added in Linux 2.6.16; library support was added in glibc 2.4.

СТАНДАРТЫ

       Данный системный вызов не является стандартным. Он был реализован по спецификации POSIX.1,  но  она  была
       заменена на utimensat(2).

       Подобный системный вызов есть в Solaris.

ЗАМЕЧАНИЯ

   Замечания по glibc
       Если  pathname  равно  NULL,  то  обёрточная  функция  glibc futimesat() обновляет временные метки файла,
       указанного в dirfd.

СМ. ТАКЖЕ

       stat(2), utimensat(2), utimes(2), futimes(3), path_resolution(7)

ПЕРЕВОД

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

       Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3
       или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

       Если  вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо
       на man-pages-ru-talks@lists.sourceforge.net.

Linux man-pages 6.03                            5 февраля 2023 г.                                   futimesat(2)