apt-ftparchive - Online în cloud

PROGRAM:

NUME

apt-ftparchive - Utilitar pentru a genera fișiere index

REZUMAT

apt-ftparchive [-dsq] [--md5] [--delink] [--numai citire] [--conținut] [--arc arhitectură]
[-o=config_string] [-c=config_file]
{pachete cale... [override-file [prefix de cale]] |
surse cale... [override-file [prefix de cale]] | continuturi cale |
eliberaţi cale | Genera config_file secțiune... | curat config_file |
{-v | --versiune} | {-h | --Ajutor}}

DESCRIERE

apt-ftparchive este instrumentul de linie de comandă care generează fișierele index pe care le folosește APT
accesați o sursă de distribuție. Fișierele index ar trebui să fie generate pe site-ul de origine
asupra conținutului site-ului respectiv.

apt-ftparchive este un superset al dpkg-scanpackages(1) program, încorporând întregul său
funcționalitate prin comanda pachete. Conține, de asemenea, un generator de fișiere de conținut,
conținut și un mijloc elaborat de a „scrie” procesul de generare pentru un proces complet
Arhiva.

Intern apt-ftparchive poate folosi bazele de date binare pentru a stoca în cache conținutul unui .deb
fișier și nu se bazează pe niciun program extern în afară de gzip(1). Când faci un full
generați-l efectuează automat verificări de schimbare a fișierelor și construiește comprimatul dorit
fișiere de ieșire.

Cu excepția cazului în care -h, Sau --Ajutor este dată, una dintre comenzile de mai jos trebuie să fie prezentă.

ofertele
Comanda pachete generează un fișier pachet dintr-un arbore de directoare. Este nevoie de
directorul dat și caută recursiv fișiere .deb, emițând o înregistrare de pachet
a stdout pentru fiecare. Această comandă este aproximativ echivalentă cu dpkg-scanpackages(1).

Optiunea --db poate fi folosit pentru a specifica un DB binar de cache.

surse
Comanda sursă generează un fișier index sursă dintr-un arbore de directoare. Este nevoie de
directorul dat și caută recursiv fișiere .dsc, emițând o înregistrare sursă
a stdout pentru fiecare. Această comandă este aproximativ echivalentă cu dpkg-scansources(1).

Dacă este specificat un fișier de înlocuire, atunci va fi căutat un fișier de înlocuire sursă cu
o extensie a .src. Opțiunea --source-override poate fi folosită pentru a schimba sursa
înlocuiți fișierul care va fi utilizat.

conținut
Comanda contents generează un fișier de conținut dintr-un arbore de directoare. Este nevoie de
directorul dat și caută recursiv fișiere .deb și citește lista de fișiere
din fiecare dosar. Apoi sortează și scrie în stdout lista de fișiere cu care se potrivește
pachete. Directoarele nu sunt scrise în ieșire. Dacă mai multe pachete dețin același lucru
apoi fiecare pachet este separat prin virgulă în rezultat.

Optiunea --db poate fi folosit pentru a specifica un DB binar de cache.

eliberaţi
Comanda de eliberare generează un fișier Release dintr-un arbore de directoare. Este recursiv
caută în directorul dat fișierele pachete și surse necomprimate și altele
comprimat cu gzip, bzip2 or lzma precum și fișierele Release și md5sum.txt implicit
(APT::FTPArchive::Release::Default-Patterns). Modele suplimentare de nume de fișiere pot fi
adăugat prin listarea lor în APT::FTPArchive::Release::Patterns. Apoi scrie la stdout
un fișier de lansare care conține (în mod implicit) un rezumat MD5, SHA1, SHA256 și SHA512 pentru fiecare
fișier.

Valorile pentru câmpurile de metadate suplimentare din fișierul Release sunt preluate din
variabilele corespunzătoare sub APT::FTPArchive::Release, de ex
APT::FTPArchive::Release::Origin. Câmpurile acceptate sunt: ​​Origine, Etichetă, Suite,
Versiune, Nume de cod, Data, Valabil până la, Arhitecturi, Componente, Descriere.

