dpkg-buildflags

NAMN

dpkg-buildflags - returnerar byggflaggor att använda för att bygga paket

SYNOPS

dpkg-buildflags [flagga...] kommando

BESKRIVNING

dpkg-buildflags är ett verktyg för att hämta kompileringsflaggor att använda för att bygga Debianpaket. De förvalda flaggorna anges av leverantören, men de kan utökas/överstyras på flera sätt:

1.

på hela systemet med /etc/dpkg/buildflags.conf;

2.

för den nuvarande användaren med $XDG_CONFIG_HOME /dpkg/buildflags.conf där $XDG_CONFIG_HOME har standardvärdet $HOME/.config;

3.

temporärt av användaren med miljövariabler (se stycket MILJÖ).

4.

dynamiskt av paketansvariga med miljövariabler som sätts via debian/rules (se stycket MILJÖ).

Konfigurationsfilerna kan innehålla fyra sorters direktiv:

SET flagga värde

Överstyr flaggan flagga till att ha värdet värde.

STRIP flagga värde

Ta bort alla flaggor som listas i värde från flaggan som anges i flagga.

APPEND flagga värde

Utöka flaggan flagga genom att lägga till alternativen som anges i värde. Ett blanksteg läggs till före värdet om flaggans nuvarande värde inte är tomt.

PREPEND flagga värde

Utöka flaggan flagga genom att lägga till alternativen som anges i värde först. Ett blanksteg läggs till efter värdet om flaggans nuvarande värde inte är tomt.

