SSL_SESSION_GET_TIME(3ssl)

الاسم
SSL_SESSION_get_time, SSL_SESSION_set_time, SSL_SESSION_get_timeout, SSL_SESSION_set_timeout, SSL_SESSION_get_time_ex, SSL_SESSION_set_time_ex, SSL_get_time, SSL_set_time, SSL_get_timeout, SSL_set_timeout \&- استرداد ومعالجة إعدادات وقت الجلسة ومهلة انتهائها

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

 long SSL_SESSION_get_timeout(const SSL_SESSION *s);
 long SSL_SESSION_set_timeout(SSL_SESSION *s, long tm);

 long SSL_get_timeout(const SSL_SESSION *s);
 long SSL_set_timeout(SSL_SESSION *s, long tm);

 time_t SSL_SESSION_get_time_ex(const SSL_SESSION *s);
 time_t SSL_SESSION_set_time_ex(SSL_SESSION *s, time_t tm);

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

 long SSL_SESSION_get_time(const SSL_SESSION *s);
 long SSL_SESSION_set_time(SSL_SESSION *s, long tm);
 long SSL_get_time(const SSL_SESSION *s);
 long SSL_set_time(SSL_SESSION *s, long tm);

الوصف
\&SSL_SESSION_get_time_ex() تُرجع الوقت الذي أُنشئت فيه الجلسة s. يُعطى الوقت بالثواني منذ الحقبة (Epoch)، وبالتالي فهو متوافق مع الوقت الذي تُرجعه دالة time().

\&SSL_SESSION_set_time_ex() تستبدل وقت إنشاء الجلسة s بالقيمة المختارة tm.

\&SSL_SESSION_get_timeout() تُرجع قيمة مهلة انتهاء الجلسة المضبوطة للجلسة s بالثواني.

\&SSL_SESSION_set_timeout() تضبط قيمة مهلة انتهاء الجلسة للجلسة s بالثواني إلى tm.

\&SSL_SESSION_get_time() و SSL_SESSION_set_time() تستخدمان نوع البيانات long بدلاً من time_t، وبالتالي فهما مهملتان لعدم كونهما آمنين لسنة 2038 على أنظمة 32 بت. لاحظ أن هذه الأنظمة لا تزال بحاجة إلى أن تُهيأ لاستخدام time_t بحجم 64 بت لتجنب تجاوز السعة في وقت النظام.

الدوال SSL_get_time() و SSL_set_time() و SSL_get_timeout() و SSL_set_timeout() هي مرادفات لنظيراتها SSL_SESSION_*().

ملاحظات
تنتهي صلاحية الجلسات بفحص وقت الإنشاء وقيمة مهلة الانتهاء. يُضبط كلاهما عند وقت إنشاء الجلسة إلى الوقت الفعلي وقيمة المهلة المبدئية عند الإنشاء، على التوالي، كما يُضبط بواسطة \&SSL_CTX_set_timeout\|(3). باستخدام هذه الدوال، يمكن تمديد أو تقصير عمر الجلسة.

القيم المُرجعة
\&SSL_SESSION_get_time_ex() و SSL_SESSION_get_timeout() تُرجعان القيم الصالحة حالياً.

\&SSL_SESSION_set_time_ex() تُرجع الوقت عند النجاح.

\&SSL_SESSION_set_timeout() تُرجع 1 عند النجاح.

إذا وُصل أي من الدوال بمؤشر NULL للجلسة s، تُرجع 0.

العلل
نوع البيانات long هو عادةً 32 بت على العديد من الأنظمة، وبالتالي فإن الدوال القديمة SSL_SESSION_get_time() و SSL_SESSION_set_time() ليست دائماً آمنة لسنة 2038.

انظر أيضًا
\&ssl\|(7), \&SSL_CTX_set_timeout\|(3), \&SSL_get_default_timeout\|(3)

التاريخ
أُضيفت الدوال SSL_SESSION_get_time_ex() و SSL_SESSION_set_time_ex() في OpenSSL 3.3.

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