.\" -*- coding: UTF-8 -*-
'\" t
.\"     Title: alpm-hooks
.\"    Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2026-05-06
.\"    Manual: Pacman Manual
.\"    Source: Pacman 7.1.0
.\"  Language: English
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ALPM\-HOOKS 5 "6 مايو 2026" "Pacman 7\&.1\&.0" "دليل Pacman"
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH الاسم
alpm\-hooks \- تنسيق ملف خطاطيف أل بي إم
.SH موجز
.sp
.nf
[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)
.fi
.SH الوصف
.sp
يوفر libalpm القدرة على تحديد خطافات لتشغيلها قبل المعاملات أو بعدها بناءً
على الحزم و/أو الملفات المعدلة\&. تتكون الخطافات من قسم \fI[Action]\fP واحد يصف
الإجراء المراد تشغيله وقسم \fI[Trigger]\fP واحد أو أكثر يصف المعاملات التي
ينبغي تشغيله لأجلها\&.
.sp
تُقرأ الخطافات من ملفات تقع في دليل خطافات النظام /usr/share/libalpm/hooks،
وأدلة مخصصة إضافية محددة في \fBpacman.conf\fP(5) (المبدئي هو
/etc/pacman\&.d/hooks)\&. يُشترط أن تنتهي أسماء الملفات باللاحقة
"\&.hook"\&. تُشغّل الخطافات بترتيب أبجدي حسب أسماء ملفاتها، حيث يتجاهل
الترتيب اللاحقة\&.
.SH المحفزات
.sp
يجب أن تحتوي الخطافات على قسم \fI[Trigger]\fP واحد على الأقل يحدد المعاملات
التي ستتسبب في تشغيل الخطاف\&. إذا عُرّفت أقسام ملقنات متعددة، فسيُشغّل
الخطاف إذا طابقت المعاملة \fBأيًّا\fP من الملقنات\&.
.PP
\fBOperation =\fP Install|Upgrade|Remove
.RS 4
اختر نوع العملية لمطابقة الأهداف معها\&. يمكن تحديده عدة مرات\&. تُعد
التثبيتات ترقيةً إذا كانت الحزمة أو الملف موجودًا بالفعل على النظام بغض
النظر عما إذا كان إصدار الحزمة الجديد أكبر فعليًّا من الإصدار المثبت
حاليًّا\&. بالنسبة لملقنات المسار (Path)، يصح هذا حتى لو تغيرت ملكية الملف
من حزمة إلى أخرى\&. مطلوب\&.
.RE
.PP
\fBType =\fP Path|Package
.RS 4
اختر ما إذا كانت الأهداف ستُطابق مع حزم المعاملة أم ملفاتها\&. انظر قسم
التحذيرات (CAVEATS) لملاحظات خاصة بشأن ملقنات المسار (Path)\&. يُعد \fIFile\fP
اسمًا بديلًا مهجورًا لـ \fIPath\fP وسيجري إزالته في إصدار مستقبلي\&. مطلوب\&.
.RE
.PP
\fBTarget =\fP <path|package>
.RS 4
المسار أو اسم الحزمة للمطابقة مع المعاملة النشطة\&. تشير المسارات إلى
الملفات في أرشيف الحزمة؛ وينبغي \fBعدم\fP إدراج جذر التثبيت في المسار\&. تسمح
الأنماط العامة (glob) بأسلوب الصدفة\&. يمكن عكس المطابقات بسبق الهدف بعلامة
تعجب\&. يمكن تحديده عدة مرات، بحيث تتخطى المطابقات اللاحقة ما
قبلها\&. مطلوب\&.
.RE
.SH الإجراءات
.PP
\fBDescription =\fP \&...
.RS 4
وصف اختياري يصف الإجراء الذي يتخذه الخطاف لاستخدامه في مخرجات الواجهة
الأمامية\&.
.RE
.PP
\fBExec =\fP <command>
.RS 4
الأمر المراد تشغيله\&. تُفصل وسائط الأمر عند المسافات البيضاء\&. ينبغي إحاطة
القيم التي تحتوي على مسافات بيضاء بعلامات اقتباس\&. مطلوب\&.
.RE
.PP
\fBWhen =\fP PreTransaction|PostTransaction
.RS 4
وقت تشغيل الخطاف\&. مطلوب\&.
.RE
.PP
\fBDepends =\fP <حزمة>
.RS 4
حزم يجب تثبيتها لتشغيل الخطاف\&. يمكن تحديدها عدة مرات\&.
.RE
.PP
\fBAbortOnFail\fP
.RS 4
يؤدي إلى إجهاض المعاملة إذا خرج الخطاف بقيمة غير صفرية\&. ينطبق فقط على
خطافات PreTransaction\&.
.RE
.PP
\fBNeedsTargets\fP
.RS 4
يؤدي إلى تمرير قائمة أهداف المشغل المطابقة إلى الخطاف الجاري على \fIstdin\fP\&.
.RE
.SH "تجاوز الخطافات"
.sp
يمكن تجاوز الخطافات بوضع ملف بنفس الاسم في دليل خطاف ذي أولوية أعلى\&. يمكن
تعطيل الخطافات بتجاوزها برابط رمزي إلى \fI/dev/null\fP\&.
.SH أمثلة
.sp
.if  n \{\
.RS 4
.\}
.nf
# فرض مزامنة الأقراص لتقليل خطر تلف البيانات

