EVP_PKEY_GET_DEFAULT_DIGEST_NID(3ssl)

الاسم
EVP_PKEY_get_default_digest_nid, EVP_PKEY_get_default_digest_name \&- الحصول على المُعمِّي الافتراضي للتوقيع

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

 int EVP_PKEY_get_default_digest_name(EVP_PKEY *pkey,
                                      char *mdname, size_t mdname_sz);
 int EVP_PKEY_get_default_digest_nid(EVP_PKEY *pkey, int *pnid);

الوصف
EVP_PKEY_get_default_digest_name() تملأ اسم المُعمِّي الافتراضي لعمليات توقيع المفتاح العمومي المرتبطة بالمفتاح pkey في mdname، حتى mdname_sz بايت كحد أقصى بما في ذلك البايت الختامي NUL. قد يكون الاسم "UNDEF"، مما يشير إلى أن المُعمِّي يجب (لقيمة الإرجاع 2) أو قد (لقيمة الإرجاع 1) أن يُترك غير محدد.

EVP_PKEY_get_default_digest_nid() تعيّن pnid إلى NID المُعمِّي الافتراضي لعمليات توقيع المفتاح العمومي المرتبطة بالمفتاح pkey. لاحظ أن بعض خوارزميات التوقيع (مثل Ed25519 و Ed448) لا تستخدم مُعمِّيًا أثناء التوقيع. في هذه الحالة، سيُعيَّن pnid إلى NID_undef. هذه الدالة موثوقة فقط للمفاتيح القديمة، وهي المفاتيح التي تحتوي على EVP_PKEY_ASN1_METHOD؛ هذه المفاتيح عادةً ما تم تحميلها من المحركات، أو أُنشئت باستخدام EVP_PKEY_assign_RSA(3) أو ما شابه.

ملاحظات
لجميع خوارزميات المفتاح العمومي القياسية الحالية في OpenSSL، يُرجَع SHA256.

القيم المُرجعة
EVP_PKEY_get_default_digest_name() و EVP_PKEY_get_default_digest_nid() كلاهما يُرجعان 1 إذا كان المُعمِّي استشاريًا (أي يمكن استخدام مُعمِّيات أخرى) و 2 إذا كان إلزاميًا (لا يمكن استخدام مُعمِّيات أخرى). يُرجعان 0 أو قيمة سالبة عند الفشل. على وجه الخصوص، تشير قيمة الإرجاع -2 إلى أن العملية غير مدعومة من قبل خوارزمية المفتاح العمومي.

انظر أيضًا
EVP_PKEY_CTX_new(3), EVP_PKEY_sign(3), EVP_PKEY_digestsign_supports_digest(3), EVP_PKEY_verify(3), EVP_PKEY_verify_recover(3),

التاريخ
أُضيفت هذه الدالة في OpenSSL 1.0.0.

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