.\" 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 "deb-symbols 5" .TH deb-symbols 5 "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" deb-symbols \- ficheiro de informa\(,c\(~ao de biblioteca partilhada extensiva de Debian .SH "SINOPSE" .IX Header "SINOPSE" \&\fBDEBIAN/symbols\fR .SH "DESCRI\(,C\(~AO" .IX Header "DESCRI\(,C\(~AO" Os ficheiros symbol s\(~ao enviados em pacotes bin\('arios Debian, e o seu formato \('e um sub-conjunto dos ficheiros symbol modelo usados por \&\fBdpkg-gensymbols\fR(1) em pacotes fonte Debian. .PP O formato para uma entrada de informa\(,c\(~ao de depend\(^encia de biblioteca partilhada extensiva nestes ficheiros \('e: .PP \fIlibrary-soname main-dependency-template\fR [| \fIalternative-dependency-template\fR] [...] [* \fIfield-name\fR: \fIfield-value\fR] [...] \fIsymbol\fR \fIminimal-version\fR [\fIid-of-dependency-template\fR] .PP O \fIlibrary-soname\fR \('e exactamente o valor do campo \s-1SONAME\s0 como exportado por \&\fBobjdump\fR(1). Um \fIdependency-template\fR \('e uma depend\(^encia onde \fI#MINVER#\fR \('e substitu\('ida dinamicamente seja por uma verifica\(,c\(~ao de vers\(~ao tipo \(lq(>= \&\fIminimal-version\fR)\(rq ou por nada (se uma depend\(^encia isenta\-de\-vers\(~ao for considerada suficiente). .PP Cada \fIsymbol\fR exportado (listado como \fIname\fR@\fIversion\fR, com \fIversion\fR sendo \(lqBase\(rq se a biblioteca for isenta\-de\-vers\(~ao) estiver associado a um \&\fIminimal-version\fR do seu modelo de depend\(^encia (o modelo de depend\(^encia principal \('e sempre usado e ir\('a acabar sendo combinado com o modelo de depend\(^encia referenciado por \fIid-of-dependency-template\fR se presente). O primeiro modelo de depend\(^encia alternativa \('e numerado 1, o segundo 2, etc. Cada coluna \('e separada por exactamente um \('unico espa\(,co em branco. .PP Cada entrada para uma biblioteca pode tamb\('em ter alguns campos de meta\-informa\(,c\(~ao. Esses campos s\(~ao armazenados em linhas que come\(,cam com um asterisco. Actualmente, os \('unicos campos v\('alidos s\(~ao: .IP "\fBBuild-Depends-Package\fR" 4 .IX Item "Build-Depends-Package" Indica que o nome do pacote \(lq\-dev\(rq associado a um bin\('ario associado \(`a biblioteca e \('e usado por \fBdpkg-shlibdeps\fR para certificar que a depend\(^encia gerada \('e pelo menos t\(~ao rigorosa como a depend\(^encia de compila\(,c\(~ao correspondente (desde dpkg 1.14.13). .IP "\fBBuild-Depends-Packages\fR" 4 .IX Item "Build-Depends-Packages" O mesmo que \fBBuild-Depends-Package\fR mas aceita uma lista separada por virgulas de nomes de pacotes (desde dpkg 1.20.0). Este campo ir\('a sobrepor qualquer campo \fBBuild-Depends-Package\fR presente, e \('e maioritariamente \('util com pacotes \(lq\-dev\(rq e meta-pacotes dependendo destes, digamos para um per\('iodo de transi\(,c\(~ao. .IP "\fBAllow-Internal-Symbol-Groups\fR" 4 .IX Item "Allow-Internal-Symbol-Groups" Indica que grupos de s\('imbolos internos dever\(~ao ser ignorados, como uma lista separada por espa\(,cos em branco, para que os s\('imbolos contidos nesses grupos sejam inclu\('idos no ficheiro resultante (desde dpkg 1.20.1). Isto s\('o deve ser necess\('ario para pacotes ferramenta-cadeia que providenciem esses s\('imbolos internos. Os grupos dispon\('iveis s\(~ao dependentes do sistema, para \s-1ELF\s0 e sistemas baseados em \s-1GNU\s0 estes s\(~ao \fBaeabi\fR e \fBgomp\fR. .IP "\fBIgnore-Blacklist-Groups\fR" 4 .IX Item "Ignore-Blacklist-Groups" Um alias descontinuado para \fBAllow-Internal-Symbol-Groups\fR (desde dpkg 1.20.1, suportado desde dpkg 1.17.6). .SH "EXEMPLOS" .IX Header "EXEMPLOS" .SS "Ficheiro symbols simples" .IX Subsection "Ficheiro symbols simples" .Vb 4 \& libftp.so.3 libftp3 #MINVER# \& DefaultNetbuf@Base 3.1\-1\-6 \& FtpAccess@Base 3.1\-1\-6 \& [...] .Ve .SS "Ficheiro symbols avan\(,cado" .IX Subsection "Ficheiro symbols avan\(,cado" .Vb 7 \& libGL.so.1 libgl1 \& | libgl1\-mesa\-glx #MINVER# \& * Build\-Depends\-Package: libgl1\-mesa\-dev \& publicGlSymbol@Base 6.3\-1 \& [...] \& implementationSpecificSymbol@Base 6.5.2\-7 1 \& [...] .Ve .SH "VEJA TAMB\('EM" .IX Header "VEJA TAMB\('EM" , \&\fBdpkg-shlibdeps\fR(1), \fBdpkg-gensymbols\fR(1). .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 .