[Trigger]
Operation = Install
Operation = Upgrade
Operation = Remove
Type = Package
Target = *

[Action]
Depends = coreutils
When = PostTransaction
Exec = /usr/bin/sync
.fi
.if  n \{\
.RE
.\}
.SH تحذيرات
.sp
هناك حالات قد تعمل فيها مشغلات المسار بطرق غير متوقعة\&. يتم تشغيل الخطافات
باستخدام قائمة ملفات الحزمة المثبتة أو المحدثة أو المحذوفة\&. عند تثبيت أو
تحديث ملف يُستخرج بامتداد \fI\&.pacnew\fP، يُستخدم اسم الملف الأصلي في تشغيل
الخطاف\&. عند إزالة حزمة، يمكن لجميع الملفات المملوكة لتلك الحزمة تشغيل خطاف
سواء كانت موجودة فعليًا على نظام الملفات قبل إزالة الحزمة أم لا\&.
.sp
لن تعمل خطافات PostTransaction \fBإذا\fP فشلت المعاملة في الإكمال لأي سبب\&.
.sp
راجع موقع pacman الإلكتروني على https://archlinux\&.org/pacman/ للحصول على
معلومات حديثة حول pacman والأدوات المرتبطة به\&.
.SH العلل
.sp
علل؟ لا بد أنك تمزح؛ لا توجد علل في هذا البرنامج\&. ولكن إذا صدف وكنا
مخطئين، فيُرجى الإبلاغ عنها في متتبع المشكلات في
https://gitlab\&.archlinux\&.org/pacman/pacman/\-/issues مع معلومات محددة مثل
سطر الأوامر الخاص بك، وطبيعة العلة، وحتى قاعدة بيانات الحزمة إذا كان ذلك
يساعد\&.
.SH المؤلفون
.sp
المصينون الحاليون:
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
آلان مكراي <allan@archlinux\&.org>
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
أندرو غريغوري <andrew\&.gregory\&.8@gmail\&.com>
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Morgan Adamiec <morganamilo@archlinux\&.org>
.RE
.sp
المساهمون الرئيسون السابقون:
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Judd Vinet <jvinet@zeroflux\&.org>
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
أوريليان فوريه <aurelien@archlinux\&.org>
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
آرون غريفين <aaron@archlinux\&.org>
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
دان ماكغي <dan@archlinux\&.org>
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Xavier Chantry <shiningxc@gmail\&.com>
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu>
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ديف رايزنر <dreisner@archlinux\&.org>
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
إيلي شوارتز <eschwartz@archlinux\&.org>
.RE
.sp
للمساهمين الإضافيين، استخدم git shortlog \-s على مستودع pacman\&.git\&.
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .