path: root/man/pl/dpkg-shlibdeps.1

.\" dpkg manual page - dpkg-deb(1)
.\"
.\" Copyright © 1995-1996 Ian Jackson <ian@chiark.chu.cam.ac.uk>
.\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org>
.\" Copyright © 2006 Frank Lichtenheld <djpig@debian.org>
.\" Copyright © 2007-2011 Raphaël Hertzog <hertzog@debian.org>
.\" Copyright © 2012 Guillem Jover <guillem@debian.org>
.\"
.\" This is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
.
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH dpkg\-shlibdeps 1 2012\-01\-20 "Projekt Debiana" "programy pomocnicze dpkg"
.SH NAZWA
dpkg\-shlibdeps \- generowanie zale¿no¶ci podstawieñ wspó³dzielonych bibliotek
.
.SH SK£ADNIA
\fBdpkg\-shlibdeps\fP [\fIoption\fP...] [\fB\-e\fP]\fIexecutable\fP [\fIoption\fP...]
.
.SH OPIS
\fBdpkg\-shlibdeps\fP calculates shared library dependencies for executables
named in its arguments. The dependencies are added to the substitution
variables file \fBdebian/substvars\fP as variable names
\fBshlibs:\fP\fIdependencyfield\fP where \fIdependencyfield\fP is a dependency field
name. Any other variables starting with \fBshlibs:\fP are removed from the
file.
.P
\fBdpkg\-shlibdeps\fP ma dwa ¼ród³a informacji s³u¿±ce do generowania informacji
o zale¿no¶ciach. S± to pliki \fIsymbols\fP lub pliki \fIshlibs\fP. Dla ka¿dego
pliku binarnego analizowanego przez \fBdpkg\-shlibdeps\fP okre¶lana jest lista
bibliotek, z którymi jest on linkowany. Nastêpnie dla ka¿dej biblioteki
przegl±dany jest plik \fIsymbols\fP lub plik \fIshlibs\fP (je¶li ten pierwszy nie
istnieje, lub gdy debian/shlibs.local zawiera stosown± zale¿no¶æ). Oba pliki
powinny byæ dostarczane przez pakiet zawieraj±cy bibliotekê i powinny wiêc
byæ dostêpne jako /var/lib/dpkg/info/\fIpakiet\fP.\fIsymbols\fP lub
/var/lib/dpkg/info/\fIpakiet\fP.\fIshlibs\fP. Nazwa pakietu jest okre¶lana w dwóch
krokach: odnalezienie pliku biblioteki w systemie (sprawdzaj±c w tych samych
katalogach, których u¿ywa \fBld.so\fP), a nastêpnie u¿ycie \fBdpkg \-S
\fP\fIplik\-biblioteki\fP w celu okre¶lenia pakietu dostarczaj±cego dan±
bibliotekê.
.SS "Pliki symboli"
Pliki symboli zawieraj± dok³adniejsze okre¶lenia informacji o zale¿no¶ciach,
dostarczaj±c minimum zale¿no¶ci dla ka¿dego symbolu eksportowanego przez
bibliotekê. Skrypt próbuje odnale¼æ plik zwi±zany z pakietem biblioteki w
nastêpuj±cych miejscach (u¿yte jest pierwsze dopasowanie):
.IP debian/*/DEBIAN/symbols
Informacje o wspó³dzielonej bibliotece wygenerowane w bie¿±cym procesie
budowy, który wywo³a³ równie¿ \fBdpkg\-shlibdeps\fP. S± one generowane przez
\fBdpkg\-gensymbols\fP(1). S± u¿ywane tylko, gdy biblioteka znajduje siê w
drzewie budowania pakietu. Plik "symbols" z tego drzewa ma pierwszeñstwo nad
plikami symboli z innych pakietów binarnych.
.IP /etc/dpkg/symbols/\fIpakiet\fP.symbols.\fIarch\fP
.IP /etc/dpkg/symbols/\fIpakiet\fP.symbols
Informacje o zasiêgu systemu, które nadpisuj± informacje o zale¿no¶ciach
bibliotek wspó³dzielonych. \fIarch\fP jest architektur± bie¿±cego systemu
(okre¶lon± przez \fBdpkg\-architecture \-qDEB_HOST_ARCH\fP).
.IP "Output from \(lq\fBdpkg\-query \-\-control\-path\fP \fIpackage\fP symbols\(rq"
Package\-provided shared library dependency information.  Unless overridden
by \-\-admindir, those files are located in /var/lib/dpkg.
.P
Podczas przeszukiwania symboli u¿ywanych przez wszystkie pliki binarne,
\fBdpkg\-shlibdeps\fP zapamiêtuje (najwiêksz±) minimaln± wersjê wymagan± dla
ka¿dej biblioteki. Na koñcu procesu jest wiêc w stanie wypisaæ minimalne
zale¿no¶ci dla ka¿dej u¿ytej biblioteki (pod warunkiem, ¿e informacja z
plików \fIsymbols\fP jest dok³adna).
.P
Jako zabezpieczenie plik symboli mo¿e zawieraæ pole metainformacji
\fIBuild\-Depends\-Package\fP, za¶ \fBdpkg\-shlibdeps\fP okre¶laj±c minimaln± wersjê
wymagan± przez odpowiadaj±cy pakiet z pola Build\-Depends bêdzie u¿ywaæ
w³a¶nie tej wersji, je¶li jest ona wy¿sza ni¿ minimalna wersja okre¶lona
dziêki przeszukiwaniu symboli.
.SS "Pliki \(dqshlibs\(dq"
Pliki "shlibs" wi±¿± bezpo¶rednio bibliotekê z zale¿no¶ciami (bez
przegl±dania symboli). Jest to wiêc czêsto silniejsze ni¿ naprawdê
potrzebne, ale bardzo bezpieczne i ³atwe w obs³udze.
.P
Zale¿no¶ci dla biblioteki s± wyszukiwane w kilku miejscach. U¿ywany jest
pierwszy plik zawieraj±cy informacje dla danej biblioteki:
.IP debian/shlibs.local
Lokalne informacje z pakietu nadpisuj±ce informacje o zale¿no¶ciach
bibliotek wspó³dzielonych.
.IP /etc/dpkg/shlibs.override
Informacje o zasiêgu systemu, które nadpisuj± informacje o zale¿no¶ciach
bibliotek wspó³dzielonych.
.IP debian/*/DEBIAN/shlibs
Informacje o zale¿no¶ciach wspó³dzielonych bibliotek wygenerowane w bie¿±cym
procesie budowy, który wywo³a³ równie¿ \fBdpkg\-shlibdeps\fP. S± u¿ywane tylko,
gdy biblioteka znajduje siê w drzewie budowania pakietu. Plik "shlibs" z
tego drzewa ma pierwszeñstwo nad plikami shlibs z innych pakietów
binarnych."
.IP "Output from \(lq\fBdpkg\-query \-\-control\-path\fP \fIpackage\fP shlibs\(rq"
Package\-provided shared library dependency information.  Unless overridden
by \-\-admindir, those files are located in /var/lib/dpkg.
.IP /etc/dpkg/shlibs.default
Domy¶lna informacja o zale¿no¶ciach bibliotek wspó³dzielonych, o zakresie
systemu.
.P
Uzyskane zale¿no¶ci s± u¿ywane bezpo¶rednio (chyba, ¿e s± odfiltrowane
poniewa¿ zosta³y zidentyfikowane jako duplikaty lub s³absze ni¿ jaka¶ inna
zale¿no¶æ).
.SH OPCJE
\fBdpkg\-shlibdeps\fP interpretuje parametry nie bêd±ce opcjami jako nazwy
plików wykonywalnych, tak jakby by³y podane przez \fB\-e\fP\fIplik_wykonywalny\fP.
.TP 
\fB\-e\fP\fIplik_wykonywalny\fP
W³±czenie zale¿no¶ci odpowiadaj±cych bibliotekom wspó³dzielonym wymaganym
przez \fIplik_wykonywalny\fP.
.TP 
\fB\-d\fP\fIpole_zale¿no¶ci\fP
Dodanie zale¿no¶ci, które maj± byæ dodane do pola zale¿no¶ci
\fIpole_zale¿no¶ci\fP pliku kontrolnego. (Zale¿no¶ci dla tego pola s±
umieszczane w zmiennej \fBshlibs:\fP\fIpole_zale¿no¶ci\fP.)

