SSL_SESSION_FREE(3SSL)

الاسم
SSL_SESSION_new، SSL_SESSION_dup، SSL_SESSION_up_ref، SSL_SESSION_free - إنشاء وتحرير وإدارة بنى SSL_SESSION

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

 SSL_SESSION *SSL_SESSION_new(void);
 SSL_SESSION *SSL_SESSION_dup(const SSL_SESSION *src);
 int SSL_SESSION_up_ref(SSL_SESSION *ses);
 void SSL_SESSION_free(SSL_SESSION *session);

الوصف
SSL_SESSION_new() تنشئ بنية SSL_SESSION جديدة وتُعيد مؤشرًا إليها.

SSL_SESSION_dup() تنشئ بنية SSL_SESSION جديدة تكون نسخة من src. النسخة ليست مملوكة لأي خبيئة قد كانت src فيها.

SSL_SESSION_up_ref() تزيد عدد المراجع في بنية SSL_SESSION المُعطاة.

SSL_SESSION_free() تُنقص عدد مراجع session وتُزيل بنية SSL_SESSION المُشار إليها بواسطة session وتُحرر الذاكرة المُخصصة، إذا بلغ عدد المراجع 0. إذا كان session NULL لا يُفعل شيء.

ملاحظات
تُخصص كائنات SSL_SESSION عند إتمام عملية مصافحة TLS/SSL بنجاح. اعتمادًا على الإعدادات، انظر SSL_CTX_set_session_cache_mode(3)، تُشار إلى كائنات SSL_SESSION داخليًا بواسطة SSL_CTX وتُربط في خبيئة جلستها. قد تستخدم كائنات SSL كائن SSL_SESSION؛ حيث قد تُعاد استخدام الجلسة، قد تستخدم عدة كائنات SSL كائن SSL_SESSION واحدًا في نفس الوقت. لذلك من الضروري الحفاظ على عدد المراجع (معلومات الاستخدام) صحيحًا وعدم حذف كائن SSL_SESSION لا يزال قيد الاستخدام، لأن هذا قد يؤدي إلى فشل البرنامج بسبب المؤشرات المعلقة. قد تظهر هذه الإخفاقات أيضًا متأخرة، مثلًا عندما يُحرر كائن SSL_SESSION بالكامل لأن عدد المراجع أصبح 0 بشكل غير صحيح، لكنه لا يزال مُشارًا إليه في خبيئة الجلسة الداخلية وتُعالج قائمة الخبيئة أثناء عملية SSL_CTX_flush_sessions(3).

SSL_SESSION_free() يجب أن تُستدعى فقط لكائنات SSL_SESSION التي زيد عدد مراجعها صراحة (مثلًا باستدعاء SSL_get1_session()، انظر SSL_get_session(3)) أو عندما وُلد كائن SSL_SESSION خارج عملية مصافحة TLS، مثلًا باستخدام d2i_SSL_SESSION(3). لا يجب استدعاؤها على كائنات SSL_SESSION الأخرى، لأن هذا سيسبب أعداد مراجع غير صحيحة وبالتالي فشل البرنامج.

القيم المُرجعة
SSL_SESSION_new تُعيد مؤشرًا إلى بنية SSL_SESSION المُخصصة حديثًا أو NULL عند الخطأ.

SSL_SESSION_dup تُعيد مؤشرًا إلى النسخة الجديدة أو NULL عند الخطأ.

SSL_SESSION_up_ref تُعيد 1 عند النجاح أو 0 عند الخطأ.

انظر أيضًا
ssl(7), SSL_get_session(3), SSL_CTX_set_session_cache_mode(3), SSL_CTX_flush_sessions(3), d2i_SSL_SESSION(3)

التاريخ
أُضيفت دالة SSL_SESSION_dup() في OpenSSL 1.1.1.

حقوق النسخ
حقوق النشر 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.