الاسم¶

alpm-hooks - تنسيق ملف خطاطيف أل بي إم

موجز¶

[Trigger] (Required, Repeatable)
Operation = Install|Upgrade|Remove (Required, Repeatable)
Type = Path|Package (Required)
Target = <Path|PkgName> (Required, Repeatable)
[Action] (Required)
Description = ... (Optional)
When = PreTransaction|PostTransaction (Required)
Exec = <Command> (Required)
Depends = <PkgName> (Optional)
AbortOnFail (Optional, PreTransaction only)
NeedsTargets (Optional)

الوصف¶

يوفر libalpm القدرة على تحديد خطافات لتشغيلها قبل المعاملات أو بعدها بناءً على الحزم و/أو الملفات المعدلة. تتكون الخطافات من قسم [Action] واحد يصف الإجراء المراد تشغيله وقسم [Trigger] واحد أو أكثر يصف المعاملات التي ينبغي تشغيله لأجلها.

تُقرأ الخطافات من ملفات تقع في دليل خطافات النظام /usr/share/libalpm/hooks، وأدلة مخصصة إضافية محددة في pacman.conf(5) (المبدئي هو /etc/pacman.d/hooks). يُشترط أن تنتهي أسماء الملفات باللاحقة ".hook". تُشغّل الخطافات بترتيب أبجدي حسب أسماء ملفاتها، حيث يتجاهل الترتيب اللاحقة.

المحفزات¶

يجب أن تحتوي الخطافات على قسم [Trigger] واحد على الأقل يحدد المعاملات التي ستتسبب في تشغيل الخطاف. إذا عُرّفت أقسام ملقنات متعددة، فسيُشغّل الخطاف إذا طابقت المعاملة أيًّا من الملقنات.

Operation = Install|Upgrade|Remove

Type = Path|Package

Target = <path|package>

الإجراءات¶

Description = ...

Exec = <command>

When = PreTransaction|PostTransaction

Depends = <حزمة>

AbortOnFail

NeedsTargets

تجاوز الخطافات¶

يمكن تجاوز الخطافات بوضع ملف بنفس الاسم في دليل خطاف ذي أولوية أعلى. يمكن تعطيل الخطافات بتجاوزها برابط رمزي إلى /dev/null.

أمثلة¶

# فرض مزامنة الأقراص لتقليل خطر تلف البيانات
[Trigger]
Operation = Install
Operation = Upgrade
Operation = Remove
Type = Package
Target = *
[Action]
Depends = coreutils
When = PostTransaction
Exec = /usr/bin/sync

تحذيرات¶

هناك حالات قد تعمل فيها مشغلات المسار بطرق غير متوقعة. يتم تشغيل الخطافات باستخدام قائمة ملفات الحزمة المثبتة أو المحدثة أو المحذوفة. عند تثبيت أو تحديث ملف يُستخرج بامتداد .pacnew، يُستخدم اسم الملف الأصلي في تشغيل الخطاف. عند إزالة حزمة، يمكن لجميع الملفات المملوكة لتلك الحزمة تشغيل خطاف سواء كانت موجودة فعليًا على نظام الملفات قبل إزالة الحزمة أم لا.

لن تعمل خطافات PostTransaction إذا فشلت المعاملة في الإكمال لأي سبب.

راجع موقع pacman الإلكتروني على https://archlinux.org/pacman/ للحصول على معلومات حديثة حول pacman والأدوات المرتبطة به.

العلل¶

علل؟ لا بد أنك تمزح؛ لا توجد علل في هذا البرنامج. ولكن إذا صدف وكنا مخطئين، فيُرجى الإبلاغ عنها في متتبع المشكلات في https://gitlab.archlinux.org/pacman/pacman/-/issues مع معلومات محددة مثل سطر الأوامر الخاص بك، وطبيعة العلة، وحتى قاعدة بيانات الحزمة إذا كان ذلك يساعد.

المؤلفون¶

المصينون الحاليون:

المساهمون الرئيسون السابقون:

للمساهمين الإضافيين، استخدم git shortlog -s على مستودع pacman.git.

ترجمة¶

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

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

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