الاسم¶

PR_PAC_RESET_KEYS - إعادة تعيين مفاتيح رمز المصادقة على المؤشر للخيط المستدعي

المكتبة¶

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

موجز¶

#include <linux/prctl.h>  /* تعريف ثوابت PR_* */
#include <sys/prctl.h>

int prctl(PR_PAC_RESET_KEYS, unsigned long keys, 0L, 0L, 0L);

الوصف¶

إعادة تعيين مفاتيح مصادقة المؤشر للخيط بشكل آمن إلى قيم عشوائية جديدة يولّدها النواة.

يُحدد مجموعة المفاتيح المراد إعادة تعيينها بواسطة keys، والتي يجب أن تكون OR منطقية لواحد أو أكثر مما يلي:

PR_PAC_APIAKEY

مفتاح مصادقة التعليمات A

PR_PAC_APIBKEY

مفتاح مصادقة التعليمات B

PR_PAC_APDAKEY

مفتاح مصادقة البيانات A

PR_PAC_APDBKEY

مفتاح مصادقة البيانات B

PR_PAC_APGAKEY

مفتاح المصادقة العام “A”.

(نعم أيها الناس، لا يوجد حقًا مفتاح عام B.)

كحالة خاصة، إذا كان keys صفرًا، فسيتم إعادة تعيين جميع المفاتيح. نظرًا لإمكانية إضافة مفاتيح جديدة في المستقبل، فهذه هي الطريقة الموصى بها لمسح المفاتيح الحالية بالكامل عند إنشاء سياق تنفيذ نظيف.

لا حاجة لاستخدام PR_PAC_RESET_KEYS استعدادًا لاستدعاء execve(2)، لأن execve(2) يعيد تعيين جميع مفاتيح مصادقة المؤشر.

قيمة الإرجاع¶

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

الأخطاء¶

EINVAL

يحتوي keys على بتات مضبوطة غير صالحة أو غير مدعومة على هذه المنصة.

المعايير¶

لينكس. arm64 فقط.

التاريخ¶

لينكس 5.0 (arm64).

تحذيرات¶

نظرًا لأن المترجم أو بيئة التشغيل قد تستخدم بعضًا أو كل المفاتيح، فقد يؤدي نجاح PR_PAC_RESET_KEYS إلى تعطل العملية المستدعية. شروط استخدامه بأمان معقدة وتعتمد على النظام. لا تستخدمه إلا إذا كنت تعرف ما تفعله.

انظر أيضًا¶

prctl(2)

لمزيد من المعلومات، راجع ملف مصدر النواة Documentation/arch/arm64/pointer-authentication.rst.

ترجمة¶

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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