.\" -*- coding: UTF-8 -*- .\" Copyright 1992, Drew Eckhardt .\" 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 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم utime, utimes \- تغيير أوقات آخر وصول وتعديل للملف .SH المكتبة مكتبة سي المعيارية (\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 يغير استدعاء النظام \fButime\fP() أوقات الوصول والتعديل لعقدة inode المحددة بواسطة \fIpath\fP إلى حقلي \fIactime\fP و \fImodtime\fP من \fItimes\fP على التوالي. سيتم تعيين وقت تغيير الحالة (ctime) إلى الوقت الحالي، حتى لو لم تتغير الطوابع الزمنية الأخرى فعليًا. .P إذا كان \fItimes\fP فارغًا (NULL)، فسيتم تعيين أوقات الوصول والتعديل للملف إلى الوقت الحالي. .P يُسمح بتغيير الطوابع الزمنية عندما: إما أن تمتلك العملية الصلاحيات المناسبة، أو أن معرف المستخدم الفعلي يساوي معرف مستخدم الملف، أو أن \fItimes\fP فارغ وتمتلك العملية إذن الكتابة للملف. .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 فارغًا، فبشكل مماثل لـ \fButime\fP()، يتم تعيين أوقات الوصول والتعديل للملف إلى الوقت الحالي. .SH "قيمة الإرجاع" عند النجاح، يُعاد الصفر. وعند حدوث خطأ، يُعاد الرقم \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEACCES\fP تم رفض إذن البحث لأحد الدلائل في بادئة المسار لـ \fIpath\fP (انظر أيضًا \fBpath_resolution\fP(7)). .TP \fBEACCES\fP \fItimes\fP فارغ، معرف المستخدم الفعلي للمتصل لا يطابق مالك الملف، لا يمتلك المتصل إذن الكتابة للملف، والمتصل ليس له صلاحيات (لينكس: لا يمتلك إمكانية \fBCAP_DAC_OVERRIDE\fP أو \fBCAP_FOWNER\fP). .TP \fBEFAULT\fP يشير \fIpath\fP إلى عنوان غير صالح. .TP \fBENOENT\fP \fIpath\fP غير موجود. .TP \fBEPERM\fP \fItimes\fP ليس فارغًا، معرف المستخدم الفعلي للمتصل لا يطابق مالك الملف، والمتصل ليس له صلاحيات (لينكس: لا يمتلك إمكانية \fBCAP_FOWNER\fP). .TP \fBEROFS\fP يقع \fIpath\fP على نظام ملفات للقراءة فقط. .SH المعايير .TP \fButime\fP() لا شيء. .TP \fButimes\fP() POSIX.1\-2024. .SH التاريخ .TP \fButime\fP() SVr4, POSIX.1\-2001. مهمل في POSIX.1\-2008. تمت إزالته في POSIX.1\-2024. .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. لا يسمح لينكس بتغيير الطوابع الزمنية على ملف غير قابل للتغيير، أو تعيين الطوابع الزمنية إلى شيء غير الوقت الحالي على ملف للإلحاق فقط. .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 ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .