.\" -*- 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 "3 декабря 2022 г." "Linux man\-pages 6.03" .SH ИМЯ utime, utimes \- изменить последнее время доступа и изменения к inode .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .PP \fBint utime(const char *\fP\fIfilename\fP\fB,\fP \fB const struct utimbuf *_Nullable \fP\fItimes\fP\fB);\fP .PP \fB#include \fP .PP \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). .PP 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. .PP Если значение \fItimes\fP равно NULL, то время доступа и изменения файла устанавливаются в текущее время. .PP Изменение временных меток разрешено если: процесс имеет соответствующие права или эффективный пользовательский идентификатор равен пользовательскому идентификатору файла, или значение \fItimes\fP равно NULL и процесс имеет права на запись в файл. .PP Структура \fIutimbuf\fP выглядит так: .PP .in +4n .EX struct utimbuf { time_t actime; /* время доступа */ time_t modtime; /* время изменения */ }; .EE .in .PP Системный вызов \fButime\fP() позволяет указывать временные метки с точностью до 1 секунды. .PP Системный вызов \fButimes\fP() выполняет подобное действие, но аргумент \fItimes\fP указывает на массив, а не на структуру. Элементы массива представляют собой структуры \fItimeval\fP, с помощью которых можно указывать временные метки с точностью до 1 микросекунды . Структура \fItimeval\fP: .PP .in +4n .EX struct timeval { long tv_sec; /* секунды */ long tv_usec; /* микросекунды */ }; .EE .in .PP В \fItimes[0]\fP задаётся новое время доступа, а в \fItimes[1]\fP новое время изменения. Если значение \fItimes\fP равно NULL, то аналогично \fButime\fP(), время доступа и изменения файла устанавливаются в текущее время. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" On success, zero is returned. On error, \-1 is returned, and \fIerrno\fP is set to indicate the error. .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 СТАНДАРТЫ \fButime\fP(): SVr4, POSIX.1\-2001. В POSIX.1\-2008 вызов \fButime\fP() помечен как устаревший. .PP \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 Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .