BN_NEW(3SSL)

الاسم
BN_new, BN_secure_new, BN_clear, BN_free, BN_clear_free - تخصيص وتحرير BIGNUMs

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

 BIGNUM *BN_new(void);

 BIGNUM *BN_secure_new(void);

 void BN_clear(BIGNUM *a);

 void BN_free(BIGNUM *a);

 void BN_clear_free(BIGNUM *a);

الوصف
BN_new() تخصص وتهيئ بنية BIGNUM. BN_secure_new() تفعل الشيء نفسه باستثناء أن الكومة الآمنة OPENSSL_secure_malloc(3) تُستخدم لتخزين القيمة.

BN_clear() تُستخدم لتدمير البيانات الحساسة مثل المفاتيح عندما لا تكون مطلوبة بعد الآن. تمسح الذاكرة المستخدمة بواسطة a وتضبطها على القيمة 0. إذا كان a هو NULL، لا يُفعل شيء.

BN_free() تحرر مكونات BIGNUM، وإذا أُنشئت بواسطة BN_new()، تحرر البنية نفسها أيضًا. BN_clear_free() تكتب فوق البيانات بالإضافة قبل إعادة الذاكرة إلى النظام. إذا كان a هو NULL، لا يُفعل شيء.

القيم المُرجعة
BN_new() و BN_secure_new() ترجعان مؤشرًا إلى BIGNUM المُهيأ إلى القيمة 0. إذا فشل التخصيص، ترجعان NULL وتضبطان رمز خطأ يمكن الحصول عليه بواسطة ERR_get_error(3).

BN_clear() و BN_free() و BN_clear_free() ليس لها قيم إرجاع.

انظر أيضًا
ERR_get_error(3), OPENSSL_secure_malloc(3)

التاريخ
BN_init() أُزيلت في OpenSSL 1.1.0؛ استخدم BN_new() بدلاً منها.

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