.\" -*- 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_SET_BIO 3ssl"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH SSL_SET_BIO 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_set_bio, SSL_set0_rbio, SSL_set0_wbio \- وصل كائن SSL مع BIO
.SH موجز
.IX Header موجز
.Vb 1
\& #include <openssl/ssl.h>
\&
\& void SSL_set_bio(SSL *ssl, BIO *rbio, BIO *wbio);
\& void SSL_set0_rbio(SSL *s, BIO *rbio);
\& void SSL_set0_wbio(SSL *s, BIO *wbio);
.Ve
.SH الوصف
.IX Header الوصف
\&\fBSSL_set0_rbio()\fP يصل BIO \fBrbio\fP لعمليات القراءة لكائن \fBssl\fP. يرث محرك
SSL سلوك \fBrbio\fP. إذا كان BIO غير محظور، فسيكون لكائن \fBssl\fP أيضًا سلوك غير
محظور. تنقل هذه الدالة ملكية \fBrbio\fP إلى \fBssl\fP. ستُحرر آليًا باستخدام
\fBBIO_free_all\fP\|(3) عند تحرير \fBssl\fP. عند استدعاء هذه الدالة، سيُحرر أي
\fBrbio\fP موجود سابقًا عبر استدعاء \fBBIO_free_all\fP\|(3) (يشمل ذلك الحالة التي
يُضبط فيها \fBrbio\fP على نفس القيمة السابقة).
.PP
إذا استُخدم BIO مخصص، يجب على \fBrbio\fP تنفيذ إما
\&\fBBIO_meth_set_read_ex\fP\|(3) أو \fBBIO_meth_set_read\fP\|(3).
.PP
\&\fBSSL_set0_wbio()\fP يعمل بنفس طريقة \fBSSL_set0_rbio()\fP باستثناء أنه يصل BIO
\fBwbio\fP لعمليات الكتابة لكائن \fBssl\fP. لاحظ أنه إذا كان rbio و wbio متطابقين،
فإن \fBSSL_set0_rbio()\fP و \fBSSL_set0_wbio()\fP تأخذ كل منهما ملكية مرجع
واحد. لذلك، قد يكون من الضروري زيادة عدد المراجع المتاحة باستخدام
\fBBIO_up_ref\fP\|(3) قبل استدعاء دوال set0.
.PP
إذا استُخدم BIO مخصص، يجب على \fBwbio\fP تنفيذ \&\fBBIO_meth_set_write_ex\fP\|(3)
أو \fBBIO_meth_set_write\fP\|(3). بالإضافة إلى ذلك، يجب تنفيذ \fBBIO_flush\fP\|(3)
باستخدام \fBBIO_CTRL_FLUSH\fP و \fBBIO_meth_set_ctrl\fP\|(3). إذا لم يكن التنظيف
ضروريًا مع \fBwbio\fP، يجب على \fBBIO_flush\fP\|(3) إرجاع واحد وعدم فعل شيء.
.PP
\&\fBSSL_set_bio()\fP مشابه لـ \fBSSL_set0_rbio()\fP و \fBSSL_set0_wbio()\fP باستثناء
أنه يصل كلاً من \fBrbio\fP و \fBwbio\fP في نفس الوقت، وينقل ملكية \fBrbio\fP و
\fBwbio\fP إلى \fBssl\fP وفقًا لمجموعة القواعد التالية:
.IP \(bu 2
إذا لم يتغير أي من \fBrbio\fP أو \fBwbio\fP عن قيمهما السابقة، فلا يُفعل شيء.
.IP \(bu 2
إذا كان المعاملان \fBrbio\fP و \fBwbio\fP مختلفين وكلاهما مختلف عن قيمهما المضبوطة
سابقًا، فسيُستهلك مرجع واحد لـ rbio ومرجع واحد لـ wbio.
.IP \(bu 2
إذا كان المعاملان \fBrbio\fP و \fBwbio\fP متطابقين و \fBrbio\fP ليس نفس القيمة
المضبوطة سابقًا، فسيُستهلك مرجع واحد.
.IP \(bu 2
إذا كان المعاملان \fBrbio\fP و \fBwbio\fP متطابقين و \fBrbio\fP هو نفس القيمة
المضبوطة سابقًا، فلا تُستهلك مراجع إضافية.
.IP \(bu 2
إذا كان المعاملان \fBrbio\fP و \fBwbio\fP مختلفين و \fBrbio\fP هو نفس القيمة المضبوطة
سابقًا، فسيُستهلك مرجع واحد لـ \fBwbio\fP ولا تُستهلك مراجع لـ \fBrbio\fP.
.IP \(bu 2
إذا كان المعاملان \fBrbio\fP و \fBwbio\fP مختلفين و \fBwbio\fP هو نفس القيمة المضبوطة
سابقًا وكانت قيم \fBrbio\fP و \fBwbio\fP القديمة متطابقة مع بعضها، فسيُستهلك مرجع
واحد لـ \fBrbio\fP ولا تُستهلك مراجع لـ \fBwbio\fP.
.IP \(bu 2
إذا كان المعاملان \fBrbio\fP و \fBwbio\fP مختلفين و \fBwbio\fP هو نفس القيمة المضبوطة
سابقًا وكانت قيم \fBrbio\fP و \fBwbio\fP القديمة مختلفة عن بعضها، فسيُستهلك مرجع
واحد لـ \fBrbio\fP ومرجع واحد لـ \fBwbio\fP.
.PP
بسبب هذا التعقيد، يجب تجنب هذه الدالة؛ استخدم \fBSSL_set0_rbio()\fP و
\fBSSL_set0_wbio()\fP بدلاً من ذلك.
.PP
عند ضبط BIO جديد على كائن SSL لاتصال QUIC، سيُعطّل الوضع المحظور على كائن
SSL إذا لم يستطع BIO دعم الوضع المحظور. إذا ضُبط BIO آخر لاحقًا على كائن SSL
يمكنه دعم الوضع المحظور، فلن يُعاد تمكين الوضع المحظور آليًا. لمزيد من
المعلومات، انظر \&\fBSSL_set_blocking_mode\fP\|(3).
.SH "القيم المُرجعة"
.IX Header "القيم المُرجعة"
\&\fBSSL_set_bio()\fP و \fBSSL_set0_rbio()\fP و \fBSSL_set0_wbio()\fP لا يمكنها
الفشل.
.SH "انظر أيضًا"
.IX Header "انظر أيضًا"
\&\fBSSL_get_rbio\fP\|(3), \&\fBSSL_connect\fP\|(3), \fBSSL_accept\fP\|(3),
\&\fBSSL_shutdown\fP\|(3), \fBssl\fP\|(7), \fBbio\fP\|(7)
.SH التاريخ
.IX Header التاريخ
أُضيفت \fBSSL_set0_rbio()\fP و \fBSSL_set0_wbio()\fP في OpenSSL 1.1.0.
.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 .