.\" -*- coding: UTF-8 -*- .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH utime 2 "17 мая 2025 г." "Справочные страницы Linux 6.15" .SH НАИМЕНОВАНИЕ utime, utimes \- изменить последнее время доступа и изменения к inode .SH БИБЛИОТЕКА Стандартная библиотека языка C (\fIlibc\fP,\ \fI\-lc\fP) .SH ОБЗОР .nf \fB#include \fP .P \fBint utime(const char *\fP\fIpath\fP\fB,\fP \fB const struct utimbuf *_Nullable \fP\fItimes\fP\fB);\fP .P \fB#include \fP .P \fBint utimes(const char *\fP\fIpath\fP\fB,\fP \fB const struct timeval \fP\fItimes\fP\fB[_Nullable 2]);\fP .fi .SH ОПИСАНИЕ \fBЗамечание:\fP современным приложениям лучше использовать интерфейсы, описанные в \fButimensat\fP(2). .P The \fButime\fP() system call changes the access and modification times of the inode specified by \fIpath\fP to the \fIactime\fP and \fImodtime\fP fields of \fItimes\fP respectively. The status change time (ctime) will be set to the current time, even if the other time stamps don't actually change. .P Если значение \fItimes\fP равно NULL, то время доступа и изменения файла устанавливаются в текущее время. .P Изменение временных меток разрешено если: процесс имеет соответствующие права или эффективный пользовательский идентификатор равен пользовательскому идентификатору файла, или значение \fItimes\fP равно NULL и процесс имеет права на запись в файл. .P Структура \fIutimbuf\fP выглядит так: .P .in +4n .EX struct utimbuf { time_t actime; /* время доступа */ time_t modtime; /* время изменения */ }; .EE .in .P Системный вызов \fButime\fP() позволяет указывать временные метки с точностью до 1 секунды. .P Системный вызов \fButimes\fP() выполняет подобное действие, но аргумент \fItimes\fP указывает на массив, а не на структуру. Элементы массива представляют собой структуры \fItimeval\fP, с помощью которых можно указывать временные метки с точностью до 1 микросекунды . Структура \fItimeval\fP: .P .in +4n .EX struct timeval { long tv_sec; /* секунды */ long tv_usec; /* микросекунды */ }; .EE .in .P В \fItimes[0]\fP задаётся новое время доступа, а в \fItimes[1]\fP новое время изменения. Если значение \fItimes\fP равно NULL, то аналогично \fButime\fP(), время доступа и изменения файла устанавливаются в текущее время. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" При успешном выполнении возвращается 0. При ошибке возвращается \-1, а в \fIerrno\fP содержится код ошибки. .SH ОШИБКИ .TP \fBEACCES\fP Запрещён поиск в одном из каталогов пути \fIpath\fP (см. также \fBpath_resolution\fP(7)). .TP \fBEACCES\fP Значение \fItimes\fP равно NULL, эффективный пользовательский идентификатор вызывающего процесса не совпадает с владельцем файла, вызывающий не имеет права на запись в файл, и у вызывающего нет привилегий (Linux: не имеет мандата \fBCAP_DAC_OVERRIDE\fP или \fBCAP_FOWNER\fP). .TP \fBEFAULT\fP \fIpath\fP points to an invalid address. .TP \fBENOENT\fP \fIpath\fP does not exist. .TP \fBEPERM\fP Значение \fItimes\fP не равно NULL, эффективный пользовательский идентификатор вызывающего процесса не совпадает с владельцем файла и у вызывающего нет привилегий (Linux: не имеет мандата \fBCAP_FOWNER\fP). .TP \fBEROFS\fP \fIpath\fP располагается на файловой системе, доступной только для чтения. .SH СТАНДАРТЫ POSIX.1\-2008. .SH ИСТОРИЯ .TP \fButime\fP() SVr4, POSIX.1\-2001. POSIX.1\-2008 помечает его как устаревший. .TP \fButimes\fP() 4.3BSD, POSIX.1\-2001. .SH ПРИМЕЧАНИЯ .\" .\" In libc4 and libc5, .\" .BR utimes () .\" is just a wrapper for .\" .BR utime () .\" and hence does not allow a subsecond resolution. В Linux нельзя изменять временные метки у недосягаемых (immutable) файлов или задавать временные метки, отличные от текущего времени для файлов, в которые можно только дописывать. .SH "СМОТРИТЕ ТАКЖЕ" \fBchattr\fP(1), \fBtouch\fP(1), \fBfutimesat\fP(2), \fBstat\fP(2), \fButimensat\fP(2), \fBfutimens\fP(3), \fBfutimes\fP(3), \fBinode\fP(7) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства разработал(и) Azamat Hackimov , Dmitriy Ovchinnikov , Dmitry Bolkhovskikh , Katrin Kutepova , Yuri Kozlov , Иван Павлов и Kirill Rekhov . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT списка рассылки русских переводчиков .ME .