Definieren¶

%NAME TEXTKÖRPER

%NAME([OPTIONEN]) TEXTKÖRPER

Expandieren¶

%NAME

%NAME [OPTIONEN] [ARGUMENTE]

%{NAME}

%{NAME [OPTIONEN] ARGUMENTE}

%{NAME:ARGUMENT}

%{?NAME}

%{?NAME:WERT-FALLS-DEFINIERT}

%{!?NAME:WERT-FALLS-NICHT-DEFINIERT}

%(SHELL-BEFEHL)

%[AUSDRUCK]

%[AUSDRUCK ? WERT-FALLS-WAHR : WERT-FALLS-FALSCH]

%{lua:LUA-CODE}

Shell-Expansion¶

Die Shell-Expansion kann mit %(Shell-Befehl) durchgeführt werden. Der Shell_Befehl wird expandiert, bevor er mit /bin/sh ausgeführt wird, dessen Ausgabe die Expansion des Makros darstellt. Der abschließende Zeilenumbruch wird gelöscht.

Beispiel:

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

Bedingte Expansion¶

Der Makroprozessor unterstützt das Testen, ob ein Makro definiert ist oder nicht.

%{?NAME:WERT}

%{!?NAME:WERT}

%{?NAME}

Für komplexere Tests verwenden Sie die Expansion von Ausdrücken oder die Lua-Expansion. Beachten Sie, dass %if, %ifarch und ähnliche keine Makros, sondern Spec-Datei-Direktiven und nur in diesem Kontext verwendbar sind.

Beachten Sie, dass in RPM >= 4.17 Bedingungen für integrierte Makros lediglich die Existenz des integrierten Makros prüfen, genau wie bei allen anderen Makros. In älteren Versionen ist das Verhalten von Bedingungen für integrierte Makros undefiniert.

Expansion von Ausdrücken¶

Ausdrücke können in der Form %[AUSDRUCK] expandiert werden. Ein Ausdruck besteht aus Termen, die mittels Operatoren kombiniert werden können.

RPM unterstützt drei Arten von Termen:

• Zahlen, bestehend aus Ziffern
• in hochgestellte doppelte Anführungszeichen eingeschlossene Zeichenketten (z.B. "Zeichenkette")
• in hochgestellte doppelte Anführungszeichen eingeschlossene Versionen, denen ein v vorangestellt ist (z.B. v"3:1.2-1")

RPM expandiert Makros, wenn Terme ausgewertet werden.

Sie können die Standard-Operatoren verwenden, um Terme zu verknüpfen:

• die logischen Operatoren &&, ||, !
• die relationalen Operatoren !=, ==, <, >, <=, >=
• die arithmetischen Operatoren +, -, /, *,
• den ternären Operator ? :
• Klammern

Beispielsweise wird %[ 3 + 4 * (1 + %two) ] zu 15 expandiert, wenn %two zu 2 expandiert wird. Versionsterme werden mit dem RPM-Versionsvergleichsalgorithmus ([Epoche:]Version[-Veröffentlichung]) verglichen, nicht mit einem regulären Zeichenkettenvergleich.

Beachten Sie, dass sich die Expansion der Form %[AUSDRUCK] vom Makro %{expr:AUSDRUCK} unterscheidet. Bei Letzterem werden zuerst die Makros im Ausdruck expandiert und dann der Ausdruck ausgewertet (ohne die Terme erneut zu expandieren). Somit wird

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

3 ausgeben. Wenn Sie stattdessen %[%bla] verwenden, wird eine Fehlermeldung ausgegeben, dass »1 + 2« keine Zahl ist.

Die Makroexpansion bei der Auswertung der Terme durchzuführen hat zwei Vorteile. Erstens ermöglicht sie RPM eine korrekte verkürzte Verarbeitung bei der Auswertung von logischen Operatoren. Zweitens beeinflusst das Expansionsergebnis nicht die Auswertung von Ausdrücken. Beispielsweise funktioniert %["%file"] selbst dann, wenn das Makro %file zu einer Zeichenkette mit doppelten englischen Anführungszeichen expandiert wird.

