.\" -*- 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_CTRL 3ssl" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH BIO_CTRL 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 الاسم BIO_ctrl, BIO_callback_ctrl, BIO_ptr_ctrl, BIO_int_ctrl, BIO_reset, BIO_seek, BIO_tell, BIO_flush, BIO_eof, BIO_set_close, BIO_get_close, BIO_pending, BIO_wpending, BIO_ctrl_pending, BIO_ctrl_wpending, BIO_get_info_callback, BIO_set_info_callback, BIO_info_cb, BIO_get_ktls_send, BIO_get_ktls_recv, BIO_set_conn_mode, BIO_get_conn_mode, BIO_set_tfo \&\- عمليات التحكم في BIO .SH موجز .IX Header موجز .Vb 1 \& #include \& \& typedef int BIO_info_cb(BIO *b, int state, int res); \& \& long BIO_ctrl(BIO *bp, int cmd, long larg, void *parg); \& long BIO_callback_ctrl(BIO *b, int cmd, BIO_info_cb *cb); \& void *BIO_ptr_ctrl(BIO *bp, int cmd, long larg); \& long BIO_int_ctrl(BIO *bp, int cmd, long larg, int iarg); \& \& int BIO_reset(BIO *b); \& int BIO_seek(BIO *b, int ofs); \& int BIO_tell(BIO *b); \& int BIO_flush(BIO *b); \& int BIO_eof(BIO *b); \& int BIO_set_close(BIO *b, long flag); \& int BIO_get_close(BIO *b); \& int BIO_pending(BIO *b); \& int BIO_wpending(BIO *b); \& size_t BIO_ctrl_pending(BIO *b); \& size_t BIO_ctrl_wpending(BIO *b); \& \& int BIO_get_info_callback(BIO *b, BIO_info_cb **cbp); \& int BIO_set_info_callback(BIO *b, BIO_info_cb *cb); \& \& int BIO_get_ktls_send(BIO *b); \& int BIO_get_ktls_recv(BIO *b); \& \& int BIO_set_conn_mode(BIO *b, int mode); \& int BIO_get_conn_mode(BIO *b); \& \& int BIO_set_tfo(BIO *b, int onoff); .Ve .SH الوصف .IX Header الوصف \&الدوال \fBBIO_ctrl()\fP و \fBBIO_callback_ctrl()\fP و \fBBIO_ptr_ctrl()\fP و \fBBIO_int_ctrl()\fP هي عمليات "تحكم" في BIO تأخذ وسائط من أنواع مختلفة. هذه الدوال لا تُستدعى عادةً مباشرةً، بل تُستخدم بدلاً منها ماكروات متنوعة. الماكروات القياسية موصوفة أدناه، والماكروات الخاصة بنوع معين من BIO موصوفة في صفحة الدليل الخاصة بذلك BIO بالإضافة إلى أي ميزات خاصة للاستدعاءات القياسية. .PP \&عادةً ما يُعيد \fBBIO_reset()\fP BIO إلى حالة مبدئية ما، ففي حالة BIOs المرتبطة بالملف مثلاً يُعيد مؤشر الملف إلى بداية الملف. .PP \&يُعيد \fBBIO_seek()\fP مؤشر موضع ملف BIO مرتبط بالملف (أي BIOs واصف الملف و FILE) إلى \fBofs\fP بايت من بداية الملف. .PP \&يُرجع \fBBIO_tell()\fP موضع الملف الحالي لـ BIO مرتبط بالملف. .PP \&يكتب \fBBIO_flush()\fP عادةً أي بيانات مخزنة داخلياً، وفي بعض الحالات يُستخدم للإشارة إلى EOF وأنه لن تُكتب بيانات أخرى. .PP \&يُرجع \fBBIO_eof()\fP 1 إذا قرأ BIO علامة EOF، ويختلف المعنى الدقيق لـ "EOF" حسب نوع BIO. .PP \&يضبط \fBBIO_set_close()\fP علامة إغلاق BIO \fBb\fP إلى \fBflag\fP. يمكن أن تأخذ \fBflag\fP القيمة BIO_CLOSE أو BIO_NOCLOSE. يُستخدم BIO_CLOSE عادةً في BIO مصدر/مصرف للإشارة إلى أن تيار الإدخال/الإخراج الأساسي يجب أن يُغلق عند تحرير BIO. .PP \&يُرجع \fBBIO_get_close()\fP علامة إغلاق BIO. .PP \&تُرجع \fBBIO_pending()\fP و \fBBIO_ctrl_pending()\fP و \fBBIO_wpending()\fP و \fBBIO_ctrl_wpending()\fP عدد الأحرف المعلقة في مخازن القراءة والكتابة لـ BIO. لا تدعم جميع BIOs هذه الاستدعاءات. تُرجع \fBBIO_ctrl_pending()\fP و \fBBIO_ctrl_wpending()\fP نوع size_t وهما دالتان، بينما \fBBIO_pending()\fP و \fBBIO_wpending()\fP هما ماكروات تستدعيان \fBBIO_ctrl()\fP. .PP \&تُرجع \fBBIO_get_ktls_send()\fP 1 إذا كان BIO يستخدم مسار بيانات Kernel TLS للإرسال. وإلا، تُرجع صفراً. \&تُرجع \fBBIO_get_ktls_recv()\fP 1 إذا كان BIO يستخدم مسار بيانات Kernel TLS للاستقبال. وإلا، تُرجع صفراً. .PP \&تُرجع \fBBIO_get_conn_mode()\fP وضع اتصال BIO. يضبط \fBBIO_set_conn_mode()\fP وضع اتصال BIO. .PP \&يُعطل \fBBIO_set_tfo()\fP TCP Fast Open عندما يكون \fBonoff\fP 0، ويُفعله عندما يكون \fBonoff\fP غير صفري. ضبط القيمة إلى 1 يُعادل ضبط \&\fBBIO_SOCK_TFO\fP في \fBBIO_set_conn_mode()\fP. .SH "القيم المُرجعة" .IX Header "القيم المُرجعة" \&يُرجع \fBBIO_reset()\fP عادةً 1 للنجاح و <=0 للفشل. BIOs الملف هي استثناء، فهي تُرجع 0 للنجاح و \-1 للفشل. .PP \&يُرجع كل من \fBBIO_seek()\fP و \fBBIO_tell()\fP موضع الملف الحالي عند النجاح و \-1 عند الفشل، باستثناء BIOs الملف التي تُرجع دائماً 0 للنجاح و \-1 للفشل بالنسبة لـ \fBBIO_seek()\fP. .PP \&\fBBIO_flush()\fP يُرجع 1 للنجاح و<=0 للفشل. .PP \&\fBBIO_eof()\fP يُرجع 1 إذا وُصِلَ إلى نهاية الملف، 0 إذا لم يُوصل، أو قيم سالبة للفشل. .PP \&\fBBIO_set_close()\fP يُرجع 1 عند النجاح أو <=0 للفشل. .PP \&\fBBIO_get_close()\fP يُرجع قيمة علم الإغلاق: BIO_CLOSE أو BIO_NOCLOSE. ويُرجع أيضًا قيمًا سالبة أخرى إذا حدث خطأ. .PP \&\fBBIO_pending()\fP، \fBBIO_ctrl_pending()\fP، \fBBIO_wpending()\fP و\fBBIO_ctrl_wpending()\fP يُرجعون كمية البيانات المعلقة. \fBBIO_pending()\fP و\fBBIO_wpending()\fP يُرجعان قيمة سالبة أو 0 عند الخطأ. \fBBIO_ctrl_pending()\fP و\fBBIO_ctrl_wpending()\fP يُرجعان 0 عند الخطأ. .PP \&تُرجع \fBBIO_get_ktls_send()\fP 1 إذا كان BIO يستخدم مسار بيانات Kernel TLS للإرسال. وإلا، تُرجع صفراً. \&تُرجع \fBBIO_get_ktls_recv()\fP 1 إذا كان BIO يستخدم مسار بيانات Kernel TLS للاستقبال. وإلا، تُرجع صفراً. .PP \&\fBBIO_set_conn_mode()\fP يُرجع 1 للنجاح و0 للفشل. \fBBIO_get_conn_mode()\fP يُرجع وضع الاتصال الحالي. والذي قد يحتوي على الجمع البتّي للأعلام التالية: .PP .Vb 6 \& BIO_SOCK_REUSEADDR \& BIO_SOCK_V6_ONLY \& BIO_SOCK_KEEPALIVE \& BIO_SOCK_NONBLOCK \& BIO_SOCK_NODELAY \& BIO_SOCK_TFO .Ve .PP \&\fBBIO_set_tfo()\fP يُرجع 1 للنجاح، و0 للفشل. .SH ملاحظات .IX Header ملاحظات \&\fBBIO_flush()\fP، لأنه يمكنه كتابة البيانات، قد يُرجع 0 أو \-1 للإشارة إلى أن الاستدعاء يجب إعادة محاولته لاحقًا بطريقة مشابهة لـ\fBBIO_write_ex()\fP. يجب استخدام استدعاء \fBBIO_should_retry()\fP واتخاذ الإجراء المناسب إذا فشل الاستدعاء. .PP قيم الإرجاع لـ\fBBIO_pending()\fP و\fBBIO_wpending()\fP قد لا تحدد بشكل موثوق كمية البيانات المعلقة في جميع الحالات. على سبيل المثال في حالة BIO ملف، قد تكون بعض البيانات متاحة في المخازن المؤقتة الداخلية لهيكل FILE ولكن ليس من الممكن تحديد ذلك بطريقة محمولة. بالنسبة لأنواع أخرى من BIO قد لا تكون مدعومة. .PP BIOs المرشحة إذا لم تعالج داخليًا عملية \fBBIO_ctrl()\fP معينة، فإنها عادةً تمرر العملية إلى BIO التالي في السلسلة. هذا يعني غالبًا أنه لا حاجة لتحديد موقع BIO المطلوب لعملية معينة، يمكن استدعاؤها على سلسلة وسيتم تمريرها آليًا إلى BIO ذي الصلة. ومع ذلك، قد يتسبب هذا في نتائج غير متوقعة: على سبيل المثال، لا تنفذ أي BIOs مرشحة حاليًا \&\fBBIO_seek()\fP، ولكن قد ينجح هذا إذا انتهت السلسلة في BIO ملف أو واصف ملف. .PP BIOs المصدر/المصرف يُرجعون 0 إذا لم يتعرفوا على عملية \fBBIO_ctrl()\fP. .SH العلل .IX Header العلل بعض قيم الإرجاع غامضة ويجب توخي الحذر. على وجه الخصوص، يمكن إرجاع قيمة 0 إذا كانت العملية غير مدعومة، أو إذا حدث خطأ، أو إذا لم يُوصل إلى نهاية الملف، وفي حالة \fBBIO_seek()\fP على BIO ملف لعملية ناجحة. .PP في الإصدارات الأقدم من OpenSSL، كان بإمكان \fBBIO_ctrl_pending()\fP و\&\fBBIO_ctrl_wpending()\fP إرجاع قيم أكبر من INT_MAX عند الخطأ. .SH التاريخ .IX Header التاريخ أُضيفت وحدات الماكرو \fBBIO_get_ktls_send()\fP و\fBBIO_get_ktls_recv()\fP في OpenSSL 3.0. تم تعديلها لعدم إرجاع \-1 أبدًا في OpenSSL 3.0.4. .PP أُضيفت دوال \fBBIO_get_conn_mode()\fP و\fBBIO_set_conn_mode()\fP و\fBBIO_set_tfo()\fP في OpenSSL 3.2. .SH "حقوق النسخ" .IX Header "حقوق النسخ" حقوق النشر 2000\-2022 لمؤلفي مشروع OpenSSL. جميع الحقوق محفوظة. .PP مرخص بموجب رخصة Apache 2.0 (المشار إليها فيما يلي بـ ”الرخصة“). لا يجوز لك استخدام هذا الملف إلا وفقًا لشروط الرخصة. يمكنك الحصول على نسخة منها في الملف LICENSE الموجود في حزمة التوزيع المصدرية أو على الرابط . .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .