Linux Certif

Toute la documentation sur la certification Linux LPI

deb-substvars

NAZWA

deb-substvars - zmienne podstawiania Œród³owych pakietów Debiana

SK£ADNIA

substvars

OPIS

Zanim dpkg-source, dpkg-gencontrol i dpkg-genchanges zapisz± swoje informacje kontrolne (do Œród³owego pliku .dsc w wypadku dpkg-source i na standardowe wyj¶cie w wypadku dpkg-gencontrol i dpkg-genchanges), wykonuj± podstawienia pewnych zmiennych na pliku wyj¶ciowym.

Podstawienie zmiennej ma postaæ ${nazwa-zmiennej}. Nazwy zmiennych sk³adaj± siê ze znaków alfanumerycznych, my¶lników oraz dwukropków i zaczynaj± siê od znaku alfanumerycznego. Podstawienia zmiennych s± powtarzane dopóty, a¿ nie bêdzie nic do podstawienia; pe³en tekst pola po podstawieniu jest ponownie skanowany w poszukiwaniu kolejnych podstawieñ.

Po dokonaniu wszystkich podstawieñ, ka¿de wyst±pienie ³añcucha ${} (który nie jest poprawnym podstawieniem) jest zastêpowane przez znak $.

Podstawianie zmiennych jest wykonywane na wszystkich polach kontrolnych, jednak niektóre z tych pól s± u¿ywane oraz wymagane podczas budowania, gdy podstawienie nie zosta³o jeszcze wykonane. Dlatego nie mo¿na u¿ywaæ zmiennych w polach Package, Source oraz Architecture.

Variable substitution happens on the content of the fields after they have been parsed, thus if you want a variable to expand over multiple lines you do not have to include a space after the newline. This is done implicitly when the field is output. For example, if the variable ${Description} is set to "foo is bar.${Newline}foo is great." and if you have the following field:

 Description: foo application
  ${Description}
  .
  More text.

It will result in:

 Description: foo application
  foo is bar.
  foo is great.
  .
  More text.

Zmienne mo¿na ustawiæ za pomoc± opcji -V. Mo¿na je tak¿e podaæ w pliku debian/substvars (lub jakimkolwiek innym pliku wskazanym opcj± -T). Plik ten sk³ada siê z linii w postaci nazwa=warto¶æ. Koñcowe spacje w ka¿dej linii, linie puste oraz linie zaczynaj±ce siê od znaku # (czyli komentarze) s± ignorowane.

Dodatkowo dostêpne s± nastêpuj±ce standardowe zmienne:

Arch

Bie¿±ca architektura budowania (z dpkg --print-architecture).

source:Version

Wersja pakietu Œród³owego

source:Upstream-Version

Oryginalna wersja autora pakietu Œród³owego, w³±czaj±c wersjê epoki Debiana je¶li jest.

binary:Version

Wersja pakietu binarnego (mo¿e siê ró¿niæ od source:Version na przyk³ad w przypadku binNMU).

Source-Version

Wersja pakietu Œród³owego (z dziennika zmian). Ta zmienna jest obecnie przestarza³a, jako ¿e jej znaczenie jest inne ni¿ jej funkcjonalno¶æ. Prosimy u¿ywaæ source:Version lub binary:Version, w zale¿no¶ci od wymagañ.

Installed-Size

Ca³kowity rozmiar plików zainstalowanych przez pakiet. Warto¶æ ta jest kopiowana do odpowiadaj±cego jej pola w pliku kontrolnym; ustawienie jej zmodyfikuje warto¶æ tego pola. Je¶li nie ustawiono zmiennej, to dpkg-gencontrol u¿yje du -k debian/tmp, aby znaleŒæ jej warto¶æ domy¶ln±.

Extra-Size

Dodatkowa przestrzeñ dyskowa, u¿ywana podczas instalowania pakietu. Je¶li ta zmienna jest ustawiona, to jej warto¶æ jest dodawana do warto¶ci zmiennej Installed-Size (niezale¿nie od tego, czy zosta³a otwarcie ustawiona, czy ma warto¶æ domy¶ln±), zanim zostania skopiowana do pola Installed-Size pliku kontrolnego.

F:nazwa-pola

Warto¶æ pola wyj¶ciowego nazwa_pola (które musi byæ podane z u¿yciem Notacji-Wielb³±dziej). Ustawienie takich zmiennych wp³ywa tylko na miejsca, gdzie s± one jawnie rozwijane.

Format

Wersja formatu pliku .changes wygenerowana przez tê wersjê skryptów przygotowuj±cych pakiety Œród³owe. Ustawienie tej zmiennej zmienia równie¿ zawarto¶æ pola Format w pliku .changes.

Newline, Space, Tab

Ka¿da z tych zmiennych zawiera odpowiadaj±cy jej znak.

shlibs:pole-zale¿no¶ci

Ustawienia zmiennych w tej postaci s± generowane przez dpkg-shlibdeps.

dpkg:Upstream-Version

Oryginalna wersja dpkg, nadana przez autorów.

dpkg:Version

Pe³na wersja programu dpkg.

Je¿eli jest odwo³anie do niezdefiniowanej zmiennej, to generowane jest ostrze¿enie i przyjmowana jest pusta warto¶æ zmiennej.

PLIKI

debian/substvars

Lista zmiennych podstawiania i ich warto¶ci.

B£ÊDY

Punkt, w którym nastêpuje nadpisywanie pól w porównaniu do pewnych standardowych ustawieñ pól wyj¶ciowych jest do¶æ zagmatwany.

ZOBACZ TAK¯E

dpkg(1), dpkg-genchanges(1), dpkg-gencontrol(1), dpkg-shlibdeps(1), dpkg-source(1).

AUTOR

Copyright © 1995-1996 Ian Jackson
Copyright © 2000 Wichert Akkerman

Niniejszy program jest oprogramowaniem wolnym, sprawdŒ Powszechn± Licencjê Publiczn± GNU w wersji drugiej lub póŒniejszej, by dowiedzieæ siê o warunkach dystrybucji. Brak JAKIEJKOLWIEK gwarancji.

T£UMACZE

Piotr Roszatycki <dexter@debian.org>, 1999
Bartosz Feñski <fenio@debian.org>, 2004-2005
Robert Luberda <robert@debian.org>, 2006-2008
Wiktor Wandachowicz <siryes@gmail.com>, 2008