futimesat(2)

الاسم
futimesat - تغيير أختام زمنية لملف نسبةً إلى واصف ملف دليل

المكتبة
مكتبة سي المعيارية (libc، -lc)

موجز
#include <fcntl.h>            /* تعريف ثوابت AT_* */
#include <sys/time.h>

[[مهمل]] int futimesat(int dirfd, const char *path,
                             const struct timeval times[2]);

    متطلبات ماكروات اختبار الميزات لـ glibc (انظر feature_test_macros(7)):

futimesat():
    _GNU_SOURCE

الوصف
استدعاء النظام هذا مهمل. استخدم utimensat(2) بدلاً منه.

يعمل استدعاء النظام futimesat() بنفس طريقة utimes(2) تماماً، باستثناء الاختلافات الموصوفة في صفحة الدليل هذه.

إذا كان path نسبياً، يُفسر بالنسبة إلى الدليل المشار إليه بواسطة واصف الملف dirfd (بدلاً من التفسير بالنسبة إلى دليل العمل الحالي للعملية المستدعية، كما تفعل utimes(2) لمسار نسبي).

إذا كان المسار path نسبيا وكان dirfd هو القيمة الخاصة AT_FDCWD، فسيُفسر path نسبة إلى دليل العمل الحالي للعملية المستدعِيَة (مثل utimes(2)).

إذا كان path مطلقاً، يُتجاهل dirfd. (انظر openat(2) لشرح سبب فائدة وسيط dirfd.)

قيمة الإرجاع
عند النجاح، تُرجع futimesat() 0. عند الخطأ، تُرجع -1 ويُضبط errno للإشارة إلى الخطأ.

الأخطاء
نفس الأخطاء التي تحدث لـ utimes(2) يمكن أن تحدث أيضًا لـ futimesat(). يمكن أن تحدث الأخطاء الإضافية التالية لـ futimesat():

EBADF
    المسار path نسبي ولكن dirfd ليس AT_FDCWD ولا واصف ملف صالح.

ENOTDIR
    المسار path نسبي و dirfd هو واصف ملف يشير إلى ملف غير الدليل.

الإصدارات

  glibc
إذا كان path NULL، تُحدّث دالة الغلاف glibc futimesat() الأوقات للملف المشار إليه بواسطة dirfd.

المعايير
لا شيء.

التاريخ
لينكس 2.6.16، glibc 2.4.

نُفذ من مواصفة قُدمت لـ POSIX.1، لكن تلك المواصفة استُبدلت بمواصفة utimensat(2).

يوجد استدعاء نظام مشابه على Solaris.

ملاحظات

انظر أيضًا
stat(2), utimensat(2), utimes(2), futimes(3), path_resolution(7)

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.