SSL_GET_VERSION(3ssl)

الاسم
SSL_client_version، SSL_get_version، SSL_is_dtls، SSL_is_tls، SSL_is_quic، SSL_version - الحصول على معلومات البروتوكول لاتصال

موجز
 #include <openssl/ssl.h>

 int SSL_client_version(const SSL *s);

 const char *SSL_get_version(const SSL *ssl);

 int SSL_is_dtls(const SSL *ssl);
 int SSL_is_tls(const SSL *ssl);
 int SSL_is_quic(const SSL *ssl);

 int SSL_version(const SSL *s);

الوصف
بالنسبة لبروتوكولات SSL وTLS وDTLS، تُرجع SSL_client_version() إصدار البروتوكول الرقمي الذي أعلنه العميل في حقل legacy_version من ClientHello عند بدء الاتصال. لاحظ أنه بالنسبة لـTLS، لن تشير هذه القيمة أبدًا إلى إصدار أكبر من TLSv1.2 حتى لو تم التفاوض لاحقًا على TLSv1.3. بالنسبة لاتصالات QUIC، تُرجع OSSL_QUIC1_VERSION.

تُرجع SSL_get_version() اسم البروتوكول المستخدم للاتصال. تُرجع SSL_version() إصدار البروتوكول الرقمي المستخدم للاتصال. يجب استدعاؤها فقط بعد اكتمال المصافحة الأولية. قبل ذلك، قد تكون النتائج المُرجَعة من هذه الدوال غير موثوقة.

تُرجع SSL_is_dtls() 1 إذا كان الاتصال يستخدم DTLS أو 0 إذا لم يكن كذلك.

تُرجع SSL_is_tls() 1 إذا كان الاتصال يستخدم SSL/TLS أو 0 إذا لم يكن كذلك.

تُرجع SSL_is_quic() 1 إذا كان الاتصال يستخدم QUIC أو 0 إذا لم يكن كذلك.

القيم المُرجعة
تُرجع SSL_get_version() إحدى السلاسل التالية:

SSLv3
    يستخدم الاتصال بروتوكول SSLv3.

TLSv1
    يستخدم الاتصال بروتوكول TLSv1.0.

TLSv1.1
    يستخدم الاتصال بروتوكول TLSv1.1.

TLSv1.2
    يستخدم الاتصال بروتوكول TLSv1.2.

TLSv1.3
    يستخدم الاتصال بروتوكول TLSv1.3.

DTLSv0.9
    يستخدم الاتصال بروتوكول DTLS قديمًا قبل التوحيد القياسي

DTLSv1
    يستخدم الاتصال بروتوكول DTLSv1

DTLSv1.2
    يستخدم الاتصال بروتوكول DTLSv1.2

QUICv1
    يستخدم الاتصال بروتوكول QUICv1.

unknown
    يشير هذا إلى إصدار بروتوكول غير معروف.

SSL_version() و SSL_client_version() تُرجعان عددًا صحيحًا قد يتضمن أيًا مما يلي:

SSL3_VERSION
    يستخدم الاتصال بروتوكول SSLv3.

TLS1_VERSION
    يستخدم الاتصال بروتوكول TLSv1.0.

TLS1_1_VERSION
    يستخدم الاتصال بروتوكول TLSv1.1.

TLS1_2_VERSION
    يستخدم الاتصال بروتوكول TLSv1.2.

TLS1_3_VERSION
    يستخدم الاتصال بروتوكول TLSv1.3 (لا يُرجع أبدًا لـ SSL_client_version()).

DTLS1_BAD_VER
    يستخدم الاتصال بروتوكول DTLS قديمًا قبل التوحيد القياسي

DTLS1_VERSION
    يستخدم الاتصال بروتوكول DTLSv1

DTLS1_2_VERSION
    يستخدم الاتصال بروتوكول DTLSv1.2

OSSL_QUIC1_VERSION
    يستخدم الاتصال بروتوكول QUICv1.

انظر أيضًا
ssl(7)

التاريخ
أُضيفت الدالة SSL_is_dtls() في OpenSSL 1.1.0. أُضيفت الدالتان SSL_is_tls() و SSL_is_quic() في OpenSSL 3.2.

حقوق النسخ
حقوق النشر 2001-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.