Konfigurationsfilerna kan innehålla kommentarer på rader som börjar med ett nummertecken (#). Även tomma rader ignoreras.

KOMMANDON

--dump

Skriv alla kompileringsflaggor och deras värde på standard ut. En flagga skrivs per rad, avdelade från sitt värde med ett likamedtecken (” flagga=värde”). Detta är standardåtgärden.

--list

Skriv ut listan över flaggor som stöds av den aktuella leverantören (en per rad). Se stycket FLAGGOR SOM STÖDS för mer information om dem.

--status

Visa information som kan vara användbar för att förklara dpkg-buildflags beteende (sedan dpkg 1.16.5): relevanta miljövariabler, aktuell återförsäljare, status för alla funktionsflaggor. Skriv även ut slutgiltiga kompilatorflaggor och deras källa. Detta är tänkt att köras från debian/rules så att byggloggen innehåller ett tydligt spår över de använda byggflaggorna. Det kan vara användbart för att diagnostisera problem rörande dessa.

--export=format

Skriv kommandon som kan användas för att exportera alla kompileringsflaggor för något specifikt verktyg. Om format inte anges antas sh. Endast kompileringsflaggor som börjar med en stor bokstav tas med, andra antas att inte vara lämpliga för miljön. Format som stöds:

--get flagga

Skriv ut värdet på flaggan på standard ut. Avslutar med 0 om flaggan är känd, om inte avslutar den med 1.

--origin flagga

Anger ursprunget till flaggan som returneras av --get. Avslutar med 0 om flaggan är känd, om inte avslutar med 1. Ursprunget kan vara ett av följande värden:

--query

Srkiv ut information som kan vara användbar för att förklara programmets beteende: aktuell återförsäljare, relevanta miljövariabler, funktionsområden, status för alla funktionsflaggor, huruvida en funktion hanteras av ett inbyggt förval av kompilatorn (sedan dpkg 1.21.14) och kompilatorflaggorna med sina ursprung (sedan dpkg 1.19.0). Till exempel:

 Vendor: Debian
 Environment:
  DEB_CFLAGS_SET=-O0 -Wall
 Area: qa
 Features:
  bug=no
  canary=no
 Builtins:
 Area: hardening
 Features:
  pie=no
 Builtins:
  pie=yes
 Area: reproducible
 Features:
  timeless=no
 Builtins:
 Flag: CFLAGS
 Value: -O0 -Wall
 Origin: env
 Flag: CPPFLAGS
 Value: -D_FORTIFY_SOURCE=2
 Origin: vendor
    

--query-features område

Skriv ut funktioner aktiverade för ett givet område (sedan dpkg 1.16.2). Om funktionen hanteras (även om bara av några arkitekturer) som ett inbyggt förval av kompilatorn visas fältet Bultin (sedan dpkg 1.21.14). De enda för närvarande kända områdena på Debian och dess derivat är future, qa, reproducible, sanitize och hardening, se avsnittet FUNKTIONSOMRÅDEN för fler detaljer. Avslutar med 0 om området är känt, avslutar annars med 1. Utdata är på RFC822-headerformat, med en sektion per funktion. Till exempel:

 Feature: pie
 Enabled: yes
 Builtin: yes
 Feature: stackprotector
 Enabled: yes
    

--help

Visar hjälpskärm och avslutar.

--version

Visar version och avslutar.

FLAGGOR SOM STÖDS

ASFLAGS

Flaggor för assemblern. Förvalt värde: tomt. Sedan dpkg 1.21.0.

CFLAGS

Flaggor för C-kompilatorn. Standardvärdet som satts av leverantören innehåller -g och den förvalda optimeringsnivån (vanligtvis -O2, eller -O0 om miljövariabeln DEB_BUILD_OPTIONS definierar noopt).

CPPFLAGS

Flaggor för C-förprocesseraren. Förvalt värde: tomt.

CXXFLAGS

Flaggor för C++-kompilatorn. Samma som CFLAGS.

OBJCFLAGS

Flaggor för Objective C-kompilatorn. Samma som CFLAGS.

OBJCXXFLAGS

Flaggor för Objective C++-kompilatorn. Samma som CFLAGS.

GCJFLAGS

Flaggor för GNU Java-kompilatorn (gcj). En delmängd av CFLAGS.

DFLAGS

Flaggor för D-kompilatorn (ldc eller gdc). Sedan dpkg 1.20.6.

FFLAGS

Flaggor för Fortran 77-kompilatorn. En delmängd av CFLAGS.

FCFLAGS

Flaggor för Fortran 9x-kompilatorn. Samma som FFLAGS.

LDFLAGS

Flaggor som sänds till kompilatorn vid länkning av binärer eller delade objekt (om länkaren anropas direkt måste -Wl och , tas bort från dessa flaggor). Standardvärde: tomt.

Nya flaggor kan komma att läggas till i framtiden om behovet uppstår (till exempel för att stöda andra språk).

FUNKTIONSOMRÅDEN

Varje områdesfunktion kan aktiveras och inaktiveras i områdesvärdet i miljövariablerna DEB_BUILD_OPTIONS och DEB_BUILD_MAINT_OPTIONS modifierarna ”+” och ” -”. Till exempel, för att aktivera hardening-funktionen ”pie” och inaktivera funktionen ”fortify” genom att ange detta i debian/rules:

    export DEB_BUILD_MAINT_OPTIONS=hardening=+pie,-fortify

Den speciella funktionen all kan användas för att aktivera eller inaktivera alla områdesfunktioner samtidigt. Du kan till exempel inaktivera allt i området hardening och endast aktivera ”format” och ”fortify” med:

    export DEB_BUILD_MAINT_OPTIONS=hardening=-all,+format,+fortify

future

Flera kommandoradsflaggor (beskrivna nedan) kan användas för att aktivera funktioner som borde vara aktiverade som standard, men som inte kan vara det på grund av bakåtkompatibilitetsorsaker.

lfs

Den här inställningen (inaktiverad som förval) aktiverar stöd för stora filer på 32-bitars-arkitekturer där deras ABI inte som förval inkluderar LFS, genom att lägga till -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 till CPPFLAGS.

qa

Flera kommandoradsflaggor (beskrivna nedan) kan användas för att göra det lättare att hitta problem i källkoden eller byggsystemet.

bug

Inställningen (inaktiverad som förval) lägger till ytterligare varningar som pålitligt upptäcket problematisk källkod. Varningarna är ödesdigra. De enda flaggor som för närvarande stöds är CFLAGS och CXXFLAGS med flaggorna satt till -Werror=array-bounds, -Werror=clobbered, -Werror=implicit-function-declaration och -Werror=volatile-register-var.

canary

Den här inställningen (inaktiverad som förval) lägger till overksamma tjallarflaggor till byggflaggorna, så att byggloggarna kan kontrolleras för att se hur byggflaggor vidarebefordras för att göra det enklare att hitta när vanliga byggflagor utesluts. De enda flaggor som stöds är för närvarande CPPFLAGS, CFLAGS, OBJCFLAGS, CXXFLAGS och OBJCXXFLAGS med flaggorna satta till -D__DEB_CANARY_flag_slumpmässigt-id __, och LDFLAGS satt till -Wl,-z,deb-canary-slumpmässigt-id.

optimize

Flera kommandoradsflaggor (beskrivna nedan) kan användas för att hjälpa till att optimera den skapade binären (sedan dpkg 1.21.0). Observera: om all aktiveras kan dessa flaggor leda till binärartifakter som inte kan reproduceras.

lto

Inställningen (sedan dpkg 1.2.0; inaktiverad som förval) aktiverar Link Time Optimization (optimering vid länkning) genom att lägga till -flto=auto -ffat-lto-objects till CFLAGS, CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, GCJFLAGS, FFLAGS, FCFLAGS och LDFLAGS.

sanitize

Du kan använda flera kompileringsflaggor (se detaljer nedan) för att sanera den färdiga binären mot minnesfördärvningsar, minnesläckor, användning efter frigivning, datakapplöpningsfel i trådar och fel i förbindels med odefinierat beteende. Observera: dessa flaggor bör inte användas för produktionsbygg eftersom de kan minska pålitligheten för korrekt kod, minska säkerheten eller till och med funktionsrikedomen.

address

Den här inställningen (inaktiverad som förval) lägger till -fsanitize=address till LDFLAGS och -fsanitize=address -fno-omit-frame-pointer till CFLAGS och CXXFLAGS.

thread

Den här inställningen (inaktiverad som förval) lägger till -fsanitize=thread till CFLAGS, CXXFLAGS och LDFLAGS.

leak

Den här inställningen (inaktiverad som förval) lägger till -fsanitize=leak till LDFLAGS. Den inaktiveras automatiskt om antingen funktionen address eller thread aktiveras, eftersom de implicerar den.

undefined

Den här inställningen (inaktiverad som förval) lägger till -fsanitize=undefined till CFLAGS, CXXFLAGS och LDFLAGS.

hardening

Du kan använda flera kompileringsflaggor (se detaljer nedan) för att härda den färdiga binären mot minnesfördärvningsangrepp, eller för att ge ytterligare varningsmeddelanden under kompileringen. Förutom det som anges nedan aktiveras dessa som standard för arkitekturer som stöder dem.

format

Inställningen (aktiverad som förval) lägger till -Wformat -Werror=format-security till CFLAGS, CXXFLAGS, OBJCFLAGS och OBJCXXFLAGS. Detta kommer att varna om olämplig användning av formatsträngar, och att misslyckas när formatfunktionerna används på ett sätt som representerar möjliga säkerhetsproblem. För närvarande varnar detta om anrop till funktionerna printf och scanf där formatsträngen inte är en fast sträng och när det inte finns några formatargument, som i printf(foo); istället för printf("%s", foo); Detta kan vara ett säkerhetshål om formatsträngen kommer från en obetrodd källa och innehåller ”%n”.

fortify

Inställningen (aktiverad som förval) lägger till -D_FORTIFY_SOURCE=2 till CPPFLAGS. Kompilatorn har under kodgenereringen kännedom om en hel del information om buffertstorlekar (där tillämpligt) och försöker ersätta osäkra funktionsanrop med obegränsade buffertlängder med längdbegränsade dito. Det här är speciellt användbart för gammal, skräpig kod. Dessutom blockeras formatsträngar i skrivbart minne som innehåller ”%n”. Om ett program är beroende av en sådan formatsträng måste det gås runt i kod. Observera att för att den här flaggan ska ha någon funktion måste källkoden också kompileras med -O1 eller högre. Om miljövariabeln DEB_BUILD_OPTIONS innehåller noopt kommer stödet för fortify att inaktiverats, på grund av nya varningar som ges av glibc 2.16 och senare.

stackprotector

Inställningen (aktiverad som förval om stackprotectorstrong inte används) lägger till -fstack-protector --param=ssp-buffer-size=4 till CFLAGS, CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, GCJFLAGS, FFLAGS och FCFLAGS. Detta lägger till säkerhetskontroller mot stacköverskrivningar, vilket gör att många möjliga kodinjiceringsangrepp istället avbryter programmet. I det bästa fallet gör det kodinjiceringsangrepp till överbelastnignsangrepp eller icke-problem (beroende på programmet). Den här funktionen kräver länkning mot glibc (eller ett annat bibliotek som tillhandahåller __stack_chk_fail), så det måste inaktiveras när du bygger med -nostdlib eller -ffreestanding eller liknande.

stackprotectorstrong

Inställningen (aktiverad som förval) lägger till -fstack-protector-strong till CFLAGS, CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, GCJFLAGS, FFLAGS och FCFLAGS. Detta är en starkare variant av stackprotector, men utan markanta prestandaminskningar. Om du inaktiverar stackprotector inaktiveras även denna inställning. Funktionen har samma krav som stackprotector, och kräver dessutom gcc 4.9 eller senare.

relro

Inställningen (aktiverad som förval) lägger till -Wl,-z,relro till LDFLAGS. Vid inläsning av programmet måste länkaren skriva till flera ELF-minnessektioner. Den här inställningen flaggar till inläsaren att dessa sektioner ska göras skrivskyddade innan programmet får kontroll. Detta skyddar huvudsaklingen mot GOT-överskrivningsangrepp. Om inställningen inaktiveras kommer även bindnow att inaktiveras.

bindnow

Inställningen (inaktiverad som förval) lägger till -Wl,-z,bindnow till LDFLAGS. Vid inläsning av programmet löses alla dynamiska symboler, vilket gör att hela PLT kan markeras som skrivskyddad (på grund av relro ovan). Inställningen kan inte aktiveras om relro inte är aktiverad.

pie

Den här inställningen (utan globalt förval sedan dpkg 1.18.23, eftersom den aktiveras som förval numera av gcc på Debianarkitekturerna amd64, arm64, armel, armhf, hurd-i386, i386, kfreebsd-amd64, kfreebsd-i386, mips, mipsel, mips64el, powerpc, ppc64, ppc64el, riscv64, s390x, sparc och sparc64) lägger till de flaggor som krävs för att aktivera eller inaktivera PIE via gcc-specifikationsfiler, om det behövs, beroende på om gcc lägger till flaggorna själv på arkitekturen eller inte. Om inställningen aktiveras och gcc injicerar flaggorna lägger den inte till Någonting. Om inställningen är aktiverad och gcc inte injicerar flaggorna, lägger den till -fPIE (via /usr/share/dpkg/pie-compiler.specs) till CFLAGS, CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, GCJFLAGS, FFLAGS och FCFLAGS, och -fPIE -pie (via /usr/share/dpkg/pie-link.specs) till LDFLAGS. När inställningen är inaktiverad och gcc injicerar flaggorna, lägger den till -fno-PIE (via /usr/share/dpkg/no-pie-compile.specs) to CFLAGS, CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, GCJFLAGS, FFLAGS till FCFLAGS, och -fno-PIE -no-pie (via /usr/share/dpkg/no-pie-link.specs) till LDFLAGS. Positionsoberoende exekverbara program (PIE) behövs för att dra fördel av slumpmässig adressrymd (ASLR), vilket stöds av vissa versioner av kärnan. Medan ASLR redan kan användas för datautrymmen i stacken och heap:en (brk och mmap), måste kodområden först kompileras som positionsoberoende. Delade bibliotek gör redan detta (-fPIC), så de drar automatiskt fördel av ASLR medan binära .text-regioner måste byggas med PIE för att uppnå ASLR. När detta sker är ROP-angrepp (Return Oriented Programming) mycket svårare eftersom det inte finns några statiska platser att studsa från i ett minnesfördärvningsangrepp. PIE är inte kompatibelt med -fPIC, så allmän försiktighet måste tas vid bygge av delade objekt. Men eftersom PIE-flaggorna som skapas injiceras via gcc-specifikationsfiler bör det alltid vara säkert att ovillkorligen sätta dem oberoende av typen av objekt som kompileras eller länkas. Statiska bibliotek kan användas av program eller andra delade bibliotek. Beroende på vilka flaggor som används för att kompilera objekten inuti ett statisk bibliotek kan dessa vara användas av olika uppsättningar objekt:

reproducible

Kompileringsflaggorna som anges nedan kan användas för att göra det lättare att reproducera byggbarhet eller tillhandahålla ytterligare varningsflaggor under kompileringen. Förutom det som anges nedan aktiveras dessa som standard för arkitekturer som stöder dem.

timeless

Inställningen (aktiverad som förval) lägger till -Wdate-time till CPPFLAGS. Detta ger varningar när makrona __TIME__, __DATE__ eller __TIMESTAMP__ används.

fixfilepath

Inställningen (aktiverad som förval) lägger till -ffile-prefix-map=BYGGSÖKVÄG =. till CFLAGS, CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, GCJFLAGS, FFLAGS och FCFLAGS där BYGGSÖKVÄG. Detta får till effekt att byggsökvägen försvinner från alla genererade filer. Om både fixdebugpath och fixfilepath anges tar denna flagga företräde, eftersom den är en övermängd av den förstnämnda.

fixdebugpath

Inställningen (aktiverad som förval) lägger till -fdebug-prefix-map=BYGGSÖKVÄG =. till till CFLAGS, CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, GCJFLAGS, FFLAGS och FCFLAGS. Detta får till effekt att byggsökvägen försvinner från alla genererade felsökningssymboler.

MILJÖVARIABLER

Det finns två uppsättningar miljövariabler som utför samma operationer, den första (DEB_ flagga_op) bör aldrig användas inuti debian/rules). Den är tänkt för användare som vill bygga om källkodspaketet med andra byggflaggor. Den andra uppsättningen (DEB_ flagga_MAINT_op) bör endast användas i debian/rules av paketansvariga för att ändra de slutgiltiga byggflaggorna.

