.\" -*- 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_WANT 3ssl"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH SSL_WANT 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_want, SSL_want_nothing, SSL_want_read, SSL_want_write,
SSL_want_x509_lookup, SSL_want_retry_verify, SSL_want_async,
SSL_want_async_job, SSL_want_client_hello_cb \- الحصول على معلومات الحالة
لعملية الإدخال/الإخراج TLS/SSL
.SH موجز
.IX Header موجز
.Vb 1
\& #include <openssl/ssl.h>
\&
\& int SSL_want(const SSL *ssl);
\& int SSL_want_nothing(const SSL *ssl);
\& int SSL_want_read(const SSL *ssl);
\& int SSL_want_write(const SSL *ssl);
\& int SSL_want_x509_lookup(const SSL *ssl);
\& int SSL_want_retry_verify(const SSL *ssl);
\& int SSL_want_async(const SSL *ssl);
\& int SSL_want_async_job(const SSL *ssl);
\& int SSL_want_client_hello_cb(const SSL *ssl);
.Ve
.SH الوصف
.IX Header الوصف
\&\fBSSL_want()\fP تُرجع معلومات الحالة لكائن SSL \fBssl\fP. \fBssl\fP \fBيجب ألا\fP
يكون NULL.
.PP
استدعاءات SSL_want_*() الأخرى هي اختصارات للحالات المحتملة التي تُرجعها
\fBSSL_want()\fP.
.SH ملاحظات
.IX Header ملاحظات
\&\fBSSL_want()\fP تفحص معلومات الحالة الداخلية لكائن SSL. قيمها المُرجعة
مشابهة لتلك الخاصة بـ \fBSSL_get_error\fP\|(3). على عكس \fBSSL_get_error\fP\|(3)،
التي تُقيّم أيضًا قائمة انتظار الأخطاء، تُحصل النتائج بفحص علامة حالة داخلية
فقط. لذلك، يجب استخدام المعلومات فقط للتشغيل العادي تحت الإدخال/الإخراج غير
المحظور. لا تُعالج حالات الخطأ ويجب معالجتها باستخدام \fBSSL_get_error\fP\|(3).
.PP
النتيجة التي تُرجعها \fBSSL_want()\fP يجب أن تكون دائمًا متسقة مع نتيجة
\fBSSL_get_error\fP\|(3).
.SH "القيم المُرجعة"
.IX Header "القيم المُرجعة"
قيم الإرجاع التالية يمكن أن تحدث حاليًا لـ \fBSSL_want()\fP:
.IP SSL_NOTHING 4
.IX Item SSL_NOTHING
لا توجد بيانات للكتابة أو القراءة.
.IP SSL_WRITING 4
.IX Item SSL_WRITING
توجد بيانات في مخزن SSL المؤقت يجب كتابتها إلى طبقة \&\fBBIO\fP الأساسية لإكمال
عملية SSL_*() الفعلية. استدعاء \fBSSL_get_error\fP\|(3) يجب أن يُرجع
\fBSSL_ERROR_WANT_WRITE\fP.
.IP SSL_READING 4
.IX Item SSL_READING
يجب قراءة المزيد من البيانات من طبقة \fBBIO\fP الأساسية لإكمال عملية SSL_*()
الفعلية. استدعاء \fBSSL_get_error\fP\|(3) يجب أن يُرجع \fBSSL_ERROR_WANT_READ\fP.
.IP SSL_X509_LOOKUP 4
.IX Item SSL_X509_LOOKUP
لم تكتمل العملية لأن استدعاء رجوع للتطبيق مُعيَّن بواسطة
\&\fBSSL_CTX_set_client_cert_cb()\fP طلب استدعاءه مرة أخرى. استدعاء
\fBSSL_get_error\fP\|(3) يجب أن يُرجع \fBSSL_ERROR_WANT_X509_LOOKUP\fP.
.IP SSL_RETRY_VERIFY 4
.IX Item SSL_RETRY_VERIFY
لم تكتمل العملية لأن استدعاء رجوع للتحقق من الشهادة طلب استدعاءه مرة أخرى
عبر \fBSSL_set_retry_verify\fP\|(3). استدعاء \fBSSL_get_error\fP\|(3) يجب أن يُرجع
\fBSSL_ERROR_WANT_RETRY_VERIFY\fP.
.IP SSL_ASYNC_PAUSED 4
.IX Item SSL_ASYNC_PAUSED
اكتملت عملية غير متزامنة جزئيًا ثم أُوقفت مؤقتًا. انظر
\&\fBSSL_get_all_async_fds\fP\|(3). يجب أن يُرجع استدعاء \fBSSL_get_error\fP\|(3)
\&\fBSSL_ERROR_WANT_ASYNC\fP.
.IP SSL_ASYNC_NO_JOBS 4
.IX Item SSL_ASYNC_NO_JOBS
تعذر بدء المهمة غير المتزامنة لعدم توفر مهام غير متزامنة في المجموعة (انظر
\fBASYNC_init_thread\fP\|(3)). يجب أن يُرجع استدعاء \fBSSL_get_error\fP\|(3)
\fBSSL_ERROR_WANT_ASYNC_JOB\fP.
.IP SSL_CLIENT_HELLO_CB 4
.IX Item SSL_CLIENT_HELLO_CB
لم تكتمل العملية لأن رد اتصال تطبيق مُعيَّن بواسطة
\&\fBSSL_CTX_set_client_hello_cb()\fP طلب استدعاءه مرة أخرى. يجب أن يُرجع
استدعاء \fBSSL_get_error\fP\|(3) \fBSSL_ERROR_WANT_CLIENT_HELLO_CB\fP.
.PP
تُرجع \&\fBSSL_want_nothing()\fP و \fBSSL_want_read()\fP و \fBSSL_want_write()\fP و
\&\fBSSL_want_x509_lookup()\fP و \fBSSL_want_retry_verify()\fP و
\&\fBSSL_want_async()\fP و \fBSSL_want_async_job()\fP و
\fBSSL_want_client_hello_cb()\fP القيمة 1 عندما يكون الشرط المقابل صحيحًا أو 0
بخلاف ذلك.
.SH "اعتبارات خاصة بـ QUIC"
.IX Header "اعتبارات خاصة بـ QUIC"
بالنسبة لـ QUIC، تتعلق هذه الدوال فقط بطبقة المصافحة TLS.
.SH "انظر أيضًا"
.IX Header "انظر أيضًا"
\&\fBssl\fP\|(7), \fBSSL_get_error\fP\|(3)
.SH التاريخ
.IX Header التاريخ
أُضيفت دالة \fBSSL_want_client_hello_cb()\fP وقيمة الإرجاع SSL_CLIENT_HELLO_CB
في OpenSSL 1.1.1.
.PP
أُضيفت \&\fBSSL_want_retry_verify()\fP في OpenSSL 3.0.
.SH "حقوق النسخ"
.IX Header "حقوق النسخ"
حقوق النشر 2001\-2025 لمؤلفي مشروع 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 .