التعريف¶

%الاسم المتن

%الاسم([الخيارات]) المتن

التوسيع¶

%الاسم

%الاسم [الخيارات] [المعطيات]

%{الاسم}

%{الاسم [الخيارات] المعطيات}

%{الاسم:المعطى}

%{?الاسم}

%{?الاسم:القيمة-إذا-عُرِّف}

%{!?الاسم:القيمة-إذا-لم-يُعرَّف}

%(أمر-الصدفة)

%[التعبير]

%[التعبير ? القيمة-إذا-صحيح : القيمة-إذا-خطأ]

%{lua:كود-lua}

توسيع الصدفة¶

يمكن إجراء توسيع الصدفة باستخدام %(أمر الصدفة). يُوسَّع أمر_الصدفة قبل تنفيذه باستخدام /bin/sh، والذي يصبح خرجه هو توسيع الماكرو. يُحذف السطر الجديد اللاحق.

مثال:

%(echo aa-bb-cc | tr '-' '.')

التوسيع المشروط¶

يدعم معالج الماكرو اختبار ما إذا كان الماكرو مُعرَّفاً أم لا.

%{?الاسم:القيمة}

%{!?الاسم:القيمة}

%{?الاسم}

لإجراء اختبارات أكثر تعقيداً، استخدم توسيع التعبير أو توسيع Lua. لاحظ أن %if و %ifarch وما شابهها ليست وحدات ماكرو، بل هي توجيهات ملف المواصفات (spec) ولا يمكن استخدامها إلا في ذلك السياق.

لاحظ أنه في RPM >= 4.17، تختبر الشروط في وحدات الماكرو المدمجة ببساطة وجود ذلك الماكرو المدمج، تماماً كما هو الحال مع أي وحدات ماكرو أخرى. في الإصدارات الأقدم، يكون سلوك الشروط على المدمجات غير محدد.

توسيع التعبير¶

يمكن إجراء توسيع التعبير باستخدام %[التعبير]. يتكون التعبير من حدود يمكن دمجها باستخدام العوامل.

يدعم RPM ثلاثة أنواع من الحدود:

• أرقام مكونة من خانات
• سلاسل نصية محاطة بعلامات اقتباس مزدوجة (مثل "سلسلة-نصية")
• إصدارات محاطة بعلامات اقتباس مزدوجة مسبوقة بـ v (مثل v"3:1.2-1")

سيقوم RPM بتوسيع وحدات الماكرو عند تقييم الحدود.

يمكنك استخدام العوامل القياسية لدمج الحدود:

• العوامل المنطقية &&، ||، !
• عوامل العلاقات !=، ==، <، >، <=، >=
• العوامل الحسابية +، -، /، *،
• العامل الثلاثي ? :
• الأقواس

على سبيل المثال، %[ 3 + 4 * (1 + %two) ] ستُوسَّع إلى 15 إذا كانت %two تُوسَّع إلى 2. تُقارن حدود الإصدار باستخدام خوارزمية مقارنة إصدارات RPM ([الحقبة:]الإصدار[-الإطلاق])، بدلاً من مقارنة السلاسل النصية العادية.

لاحظ أن توسيع %[التعبير] يختلف عن ماكرو %{expr:التعبير}. مع الأخير، تُوسَّع وحدات الماكرو في التعبير أولاً ثم يُقيَّم التعبير (دون إعادة توسيع الحدود). وبالتالي

rpm --define 'foo 1 + 2' --eval '%{expr:%foo}'

ستطبع 3. استخدام %[%foo] بدلاً من ذلك سيؤدي إلى خطأ مفاده أن "1 + 2" ليس رقماً.

إن إجراء توسيع الماكرو عند تقييم الحدود له ميزتان. أولاً، يسمح لـ RPM بإجراء معالجة الدائرة القصيرة الصحيحة عند تقييم العوامل المنطقية. ثانياً، لا تؤثر نتيجة التوسع على تحليل التعبير، مثلاً %["%file"] ستعمل حتى لو توسع ماكرو %file إلى سلسلة نصية تحتوي على علامة اقتباس مزدوجة.

أُضيف في: 4.16.0

