summaryrefslogtreecommitdiffstats
path: root/man/sv/dpkg-gensymbols.pod
diff options
context:
space:
mode:
Diffstat (limited to 'man/sv/dpkg-gensymbols.pod')
-rw-r--r--man/sv/dpkg-gensymbols.pod286
1 files changed, 286 insertions, 0 deletions
diff --git a/man/sv/dpkg-gensymbols.pod b/man/sv/dpkg-gensymbols.pod
new file mode 100644
index 0000000..44ced04
--- /dev/null
+++ b/man/sv/dpkg-gensymbols.pod
@@ -0,0 +1,286 @@
+
+ *****************************************************
+ * GENERATED FILE, DO NOT EDIT *
+ * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
+ *****************************************************
+
+This file was generated by po4a(7). Do not store it (in VCS, for example),
+but store the PO file used as source file by po4a-translate.
+
+In fact, consider this as a binary, and the PO file as a regular .c file:
+If the PO get lost, keeping this translation up-to-date will be harder.
+
+=encoding UTF-8
+
+=head1 NAMN
+
+dpkg-gensymbols - generera symbolfiler (information om delade bibliotek)
+
+=head1 SYNOPS
+
+B<dpkg-gensymbols> [I<flagga>...]
+
+=head1 BESKRIVNING
+
+B<dpkg-gensymbols> söker genom en temporärt byggträd (som standard
+debian/tmp) efter bibliotek och skapar en I<symbols>-fil som beskriver
+dem. Denna fil kommer sedan, såvida den inte är tom, att installeras i
+DEBIAN-underkatalogen i byggträdet så att den hamnar i styrinformationen i
+paketet.
+
+När dessa filer skapas, används ett par symbolfiler från paketansvariga som
+indata. Programmet söker efter följande filer (och använder den första det
+finner):
+
+=over
+
+=item *
+
+debian/I<paket>.symbols.I<arkitektur>
+
+=item *
+
+debian/symbols.I<arkitektur>
+
+=item *
+
+debian/I<paket>.symbols
+
+=item *
+
+debian/symbols
+
+=back
+
+Dessa filer är i huvudsak intressanta för att kunna tillhandahålla den
+minimala version associerad med varje symbol i biblioteken. Detta motsvarar
+normalt den första version av paketet som tillhandahöll symbolen, men det
+kan manuellt inkrementeras av de ansvariga om symbolens ABI utökas med
+bibehållen bakåtkompatibilitet. Det är den ansvarigas ansvar att hålla dessa
+filer àjourförda och korrekta, men B<dpkg-gensymbols> kan hjälpa till med
+detta.
+
+När den genererade symbolfilen skiljer sig mot den version som
+tillhandahållits av de paketansvariga kommer B<dpkg-gensymbols> att skriva
+ut en differens mellan de två versionerna. Om ändringarna är för stora
+kommer programmet dessutom att misslyckas (du kan justera hur stora
+ändringar du kan tolerera, se flaggan B<-c>).
+
+=head1 UNDERHÅLLA SYMBOLFILER
+
+Det grundläggande utväxlingsformatet för symbolfilen beskrivs i
+B<deb-symbols>(5), vilket används av symbolfilerna som inkluderas i
+bärpaket. Dessa genereras från mallsymbolfiler med ett format som baseras på
+det tidigare nämnda, beskrivet i B<deb-src-symbols>(5) och inkluderas i
+källkodspaket.
+
+Symbolfilerna är bara riktigt nyttiga om de motsvarar hur paketet har
+utvecklats över flera versioner. De paketansvariga måste därför uppdatera
+dem varje gång en ny symbol läggs till så att dess associerade minimala
+version motsvarar verkligheten.
+
+Diffarna som inkluderas i byggloggarna kan användas som en startpunkt, men
+den paketansvarige måste dessutom se till att beteendet för symbolerna inte
+har ändrats på ett sätt som gör att något som använder symbolerna och länkar
+mot den nya versionen slutar fungera med den gamla versionen.Diffarna som
+finns i byggloggarna kan användas som startpunkt, men paketansvariga måste
+dessutom se till att beteendet på dessa symboler inte på något sätt har
+ändrat sig på ett sådant sätt att något som använder symbolerna och länkar
+mot den nya versionen slutar fungera med den gamla versionen.
+
+I de flesta fall kan differensfilen appliceras direkt på filen
+debian/I<paket>.symbols. Med det i åtanke så behövs det oftast ytterligare
+justeringar: det rekommenderas till exempel att skippa Debianrevisionen från
+det minimala versionsnummer så att bakåtanpassningar med ett lägre
+versionsnummer, men med samma uppströmsversion, fortfarande uppfyller de
+genererade beroendena. Om Debianrevisionen inte kan tas bort på grund av att
+en symbol faktiskt lades till av en Debianspecifik ändring så bör ett ”B<~>”
+läggs till i slutet av versionen.
+
+Innan man applicerar en patch på symbolfilen bör de ansvariga dubbelchecka
+att den är korrekt. Publicerade symboler bör inte försvinna, så patchen bör
+ideellt sett bara lägga till nya rader.
+
+Observera att du kan lägga in kommentarer i symbolfilerna
+
+Glöm inte att kontrollera om de gamla symbolversionerna måste ökas. Det
+finns inget sätt för B<dpkg-gensymbols> att varna om detta. Att blint
+applicera diffen eller utgå från att inget har ändrats om diffen är tom,
+utan att se efter sådana ändringar, kan leda till att paket med lösa
+beroenden kan deklarera att de fungerar med äldre paket de inte kan fungera
+tillsammans med. Detta kommer introducera svårfunna problem vid (delvisa)
+uppgraderingar.{
+
+=head2 God hantering av bibliotek
+
+Ett välunderhållet bibliotek har följande funktioner:
+
+=over
+
+=item *
+
+dess API är stabilt (publika symboler tas aldrig bort, endast nya publika
+symboler läggs till) och inkompatibla ändringar görs endast när SONAME
+ändras;
+
+=item *
+
+ideellt använder det en versionhanterade symboler för att upprätthålla
+ABI-stabilitet trots interna ändringar och API-utökningar;
+
+=item *
+
+det exporterar inte privata symboler (sådana symboler kan taggas med
+”optional” för att gå runt detta).
+
+=back
+
+När man underhåller symbolfilen är det lätt att upptäcka symboler som dyker
+upp och försvinner. Det är svårare att upptäcka inkompatibla API- och
+ABI-ändringar. Den paketansvarige bör därför noggrant läsa igenom
+uppströmsändringsloggen för fall då reglerna för god hantering av bibliotek
+bryts. Om ett möjligt fel upptäcks bör uppströmsförfattaren meddelas, då det
+alltid är bättre att problemet rättas uppströms än specifikt i Debian.
+
+=head1 FLAGGOR
+
+=over
+
+=item B<-P>I<paketbyggkatalog>
+
+Sök I<paketbyggkatalog> istället för debian/tmp.
+
+=item B<-p>I<paket>
+
+Definiera paketnamnet. Krävs om mer än ett binärpaket listas i
+debian/control (eller om det inte finns någon debian/control-fil).
+
+=item B<-v>I<version>
+
+Definiera paketversion. Standardvärdet är versionen som hämtas från
+debian/changelog. Krävs om programmet anropas utanför ett källkodspaketträd.
+
+=item B<-e>I<biblioteksfil>
+
+Analyserar endast bibliotek som listats explicit istället för att hitta alla
+publika bibliotek. Du kan använda ett jokertecken för filnamn (se
+manualsidan B<File::Glob>(3perl) för detaljer) i I<biblioteksfil> för att
+träffa multipla bibliotek med ett enda argument (annars behöver du flera
+B<-e>).
+
+=item B<-l>I<katalog>
+
+Lägg till I<katalog> till först i listan över kataloger som ska eftersökas
+efter privata delade bibliotek (sedan dpkg 1.19.1). Flaggan kan användas
+flera gånger.
+
+B<Observera>: Använd den här flaggan istället för att sätta
+B<LD_LIBRARY_PATH>, eftersom miljövariabeln används för att styra
+körtidslänkaren, och genom att utnyttja det för att ange sökvägen till
+delade bibliotek vid kompilering kan det uppstå problem, till exempel vid
+korskompilering.
+
+=item B<-I>I<filnamn>
+
+Använd I<filnamn> som referensfil för att generera symbolfilen som
+integreras i själva paketet.
+
+=item B<-O>[I<filnamn>]
+
+Visa den genererade symbolfilen på standard ut eller spara som I<filnamn> om
+det anges, istället för B<debian/tmp/DEBIAN/symbols> (eller
+I<paketbyggkatalog>B</DEBIAN/symbols> om B<-P> användes). Om I<filnamn>
+redan existerar kommer dess innehåll att användas som bas för den genererade
+symbolfilen. Du kan använda den här funktionen för att uppdatera en
+symbolfil så att den motsvarar en nyare uppströmsversion av ditt bibliotek.
+
+=item B<-t>
+
+Skriv symbolfilen i mall-läge istället för i formatet kompatibelt med
+B<deb-symbols>(5). Huvudskillnaden är att symbolnamn och taggar skrivs i sin
+originalform i mall-läget, till skillnad från de efterbehandlade
+symbolnamnen med borttagna taggar som skrivs i det kompatibla
+läget. Dessutom kan vissa symboler uteslutas när en vanlig
+B<deb-symbols>(5)-fil skrivs (i enlighet med tagghanteringsreglerna) medan
+alla symboler alltid skrivs till symbolfilsmallen.
+
+=item B<-c>I<[0-4]>
+
+Definiera vilka kontroller som ska utföras när den genererade symbolfilen
+jämförs med den mallfil som används som startpunkt. Som standard är nivån
+1. Genom att öka nivån utförs flera kontroller, inklusive alla kontroller på
+lägre nivå. Nivå 2 misslyckas om nya symboler har introducerats. Nivå 3
+misslyckas om några bibliotek har försvunnit. Nivå 4 misslyckas om några
+bibliotek har introducerats.
+
+Värdet kan överstyras med miljövariabeln B<DPKG_GENSYMBOLS_CHECK_LEVEL>.
+
+=item B<-q>
+
+Håll tyst och generera aldrig en differens mellan den genererade symbolfilen
+och mallfilen som användes som startpunkt eller visa varningar om
+nya/förlorade bibliotek eller nya/förlorade symboler. Den här flaggan tar
+endast bort informationsutdata, inte själva kontrolleran (se flaggan B<-c>).
+
+=item B<-a>I<arkitektur>
+
+Anta I<arkitektur> som värdarkitektur vid hantering av symbolfiler. Använd
+den här flaggan för att generera en symbolfil eller differens för valfri
+arkitektur så länge dess binärer är tillgängliga.
+
+=item B<-d>
+
+Aktiverar felsökningsläge. Flera meddelanden visas för att förklara vad
+B<dpkg-gensymbols> gör.
+
+=item B<-V>
+
+Aktivera pratsamt läge. Den genererade symbolfilen innehåller ej längre
+rekommenderade symboler som kommentarer. I mall-läge följs dessutom
+mönstersymboler av kommentarer som visar vilka verkliga symboler som har
+träffats av mönstret.
+
+=item B<-?>, B<--help>
+
+Visar hjälpskärm och avslutar.
+
+=item B<--version>
+
+Visar version och avslutar.
+
+=back
+
+=head1 MILJÖVARIABLER
+
+=over
+
+=item B<DPKG_GENSYMBOLS_CHECK_LEVEL>
+
+Överstyr kommandokontrollnivån, även om kommandoradsflaggan B<-c> gavs
+(observera att detta går mot den normala konventionen att
+kommandoardsflaggor har företräde över miljövariabler).
+
+=item B<DPKG_COLORS>
+
+Väljer färgläge (sedan dpkg 1.18.5). För närvarande godtas följande värden:
+B<auto> (förval), B<always> och B<never>.
+
+=item B<DPKG_NLS>
+
+Om satt, används för att bestämma om lokalt språkstöd ska aktiveras, även
+känt som internationaliseringsstöd (eller i18n) (sedan dpkg
+1.19.0). Tillåtna värden är: B<0> och B<1> (förval).
+
+=back
+
+=head1 SE ÄVEN
+
+L<https://people.redhat.com/drepper/symbol-versioning>,
+L<https://people.redhat.com/drepper/goodpractice.pdf>,
+L<https://people.redhat.com/drepper/dsohowto.pdf>, B<deb-src-symbol>(5),
+B<deb-symbols>(5), B<dpkg-shlibdeps>(1).
+
+
+=head1 ÖVERSÄTTNING
+
+Peter Krefting och Daniel Nylander.