Hinzugefügt: 4.16.0

Lua-Expansion¶

Die leistungsstärkste Methode zur Makroexpansion ist die Verwendung des in RPM eingebetteten Lua-Interpreters:

%{lua:LUA-CODE}

Weitere Details finden Sie in rpm-lua(7).

Automatische Makros¶

Während ein parametrisiertes Makro expandiert wird, stehen die folgenden Shell-ähnlichen automatischen Makros zur Verfügung:

Wenn die integrierte Optionsverarbeitung mit - als OPTIONEN-Feld deaktiviert wurde, sind nur die folgenden automatischen Makros verfügbar:

Automatische Makros werden beim Ein- und Ausstieg aus parametrischen Makros automatisch definiert und undefiniert.

Zugriff auf Optionen¶

Im Textkörper eines parametrischen Makros gibt es mehrere Konstrukte, die das Testen auf das Vorhandensein optionaler Parameter ermöglichen. Das einfachste Konstrukt ist %{-f}, das (wörtlich) zu -f expandiert wird, wenn -f beim Aufruf des Makros übergeben wurde. Es gibt auch Möglichkeiten, Text einzufügen, wenn ein Schalter vorhanden ist, indem %{-f:X} verwendet wird. Dieses Makro expandiert zu (der Expansion von) X, wenn der Schalter vorhanden war. Die negierte Form %{!-f:Y}, die zu (der Expansion von) Y expandiert, wenn -f nicht vorhanden war, wird ebenfalls unterstützt.

Bereich und Sichtbarkeit¶

Im Allgemeinen haben Makros einen globalen Gültigkeitsbereich, unabhängig davon, wo und wie sie definiert wurden. Makros, die innerhalb parametrischer Makros definiert sind, haben jedoch einen nicht-globalen Gültigkeitsbereich, und zwar wie folgt:

• Automatische Makros haben einen lokalen Gültigkeitsbereich, das heißt, sie sind nur auf der Aufrufebene des Makros selbst sichtbar.
• Benutzerdefinierte lokale Makros haben einen verschachtelten Gültigkeitsbereich, das heißt, sie sind auf der Aufrufebene des Makros selbst und tiefer sichtbar.

Das heißt, ein parametrisches Makro kann die Optionen oder Argumente eines anderen nicht sehen, aber auf ein benutzerdefiniertes lokales Makro in einem aufrufenden Makro kann in den aufgerufenen Makros zugegriffen werden.

Um ein globales Makro innerhalb eines parametrischen Makros zu definieren, müssen Sie %global anstelle von %define verwenden. Beachten Sie außerdem, dass %global den Makrokörper zum Zeitpunkt der Definition einmal expandiert, da ein solches Makro möglicherweise auf andere Makros verweist, die nur im aktuellen Bereich sichtbar sind.

Aufrufkonvention¶

Beim Expandieren eines parametrischen Makros wird die folgende Aufrufkonvention verwendet:

1.

alle Argumente des Makros werden auf der Aufrufebene des Aufrufenden expandiert

2.

alle Optionen des Makros werden verarbeitet

3.

automatische Makros werden für die Optionen und die Argumente eingerichtet

4.

der Makrokörper wird rekursiv expandiert

5.

alle auf dieser Aufrufebene definierten Makros werden verworfen

Manipulation von Makros¶

Die Makroprimitive werden zur Makromanipulation in Spec-Dateien und anderen Makros verwendet. Beachten Sie, dass alle diese auf dem Makronamen ohne das vorangehende %-Zeichen arbeiten.

%define NAME[([OPTIONEN])] TEXTKÖRPER

%define meinpfad /usr/bin/mein

%global NAME[([OPTIONEN])] TEXTKÖRPER

%global snapver 0-0.48.20240616git

%undefine NAME

%undefine mein_Pfad

%{load:DATEI}

%{load:/irgendein/verzeichnis/makros.foo}

Makro-Expansion¶

%{expand:TEXTKÖRPER}

%{expand:%{foo_präfix}%{foo_suffix}}

%{expr:AUSDRUCK}

