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).