ERR_GET_LIB(3ssl)

الاسم
ERR_GET_LIB, ERR_GET_REASON, ERR_FATAL_ERROR \&- استخراج معلومات من رموز الأخطاء

موجز
 #include <openssl/err.h>

 int ERR_GET_LIB(unsigned long e);

 int ERR_GET_REASON(unsigned long e);

 int ERR_FATAL_ERROR(unsigned long e);

الوصف
يتكون رمز الخطأ الذي يُرجعه ERR_get_error() من رقم مكتبة ورمز سبب. يمكن استخدام ERR_GET_LIB() و ERR_GET_REASON() لاستخراج هذين.

يشير ERR_FATAL_ERROR() إلى ما إذا كان رمز خطأ معين خطأً قاتلاً.

يصف رقم المكتبة مكان حدوث الخطأ، ورمز السبب هو المعلومات حول ما حدث خطأ.

لكل مكتبة فرعية من OpenSSL رقم مكتبة فريد؛ رمز السبب فريد داخل كل مكتبة فرعية. لاحظ أن المكتبات المختلفة قد تستخدم نفس القيمة للإشارة إلى أسباب مختلفة.

رموز السبب ERR_R_... مثل ERR_R_MALLOC_FAILURE فريدة عالمياً. ومع ذلك، عند التحقق من رموز سبب خاصة بمكتبة فرعية، تأكد من مقارنة رقم المكتبة أيضاً.

ERR_GET_LIB() و ERR_GET_REASON() و ERR_FATAL_ERROR() هي وحدات ماكرو.

القيم المُرجعة
رقم المكتبة، ورمز السبب، وما إذا كان الخطأ قاتلاً، على التوالي. بدءاً من OpenSSL 3.0.0، يُضبط رمز الدالة دائماً على الصفر.

ملاحظات
لا ينبغي للتطبيقات اتخاذ قرارات تدفق تحكم بناءً على رموز خطأ محددة. رموز الأخطاء قابلة للتغيير في أي وقت (حتى في إصدارات التصحيح من OpenSSL). لا يمكن اعتبار رمز خطأ معين ذا معنى لقرارات تدفق التحكم إلا إذا تم توثيقه صراحةً على هذا النحو. قد تظهر رموز فشل جديدة في أي وقت.

انظر أيضًا
ERR_get_error(3)

التاريخ
ERR_GET_LIB() و ERR_GET_REASON() متاحان في جميع إصدارات OpenSSL.

أُزيل ERR_GET_FUNC() في OpenSSL 3.0.

حقوق النسخ
حقوق النشر 2000-2023 لمؤلفي مشروع OpenSSL. جميع الحقوق محفوظة.

مرخص بموجب رخصة Apache 2.0 (المشار إليها فيما يلي بـ ”الرخصة“). لا يجوز لك استخدام هذا الملف إلا وفقًا لشروط الرخصة. يمكنك الحصول على نسخة منها في الملف LICENSE الموجود في حزمة التوزيع المصدرية أو على الرابط <https://www.openssl.org/source/license.html>.

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

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

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