%{expr:5*1024}

%{lua:LUA-CODE}

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

%{macrobody:NAME}

%{macrobody:_libdir}

Zeichenkettenaktionen¶

%dnl

%dnl Dies ist ein Kommentar zum Verhalten von %{mymacro}

%{gsub ZEICHENKETTE, MUSTER, ERSETZUNG [,N]}

%{gsub aabbaacc aa dd 1}

%{len:ZEICHENKETTE}

%{len:9bf7da058a7c582878310e75be3d56a5a8b67f95}

%{lower:ZEICHENKETTE}

%{lower:CamelCase}'

%{quote:ZEICHENKETTE}

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

%{rep ZEICHENKETTE, N [,TRENNER]}

%{rep a 5}

%{reverse:ZEICHENKETTE}

%{reverse:tac}

%{shescape:ZEICHENKETTE}

%{shescape:foo's}

%{shrink:ZEICHENKETTE}

%{shrink:aa  bb   ccc   }

%{span:ZEICHENKETTE}

%{span:
	%one thing
	%another thing
}

%{sub ZEICHENKETTE, I, [,J]}

*%{sub meinedatei.zip 3 6}*

%{upper:ZEICHENKETTE}

%{upper:CamelCase}'

Datei- und Pfadaktionen¶

%{basename:PFAD}

%{basename:/ein/verzeichnis/datei.endung}

%{dirname:PFAD}

%{dirname:/ein/verzeichnis/datei.endung}

%{exists:PFAD}

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

%{suffix:PFAD}

%{suffix:meinedatei.zip}

%{url2path:URL}

%{url2path:http://rpm.org/nicht/dort}

%{uncompress:PFAD}

%{uncompress /meine/quelldatei.tar.gz}

%{xdg:ART}

%{xdg config}

Infos zur Umgebung¶

%getncpus

%{getncpus:ART}

%{getncpus proc}

%getconfdir

%{getenv:NAME}

%{getenv:HOME}

%rpmversion

Ausgabe¶

%{echo:ZEICHENKETTE}

%{echo:Building with foo}

%{warn:ZEICHENKETTE}

%{warning:Foo is deprecated}

%{error:ZEICHENKETTE}

%{error:Invalid argument}

%verbose

%{verbose:ZEICHENKETTE}

%{verbose:-x}

Spec-spezifische Makros¶

%{S:NUMMER}

%{P:NUMMER}

Diagnostik¶

%trace

%dump

%__file_name

%__file_lineno

Beispiel 1: Definieren eines einfachen Makros¶

Das Makro mylib in einer Spec-Datei auf einen Pfad relativ zum %{_libdir}-Makro setzen:

%define mylib %{_libdir}/mein

Beispiel 2: Ein parametrisches Makro definieren¶

Das parametrische Makro myhelper definieren, das das durch %myprog angegebene Programm mit seinem ersten Argument ausführt und ihm immer die Option --some-opt übergibt, sowie zusätzlich die Option --xtra, wenn es selbst die Option -x erhalten hat:

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

Beispiel 3: Ein Makro mittels Shell-Expansion definieren¶

Definieren des Makros %today, das mithilfe des Shell-Dienstprogramms date(1) zum aktuellen Datum im Format JJMMTT expandiert. Beachten Sie das zweite %, das zum Maskieren der Argumente für date(1) benötigt wird:

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

Beispiel 4: Ein bedingtes Makro definieren¶

Das Makro mypath definieren, sofern es nicht bereits zuvor definiert wurde:

%{!?mypath: %define mypath /ir/gend/wo}

Beispiel 5: Bedingte Expansion¶

Expandiert zu 1, falls use_foo definiert ist, anderenfalls zu 0:

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

Beispiel 6 – Ausdrücke¶

5 * 1024 berechnen:

%[5 * 1024]

Zu wörtlichem true oder false expandieren, abhängig von einer Bedingung:

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

Versionen vergleichen; zu 1 (wahr) oder 0 (falsch) expandieren:

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

Zu 1 expandieren, falls %aa zu 5 expandiert, anderenfalls zu 2 expandieren:

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