apt-ftparchive — Online w chmurze

PROGRAM:

IMIĘ

apt-ftparchive - Narzędzie do generowania plików indeksowych

STRESZCZENIE

apt-ftparchive [-dsq] [--md5] [--usuń łącze] [--tylko czytać] [--zawartość] [--łuk architektura]
[-o=ciąg_konfiguracji] [-c=plik_konfiguracyjny]
{pakiety ścieżka... [zastąp plik [przedrostek ścieżki]] |
źródła ścieżka... [zastąp plik [przedrostek ścieżki]] | zawartość ścieżka |
zwolnić ścieżka | Generować plik_konfiguracyjny Sekcja... | czysty plik_konfiguracyjny |
{-v | --wersja} | {-h | --pomoc}}

OPIS

apt-ftparchive to narzędzie wiersza poleceń, które generuje pliki indeksu używane przez APT
uzyskać dostęp do źródła dystrybucji. Pliki indeksu powinny być generowane na podstawie witryny źródłowej
na zawartość tej witryny.

apt-ftparchive jest nadzbiorem dpkg-scanpackages(1) program obejmujący jego całość
funkcjonalność za pomocą polecenia pakiety. Zawiera także generator plików zawartości,
treści oraz wyszukane sposoby „skryptowania” procesu generowania w celu uzyskania kompletnego pliku
archiwum.

Wewnętrznie apt-ftparchive może używać binarnych baz danych do buforowania zawartości pliku .deb
i nie opiera się na żadnych zewnętrznych programach poza gzip(1). Podczas wykonywania pełnego
generate it automatycznie sprawdza zmiany plików i tworzy żądaną skompresowaną wersję
pliki wyjściowe.

Dopóki -hlub --help opcja jest podana, musi występować jedno z poniższych poleceń.

Pakiety
Komenda package generuje plik pakietu z drzewa katalogów. To zajmuje
podany katalog i rekurencyjnie przeszukuje go w poszukiwaniu plików .deb, emitując rekord pakietu
na standardowe wyjście dla każdego. To polecenie jest w przybliżeniu równoważne dpkg-scanpackages(1).

Opcja --db. można użyć do określenia binarnej bazy danych buforującej.

źródła
Polecenie źródła generuje plik indeksu źródłowego z drzewa katalogów. To zajmuje
podany katalog i rekurencyjnie przeszukuje go w poszukiwaniu plików .dsc, emitując rekord źródłowy
na standardowe wyjście dla każdego. To polecenie jest w przybliżeniu równoważne dpkg-scansources(1).

Jeśli określono plik zastąpień, będzie wyszukiwany plik źródłowy
rozszerzenie .src. Opcji --source-override można użyć do zmiany źródła
zastąpić plik, który będzie używany.

treść
Polecenie content generuje plik zawartości z drzewa katalogów. To zajmuje
podany katalog i rekursywnie przeszukuje go w poszukiwaniu plików .deb i odczytuje listę plików
z każdego pliku. Następnie sortuje i zapisuje na standardowe wyjście listę dopasowanych plików
pakiety. Katalogi nie są zapisywane na wyjściu. Jeśli wiele pakietów posiada to samo
file, wówczas każdy pakiet jest oddzielony przecinkiem na wyjściu.

Opcja --db. można użyć do określenia binarnej bazy danych buforującej.

zwolnić
Polecenie release generuje plik Release z drzewa katalogów. To rekurencyjnie
przeszukuje podany katalog w poszukiwaniu nieskompresowanych plików Packages i Sources
skompresowany z gzip, bzip2 or Izma a także domyślnie pliki Release i md5sum.txt
(APT::FTPArchive::Release::Default-Patterns). Dodatkowe wzorce nazw plików mogą być
dodane poprzez wypisanie ich w APT::FTPArchive::Release::Patterns. Następnie zapisuje na standardowe wyjście
plik wydania zawierający (domyślnie) skrót MD5, SHA1, SHA256 i SHA512 dla każdego
plik.

Wartości dodatkowych pól metadanych w pliku Release są pobierane z pliku
odpowiednie zmienne w APT::FTPArchive::Release, np
APT::FTPArchive::Release::Origin. Obsługiwane pola to: Pochodzenie, Etykieta, Pakiet,
Wersja, nazwa kodowa, data, ważność do momentu, architektury, komponenty, opis.

