.\" -*- 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_CTX_SET_MODE 3ssl" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH SSL_CTX_SET_MODE 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_CTX_set_mode، SSL_CTX_clear_mode، SSL_set_mode، SSL_clear_mode، SSL_CTX_get_mode، SSL_get_mode \- معالجة وضع محرك SSL .SH موجز .IX Header موجز .Vb 1 \& #include \& \& long SSL_CTX_set_mode(SSL_CTX *ctx, long mode); \& long SSL_CTX_clear_mode(SSL_CTX *ctx, long mode); \& long SSL_set_mode(SSL *ssl, long mode); \& long SSL_clear_mode(SSL *ssl, long mode); \& \& long SSL_CTX_get_mode(SSL_CTX *ctx); \& long SSL_get_mode(SSL *ssl); .Ve .SH الوصف .IX Header الوصف \&\fBSSL_CTX_set_mode()\fP يُضيف الوضع المُعيَّن عبر قناع بت في \fBmode\fP إلى \fBctx\fP. الخيارات المُعيَّنة سابقًا لا تُمسح. \&\fBSSL_CTX_clear_mode()\fP يُزيل الوضع المُعيَّن عبر قناع بت في \fBmode\fP من \fBctx\fP. .PP \&\fBSSL_set_mode()\fP يُضيف الوضع المُعيَّن عبر قناع بت في \fBmode\fP إلى \fBssl\fP. الخيارات المُعيَّنة سابقًا لا تُمسح. \&\fBSSL_clear_mode()\fP يُزيل الوضع المُعيَّن عبر قناع بت في \fBmode\fP من \fBssl\fP. .PP \&\fBSSL_CTX_get_mode()\fP يُرجع الوضع المُعيَّن لـ \fBctx\fP. .PP \&\fBSSL_get_mode()\fP يُرجع الوضع المُعيَّن لـ \fBssl\fP. .SH ملاحظات .IX Header ملاحظات تغييرات الوضع التالية متوفرة: .IP SSL_MODE_ENABLE_PARTIAL_WRITE 4 .IX Item SSL_MODE_ENABLE_PARTIAL_WRITE يسمح لـ SSL_write_ex(..., n, &r) بالإرجاع مع 0 < r < n (أي الإبلاغ عن النجاح عند كتابة سجل واحد فقط). يعمل هذا بطريقة مشابهة لـ \&\fBSSL_write()\fP. عندما لا يُعيَّن (المبدئي)، \fBSSL_write_ex()\fP أو \fBSSL_write()\fP سيُبلغان عن النجاح فقط بعد كتابة الكتلة الكاملة. بمجرد أن يُرجع \fBSSL_write_ex()\fP أو \&\fBSSL_write()\fP بنجاح، كُتبت \fBr\fP بايت، ويجب على الاستدعاء التالي لـ \fBSSL_write_ex()\fP أو \fBSSL_write()\fP إرسال n\-r بايت المتبقية فقط، مقلدًا سلوك \fBwrite()\fP. .Sp لا يمكن تفعيل هذا الوضع أثناء وجود عملية كتابة غير مكتملة. .IP SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER 4 .IX Item SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER يجعل من الممكن إعادة محاولة \fBSSL_write_ex()\fP أو \fBSSL_write()\fP مع موقع مخزن مؤقت مُغيَّر (يجب أن تبقى محتويات المخزن المؤقت كما هي). هذا ليس المبدئي لتجنب المفهوم الخاطئ بأن \fBSSL_write()\fP غير المحظور يتصرف مثل \fBwrite()\fP غير المحظور. .IP SSL_MODE_AUTO_RETRY 4 .IX Item SSL_MODE_AUTO_RETRY أثناء العمليات العادية، قد تحتاج سجلات بيانات غير تطبيقية إلى الإرسال أو الاستقبال لا يعلم بها التطبيق. إذا عُولج سجل بيانات غير تطبيقي، يمكن لـ \&\fBSSL_read_ex\fP\|(3) و \fBSSL_read\fP\|(3) الإرجاع بفشل والإشارة إلى الحاجة لإعادة المحاولة مع \fBSSL_ERROR_WANT_READ\fP. إذا عُولج مثل هذا السجل، يتسبب العلم \&\fBSSL_MODE_AUTO_RETRY\fP في محاولة معالجة السجل التالي بدلاً من الإرجاع. .Sp في بيئة غير محظورة، يجب أن تكون التطبيقات مستعدة للتعامل مع عمليات قراءة/كتابة غير مكتملة. تعيين \fBSSL_MODE_AUTO_RETRY\fP لـ \fBBIO\fP غير محظور سيعالج سجلات البيانات غير التطبيقية حتى لا تتوفر بيانات إضافية أو يُعالج سجل بيانات تطبيقي. .Sp في بيئة محظورة، ليست التطبيقات دائمًا مستعدة للتعامل مع الدوال التي تُرجع تقارير وسيطة مثل طلبات إعادة المحاولة، وسيتسبب تعيين العلم \fBSSL_MODE_AUTO_RETRY\fP في إرجاع الدوال فقط بعد معالجة ناجحة لسجل بيانات تطبيقي أو فشل. .Sp قد يكون إيقاف تشغيل \fBSSL_MODE_AUTO_RETRY\fP مفيدًا مع \fBBIO\fPs المحظورة في حال استخدامها مع شيء مثل \fBselect()\fP أو \fBpoll()\fP. وإلا، قد يتعطل الاستدعاء لـ \fBSSL_read()\fP أو \fBSSL_read_ex()\fP عند إرسال سجل غير تطبيقي دون إرسال بيانات تطبيقية. .IP SSL_MODE_RELEASE_BUFFERS 4 .IX Item SSL_MODE_RELEASE_BUFFERS عندما لا نحتاج بعد الآن إلى مخزن قراءة أو مخزن كتابة لـ SSL معين، فحرر الذاكرة التي كنا نستخدمها لحفظه. استخدام هذه العلامة يمكن أن يوفر حوالي 34 كيلوبايت لكل اتصال SSL خامل. لا تأثير لهذه العلامة على اتصالات SSL v2 أو اتصالات DTLS. .IP SSL_MODE_SEND_FALLBACK_SCSV 4 .IX Item SSL_MODE_SEND_FALLBACK_SCSV أرسل TLS_FALLBACK_SCSV في ClientHello. يجب تعيينها فقط بواسطة التطبيقات التي تعيد الاتصال بإصدار بروتوكول مخفض؛ انظر draft\-ietf\-tls\-downgrade\-scsv\-00 للتفاصيل. .Sp لا تفعّل هذا إذا كان تطبيقك يحاول مصافحة عادية. استخدم هذا فقط في محاولات التخفيض الصريحة، وفقًا للتوجيهات في draft\-ietf\-tls\-downgrade\-scsv\-00. .IP SSL_MODE_ASYNC 4 .IX Item SSL_MODE_ASYNC فعّل المعالجة غير المتزامنة. قد تشير عمليات الإدخال/الإخراج TLS إلى إعادة محاولة مع SSL_ERROR_WANT_ASYNC عند تعيين هذا الوضع إذا استُخدم محرك قادر على المعالجة غير المتزامنة لأداء العمليات التعمية. انظر \fBSSL_get_error\fP\|(3). .IP SSL_MODE_DTLS_SCTP_LABEL_LENGTH_BUG 4 .IX Item SSL_MODE_DTLS_SCTP_LABEL_LENGTH_BUG الإصدارات الأقدم من OpenSSL كان بها خطأ في حساب طول التسمية المستخدم لحساب السر المشترك لزوج النقاط الطرفية. كان الخطأ هو تضمين الصفر الختامي في طول التسمية. تعيين هذا الخيار يُفعّل هذا السلوك للسماح بالتوافق مع هذه التطبيقات المعطوبة. يُرجى ملاحظة أن تعيين هذا الخيار يكسر التوافق مع التطبيقات الصحيحة. هذا الخيار ينطبق فقط على DTLS عبر SCTP. .PP جميع الأوضاع معطلة مبدئيًا باستثناء SSL_MODE_AUTO_RETRY والذي هو مفعّل مبدئيًا منذ 1.1.1. .SH "القيم المُرجعة" .IX Header "القيم المُرجعة" \&\fBSSL_CTX_set_mode()\fP و \fBSSL_set_mode()\fP يُرجعان قناع البت الجديد للوضع بعد إضافة \fBmode\fP. .PP \&\fBSSL_CTX_get_mode()\fP و \fBSSL_get_mode()\fP يُرجعان قناع البت الحالي. .SH "انظر أيضًا" .IX Header "انظر أيضًا" \&\fBssl\fP\|(7), \fBSSL_read_ex\fP\|(3), \fBSSL_read\fP\|(3), \fBSSL_write_ex\fP\|(3) أو \&\fBSSL_write\fP\|(3), \fBSSL_get_error\fP\|(3) .SH التاريخ .IX Header التاريخ أُضيف SSL_MODE_ASYNC في OpenSSL 1.1.0. .SH "حقوق النسخ" .IX Header "حقوق النسخ" حقوق النشر 2001\-2023 لمؤلفي مشروع 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 .