genera
Comanda de generare este concepută pentru a fi rulată dintr-un script cron și construiește indecși
conform fișierului de configurare dat. Limbajul de configurare oferă un mijloc flexibil de
specificarea ce fișiere index sunt construite din ce directoare, precum și furnizarea unui
mijloace simple de menținere a setărilor necesare.

curat
Comanda clean ordonează bazele de date utilizate de fișierul de configurare dat de
eliminarea oricăror înregistrări care nu mai sunt necesare.

THE GENERA CONFIGURARE

Comanda generate folosește un fișier de configurare pentru a descrie arhivele la care urmează
fi generat. Urmează formatul tipic de configurare ISC, așa cum se vede în instrumentele ISC precum
bind 8 și dhcpd. apt.conf(5) conține o descriere a sintaxei. Rețineți că
generarea configurației este analizată în mod secțional, dar apt.conf(5) este analizat într-un copac
manieră. Acest lucru afectează doar modul în care este gestionată eticheta scope.

Configurația de generare are patru secțiuni separate, fiecare descrisă mai jos.

dir Secțiune
Secțiunea Dir definește directoarele standard necesare pentru a localiza fișierele necesare
în timpul procesului de generare. Aceste directoare sunt predate anumite căi relative
definite în secțiunile ulterioare pentru a produce o cale completă și absolută.

ArchiveDir
Specifică rădăcina arhivei FTP, într-o configurație standard Debian aceasta este
directorul care conține nodurile ls-LR și dist.

OverrideDir
Specifică locația fișierelor de înlocuire.

CacheDir
Specifică locația fișierelor cache.

FileListDir
Specifică locația fișierelor cu listă de fișiere, dacă setarea FileList este utilizată mai jos.

Mod implicit Secțiune
Secțiunea Implicit specifică valorile implicite și setările care controlează funcționarea
generatorul. Alte secțiuni pot suprascrie aceste valori implicite cu o setare pe secțiune.

Pachete::Comprimare
Setează schemele implicite de compresie de utilizat pentru fișierele index ale pachetelor. Este un
șir care conține o listă separată de spații de cel puțin una dintre: '.' (fără compresie),
„gzip” și „bzip2”. Valoarea implicită pentru toate schemele de compresie este „. gzip'.

Pachete::Extensii
Setează lista implicită de extensii de fișiere care sunt fișiere pachet. Aceasta este implicită
'.deb'.

Surse::Compress
Acest lucru este similar cu Packages::Compress, cu excepția faptului că controlează compresia pentru
Fișiere surse.

Surse::Extensii
Setează lista implicită de extensii de fișiere care sunt fișiere sursă. Aceasta este implicită
„.dsc”.

Continut::Comprimare
Acest lucru este similar cu Packages::Compress, cu excepția faptului că controlează compresia pentru
Fișiere de conținut.

Traducere::Comprimare
Acest lucru este similar cu Packages::Compress, cu excepția faptului că controlează compresia pentru
Traducere-ro fișier principal.

DeLinkLimit
Specifică numărul de kiloocteți de deconectat (și înlocuiți cu legături rigide) per rulare.
Aceasta este utilizată împreună cu setarea Legături externe pe secțiune.

FileMode
Specifică modul tuturor fișierelor index create. Setarea implicită este 0644. Toate fișierele index
sunt setate în acest mod fără a ține cont de umask.

Descriere lungă
Specifică dacă descrierile lungi trebuie incluse în fișierul Pachete sau împărțite
într-un fișier master Translation-en.

TreeDefault Secțiune
Setează valorile implicite specifice secțiunilor de arbore. Toate aceste variabile sunt variabile de substituție
și au șirurile $(DIST), $(SECTION) și $(ARCH) înlocuite cu respectivele lor
valori.