Opcja \fB\-d\fP\fIpole_zale¿no¶ci\fP wp³ywa na wszystkie pliki wykonywalne podane
po tej opcji, a¿ do nastêpnego \fB\-d\fP\fIpole_zale¿no¶ci\fP. Domy¶lnym
\fIpolem_zale¿no¶ci\fP jest \fBDepends\fP.

Je¶li to samo okre¶lenie zale¿no¶ci (lub zbiór alternatyw) pojawia siê w
wiêcej ni¿ jednej nazwie z rozró¿nianych pól zale¿no¶ci \fBPre\-Depends\fP,
\fBDepends\fP, \fBRecommends\fP, \fBEnhances\fP lub \fBSuggests\fP to \fBdpkg\-shlibdeps\fP
automatycznie usunie zale¿no¶æ ze wszystkich pól, poza polem reprezentuj±cym
najwa¿niejsze zale¿no¶ci.
.TP 
\fB\-p\fP\fIprefiks_nazw_zmiennych\fP
Rozpoczynanie nazw zmiennych podstawiania od \fIprefiks_nazw_zmiennych\fP\fB:\fP
zamiast \fBshlibs:\fP. Podobnie, wszystkie zmienne rozpoczynaj±ce siê od
\fIprefiks_nazw_zmiennych\fP\fB:\fP (zamiast \fBshlibs:\fP) s± usuwane z pliku
zmiennych podstawiania.
.TP 
\fB\-O\fP
Wy¶wietlenie ustawieñ zmiennych podstawiania na standardowe wyj¶cie, zamiast
dodawania ich do pliku zmiennych podstawiania (domy¶lnie
\fBdebian/substvars\fP).
.TP 
\fB\-t\fP\fItyp\fP
Preferowanie informacji o zale¿no¶ciach bibliotek wspó³dzielonych
oznaczonych dla danego typu pakietu. Je¶li informacji oznaczonych nie ma,
u¿ywane s± informacje bez oznaczeñ. Domy¶lnym typem pakietu jest
"deb". Informacje o zale¿no¶ciach bibliotek wspó³dzielonych s± oznaczane dla
danego typu pakietu przez poprzedzenie ich nazw± typu, dwukropkiem oraz
bia³ymi znakami (spacjami).
.TP 
\fB\-L\fP\fIlokalny_plik_shlibs\fP
Odczyt nadpisañ informacji o bibliotekach wspó³dzielonych z
\fIlokalnego_pliku_shlibs\fP zamiast \fBdebian/shlibs.local\fP.
.TP 
\fB\-T\fP\fIplik_zmiennych_podst\fP
Zapis zmiennych podstawiania w pliku \fIplik_zmiennych_podst\fP; domy¶lnie jest
to \fBdebian/substvars\fP.
.TP 
\fB\-v\fP
W³±czenie dodatkowych informacji. Wy¶wietlanych jest wiele komunikatów
t³umacz±cych dzia³anie \fBdpkg\-shlibdeps\fP.
.TP 
\fB\-x\fP\fIpakiet\fP
Wy³±czenie pakietu z generowanych zale¿no¶ci. U¿yteczne aby zapobiec
zale¿no¶ciom pakietu od samego siebie dla pakietów dostarczaj±cych binaria
typu ELF (pliki wykonywalne lub biblioteki), które zale¿± od innej
biblioteki zawartej w tym samym pakiecie. Ta opcja mo¿e byæ u¿yta
wielokrotnie aby wy³±czyæ kilka pakietów.
.TP 
\fB\-S\fP\fIkatalog_budowania_pakietu\fP
Przegl±danie najpierw \fIkatalogu_budowania_pakietu\fP przy próbie odnalezienia
biblioteki. Przydatne gdy pakiet ¼ród³owy tworzy wiele odmian tej samej
biblioteki, a chce siê zapewniæ uzyskanie zale¿no¶ci od okre¶lonego pakietu
binarnego. Ta opcja mo¿e byæ u¿yta wielokrotnie: katalogi bêd± przegl±dane w
tej samej kolejno¶ci przed katalogami innych pakietów binarnych.
.TP 
\fB\-\-ignore\-missing\-info\fP
Kontynuacja pomimo braku informacji o zale¿no¶ciach dla biblioteki
wspó³dzielonej. Odradza siê u¿ywanie tej opcji, wszystkie biblioteki powinny
dostarczaæ informacje o zale¿no¶ciach (w postaci plików shlibs lub plików
symboli) \- nawet je¶li nie s± jeszcze u¿ywane przez inne pakiety.
.TP 
\fB\-\-warnings=\fP\fIwarto¶æ\fP
\fIvalue\fP is a bit field defining the set of warnings that can be emitted by
\fBdpkg\-shlibdeps\fP.  Bit 0 (value=1) enables the warning "symbol \fIsym\fP used
by \fIbinary\fP found in none of the libraries", bit 1 (value=2) enables the
warning "package could avoid a useless dependency" and bit 2 (value=4)
enables the warning "\fIbinary\fP should not be linked against \fIlibrary\fP".
The default \fIvalue\fP is 3: the first two warnings are active by default, the
last one is not. Set \fIvalue\fP to 7 if you want all warnings to be active.
.TP 
\fB\-\-admindir=\fP\fIkatalog\fP
Zmienia po³o¿enie bazy danych \fBdpkg\fP. Domy¶lnie jest to \fI/var/lib/dpkg\fP.
.TP 
\fB\-h\fP, \fB\-\-help\fP
Wy¶wietla informacjê o u¿ytkowaniu i koñczy dzia³anie.
.TP 
\fB\-\-version\fP
Wy¶wietla informacjê o wersji i pomy¶lnie koñczy dzia³anie.
.
.SH UWAGI
Poniewa¿ \fBdpkg\-shlibdeps\fP analizuje zbiór symboli u¿ywanych przez ka¿dy
plik binarny generowanego pakietu, jest w stanie wysy³aæ ostrze¿enia w
pewnych przypadkach. Informuj± one o rzeczach, które mog± byæ ulepszone w
pakiecie. W wiêkszo¶ci przypadków dotyczy to bezpo¶rednio oryginalnych
¼róde³. Poni¿ej zebrane s± ostrze¿enia na jakie mo¿na natrafiæ, w kolejno¶ci
malej±cej wa¿no¶ci:
.TP 
\fBw ¿adnej z bibliotek nie znaleziono symbolu\fP\fI symb\fP\fB u¿ywanego przez \fP\fIplik_binarny\fP
Wskazany symbol nie zosta³ odnaleziony w ¿adnej z bibliotek, z którymi jest
linkowany plik binarny. Taki \fIplik_binarny\fP jest najpewniej bibliotek± i
powinien byæ linkowany z dodatkow± bibliotek± podczas budowania pakietu
(opcja \fB\-l\fP\fIbiblioteka\fP linkera).
.TP 
\fIplik_binarny\fP\fB zawiera nierozwi±zywalne odniesienie do symbolu \fP\fIsym\fP\fB: prawdopodobnie jest to wtyczka\fP
Wskazany symbol nie zosta³ odnaleziony w ¿adnej z bibliotek, z którymi jest
linkowany plik binarny. Taki \fIplik_binarny\fP jest najpewniej wtyczk± i jest
prawdopodobnie dostarczany wraz z programem, który ³adujê tak±
wtyczkê. Teoretycznie wtyczka nie powinna mieæ pola SONAME, jednak ten plik
binarny je posiada i nie mo¿na go zidentyfikowaæ na tej podstawie. Fakt, i¿
plik ten jest umieszczony w niepublicznym katalogu mocno wskazuje na to, ¿e
nie jest on zwyk³± bibliotek± wspó³dzielon±. Je¶li plik binarny rzeczywi¶cie
jest wtyczk±, mo¿na pomin±æ to ostrze¿enie. Jednak zawsze istnieje
mo¿liwo¶æ, ¿e jest to biblioteka i programy z ni± linkowane u¿ywaj± RPATH,
aby dynamiczny loader by³ w stanie j± odnale¼æ. W takim przypadku bibliotekê
mo¿na uznaæ za zepsut± i nale¿y j± naprawiæ.
.TP 
\fBpackage could avoid a useless dependency if \fP\fIbinary\fP\fB was not linked against \fP\fIlibrary\fP\fB (it uses none of the library's symbols)\fP
¯aden z \fIplików_binarnych\fP, które s± linkowane z \fIbibliotek±\fP nie u¿ywa
symboli przez ni± udostêpnianych. Poprawiaj±c wszystkie pliki binarne mo¿na
unikn±æ zale¿no¶ci zwi±zanych z t± bibliotek± (chyba, ¿e taka sama zale¿no¶æ
jest równie¿ generowana przez inn± bibliotekê, która jest faktycznie
u¿ywana).
.TP 
\fBpackage could avoid a useless dependency if \fP\fIbinaries\fP\fB were not linked against \fP\fIlibrary\fP\fB (they uses none of the library's symbols)\fP
Exactly the same as the above warning, but for multiple binaries.
.TP 
\fIbinary\fP\fB should not be linked against \fP\fIlibrary\fP\fB (it uses none of the library's symbols)\fP
\fIplik_binarny\fP jest linkowany z bibliotek±, której nie potrzebuje. Nie jest
to problem, ale mo¿na uzyskaæ pewn± poprawê wydajno¶ci czasu ³adowania pliku
binarnego, je¶li biblioteka ta nie bêdzie z nim linkowana. To ostrze¿enie
sprawdza te same informacje co poprzednie, ale wykonuje to dla ka¿dego pliku
binarnego zamiast wykonywania globalnego sprawdzenia dla wszystkich
analizowanych plików.
.SH B£ÊDY
\fBdpkg\-shlibdeps\fP przerwie dzia³anie z b³êdem je¶li nie bêdzie w stanie
znale¼æ publicznej biblioteki u¿ywanej przez plik binarny, lub je¶li
biblioteka taka nie bêdzie mieæ powi±zanej informacji o zale¿no¶ciach (pliku
shlibs lub pliku symboli). Publiczne biblioteki maj± SONAME i s±
wersjonowane (jak np. libsomething.so.\fIX\fP). Biblioteki prywatne (jak
np. wtyczki) nie powinny mieæ SONAME i nie musz± byæ wersjonowane.
.TP 
\fBnie mo¿na znale¼æ biblioteki \fP\fIsoname\-biblioteki\fP\fB potrzebnej dla \fP\fIpliku_binarnego\fP\fB (RPATH to "\fP\fIrpath\fP\fB")\fP
The \fIbinary\fP uses a library called \fIlibrary\-soname\fP but \fBdpkg\-shlibdeps\fP
has been unable to find the library.  \fBdpkg\-shlibdeps\fP creates a list of
directories to check as following: directories listed in the RPATH of the
binary, directories listed in /etc/ld.so.conf, directories listed in the
LD_LIBRARY_PATH environment variable, and standard public directories (/lib,
/usr/lib, /lib32, /usr/lib32, /lib64, /usr/lib64). Then it checks those
directories in the package's build tree of the binary being analyzed, in the
packages' build trees indicated with the \-S command\-line option, in other
packages' build trees that contains a DEBIAN/shlibs or DEBIAN/symbols file
and finally in the root directory.  If the library is not found in any of
those directories, then you get this error.

Je¶li nie odnaleziona biblioteka jest w prywatnym katalogu tego samego
pakietu, nale¿y dodaæ taki katalog do LD_LIBRARY_PATH. Je¶li biblioteka jest
w innym budowanym binarnym pakiecie, nale¿y upewniæ siê, ¿e plik shlibs lub
plik symboli dla tego pakietu zosta³ stworzony oraz, ¿e LD_LIBRARY_PATH
zawiera odpowiedni katalog je¶li biblioteka tak¿e jest w katalogu prywatnym.
.TP 
\fBnie znaleziono informacji o zale¿no¶ciach dla \fP\fIplik\-biblioteki\fP\fB (u¿ywanego przez \fP\fIplik\-binarny\fP\fB).\fP
Biblioteka wymagana przez \fIplik\-binarny\fP zosta³a znaleziona przez
\fBdpkg\-shlibdeps\fP w \fIpliku\-biblioteki\fP, ale \fBdpkg\-shlibdeps\fP nie móg³
odnale¼æ ¿adnej informacji o zale¿no¶ciach dla tej biblioteki. Aby okre¶liæ
zale¿no¶ci, podjêto próbê u¿ycia \fBdpkg \-S\fP\fIplik\-biblioteki\fP w celu
okre¶lenia pakietu dostarczaj±cego dan± bibliotekê. Nastêpnie sprawdzono
odpowiednie pliki shlibs i pliki symboli w /var/lib/dpkg/info/ oraz w
ró¿nych drzewach budowania pakietów (debian/*/DEBIAN/).

To niepowodzenie mo¿e byæ spowodowane przez niepoprawny lub nieistniej±cy
plik shlibs lub plik symboli w pakiecie biblioteki. Mo¿e siê równie¿ zdarzyæ
je¶li biblioteka jest budowana wewn±trz tego samego pakietu ¼ród³owego, a
pliki shlibs jeszcze nie zosta³y stworzone (w takim przypadku nale¿y
poprawiæ debian/rules aby shlibs by³y tworzone przed wywo³aniem
\fBdpkg\-shlibdeps\fP). Niew³a¶ciwa warto¶æ RPATH mo¿e równie¿ powodowaæ, ¿e
biblioteka zostanie odnaleziona pod nietypow± nazw±, która nie jest zwi±zana
z ¿adnym pakietem (np. /usr/lib/openoffice.org/../lib/libssl.so.0.9.8
zamiast /usr/lib/libssl.so.0.9.8). \fBdpkg\-shlibdeps\fP próbuje poradziæ sobie
z tym staraj±c siê odczytaæ nazwê kanoniczn± (z u¿yciem \fBrealpath\fP(3)) ale
mo¿e to nie zawsze zadzia³aæ. Aby unikn±æ problemów, najlepiej jest zawsze
doprowadziæ do porz±dku RPATH pliku binarnego.

Wywo³anie \fBdpkg\-shlibdeps\fP w trybie rozszerzonej informacji (\-v) dostarcza
wielu dodatkowych informacji o tym, gdzie próbowa³ on znale¼æ informacjê o
zale¿no¶ciach. Mo¿e to byæ przydatne je¶li nie wiadomo dlaczego zwracany
jest ten b³±d.
.SH "ZOBACZ TAK¯E"
\fBdeb\-shlibs\fP(5), \fBdeb\-symbols\fP(5), \fBdpkg\-gensymbols\fP(1).
.SH "T£UMACZE"
Piotr Roszatycki <dexter@debian.org>, 1999
.br
Bartosz Feñski <fenio@debian.org>, 2004-2005
.br
Robert Luberda <robert@debian.org>, 2006-2008
.br
Wiktor Wandachowicz <siryes@gmail.com>, 2008