Generować
Komenda generate została zaprojektowana tak, aby można ją było uruchomić ze skryptu cron i zbudować indeksy
zgodnie z podanym plikiem konfiguracyjnym. Język konfiguracji zapewnia elastyczne możliwości
określenie, które pliki indeksu są zbudowane z jakich katalogów, a także udostępnienie pliku
prosty sposób utrzymania wymaganych ustawień.

kleń
Polecenie clean porządkuje bazy danych używane przez dany plik konfiguracyjny według
usunięcie wszelkich zapisów, które nie są już potrzebne.

THE GENEROWAĆ KONFIGURACJA

Komenda generate używa pliku konfiguracyjnego do opisania archiwów, które mają zostać utworzone
zostać wygenerowany. Jest zgodny z typowym formatem konfiguracji ISC, jak widać w narzędziach ISC, takich jak
bind 8 i dhcpd. apt.konf(5) zawiera opis składni. Należy pamiętać, że
Generacja konfiguracji jest analizowana w sposób przekrojowy, ale apt.konf(5) jest analizowany w drzewie
sposób. Ma to wpływ tylko na sposób obsługi znacznika zakresu.

Konfiguracja generowania składa się z czterech oddzielnych sekcji, z których każda została opisana poniżej.

Państwo Sekcja
Sekcja Dir definiuje standardowe katalogi potrzebne do zlokalizowania wymaganych plików
podczas procesu generacji. Do katalogów tych dołączone są pewne ścieżki względne
zdefiniowane w późniejszych sekcjach, aby utworzyć pełną ścieżkę bezwzględną.

ArchiwumDir
Określa katalog główny archiwum FTP. W standardowej konfiguracji Debiana jest to katalog główny
katalog zawierający węzły ls-LR i dist.

ZastąpićDir
Określa lokalizację plików zastąpień.

Katalog pamięci podręcznej
Określa lokalizację plików pamięci podręcznej.

KatalogListaPlików
Określa lokalizację plików listy plików, jeśli poniżej użyto ustawienia FileList.

Domyślnie Sekcja
Sekcja Domyślne określa wartości domyślne i ustawienia sterujące działaniem
generator. Inne sekcje mogą zastąpić te ustawienia domyślne ustawieniem dla poszczególnych sekcji.

Pakiety::Kompresuj
Ustawia domyślne schematy kompresji używane dla plików indeksu pakietów. To jest
ciąg znaków zawierający listę oddzielonych spacjami co najmniej jednego z: '.' (bez kompresji),
„gzip” i „bzip2”. Domyślną wartością dla wszystkich schematów kompresji jest „. gzip'.

Pakiety::Rozszerzenia
Ustawia domyślną listę rozszerzeń plików będących plikami pakietów. Domyślnie jest to
„.deb”.

Źródła::Compress
Jest to podobne do Packages::Compress, z tą różnicą, że kontroluje kompresję pliku
Pliki źródłowe.

Źródła::Rozszerzenia
Ustawia domyślną listę rozszerzeń plików będących plikami źródłowymi. Domyślnie jest to
„.dsc”.

Zawartość::Kompresuj
Jest to podobne do Packages::Compress, z tą różnicą, że kontroluje kompresję pliku
Pliki zawartości.

Tłumaczenie::Kompresuj
Jest to podobne do Packages::Compress, z tą różnicą, że kontroluje kompresję pliku
Tłumaczenie-en plik główny.

OdłączLimit
Określa liczbę kilobajtów do usunięcia (i zastąpienia twardymi łączami) na przebieg.
Jest to używane w połączeniu z ustawieniem Linki zewnętrzne dla poszczególnych sekcji.

Tryb pliku
Określa tryb wszystkich utworzonych plików indeksu. Domyślnie jest to 0644. Wszystkie pliki indeksu
są ustawione na ten tryb bez względu na maskę umask.

Długi opis
Określa, czy długie opisy powinny być zawarte w pliku Packages, czy też podzielone
do głównego pliku Translation-en.

DrzewoDomyślne Sekcja
Ustawia wartości domyślne specyficzne dla sekcji drzewa. Wszystkie te zmienne są zmiennymi substytucyjnymi
i zastąp ciągi $(DIST), $(SECTION) i $(ARCH) odpowiednimi ciągami
wartości.

Maksymalna zawartośćZmień
Ustawia liczbę kilobajtów plików zawartości generowanych każdego dnia. The
pliki zawartości są przetwarzane okrężnie, więc w ciągu kilku dni wszystkie zostaną odbudowane.

