.\" -*- coding: UTF-8 -*-
.de  Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de  Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de  Ve \" End verbatim text
.ft R
.fi
..
.ie  n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.de  IX
..
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.nr rF 0
.if  \n(.g .if rF .nr rF 1
.if  (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.if  n .ds AD l
.\"
.\" Required to disable full justification in groff 1.23.0.
.\" ========================================================================
.\"
.IX Title "SSL_SESSION_FREE 3ssl"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH SSL_SESSION_FREE 3ssl "7 أبريل 2026" 3.6.2 OpenSSL
.if  n .ad l
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.nh
.SH الاسم
SSL_SESSION_new، SSL_SESSION_dup، SSL_SESSION_up_ref، SSL_SESSION_free \-
إنشاء وتحرير وإدارة بنى SSL_SESSION
.SH موجز
.IX Header موجز
.Vb 1
\& #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);
.Ve
.SH الوصف
.IX Header الوصف
\&\fBSSL_SESSION_new()\fP تنشئ بنية SSL_SESSION جديدة وتُعيد مؤشرًا إليها.
.PP
\&\fBSSL_SESSION_dup()\fP تنشئ بنية SSL_SESSION جديدة تكون نسخة من \fBsrc\fP.
النسخة ليست مملوكة لأي خبيئة قد كانت \fBsrc\fP فيها.
.PP
\&\fBSSL_SESSION_up_ref()\fP تزيد عدد المراجع في بنية SSL_SESSION المُعطاة.
.PP
\&\fBSSL_SESSION_free()\fP تُنقص عدد مراجع \fBsession\fP وتُزيل بنية
\fBSSL_SESSION\fP المُشار إليها بواسطة \fBsession\fP وتُحرر الذاكرة المُخصصة، إذا
بلغ عدد المراجع 0.  إذا كان \fBsession\fP NULL لا يُفعل شيء.
.SH ملاحظات
.IX Header ملاحظات
تُخصص كائنات SSL_SESSION عند إتمام عملية مصافحة TLS/SSL بنجاح. اعتمادًا على
الإعدادات، انظر \&\fBSSL_CTX_set_session_cache_mode\fP\|(3)، تُشار إلى كائنات
SSL_SESSION داخليًا بواسطة SSL_CTX وتُربط في خبيئة جلستها. قد تستخدم كائنات
SSL كائن SSL_SESSION؛ حيث قد تُعاد استخدام الجلسة، قد تستخدم عدة كائنات SSL
كائن SSL_SESSION واحدًا في نفس الوقت. لذلك من الضروري الحفاظ على عدد المراجع
(معلومات الاستخدام) صحيحًا وعدم حذف كائن SSL_SESSION لا يزال قيد الاستخدام،
لأن هذا قد يؤدي إلى فشل البرنامج بسبب المؤشرات المعلقة. قد تظهر هذه
الإخفاقات أيضًا متأخرة، مثلًا عندما يُحرر كائن SSL_SESSION بالكامل لأن عدد
المراجع أصبح 0 بشكل غير صحيح، لكنه لا يزال مُشارًا إليه في خبيئة الجلسة
الداخلية وتُعالج قائمة الخبيئة أثناء عملية \&\fBSSL_CTX_flush_sessions\fP\|(3).
.PP
\&\fBSSL_SESSION_free()\fP يجب أن تُستدعى فقط لكائنات SSL_SESSION التي زيد عدد
مراجعها صراحة (مثلًا باستدعاء \fBSSL_get1_session()\fP، انظر
\fBSSL_get_session\fP\|(3)) أو عندما وُلد كائن SSL_SESSION خارج عملية مصافحة
TLS، مثلًا باستخدام \fBd2i_SSL_SESSION\fP\|(3).  لا يجب استدعاؤها على كائنات
SSL_SESSION الأخرى، لأن هذا سيسبب أعداد مراجع غير صحيحة وبالتالي فشل
البرنامج.
.SH "القيم المُرجعة"
.IX Header "القيم المُرجعة"
SSL_SESSION_new تُعيد مؤشرًا إلى بنية SSL_SESSION المُخصصة حديثًا أو NULL
عند الخطأ.
.PP
SSL_SESSION_dup تُعيد مؤشرًا إلى النسخة الجديدة أو NULL عند الخطأ.
.PP
SSL_SESSION_up_ref تُعيد 1 عند النجاح أو 0 عند الخطأ.
.SH "انظر أيضًا"
.IX Header "انظر أيضًا"
\&\fBssl\fP\|(7), \fBSSL_get_session\fP\|(3),
\&\fBSSL_CTX_set_session_cache_mode\fP\|(3), \&\fBSSL_CTX_flush_sessions\fP\|(3),
\&\fBd2i_SSL_SESSION\fP\|(3)
.SH التاريخ
.IX Header التاريخ
أُضيفت دالة \fBSSL_SESSION_dup()\fP في OpenSSL 1.1.1.
.SH "حقوق النسخ"
.IX Header "حقوق النسخ"
حقوق النشر 2000\-2023 لمؤلفي مشروع OpenSSL. جميع الحقوق محفوظة.
.PP
مرخص بموجب رخصة Apache 2.0 (المشار إليها فيما يلي بـ ”الرخصة“).  لا يجوز لك
استخدام هذا الملف إلا وفقًا لشروط الرخصة.  يمكنك الحصول على نسخة منها في
الملف LICENSE الموجود في حزمة التوزيع المصدرية أو على الرابط
<https://www.openssl.org/source/license.html>.
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .