futimesat(2)

ИМЯ
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 notes
Если 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 (https://www.gnu.org/licenses/gpl-3.0.html) или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

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