DEB_flagga_SET

DEB_flagga_MAINT_SET

Denna variabel kan användas för att tvinga fram värdet som returneras för given flagga.

DEB_flagga_STRIP

DEB_flagga_MAINT_STRIP

Denna variabel kan användas för att tillhandahålla en blankstegsavdelad lista med flaggor som kommer att tas bort från uppsättningen flaggor som ges för given flagga.

DEB_flagga_APPEND

DEB_flagga_MAINT_APPEND

Denna variabel kan användas för att lägga till ytterligare flaggor till värdet som returneras för given flagga.

DEB_flagga_PREPEND

DEB_flagga_MAINT_PREPEND

Denna variabel kan användas för att lägga till ytterligare flaggor först i värdet som returneras för given flagga.

DEB_BUILD_OPTIONS

DEB_BUILD_MAINT_OPTIONS

De här variablerna kan användas av en användare eller utvecklare för att slå av/på olika områdesfunktioner som påverkar byggflaggorna. Variabeln DEB_BUILD_MAINT_OPTIONS-variabeln överstyr alla inställningar i funktionsområden i DEB_BUILD_OPTIONS. Se avsnittet FUNKTIONSOMRÅDEN för mer information.

DEB_VENDOR

Inställningen anger den aktuella återförsäljaren. Om den inte är satt kommer återförsäljaren att identifieras genom att läsa /etc/dpkg/origins/default.

