dpkg-gensymbols(1)

dpkg-gensymbols(1)

NAMN

dpkg-gensymbols — generera symbolfiler (beroendeinformation för delade bibliotek)

SYNOPSIS

dpkg-gensymbols [ alternativ ... ]

BESKRIVNING

dpkg-gensymbols genomsöker en tillfällig byggkatalog (standard: debian/tmp) efter delade bibliotek och genererar en symbols-fil som beskriver dem. Denna fil, om den inte är tom, installeras i DEBIAN-undermappen och inkluderas i paketets kontrollinformation.

Den använder underhållarspecifika symbolfiler som indata. Följande filer används (i prioriteringsordning):

• debian/paket.symbols.arch
• debian/symbols.arch
• debian/paket.symbols
• debian/symbols

Huvudsyftet är att ange minimiversionen för varje symbol, vilket vanligtvis motsvarar den första versionen som innehöll symbolen. Underhållaren måste hålla denna fil uppdaterad. Om den genererade symbolfilen skiljer sig från den befintliga, visas en diff. Vid stora avvikelser kan verktyget även misslyckas (se alternativet -c).

Detta program introducerades i dpkg 1.14.8.

UNDERHÅLL AV SYMBOLFILER

Formatet för symbolfiler beskrivs i deb-symbols(5). Symbolfiler är endast användbara om de spårar utvecklingen av ett bibliotek över flera versioner.

Uppdatering av symbolfiler Underhållaren bör uppdatera symbolfilen vid varje ny version och säkerställa att symbolernas funktionalitet inte har förändrats på ett sätt som bryter bakåtkompatibiliteten.

Genererade difflistor i byggloggar kan användas som referens, men kräver manuell granskning. Underhållaren bör:

• Kontrollera att inga symboler har försvunnit.
• Se till att minimiversioner är korrekta.
• Ta bort Debian-revisioner från versioner om möjligt.
• Använda suffixet ~ om en symbol verkligen introducerats i en Debian-specifik patch.

Kommentarer kan inkluderas i symbolfiler.

Bra bibliotekshantering Ett välskött bibliotek bör:

• Bibehålla en stabil API (ingen borttagning av publika symboler, endast tillägg).
• Använda symbolversionering för ABI-stabilitet.
• Undvika att exportera privata symboler (eller markera dem som optional).

Om API eller ABI förändras på ett icke bakåtkompatibelt sätt, bör upstream kontaktas för att undvika Debian-specifika lösningar.

ALTERNATIV

-P katalog Skanna en alternativ katalog istället för debian/tmp.

-p paket Ange paketnamn (krävs om flera binärpaket finns i debian/control).

-v version Ange paketversion (krävs om den inte kan extraheras från debian/changelog).

-e bibliotek Analysera endast angivna bibliotek.

-l katalog Lägg till katalog i sökvägen för privata bibliotek.

-I fil Använd en referensfil för att generera symbolfilen.

-O[fil] Skriv den genererade symbolfilen till standardutgången eller till fil.

-t Skriv ut i mallformat istället för deb-symbols(5)-format.

-c [0-4] Ange strikt nivå för jämförelse mellan genererad och befintlig symbolfil: 0 - Aldrig misslyckas. 1 - Misslyckas om symboler saknas. 2 - Misslyckas om nya symboler introducerats. 3 - Misslyckas om bibliotek saknas. 4 - Misslyckas om nya bibliotek lagts till.

-q Tyst läge, visar inga diffar eller varningar.

-a arkitektur Behandla symbolfiler för en specifik arkitektur.

-d Aktivera felsökningsläge.

-V Visa fler detaljer, inklusive utgångna symboler som kommentarer.

MILJÖVARIABLER

• DEB_HOST_ARCH

Används om arkitektur inte anges med -a.

• DPKG_GENSYMBOLS_CHECK_LEVEL

Överskrider kontrollnivån (-c).

• DPKG_COLORS

Styr färganvändning. Värden: auto (standard), always, never.

• DPKG_NLS

Aktiverar eller inaktiverar internationellt språkstöd (i18n). Värden: 0 eller 1.

SE ÄVEN

• Symbol Versioning Guide
• deb-symbols(5), deb-src-symbols(5), dpkg-shlibdeps(1)

COLOPHON

Denna sida är en del av **dpkg** (Debian Package Manager)-projektet. Mer information finns på: https://wiki.debian.org/Teams/Dpkg

Buggrapporter för denna manualsida skickas till: http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=dpkg

Sidan genererades från dpkg:s Git-repository (hämtad 2025-02-02).

Om du upptäcker problem i denna HTML-version av manualsidan eller har förbättringsförslag, kontakta: man-pages@man7.org

Sidslut

Orginalhemsidan på Engelska :https://man7.org/linux/man-pages/man1/dpkg-gensymbols.1.html

---

Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till PC Service som har sponsrat Linux.se med webbhotell.