Man page - deb-substvars(5)

Packages contains this manual

Available languages:

en fr pt nl sv de

Manual

deb-substvars

NAMN
SYNOPS
BESKRIVNING
Variabelsyntax
Filsyntax
Substituering
Inbyggda variabler
FILER
SE ÄVEN
ÖVERSÄTTNING

NAMN

deb-substvars - Debians kÀllkods-substitueringsvariabler

SYNOPS

debian/substvars , debian/ binÀrpaket .substvars , variabler

BESKRIVNING

Innan dpkg-source , dpkg-gencontrol och dpkg-genchanges skriver sin styrinformation (till control-filen i kÀllkodspaketet .dsc för dpkg-source och till standard ut för dpkg-gencontrol och dpkg-genchanges ) kommer de utföra viss variabelsubstituering pÄ utdatafilen.

Variabelsyntax

En variabelsubstitution har formen ${ variabelnamn } . Variabelnamn bestÄr av alfanumeriska tecken (a-zA-Z0-9), bindestreck (-) och kolon (:) och börjar med ett alfanumeriskt tecken, och Àr skiftlÀgeskÀnsliga. Variabelsubstitueringar utförs upprepade gÄnger tills det inte kvarstÄr nÄgra - det resulterande innehÄllet i fÀltet lÀses av pÄ nytt efter substitueringen för att se om det behövs fler substitueringar.

Filsyntax

Substitueringsvariabler kan anges i en fil. En sÄdan fil bestÄr av rader pÄ formen namn = vÀrde , namn ?= <vÀrde>, eller namn != vÀrde . Operatorn = tilldelar en normal substitueringsvariabel, operatorn ?= (sedan dpkg 1.21.8) tilldelar en valfri variabel som inte skriver ut nÄgon varning Àven om den inte anvÀnds, och operatorn != (sedan dpkg 1.22.7) tilldelar en krÀvd substitueringsvariabel som kommer orsaka ett felavslut om den inte anvÀnds. Avslutande blanksteg pÄ en rad, blanka rader och rader som börjar med en # -symbol (kommentarer) ignoreras.

Substituering

Variabler kan sÀttas genom att anvÀnda den gemensamma kommandoradsflaggan -V . De kan Àven anges i filen debian/substvars (eller vilken som helst annan fil som anges med gemensamma flaggan -T ).

NÀr alla substitueringar har utförts ersÀtts varje förekomst av strÀngen ${} (som inte Àr en faktisk substitueringsvariabel) med ett $ -tecken. Detta kan anvÀndas som en ersÀttningssekvens sÄsom ${}{ VARIABEL } vilket kommer bli till ${ VARIABLE } i utdata.

Om en variabel refereras till men inte definieras kommer en varning att genereras och ett tomt vÀrde anvÀnds.

Medan variabelsubstituering görs pÄ alla fÀlt i styrfilen Àr det nÄgra av fÀlten som anvÀnds och behövs vid byggning innan substitueringen Ànnu har utförts. DÀrför gÄr det inte att anvÀnda variabler i fÀlten Package , Source och Architecture .

Variabelsubstituering sker över innehÄllet i fÀlten efter att de har tolkats, vilket innebÀr att om du vill att en variabel ska expanderas över flera rader sÄ behöver du inte inkludera ett blanksteg efter nyradstecknet. Detta görs implicit nÀr fÀltet skrivs ut. Till exempel, om variabeln ${Description} sÀtts till "foo Àr bar.${Newline}foo Àr bra." och du har följande fÀlt:

Description: programmet foo
${Description}
.
Mer text.

SĂ„ blir resultatet:

Description: programmet foo
foo Àr bar.
foo Àr bra.
.
Mer text.

Inbyggda variabler

I tillÀgg Àr alltid följande standardvariabler tillgÀngliga:
Arch

Aktuell vÀrdarkitektur (dvs., arkitekturen paketet byggs för, motsvarigheten till DEB_HOST_ARCH ).

vendor:Name

Aktuellt ÄterförsÀljarnamn (sedan dpkg 1.20.0). VÀrdet kommer frÄn fÀltet Vendor för aktuell ÄterförsÀljares origin-fil, sÄ som dpkg-vendor (1) skulle hÀmta det.

vendor:Id

Aktuellt ÄterförsÀljar-ID (sedan dpkg 1.20.0). Det hÀr bara en variant av vendor:Name skriven med smÄ bokstÀver.

