.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" 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 "DH_MAKESHLIBS 1" .TH DH_MAKESHLIBS 1 "2021-03-06" "13.3.3~bpo10+1" "Debhelper" .\" 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" dh_makeshlibs \- cria automaticamente o ficheiro shlibs e chama dpkg-gensymbols .SH "RESUMO" .IX Header "RESUMO" \&\fBdh_makeshlibs\fR [\fIopções do debhelper\fR] [\fB\-m\fR\fImajor\fR] [\fB\-V\fR\fI[dependências]\fR] [\fB\-n\fR] [\fB\-X\fR\fIitem\fR] [\fB\-\-\fR \fIparâmetros\fR] .SH "DESCRIÇÃO" .IX Header "DESCRIÇÃO" \&\fBdh_makeshlibs\fR é um programa debhelper que sonda automaticamente por bibliotecas partilhadas, e gera um ficheiro shlibs para as bibliotecas que encontra. .PP Também assegura que o ldconfig é invocado durante a instalação e remoção quando encontra bibliotecas partilhadas. Desde o debhelper 9.20151004, isto é feito via um trigger do dpkg. Nas versões mais antigas do debhelper, \&\fBdh_makeshlibs\fR seria geralmente um script de maintainer para este objetivo. .PP Desde o debhelper 12.3, \fBdh_makeshlibs\fR irá por predefinição adicionar uma linha \fIudeb\fR adicional para udebs no ficheiro shlibs, quando o udeb tem o mesmo nome que o deb seguido por um sufixo \*(L"\-udeb\*(R" (ex. se o deb for chamado \&\*(L"libfoo1\*(R", então o debhelper irá auto-detectar o udeb se ele for chamado \&\*(L"libfoo1\-udeb\*(R"). Por favor use as opções \fB\-\-add\-udeb\fR e \fB\-\-no\-add\-udeb\fR abaixo quando esta auto\-detecção é insuficiente. .PP Se você usou anteriormente \fB\-\-add\-udeb\fR e está a considerar migrar para a utilização da nova funcionalidade de auto\-detecção em 12.3, então por favor lembre-se de testar que os ficheiros \fIDEBIAN/shlibs\fR resultantes são os esperados. Existem alguns casos conhecidos, onde a auto\-detecção é insuficiente. Estes incluem quando o udeb contem ficheiros biblioteca de múltiplos pacotes deb regulares ou quando os pacotes não seguem a convenção de nomes esperada. .SH "FICHEIROS" .IX Header "FICHEIROS" .IP "debian/\fIpacote\fR.shlibs" 4 .IX Item "debian/pacote.shlibs" Instala este ficheiro, se presente, no pacote como DEBIAN/shlibs. Se omitido, o debhelper irá gerar um ficheiro shlibs automaticamente se detectar quaisquer bibliotecas. .Sp Note que em níveis de compatibilidade 9 e anteriores, este ficheiro era instalado pelo \fBdh_installdeb\fR\|(1) em vez do \fBdh_makeshlibs\fR. .IP "debian/\fIpacote\fR.symbols" 4 .IX Item "debian/pacote.symbols" .PD 0 .IP "debian/\fIpacote\fR.symbols.\fIarquitectura\fR" 4 .IX Item "debian/pacote.symbols.arquitectura" .PD Estes ficheiros de símbolos, se presentes, são passados para \&\fBdpkg\-gensymbols\fR\|(1) para serem processados e instalados. Use os nomes específicos de \fIarch\fR se precisar de disponibilizar ficheiros de símbolos diferentes para diferentes arquitecturas. .SH "OPÇÕES" .IX Header "OPÇÕES" .IP "\fB\-m\fR\fImajor\fR, \fB\-\-major=\fR\fImajor\fR" 4 .IX Item "-mmajor, --major=major" Em vez de tentar adivinhar o maior número da biblioteca com o objdump, usa o maior número especificado após o parâmetro \-m. Isto é muito menos útil do que costumava ser, de volta aos maus velhos tempos quando este programa olhava para os nomes de ficheiro das bibliotecas em vez de usar o objdump. .IP "\fB\-V\fR, \fB\-V\fR\fIdependências\fR" 4 .IX Item "-V, -Vdependências" .PD 0 .IP "\fB\-\-version\-info\fR, \fB\-\-version\-info=\fR\fIdependências\fR" 4 .IX Item "--version-info, --version-info=dependências" .PD Se um ficheiro shlibs for gerado por este programa, esta opção controla que versão será usada na relação de dependência. .Sp Em compatibilidade 12 e posterior, \fBdh_makeshlibs\fR usa por predefinição \&\fB\-VUpstream\-Version\fR. Em compatibilidade 11 e anterior o comportamento predefinido é como \fB\-VNone\fR. .Sp A ferramenta \fBdh_makeshlibs\fR pode gerar dependências em três variantes: .RS 4 .IP "\fB\-VUpstream\-Version\fR" 4 .IX Item "-VUpstream-Version" A dependência será "\fIpackagename\fR \fB(>\fR= \fIpackageversion\fR\fB)\fR". Note que \fIUpstream-Version\fR é sensível a maiúsculas/minúsculas e tem de ser escrito exactamente como mostrado aqui. .Sp Esta é uma definição conservativa que assegura sempre que as dependências de bibliotecas partilhadas dos pacotes mais antigos são pelo menos tão justas o quanto precisam de ser (a menos que a biblioteca seja inclinada a alterar a \&\s-1ABI\s0 sem actualizar o número de versão do autor). .Sp O reverso da medalha é que os pacotes podem acabar com dependências muito apertadas em alguns casos (note que um ficheiro symbols pode mitigar esta situação). Isto é geralmente uma inconveniência menor temporária e normalmente muito melhor que a falha causada ao esquecer de inserir a informação de dependência. .Sp Este formato explícito foi adicionado no debhelper/11.3. Nas versões anteriores, era usado em vez disto um \fB\-V\fR sem nenhuma informação de dependência (e esse formato ainda funciona). .IP "\fB\-VNone\fR" 4 .IX Item "-VNone" A dependência será "\fIpackagename\fR". Note que \fINone\fR é sensível a maiúsculas/minúsculas e tem de ser escrito exactamente como mostrado aqui. .Sp Este formato é na generalidade não seguro sendo a única excepção se o autor original não estender a \s-1ABI\s0 de maneira nenhuma. No entanto, a maioria dos autores originais melhoram as suas interfaces com o passar do tempo e é recomendado que os pacotes usem \fB\-VUpstream\-Version\fR (ou um dos outros formatos de \fB\-V\fR\fIdependencies\fR). .Sp Alternativamente, isto pode ser suficiente se (e apenas se) o pacote usar versão por símbolo (veja \fBdpkg\-gensymbols\fR\|(1)) e \fInão\fR compilar nenhum pacote udeb. Note que symbols não são suportados para pacotes udeb, os quais apenas se apoiam em shlibs para manuseamento das dependências. .IP "\fB\-V\fR\fIpackage-relation\fR" 4 .IX Item "-Vpackage-relation" Neste caso, o valor passado a \fB\-V\fR irá ser usado como uma relação de dependência. O \fIpackage-relation\fR deve geralmente ser do formato "\fIalgum-nome-pacote\fR \fB(>\fR= \fIalguma\-versão\-pacote\fR\fB)\fR". Lembre-se de incluir o nome do pacote. .Sp Note que o debhelper irá usar o calor \fIcomo está\fR sem verificações de sanidade ou modificação. Em casos \fIraros e especiais\fR, isto é preciso para gerar uma dependência num pacote diferente daquele que contém a biblioteca. .RE .RS 4 .Sp Quando escolher um valor para esta opção, por favor lembre-se que se o pacote fornecer um ficheiro symbols, então esse é geralmente preferido sobre o ficheiro shlibs para pacotes .deb regulares. Veja \fBdpkg\-shlibdeps\fR\|(1) para mais informação sobre este tópico. .RE .IP "\fB\-n\fR, \fB\-\-no\-scripts\fR" 4 .IX Item "-n, --no-scripts" Não adiciona o trigger \*(L"ldconfig\*(R" mesmo que parece que o pacote possa precisar dele. A opção é chamada \fB\-\-no\-scripts\fR por razões históricas pois o \fBdh_makeshlibs\fR previamente gerava scripts do maintainer que chamavam \&\fBldconfig\fR. .IP "\fB\-X\fR\fIitem\fR, \fB\-\-exclude=\fR\fIitem\fR" 4 .IX Item "-Xitem, --exclude=item" Exclui ficheiros que contenham \fIitem\fR em qualquer ponto do seu nome de ficheiro ou directório de serem tratados como bibliotecas partilhadas. .IP "\fB\-\-add\-udeb=\fR\fIudeb\fR" 4 .IX Item "--add-udeb=udeb" Cria uma linha adicionar para udebs no ficheiro shlibs e usa \fIudeb\fR como o nome do pacote para o udebs depender dele em vez do pacote da biblioteca normal. .Sp Esta opção é apenas útil para casos especiais tais como quando o debhelper não consegue auto-detectar o nome de pacote para o pacote udeb, quando o udeb irá conter bibliotecas de múltiplos pacotes deb, ou quando o udeb contem bibliotecas \fBnão\fR presentes no pacote deb. .IP "\fB\-\-no\-add\-udeb\fR" 4 .IX Item "--no-add-udeb" Não adiciona nenhumas linhas udeb ao ficheiro shlibs. Isto pode ser usado para desactivar a auto\-detecção predefinida do udebs. .Sp Isto pode ser útil caso você não queira nenhum ficheiro shlibs para o udeb porque nenhum pacote irá depender dele. Ex. porque adicionar um pacote udeb para a biblioteca foi \*(L"exagero\*(R" e a biblioteca está embebida num pacote udeb diferente. .IP "\fB\-\-\fR \fIparams\fR" 4 .IX Item "-- params" Passa \fIparams\fR para \fBdpkg\-gensymbols\fR\|(1). .SH "EXEMPLOS" .IX Header "EXEMPLOS" .IP "\fBdh_makeshlibs \-VNone\fR" 4 .IX Item "dh_makeshlibs -VNone" Assumindo que este é um pacote chamado \fIlibfoobar1\fR, gera um ficheiro shlibs que se parece com algo como isto: libfoobar 1 libfoobar1 .IP "\fBdh_makeshlibs \-VUpstream\-Version\fR" 4 .IX Item "dh_makeshlibs -VUpstream-Version" Assumindo que a versão actual do pacote é 1.1\-3, gera um ficheiro shlibs que se parece com algo como isto: libfoobar 1 libfoobar1 (>= 1.1) .IP "\fBdh_makeshlibs \-V 'libfoobar1 (>= 1.0)'\fR" 4 .IX Item "dh_makeshlibs -V 'libfoobar1 (>= 1.0)'" Gera um ficheiro shlibs que se parece com isto: libfoobar 1 libfoobar1 (>= 1.0) .SH "VEJA TAMBÉM" .IX Header "VEJA TAMBÉM" \&\fBdebhelper\fR\|(7) .PP Este programa é parte do debhelper. .SH "AUTOR" .IX Header "AUTOR" Joey Hess .SH "TRADUÇÃO" .IX Header "TRADUÇÃO" Américo Monteiro .PP Se encontrar algum erro na tradução deste documento, por favor comunique para Américo Monteiro \fIa_monteiro@gmx.com\fR ou Equipa Debian de Tradução Portuguesa \fItraduz@debianpt.org\fR.