SSL_CTX_FLUSH_SESSIONS(3ssl)

الاسم
SSL_CTX_flush_sessions_ex, SSL_CTX_flush_sessions - إزالة الجلسات منتهية الصلاحية

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

 void SSL_CTX_flush_sessions_ex(SSL_CTX *ctx, time_t tm);

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

 void SSL_CTX_flush_sessions(SSL_CTX *ctx, long tm);

الوصف
SSL_CTX_flush_sessions_ex() تُسبب تشغيلًا عبر خبيئة الجلسة لـctx لإزالة الجلسات منتهية الصلاحية في الوقت tm.

SSL_CTX_flush_sessions() هو متغير أقدم من الدالة غير آمن لـ Y2038 بسبب استخدام نوع بيانات long بدلاً من time_t.

ملاحظات
إذا كان مُفعّلاً، ستجمع خبيئة الجلسة الداخلية جميع الجلسات المنشأة حتى العدد الأقصى المحدد (انظر SSL_CTX_sess_set_cache_size()). نظرًا لأن الجلسات لن يُعاد استخدامها بمجرد انتهاء صلاحيتها، يجب إزالتها من الخبيئة لتوفير الموارد. يمكن فعل ذلك آليًا كلما أُنشئت 255 جلسة جديدة (انظر SSL_CTX_set_session_cache_mode(3)) أو يدويًا باستدعاء SSL_CTX_flush_sessions_ex().

يحدد المعامل tm الوقت الذي يجب استخدامه لاختبار انتهاء الصلاحية، في معظم الحالات سيُستخدم الوقت الفعلي المُعطى بواسطة time(0).

SSL_CTX_flush_sessions_ex() ستفحص فقط الجلسات المخزنة في الخبيئة الداخلية. عند العثور على جلسة وإزالتها، يُستدعى remove_session_cb مع ذلك للمزامنة مع الخبيئة الخارجية (انظر SSL_CTX_sess_set_get_cb(3)).

القيم المُرجعة
SSL_CTX_flush_sessions_ex() لا تُرجع قيمة.

انظر أيضًا
ssl(7), SSL_CTX_set_session_cache_mode(3), SSL_CTX_set_timeout(3), SSL_CTX_sess_set_get_cb(3)

التاريخ
SSL_CTX_flush_sessions_ex() أُضيفت في OpenSSL 3.4.

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