Spis treści Wiek
Kontroluje liczbę dni, przez które plik zawartości może być sprawdzany bez zmian.
Jeśli ten limit zostanie przekroczony, mtime pliku zawartości zostanie zaktualizowany. Taki przypadek może mieć miejsce
jeśli plik pakietu zostanie zmieniony w sposób nie powodujący nowej zawartości
plik [na przykład zastąp edycję]. Wstrzymanie jest dozwolone w nadziei, że nowe .debs to zrobią
zostać zainstalowany, co i tak wymaga nowego pliku. Wartość domyślna to 10, jednostkami są dni.

Informator
Ustawia górę drzewa katalogów .deb. Domyślnie
$(DIST)/$(SECTION)/binarny-$(ARCH)/

Katalog Src
Ustawia górę drzewa katalogów pakietu źródłowego. Domyślnie
$(ODKŁAD)/$(SEKCJA)/źródło/

pakiety
Ustawia wyjściowy plik pakietów. Domyślnie $(DIST)/$(SECTION)/binary-$(ARCH)/Pakiety

Źródła
Ustawia wyjściowy plik źródłowy. Domyślnie $(DIST)/$(SECTION)/źródło/Źródła

Tłumaczenie
Ustawia wyjściowy plik główny Translation-en z długimi opisami, jeśli powinny
nie zostaną uwzględnione w pliku Packages. Domyślnie
$(DIST)/$(SECTION)/i18n/Translation-en

Wewnętrzny prefiks
Ustawia przedrostek ścieżki, który powoduje, że dowiązanie symboliczne jest traktowane jako łącze wewnętrzne
linku zewnętrznego. Domyślnie $(ODKR)/$(SEKCJA)/

Spis treści
Ustawia wyjściowy plik zawartości. Domyślnie $(DIST)/$(SECTION)/Contents-$(ARCH). Jeśli
to ustawienie powoduje, że wiele plików pakietów jest mapowanych na pojedynczy plik zawartości (tak jak jest
domyślnie). apt-ftparchive zintegruje ze sobą te pliki pakietów
automatycznie.

Spis treści::Nagłówek
Ustawia plik nagłówkowy, który ma być dodawany do wyjściowej zawartości.

BinCacheDB
Ustawia binarną bazę danych pamięci podręcznej, która będzie używana w tej sekcji. Wiele sekcji może być udostępnianych
ta sama baza danych.

Lista plików
Określa, że ​​zamiast chodzić po drzewie katalogów, apt-ftparchive powinien przeczytać
lista plików z danego pliku. Względne nazwy plików są poprzedzone nazwą archiwum
katalogiem.

Lista plików źródłowych
Określa, że ​​zamiast chodzić po drzewie katalogów, apt-ftparchive powinien przeczytać
lista plików z danego pliku. Względne nazwy plików są poprzedzone nazwą archiwum
informator. Jest to używane podczas przetwarzania indeksów źródłowych.

Drzewo Sekcja
Sekcja Drzewo definiuje standardowe drzewo plików Debiana, które składa się z katalogu podstawowego,
następnie wiele sekcji w tym katalogu podstawowym i na koniec wiele architektur w każdej
Sekcja. Dokładna używana ścieżka jest definiowana przez zmienną podstawienia katalogu.

Sekcja Drzewo przyjmuje znacznik zakresu, który ustawia zmienną $(DIST) i definiuje korzeń
drzewo (ścieżka jest poprzedzona przez ArchiveDir). Zazwyczaj jest to ustawienie takie jak
dyst/jessie.

Wszystkie ustawienia zdefiniowane w sekcji TreeDefault mogą być użyte w sekcji Drzewo jako
a także trzy nowe zmienne.

Podczas przetwarzania sekcji drzewa apt-ftparchive wykonuje operację podobną do:

bo ja w sekcjach tak
dla j w Architekturze tak
Generuj dla DIST=zakres SECTION=i ARCH=j

sekcje
To jest oddzielona spacjami lista sekcji, które pojawiają się pod dystrybucją;
zazwyczaj jest to coś w rodzaju głównego wkładu niewolnego

