OPENSSL_CONFIG(3ssl)

الاسم
OPENSSL_config, OPENSSL_no_config - دوال تهيئة OpenSSL بسيطة

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

الدوال التالية أصبحت مهجورة منذ OpenSSL 1.1.0، ويمكن إخفاؤها تمامًا عبر تعريف OPENSSL_API_COMPAT بقيمة إصدار مناسبة، انظر openssl_user_macros(7):

 void OPENSSL_config(const char *appname);
 void OPENSSL_no_config(void);

الوصف
OPENSSL_config() يهيئ OpenSSL باستخدام openssl.cnf القياسي ويقرأ من قسم التطبيق appname. إذا كان appname NULL فسيُستخدم القسم المبدئي، openssl_conf. تُتجاهل الأخطاء بصمت. لا تأثير للاستدعاءات المتعددة.

OPENSSL_no_config() يعطل التهيئة. إذا استُدعي قبل OPENSSL_config() فلا تحدث تهيئة.

إذا بُنِي التطبيق مع تعريف OPENSSL_LOAD_CONF، فإن استدعاء OpenSSL_add_all_algorithms() سيستدعي ضمنيًا OPENSSL_config() أولاً.

ملاحظات
دالة OPENSSL_config() صُممت لتكون دالة بسيطة جدًا "استدعها وانسها". لكنها مع ذلك أفضل بكثير من لا شيء. التطبيقات التي تحتاج تحكمًا أدق في وظيفة التهيئة عليها استخدام دوال التهيئة مثل CONF_modules_load() مباشرة. هذه الدالة مهملة ويجب تجنب استخدامها. على التطبيقات بدلاً من ذلك استدعاء CONF_modules_load() أثناء التهيئة (أي قبل بدء أي خيوط).

هناك عدة أسباب تجعل استدعاء إجراءات تهيئة OpenSSL مستحسنًا. على سبيل المثال، لتحميل محركات ENGINE ديناميكية من المكتبات المشتركة (DSOs). لكن، عدد قليل جدًا من التطبيقات يدعم حاليًا واجهة التحكم، وبالتالي عدد قليل جدًا يمكنه تحميل واستخدام محركات ENGINE ديناميكية. بالمثل، في المستقبل ستتطلب محركات ENGINE أكثر تطورًا عمليات تحكم معينة لتخصيصها. إذا استدعى تطبيق OPENSSL_config() فلا يحتاج لمعرفة أو الاهتمام بعمليات تحكم ENGINE لأنه يمكن تنفيذها بتحرير ملف تهيئة.

البيئة

OPENSSL_CONF
    المسار إلى ملف التهيئة. يُتجاهل في برامج set-user-ID و set-group-ID.

القيم المُرجعة
لا تُرجع OPENSSL_config() ولا OPENSSL_no_config() قيمة.

انظر أيضًا
config(5)، CONF_modules_load_file(3)

التاريخ
أُهملت دالتا OPENSSL_no_config() و OPENSSL_config() في OpenSSL 1.1.0 بواسطة OPENSSL_init_crypto().

حقوق النسخ
حقوق النشر 2004-2020 لمؤلفي مشروع 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.