.\" 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 "NOME"
.IX Header "NOME"
dpkg-buildflags \- retorna flags de compila\(,c\(~ao para usar durante a compila\(,c\(~ao
de pacotes
.SH "SINOPSE"
.IX Header "SINOPSE"
\&\fBdpkg-buildflags\fR [\fIoption\fR...] [\fIcommand\fR]
.SH "DESCRI\(,C\(~AO"
.IX Header "DESCRI\(,C\(~AO"
\&\fBdpkg-buildflags\fR \('e uma ferramenta para obter flags de compila\(,c\(~ao para usar
durante a compila\(,c\(~ao de pacotes Debian.
.PP
As flags predefinidas s\(~ao definidas pelo fornecedor mas podem ser
estendidas/sobrepostas de v\('arias maneiras:
.IP "1." 4
de todo o sistema com \fB/etc/dpkg/buildflags.conf\fR;
.IP "2." 4
para o utilizador actual com \fB\f(CB$XDG_CONFIG_HOME\fB/dpkg/buildflags.conf\fR onde
\&\fB\f(CB$XDG_CONFIG_HOME\fB\fR usa por predefini\(,c\(~ao \fB\f(CB$HOME\fB/.config\fR;
.IP "3." 4
temporariamente pelo utilizador com vari\('aveis de ambiente (veja a sec\(,c\(~ao
\&\fB\s-1AMBIENTE\s0\fR);
.IP "4." 4
dinamicamente pelo maintainer do pacote com vari\('aveis de ambiente definidas
via \fBdebian/rules\fR (veja a sec\(,c\(~ao \fB\s-1AMBIENTE\s0\fR).
.PP
Os ficheiros de configura\(,c\(~ao podem conter quatro tipos de directivas:
.IP "\fB\s-1SET\s0\fR \fIflag value\fR" 4
.IX Item "SET flag value"
Sobrescreve a flag chamada \fIflag\fR para ter o valor \fIvalor\fR.
.IP "\fB\s-1STRIP\s0\fR \fIflag value\fR" 4
.IX Item "STRIP flag value"
Despoja da flag chamada \fIflag\fR todas as flags de compila\(,c\(~ao listadas em
\&\fIvalor\fR.
.IP "\fB\s-1APPEND\s0\fR \fIflag value\fR" 4
.IX Item "APPEND flag value"
Estende a flag chamada \fIflag\fR ao acrescentar as op\(,c\(~oes dadas em \fIvalor\fR. \('E
usado um espa\(,co a preceder o valor acrescentado se o valor da flag actual
n\(~ao estiver vazio.
.IP "\fB\s-1PREPEND\s0\fR \fIflag value\fR" 4
.IX Item "PREPEND flag value"
Estende a flag chamada \fIflag\fR ao preced\(^e\-la com as op\(,c\(~oes dadas em
\&\fIvalor\fR. \('E acrescentado um espa\(,co ao valor precedido se o valor da flag
actual n\(~ao estiver vazio.
.PP
Os ficheiros de configura\(,c\(~ao podem conter coment\('arios nas linhas que come\(,cam
com um cardinal (#). As linhas vazias tamb\('em s\(~ao ignoradas.
.SH "COMANDOS"
.IX Header "COMANDOS"
.IP "\fB\-\-dump\fR" 4
.IX Item "--dump"
Escreve na sa\('ida standard todas as bandeiras de compila\(,c\(~ao e os seus
valores. Escreve uma bandeira por linha separada do seu valor por um sinal
de igual ("\fIflag\fR=\fIvalue\fR"). Esta \('e a ac\(,c\(~ao predefinida.
.IP "\fB\-\-list\fR" 4
.IX Item "--list"
Escreve a lista das flags suportadas pelo fornecedor actual (uma por cada
linha). Veja a sec\(,c\(~ao \fB\s-1FLAGS SUPORTADAS\s0\fR para mais informa\(,c\(~ao sobre elas.
.IP "\fB\-\-status\fR" 4
.IX Item "--status"
Mostra qualquer informa\(,c\(~ao que possa ser \('util para explicar o comportamento
de \fBdpkg-buildflags\fR (desde dpkg 1.16.5): vari\('aveis de ambiente relevantes,
fornecedor actual, estado de todas as bandeiras de funcionalidades. Tamb\('em
escreve as bandeira de compila\(,c\(~ao resultantes com as suas origens.
.Sp
Isto destina-se a ser corrido a partir de \fBdebian/rules\fR, para que os
relat\('orios de compila\(,c\(~ao mantenham um rasto claro das bandeiras de
compila\(,c\(~ao usadas. Isto pode ser \('util para diagnosticar problemas
relacionados com elas.
.IP "\fB\-\-export=\fR\fIformat\fR" 4
.IX Item "--export=format"
Escreve na sa\('ida standard comandos que podem ser usados para exportar todas
as bandeiras de compila\(,c\(~ao para alguma ferramenta particular. Se o valor
\&\fIformat\fR n\(~ao for fornecido, \('e assumido \fBsh\fR. Apenas s\(~ao inclu\('idas
bandeiras que comecem com um caractere mai\('usculo, as outras s\(~ao assumidas
como n\(~ao apropriadas para o ambiente. Formatos suportados:
.RS 4
.IP "\fBsh\fR" 4
.IX Item "sh"
Comandos de shell para definir e exportar todas as bandeiras de compila\(,c\(~ao
no ambiente. Os valores das bandeiras s\(~ao citados para que o resultado
esteja pronto para avalia\(,c\(~ao pela shell.
.IP "\fBcmdline\fR" 4
.IX Item "cmdline"
Argumentos a passar para a linha de comandos dos programas de compila\(,c\(~ao
para se usar todas as bandeiras de compila\(,c\(~ao (desde dpkg 1.17.0). Os
valores das bandeiras s\(~ao citados na sintaxe da shell.
.IP "\fBconfigure\fR" 4
.IX Item "configure"
Este \('e um nome alternativo antigo para \fBcmdline\fR.
.IP "\fBmake\fR" 4
.IX Item "make"
Faz as directivas definir e exportar todas as bandeiras de compila\(,c\(~ao no
ambiente. O resultado pode ser escrito para o fragmento do Makefile e
avaliado usando uma directiva \fBinclude\fR.
.RE
.RS 4
.RE
.IP "\fB\-\-get\fR \fIflag\fR" 4
.IX Item "--get flag"
Escreve o valor da flag na sa\('ida standard. Termina com 0 se a flag for
conhecida, caso contr\('ario termina com 1.
.IP "\fB\-\-origin\fR \fIflag\fR" 4
.IX Item "--origin flag"
Escreve a origem do valor que \('e devolvido por \fB\-\-get\fR. Termina com 0 se a
flag for conhecida, caso contr\('ario termina com 1. A origem pode ser um dos
seguintes valores:
.RS 4
.IP "\fBvendor\fR" 4
.IX Item "vendor"
\('e devolvida a flag origina definida pelo fornecedor;
.IP "\fBsystem\fR" 4
.IX Item "system"
a flag \('e definida/modifica por uma configura\(,c\(~ao de todo o sistema;
.IP "\fBuser\fR" 4
.IX Item "user"
a flag \('e definida/modifica por uma configura\(,c\(~ao espec\('ifica do utilizador;
.IP "\fBenv\fR" 4
.IX Item "env"
a flag \('e definida/modifica por uma configura\(,c\(~ao espec\('ifica do ambiente;
.RE
.RS 4
.RE
.IP "\fB\-\-query\fR" 4
.IX Item "--query"
Escreve qualquer informa\(,c\(~ao que possa ser \('util para explicar o comportamento
do programa: fornecedor actual, vari\('aveis de ambiente relevantes, \('areas de
funcionalidades, estada das bandeiras de funcionalidades, e as bandeiras de
compila\(,c\(~ao com as suas origens (desde dpkg 1.19.0).
.Sp
Por exemplo:
.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 \fIarea\fR" 4
.IX Item "--query-features area"
Escreve as funcionalidades activadas para uma dada \('area (desde dpkg
1.16.2). As \('unicas \('areas actualmente reconhecidas em Debian e derivados s\(~ao
\&\fBfuture\fR, \fBqa\fR, \fBreproducible\fR, \fBsanitize\fR e \fBhardening\fR, veja a sec\(,c\(~ao
\&\fB\('AREAS \s-1DE\s0 CARACTER\('ISTICAS\fR para mais detalhes. Termina com 0 se a \('area \('e
conhecida caso contr\('ario termina com 1.
.Sp
O resultado est\('a em formato \s-1RFC822,\s0 com uma sec\(,c\(~ao por caracter\('istica. Por
exemplo:
.Sp
.Vb 2
\& Feature: pie
\& Enabled: yes
\&
\& Feature: stackprotector
\& Enabled: yes
.Ve
.IP "\fB\-\-help\fR" 4
.IX Item "--help"
Mostra a mensagem de utiliza\(,c\(~ao e termina.
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
Mostra a vers\(~ao e termina.
.SH "FLAGS SUPORTADAS"
.IX Header "FLAGS SUPORTADAS"
.IP "\fB\s-1CFLAGS\s0\fR" 4
.IX Item "CFLAGS"
Op\(,c\(~oes para o compilador de C. O valor predefinido regulado pelo fornecedor
inclui \fB\-g\fR e o n\('ivel de optimiza\(,c\(~ao predefinido (geralmente \fB\-O2\fR, ou
\&\fB\-O0\fR se a vari\('avel de ambiente \fB\s-1DEB_BUILD_OPTIONS\s0\fR definir \fInoopt\fR).
.IP "\fB\s-1CPPFLAGS\s0\fR" 4
.IX Item "CPPFLAGS"
Op\(,c\(~oes para o pr\('e\-processador de C. Valor predefinido: vazio.
.IP "\fB\s-1CXXFLAGS\s0\fR" 4
.IX Item "CXXFLAGS"
Op\(,c\(~oes para o compilador de \*(C+. O mesmo que \fB\s-1CFLAGS\s0\fR.
.IP "\fB\s-1OBJCFLAGS\s0\fR" 4
.IX Item "OBJCFLAGS"
Op\(,c\(~oes para o compilador Objective C. O mesmo que \fB\s-1CFLAGS\s0\fR.
.IP "\fB\s-1OBJCXXFLAGS\s0\fR" 4
.IX Item "OBJCXXFLAGS"
Op\(,c\(~oes para o compilador Objective \*(C+. O mesmo que \fB\s-1CXXFLAGS\s0\fR.
.IP "\fB\s-1GCJFLAGS\s0\fR" 4
.IX Item "GCJFLAGS"
Op\(,c\(~oes para o compilador de Java do \s-1GNU\s0 (gcj). Um subconjunto de \fB\s-1CFLAGS\s0\fR.
.IP "\fB\s-1DFLAGS\s0\fR" 4
.IX Item "DFLAGS"
Op\(,c\(~oes para o compilador D (ldc ou gdc). Desde dpkg 1.20.6.
.IP "\fB\s-1FFLAGS\s0\fR" 4
.IX Item "FFLAGS"
Op\(,c\(~oes para o compilador Fortran 77. Um subconjunto de \fB\s-1CFLAGS\s0\fR.
.IP "\fB\s-1FCFLAGS\s0\fR" 4
.IX Item "FCFLAGS"
Op\(,c\(~oes para o compilador Fortran 9x. O mesmo que \fB\s-1FFLAGS\s0\fR.
.IP "\fB\s-1LDFLAGS\s0\fR" 4
.IX Item "LDFLAGS"
Op\(,c\(~oes passadas ao compilador quando faz link a execut\('aveis ou objetos
partilhados (se o vinculador (linker) for chamado directamente, ent\(~ao \fB\-Wl\fR
e \fB,\fR t\(^em de ser cortados destas op\(,c\(~oes). Valor predefinido: empty.
.PP
Podem ser adicionadas novas bandeiras no futuro se a necessidade surgir (por
exemplo para suportar outras linguagens).
.SH "\('AREAS DE CARACTER\('ISTICAS"
.IX Header "\('AREAS DE CARACTER\('ISTICAS"
Cada funcionalidade de \('area pode ser activada ou desactivada no valor da
\('area das vari\('aveis de ambiente \fB\s-1DEB_BUILD_OPTIONS\s0\fR e
\&\fB\s-1DEB_BUILD_MAINT_OPTIONS\s0\fR com o modificador \(oq\fB+\fR\(cq e \(oq\fB\-\fR\(cq. Por exemplo,
par activar a funcionalidade \*(L"pie\*(R" de \fBhardening\fR e desactivar a
funcionalidade \(lqfortify\(rq voc\(^e pode fazer isto em \fBdebian/rules\fR:
.PP
.Vb 1
\&    export DEB_BUILD_MAINT_OPTIONS=hardening=+pie,\-fortify
.Ve
.PP
A funcionalidade especial \fBall\fR (v\('alida em qualquer \('area) pode ser usada
para activar ou desactivar todas as funcionalidades de \('area ao mesmo
tempo. Assim desactivar tudo na \('area \fBhardening\fR e activar apenas apenas
\(lqformat\(rq e \(lqfortify\(rq pode ser obtido com:
.PP
.Vb 1
\&    export DEB_BUILD_MAINT_OPTIONS=hardening=\-all,+format,+fortify
.Ve
.SS "future"
.IX Subsection "future"
V\('arias op\(,c\(~oes de tempo de compila\(,c\(~ao (detalhado em baixo) podem ser usadas
para activar funcionalidades que deveria estar activadas por predefini\(,c\(~ao,
mas n\(~ao podem estar por raz\(~oes de compatibilidade com vers\(~oes anteriores.
.IP "\fBlfs\fR" 4
.IX Item "lfs"
Esta defini\(,c\(~ao (desactivada por predefini\(,c\(~ao) activa Suporte Ficheiros
Longos em arquitecturas de 32\-bit onde o seu \s-1ABI\s0 n\(~ao inclui \s-1LFS\s0 (Large File
Support) por predefini\(,c\(~ao, ao adicionar \fB\-D_LARGEFILE_SOURCE
\&\-D_FILE_OFFSET_BITS=64\fR a \fB\s-1CPPFLAGS\s0\fR.
.SS "qa"
.IX Subsection "qa"
V\('arias op\(,c\(~oes de tempo de compila\(,c\(~ao (detalhado em baixo) podem ser usadas
para ajudar a detectar no c\('odigo fonte ou no sistema de compila\(,c\(~ao.
.IP "\fBbug\fR" 4
.IX Item "bug"
Esta defini\(,c\(~ao (desactivada por predefini\(,c\(~ao) adiciona qualquer op\(,c\(~ao de
aviso de detec\(,c\(~ao de fiabilidade problem\('atica no c\('odigo fonte. Os avisos s\(~ao
fatais. As \('unicas bandeiras presentemente suportadas s\(~ao \fB\s-1CFLAGS\s0\fR e
\&\fB\s-1CXXFLAGS\s0\fR com bandeiras definidas para \fB\-Werror=array\-bounds\fR,
\&\fB\-Werror=clobbered\fR, \fB\-Werror=implicit\-function\-declaration\fR e
\&\fB\-Werror=volatile\-register\-var\fR.
.IP "\fBcanary\fR" 4
.IX Item "canary"
Esta defini\(,c\(~ao (desactivada por predefini\(,c\(~ao) adiciona op\(,c\(~oes canary
fantoches \(`as bandeiras de compila\(,c\(~ao, para que os relat\('orios de compila\(,c\(~ao
possam ser verificados em como as bandeiras de compila\(,c\(~ao de propagam e para
permitir encontrar qualquer omiss\(~ao de defini\(,c\(~oes normais de bandeiras de
compila\(,c\(~ao. As \('unicas bandeiras actualmente suportadas s\(~ao \fB\s-1CPPFLAGS\s0\fR,
\&\fB\s-1CFLAGS\s0\fR, \fB\s-1OBJCFLAGS\s0\fR, \fB\s-1CXXFLAGS\s0\fR e \fB\s-1OBJCXXFLAGS\s0\fR com bandeiras
definidas para \fB\-D_\|_DEB_CANARY_\fR\fIflag\fR_\fIrandom-id\fR\fB_\|_\fR, e \fB\s-1LDFLAGS\s0\fR
definida para \fB\-Wl,\-z,deb\-canary\-\fR\fIrandom-id\fR.
.SS "sanitize"
.IX Subsection "sanitize"
V\('arias op\(,c\(~oes de tempo de compila\(,c\(~ao (detalhado em baixo) podem ser usadas
para ajudar a higienizar um bin\('ario resultante contra corrup\(,c\(~oes de mem\('oria,
fugas de mem\('oria, utiliza\(,c\(~ao ap\('os livre, segmenta\(,c\(~ao de dados e bugs de
comportamento indefinido.  \fBNota\fR: estas op\(,c\(~oes \fBn\(~ao\fR devem ser usadas
para compila\(,c\(~oes de produ\(,c\(~ao pois elas podem reduzir a confian\(,ca na
conformidade do c\('odigo, reduzir a seguran\(,ca ou mesmo a funcionalidade.
.IP "\fBaddress\fR" 4
.IX Item "address"
Esta defini\(,c\(~ao (desactivada por predefini\(,c\(~ao) adiciona \fB\-fsanitize=address\fR
a \fB\s-1LDFLAGS\s0\fR e \fB\-fsanitize=address \-fno\-omit\-frame\-pointer\fR a \fB\s-1CFLAGS\s0\fR e
\&\fB\s-1CXXFLAGS\s0\fR.
.IP "\fBthread\fR" 4
.IX Item "thread"
Esta defini\(,c\(~ao (desactivada por predefini\(,c\(~ao) adiciona \fB\-fsanitize=thread\fR
a \fB\s-1CFLAGS\s0\fR, \fB\s-1CXXFLAGS\s0\fR e \fB\s-1LDFLAGS\s0\fR.
.IP "\fBleak\fR" 4
.IX Item "leak"
Esta defini\(,c\(~ao (desactivada por predefini\(,c\(~ao) adiciona \fB\-fsanitize=leak\fR a
\&\fB\s-1LDFLAGS\s0\fR. fica automaticamente desactivada se as funcionalidades
\&\fBaddress\fR ou \fBthread\fR estiverem activas, pois elas j\('a implicam isto.
.IP "\fBundefined\fR" 4
.IX Item "undefined"
Esta defini\(,c\(~ao (desactivada por predefini\(,c\(~ao) adiciona
\&\fB\-fsanitize=undefined\fR a \fB\s-1CFLAGS\s0\fR, \fB\s-1CXXFLAGS\s0\fR e \fB\s-1LDFLAGS\s0\fR.
.SS "endurecimento"
.IX Subsection "endurecimento"
V\('arias op\(,c\(~oes de tempo de compila\(,c\(~ao (detalhado em baixo) podem ser usadas
para ajudar a endurecer um bin\('ario resultante contra ataques de corrup\(,c\(~ao de
mem\('oria, ou disponibilizar mensagens de aviso adicionais durante a
compila\(,c\(~ao. Excepto como notado em baixo, estas est\(~ao activadas por
predefini\(,c\(~ao para as arquitecturas que as suportam.
.IP "\fBformat\fR" 4
.IX Item "format"
Esta defini\(,c\(~ao (activada por predefini\(,c\(~ao) adiciona \fB\-Wformat
\&\-Werror=format\-security\fR a \fB\s-1CFLAGS\s0\fR, \fB\s-1CXXFLAGS\s0\fR, \fB\s-1OBJCFLAGS\s0\fR e
\&\fB\s-1OBJCXXFLAGS\s0\fR.  Isto ir\('a avisar sobre uso de strings de formato impr\('oprias,
e ir\('a falhar quando fun\(,c\(~oes de formato forem usadas em modo que representem
poss\('iveis problemas de seguran\(,ca. Presentemente, isto avisa sobre chamadas a
fun\(,c\(~oes \fBprintf\fR e \fBscanf\fR onde a string de formato n\(~ao \('e uma string
literal e n\(~ao existem argumentos de formato, como em \fBprintf(foo);\fR em vez
de \fBprintf(\*(L"%s\*(R", foo);\fR Isto pode ser um buraco de seguran\(,ca se a string de
formato vier de uma entrada n\(~ao confi\('avel e conter \(oq%n\(cq.
.IP "\fBfortify\fR" 4
.IX Item "fortify"
Esta defini\(,c\(~ao (activada por predefini\(,c\(~ao) adiciona \fB\-D_FORTIFY_SOURCE=2\fR a
\&\fB\s-1CPPFLAGS\s0\fR. Durante a gera\(,c\(~ao de c\('odigo o compilador sabe muita informa\(,c\(~ao
sobre tamanhos de buffer (onde poss\('ivel), e tenta substituir chamadas de
fun\(,c\(~ao buffer de comprimento ilimitadas e inseguras por umas limitadas em
comprimento. Isto \('e especialmente \('util para c\('odigo antigo,
desnecessariamente complicado. Adicionalmente, as strings de formato em
mem\('oria grav\('avel que cont\(^em \(oq%n\(cq s\(~ao bloqueadas. Se uma aplica\(,c\(~ao depender
de tal string de formato, isso ter\('a que ser contornado.
.Sp
Note que para esta op\(,c\(~ao ter algum efeito, a fonte tem de tamb\('em ser
compilada com \fB\-O1\fR ou superior. Se a vari\('avel de ambiente
\&\fB\s-1DEB_BUILD_OPTIONS\s0\fR conter \fInoopt\fR, ent\(~ao o suporte a \fBfortify\fR ser\('a
desactivado, devido a novos avisos serem emitidos pelo glibc 2.16 e
posterior.
.IP "\fBstackprotector\fR" 4
.IX Item "stackprotector"
Esta defini\(,c\(~ao (activada por predefini\(,c\(~ao se stackprotectorstrong n\(~ao
estiver em uso) adiciona \fB\-fstack\-protector \-\-param=ssp\-buffer\-size=4\fR a
\&\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
e \fB\s-1FCFLAGS\s0\fR. Isto adiciona verifica\(,c\(~oes de seguran\(,ca contra sobreposi\(,c\(~oes
de empilhamento. Isto renderiza muitos potenciais ataques de inje\(,c\(~oes de
c\('odigo em situa\(,c\(~oes de abortar. No melhor caso, isto transforma
vulnerabilidades de inje\(,c\(~ao de c\('odigo em nega\(,c\(~ao de servi\(,co ou em
n\(~ao\-problemas (dependendo da aplica\(,c\(~ao).
.Sp
Esta funcionalidade requer liga\(,c\(~ao (link) a glibc (ou outro fornecedor de
\&\fB_\|_stack_chk_fail\fR), portanto precisa de ser desactivada quando se compila
com \fB\-nostdlib\fR ou \fB\-ffreestanding\fR ou semelhante.
.IP "\fBstackprotectorstrong\fR" 4
.IX Item "stackprotectorstrong"
Esta defini\(,c\(~ao (activada por predefini\(,c\(~ao) adiciona
\&\fB\-fstack\-protector\-strong\fR a \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 e \fB\s-1FCFLAGS\s0\fR. Esta \('a uma variante
mais forte de \fBstackprotector\fR, mas sem penalidades de performance
significativas.
.Sp
Desactivar \fBstackprotector\fR ir\('a tamb\('em desactivar esta defini\(,c\(~ao.
.Sp
Esta funcionalidade tem os mesmos requerimentos que \fBstackprotector\fR, e
adicionalmente tamb\('em requer gcc 4.9 e posterior.
.IP "\fBrelro\fR" 4
.IX Item "relro"
Esta defini\(,c\(~ao (activada por predefini\(,c\(~ao) adiciona \fB\-Wl,\-z,relro\fR a
\&\fB\s-1LDFLAGS\s0\fR. Durante o carregamento do programa, v\('arias sec\(,c\(~oes de mem\('oria
\&\s-1ELF\s0 precisam de ser escritas pelo vinculador. Isto sinaliza ao carregador
para tornar estas sec\(,c\(~oes s\('o\-leitura antes de entregar o controlo ao
programa. Mais notavelmente isto previne ataques de sobrescrita \s-1GOT.\s0 Se esta
op\(,c\(~ao for desactivada, \fBbindnow\fR ir\('a ficar tamb\('em desactivado.
.IP "\fBbindnow\fR" 4
.IX Item "bindnow"
Esta defini\(,c\(~ao (desactivada por predefini\(,c\(~ao) adiciona \fB\-Wl,\-z,now\fR a
\&\fB\s-1LDFLAGS\s0\fR. Durante o carregamento do programa, todos os s\('imbolos din\(^amicos
s\(~ao resolvidos, permitindo que todo o \s-1PLT\s0 seja marcado s\('o\-leitura (devido ao
\&\fBrelro\fR em cima). A op\(,c\(~ao pode ser activada se \fBrelro\fR n\(~ao for activado.
.IP "\fBpie\fR" 4
.IX Item "pie"
Esta defini\(,c\(~ao (sem uma predefini\(,c\(~ao global desde dpkg 1.18.23, pois \('e agora
activa por predefini\(,c\(~ao pelo gcc nas arquitecturas Debian amd64, arm64,
armel, armhf, hurd\-i386, i386, kfreebsd\-amd64, kfreebsd\-i386, mips, mipsel,
mips64el, powerpc, ppc64, ppc64el, riscv64, s390x, sparc e sparc64) adiciona
as op\(,c\(~oes requeridas para activar ou desactivar \s-1PIE\s0 via ficheiros de
especifica\(,c\(~oes do gcc, Se necess\('ario, dependendo de se o gcc injeta nessa
arquitectura as bandeiras por ele pr\('oprio ou n\(~ao. Quando a defini\(,c\(~ao est\('a
activa e o gcc injeta as bandeiras, n\(~ao adiciona nada. Quando a defini\(,c\(~ao
est\('a activa e o gcc n\(~ao injeta as bandeiras, adiciona \fB\-fPIE\fR (via
\&\fI/usr/share/dpkg/pie\-compiler.specs\fR) to \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 e \fB\s-1FCFLAGS\s0\fR, e \fB\-fPIE \-pie\fR (via
\&\fI/usr/share/dpkg/pie\-link.specs\fR) a \fB\s-1LDFLAGS\s0\fR. Quando a defini\(,c\(~ao est\('a
desactivada e o gcc injeta as bandeiras, adiciona \fB\-fno\-PIE\fR (via
\&\fI/usr/share/dpkg/no\-pie\-compile.specs\fR) a \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 e \fB\s-1FCFLAGS\s0\fR, e
\&\fB\-fno\-PIE \-no\-pie\fR (via \fI/usr/share/dpkg/no\-pie\-link.specs\fR) a \fB\s-1LDFLAGS\s0\fR.
.Sp
Position Independent Executable \('e necess\('ario para tirar vantagem de Address
Space Layout Randomization, suportado por algumas vers\(~oes de
kernel. Enquanto \s-1ASLR\s0 j\('a pode ser aplicada para \('areas de dados na stack e
heap (brk e mmap), as \('areas de c\('odigo t\(^em de ser compiladas como
independente\-de\-posi\(,c\(~ao. As bibliotecas partilhadas j\('a fazem isto
(\fB\-fPIC\fR), assim elas ganham \s-1ASLR\s0 automaticamente, mas as regi\(~oes de texto
bin\('arios precisam de ser compiladas com \s-1PIE\s0 para ganhar \s-1ASLR.\s0 Quando isto
acontece, os ataques \s-1ROP\s0 (Return Oriented Programming) s\(~ao mais dif\('iceis
pois n\(~ao s\(~ao localiza\(,c\(~oes est\('aticas para ressaltar durante um ataque de
corrup\(,c\(~ao de mem\('oria.
.Sp
\&\s-1PIE\s0 n\(~ao \('e compat\('ivel com \fB\-fPIC\fR, assim em geral \('e preciso cuidado qo
compilar objectos partilhados. Mas porque as bandeiras \s-1PIE\s0 emitidas s\(~ao
injetadas via ficheiros specs de gcc, dever\('a ser sempre seguro defini-las
incondicionalmente independentemente do tipo de objecto a ser compilado ou
ligado em link.
.Sp
Bibliotecas est\('aticas pode ser usadas por programas ou outras bibliotecas
partilhadas. Dependendo das bandeiras usadas para compilar todos os objectos
dentro de uma biblioteca est\('atica, estas bibliotecas ser\(~ao utiliz\('aveis por
conjuntos diferentes de objectos:
.RS 4
.IP "none" 4
.IX Item "none"
N\(~ao pode ser vinculado a um programa \s-1PIE,\s0 n\(~ao \('e uma biblioteca partilhada.
.IP "\fB\-fPIE\fR" 4
.IX Item "-fPIE"
Pode ser vinculado a qualquer programa, mas n\(~ao a uma biblioteca partilhada
(recomendado).
.IP "\fB\-fPIC\fR" 4
.IX Item "-fPIC"
Pode ser vinculado a qualquer programa e biblioteca partilhada.
.RE
.RS 4
.Sp
Se existir a necessidade de definir estas bandeiras manualmente, fazendo
bypass \(`a inje\(,c\(~ao de spec gcc, h\('a varias coisas a ter em conta. Passar
incondicionalmente e explicitamente \fB\-fPIE\fR, \fB\-fpie\fR ou \fB\-pie\fR a um
sistema de compila\(,c\(~ao usando libtool \('e seguro pois estas bandeiras ir\(~ao ser
despojadas quando se compila bibliotecas partilhadas. Caso contr\('ario em
projetos que compilam ambos programas e bibliotecas partilhadas voc\(^e pode
precisar de certificar que quando compila as bibliotecas partilhadas,
\&\fB\-fPIC\fR seja sempre passado em \('ultimo (para que sobreponha qualquer \fB\-PIE\fR
anterior) \(`as bandeiras de compila\(,c\(~ao tais como \fB\s-1CFLAGS\s0\fR, e \fB\-shared\fR \('e
passado em \('ultimo (para que sobreponha qualquer \fB\-pie\fR anterior) para ligar
em link bandeiras tais como \fB\s-1LDFLAGS\s0\fR. \fBNota:\fR Isto n\(~ao deve ser
necess\('ario com a maquinaria de specs gcc predefinida.
.Sp
Adicionalmente, como \s-1PIE\s0 \('e implementado via registo geral, algumas
arquitecturas com falta de registo (mas n\(~ao incluindo mais a i386 desde as
optimiza\(,c\(~oes implementadas no gcc >= 5) podem ver perdas de performance
at\('e aos 15% em grandes cargas de aplica\(,c\(~oes de segmentos de texto pesados; a
maioria das cargas v\(^em menos de 1%. Arquitecturas com registos mais gerais
(ex. amd64) n\(~ao v\(^em mais alto que uma penalidade de pior caso.
.RE
.SS "reproducible"
.IX Subsection "reproducible"
As op\(,c\(~oes de tempo de compila\(,c\(~ao detalhadas em baixo  podem ser usadas para
ajudar a melhorar a reprodutibilidade de compila\(,c\(~ao ou fornecer mensagens de
aviso adicionais durante a compila\(,c\(~ao. Excepto como notado em baixo, estas
est\(~ao activadas por predefini\(,c\(~ao para as arquitecturas que as suportam.
.IP "\fBtimeless\fR" 4
.IX Item "timeless"
Esta defini\(,c\(~ao (activada por predefini\(,c\(~ao) adiciona \fB\-Wdate\-time\fR a
\&\fB\s-1CPPFLAGS\s0\fR. Isto ir\('a causar avisos quando as macros \fB_\|_TIME_\|_\fR,
\&\fB_\|_DATE_\|_\fR e \fB_\|_TIMESTAMP_\|_\fR s\(~ao usadas.
.IP "\fBfixfilepath\fR" 4
.IX Item "fixfilepath"
Esta defini\(,c\(~ao (activada por predefini\(,c\(~ao) adiciona
\&\fB\-ffile\-prefix\-map=\fR\fI\s-1BUILDPATH\s0\fR\fB=.\fR a \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 e \fB\s-1FCFLAGS\s0\fR quando
\&\fB\s-1BUILDPATH\s0\fR est\('a definido para o direct\('orio de n\('ivel de topo do pacote a
ser compilado. Isto tem o efeito de remover o caminho de compila\(,c\(~ao de
qualquer ficheiro gerado.
.Sp
Se ambas \fBfixdebugpath\fR e \fBfixfilepath\fR forem definidas, esta op\(,c\(~ao toma
preced\(^encia, porque \('e um superconjunto do anterior.
.IP "\fBfixdebugpath\fR" 4
.IX Item "fixdebugpath"
Esta defini\(,c\(~ao (activada por predefini\(,c\(~ao) adiciona
\&\fB\-fdebug\-prefix\-map=\fR\fI\s-1BUILDPATH\s0\fR\fB=.\fR a \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 e \fB\s-1FCFLAGS\s0\fR quando
\&\fB\s-1BUILDPATH\s0\fR est\('a definido para o direct\('orio de n\('ivel de topo do pacote a
ser compilado. Isto tem o efeito de remover o caminho de compila\(,c\(~ao de
qualquer s\('imbolo de depura\(,c\(~ao ficheiro gerado.
.SH "AMBIENTE"
.IX Header "AMBIENTE"
Existem 2 conjuntos de vari\('aveis de ambiente a fazer as mesmas opera\(,c\(~oes, O
primeiro (\s-1DEB_\s0\fIflag\fR_\fIop\fR) nunca deve ser usada dentro de
\&\fBdebian/rules\fR. Destina-se a qualquer utilizador que queria recompilar o
pacote fonte com bandeiras de compila\(,c\(~ao diferentes. O segundo conjunto
(\s-1DEB_\s0\fIflag\fR_MAINT_\fIop\fR) s\('o deve ser usado em \fBdebian/rules\fR pelos
maintainers de pacotes para alterar as bandeiras de compila\(,c\(~ao resultantes.
.IP "\fB\s-1DEB_\s0\fR\fIflag\fR\fB_SET\fR" 4
.IX Item "DEB_flag_SET"
.PD 0
.IP "\fB\s-1DEB_\s0\fR\fIflag\fR\fB_MAINT_SET\fR" 4
.IX Item "DEB_flag_MAINT_SET"
.PD
Esta vari\('avel pode ser usada para for\(,car o valor retornado para a <flag>
fornecida.
.IP "\fB\s-1DEB_\s0\fR\fIflag\fR\fB_STRIP\fR" 4
.IX Item "DEB_flag_STRIP"
.PD 0
.IP "\fB\s-1DEB_\s0\fR\fIflag\fR\fB_MAINT_STRIP\fR" 4
.IX Item "DEB_flag_MAINT_STRIP"
.PD
Esta vari\('avel pode ser usada para disponibilizar uma lista separada por
espa\(,cos das op\(,c\(~oes que ir\(~ao ser despojadas do conjunto de flags retornado
para a \fIflag\fR fornecida.
.IP "\fB\s-1DEB_\s0\fR\fIflag\fR\fB_APPEND\fR" 4
.IX Item "DEB_flag_APPEND"
.PD 0
.IP "\fB\s-1DEB_\s0\fR\fIflag\fR\fB_MAINT_APPEND\fR" 4
.IX Item "DEB_flag_MAINT_APPEND"
.PD
Esta vari\('avel pode ser usada para acrescentar op\(,c\(~oes suplementares ao valor
retornado para a \fIflag\fR fornecida.
.IP "\fB\s-1DEB_\s0\fR\fIflag\fR\fB_PREPEND\fR" 4
.IX Item "DEB_flag_PREPEND"
.PD 0
.IP "\fB\s-1DEB_\s0\fR\fIflag\fR\fB_MAINT_PREPEND\fR" 4
.IX Item "DEB_flag_MAINT_PREPEND"
.PD
Esta vari\('avel pode ser usada para adicionar op\(,c\(~oes suplementares ao inicio
do valor retornado  para a \fIflag\fR fornecida.
.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
Estas vari\('aveis podem ser usadas por um utilizador ou maintainer para
desactivar/activar v\('arias funcionalidades de \('area que afectam bandeiras de
compila\(,c\(~ao. A vari\('avel \fB\s-1DEB_BUILD_MAINT_OPTIONS\s0\fR sobrep\(~oe qualquer
defini\(,c\(~ao nas \('areas de funcionalidade de \fB\s-1DEB_BUILD_OPTIONS\s0\fR. Veja a sec\(,c\(~ao
\&\fB\('AREAS \s-1DE\s0 CARACTER\('ISTICAS\fR para detalhes.
.IP "\fB\s-1DEB_VENDOR\s0\fR" 4
.IX Item "DEB_VENDOR"
Esta defini\(,c\(~ao define o fornecedor actual. Se n\(~ao definida, ir\('a descobrir o
fornecedor actual ao ler \fB/etc/dpkg/origins/default\fR.
.IP "\fB\s-1DEB_BUILD_PATH\s0\fR" 4
.IX Item "DEB_BUILD_PATH"
Esta vari\('avel define o caminho de compila\(,c\(~ao (desde dpkg 1.18.8) a usar em
funcionalidades como \fBfixdebugpath\fR para que possam ser controladas pelo
chamador. Esta vari\('avel \('e actualmente espec\('ifica de Debian e derivados.
.IP "\fB\s-1DPKG_COLORS\s0\fR" 4
.IX Item "DPKG_COLORS"
Define o modo de cor (desde dpkg 1.18.5). Os valores actualmente aceites
s\(~ao: \fBauto\fR (predefinido), \fBalways\fR e \fBnever\fR.
.IP "\fB\s-1DPKG_NLS\s0\fR" 4
.IX Item "DPKG_NLS"
Se definida, ser\('a usada para decidir se deve activar o Suporte a Linguagem
Nativa. Tamb\('em como conhecido como suporte de internacionaliza\(,c\(~ao (ou i18n)
(desde dpkg 1.19.0). Os valores aceites s\(~ao \fB0\fR e \fB1\fR (predefini\(,c\(~ao).
.SH "FICHEIROS"
.IX Header "FICHEIROS"
.SS "Ficheiros de configura\(,c\(~ao"
.IX Subsection "Ficheiros de configura\(,c\(~ao"
.IP "\fB/etc/dpkg/buildflags.conf\fR" 4
.IX Item "/etc/dpkg/buildflags.conf"
Ficheiro de configura\(,c\(~ao geral do sistema.
.IP "\fB\f(CB$XDG_CONFIG_HOME\fB/dpkg/buildflags.conf\fR ou" 4
.IX Item "$XDG_CONFIG_HOME/dpkg/buildflags.conf ou"
.PD 0
.IP "\fB\f(CB$HOME\fB/.config/dpkg/buildflags.conf\fR" 4
.IX Item "$HOME/.config/dpkg/buildflags.conf"
.PD
Ficheiro de configura\(,c\(~ao do utilizador.
.SS "Suporte a empacotamento"
.IX Subsection "Suporte a empacotamento"
.IP "\fB/usr/share/dpkg/buildflags.mk\fR" 4
.IX Item "/usr/share/dpkg/buildflags.mk"
trecho do Makefile que ir\('a carregar (e opcionalmente exportar) todas as
bandeiras suportadas pelo \fBdpkg-buildflags\fR em vari\('aveis (desde dpkg
1.16.1).
.SH "EXEMPLOS"
.IX Header "EXEMPLOS"
Para passar flags de compila\(,c\(~ao a um comando de compila\(,c\(~ao dentro de um
Makefile:
.Sp
.Vb 1
\& $(MAKE) $(shell dpkg\-buildflags \-\-export=cmdline)
\&
\& ./configure $(shell dpkg\-buildflags \-\-export=cmdline)
.Ve
.PP
Para definir bandeiras de compila\(,c\(~ao num script de shell ou num fragmento de
shell, por ser usado o \fBeval\fR para interpretar o resultado e para exportar
as bandeiras no ambiente:
.Sp
.Vb 1
\& eval "$(dpkg\-buildflags \-\-export=sh)" && make
.Ve
.PP
ou para definir os par\(^ametros posicionais a passar a um comando:
.Sp
.Vb 2
\& eval "set \-\- $(dpkg\-buildflags \-\-export=cmdline)"
\& for dir in a b c; do (cd $dir && ./configure "$@" && make); done
.Ve
.SS "Utiliza\(,c\(~ao em debian/rules"
.IX Subsection "Utiliza\(,c\(~ao em debian/rules"
Voc\(^e deve chamar \fBdpkg-buildflags\fR ou incluir \fBbuildflags.mk\fR do ficheiro
\&\fBdebian/rules\fR para obter as bandeiras de compila\(,c\(~ao necess\('arias para
passar ao sistema de compila\(,c\(~ao. Note que vers\(~oes antigas do
\&\fBdpkg-buildpackage\fR (antes do dpkg 1.16.1) exportavam estas bandeiras
automaticamente. No entanto, voc\(^e n\(~ao deve confiar nisto, pois isto quebra a
invoca\(,c\(~ao manual de \fBdebian/rules\fR.
.PP
Para pacotes com sistemas de compila\(,c\(~ao tipo autoconf, voc\(^e pode passar as
op\(,c\(~oes relevantes ao configure ou \fBmake\fR(1) directamente, como mostrado em
cima.
.PP
Para outros sistemas de compila\(,c\(~ao, ou quando precisa de um controle mais
afinado acerca de quais bandeiras s\(~ao passadas para onde, voc\(^e pode usar
\&\fB\-\-get\fR. Ou voc\(^e pode incluir \fBbuildflags.mk\fR em vez disto, o que toma
conta de chamar \fBdpkg-buildflags\fR e guardar as bandeiras de compila\(,c\(~ao em
vari\('aveis do make.
.PP
Se voc\(^e quiser exportar todas as bandeiras de compila\(,c\(~ao para o ambiente
(onde elas pode ser colhidas pelo seu sistema de compila\(,c\(~ao):
.Sp
.Vb 2
\& DPKG_EXPORT_BUILDFLAGS = 1
\& include /usr/share/dpkg/buildflags.mk
.Ve
.PP
Para algum controle extra sobre o que \('e exportado, voc\(^e pode exportar
manualmente as vari\('aveis (pois nenhuma \('e exportada por predefini\(,c\(~ao).
.Sp
.Vb 2
\& include /usr/share/dpkg/buildflags.mk
\& export CPPFLAGS CFLAGS LDFLAGS
.Ve
.PP
E claro que voc\(^e pode passar as bandeiras aos comandos manualmente:
.Sp
.Vb 3
\& include /usr/share/dpkg/buildflags.mk
\& build\-arch:
\&        $(CC) \-o hello hello.c $(CPPFLAGS) $(CFLAGS) $(LDFLAGS)
.Ve
.SH "TRADU\(,C\(~AO"
.IX Header "TRADU\(,C\(~AO"
Am\('erico Monteiro
.PP
Se encontrar algum erro na tradu\(,c\(~ao deste documento, por favor comunique para
Am\('erico Monteiro <a_monteiro@gmx.com>.