توسيع Lua¶

أقوى طرق توسيع الماكرو هي استخدام مفسر Lua المضمن في RPM:

%{lua:كود-lua}

انظر rpm-lua(7) للتفاصيل.

وحدات الماكرو الآلية¶

بينما يتم توسيع ماكرو وسيطي، تتوفر وحدات الماكرو الآلية الشبيهة بالصدفة التالية:

إذا عُطّلت معالجة الخيارات المدمجة باستخدام - في حقل OPTIONS، فلن تتوفر سوى وحدات الماكرو الآلية التالية:

تُعرّف وحدات الماكرو الآلية وتُلغى آليًا عند الدخول إلى ماكرو وسائطي والخروج منه.

الوصول إلى الخيارات¶

داخل متن الماكرو الوسائطي، توجد عدة تراكيب تسمح باختبار وجود وسائط اختيارية. أبسط تركيب هو %{-f} الذي يتمدد (حرفيًا) إلى -f إذا ذُكر -f عند استدعاء الماكرو. توجد أيضًا أحكام لتضمين نص في حال وجود علم باستخدام %{-f:X}. يتمدد هذا الماكرو إلى (تمدد) X إذا كان العلم موجودًا. الصيغة المنفية، %{!-f:Y}، التي تتمدد إلى (تمدد) Y إذا لم يكن -f موجودًا، مدعومة أيضًا.

النطاق والرؤية¶

بشكل عام، تملك وحدات الماكرو نطاقًا عامًا، بغض النظر عن مكان وكيفية تعريفها. ومع ذلك، فإن وحدات الماكرو المعرفة داخل وحدات ماكرو وسائطية تملك نطاقًا غير عام كما يلي:

• وحدات الماكرو الآلية تملك نطاقًا محليًا، أي أنها مرئية فقط على مستوى استدعاء الماكرو نفسه
• وحدات الماكرو المحلية التي يُعرفها المستخدم تملك نطاقًا متداخلاً، أي أنها مرئية على مستوى استدعاء الماكرو نفسه وما دونه

بمعنى آخر، لا يمكن لماكرو وسائطي رؤية خيارات أو وسائط ماكرو آخر، لكن يمكن الوصول إلى ماكرو محلي عرّفه المستخدم في ماكرو مُستدعٍ داخل المُستدعَى (أو المُستدعَيْن).

لتعريف ماكرو عام داخل ماكرو وسائطي، يجب استخدام %global بدلاً من %define. لاحظ أيضًا أنه بما أن مثل هذا الماكرو قد يشير إلى وحدات ماكرو أخرى مرئية فقط في النطاق الحالي، فإن %global يُمدد متن الماكرو مرة واحدة عند وقت التعريف.

اتفاقية الاستدعاء¶

عند تمديد ماكرو وسائطي، تُستخدم اتفاقية الاستدعاء التالية:

1.

تُمدد أي وسائط للماكرو على مستوى استدعاء المُستدعَى

2.

تُعالج أي خيارات للماكرو

3.

تُعدّ وحدات الماكرو الآلية للخيارات والوسائط

4.

يُمدد متن الماكرو تكراريًا

5.

تُنبذ جميع وحدات الماكرو المعرفة على مستوى الاستدعاء هذا

التلاعب بالماكرو¶

تُستخدم أساسيات الماكرو للتلاعب بالماكرو في ملفات المواصفات ووحدات الماكرو الأخرى. لاحظ أن كل هذه العمليات تعمل على اسم الماكرو دون بادئة حرف %.

%define الاسم[([الخيارات])] المتن

%define mypath /usr/bin/mine

%global الاسم[([الخيارات])] المتن

%global snapver 0-0.48.20240616git

%undefine الاسم

%undefine mypath

%{load:الملف}

%{load:/some/dir/macros.foo}

تمدد الماكرو¶

%{expand:المتن}

%{expand:%{foo_prefix}%{foo_suffix}}

%{expr:التعبير}

%{expr:5*1024}

%{lua:كود-lua}

%{lua:for i=65,90 do print(string.char(i)) end}

%{macrobody:الاسم}

%{macrobody:_libdir}

