.\" -*- coding: UTF-8 -*- .\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992 .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified by Michael Haardt .\" Modified 1993-07-24 by Rik Faith .\" Modified 1995-06-10 by Andries Brouwer .\" Modified 2004-06-23 by Michael Kerrisk .\" Modified 2004-10-10 by Andries Brouwer .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH utime 2 "2 мая 2024 г." "Справочные страницы Linux 6.9.1" .SH ИМЯ utime, utimes \- изменить последнее время доступа и изменения к inode .SH БИБЛИОТЕКА Стандартная библиотека языка C (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .P \fBint utime(const char *\fP\fIfilename\fP\fB,\fP \fB const struct utimbuf *_Nullable \fP\fItimes\fP\fB);\fP .P \fB#include \fP .P \fBint utimes(const char *\fP\fIfilename\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 \fIfilename\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 \fBENOENT\fP Файл \fIfilename\fP не существует. .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 marks it as obsolete. .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 и Иван Павлов . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT списка рассылки русских переводчиков .ME .