MaxContentsChange
Setează numărul de kiloocteți de fișiere de conținut care sunt generate în fiecare zi. The
fișierele de conținut sunt round-robined, astfel încât în ​​câteva zile vor fi toate reconstruite.

CuprinsVârsta
Controlează numărul de zile în care un fișier de conținut poate fi verificat fără modificare.
Dacă această limită este depășită, mtime-ul fișierului de conținut este actualizat. Acest caz poate apărea
dacă fișierul pachetului este modificat în așa fel încât să nu rezulte un conținut nou
fișier [de exemplu, anulați editarea]. O suspendare este permisă în speranța că noile .debs vor face
fi instalat, necesitând un fișier nou oricum. Valoarea implicită este 10, unitățile sunt în zile.

director
Setează partea de sus a arborelui directorului .deb. Implicit la
$(DIST)/$(SECȚIUNE)/binar-$(ARCH)/

SrcDirectory
Setează partea de sus a arborelui director al pachetului sursă. Implicit la
$(DIST)/$(SECȚIUNE)/sursă/

Pachete
Setează fișierul pachete de ieșire. Implicit la $(DIST)/$(SECTION)/binar-$(ARCH)/Pachete

Surse
Setează fișierul surse de ieșire. Setarea implicită este $(DIST)/$(SECTION)/sursă/Surse

Traducere
Setează fișierul master de ieșire Translation-en cu descrierile lungi dacă ar trebui
să nu fie incluse în fișierul Pachete. Implicit la
$(DIST)/$(SECTION)/i18n/Translation-ro

Prefix intern
Setează prefixul de cale care face ca o legătură simbolică să fie considerată o legătură internă
a unui link extern. Implicit la $(DIST)/$(SECTION)/

Cuprins
Setează fișierul Conținut de ieșire. Setarea implicită este $(DIST)/$(SECTION)/Contents-$(ARCH). Dacă
această setare face ca mai multe fișiere Pachete să se mapeze într-un singur fișier Conținut (așa cum este
implicit) atunci apt-ftparchive va integra acele fișiere pachet împreună
în mod automat.

Conținut::Header
Setează fișierul antet pentru a fi înaintea rezultatului conținutului.

BinCacheDB
Setează baza de date binară cache pe care să o folosească pentru această secțiune. Se pot partaja mai multe secțiuni
aceeași bază de date.

Filelist
Specifică faptul că, în loc să parcurgeți arborele de directoare, apt-ftparchive ar trebui să citească
lista de fișiere din fișierul dat. Numele de fișiere relative sunt prefixate cu arhiva
director.

SourceFileList
Specifică faptul că, în loc să parcurgeți arborele de directoare, apt-ftparchive ar trebui să citească
lista de fișiere din fișierul dat. Numele de fișiere relative sunt prefixate cu arhiva
director. Acesta este utilizat la procesarea indicilor sursă.

Copac Secțiune
Secțiunea Arboresc definește un arbore de fișiere Debian standard care constă dintr-un director de bază,
apoi mai multe secțiuni în acel director de bază și în cele din urmă mai multe arhitecturi în fiecare
secțiune. Calea exactă utilizată este definită de variabila de înlocuire a directorului.

Secțiunea Arboresc ia o etichetă scope care setează variabila $(DIST) și definește rădăcina lui
arborele (calea este prefixată de ArchiveDir). De obicei, aceasta este o setare precum
dists/jessie.

Toate setările definite în secțiunea TreeDefault pot fi utilizate într-o secțiune Tree ca
precum și trei variabile noi.

La procesarea unei secțiuni de arbore apt-ftparchive efectuează o operație similară cu:

pentru i în secțiunile do
pentru j în Arhitecturi do
Generați pentru DIST=scop SECTION=i ARCH=j

Secţiuni
Aceasta este o listă de secțiuni separate prin spații care apar sub distribuție;
de obicei, aceasta este ceva de genul principal contribuție non-free

