SSL_GET_CURRENT_CIPHER(3SSL)

الاسم
SSL_get_current_cipher, SSL_get_cipher_name, SSL_get_cipher, SSL_get_cipher_bits, SSL_get_cipher_version, SSL_get_pending_cipher - الحصول على SSL_CIPHER لاتصال

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

 const SSL_CIPHER *SSL_get_current_cipher(const SSL *ssl);
 const SSL_CIPHER *SSL_get_pending_cipher(const SSL *ssl);

 const char *SSL_get_cipher_name(const SSL *s);
 const char *SSL_get_cipher(const SSL *s);
 int SSL_get_cipher_bits(const SSL *s, int *np);
 const char *SSL_get_cipher_version(const SSL *s);

الوصف
SSL_get_current_cipher() يُرجع مؤشرًا إلى كائن SSL_CIPHER يحتوي على وصف المُعمِّي المستخدم فعليًا لاتصال أُنشئ مع كائن ssl. ssl يجب ألا يكون NULL. انظر SSL_CIPHER_get_name(3) لمزيد من التفاصيل.

SSL_get_cipher_name() يحصل على اسم المُعمِّي المستخدم حاليًا. SSL_get_cipher() مطابق لـ SSL_get_cipher_name(). SSL_get_cipher_bits() هو كليّة للحصول على عدد بتات السر/الخوارزمية المستخدمة و SSL_get_cipher_version() يُرجع اسم البروتوكول.

SSL_get_pending_cipher() يُرجع مؤشرًا إلى كائن SSL_CIPHER يحتوي على وصف المُعمِّي (إن وُجد) الذي فُوِّض للاستخدام المستقبلي على الاتصال المُنشأ مع كائن ssl، لكنه ليس قيد الاستخدام بعد. قد تكون هذه هي الحالة أثناء معالجة المصافحة، عندما يُعاد تدفق التحكم إلى التطبيق عبر أي من عدة طرق استدعاء رجعي. التسلسل الداخلي لمعالجة المصافحة واستدعاء الاستدعاء الرجعي غير مضمون ليكون مستقرًا من إصدار إلى آخر، وحاليًا فقط الاستدعاء الرجعي المُعيَّن بواسطة SSL_CTX_set_alpn_select_cb() مضمون أن تكون له قيمة إرجاع غير NULL. قد تُضاف استدعاءات رجعية أخرى إلى هذه القائمة بمرور الوقت.

القيم المُرجعة
SSL_get_current_cipher() يُرجع المُعمِّي المستخدم فعليًا، أو NULL إذا لم تُنشأ جلسة.

SSL_get_pending_cipher() يُرجع المُعمِّي الذي سيُستخدم عند التغيير التالي لمجموعة المُعمِّيات، أو NULL إذا لم يُعرف مثل هذا المُعمِّي.

ملاحظات
SSL_get_cipher, SSL_get_cipher_bits, SSL_get_cipher_version, و SSL_get_cipher_name مُنفَّذة ككليّات.

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

حقوق النسخ
حقوق الطبع والنشر 2000-2018 لمؤلفي مشروع 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.