Definirea¶

%NUME CORP

%NUME([OPȚIUNI]) CORP

Expandarea¶

%NUME

%NUME [OPȚIUNI] [ARGUMENTE]

%{NUME}

%{NUME [OPȚIUNI] ARGUMENTE}

%{NUME:ARGUMENT}

%{?NUME}

%{?NUME:VALOARE-DACĂ-DEFINITĂ}

%{!?NUME:VALOARE-DACĂ-NU_ ESTE-DEFINITĂ}

%(COMANDĂ-SHELL)

%[EXPRESIE]

%[EXPRESIE ? VALOARE-DACĂ-ADEVĂRAT : VALOARE-DACĂ-FALS]

%{lua:COD-LUA}

Expansiune shell¶

Extinderea shell-ului poate fi efectuată folosind %(comanda shell). comanda_shell este extinsă înainte de a fi executată cu /bin/sh, a cărei ieșire devine extinderea macrocomenzii. Caracterul de linie nouă de la sfârșit este șters.

Exemplu:

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

Extindere condițională¶

Procesorul de macrocomenzi acceptă testarea dacă o macrocomandă este definită sau nu.

%{?NUME:VALOARE}

%{!?NUME:VALOARE}

%{?NUME}

Pentru teste mai complexe, utilizați Expansiune expresie sau Expansiune Lua. Rețineți că %if, %ifarch și altele similare nu sunt macrocomenzi, ci directive spec și pot fi utilizate numai în acel context.

Rețineți că în RPM >= 4.17, condițiile din macrocomenzile încorporate verifică pur și simplu existența acelei macrocomenzi încorporate, la fel ca în cazul oricărei alte macrocomenzi. În versiunile mai vechi, comportamentul condițiilor din macrocomenzile încorporate este nedefinit.

Expansiune expresie¶

Extinderea expresiei poate fi efectuată utilizând %[EXPRESIE]. O expresie este formată din termeni care pot fi combinați utilizând operatori.

RPM acceptă trei tipuri de termeni:

• numere formate din cifre
• șiruri de caractere între ghilimele duble (de exemplu, "vreun -șir")
• versiuni între ghilimele duble precedate de v (de exemplu, v"3:1.2-1")

RPM va extinde macrocomenzile atunci când evaluează termenii.

Puteți utiliza operatorii standard pentru a combina termenii:

• operatori logici &&, ||, !
• operatori relaționali !=, ==, <, >, <=, >=
• operatori aritmetici +, -, /, *,
• operatorul ternar ? :
• paranteze

De exemplu, %[ 3 + 4 * (1 + %two) ] se va extinde la 15 dacă %two se extinde la 2. Termenii versiunii sunt comparați folosind algoritmul de comparare a versiunii RPM ([epoch:]version[-release]), și nu prin compararea obișnuită a șirurilor de caractere.

Rețineți că expansiunea %[EXPRESIE] este diferită de macrocomanda %{expr:EXPRESIE}. În cazul celei din urmă, macrocomenzile din expresie sunt mai întâi expandate, iar apoi expresia este evaluată (fără a reexpanda termenii). Astfel

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

va afișa 3. Utilizarea %[%foo] va genera eroarea "1 + 2" nu este un număr.

Efectuarea expansiunii macrocomenzii în timpul evaluării termenilor are două avantaje. În primul rând, permite RPM să efectueze o procesare corectă a scurtcircuitelor în timpul evaluării operatorilor logici. În al doilea rând, rezultatul expansiunii nu influențează analizarea expresiei, de exemplu %[„%file”] va funcționa chiar și dacă macrocomanda %file se extinde la un șir care conține ghilimele duble.

Adăugată: 4.16.0

Expansiune Lua¶

Cea mai puternică dintre metodele de expansiune a macrocomenzilor este utilizarea interpretului Lua încorporat în RPM:

%{lua:COD-LUA}

Pentru detalii, consultați rpm-lua(7).

Macrocomenzi automate¶

În timpul extinderii unei macrocomenzi parametrizate, sunt disponibile următoarele macrocomenzi automate de tip shell:

Dacă procesarea opțiunilor încorporate a fost dezactivată cu - ca câmp OPȚIUNI , sunt disponibile numai următoarele macrocomenzi automate:

Macrocomenzile automate sunt definite și redefinite automat la intrarea și ieșirea din macrocomanda parametrică.

Accesarea opțiunilor¶

În cadrul unei macrocomenzi parametrice, există mai multe construcții care permit testarea prezenței parametrilor opționali. Cea mai simplă construcție este %{-f} care se extinde (literalmente) la -f dacă -f a fost menționat atunci când macrocomanda a fost invocată. Există, de asemenea, prevederi pentru includerea textului dacă era prezent un fanion folosind %{-f:X}. Această macrocomandă se extinde la (extinderea lui) X dacă fanionul era prezent. Forma negativă, %{!-f:Y}, care se extinde la (extinderea lui) Y dacă -f nu era prezent, este de asemenea acceptată.

Domeniul de aplicare și vizibilitatea¶

În general, macrocomenzile au o aplicabilitate globală, indiferent de locul și modul în care au fost definite. Cu toate acestea, macrocomenzile definite în cadrul macrocomenzilor parametrice au o aplicabilitate non-globală, după cum urmează:

• macrocomenzile automate au domeniu de aplicare local, adică sunt vizibile numai la nivelul apelului macrocomenzii respective
• macrocomenzile locale definite de utilizator au un domeniu de aplicare imbricat, adică sunt vizibile la nivelul apelului macrocomenzii în sine și la niveluri mai profunde.

