NAZWA

       forktracer.conf - konfiguracja programu apt-forktracer

OPIS

       Program  apt-forktracer  zgłasza "niestandardowe" pakiety zainstalowane w systemie.  Pliki konfiguracyjne
       tego programu umożliwiają ignorowanie (pominięcie zgłaszania) wybranych z nich,  o  ile  spełniają  pewne
       warunki.   Program  czyta  plik  /etc/apt/forktracer.conf  oraz  pliki  /etc/apt/forktracer.d/*.conf  (za
       wyjątkiem plików ukrytych).

       Plik konfiguracyjny składa się z  dowolnej  ilości  zwrotek,  rozdzielonych  jedną  lub  wieloma  pustymi
       liniami.  Format zwrotki jest następujący:

           Package: pakiet
           Accept-Origin: źródło1
           Track-Origin: źródło2
           Track-Version: wersja

       Wszystkie linie w zwrotce są wymagane, a ich znaczenie jest następujące:

       pakiet nazwa pakietu, którego dotyczy dana zwrotka

       źródło1
              wartość  pola  Origin źródła, z którego należy ignorować dany pakiet. Pakiet zostanie zignorowany,
              jeśli jego kandydująca wersja pochodzi ze źródła1, i jednocześnie spełniony jest  warunek  dany  w
              polach  Track-*.   Specjalna wartość * oznacza, że należy ignorować pakiet niezależnie od źródła z
              którego pochodzi wersja kandydująca.

       źródło2
              wartość pola Origin źródła, którego najnowszą wersję należy śledzić. Specjalna wartość *  oznacza,
              że należy śledzić ogólnie najnowszą dostępną wersję.

       wersja to wymagany numer najnowszej wersji dostępnej ze źródła źródło2.  Oprócz dosłownego numeru wersji,
              można  tu także użyć jednej z dwóch wartości specjalnych: =candidate - oznaczająca aktualną wersję
              kandydującą, oraz =candidate-base - oznaczająca wersję podstawową (patrz niżej)  aktualnej  wersji
              kandydującej.

       Powyższa  zwrotka powoduje pominięcie pakietu pakiet z wyjścia programu, o ile kandydująca wersja pakietu
       pochodzi ze źródła źródło1, i jednocześnie najnowsza wersja tegoż pakietu dostępna ze źródła źródło2 jest
       równa wersja.

       Jeśli dla danego pakietu istnieje więcej niż jedna zwrotka, to jest on pomijany jeśli choć jedna  z  nich
       pasuje do obecnej sytuacji.

   Definicja wersji podstawowej
       Wersję  podstawową  uzyskuje  się poprzez obcięcie z końca danej wersji najkrótszego napisu zaczynającego
       się od tyldy. Na przykład dla wersji 1:1.2-3~4~5 wersja podstawowa to 1:1.2-3~4.

   Konfiguracja domyślna
       Jeśli dla pewnego pakietu pakiet nie ma żadnej zwrotki w  konfiguracji,  to  program  działa  tak,  jakby
       istniały następujące dwie zwrotki:

           Package: pakiet
           Accept-Origin: *
           Track-Origin: dystrybutor
           Track-Version: =candidate

           Package: pakiet
           Accept-Origin: *
           Track-Origin: dystrybutor
           Track-Version: =candidate-base

       gdzie  dystrybutor  to identyfikator dystrybutora systemu, określony przez wynik komendy lsb_release --id
       lub przez pole DISTRIB_ID w pliku /etc/lsb-release.

PRZYKŁADY

   Nieoficjalny pakiet
       apt-forktracer zgłasza pakiety niedostępne z żadnego źródła oficjalnego, na przykład:

           puppet-softwarelab (0.2) [SoftwareLab: 0.2 0.1]

       Aby tego uniknąć, należy dodać do pliku konfiguracyjnego następującą zwrotkę:

           Package: puppet-softwarelab
           Accept-Origin: SoftwareLab
           Track-Origin: *
           Track-Version: =candidate

       Jeśli dodatkowo "przypniemy" pakiet do źródła "release o=Softwarelab", to taka konfiguracja spowoduje, że
       apt-forktracer ostrzeże nas, jeśli w jakimś innym źródle pojawi się taki  pakiet  w  wersji  nowszej  niż
       dostępne ze źródła SoftwareLab.

   Backport
       Instalacja backportu ma podobny efekt jak instalacja pakietu nieoficjalnego:

           spamc (3.2.3-0.volatile1) [Debian: 3.1.7-2] [volatile.debian.org: 3.2.3-0.volatile1]

       Aby wymusić pomijanie tego pakietu, należy dodać analogiczną zwrotkę do konfiguracji:

           Package: spamc
           Accept-Origin: volatile.debian.org
           Track-Origin: *
           Track-Version: =candidate

       W  tej  sytuacji  niewielka  zmiana  wersji  pakietu oficjalnego (na przykład na 3.1.7-2etch1) pozostanie
       niezauważona. Konfiguracja ta nadaje się więc wyłącznie w przypadkach, gdy ufamy, że osoba udostępniająca
       zainstalowany przez nas backport śledzi zmiany wersji stabilnej i będzie  wydawać  poprawione  backporty,
       zawierające  niezbędne  zmiany  z  edycji  stabilnej.   Jeśli  nie  mamy  takiego  zaufania,  należy użyć
       następującej konfiguracji.

   Własne poprawki
       Czasami pojawia się sytuacja, gdy wprowadziliśmy do pakietu niewielkie poprawki, i chcemy  wiedzieć,  gdy
       pojawi się nowsza wersja oficjalna, aby móc utworzyć nową wersję poprawioną.

           policyd-weight (0.1.14-beta-6etch2.0.sl.1) [Debian: 0.1.14-beta-6etch2] [SoftwareLab: 0.1.14-beta-6etch2.0.sl.1]

       Jest wtedy przydatna poniższa konfiguracja:

           Package: policyd-weight
           Accept-Origin: SoftwareLab
           Track-Origin: Debian
           Track-Version: 0.1.14-beta-6etch2

       Warto  zauważyć, że jeśli tworząc poprawioną wersję pakietu zastosujemy się do pewnej konwencji numeracji
       wersji, to do uzyskania tego efektu wystarczy opisana  wyżej  Konfiguracja  domyślna.   W  tym  przypadku
       wystarczyłoby  nadać pakietowi wersję 0.1.14-beta-6etch2~sl.1 i powyższa zwrotka konfiguracji stałaby się
       zbędna.  Co ważniejsze, odpada wtedy konieczność aktualizacji konfiguracji przy  wydawaniu  nowej  wersji
       pakietu, ponieważ konfiguracja domyślna jest generowana automatycznie na podstawie obecnej sytuacji.

PLIKI

       /etc/apt/forktracer.conf
       /etc/apt/forktracer.d/*.conf

PATRZ TEŻ

       apt-cache(8), apt-forktracer(8), apt_preferences(5).

Projekt Debian                                     2008-11-16                                 FORKTRACER.CONF(5)