.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "dpkg-buildflags 1"
.TH dpkg-buildflags 1 "2022-09-01" "1.20.12" "dpkg suite"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAAM"
.IX Header "NAAM"
dpkg-buildflags \- geeft de bij pakketbouw te gebruiken bouwvlaggen terug
.SH "OVERZICHT"
.IX Header "OVERZICHT"
\&\fBdpkg-buildflags\fR [\fIoptie\fR...] [\fIcommando\fR]
.SH "BESCHRIJVING"
.IX Header "BESCHRIJVING"
\&\fBdpkg-buildflags\fR is gereedschap om de compilatievlaggen op te halen die
tijdens het bouwen van Debian pakketten gebruikt moeten worden.
.PP
De standaardvlaggen worden gedefinieerd door de leverancier, maar ze kunnen
op verschillende manieren uitgebreid/vervangen worden:
.IP "1." 4
voor het hele systeem met \fB/etc/dpkg/buildflags.conf\fR;
.IP "2." 4
voor de huidige gebruiker met \fB\f(CB$XDG_CONFIG_HOME\fB/dpkg/buildflags.conf\fR,
waarbij \fB\f(CB$XDG_CONFIG_HOME\fB\fR als standaardwaarde \fB\f(CB$HOME\fB/.config\fR heeft;
.IP "3." 4
tijdelijk door de gebruiker met omgevingsvariabelen (zie het onderdeel
\&\fB\s-1OMGEVING\s0\fR);
.IP "4." 4
dynamisch door de pakketonderhouder met omgevingsvariabelen die ingesteld
worden via \fBdebian/rules\fR (zie het onderdeel \fB\s-1OMGEVING\s0\fR).
.PP
De configuratiebestanden kunnen vier types opdrachten bevatten:
.IP "\fB\s-1SET\s0\fR \fIvlag waarde\fR" 4
.IX Item "SET vlag waarde"
De vlag met \fIvlag\fR als naam overschrijven om ze de waarde \fIwaarde\fR te
geven.
.IP "\fB\s-1STRIP\s0\fR \fIvlag waarde\fR" 4
.IX Item "STRIP vlag waarde"
Van de vlag met \fIvlag\fR als naam alle bouwvlaggen verwijderen die in
\&\fIwaarde\fR opgesomd worden.
.IP "\fB\s-1APPEND\s0\fR \fIvlag waarde\fR" 4
.IX Item "APPEND vlag waarde"
De vlag met \fIvlag\fR als naam uitbreiden door er de opties aan toe te voegen
die in \fIwaarde\fR opgegeven worden. Er wordt een spatie geplaatst voor de
waarde die toegevoegd wordt, indien de huidige waarde van de vlag niet leeg
is.
.IP "\fB\s-1PREPEND\s0\fR \fIvlag waarde\fR" 4
.IX Item "PREPEND vlag waarde"
De vlag met \fIvlag\fR als naam uitbreiden door er vooraan de opties aan toe te
voegen die in \fIwaarde\fR opgegeven worden. Er wordt een spatie geplaatst
achter de waarde die toegevoegd wordt, indien de huidige waarde van de vlag
niet leeg is.
.PP
De configuratiebestanden kunnen commentaar bevatten op regels die beginnen
met een hekje (#). Ook lege regels worden genegeerd.
.SH "COMMANDO'S"
.IX Header "COMMANDO'S"
.IP "\fB\-\-dump\fR" 4
.IX Item "--dump"
Op standaarduitvoer alle compilatievlaggen en hun waarden tonen. Dit geeft
per regel \('e\('en vlag en de waarde ervan weer met daartussenin een
gelijkheidsteken (\(lq\fIvlag\fR=\fIwaarde\fR\(rq). Dit is de standaardactie.
.IP "\fB\-\-list\fR" 4
.IX Item "--list"
Een lijst weergeven van vlaggen die door de huidige leverancier ondersteund
worden (\('e\('en per regel). Zie het onderdeel \fB\s-1SUPPORTED FLAGS\s0\fR (ondersteunde
vlaggen) voor meer informatie daarover.
.IP "\fB\-\-status\fR" 4
.IX Item "--status"
Eventuele informatie laten zien welke nuttig kan zijn om het gedrag te
verklaren van \fBdpkg-buildflags\fR (sinds dpkg 1.16.5): relevante
omgevingsvariabelen, huidige leverancier, toestand van alle
functievlaggen. Ook de resulterende compileervlaggen met hun oorsprong
weergeven.
.Sp
Het is de bedoeling dat dit uitgevoerd wordt vanuit \fBdebian/rules\fR, zodat
de bouwlog een duidelijk spoor van de gebruikte vlaggen kan bijhouden. Dit
kan nuttig zijn om ermee verband houdende problemen te diagnosticeren.
.IP "\fB\-\-export=\fR\fIindeling\fR" 4
.IX Item "--export=indeling"
Op standaarduitvoer commando's weergeven die gebruikt kunnen worden om alle
compilatievlaggen te exporteren ten behoeve van een specifiek
gereedschap. Indien de waarde \fIindeling\fR niet opgegeven werd, wordt \fBsh\fR
verondersteld. Enkel compilatievlaggen die met een hoofdletter beginnen
worden opgenomen. Van de andere wordt aangenomen dat ze niet bruikbaar zijn
voor de omgeving. Ondersteunde indelingen:
.RS 4
.IP "\fBsh\fR" 4
.IX Item "sh"
Shell-opdrachten om alle compilatievlaggen in de omgeving in te stellen en
te exporteren. Er worden aanhalingstekens geplaatst rond de vlagwaarden
waardoor de uitvoer gereed is om door een shell ge\(:evalueerd te worden.
.IP "\fBcmdline\fR" 4
.IX Item "cmdline"
Argumenten om door te geven aan de commandoregel van een bouwprogramma om al
de compilatievlaggen te gebruiken (sinds dpkg 1.17.0). De vlagwaarden worden
volgens de shell-syntaxis tussen haakjes geplaatst.
.IP "\fBconfigure\fR" 4
.IX Item "configure"
Dit is een verouderde alias voor \fBcmdline\fR.
.IP "\fBmake\fR" 4
.IX Item "make"
Make-opdrachten om alle compilatievlaggen in de omgeving in te stellen en te
exporteren. De uitvoer kan naar een Makefile-fragment geschreven worden en
ge\(:evalueerd met behulp van een \fBinclude\fR\-opdracht.
.RE
.RS 4
.RE
.IP "\fB\-\-get\fR \fIvlag\fR" 4
.IX Item "--get vlag"
De waarde van de vlag op de standaarduitvoer weergeven. Sluit af met 0 bij
een gekende vlag en sluit anders af met 1.
.IP "\fB\-\-origin\fR \fIvlag\fR" 4
.IX Item "--origin vlag"
De origine weergeven van de waarde die teruggegeven wordt door
\&\fB\-\-get\fR. Sluit af met 0 bij een gekende vlag en sluit anders af met 1. De
origine kan \('e\('en van de volgende waarden hebben:
.RS 4
.IP "\fBvendor\fR" 4
.IX Item "vendor"
de originele vlag die door de leverancier ingesteld werd, wordt
teruggegeven;
.IP "\fBsystem\fR" 4
.IX Item "system"
de vlag werd ingesteld/gewijzigd door een systeemconfiguratie;
.IP "\fBuser\fR" 4
.IX Item "user"
de vlag werd ingesteld/gewijzigd door een gebruikersspecifieke configuratie;
.IP "\fBenv\fR" 4
.IX Item "env"
de vlag werd ingesteld/gewijzigd door een omgevingsspecifieke configuratie.
.RE
.RS 4
.RE
.IP "\fB\-\-query\fR" 4
.IX Item "--query"
Alle informatie tonen welke nuttig kan zijn om het gedrag van het programma
te verklaren: huidige leverancier, relevante omgevingsvariabelen,
functiegebieden, toestand van alle functievlaggen en de compileervlaggen met
hun oorsprong (sinds dpkg 1.19.0).
.Sp
Bijvoorbeeld:
.Sp
.Vb 3
\& Vendor: Debian
\& Environment:
\&  DEB_CFLAGS_SET=\-O0 \-Wall
\&
\& Area: qa
\& Features:
\&  bug=no
\&  canary=no
\&
\& Area: reproducible
\& Features:
\&  timeless=no
\&
\& Flag: CFLAGS
\& Value: \-O0 \-Wall
\& Origin: env
\&
\& Flag: CPPFLAGS
\& Value: \-D_FORTIFY_SOURCE=2
\& Origin: vendor
.Ve
.IP "\fB\-\-query\-features\fR \fIgebied\fR" 4
.IX Item "--query-features gebied"
De functies weergeven die voor een opgegeven gebied geactiveerd zijn (sinds
dpkg 1.16.2). Momenteel worden door Debian en zijn derivaten enkel de
gebieden \fBfuture\fR, \fBqa\fR, \fBreproducible\fR, \fBsanitize\fR en \fBhardening\fR
herkend. Zie het onderdeel \fB\s-1FUNCTIEGEBIEDEN\s0\fR voor meer details. Sluit af
met 0 als het gebied gekend is, anders met 1.
.Sp
De uitvoer is in RFC822\-indeling met \('e\('en sectie per functie. Bijvoorbeeld:
.Sp
.Vb 2
\& Feature: pie
\& Enabled: yes
\&
\& Feature: stackprotector
\& Enabled: yes
.Ve
.IP "\fB\-\-help\fR" 4
.IX Item "--help"
Info tonen over het gebruik en afsluiten.
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
De versie tonen en afsluiten.
.SH "ONDERSTEUNDE VLAGGEN"
.IX Header "ONDERSTEUNDE VLAGGEN"
.IP "\fB\s-1CFLAGS\s0\fR" 4
.IX Item "CFLAGS"
Opties voor de C\-compiler. De door de leverancier ingestelde standaardwaarde
bestaat uit \fB\-g\fR en het standaardniveau van optimalisatie (gewoonlijk
\&\fB\-O2\fR, of \fB\-O0\fR indien de omgevingsvariabele \fB\s-1DEB_BUILD_OPTIONS\s0\fR \fInoopt\fR
aangeeft).
.IP "\fB\s-1CPPFLAGS\s0\fR" 4
.IX Item "CPPFLAGS"
Opties voor de C\-preprocessor. Standaardwaarde: leeg.
.IP "\fB\s-1CXXFLAGS\s0\fR" 4
.IX Item "CXXFLAGS"
Opties voor de \*(C+ compiler. Hetzelfde als \fB\s-1CFLAGS\s0\fR.
.IP "\fB\s-1OBJCFLAGS\s0\fR" 4
.IX Item "OBJCFLAGS"
Opties voor de Objective C compiler. Hetzelfde als \fB\s-1CFLAGS\s0\fR.
.IP "\fB\s-1OBJCXXFLAGS\s0\fR" 4
.IX Item "OBJCXXFLAGS"
Opties voor de Objective \*(C+ compiler. Hetzelfde als \fB\s-1CXXFLAGS\s0\fR.
.IP "\fB\s-1GCJFLAGS\s0\fR" 4
.IX Item "GCJFLAGS"
Opties voor de \s-1GNU\s0 Java compiler (gcj). Een subset van \fB\s-1CFLAGS\s0\fR.
.IP "\fB\s-1DFLAGS\s0\fR" 4
.IX Item "DFLAGS"
Opties voor de D\-compiler (ldc of gdc). Sinds dpkg 1.20.6.
.IP "\fB\s-1FFLAGS\s0\fR" 4
.IX Item "FFLAGS"
Opties voor de Fortran 77 compiler. Een subset van \fB\s-1CFLAGS\s0\fR.
.IP "\fB\s-1FCFLAGS\s0\fR" 4
.IX Item "FCFLAGS"
Opties voor de Fortran 9x compiler. Hetzelfde als \fB\s-1FFLAGS\s0\fR.
.IP "\fB\s-1LDFLAGS\s0\fR" 4
.IX Item "LDFLAGS"
Opties die aan de compiler doorgegeven worden bij het linken van uitvoerbare
programma's en gedeelde objecten (indien de linker rechtstreeks aangeroepen
wordt, dan moeten \fB\-Wl\fR en \fB,\fR van die opties verwijderd
worden). Standaardwaarde: leeg.
.PP
In de toekomst kunnen nog andere vlaggen toegevoegd worden als daar behoefte
aan ontstaat (bijvoorbeeld om andere talen te ondersteunen).
.SH "FUNCTIEGEBIEDEN"
.IX Header "FUNCTIEGEBIEDEN"
Elke gebiedsfunctie kan in de gebiedswaarde van de omgevingsvariabelen
\&\fB\s-1DEB_BUILD_OPTIONS\s0\fR en \fB\s-1DEB_BUILD_MAINT_OPTIONS\s0\fR ingeschakeld en
uitgeschakeld worden met de schakelaars \(oq\fB+\fR\(cq en \(oq\fB\-\fR\(cq. Om bijvoorbeeld de
\&\fBhardening\fR\-functionaliteit \(lqpie\(rq te activeren en de functionaliteit
\(lqfortify\(rq uit te schakelen, kunt u in \fBdebian/rules\fR het volgende doen:
.PP
.Vb 1
\&    export DEB_BUILD_MAINT_OPTIONS=hardening=+pie,\-fortify
.Ve
.PP
De bijzondere functie \fBall\fR (geldig in elk gebied) kan gebruikt worden om
gelijktijdig alle gebiedsfunctionaliteit te activeren of uit te
schakelen. Alles uitschakelen in het gebied \fBhardening\fR en enkel \(lqformat\(rq
en \(lqfortify\(rq activeren kunt u dus doen met:
.PP
.Vb 1
\&    export DEB_BUILD_MAINT_OPTIONS=hardening=\-all,+format,+fortify
.Ve
.SS "future"
.IX Subsection "future"
Er kunnen verschillende compilatieopties (die hierna beschreven worden)
gebruikt worden om functies te activeren die standaard geactiveerd zouden
moeten zijn, maar dat niet zijn om redenen van terugwaartse compatibiliteit.
.IP "\fBlfs\fR" 4
.IX Item "lfs"
Deze instelling (standaard uitgezet) activeert ondersteuning voor grote
bestanden (Large File Support) op 32\-bits architecturen waarvan de \s-1ABI\s0
standaard geen LFS-ondersteuning biedt, door \fB\-D_LARGEFILE_SOURCE
\&\-D_FILE_OFFSET_BITS=64\fR toe te voegen aan \fB\s-1CPPFLAGS\s0\fR.
.SS "qa (kwaliteitsbevordering)"
.IX Subsection "qa (kwaliteitsbevordering)"
Er kunnen verschillende compilatieopties (die hierna beschreven worden)
gebruikt worden om problemen in de broncode of het bouwsysteem te helpen
detecteren.
.IP "\fBbug\fR" 4
.IX Item "bug"
Deze instelling (die standaard uitgeschakeld is) voegt alle
waarschuwingsopties toe die op een betrouwbare wijze problematische broncode
opsporen. De waarschuwingen zijn fataal. De enige vlaggen die momenteel
ondersteund worden zijn \fB\s-1CFLAGS\s0\fR en \fB\s-1CXXFLAGS\s0\fR waarbij de vlaggen
ingesteld staan op \fB\-Werror=array\-bounds\fR, \fB\-Werror=clobbered\fR,
\&\fB\-Werror=implicit\-function\-declaration\fR en
\&\fB\-Werror=volatile\-register\-var\fR.
.IP "\fBcanary\fR" 4
.IX Item "canary"
Deze instelling (die standaard uitgeschakeld is) voegt loze
kanarievogelopties toe aan de bouwvlaggen, zodat in de bouwlogs nagekeken
kan worden hoe de bouwvlaggen doorgegeven worden en zodat het eventueel
ontbreken van normale bouwvlaginstellingen ontdekt kan worden. Momenteel
zijn de enige ondersteunde vlaggen \fB\s-1CPPFLAGS\s0\fR, \fB\s-1CFLAGS\s0\fR, \fB\s-1OBJCFLAGS\s0\fR,
\&\fB\s-1CXXFLAGS\s0\fR en \fB\s-1OBJCXXFLAGS\s0\fR, waarbij die vlaggen als
\&\fB\-D_\|_DEB_CANARY_\fR\fIvlag\fR_\fIwillekeurige-id\fR\fB_\|_\fR ingesteld worden, en
\&\fB\s-1LDFLAGS\s0\fR dat ingesteld wordt op \fB\-Wl,\-z,deb\-canary\-\fR\fIwillekeurige-id\fR.
.SS "sanitize (saneren)"
.IX Subsection "sanitize (saneren)"
Er kunnen verschillende compilatie-opties (die hierna beschreven worden)
gebruikt worden om te helpen bij het gezond houden van een resulterend
binair pakket op het vlak van geheugenvervuiling, geheugenlekkage,
geheugengebruik na vrijgave, dataraces bij threads en bugs door
ongedefinieerd gedrag. \fBNoot\fR: deze opties zouden \fBniet\fR gebruikt mogen
worden voor een bouw voor productiedoeleinden, aangezien ze een verminderde
betrouwbaarheid bieden inzake codeconformiteit en de beveiliging en zelfs de
functionaliteit reduceren.
.IP "\fBaddress\fR" 4
.IX Item "address"
Deze instelling (standaard uitgeschakeld) voegt \fB\-fsanitize=address\fR toe
aan \fB\s-1LDFLAGS\s0\fR en \fB\-fsanitize=address \-fno\-omit\-frame\-pointer\fR aan
\&\fB\s-1CFLAGS\s0\fR en aan \fB\s-1CXXFLAGS\s0\fR.
.IP "\fBthread\fR" 4
.IX Item "thread"
Deze instelling (standaard uitgeschakeld) voegt \fB\-fsanitize=thread\fR toe aan
\&\fB\s-1CFLAGS\s0\fR, \fB\s-1CXXFLAGS\s0\fR en \fB\s-1LDFLAGS\s0\fR.
.IP "\fBleak\fR" 4
.IX Item "leak"
Deze instelling (standaard uitgeschakeld) voegt \fB\-fsanitize=leak\fR toe aan
\&\fB\s-1LDFLAGS\s0\fR. Ze wordt automatisch uitgeschakeld als ofwel de
\&\fBaddress\fR\-functionaliteit of de \fBthread\fR\-functionaliteit geactiveerd is,
aangezien die dit impliceren.
.IP "\fBundefined\fR" 4
.IX Item "undefined"
Deze instelling (standaard uitgeschakeld) voegt \fB\-fsanitize=undefined\fR toe
aan \fB\s-1CFLAGS\s0\fR, \fB\s-1CXXFLAGS\s0\fR en \fB\s-1LDFLAGS\s0\fR.
.SS "hardening (kwetsbaarheidsreductie)"
.IX Subsection "hardening (kwetsbaarheidsreductie)"
Er kunnen verschillende compilatie-opties (die hierna beschreven worden)
gebruikt worden om te helpen bij het versterken van een resulterend binair
pakket tegen geheugenvervuilingsaanvallen of om bijkomende
waarschuwingsberichten te geven tijdens het compileren. Behalve wanneer
hierna anders aangegeven is, worden deze opties standaard geactiveerd voor
architecturen die ze ondersteunen.
.IP "\fBformat\fR" 4
.IX Item "format"
Deze instelling (standaard geactiveerd) voegt \fB\-Wformat
\&\-Werror=format\-security\fR toe aan \fB\s-1CFLAGS\s0\fR, \fB\s-1CXXFLAGS\s0\fR, \fB\s-1OBJCFLAGS\s0\fR en
\&\fB\s-1OBJCXXFLAGS\s0\fR. Dit zal waarschuwingen geven bij verkeerd gebruik van
indelingstekenreeksen en zal mislukken als indelingsfuncties gebruikt worden
op een manier die mogelijke veiligheidsproblemen tot gevolg kunnen
hebben. Momenteel geeft dit een waarschuwing als een \fBprintf\fR\-functie of
een \fBscanf\fR\-functie aangeroepen wordt met een indelingstekenreeks die geen
letterlijke tekenreeks is en er ook geen indelingsargumenten opgegeven
werden, zoals bij \fBprintf(foo);\fR in plaats van \fBprintf(\*(L"%s\*(R", foo);\fR. Dit
kan een veiligheidslek zijn als de indelingstekenreeks afkomstig was van
onbetrouwbare invoer en \(oq%n\(cq bevat.
.IP "\fBfortify\fR" 4
.IX Item "fortify"
Deze instelling (standaard geactiveerd) voegt \fB\-D_FORTIFY_SOURCE=2\fR toe aan
\&\fB\s-1CPPFLAGS\s0\fR. Tijdens het produceren van de code heeft de compiler een
heleboel informatie over buffergroottes (waar mogelijk), en tracht een
functieaanroep met een onveilige ongelimiteerde buffergrootte te vervangen
door een functieaanroep met een gelimiteerde buffergrootte. Dit is in het
bijzonder nuttig bij oude en slecht geschreven code. Daarnaast wordt het
gebruik in het voor schrijven toegankelijk geheugen van
indelingstekenreeksen die \(oq%n\(cq bevatten, geblokkeerd. Indien een toepassing
op een dergelijke indelingstekenreeks steunt, zal het er een alternatief
voor moeten gebruiken.
.Sp
Merk op dat de code ook met \fB\-O1\fR of hoger gecompileerd moet worden opdat
deze optie effect zou hebben. Indien de omgevingsvariabele
\&\fB\s-1DEB_BUILD_OPTIONS\s0\fR \fInoopt\fR bevat, dan wordt ondersteuning voor \fBfortify\fR
uitgeschakeld. Dit is te wijten aan nieuwe waarschuwingen die gegeven worden
door glibc 2.16 en hoger.
.IP "\fBstackprotector\fR" 4
.IX Item "stackprotector"
Deze instelling (standaard geactiveerd als stackprotectorstrong niet
gebruikt wordt) voegt \fB\-fstack\-protector \-\-param=ssp\-buffer\-size=4\fR toe aan
\&\fB\s-1CFLAGS\s0\fR, \fB\s-1CXXFLAGS\s0\fR, \fB\s-1OBJCFLAGS\s0\fR, \fB\s-1OBJCXXFLAGS\s0\fR, \fB\s-1GCJFLAGS\s0\fR, \fB\s-1FFLAGS\s0\fR
en \fB\s-1FCFLAGS\s0\fR. Dit voegt beveiligingscontroles tegen het overschrijven van
de stack toe. Dit maakt dat bij veel mogelijke code-injectieaanvallen
afgebroken wordt. In het beste geval wordt op die manier een kwetsbaarheid
voor code-injectie omgebogen tot een denial-of-service (dienst niet
beschikbaar) of een fictief probleem (afhankelijk van de toepassing).
.Sp
Deze functionaliteit vereist het linken van de code met glibc (of een andere
aanbieder van \fB_\|_stack_chk_fail\fR) en moet dus uitgeschakeld worden als er
gebouwd wordt met \fB\-nostdlib\fR of \fB\-ffreestanding\fR of iets gelijkaardigs.
.IP "\fBstackprotectorstrong\fR" 4
.IX Item "stackprotectorstrong"
Deze instelling (standaard geactiveerd) voegt \fB\-fstack\-protector\-strong\fR
toe aan \fB\s-1CFLAGS\s0\fR, \fB\s-1CXXFLAGS\s0\fR, \fB\s-1OBJCFLAGS\s0\fR, \fB\s-1OBJCXXFLAGS\s0\fR, \fB\s-1GCJFLAGS\s0\fR,
\&\fB\s-1FFLAGS\s0\fR en \fB\s-1FCFLAGS\s0\fR. Dit is een sterkere variant van \fBstackprotector\fR,
maar zonder noemenswaardig prestatieverlies.
.Sp
Het uitzetten van \fBstackprotector\fR schakelt ook deze functionaliteit uit.
.Sp
Deze functionaliteit stelt dezelfde vereisten als \fBstackprotector\fR en heeft
daarenboven ook gcc 4.9 of een recentere versie nodig.
.IP "\fBrelro\fR" 4
.IX Item "relro"
Deze instelling (standaard geactiveerd) voegt \fB\-Wl,\-z,relro\fR toe aan
\&\fB\s-1LDFLAGS\s0\fR. Tijdens het laden van het programma moet de linker in
verschillende ELF-geheugensecties schrijven. Dit zet voor de programmalader
een vlag zodat die deze secties alleen-lezen maakt alvorens de controle over
te dragen aan het programma. Het meest noemenswaardige effect is dat dit
aanvallen door het overschrijven van de Global Offset Table (\s-1GOT\s0)
voorkomt. Indien deze optie uitgeschakeld wordt, wordt ook \fBbindnow\fR
uitgezet.
.IP "\fBbindnow\fR" 4
.IX Item "bindnow"
Deze instelling (standaard uitgeschakeld) voegt \fB\-Wl,\-z,now\fR toe aan
\&\fB\s-1LDFLAGS\s0\fR. Tijdens het laden van het programma worden alle dynamische
symbolen omgezet, waardoor de volledige \s-1PLT\s0 (Procedure Linkage Table) als
alleen lezen gemarkeerd kan worden (ten gevolge van \fBrelro\fR hiervoor). Deze
optie kan niet aangezet worden als \fBrelro\fR niet geactiveerd is.
.IP "\fBpie\fR" 4
.IX Item "pie"
Deze instelling (zonder standaardinstelling sinds dpkg 1.18.23, aangezien
het nu standaard geactiveerd wordt door gcc op de Debian-architecturen
amd64, arm64, armel, armhf, hurd\-i386, i386, kfreebsd\-amd64, kfreebsd\-i386,
mips, mipsel, mips64el, powerpc, ppc64, ppc64el, riscv64, s390x, sparc en
sparc64) voegt zo nodig de vereiste opties toe om \s-1PIE\s0 te activeren of te
deactiveren via gcc specs-bestanden, afhankelijk van het feit of gcc op die
architectuur de vlaggen zelf injecteert of niet. Indien de instelling
geactiveerd is en gcc de vlaggen injecteert, voegt ze niets toe. Indien de
instelling geactiveerd is en gcc de vlaggen niet injecteert, voegt ze
\&\fB\-fPIE\fR toe (via \fI/usr/share/dpkg/pie\-compiler.specs\fR) aan \fB\s-1CFLAGS\s0\fR,
\&\fB\s-1CXXFLAGS\s0\fR, \fB\s-1OBJCFLAGS\s0\fR, \fB\s-1OBJCXXFLAGS\s0\fR, \fB\s-1GCJFLAGS\s0\fR, \fB\s-1FFLAGS\s0\fR en
\&\fB\s-1FCFLAGS\s0\fR, en \fB\-fPIE \-pie\fR (via \fI/usr/share/dpkg/pie\-link.specs\fR) aan
\&\fB\s-1LDFLAGS\s0\fR. Indien de instelling gedeactiveerd is en gcc de vlaggen
injecteert, voegt ze \fB\-fno\-PIE\fR toe (via
\&\fI/usr/share/dpkg/no\-pie\-compile.specs\fR) aan \fB\s-1CFLAGS\s0\fR, \fB\s-1CXXFLAGS\s0\fR,
\&\fB\s-1OBJCFLAGS\s0\fR, \fB\s-1OBJCXXFLAGS\s0\fR, \fB\s-1GCJFLAGS\s0\fR, \fB\s-1FFLAGS\s0\fR en \fB\s-1FCFLAGS\s0\fR, en
\&\fB\-fno\-PIE \-no\-pie\fR (via \fI/usr/share/dpkg/no\-pie\-link.specs\fR) aan \fB\s-1LDFLAGS\s0\fR.
.Sp
Position Independent Executable (\s-1PIE\s0 \- positie-onafhankelijke programma's)
zijn nodig om voordeel te halen uit Address Space Layout Randomization (\s-1ASLR\s0
\&\- de adresruimte rangschikken in toevallige volgorde), hetgeen door sommige
kernelversies ondersteund wordt. Hoewel \s-1ASLR\s0 reeds voor datagebieden in de
stack en de heap opgelegd kan worden (brk and mmap), moeten de codegebieden
als positieonafhankelijk gecompileerd worden. Gedeelde bibliotheken doen dit
reeds (\fB\-fPIC\fR), waardoor zij automatisch \s-1ASLR\s0 krijgen, maar binaire
\&.text\-gebieden moeten als \s-1PIE\s0 gebouwd worden om \s-1ASLR\s0 te krijgen. Als dit
gebeurt, worden aanvallen van het type \s-1ROP\s0 (Return Oriented Programming \- op
terugkeerwaarde geori\(:enteerd programmeren) veel moeilijker aangezien er geen
statische locaties meer zijn die bij een aanval van geheugenvervuiling als
springplank gebruikt kunnen worden.
.Sp
\&\s-1PIE\s0 is niet compatibel met \fB\-fPIC\fR, dus over het algemeen moet men
voorzichtig zijn bij het bouwen van gedeelde objecten. Maar aangezien de
PIE-vlaggen die meegegeven worden ge\(:injecteerd worden via specs-bestanden
van gcc, zou het altijd veilig moeten zijn om ze onvoorwaardelijk in te
stellen ongeacht het objecttype dat gecompileerd of gelinkt wordt.
.Sp
Statische bibliotheken kunnen door programma's of door andere gedeelde
bibliotheken gebruikt worden. Afhankelijk van de gebruikte vlaggen bij het
compileren van alle objecten in een statische bibliotheek, zullen deze
bibliotheken door verschillende reeksen objecten gebruikt kunnen worden:
.RS 4
.IP "geen" 4
.IX Item "geen"
Kan niet gelinkt worden aan een PIE-programma, noch aan een gedeelde
bibliotheek.
.IP "\fB\-fPIE\fR" 4
.IX Item "-fPIE"
Kan gelinkt worden aan elk programma, maar niet aan een gedeelde bibliotheek
(aanbevolen).
.IP "\fB\-fPIC\fR" 4
.IX Item "-fPIC"
Kan gelinkt worden aan elk programma en elke gedeelde bibliotheek.
.RE
.RS 4
.Sp
Indien er een behoefte bestaat om deze vlaggen manueel in te stellen en de
gcc specs-injectie te overbruggen, moet u rekening houden met verschillende
zaken. Het onvoorwaardelijk en expliciet doorgeven van \fB\-fPIE\fR, \fB\-fpie\fR of
\&\fB\-pie\fR aan een bouwsysteem dat libtool gebruikt, is veilig aangezien deze
vlaggen weggelaten worden bij het bouwen van gedeelde bibliotheken. Bij
projecten waarin daarentegen zowel programma's als gedeelde bibliotheken
gebouwd worden, moet u ervoor zorgen dat bij het bouwen van de gedeelde
bibliotheken \fB\-fPIC\fR steeds als laatste doorgegeven wordt (waardoor het een
eventuele voorafgaande \fB\-PIE\fR opheft) aan compilatievlaggen zoals \fB\s-1CFLAGS\s0\fR
en dat \fB\-shared\fR als laatste doorgegeven wordt (waardoor het een eventuele
voorafgaande \fB\-pie\fR opheft) aan linkvlaggen zoals \fB\s-1LDFLAGS\s0\fR. \fBOpmerking:\fR
dit is niet nodig met het standaard specs-mechanisme van gcc.
.Sp
Aangezien \s-1PIE\s0 via een algemeen register ge\(:implementeerd wordt, kunnen
bovendien bij sommige architecturen (maar niet meer bij i386 sinds de
optimalisaties die in gcc >= 5 toegepast zijn) prestatieverminderingen
tot 15% optreden bij zeer zware belasting met tekstsegmenten van
toepassingen. De meeste belastingen hebben minder dan 1%
prestatievermindering tot gevolg. Architecturen met meer algemene registers
(bijv. amd64) vertonen niet zo een hoge terugval in de ergste gevallen.
.RE
.SS "reproducible (reproduceerbaar)"
.IX Subsection "reproducible (reproduceerbaar)"
De hierna behandelde compilatieopties kunnen gebruikt worden om de
bouwreproduceerbaarheid te helpen verbeteren of om bijkomende
waarschuwingsberichten af te leveren tijdens het compileren. Behalve wanneer
het hierna aangegeven wordt, worden deze opties standaard geactiveerd voor
architecturen die ze ondersteunen.
.IP "\fBtimeless\fR" 4
.IX Item "timeless"
Deze instelling (standaard geactiveerd) voegt \fB\-Wdate\-time\fR toe bij
\&\fB\s-1CPPFLAGS\s0\fR. Dit leidt tot waarschuwingen als de macros \fB_\|_TIME_\|_\fR,
\&\fB_\|_DATE_\|_\fR en \fB_\|_TIMESTAMP_\|_\fR gebruikt worden.
.IP "\fBfixfilepath\fR" 4
.IX Item "fixfilepath"
Deze instelling (standaard geactiveerd) voegt
\&\fB\-ffile\-prefix\-map=\fR\fI\s-1BUILDPATH\s0\fR\fB=.\fR toe aan \fB\s-1CFLAGS\s0\fR, \fB\s-1CXXFLAGS\s0\fR,
\&\fB\s-1OBJCFLAGS\s0\fR, \fB\s-1OBJCXXFLAGS\s0\fR, \fB\s-1GCJFLAGS\s0\fR, \fB\s-1FFLAGS\s0\fR en \fB\s-1FCFLAGS\s0\fR, waarbij
\&\fB\s-1BUILDPATH\s0\fR ingesteld wordt op de basismap van het pakket dat gebouwd
wordt. Dit heeft als effect dat het bouwpad verwijderd wordt van elk
gegenereerd bestand.
.Sp
Indien zowel \fBfixdebugpath\fR als \fBfixfilepath\fR ingesteld zijn, heeft deze
laatste optie voorrang, omdat het een superset is van de eerste.
.IP "\fBfixdebugpath\fR" 4
.IX Item "fixdebugpath"
Deze instelling (standaard geactiveerd) voegt
\&\fB\-fdebug\-prefix\-map=\fR\fI\s-1BUILDPATH\s0\fR\fB=.\fR toe aan \fB\s-1CFLAGS\s0\fR, \fB\s-1CXXFLAGS\s0\fR,
\&\fB\s-1OBJCFLAGS\s0\fR, \fB\s-1OBJCXXFLAGS\s0\fR, \fB\s-1GCJFLAGS\s0\fR, \fB\s-1FFLAGS\s0\fR en \fB\s-1FCFLAGS\s0\fR, waarbij
\&\fB\s-1BUILDPATH\s0\fR ingesteld wordt op de basismap van het pakket dat gebouwd
wordt. Dit heeft als effect dat het bouwpad verwijderd wordt van eventueel
gegenereerde debug-symbolen.
.SH "OMGEVING"
.IX Header "OMGEVING"
Er zijn twee sets omgevingsvariabelen die dezelfde operaties uitvoeren. De
eerste (\s-1DEB_\s0\fIvlag\fR_\fIoperatie\fR) zou nooit gebruikt mogen worden binnen
\&\fBdebian/rules\fR. Die is bedoeld voor eventuele gebruikers die het bronpakket
opnieuw willen bouwen met andere bouwvlaggen. De tweede set
(\s-1DEB_\s0\fIvlag\fR_MAINT_\fIoperatie\fR) zou door pakketonderhouders enkel in
\&\fBdebian/rules\fR gebruikt moeten worden om de resulterende bouwvlaggen aan te
passen.
.IP "\fB\s-1DEB_\s0\fR\fIvlag\fR\fB_SET\fR" 4
.IX Item "DEB_vlag_SET"
.PD 0
.IP "\fB\s-1DEB_\s0\fR\fIvlag\fR\fB_MAINT_SET\fR" 4
.IX Item "DEB_vlag_MAINT_SET"
.PD
Deze variabele kan gebruikt worden om de teruggegeven waarde voor de
opgegeven vlag \fIvlag\fR af te dwingen.
.IP "\fB\s-1DEB_\s0\fR\fIvlag\fR\fB_STRIP\fR" 4
.IX Item "DEB_vlag_STRIP"
.PD 0
.IP "\fB\s-1DEB_\s0\fR\fIvlag\fR\fB_MAINT_STRIP\fR" 4
.IX Item "DEB_vlag_MAINT_STRIP"
.PD
Deze variabele kan gebruikt worden om in een lijst met witruimte als
scheidingsteken opties op te geven die weggehaald zullen worden uit de set
vlaggen die teruggegeven wordt voor de opgegeven \fIvlag\fR.
.IP "\fB\s-1DEB_\s0\fR\fIvlag\fR\fB_APPEND\fR" 4
.IX Item "DEB_vlag_APPEND"
.PD 0
.IP "\fB\s-1DEB_\s0\fR\fIvlag\fR\fB_MAINT_APPEND\fR" 4
.IX Item "DEB_vlag_MAINT_APPEND"
.PD
Deze variabele kan gebruikt worden om bijkomende opties toe te voegen aan de
waarde die teruggegeven wordt voor de opgegeven \fIvlag\fR.
.IP "\fB\s-1DEB_\s0\fR\fIvlag\fR\fB_PREPEND\fR" 4
.IX Item "DEB_vlag_PREPEND"
.PD 0
.IP "\fB\s-1DEB_\s0\fR\fIvlag\fR\fB_MAINT_PREPEND\fR" 4
.IX Item "DEB_vlag_MAINT_PREPEND"
.PD
Deze variabele kan gebruikt worden om vooraan bijkomende opties toe te
voegen aan de waarde die teruggegeven wordt voor de opgegeven \fIvlag\fR.
.IP "\fB\s-1DEB_BUILD_OPTIONS\s0\fR" 4
.IX Item "DEB_BUILD_OPTIONS"
.PD 0
.IP "\fB\s-1DEB_BUILD_MAINT_OPTIONS\s0\fR" 4
.IX Item "DEB_BUILD_MAINT_OPTIONS"
.PD
Deze variabelen kunnen door een gebruiker of een onderhouder gebruikt worden
om diverse gebiedsfuncties die bouwvlaggen be\(:invloeden, te activeren of uit
te zetten. De variabele \fB\s-1DEB_BUILD_MAINT_OPTIONS\s0\fR vervangt eventuele
instellingen in de functionaliteitsgebieden \fB\s-1DEB_BUILD_OPTIONS\s0\fR. Zie het
onderdeel \fB\s-1FUNCTIONALITEITSGEBIEDEN\s0\fR voor de details.
.IP "\fB\s-1DEB_VENDOR\s0\fR" 4
.IX Item "DEB_VENDOR"
Deze instelling definieert de huidige leverancier. Indien zij niet ingesteld
is, zal gezocht worden naar de huidige leverancier door te gaan lezen in
\&\fB/etc/dpkg/origins/default\fR.
.IP "\fB\s-1DEB_BUILD_PATH\s0\fR" 4
.IX Item "DEB_BUILD_PATH"
Deze variabele stelt in welk bouwpad (sinds dpkg 1.18.8) gebruikt moet
worden bij functionaliteit zoals \fBfixdebugpath\fR waardoor die gesuperviseerd
kan worden door het aanroepende programma. Momenteel is deze variabele
Debian\- en derivaat-specifiek.
.IP "\fB\s-1DPKG_COLORS\s0\fR" 4
.IX Item "DPKG_COLORS"
Stelt de kleurmodus in (sinds dpkg 1.18.5). Waarden die momenteel gebruikt
mogen worden zijn: \fBauto\fR (standaard), \fBalways\fR en \fBnever\fR.
.IP "\fB\s-1DPKG_NLS\s0\fR" 4
.IX Item "DPKG_NLS"
Indien dit ingesteld is, zal het gebruikt worden om te beslissen over het
activeren van moedertaalondersteuning, ook gekend als
internationaliseringsondersteuning (of i18n) (sinds dpkg 1.19.0). Geldige
waarden zijn: \fB0\fR and \fB1\fR (standaard).
.SH "BESTANDEN"
.IX Header "BESTANDEN"
.SS "Configuratiebestanden"
.IX Subsection "Configuratiebestanden"
.IP "\fB/etc/dpkg/buildflags.conf\fR" 4
.IX Item "/etc/dpkg/buildflags.conf"
Configuratiebestand dat voor het hele systeem geldt.
.IP "\fB\f(CB$XDG_CONFIG_HOME\fB/dpkg/buildflags.conf\fR of" 4
.IX Item "$XDG_CONFIG_HOME/dpkg/buildflags.conf of"
.PD 0
.IP "\fB\f(CB$HOME\fB/.config/dpkg/buildflags.conf\fR" 4
.IX Item "$HOME/.config/dpkg/buildflags.conf"
.PD
Configuratiebestand dat gebruikersafhankelijk is.
.SS "Ondersteuning bij het maken van een pakket"
.IX Subsection "Ondersteuning bij het maken van een pakket"
.IP "\fB/usr/share/dpkg/buildflags.mk\fR" 4
.IX Item "/usr/share/dpkg/buildflags.mk"
Makefile-fragment dat alle vlaggen die door \fBdpkg-buildflags\fR ondersteund
worden, laadt in variabelen (en eventueel exporteert) (sinds dpkg 1.16.1).
.SH "VOORBEELDEN"
.IX Header "VOORBEELDEN"
Om in een Makefile bouwvlaggen door te geven aan een bouwcommando:
.Sp
.Vb 1
\& $(MAKE) $(shell dpkg\-buildflags \-\-export=cmdline)
\&
\& ./configure $(shell dpkg\-buildflags \-\-export=cmdline)
.Ve
.PP
Om in een shell-script of shell-fragment bouwvlaggen in te stellen, kan
\&\fBeval\fR gebruikt worden om de uitvoer te interpreteren en de vlaggen in de
omgeving te exporteren:
.Sp
.Vb 1
\& eval "$(dpkg\-buildflags \-\-export=sh)" && make
.Ve
.PP
of om de positieparameters in te stellen die aan een commando doorgegeven
moeten worden:
.Sp
.Vb 2
\& eval "set \-\- $(dpkg\-buildflags \-\-export=cmdline)"
\& for dir in a b c; do (cd $dir && ./configure "$@" && make); done
.Ve
.SS "Het gebruik in debian/rules"
.IX Subsection "Het gebruik in debian/rules"
Om de benodigde bouwvlaggen te bekomen die aan het bouwsysteem doorgegeven
moeten worden, moet u vanuit het bestand \fBdebian/rules\fR \fBdpkg-buildflags\fR
aanroepen of \fBbuildflags.mk\fR invoegen. Merk op dat oudere versies van
\&\fBdpkg-buildpackage\fR (voor dpkg 1.16.1) deze vlaggen automatisch
exporteerden. U zou hierop echter niet mogen betrouwen, aangezien dit het
handmatig aanroepen van \fBdebian/rules\fR defect maakt.
.PP
Voor pakketten met een autoconf-achtig bouwsysteem, kunt u de relevante
opties rechtstreeks doorgeven aan configure of \fBmake\fR(1), zoals hiervoor
ge\(:illustreerd werd.
.PP
Voor andere bouwsystemen, of indien u een meer fijnmazige controle nodig
heeft over welke vlaggen waar doorgegeven worden, kunt u \fB\-\-get\fR
gebruiken. Of in de plaats daarvan kunt u \fBbuildflags.mk\fR invoegen, dat
zorgt voor het aanroepen van \fBdpkg-buildflags\fR en het opslaan van de
bouwvlaggen in variabelen voor make.
.PP
Indien u alle bouwvlaggen naar de omgeving wenst te exporteren (waar ze door
uw bouwsysteem opgepikt kunnen worden):
.Sp
.Vb 2
\& DPKG_EXPORT_BUILDFLAGS = 1
\& include /usr/share/dpkg/buildflags.mk
.Ve
.PP
Als u bijkomende controle wenst over wat ge\(:exporteerd wordt, kunt u de
variabelen handmatig exporteren (aangezien er standaard geen enkele
ge\(:exporteerd wordt):
.Sp
.Vb 2
\& include /usr/share/dpkg/buildflags.mk
\& export CPPFLAGS CFLAGS LDFLAGS
.Ve
.PP
En u kunt de vlaggen natuurlijk ook handmatig doorgeven aan commando's:
.Sp
.Vb 3
\& include /usr/share/dpkg/buildflags.mk
\& build\-arch:
\&        $(CC) \-o hello hello.c $(CPPFLAGS) $(CFLAGS) $(LDFLAGS)
.Ve