source:Version

KĂ€llkodspaketets version (sedan dpkg 1.13.19).

source:Upstream-Version

Version pÄ uppströmskÀllkodspaketet, inklusive Debianversionens epok, om sÄdan finns (sedan dpkg 1.13.19).

binary:Version

Den binÀra paketversionen (som kan avvika frÄn source:Version , till exempel i en binNMU; sedan dpkg 1.13.19).

Source-Version

Versionen pÄ kÀllkodspaketet (frÄn changelog-filen). Variabeln Àr nu förÄldrad och ger ett felmeddelande om den anvÀnds eftersom betydelsen skiljer sig frÄn funktionen, anvÀnd i stÀllet source:Version eller binary:Version allt eftersom vad som Àr lÀmpligt.

source:Synopsis

KÀllkodspaketets synops, hÀmtad frÄn kÀllkods-strofens Description -fÀlt, om det finns (sedan dpkg 1.19.0).

source:Extended-Description

KÀllkodspaketet utökade beskricning, hÀmtad frÄn kÀllkods-strofens Description -fÀlt, om det finns (sedan dpkg 1.19.0).

Installed-Size

Den ungefÀrliga totala storleken pÄ paketets installerade filer. VÀrdet kopieras in i motsvarande fÀlt i styrfilen. Om du stÀller in det kommer det att ersÀtta vÀrdet pÄ fÀltet. Om variabeln inte Àr satt kommer dpkg-gencontrol att berÀkna dess standardvÀrde genom att summera storleken pÄ alla vanliga filer och symboliska lÀnkar avrundat till 1 KiB-enheter, och ett grundvÀrde pÄ 1 KiB för andra filsystemsobjekttyper. HÄrda lÀnkar rÀknas bara som vanliga filer en gÄng.

Observera : TÀnk pÄ att det hÀr aldrig kan vara nÄgot annat Àn ett nÀrmevÀrde eftersom den faktiska storleken som anvÀnds pÄ det installerade systemet i stor grad beror pÄ vilket filsystem som anvÀnds och dess parameterar, vilket kan komma att anvÀnda mer eller mindre plats Àn vad som anges i det hÀr fÀltet.

Extra-Size

Ytterligare diskutrymme som anvÀnds nÀr paketet installeras. Om vÀrdet Àr satt kommer dess vÀrde att lÀggas till Installed-Size -variabelns vÀrde (oavsett om den satts explicit eller om det förvalda vÀrdet anvÀnds) innan det kopieras till styrfilens fÀlt Installed-Size .

S: fÀltnamn

VÀrdet pÄ kÀllkods-strofens fÀlt fÀltnamn (som mÄste anges med rÀtt form av stora och smÄ bokstÀver; sedan dpkg 1.18.11). Om du sÀtter dessa variabler hÀnder ingenting förutom dÀr de explicit expanderats. Variablerna Àr bara tillgÀngliga nÀr styrfiler för binÀrpaketen skapas.

F: fÀltnamn

VÀrdet pÄ utdatafÀltet fÀltnamn (som mÄste anges med rÀtt form av stora och smÄ bokstÀver). Om du sÀtter dessa variabler hÀnder ingenting förutom dÀr de explicit expanderats.

Format

Formatet pÄ filen .changes som skapats av denna version av kÀllkodspaketeringsskripten. Om du sÀtter denna variabel kommer innehÄllet i Format -fÀltet i filen .changes ocksÄ att Àndras.

Newline , Space , Tab

Dessa variabler innehÄller motsvarande tecken (radbrytning, blanksteg, tabbsteg).

shlibs: beroendefÀlt

VariabelinstÀllningar pÄ den hÀr formen skapas av dpkg-shlibdeps .

dpkg:Upstream-Version

Uppströmsversionen av dpkg (sedan dpkg 1.13.19).

dpkg:Version

FullstÀndig version av dpkg (sedan dpkg 1.13.19).

FILER

debian/substvars

Lista över substitueringsvariabler och -vÀrden.

SE ÄVEN

dpkg (1), dpkg-vendor (1), dpkg-genchanges (1), dpkg-gencontrol (1), dpkg-shlibdeps (1), dpkg-source (1).

ÖVERSÄTTNING

Peter Krefting och Daniel Nylander.