EVP_PKEY_COPY_PARAMETERS(3SSL)

الاسم
EVP_PKEY_missing_parameters, EVP_PKEY_copy_parameters, EVP_PKEY_parameters_eq, EVP_PKEY_cmp_parameters, EVP_PKEY_eq, EVP_PKEY_cmp - دوال معامل المفتاح العام والمقارنة

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

 int EVP_PKEY_missing_parameters(const EVP_PKEY *pkey);
 int EVP_PKEY_copy_parameters(EVP_PKEY *to, const EVP_PKEY *from);

 int EVP_PKEY_parameters_eq(const EVP_PKEY *a, const EVP_PKEY *b);
 int EVP_PKEY_eq(const EVP_PKEY *a, const EVP_PKEY *b);

الدوال التالية أصبحت مهجورة منذ OpenSSL 3.0، ويمكن إخفاؤها تماماً عن طريق تعريف OPENSSL_API_COMPAT بقيمة إصدار مناسبة، انظر openssl_user_macros(7):

 int EVP_PKEY_cmp_parameters(const EVP_PKEY *a, const EVP_PKEY *b);
 int EVP_PKEY_cmp(const EVP_PKEY *a, const EVP_PKEY *b);

الوصف
تُرجع الدالة EVP_PKEY_missing_parameters() القيمة 1 إذا كانت معاملات المفتاح العام لـ pkey مفقودة، و0 إذا كانت موجودة أو إذا كانت الخوارزمية لا تستخدم معاملات.

تنسخ الدالة EVP_PKEY_copy_parameters() المعاملات من المفتاح from إلى المفتاح to. يُرجع خطأ إذا كانت المعاملات مفقودة في from أو موجودة في كل من from وto وغير متطابقة. إذا كانت المعاملات في from وto موجودة ومتطابقة، فلا تأثير لهذه الدالة.

تفحص الدالة EVP_PKEY_parameters_eq() معاملات المفتاحين a وb من أجل التساوي.

تفحص الدالة EVP_PKEY_eq() المفتاحين a وb من أجل التساوي، بما في ذلك معاملاتهما إذا كانت متوفرة.

ملاحظات
الغرض الرئيسي من الدالتين EVP_PKEY_missing_parameters() وEVP_PKEY_copy_parameters() هو معالجة المفاتيح العامة في الشهادات حيث تُحذف المعاملات أحيانًا من المفتاح العام إذا كانت موروثة من CA الذي وقعه.

تختلف الدالتان المُهملتان EVP_PKEY_cmp() وEVP_PKEY_cmp_parameters() في قيم الإرجاع مقارنة بدوال _cmp() الأخرى. هما اسمان مستعاران لـ EVP_PKEY_eq() وEVP_PKEY_parameters_eq().

كانت الدالة EVP_PKEY_cmp() سابقًا تفحص فقط معاملات المفتاح (إن وُجدت) والمفتاح العام، بافتراض وجود مفتاح عام دائمًا وأن مساواة المفتاح الخاص يمكن استنتاجها من ذلك. ونظرًا لأنه لم يعد يُفترض أن المفتاح الخاص في EVP_PKEY(3) يرافقه دائمًا مفتاح عام، فلا يمكن للمقارنة الاعتماد على مقارنة المفتاح العام وحدها.

بدلاً من ذلك، تقارن EVP_PKEY_eq() (وبالتالي أيضًا EVP_PKEY_cmp()) الآن:

1.  معاملات المفتاح (إن وجدت)

2.  المفاتيح العامة أو المفاتيح الخاصة لـ EVP_PKEYين، اعتمادًا على ما يحتويان عليه.

القيم المُرجعة
تُرجع الدالة EVP_PKEY_missing_parameters() القيمة 1 إذا كانت معاملات المفتاح العام لـ pkey مفقودة، و0 إذا كانت موجودة أو إذا كانت الخوارزمية لا تستخدم معاملات.

ترجع هذه الدوال EVP_PKEY_copy_parameters() 1 للنجاح و0 للفشل.

تُرجع الدوال EVP_PKEY_cmp_parameters() و EVP_PKEY_parameters_eq() و EVP_PKEY_cmp() و EVP_PKEY_eq() القيمة 1 إذا تطابقت مدخلاتها، و0 إذا لم تتطابق، و-1 إذا كانت أنواع المفاتيح مختلفة، و-2 إذا كانت العملية غير مدعومة.

انظر أيضًا
EVP_PKEY_CTX_new(3)، EVP_PKEY_keygen(3)

التاريخ
أُهملت الدالتان EVP_PKEY_cmp() وEVP_PKEY_cmp_parameters() في OpenSSL 3.0.

أُضيفت الدالتان EVP_PKEY_eq() وEVP_PKEY_parameters_eq() في OpenSSL 3.0 لاستبدال EVP_PKEY_cmp() وEVP_PKEY_cmp_parameters().

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