عمليات السلاسل النصية¶

%dnl

%dnl هذا تعليق على سلوك %{mymacro}

%{gsub السلسلة, النمط, البديل [,N]}

%{gsub aabbaacc aa dd 1}

%{len:السلسلة}

%{len:9bf7da058a7c582878310e75be3d56a5a8b67f95}

%{lower:السلسلة}

%{lower:CamelCase}'

%{quote:السلسلة}

%myzip -x %{quote:empty spaces.zip}

%{rep السلسلة, N [,الفاصل]}

%{rep a 5}

%{reverse:السلسلة}

%{reverse:tac}

%{shescape:السلسلة}

%{shescape:foo's}

%{shrink:السلسلة}

%{shrink:aa  bb   ccc   }

%{span:السلسلة}

%{span:
	%شيء واحد
	%شيء آخر
}

%{sub STRING، I، [،J]}

*%{sub myfile.zip 3 6}*

%{upper:STRING}

%{upper:CamelCase}'

عمليات الملفات والمسارات¶

%{basename:PATH}

%{basename:/some/dir/file.suf}

%{dirname:PATH}

%{dirname:/some/dir/file.suf}

%{exists:PATH}

%{exists:%{builddir}/myflag.txt}

%{suffix:PATH}

%{suffix:myfile.zip}

%{url2path:URL}

%{url2path:http://rpm.org/not/there}

%{uncompress:PATH}

%{uncompress /my/source.tar.gz}

%{xdg:KIND}

%{xdg config}

معلومات البيئة¶

%getncpus

%{getncpus:KIND}

%{getncpus proc}

%getconfdir

%{getenv:NAME}

%{getenv:HOME}

%rpmversion

المخرجات¶

%{echo:STRING}

%{echo:Building with foo}

%{warn:STRING}

%{warning:Foo is deprecated}

%{error:STRING}

%{error:Invalid argument}

%verbose

%{verbose:STRING}

%{verbose:-x}

وحدات الماكرو الخاصة بملف المواصفات (spec)¶

%{S:NUMBER}

%{P:NUMBER}

التشخيصات¶

%trace

%dump

%__file_name

%__file_lineno

المثال 1. تعريف ماكرو بسيط¶

تعريف ماكرو mylib إلى مسار نسبي لماكرو %{_libdir} في ملف مواصفات:

%define mylib %{_libdir}/mine

المثال 2. تعريف ماكرو وسيطي¶

تعريف ماكرو وسيطي myhelper ينفذ البرنامج المحدد بواسطة %myprog مع معطاه الأول ويمرر الخيار --some-opt إليه دائماً، وبالإضافة إليه الخيار --xtra إذا تلقى الماكرو الخيار -x نفسه:

%define myhelper(x) %{myprog} --some-opt %{?-x:--xtra} %{1}

المثال 3. تعريف ماكرو يستخدم توسيع الصدفة¶

تعريف الماكرو %today الذي يتوسع إلى التاريخ الحالي بتنسيق YYMMDD عبر استدعاء أداة الصدفة date(1). لاحظ رمز % الثاني اللازم لهروب معطيات date(1):

%define today %(date +%%y%%m%%d)

المثال 4. تعريف ماكرو شرطياً¶

تعريف الماكرو mypath إذا لم يكن معرفاً مسبقاً:

%{!?mypath: %define mypath /some/where}

المثال 5. التوسع الشرطي¶

يتوسع إلى 1 إذا كان use_foo معرفاً، و 0 خلاف ذلك:

%{?use_foo:1}%{!?use_foo:0}

المثال 6. التعبيرات¶

حساب 5 * 1024:

%[5 * 1024]

توسيع إلى true أو false حرفيًا بناءً على شرط:

%[1 < 2 ? "true" : "false"]

مقارنة الإصدارات، مع التوسيع إلى 1 أو 0 عند الصحة/الخطأ:

%[ v"3.1.0-1" < v"1.0~alpha-2" ? 1 : 0]

يتوسع إلى 1 إذا توسع %aa إلى 5، وإلا فإنه يتوسع إلى 2:

%[ "%{aa}" == "5" ? 1 : 2]