arhitecturi
Aceasta este o listă separată de spații a tuturor arhitecturilor care apar în căutare
secțiune. Arhitectura specială „sursă” este folosită pentru a indica faptul că acest arbore are un
arhiva sursă. Arhitectura „toate” semnalează că fișierele specifice arhitecturii ca
Pachetele nu ar trebui să includă informații despre arhitectura tuturor pachetelor din toate fișierele
deoarece acestea vor fi disponibile într-un fișier dedicat.

Descriere lungă
Specifică dacă descrierile lungi trebuie incluse în fișierul Pachete sau împărțite
într-un fișier master Translation-en.

BinOverride
Setează fișierul de înlocuire binar. Fișierul de înlocuire conține secțiune, prioritate și
informații despre adresa întreținătorului.

SrcOverride
Setează fișierul de înlocuire sursă. Fișierul de înlocuire conține informații despre secțiune.

ExtraOverride
Setează fișierul binar de suprascriere suplimentară.

SrcExtraOverride
Setează fișierul de înlocuire suplimentar sursă.

BinDirectory Secțiune
Secțiunea bindirectory definește un arbore de directoare binar fără o structură specială. The
Eticheta scope specifică locația directorului binar și setările sunt similare cu
secțiunea Arboresc fără variabile de substituție sau setări SectionArchitecture.

Pachete
Setează ieșirea fișierului Pachete.

Surse
Setează ieșirea fișierului Surse. Este necesar cel puțin unul dintre pachete sau surse.

Cuprins
Setează ieșirea fișierului Conținut (opțional).

BinOverride
Setează fișierul de înlocuire binar.

SrcOverride
Setează fișierul de înlocuire sursă.

ExtraOverride
Setează fișierul binar de suprascriere suplimentară.

SrcExtraOverride
Setează fișierul de înlocuire suplimentar sursă.

BinCacheDB
Setează DB cache.

PathPrefix
Adaugă o cale la toate căile de ieșire.

Filelist, SourceFileList
Specifică fișierul cu lista de fișiere.

THE BINAR TRECE PESTE FILE

Fișierul de suprascriere binar este pe deplin compatibil cu dpkg-scanpackages(1). Conține patru
câmpuri separate prin spații. Primul câmp este numele pachetului, al doilea este
prioritate pentru a forța acel pachet, a treia este secțiunea pentru a forța acel pachet și
câmpul final este câmpul de permutare a menținerii.

Forma generală a câmpului de întreținere este:

