abidw(1)

abidw(1) - Linux man-sida

NAMN

abidw - serialisera ABI för en ELF-fil

BESKRIVNING

• • abidw** läser ett delat bibliotek i **ELF**-format och genererar en XML-representation av dess **ABI** till standardutgången. Det genererade formatet, kallat **ABIXML**, inkluderar alla globalt definierade funktioner och variabler, tillsammans med en fullständig representation av deras typer. Det innehåller även en representation av de globalt definierade **ELF-symbolerna** i filen.

Vid användning av flaggan `--linux-tree` kan verktyget även hantera en **Linux-kärna** genom att analysera både **vmlinux**-binären och dess moduler, och generera en XML-representation av **Kernel Module Interface (KMI)**.

Som standard använder **abidw** felsökningsinformation i **DWARF**-format, om den finns. Om DWARF inte är tillgängligt, söker det istället efter **CTF** eller **BTF**-format. Om ingen felsökningsinformation finns tillgänglig, kommer endast ELF-symboler att användas för analys.

ANVÄNDNING

``` abidw [alternativ] [sökväg-till-elf-fil] ```

ALTERNATIV

• `-h, --help` - Visa en kort hjälpinformation.
• `-v, --version` - Visa programversionen och avsluta.
• `--abixml-version` - Visa versionen av ABIXML-formatet.
• `--out-file [filnamn]` - Skriv XML-representationen till en specifik fil istället för standardutgången.
• `--noout` - Generera **ingen** XML, endast analys.
• `--debug-info-dir [sökväg]` - Ange en alternativ sökväg för separerad felsökningsinformation.
• `--suppressions [fil]` - Använd en undertryckningsfil för att filtrera bort oönskade delar av ABI.
• `--linux-tree [sökväg]` - Analysera en Linux-kärna och dess moduler.
• `--kmi-whitelist [fil]` - Specificera en vitlista för symboler som ska ingå i KMI.
• `--headers-dir [sökväg]` - Specificera en katalog där publika headers för ABI finns.
• `--drop-private-types` - Exkludera typer som **inte** finns i de angivna header-filerna.
• `--no-parameter-names` - Utelämna parameternamn i den genererade XML-representationen.
• `--exported-interfaces-only` - Analysera endast gränssnitt som exporteras via ELF-symboler.
• `--verbose` - Visa mer detaljerad information under körning.
• `--stats` - Skriv ut statistik över analysen.

EXEMPEL

1. Generera en ABIXML-representation av en ELF-fil: ``` abidw mylibrary.so > mylibrary.abi ```

2. Generera en ABIXML-representation för en Linux-kärna: ``` abidw --linux-tree /path/to/linux > linux-kmi.abi ```

3. Analysera en ELF-fil och dess beroenden: ``` abidw --follow-dependencies --added-binaries-dir /libs mybinary > mybinary.abi ```

FÖRFATTARE

Dodji Seketeli

COPYRIGHT

2024-2025, Red Hat, Inc.

REFERENSER

• ELF: ELF Wikipedia
• DWARF: DWARF standard
• Linux-kärnan: Kernel.org