.\" -*- 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_GET_CIPHERS 3ssl" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH SSL_GET_CIPHERS 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_get1_supported_ciphers, SSL_get_client_ciphers, SSL_get_ciphers, SSL_CTX_get_ciphers, SSL_bytes_to_cipher_list, SSL_get_cipher_list, SSL_get_shared_ciphers \&\- الحصول على قائمة SSL_CIPHERs المتاحة .SH موجز .IX Header موجز .Vb 1 \& #include \& \& STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *ssl); \& STACK_OF(SSL_CIPHER) *SSL_CTX_get_ciphers(const SSL_CTX *ctx); \& STACK_OF(SSL_CIPHER) *SSL_get1_supported_ciphers(SSL *s); \& STACK_OF(SSL_CIPHER) *SSL_get_client_ciphers(const SSL *ssl); \& int SSL_bytes_to_cipher_list(SSL *s, const unsigned char *bytes, size_t len, \& int isv2format, STACK_OF(SSL_CIPHER) **sk, \& STACK_OF(SSL_CIPHER) **scsvs); \& const char *SSL_get_cipher_list(const SSL *ssl, int priority); \& char *SSL_get_shared_ciphers(const SSL *s, char *buf, int size); .Ve .SH الوصف .IX Header الوصف \&\fBSSL_get_ciphers()\fP تُرجع كومة SSL_CIPHERs المتاحة لـ \fBssl\fP، مُرتبة حسب التفضيل. إذا كان \fBssl\fP فارغًا أو لم تتوفر أي مُعمِّيات، فتُرجع NULL. .PP \&\fBSSL_CTX_get_ciphers()\fP تُرجع كومة SSL_CIPHERs المتاحة لـ \fBctx\fP. .PP \&\fBSSL_get1_supported_ciphers()\fP تُرجع كومة SSL_CIPHERs المُفعَّلة لـ \&\fBssl\fP كما ستُرسل في ClientHello (أي مُرتبة حسب التفضيل). تعتمد القائمة على إعدادات مثل قائمة المُعمِّيات، وإصدارات البروتوكول المدعومة، ومستوى الأمان، وخوارزميات التوقيع المُفعَّلة. تُفعَّل مُعمِّيات SRP و PSK فقط إذا طُبقت الاستدعاءات أو الإعدادات المناسبة. قد تختلف قائمة المُعمِّيات التي ستُرسل في ClientHello عن قائمة المُعمِّيات المقبولة عند العمل كخادم. على سبيل المثال، قد يستخدم الخادم مُعمِّيات إضافية إذا وُجدت فجوة في قائمة البروتوكولات المدعومة، وقد لا يستخدم الخادم بعض المُعمِّيات إذا لم يُهيأ شهادة مناسبة. إذا كان \fBssl\fP فارغًا أو لم تتوفر أي مُعمِّيات، فتُرجع NULL. .PP \&\fBSSL_get_client_ciphers()\fP تُرجع كومة SSL_CIPHERs المتاحة المطابقة للقائمة المُستلمة من العميل على \fBssl\fP. إذا كان \fBssl\fP فارغًا، أو لم تتوفر أي مُعمِّيات، أو لم يعمل \fBssl\fP في وضع الخادم، فتُرجع NULL. .PP \&\fBSSL_bytes_to_cipher_list()\fP تُعالج \fBlen\fP ثمانيات المُقدَّمة في \fBbytes\fP كمواصفات حزمة مُعمِّيات بروتوكول سلكي (بتنسيق SSLv2 السلكي بثلاث ثمانيات لكل مُعمٍّ إذا كان \fBisv2format\fP غير صفري؛ وإلا بتنسيق SSLv3/TLS السلكي بثمانيتين)، وتُحلِّل حزم المُعمِّيات المدعومة من المكتبة إلى كومة كائنات SSL_CIPHER المُرجَعة sk وقيم إشارات حزمة المُعمِّيات scsvs. تُتجاهل حزم المُعمِّيات غير المدعومة. تُرجع 1 عند النجاح و0 عند الفشل. .PP \&\fBSSL_get_cipher_list()\fP تُرجع مؤشرًا لاسم SSL_CIPHER المُدرَج لـ \fBssl\fP مع \fBpriority\fP. إذا كان \fBssl\fP فارغًا، أو لم تتوفر أي مُعمِّيات، أو توفرت مُعمِّيات أقل من \fBpriority\fP، فتُرجع NULL. .PP \&\fBSSL_get_shared_ciphers()\fP تُنشئ قائمة بأسماء SSL_CIPHER مفصولة بنقطتين ومنتهية بـ NUL والمتاحة في كل من العميل والخادم. \fBbuf\fP هو المخزن الذي يجب ملؤه بقائمة الأسماء و \fBsize\fP هو حجم ذلك المخزن. يُرجع مؤشر إلى \fBbuf\fP عند النجاح أو NULL عند الخطأ. إذا لم يكن المخزن المُقدَّم كبيرًا بما يكفي لاحتواء القائمة الكاملة للأسماء، فتُرجع قائمة مبتورة من الأسماء. لاحظ أن مجرد توفر حزمة مُعمِّيات (أي أنها مُهيأة في قائمة المُعمِّيات) ومشاركتها بين العميل والخادم لا يعني أنها مُفعَّلة (انظر وصف \fBSSL_get1_supported_ciphers()\fP أعلاه). تُرجع هذه الدالة حزم المُعمِّيات المشتركة المتاحة سواء كانت مُفعَّلة أم لا. هذه دالة خاصة بالخادم فقط ويجب استدعاؤها فقط بعد اكتمال المصافحة الأولية. تُعيِّن الدالة سلسلة فارغة عندما يفشل \fBssl\fP في المصافحة بسبب عدم وجود مُعمِّيات مشتركة. .SH ملاحظات .IX Header ملاحظات يمكن الحصول على تفاصيل المُعمِّيات التي حصلت عليها \fBSSL_get_ciphers()\fP و \fBSSL_CTX_get_ciphers()\fP \&\fBSSL_get1_supported_ciphers()\fP و \fBSSL_get_client_ciphers()\fP باستخدام عائلة دوال \fBSSL_CIPHER_get_name\fP\|(3). .PP استدعِ \fBSSL_get_cipher_list()\fP مع \fBpriority\fP بدءًا من 0 للحصول على القائمة المُرتَّبة للمُعمِّيات المتاحة، حتى تُرجع NULL. .PP ملاحظة: \fBSSL_get_ciphers()\fP و \fBSSL_CTX_get_ciphers()\fP و \fBSSL_get_client_ciphers()\fP تُرجع مؤشرًا لكومة مُعمِّيات داخلية، والتي ستُحرر لاحقًا عند تحرير كائن SSL أو SSL_SESSION. لذلك، \fBيجب ألا\fP يحرر الكود المستدعي القيمة المُرجعة نفسها. .PP يجب تحرير الكومة المُرجعة بواسطة \fBSSL_get1_supported_ciphers()\fP باستخدام \&\fBsk_SSL_CIPHER_free()\fP. .PP يجب تحرير الكومات المُرجعة بواسطة \fBSSL_bytes_to_cipher_list()\fP باستخدام \&\fBsk_SSL_CIPHER_free()\fP. .SH "القيم المُرجعة" .IX Header "القيم المُرجعة" انظر الوصف (DESCRIPTION) .SH "انظر أيضًا" .IX Header "انظر أيضًا" \&\fBssl\fP\|(7), \fBSSL_CTX_set_cipher_list\fP\|(3), \&\fBSSL_CIPHER_get_name\fP\|(3) .SH "حقوق النسخ" .IX Header "حقوق النسخ" حقوق النشر 2000\-2026 لمؤلفي مشروع 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 .