dpkg-gensymbols(1)

Från Wiki.linux.se
Version från den 6 mars 2025 kl. 05.43 av Admin (diskussion | bidrag) (Skapade sidan med '= 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 kontrollinform...')
(skillnad) ← Äldre version | Nuvarande version (skillnad) | Nyare version → (skillnad)
Hoppa till navigering Hoppa till sök

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.

      1. 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.

      1. 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

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.

Hämtad från "https://wiki.linux.se/index.php?title=dpkg-gensymbols(1)&oldid=7094"