Architektur
Jest to rozdzielona spacjami lista wszystkich architektur pojawiających się podczas wyszukiwania
Sekcja. Specjalna architektura „źródło” służy do wskazania, że ​​to drzewo ma
archiwum źródłowe. Architektura „all” sygnalizuje, że konkretne pliki architektury lubią
Pakiety nie powinny zawierać informacji o architekturze wszystkich pakietów we wszystkich plikach
ponieważ będą one dostępne w dedykowanym pliku.

Długi opis
Określa, czy długie opisy powinny być zawarte w pliku Packages, czy też podzielone
do głównego pliku Translation-en.

BinZastąp
Ustawia plik zastąpień binarnych. Plik zastąpień zawiera sekcję, priorytet i
dane adresowe opiekuna.

SrcOverride
Ustawia źródłowy plik zastępujący. Plik zastąpień zawiera informacje o sekcji.

Dodatkowe zastąpienie
Ustawia dodatkowy plik binarny zastępujący.

SrcExtraOverride
Ustawia dodatkowy plik zastąpień źródłowych.

Katalog Bin Sekcja
Sekcja bindirectory definiuje drzewo katalogów binarnych bez specjalnej struktury. The
Znacznik zasięgu określa lokalizację katalogu binarnego, a ustawienia są podobne do
sekcję Drzewo bez zmiennych zastępczych i ustawień SessionArchitecture.

pakiety
Ustawia dane wyjściowe pliku Packages.

Źródła
Ustawia wyjście pliku źródłowego. Wymagany jest co najmniej jeden z pakietów lub źródeł.

Spis treści
Ustawia wyjście pliku zawartości (opcjonalnie).

BinZastąp
Ustawia plik zastąpień binarnych.

SrcOverride
Ustawia źródłowy plik zastępujący.

Dodatkowe zastąpienie
Ustawia dodatkowy plik binarny zastępujący.

SrcExtraOverride
Ustawia dodatkowy plik zastąpień źródłowych.

BinCacheDB
Ustawia bazę danych pamięci podręcznej.

Prefiks ścieżki
Dołącza ścieżkę do wszystkich ścieżek wyjściowych.

Lista plików, Lista plików źródłowych
Określa plik listy plików.

THE BINARY NADPISANIE FILE

Binarny plik zastępujący jest w pełni kompatybilny z dpkg-scanpackages(1). Zawiera cztery
pola oddzielone spacjami. Pierwsze pole to nazwa pakietu, drugie to
priorytet, aby wymusić działanie tego pakietu, trzecia to sekcja, w której należy wymusić wymuszenie tego pakietu i
ostatnim polem jest pole permutacji opiekuna.

Ogólna postać pola opiekuna to:

