.\" -*- 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_NEW 3ssl" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH SSL_NEW 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_dup, SSL_new, SSL_up_ref \- إنشاء بنية SSL لاتصال .SH موجز .IX Header موجز .Vb 1 \& #include \& \& SSL *SSL_dup(SSL *s); \& SSL *SSL_new(SSL_CTX *ctx); \& int SSL_up_ref(SSL *s); .Ve .SH الوصف .IX Header الوصف \&تنشئ الدالة \fBSSL_new()\fP بنية \fBSSL\fP جديدة تُحتاج لحفظ بيانات اتصال TLS/SSL. ترث البنية الجديدة إعدادات السياق الأساسي \fBctx\fP: طريقة الاتصال، الخيارات، إعدادات التحقق، إعدادات المهلة. تُعد بنية \fBSSL\fP ذات عداد مرجعي. يزيد إنشاء بنية \fBSSL\fP لأول مرة من عداد المرجعي. يُنقص تحريرها (باستخدام SSL_free) من العداد. عندما ينخفض العداد المرجعي إلى الصفر، يُحرر أي ذاكرة أو موارد خُصصت لبنية \fBSSL\fP. .PP \&تزيد الدالة \fBSSL_up_ref()\fP العداد المرجعي لبنية \fBSSL\fP موجودة. .PP تنشئ الدالة \fBSSL_dup()\fP وتُعيد بنية \fBSSL\fP جديدة من نفس \&\fBSSL_CTX\fP الذي استُخدم لإنشاء \fIs\fP. تنسخ بالإضافة إلى ذلك مجموعة فرعية من الإعدادات في \fIs\fP إلى كائن \fBSSL\fP الجديد. .PP لكي تعمل \fBSSL_dup()\fP، يجب أن يكون الاتصال في حالته الأولية ويجب ألا يكون قد بدأ مصافحة SSL بعد. بالنسبة للاتصالات غير الموجودة في حالتها الأولية، تزيد \fBSSL_dup()\fP فقط عدادًا مرجعيًا داخليًا وتُعيد نفس المقبض \fIنفسه\fP. قد يكون من الممكن استخدام \fBSSL_clear\fP\|(3) لإعادة تدوير مقبض SSL غير موجود في حالته الأولية لإعادة الاستخدام، لكن من الأفضل تجنب ذلك. بدلاً من ذلك، احفظ واستعد الجلسة، إذا رغبت، وأنشئ مقبضًا جديدًا لكل اتصال. .PP المجموعة الفرعية من الإعدادات في \fIs\fP التي تُنسخ هي: .IP "أي بيانات جلسة إذا كانت مُهيأة (بما في ذلك session_id_context)" 4 .IX Item "أي بيانات جلسة إذا كانت مُهيأة (بما في ذلك session_id_context)" .PD 0 .IP "أي إعدادات tmp_dh مُعينة عبر \fBSSL_set_tmp_dh\fP\|(3)، أو \fBSSL_set_tmp_dh_callback\fP\|(3)، أو \fBSSL_set_dh_auto\fP\|(3)" 4 .IX Item "أي إعدادات tmp_dh مُعينة عبر SSL_set_tmp_dh، أو SSL_set_tmp_dh_callback، أو SSL_set_dh_auto" .IP "أي شهادات مُهيأة، أو مفاتيح خاصة، أو سلاسل شهادات" 4 .IX Item "أي شهادات مُهيأة، أو مفاتيح خاصة، أو سلاسل شهادات" .IP "أي خوارزميات توقيع مُهيأة، أو خوارزميات توقيع العميل" 4 .IX Item "أي خوارزميات توقيع مُهيأة، أو خوارزميات توقيع العميل" .IP "أي إعدادات DANE" 4 .IX Item "أي إعدادات DANE" .IP "أي خيارات مُعينة عبر \fBSSL_set_options\fP\|(3)" 4 .IX Item "أي خيارات مُعينة عبر SSL_set_options" .IP "أي وضع مُعين عبر \fBSSL_set_mode\fP\|(3)" 4 .IX Item "أي وضع مُعين عبر SSL_set_mode" .IP "أي إعدادات بروتوكول دنيا أو قصوى مُعينة عبر \fBSSL_set_min_proto_version\fP\|(3) أو \fBSSL_set_max_proto_version\fP\|(3) (ملاحظة: فقط من OpenSSL 1.1.1h وما فوق)" 4 .IX Item "أي إعدادات للبروتوكول الأدنى أو الأقصى مُعيَّنة عبر SSL_set_min_proto_version أو SSL_set_max_proto_version (ملاحظة: فقط من OpenSSL 1.1.1h فما فوق)" .IP "أي وضع تحقق أو استدعاء رجعي أو عمق مُعيَّن عبر \fBSSL_set_verify\fP\|(3) أو \fBSSL_set_verify_depth\fP\|(3) أو أي معاملات تحقق X509 مُهيَّأة" 4 .IX Item "أي وضع تحقق أو استدعاء رجعي أو عمق مُعيَّن عبر SSL_set_verify أو SSL_set_verify_depth أو أي معاملات تحقق X509 مُهيَّأة" .IP "أي استدعاء رجعي للرسالة أو استدعاء رجعي للمعلومات مُعيَّن عبر \fBSSL_set_msg_callback\fP\|(3) أو \fBSSL_set_info_callback\fP\|(3)" 4 .IX Item "أي استدعاء رجعي للرسالة أو استدعاء رجعي للمعلومات مُعيَّن عبر SSL_set_msg_callback أو SSL_set_info_callback" .IP "أي استدعاء رجعي مبدئي لكلمة السر مُعيَّن عبر \fBSSL_set_default_passwd_cb\fP\|(3)" 4 .IX Item "أي استدعاء رجعي مبدئي لكلمة السر مُعيَّن عبر SSL_set_default_passwd_cb" .IP "أي استدعاء رجعي لتوليد معرف الجلسة مُعيَّن عبر \fBSSL_set_generate_session_id\fP\|(3)" 4 .IX Item "أي استدعاء رجعي لتوليد معرف الجلسة مُعيَّن عبر SSL_set_generate_session_id" .IP "أي قائمة معميات مُهيَّأة" 4 .IX Item "أي قائمة معميات مُهيَّأة" .IP "حالة القبول الأولي (خادم) أو الاتصال (عميل)" 4 .IX Item "حالة القبول الأولي (خادم) أو الاتصال (عميل)" .IP "قيمة قائمة الشهادات القصوى المُعيَّنة عبر \fBSSL_set_max_cert_list\fP\|(3)" 4 .IX Item "قيمة قائمة الشهادات القصوى المُعيَّنة عبر SSL_set_max_cert_list" .IP "قيمة القراءة المسبقة المُعيَّنة عبر \fBSSL_set_read_ahead\fP\|(3)" 4 .IX Item "قيمة القراءة المسبقة المُعيَّنة عبر SSL_set_read_ahead" .IP "بيانات خاصة بالتطبيق مُعيَّنة عبر \fBSSL_set_ex_data\fP\|(3)" 4 .IX Item "بيانات خاصة بالتطبيق مُعيَّنة عبر SSL_set_ex_data" .IP "أي قائمة مراجع مصادقة أو قائمة مراجع مصادقة للعميل مُعيَّنة عبر \fBSSL_set0_CA_list\fP\|(3) أو \fBSSL_set0_client_CA_list()\fP أو دوال مشابهة" 4 .IX Item "أي قائمة مراجع مصادقة أو قائمة مراجع مصادقة للعميل مُعيَّنة عبر SSL_set0_CA_list أو SSL_set0_client_CA_list() أو دوال مشابهة" .IP "أي إعدادات لمستوى الأمان أو استدعاءات رجعية" 4 .IX Item "أي إعدادات لمستوى الأمان أو استدعاءات رجعية" .IP "أي بيانات معلومات الخادم المهيأة" 4 .IX Item "أي بيانات معلومات الخادم المهيأة" .IP "أي تلميح هوية PSK مهيأ" 4 .IX Item "أي تلميح هوية PSK مهيأ" .IP "أي امتدادات مخصصة مهيأة" 4 .IX Item "أي امتدادات مخصصة مهيأة" .IP "أي أنواع شهادات عميل مهيأة عبر SSL_set1_client_certificate_types" 4 .IX Item "أي أنواع شهادات عميل مهيأة عبر SSL_set1_client_certificate_types" .PD .PP \&\fBSSL_dup()\fP غير مدعوم على كائنات QUIC SSL وتُرجع NULL إذا استُدعيت على هذا الكائن. .SH "القيم المُرجعة" .IX Header "القيم المُرجعة" يمكن أن تحدث قيم الإعادة التالية: .IP NULL 4 .IX Item NULL فشل إنشاء بنية SSL جديدة. افحص مكدس الأخطاء لمعرفة السبب. .IP "مؤشر إلى بنية SSL" 4 .IX Item "مؤشر إلى بنية SSL" تشير القيمة المُرجعة إلى بنية SSL مخصصة. .Sp \&\fBSSL_up_ref()\fP تُرجع 1 للنجاح و0 للفشل. .SH "انظر أيضًا" .IX Header "انظر أيضًا" \&\fBSSL_free\fP\|(3), \fBSSL_clear\fP\|(3), \&\fBSSL_CTX_set_options\fP\|(3), \&\fBSSL_get_SSL_CTX\fP\|(3), \&\fBssl\fP\|(7) .SH "حقوق النسخ" .IX Header "حقوق النسخ" حقوق النشر 2000\-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 .