DEB_BUILD_PATH

Den här variabeln anger byggsökvägen (sedan dpkg 1.18.8) att använda i funktioner såsom fixdebugpath så att de kan styras av anroparen. Variabeln är för närvarande specifik för Debian och dess derivat.

DPKG_COLORS

Väljer färgläge (sedan dpkg 1.18.5). För närvarande godtas följande värden: auto (förval), always och never.

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: 0 och 1 (förval).

FILER

Konfigurationsfiler

/etc/dpkg/buildflags.conf

Konfigurationsfil för hela systemet.

$XDG_CONFIG_HOME/dpkg/buildflags.conf eller

$HOME/.config/dpkg-buildflags.conf

Användarens konfigurationsfil.

Paketeringsstöd

/usr/share/dpkg/buildflags.mk

Makefile-klipp som läser in (och eventuellt exporterar) alla flaggor som stöd av dpkg-buildflags till variabler (sedan dpkg 1.16.1).

EXEMPEL

För att sända byggflaggor till en byggkommandorad i en makefil:

 $(MAKE) $(shell dpkg-buildflags --export=cmdline)
 ./configure $(shell dpkg-buildflags --export=cmdline)

För att sätta byggflaggor i ett skalskript eller skalfragment kan eval användas för att tolka utdata och exportera flaggorna i miljön:

 eval "$(dpkg-buildflags --export=sh)" && make

