lookup_dcookie(2)

الاسم
lookup_dcookie - إرجاع مسار إدخال دليل

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

موجز
#include <sys/syscall.h>      /* تعريف ثوابت SYS_* */
#include <unistd.h>

int syscall(size_t size;
            SYS_lookup_dcookie, uint64_t cookie, char buffer[size],
            size_t size);

ملاحظة: لا توفر glibc غلافًا لـ lookup_dcookie()، مما يستلزم استخدام syscall(2).

الوصف
ابحث عن المسار الكامل لإدخال الدليل المحدد بالقيمة cookie. الكوكي هو معرّف غير شفاف يحدد بشكل فريد إدخال دليل معين. يتم ملء المخزن المؤقت المعطى بالمسار الكامل لإدخال الدليل.

لكي يعيد lookup_dcookie() بنجاح، يجب أن يحتفظ النواة بمرجع كوكي لإدخال الدليل.

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

الأخطاء

EFAULT
    المخزن المؤقت غير صالح.

EINVAL
    لا تحتوي النواة على تعيينات كوكي/إدخال دليل مسجلة وقت البحث، أو لا تشير الكوكي إلى إدخال دليل صالح.

ENAMETOOLONG
    لا يمكن للاسم أن يتسع في المخزن المؤقت.

ENOMEM
    لم تستطع النواة تخصيص ذاكرة للمخزن المؤقت المؤقت الذي يحمل المسار.

EPERM
    لا تمتلك العملية القدرة CAP_SYS_ADMIN المطلوبة للبحث عن قيم الكوكي.

ERANGE
    المخزن المؤقت ليس كبيرًا بما يكفي لحمل مسار إدخال الدليل.

المعايير
لينكس.

التاريخ
لينكس 2.5.43.

أُضيف خطأ ENAMETOOLONG في لينكس 2.5.70.

ملاحظات
lookup_dcookie() هو استدعاء نظام لأغراض خاصة، يُستخدم حاليًا فقط بواسطة ملف تعريف oprofile(1). يعتمد على برنامج تشغيل نواة لتسجيل الكوكيز لإدخالات الدليل.

قد يُلحق المسار المُعاد بالسلسلة " (محذوف)" إذا تمت إزالة إدخال الدليل.

انظر أيضًا
oprofile(1)

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

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

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