vechi [// oldn]* => nou

sau pur și simplu,

nou

Prima formă permite o listă separată cu două bare oblice de adrese de e-mail vechi
specificat. Dacă oricare dintre acestea este găsit, atunci câmpul de întreținere este înlocuit cu nou. The
a doua formă înlocuiește necondiționat câmpul de întreținere.

THE SOURCE TRECE PESTE FILE

Fișierul de suprascriere sursă este pe deplin compatibil cu dpkg-scansources(1). Conține două
câmpuri separate prin spații. Primul câmp este numele pachetului sursă, al doilea este
secțiune pentru a o atribui.

THE EXTRA TRECE PESTE FILE

Fișierul suplimentar de suprascriere permite adăugarea sau înlocuirea oricărei etichete arbitrare în rezultat. Aceasta
are trei coloane, prima este pachetul, a doua este eticheta și restul
linia este noua valoare.

OPŢIUNI

Toate opțiunile liniei de comandă pot fi setate folosind fișierul de configurare, descrierile
indicați opțiunea de configurare de setat. Pentru opțiunile booleene puteți suprascrie configurația
fișier folosind ceva de genul -f-,--nu-f, -f=nu sau alte câteva variante.

--md5, --sha1, --sha256, --sha512
Generați suma de control dată. Aceste opțiuni sunt activate implicit, când sunt dezactivate
fișierele index generate nu vor avea câmpurile de sumă de control acolo unde este posibil. Configurare
Articole: APT::FTPArchive::checksum și APT::FTPArchive::index::checksum Unde index poate să
fie Pachete, Surse sau Lansare și checksum poate fi MD5, SHA1, SHA256 sau SHA512.

-d, --db
Utilizați un DB binar de cache. Acest lucru nu are niciun efect asupra comenzii generate. Configurare
Articol: APT::FTPArchive::DB.

-q, --Liniște
Liniște; produce rezultate adecvate pentru înregistrare, omițând indicatorii de progres. Mai multe q
va produce mai multă liniște până la maximum 2. De asemenea, puteți utiliza -q=# pentru a stabili liniștea
nivel, suprascriind fișierul de configurare. Element de configurare: silențios.

--delink
Efectuați deconectarea. Dacă se folosește setarea External-Links, atunci această opțiune de fapt
permite deconectarea fișierelor. Se activează implicit și poate fi oprit cu
--no-delink. Element de configurare: APT::FTPArchive::DeLinkAct.

--conținut
Efectuați generarea de conținut. Când această opțiune este setată și sunt afișate indecșii pachetelor
generat cu o bază de date cache, apoi lista de fișiere va fi, de asemenea, extrasă și stocată
DB pentru utilizare ulterioară. Când utilizați comanda generate, această opțiune permite și
crearea oricăror fișiere de conținut. Valoarea implicită este activată. Element de configurare:
APT::FTPArchive::Conținut.

-s, --source-override
Selectați fișierul de înlocuire sursă de utilizat cu comanda surse. Element de configurare:
APT::FTPArchive::SourceOverride.

--numai citire
Faceți ca bazele de date de stocare numai în citire. Element de configurare: APT::FTPArchive::ReadOnlyDB.

-a, --arc
Acceptați în comenzile pachete și conținut numai fișierele de pachete care se potrivesc cu *_arch.deb sau
*_all.deb în loc de toate fișierele pachet din calea dată. Element de configurare:
APT::FTPArchive::Arhitectură.

APT::FTPArchive::AlwaysStat
apt-ftparchive(1) memorează în cache cât mai mult posibil de metadate într-un cachedb. Dacă pachetele sunt
recompilat și/sau republicat cu aceeași versiune din nou, acest lucru va duce la probleme
deoarece vor fi utilizate metadatele stocate în cache, cum ar fi dimensiunea și sumele de control. Cu asta
opțiunea activată, acest lucru nu se va mai întâmpla deoarece se va verifica dacă fișierul a fost
schimbat. Rețineți că această opțiune este setată implicit la „false”, deoarece nu este recomandată
încărcați mai multe versiuni/construcții ale unui pachet cu același număr de versiune, deci în teorie
nimeni nu va avea aceste probleme și prin urmare toate aceste verificări suplimentare sunt inutile.

APT::FTPArchive::LongDescription
Această opțiune de configurare este implicită „adevărat” și ar trebui să fie setată la „fals” numai dacă
Arhivă generată cu apt-ftparchive(1) furnizează și fișiere de traducere. Rețineți că
fișierul master Translation-en poate fi creat numai în comanda generate.

-h, --Ajutor
Afișați un scurt rezumat al utilizării.

-v, --versiune
Arată versiunea programului.

-c, --config-file
Fișier de configurare; Specificați un fișier de configurare de utilizat. Programul va citi
fișierul de configurare implicit și apoi acest fișier de configurare. Dacă setările de configurare
trebuie setate înainte ca fișierele de configurare implicite să fie analizate, specificați un fișier cu
il APT_CONFIG variabilă de mediu. Vedea apt.conf(5) pentru informații despre sintaxă.

-o, --opțiune
Setați o opțiune de configurare; Aceasta va seta o opțiune de configurare arbitrară. The
sintaxa este -o Foo::Bar=bar. -o și --opțiune poate fi folosit de mai multe ori pentru a seta
diferite opțiuni.

EXEMPLE

Pentru a crea un fișier de pachete comprimat pentru un director care conține pachete binare (.deb):

apt-ftparchive ofertele director | gzip > Pachete.gz

Utilizați apt-ftparchive online folosind serviciile onworks.net