الاسم

namcap - أداة تحليل الحزم

موجز

namcap [خيارات] <حزمة|PKGBUILD> [حزمة|PKGBUILD] ...

الوصف

namcap هي أداة تحليل حزم تبحث عن مشاكل في حزم آرتش لينكس أو ملفات PKGBUILD الخاصة بها. يمكنها تطبيق قواعد على قائمة الملفات، أو الملفات نفسها، أو ملفات PKGBUILD فردية.

ترجع القواعد قوائم من الرسائل. يمكن أن تكون كل رسالة من ثلاثة أنواع: خطأ، تحذير، أو معلومات (اعتبرهم ملاحظات أو تعليقات). الأخطاء (المشار إليها بـ 'E:') هي أشياء يتأكد namcap بشدة أنها خاطئة وتحتاج إلى إصلاح. التحذيرات (المشار إليها بـ 'W:') هي أشياء يعتقد namcap أنه يجب تغييرها ولكن إذا كنت تعرف ما تفعله فيمكنك تركها. المعلومات (المشار إليها بـ 'I:') تُظهر فقط عند استخدام وسيط المعلومات. رسائل المعلومات تعطي معلومات قد تكون مفيدة ولكنها ليست شيئًا يحتاج إلى تغيير.

الخيارات

-e قائمة_قواعد, --exclude=قائمة_قواعد: لا تشغل قواعد قائمة_قواعد على الحزمة
-i، --info: اعرض رسائل المعلومات
-L, --list: أرجع قائمة بالقواعد الصالحة وأوصافها
-m, --machine-readable: اعرض وسوم namcap سهلة التحليل بدلاً من الوصف العادي المقروء للإنسان؛ على سبيل المثال استخدام non-fhs-man-page بدلاً من "تم العثور على صفحة دليل غير FHS (%s). استخدم /usr/share/man بدلاً من ذلك". يمكن العثور على قائمة كاملة بوسوم namcap مع أوصافها المقروءة للإنسان في /usr/share/namcap/tags.
-r قائمة_قواعد, --rules=قائمة_قواعد: طبق فقط قواعد قائمة_قواعد على الحزمة

: قائمة_قواعد هي قائمة بأسماء القواعد مفصولة بفواصل

-v, --version: اطبع الإصدار واخرج

قواعد