Adică, o macrocomandă parametrică nu poate vedea opțiunile sau argumentele altei macrocomenzi, dar o macrocomandă locală definită de utilizator într-o macrocomandă de apel poate fi accesată în macrocomanda (macrocomenzile) apelată (apelate).

Pentru a defini o macrocomandă globală în interiorul unei macrocomenzi parametrice, trebuie să utilizați %global în loc de %define. De asemenea, rețineți că, deoarece o astfel de macrocomandă poate face referire la alte macrocomenzi vizibile numai în domeniul curent, %global extinde corpul macrocomenzii o singură dată în momentul definirii.

Convenția de apelare¶

Când o macrocomandă parametrică este extinsă, se utilizează următoarea convenție de apelare:

1.

orice argumente ale macrocomenzii sunt extinse la nivelul apelului destinatarului apelului

2.

orice opțiuni pentru macrocomandă sunt procesate

3.

macrocomenzile automate sunt configurate pentru opțiuni și argumente

4.

corpul macrocomenzii este extins recursiv

5.

toate macrocomenzile definite la acest nivel de apel sunt eliminate

Manipularea macrocomenzilor¶

Macrocomenzile primitive sunt utilizate pentru manipularea macrocomenzilor în fișierele spec și în alte macrocomenzi. Rețineți că toate acestea funcționează pe numele macrocomenzii fără caracterul % precedent.

%define NUME[([OPȚIUNI])] CORP

%define ruta-mea /usr/bin/mine

%global NUME[([OPȚIUNI])] CORP

%global snapver 0-0.48.20240616git

%undefine NUME

%undefine ruta-mea

%{load:FIȘIER}

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

Extinderea macrocomenzii¶

%{expand:CORP}

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

%{expr:EXPRESIE}

%{expr:5*1024}

%{lua:COD-LUA}

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

%{macrobody:NUME}

%{macrobody:_libdir}

Operații cu șiruri de caractere¶

%dnl

%dnl Acesta este un comentariu privind comportamentul %{mymacro}

%{gsub ȘIR, MODEL, ÎNLOCUIRE [,N]}

%{gsub aabbaacc aa dd 1}

%{len:ȘIR}

%{len:9bf7da058a7c582878310e75be3d56a5a8b67f95}

%{lower:ȘIR}

%{lower:CamelCase}'

%{quote:Șir}

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

%{rep ȘIR, N [,SEP]}

%{rep a 5}

%{reverse:ȘIR}

%{reverse:tac}

%{shescape:ȘIR}

%{shescape:foo's}

%{shrink:ȘIR}

%{shrink:aa  bb   ccc   }

%{span:ȘIR}

%{span:
	%un lucru
	%un alt lucru
}

%{sub ȘIR, I, [,J]}

*%{sub fișierul-meu.zip 3 6}*

%{upper:ȘIR}

%{upper:CamelCase}'

Operații cu fișiere și rute¶

%{basename:RUTA}

%{nume-bazăe:/vreun/dir/fișier.suf}

%{dirname:RUTA}

%{dirname:/vreun/dir/fișier.suf}

%{exists:RUTA}

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

%{suffix:RUTA}

%{suffix:fișierul-meu.zip}

%{url2path:URL}

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

%{uncompress:RUTA}

%{uncompress /sursa/mea.tar.gz}

%{xdg:TIP}

%{xdg config}

Informații despre mediu¶

%getncpus

%{getncpus:TIP}

%{getncpus proc}

%getconfdir

%{getenv:NUME}

%{getenv:HOME}

%rpmversion

Ieșire¶

%{echo:ȘIR}

%{echo:Construirea cu foo}

%{warn:ȘIR}

%{warning:Foo este depreciat}

%{error:ȘIR}

%{error:Argument nevalid}

%verbose

%{verbose:ȘIR}

%{verbose:-x}

Macrocomenzi specifice spec¶

%{S:NUMĂR}

%{P:NUMĂR}

Diagnosticare¶

%trace

%dump

%__nume_fișier

%__fișier_nr.linie

Exemplul 1. Definiți o macrocomandă simplă¶

Definiți macrocomanda mylib ca o rută relativă la macrocomanda %{_libdir} într-un fișier spec:

%define mylib %{_libdir}/mine

Exemplul 2. Definiți o macrocomandă parametrică¶

Definiți macrocomanda parametrică myhelper care execută programul specificat de %myprog cu primul argument al acestuia și trecând întotdeauna opțiunea --some-opt către acesta, precum și opțiunea --xtra dacă a primit opțiunea -x:

%define myhelper(x) %{myprog} --vreo-opțiune %{?-x:--xtra} %{1}

Exemplul 3. Definiți o macrocomandă utilizând expansiunea shell-ului¶

Definiți macrocomanda %today care se extinde la data curentă în formatul AALLZZ apelând ustensila shell date(1). Rețineți că este necesară a doua macrocomandă % pentru a eluda argumentele către date(1):

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

Exemplul 4. Definiți o macrocomandă condițională¶

Definiți macrocomanda mypath dacă nu a fost definită anterior:

%{!?mypath: %define mypath /vreun/loc}

Exemplul 5. Expansiune conditională¶

Expandează la 1 dacă use_foo este definit și 0 în caz contrar:

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

Exemplul 6. Expresii¶

Calculează 5 * 1024:

%[5 * 1024]

Extinde la literalul true sau false în funcție de o condiție:

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

Compară versiunile, extinzând la 1 sau 0 pentru true/false:

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

Expandează la 1 dacă %aa se extinde la 5, altfel se extinde la 2:

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