Scroll to navigation

futimesat(2) System Calls Manual 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() могут возникнуть следующие ошибки:

В pathname содержится относительный путь, но значение dirfd не равно AT_FDCWD и не является правильным файловым дескриптором.
Значение 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 (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

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

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