SSL_SET_FD(3ssl)

الاسم
SSL_set_fd، SSL_set_rfd، SSL_set_wfd - وصل كائن SSL بواصف ملف

موجز
 #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);

الوصف
SSL_set_fd() يضبط واصف الملف fd كمرفق إدخال/إخراج للجانب المُعمّى TLS/SSL من ssl. سيكون fd عادةً واصف ملف المقبس لاتصال شبكي.

عند تنفيذ العملية، يُنشأ socket BIO آليًا للواجهة بين ssl وfd. يرث BIO وبالتالي محرك SSL سلوك fd. إذا كان fd غير محظور، سيكون لـ ssl أيضًا سلوك غير محظور.

عند استخدامه على كائن اتصال QUIC SSL، يُنشأ datagram BIO آليًا بدلاً من socket BIO. تفشل هذه الدوال إذا استُدعيت على كائن دفق QUIC SSL.

إذا كان هناك BIO موصول بـ ssl مسبقًا، تُستدعى BIO_free() (لكل من جانب القراءة والكتابة، إذا كانا مختلفين).

SSL_set_rfd() وSSL_set_wfd() تنفذان الإجراء المعني، ولكن فقط لقناة القراءة أو قناة الكتابة، والتي يمكن ضبطها بشكل مستقل.

القيم المُرجعة
يمكن أن تحدث قيم الإعادة التالية:

0   فشلت العملية. افحص رصة الأخطاء لمعرفة السبب.

1   نجحت العملية.

ملاحظات
في ويندوز، مقبض المقبس هو نوع بيانات 64 بت (UINT_PTR)، مما يؤدي إلى تحذير من المترجم (تحويل من 'SOCKET' إلى 'int'، فقدان محتمل للبيانات) عند تمرير مقبض المقبس إلى SSL_set_*fd(). في الوقت الحالي، يمكن تجاهل هذا التحذير بأمان، لأنه على الرغم من أن توثيق مايكروسوفت يدّعي أن الحد الأعلى هو INVALID_SOCKET-1 (2^64 - 2)، في الممارسة العملية، يُرجع تنفيذ socket() الحالي فهرسًا إلى جدول مقابض النواة، الذي يقتصر حجمه على 2^24.

انظر أيضًا
SSL_get_fd(3), SSL_set_bio(3), SSL_connect(3), SSL_accept(3), SSL_shutdown(3), ssl(7) , bio(7)

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