OPENSSL-REHASH(1ssl)

الاسم
openssl-rehash, c_rehash - إنشاء روابط رمزية للملفات المُسمّاة بقيم التجزئة

موجز
openssl rehash [-h] [-help] [-old] [-compat] [-n] [-v] [-provider name] [-provider-path path] [-provparam [name:]key=value] [-propquery propq] [directory] ...

c_rehash [-h] [-help] [-old] [-n] [-v] [-provider name] [-provider-path path] [-provparam [name:]key=value] [-propquery propq] [directory] ...

الوصف
هذا الأمر مكافئ عامةً للنص البرمجي الخارجي c_rehash، باستثناء اختلافات طفيفة مُشار إليها أدناه.

openssl rehash يمسح الدلائل ويحسب قيمة تجزئة لكل ملف .pem أو .crt أو .cer أو .crl في قائمة الدلائل المُحددة وينشئ روابط رمزية لكل ملف، حيث اسم الرابط هو قيمة التجزئة. (إذا كان النظام لا يدعم الروابط الرمزية، تُنشأ نسخة.) هذا الأمر مفيد لأن العديد من البرامج التي تستخدم OpenSSL تتطلب إعداد الدلائل بهذه الطريقة للعثور على الشهادات.

إذا سُميت أي دلائل في سطر الأوامر، فتُعالج تلك بدورها. إذا لم يُسمَ أي دليل، يُستشار متغير البيئة SSL_CERT_DIR؛ يجب أن يكون هذا قائمة من الدلائل مفصولة بنقطتين رأسيتين، مثل متغير Unix PATH. إذا لم يُعين ذلك، يُعالج الدليل المبدئي (خاص بالتنصيب لكن غالبًا /usr/local/ssl/certs).

لمعالجة دليل، يجب أن يمتلك المستخدم أذونات كتابة على ذلك الدليل، وإلا يُنشأ خطأ.

الروابط المُنشأة تكون من الشكل HHHHHHHH.D، حيث كل H هو حرف ست عشري و D هو رقم عشري واحد. عند معالجة دليل، تُزال أولاً جميع الروابط فيه التي لها اسم بهذا الصياغ، حتى لو كانت تُستخدم لغرض آخر. لتخطي خطوة الإزالة، استخدم العلم -n. تجزئات قوائم إلغاء الشهادات (CRL) تبدو مشابهة باستثناء ظهور الحرف r بعد النقطة، هكذا: HHHHHHHH.rD.

قد يكون لكائنات متعددة نفس التجزئة؛ يُشار إليها بزيادة قيمة D. تُكتشف التكرارات بمقارنة بصمة SHA-1 الكاملة. يُعرض تحذير إذا وُجد تكرار.

يُعرض تحذير أيضًا إذا كانت هناك ملفات لا يمكن تحليلها كشهادة أو كقائمة إلغاء شهادات (CRL) أو إذا ظهر أكثر من كائن من هذا القبيل في الملف.

  تهيئة النص البرمجي
النص البرمجي c_rehash يستخدم برنامج openssl لحساب التجزئات والبصمات. إذا لم يُوجد في PATH الخاص بالمستخدم، فعيّن متغير البيئة OPENSSL إلى اسم المسار الكامل. يمكن استخدام أي برنامج، يُستدعى كالتالي إما لشهادة أو لقائمة إلغاء شهادات (CRL):

  $OPENSSL x509 -hash -fingerprint -noout -in FILENAME
  $OPENSSL crl -hash -fingerprint -noout -in FILENAME

حيث FILENAME هو اسم الملف. يجب أن يُخرج تجزئة الملف في السطر الأول، والبصمة في السطر الثاني، مع إمكانية سبقهما ببعض النص وعلامة يساوي.

الخيارات

-help -h
    عرض رسالة استخدام موجزة.

-old
    استخدام تجزئة النمط القديم (MD5، بدلاً من SHA-1) لتوليد روابط تُستخدم للإصدارات قبل 1.0.0. لاحظ أن الإصدارات الحالية لن تستخدم النمط القديم.

-n  عدم إزالة الروابط الموجودة. هذا ضروري عند الاحتفاظ بروابط النمط الجديد والقديم في نفس الدليل.

-compat
    توليد روابط لكل من تجزئة النمط القديم (MD5) والنمط الجديد (SHA1). هذا يسمح للإصدارات قبل 1.0.0 باستخدام هذه الروابط جنبًا إلى جنب مع الإصدارات الأحدث.

-v  اطبع رسائل حول الروابط القديمة التي تمت إزالتها والروابط الجديدة التي تم إنشاؤها. مبدئيًا، يسرد هذا الأمر كل دليل فقط أثناء معالجته.

-provider الاسم
-provider-path المسار
-provparam [الاسم:]المفتاح=القيمة
-propquery propq
    انظر "خيارات المزود" في openssl(1)، و provider(7)، و property(7).

البيئة

OPENSSL
    المسار إلى ملف تنفيذي لاستخدامه في توليد التجزئات والبصمات (انظر أعلاه).

PATH
    قائمة مسارات، مفصولة بنقطتين رأسيتين (أو فواصل منقوطة، على منصات ويندوز)، حيث يُبحث عن الملف التنفيذي openssl في حال لم يُقدم المسار إلى الملف التنفيذي لتوليد التجزئة في متغير البيئة OPENSSL أو لم يكن قابلاً للاستخدام (أي غير موجود أو غير قابل للتنفيذ).

SSL_CERT_DIR
    قائمة أدلة مفصولة بنقطتين رأسيتين للعمل عليها. يُتجاهل إذا كانت الأدلة مدرجة في سطر الأوامر.

انظر أيضًا
openssl(1), openssl-crl(1), openssl-x509(1)

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