.\" -*- 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_FD 3ssl"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH SSL_SET_FD 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_fd، SSL_set_rfd، SSL_set_wfd \- وصل كائن SSL بواصف ملف
.SH موجز
.IX Header موجز
.Vb 1
\& #include <openssl/ssl.h>
\&
\& int SSL_set_fd(SSL *ssl, int fd);
\& int SSL_set_rfd(SSL *ssl, int fd);
\& int SSL_set_wfd(SSL *ssl, int fd);
.Ve
.SH الوصف
.IX Header الوصف
\&\fBSSL_set_fd()\fP يضبط واصف الملف \fBfd\fP كمرفق إدخال/إخراج للجانب المُعمّى
TLS/SSL من \fBssl\fP. سيكون \fBfd\fP عادةً واصف ملف المقبس لاتصال شبكي.
.PP
عند تنفيذ العملية، يُنشأ \fBsocket BIO\fP آليًا للواجهة بين \fBssl\fP و\fBfd\fP. يرث
BIO وبالتالي محرك SSL سلوك \fBfd\fP. إذا كان \fBfd\fP غير محظور، سيكون لـ \fBssl\fP
أيضًا سلوك غير محظور.
.PP
عند استخدامه على كائن اتصال QUIC SSL، يُنشأ \fBdatagram BIO\fP آليًا بدلاً من
\fBsocket BIO\fP. تفشل هذه الدوال إذا استُدعيت على كائن دفق QUIC SSL.
.PP
إذا كان هناك BIO موصول بـ \fBssl\fP مسبقًا، تُستدعى \fBBIO_free()\fP (لكل من جانب
القراءة والكتابة، إذا كانا مختلفين).
.PP
\&\fBSSL_set_rfd()\fP و\fBSSL_set_wfd()\fP تنفذان الإجراء المعني، ولكن فقط لقناة
القراءة أو قناة الكتابة، والتي يمكن ضبطها بشكل مستقل.
.SH "القيم المُرجعة"
.IX Header "القيم المُرجعة"
يمكن أن تحدث قيم الإعادة التالية:
.IP 0 4
فشلت العملية. افحص رصة الأخطاء لمعرفة السبب.
.IP 1 4
.IX Item 1
نجحت العملية.
.SH ملاحظات
.IX Header ملاحظات
في ويندوز، مقبض المقبس هو نوع بيانات 64 بت (UINT_PTR)، مما يؤدي إلى تحذير من
المترجم (تحويل من \*(AqSOCKET\*(Aq إلى \*(Aqint\*(Aq، فقدان محتمل للبيانات)
عند تمرير مقبض المقبس إلى SSL_set_*\fBfd()\fP. في الوقت الحالي، يمكن تجاهل هذا
التحذير بأمان، لأنه على الرغم من أن توثيق مايكروسوفت يدّعي أن الحد الأعلى هو
INVALID_SOCKET\-1 (2^64 \- 2)، في الممارسة العملية، يُرجع تنفيذ \fBsocket()\fP
الحالي فهرسًا إلى جدول مقابض النواة، الذي يقتصر حجمه على 2^24.
.SH "انظر أيضًا"
.IX Header "انظر أيضًا"
\&\fBSSL_get_fd\fP\|(3), \fBSSL_set_bio\fP\|(3), \&\fBSSL_connect\fP\|(3),
\fBSSL_accept\fP\|(3), \&\fBSSL_shutdown\fP\|(3), \fBssl\fP\|(7) , \fBbio\fP\|(7)
.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 .