stary [// stary]* => nowy

lub po prostu,

nowa

Pierwsza forma pozwala na rozdzielenie podwójnymi ukośnikami listy starych adresów e-mail
określony. Jeśli którykolwiek z nich zostanie znaleziony, pole opiekuna zostanie zastąpione nowym. The
druga forma bezwarunkowo zastępuje pole opiekuna.

THE ŹRÓDŁO NADPISANIE FILE

Plik zastępowania źródła jest w pełni kompatybilny z dpkg-scansources(1). Zawiera dwa
pola oddzielone spacjami. Pierwsze pole to nazwa pakietu źródłowego, drugie to
sekcję, aby ją przypisać.

THE DODATKOWY NADPISANIE FILE

Dodatkowy plik zastąpień umożliwia dodanie lub zastąpienie dowolnego dowolnego znacznika w wynikach. To
ma trzy kolumny, pierwsza to pakiet, druga to tag, a reszta
linia oznacza nową wartość.

OPCJE

Wszystkie opcje wiersza poleceń można ustawić za pomocą pliku konfiguracyjnego, opisów
wskazać opcję konfiguracji do ustawienia. W przypadku opcji logicznych możesz nadpisać konfigurację
plik, używając czegoś takiego jak -F-,--nie-f, -f=nie lub kilka innych odmian.

--md5, --sha1, --sha256, --sha512
Wygeneruj podaną sumę kontrolną. Opcje te są domyślnie włączone, gdy są wyłączone
wygenerowane pliki indeksu, tam gdzie to możliwe, nie będą miały pól sumy kontrolnej. Konfiguracja
Elementy: APT::FTPArchive::Suma kontrolna i APT::FTPArchive::wskaźnik::Suma kontrolna gdzie wskaźnik mogą
być pakietami, źródłami lub wydaniami Suma kontrolna może być MD5, SHA1, SHA256 lub SHA512.

-d, --db.
Użyj binarnej bazy danych buforującej. Nie ma to wpływu na polecenie generowania. Konfiguracja
Pozycja: APT::FTPArchive::DB.

-q, --cichy
Cichy; generuje dane wyjściowe odpowiednie do rejestrowania, pomijając wskaźniki postępu. Więcej pytań
wyprodukuje ciszej maksymalnie do 2. Możesz także użyć -q=# ustawić ciszę
poziomie, zastępując plik konfiguracyjny. Element konfiguracji: cichy.

--usuń łącze
Wykonaj usuwanie linków. Jeśli używane jest ustawienie Linki zewnętrzne, faktycznie jest to ta opcja
umożliwia rozłączenie plików. Domyślnie jest włączone i można je wyłączyć za pomocą
--nie-usuwania. Element konfiguracji: APT::FTPArchive::DeLinkAct.

--zawartość
Wykonaj generowanie treści. Gdy ta opcja jest ustawiona i indeksowane są pakiety
wygenerowany za pomocą bazy danych pamięci podręcznej, wówczas lista plików również zostanie wyodrębniona i zapisana
DB do późniejszego wykorzystania. W przypadku korzystania z polecenia generowania ta opcja umożliwia również
tworzenie dowolnych plików zawartości. Wartość domyślna jest włączona. Element konfiguracji:
APT::FTPArchive::Zawartość.

-s, --zastąpienie źródła
Wybierz plik zastępowania źródła, który ma być używany z poleceniem source. Element konfiguracji:
APT::FTPArchive::SourceOverride.

--tylko czytać
Ustaw buforujące bazy danych tylko do odczytu. Element konfiguracji: APT::FTPArchive::ReadOnlyDB.

-a, --łuk
Akceptuj w poleceniach pakietów i zawartości tylko pliki pakietów pasujące do *_arch.deb lub
*_all.deb zamiast wszystkich plików pakietów w podanej ścieżce. Element konfiguracji:
APT::FTPArchive::Architektura.

APT::FTPArchive::AlwaysStat
apt-ftparchive(1) buforuje jak najwięcej metadanych w pamięci podręcznej. Jeśli pakiety są
ponownie skompilowany i/lub ponownie opublikowany w tej samej wersji, spowoduje to problemy
ponieważ zostaną użyte nieaktualne metadane z pamięci podręcznej, takie jak rozmiar i sumy kontrolne. Z tym
opcja włączona, nie będzie to już miało miejsca, ponieważ zostanie sprawdzone, czy plik był
zmieniony. Należy pamiętać, że ta opcja jest domyślnie ustawiona na „false”, ponieważ nie jest to zalecane
przesyłaj wiele wersji/kompilacji pakietu o tym samym numerze wersji, więc teoretycznie
nikt nie będzie miał takich problemów i dlatego wszystkie te dodatkowe kontrole są bezużyteczne.

APT::FTPArchive::Długi opis
Ta opcja konfiguracji ma domyślnie wartość „true” i powinna być ustawiona na „false” tylko w przypadku
Archiwum wygenerowane za pomocą apt-ftparchive(1) udostępnia również pliki tłumaczeń. Zauważ to
plik główny Translation-en można utworzyć tylko w poleceniu generowania.

-h, --help
Pokaż krótkie podsumowanie użytkowania.

-v, --wersja
Pokaż wersję programu.

-c, --plik-konfiguracyjny
Plik konfiguracyjny; Określ plik konfiguracyjny do użycia. Program odczyta
domyślny plik konfiguracyjny, a następnie ten plik konfiguracyjny. Jeśli ustawienia konfiguracyjne
należy ustawić przed analizowaniem domyślnych plików konfiguracyjnych, podaj plik za pomocą
dotychczasowy APT_KONFIG Zmienna środowiskowa. Widzieć apt.konf(5) dla informacji o składni.

-o, --opcja
Ustaw opcję konfiguracji; Spowoduje to ustawienie dowolnej opcji konfiguracyjnej. ten
składnia to -o Foo::pasek=pasek. -o i --opcja może być używany wiele razy, aby ustawić;
różne opcje.

PRZYKŁADY

Aby utworzyć skompresowany plik pakietów dla katalogu zawierającego pakiety binarne (.deb):

apt-ftparchive Pakiety katalog | gzip > Pakiety.gz

Użyj apt-ftparchive online, korzystając z usług onworks.net