مصفوفات: يتحقق من أن متغيرات المصفوفة هي بالفعل مصفوفات وليست سلاسل نصية
نسخ_احتياطية_سيئة: يتحقق من أن إدخالات النسخ الاحتياطي لا تبدأ بـ /
معمارية: يبحث عن مراجع لـ i686 و i586 ويخبرك باستخدام $CARCH بدلاً من ذلك
أسماء_كبيرة: يفحص PKGBUILD للتحقق من أن اسم الحزمة لا يحتوي على أحرف كبيرة
أسماء_كبيرة_حزمة: يفحص حزمة للتحقق من أن اسم الحزمة لا يحتوي على أحرف كبيرة
مجاميع_اختبارية: يتأكد من أن PKGBUILD يتضمن مجاميع اختبارية صالحة
يعتمد_على: تشغل هذه الوحدة ldd على جميع الملفات التنفيذية، وتحصل على التبعيات على مستوى الربط، وتجد أصغر مجموعة فرعية من التبعيات تغطي التبعيات على مستوى الربط، وتقارن تلك القائمة بتبعيات الحزمة. تُرجع رسائل في ثلاث حالات: تبعية مكتشفة وغير مضمنة، تبعية مضمنة ولكنها مستوفاة بالفعل، وتبعية مضمنة وغير ضرورية. هذه الاقتراحات هي مجرد إرشادات ويجب على جميع بناة الحزم أخذها في الاعتبار (أي أنت أذكى من namcap).
بعض الحالات التي يفشل فيها namcap هي dlopen() والروابط الغامضة. لا تظهر المكتبات المحملة عبر dlopen() لأنها تُحمّل في وقت التشغيل: في حالة برنامج يُحمّل الإضافات. الروابط الغامضة هي الحالات التي يحتاج فيها جزء صغير فقط من الحزمة إلى شيء ليعمل؛ عادةً، لن يُصل إلى ذلك الجزء الصغير إلا إذا كان ذلك الشيء مثبتًا (مثل إضافة جافا لمتصفح موزيلا المضمنة في حزمة جافا).
directoryname: يتحقق من أسماء الدلائل في قائمة ملفات الحزمة للدلائل القياسية (أي /etc، /usr/bin، /usr/lib). تُرجع جميع الملفات في الدلائل غير القياسية.
elffiles: يُعطي خطأ إذا وجد ملفات ELF (ثنائية) خارج المسارات القياسية (/bin، /usr/bin، إلخ).
emptydir: يبحث عن دلائل في حزمة لا تحتوي على أي ملفات.
extravars: يتحقق من أن المتغيرات الإضافية تبدأ بشرطة سفلية.
fhsinfopages: يتحقق من التثبيت الصحيح لصفحات المعلومات.
fhsmanpages: يتحقق من التثبيت الصحيح لصفحات الدليل.
fileownership: يتحقق من أن جميع الملفات مملوكة لـ root:root وليس لمستخدم أو مجموعة أخرى.
gnomemime: يتحقق من وجود ملفات MIME الخاصة بـ GNOME المولدة.
hicoloricons: يتحقق مما إذا كانت خبيئة أيقونات hicolor تُحدّث عندما تُثبّت حزمة ملفات في /usr/share/icons/hicolor.
infodirectory: يتحقق من أن الحزمة لا تحتوي على ملف دليل المعلومات (/usr/share/info/dir).
invalidstartdir: أي ملفات PKGBUILD تشير إلى ملفات في $startdir غير صحيحة.
libtool: يحذر إذا كانت ملفات libtool (*.la) موجودة.
license: يتحقق من أن متغير التراخيص قد مُلئ في ملف PKGBUILD.
licensepkg: يتحقق من أن متغير التراخيص قد مُلئ في حزمة. بالنسبة للحزم ذات الترخيص المخصص، يتحقق مما إذا كان ملف الترخيص قد ثُبّت في /usr/share/licenses/$pkgname/.
perllocal: يبحث عن perllocal.pod. perllocal.pod هو ملف مزعج يُضمّن أثناء معظم تثبيتات وحدات perl
permissions: يتحقق من صلاحيات الملفات والدلائل الأساسية. يُرجع تحذيرات حول عدم تعيين بتات القراءة للجميع، وتعيين بتات الكتابة للجميع، وعدم تعيين بتات التنفيذ للجميع للدلائل
rpath: يُصدر خطأ إذا كان لملف ثنائي RPATH مضبوط على قيمة غير /usr/lib
runpath: يُصدر خطأ إذا كان لملف ثنائي RUNPATH مضبوط على قيمة غير /usr/lib أو /usr/lib32
scrollkeeper: يتحقق من عدم وجود أي أدلة scrollkeeper
sfurl: يحذر إذا كان PKGBUILD يُنزّل من مرآة sourceforge محددة بدلاً من downloads.sourceforge.net العام
symlink: يكتشف الروابط الرمزية والصلبة التي لا تشير إلى مسار صالح في الحزمة
tags: لمسؤولي الحزم، تتحقق هذه الوحدة من تذكرنا إضافة تعليق الصيانة والمساهمة.
url: يتحقق من تعيين متغير url في PKGBUILD
urlpkg: يتحقق من تعيين متغير url في ملف الحزمة

أمثلة

namcap foo.pkg.tar.gz: تطبيق جميع القواعد على foo.pkg.tar.gz
namcap -r depends,symlink foo.pkg.tar.gz: تطبيق قاعدتي depends وsymlink على foo.pkg.tar.gz
namcap PKGBUILD: تطبيق جميع القواعد المستندة إلى PKGBUILD على الملف PKGBUILD
namcap --list: سرد جميع القواعد المتاحة

حقوق النسخ

هذا برنامج حر؛ انظر المصدر لشروط النسخ. لا يوجد أي ضمان؛ ولا حتى ضمان قابلية التسويق أو الملاءمة لغرض معين.

ترجمة

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.