.\" -*- 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 "BIO 7ssl"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH BIO 7ssl "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 الاسم
bio \- تجريد أساسي للإدخال/الإخراج
.SH موجز
.IX Header موجز
.Vb 1
\& #include <openssl/bio.h>
.Ve
.SH الوصف
.IX Header الوصف
BIO هو تجريد للإدخال/الإخراج، يخفي العديد من تفاصيل الإدخال/الإخراج الأساسية
عن التطبيق. إذا استخدم التطبيق BIO لإدخاله/إخراجه، فيمكنه التعامل بشفافية مع
اتصالات SSL، واتصالات الشبكة غير المشفرة، وإدخال/إخراج الملفات.
.PP
يوجد نوعان من BIO: BIO مصدر/مصرف وBIO مرشح.
.PP
كما يوحي اسمه، BIO مصدر/مصرف هو مصدر و/أو مصرف للبيانات، وتشمل الأمثلة BIO
مقبس وBIO ملف.
.PP
BIO مرشح يأخذ البيانات من BIO واحد ويمررها إلى آخر، أو إلى التطبيق. قد تُترك
البيانات دون تعديل (مثل BIO ملخص الرسالة) أو تُترجم (مثل BIO تشفير). قد
يتغير تأثير BIO المرشح وفقًا لعملية الإدخال/الإخراج التي يؤديها: على سبيل
المثال، BIO تشفير سيشفر البيانات إذا كانت تُكتب إليه ويفك تشفيرها إذا كانت
تُقرأ منه.
.PP
يمكن ربط BIOs معًا لتشكيل سلسلة (BIO واحد هو سلسلة بمكون واحد). تتكون
السلسلة عادةً من BIO مصدر/مصرف واحد وواحد أو أكثر من BIOs مرشحة. البيانات
المقروءة من أو المكتوبة إلى أول BIO تعبر السلسلة إلى النهاية (عادةً BIO
مصدر/مصرف).
.PP
بعض BIOs (مثل BIOs الذاكرة) يمكن استخدامها فورًا بعد استدعاء
\&\fBBIO_new()\fP. البعض الآخر (مثل BIOs الملف) يحتاج إلى تهيئة إضافية، وغالبًا
ما توجد دالة مساعدة لإنشاء وتهيئة هذه BIOs.
.PP
إذا استدعي \fBBIO_free()\fP على سلسلة BIO، فسيحرر BIO واحدا فقط مما يؤدي إلى
تسرب في الذاكرة.
.PP
استدعاء \fBBIO_free_all()\fP على BIO واحد له نفس تأثير استدعاء \&\fBBIO_free()\fP
عليه باستثناء القيمة المرجعة المهملة.
.PP
عادةً ما تُزود وسيطة \fItype\fP بواسطة دالة تُرجع مؤشرًا إلى BIO_METHOD. هناك
اصطلاح تسمية لهذه الدوال: BIO مصدر/مصرف يبدأ عادةً بـ \fIBIO_s_\fP وBIO مرشح بـ
\fIBIO_f_\fP.
.SS "فتح TCP السريع"
.IX Subsection "فتح TCP السريع"
فتح TCP السريع (RFC7413)، المختصر "TFO"، مدعوم بواسطة واجهة BIO منذ OpenSSL
3.2. TFO مدعوم في أنظمة التشغيل التالية:
.IP \(bu 4
نواة لينكس 3.13 والإصدارات الأحدث، حيث TFO مفعل آليًا.
.IP \(bu 4
نواة لينكس 4.11 والإصدارات الأحدث، باستخدام TCP_FASTOPEN_CONNECT.
.IP \(bu 4
FreeBSD 10.3 إلى 11.4، يدعم TFO للخادم فقط.
.IP \(bu 4
FreeBSD 12.0 والإصدارات الأحدث، يدعم TFO لكل من العميل والخادم.
.IP \(bu 4
macOS 10.14 والإصدارات الأحدث.
.PP
كل نظام تشغيل لديه API مختلف قليلاً لـ TFO. يُرجى الرجوع إلى وثائق API
لأنظمة التشغيل عند استخدام المقابس مباشرة.
.SH أمثلة
.IX Header أمثلة
أنشئ ذاكرة BIO:
.PP
.Vb 1
\& BIO *mem = BIO_new(BIO_s_mem());
.Ve
.SH "انظر أيضًا"
.IX Header "انظر أيضًا"
\&\fBBIO_ctrl\fP\|(3), \&\fBBIO_f_base64\fP\|(3), \fBBIO_f_buffer\fP\|(3),
\&\fBBIO_f_cipher\fP\|(3), \fBBIO_f_md\fP\|(3), \&\fBBIO_f_null\fP\|(3),
\fBBIO_f_ssl\fP\|(3), \&\fBBIO_f_readbuffer\fP\|(3), \&\fBBIO_find_type\fP\|(3),
\&\fBBIO_get_conn_mode\fP\|(3), \&\fBBIO_new\fP\|(3), \&\fBBIO_new_bio_pair\fP\|(3),
\&\fBBIO_push\fP\|(3), \fBBIO_read_ex\fP\|(3), \&\fBBIO_s_accept\fP\|(3),
\fBBIO_s_bio\fP\|(3), \&\fBBIO_s_connect\fP\|(3), \fBBIO_s_fd\fP\|(3),
\&\fBBIO_s_file\fP\|(3), \fBBIO_s_mem\fP\|(3), \&\fBBIO_s_null\fP\|(3),
\fBBIO_s_socket\fP\|(3), \&\fBBIO_set_callback\fP\|(3),
\&\fBBIO_set_conn_mode\fP\|(3), \&\fBBIO_set_tfo\fP\|(3),
\&\fBBIO_set_tfo_accept\fP\|(3), \&\fBBIO_should_retry\fP\|(3)
.SH "حقوق النسخ"
.IX Header "حقوق النسخ"
حقوق النشر 2000\-2022 لمؤلفي مشروع 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 .