Abi-compliance-checker
abi-compliance-checker - Kontrollera ABI-kompatibilitet mellan olika versioner av bibliotek
Kommandot `abi-compliance-checker` används för att kontrollera ABI (Application Binary Interface) kompatibilitet mellan olika versioner av bibliotek.
Syntax
abi-compliance-checker [ALTERNATIV]
Beskrivning
Kommandot `abi-compliance-checker` analyserar två versioner av ett bibliotek och rapporterar eventuella skillnader i deras ABI. Detta är användbart för att säkerställa att ändringar i ett bibliotek inte bryter binär kompatibilitet med program som använder det.
Alternativ
Kommandot `abi-compliance-checker` stöder flera alternativ som kan användas för att justera dess beteende:
- -lib LIBRARY - Namn på biblioteket som ska kontrolleras.
- -old OLD_XML - XML-beskrivning av den gamla versionen av biblioteket.
- -new NEW_XML - XML-beskrivning av den nya versionen av biblioteket.
- -dump DUMP - Dump-fil genererad av abi-dumper.
- -l, --list-symbols - Lista symboler i biblioteket.
- -d, --debug - Visa felsökningsinformation.
- -v, --verbose - Visa mer detaljerad information om jämförelsen.
- -report-path=PATH - Ange sökväg för att spara rapporten.
- -skip-headers=REGEXP - Ignorera headers som matchar REGEXP.
- -show-affected - Visa alla påverkade symboler.
- -help - Visa hjälpmeddelande och avsluta.
- -version - Visa versionsinformation och avsluta.
Exempel
Här är några praktiska exempel som visar hur du kan använda `abi-compliance-checker`-kommandot:
- För att kontrollera ABI-kompatibilitet mellan två versioner av ett bibliotek:
abi-compliance-checker -lib libfoo -old libfoo_v1.xml -new libfoo_v2.xml
- För att generera en rapport och spara den till en specifik sökväg:
abi-compliance-checker -lib libfoo -old libfoo_v1.xml -new libfoo_v2.xml -report-path /path/to/report
- För att visa felsökningsinformation:
abi-compliance-checker -lib libfoo -old libfoo_v1.xml -new libfoo_v2.xml -d
- För att lista symboler i biblioteket:
abi-compliance-checker -lib libfoo -l
- För att visa mer detaljerad information om jämförelsen:
abi-compliance-checker -lib libfoo -old libfoo_v1.xml -new libfoo_v2.xml -v
Skillnader mellan macOS och Linux
Det finns några skillnader att tänka på när man använder `abi-compliance-checker` på macOS jämfört med Linux:
Tillgänglighet: `abi-compliance-checker`-kommandot är generellt sett tillgängligt på de flesta Linux-distributioner. På macOS kan det behöva installeras via paketförvaltare som Homebrew. Installation: På Linux kan `abi-compliance-checker` installeras via paketförvaltaren (t.ex. `apt-get install abi-compliance-checker` på Debian-baserade system). På macOS kan `abi-compliance-checker` installeras via Homebrew med `brew install abi-compliance-checker`.
Exempel på att installera `abi-compliance-checker` på macOS med Homebrew: Installera Homebrew om det inte redan är installerat:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Installera `abi-compliance-checker`:
brew install abi-compliance-checker
Det är alltid bra att konsultera `man`-sidan för `abi-compliance-checker` på din specifika plattform för att se vilka alternativ och funktioner som är tillgängliga och hur de används.
Felsökning
Om du får ett felmeddelande när du använder `abi-compliance-checker`, kontrollera följande:
Att du använder rätt syntax och alternativ för ditt specifika kommando. Att XML-filerna du försöker använda existerar och är tillgängliga. Att du har nödvändiga behörigheter för att läsa filerna.
Se även
abi-dumper - Dumpera ABI-information från en delad objektfil. abidiff - Jämför ABI mellan två versioner av ett bibliotek. nm - Visa symboltabellen för objektfiler.
Källor
https://lvc.github.io/abi-compliance-checker/abi-compliance-checker.html abi-compliance-checker manual (projektets officiella sida)
https://man7.org/linux/man-pages/man1/abi-compliance-checker.1.html abi-compliance-checker manual (Linux)