eller för att sätta positionsparametrarna för att sända till ett kommando:

 eval "set -- $(dpkg-buildflags --export=cmdline)"
 for dir in a b c; do (cd $dir && ./configure "$@" && make); done

Använda i debian/rules

Du bör anropa dpkg-buildflags eller inkludera buildflags.mk från filen debian/rules för att hämta de byggflaggor det är nödvändigt att sända till byggsystemet. Observera att äldre versioner av dpkg-buildpackages (före dpkg 1.16.1) exporterade dessa flaggor automatiskt. Du bör dock inte bero på detta, eftersom detta förhindrar körning av debian/rules manuellt. För paket med autoconf-liknande byggsystem kan du sända relevanta flaggor direkt till configure eller make(1), som visas ovan. I andra byggsystem, eller om du vill ha mer finkorning styrning av vilka flaggor som sänds vart, kan du använda --get. Eller så kan du istället inkludera buildflags.mk, som tar hand om anropet till dpkg-buildflags och lagringen av byggflaggorna i make-variabler. Om du vill exportera alla byggflaggor till miljön (där de kan fångas upp av ditt byggsystem):

 DPKG_EXPORT_BUILDFLAGS = 1
 include /usr/share/dpkg/buildflags.mk

För extra styrning av vad som expoteras kan du manuellt exportera variablerna (eftersom inga av dem exporteras som standard):

 include /usr/share/dpkg/buildflags.mk
 export CPPFLAGS CFLAGS LDFLAGS

Du kan naturligtvis dessutom manuellt sända flaggorna till kommandon:

 include /usr/share/dpkg/buildflags.mk
 build-arch:
        $(CC) -o hello hello.c $(CPPFLAGS) $(CFLAGS) $(LDFLAGS)

ÖVERSÄTTNING

Peter Krefting och Daniel Nylander.