apt-ftparchive – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

apt-ftparchive – Dienstprogramm zum Generieren von Indexdateien

ZUSAMMENFASSUNG

apt-ftparchive [-dsq] [--md5] [--delink] [--schreibgeschützt] [--Inhalt] [--Bogen Architektur]
[-o=config_string] [-c=Konfigurationsdatei]
{Pakete Weg... [Override-Datei [Pfadpräfix]] |
Quellen Weg... [Override-Datei [Pfadpräfix]] | Inhalt Weg |
Release Weg | generieren Konfigurationsdatei Abschnitt... | sauber Konfigurationsdatei |
{-v | --version} | {-h | --helfen}}

BESCHREIBUNG

apt-ftparchive ist das Befehlszeilentool, das die Indexdateien generiert, die APT verwendet
Zugriff auf eine Vertriebsquelle. Die Indexdateien sollten auf der Ursprungsseite basierend generiert werden
über den Inhalt dieser Website.

apt-ftparchive ist eine Obermenge von dpkg-scanpackages(1) Programm, einschließlich seiner gesamten
Funktionalität über den Paketbefehl. Es enthält auch einen Inhaltsdateigenerator,
Inhalte und eine ausgefeilte Möglichkeit, den Generierungsprozess vollständig zu „skripten“.
Archiv.

Im Inneren apt-ftparchive kann Binärdatenbanken nutzen, um den Inhalt einer .deb-Datei zwischenzuspeichern
Datei und ist nicht auf andere externe Programme angewiesen gzip(1). Bei einem Full
Generate It führt automatisch Dateiänderungsprüfungen durch und erstellt die gewünschte komprimierte Datei
Ausgabedateien.

Es sei denn, die -h, oder --help Wenn die Option angegeben ist, muss einer der folgenden Befehle vorhanden sein.

Pakete
Der Befehl „packages“ generiert eine Paketdatei aus einem Verzeichnisbaum. Es dauert die
Das angegebene Verzeichnis wird rekursiv nach .deb-Dateien durchsucht und ein Paketdatensatz ausgegeben
für jeden stdout. Dieser Befehl entspricht ungefähr dpkg-scanpackages(1).

Die Option --db kann verwendet werden, um eine binäre Caching-DB anzugeben.

Quellen
Der Befehl „sources“ generiert eine Quellindexdatei aus einem Verzeichnisbaum. Es dauert die
Das angegebene Verzeichnis wird rekursiv nach .dsc-Dateien durchsucht und ein Quelldatensatz ausgegeben
für jeden stdout. Dieser Befehl entspricht ungefähr dpkg-scansources(1).

Wenn eine Override-Datei angegeben ist, wird mit nach einer Quell-Override-Datei gesucht
eine Erweiterung von .src. Mit der Option --source-override kann die Quelle geändert werden
Überschreibungsdatei, die verwendet wird.

Inhalt
Der Befehl content generiert eine Inhaltsdatei aus einem Verzeichnisbaum. Es dauert die
Das angegebene Verzeichnis wird rekursiv nach .deb-Dateien durchsucht und die Dateiliste wird gelesen
aus jeder Datei. Anschließend wird die Liste der übereinstimmenden Dateien sortiert und in die Standardausgabe geschrieben
Pakete. Verzeichnisse werden nicht in die Ausgabe geschrieben. Wenn mehrere Pakete dasselbe besitzen
Datei, dann werden die einzelnen Pakete in der Ausgabe durch ein Komma getrennt.

Die Option --db kann verwendet werden, um eine binäre Caching-DB anzugeben.

Release
Der Release-Befehl generiert eine Release-Datei aus einem Verzeichnisbaum. Es rekursiv
durchsucht das angegebene Verzeichnis nach unkomprimierten Paket- und Quelldateien und solchen
komprimiert mit gzip, bzip2 or lzma sowie standardmäßig Release- und md5sum.txt-Dateien
(APT::FTPArchive::Release::Default-Patterns). Zusätzliche Dateinamenmuster können sein
hinzugefügt, indem sie in APT::FTPArchive::Release::Patterns aufgelistet werden. Anschließend wird nach stdout geschrieben
eine Release-Datei, die (standardmäßig) jeweils einen MD5-, SHA1-, SHA256- und SHA512-Digest enthält
Datei.

Werte für die zusätzlichen Metadatenfelder in der Release-Datei werden aus übernommen
entsprechende Variablen unter APT::FTPArchive::Release, z.B
APT::FTPArchive::Release::Origin. Die unterstützten Felder sind: Origin, Label, Suite,
Version, Codename, Datum, Gültig bis, Architekturen, Komponenten, Beschreibung.

erzeugen
Der Befehl „generate“ ist so konzipiert, dass er über ein Cron-Skript ausgeführt werden kann und Indizes erstellt
gemäß der angegebenen Konfigurationsdatei. Die Konfigurationssprache bietet ein flexibles Mittel dazu
Angabe, welche Indexdateien aus welchen Verzeichnissen erstellt werden, sowie Bereitstellung einer
einfache Möglichkeit, die erforderlichen Einstellungen beizubehalten.

reinigen
Der Befehl „clean“ bereinigt die Datenbanken, die von der angegebenen Konfigurationsdatei verwendet werden
Entfernen aller Datensätze, die nicht mehr benötigt werden.

GENERIEREN CONFIGURATION

Der Befehl „generate“ verwendet eine Konfigurationsdatei, um die zu erstellenden Archive zu beschreiben
generiert werden. Es folgt dem typischen ISC-Konfigurationsformat, wie es in ISC-Tools wie zu sehen ist
bind 8 und dhcpd. apt.conf(5) enthält eine Beschreibung der Syntax. Notiere dass der
Die generierte Konfiguration wird jedoch abschnittsweise analysiert apt.conf(5) wird in einem Baum analysiert
Benehmen. Dies wirkt sich nur darauf aus, wie mit dem Scope-Tag umgegangen wird.

Die Generierungskonfiguration besteht aus vier separaten Abschnitten, die jeweils im Folgenden beschrieben werden.

Dir Abschnitt
Der Abschnitt „Dir“ definiert die Standardverzeichnisse, die zum Auffinden der erforderlichen Dateien erforderlich sind
während des Generierungsprozesses. Diesen Verzeichnissen werden bestimmte relative Pfade vorangestellt
wird in späteren Abschnitten definiert, um einen vollständigen, absoluten Pfad zu erzeugen.

Archivverzeichnis
Gibt das Stammverzeichnis des FTP-Archivs an. In einer Standard-Debian-Konfiguration ist dies das
Verzeichnis, das die ls-LR- und dist-Knoten enthält.

OverrideDir
Gibt den Speicherort der Überschreibungsdateien an.

CacheDir
Gibt den Speicherort der Cache-Dateien an.

FileListDir
Gibt den Speicherort der Dateilistendateien an, wenn unten die FileList-Einstellung verwendet wird.

Standard Abschnitt
Der Abschnitt „Standard“ gibt Standardwerte und Einstellungen an, die den Betrieb von steuern
der Generator. Andere Abschnitte können diese Standardeinstellungen durch eine abschnittsweise Einstellung überschreiben.

Pakete::Komprimieren
Legt die Standardkomprimierungsschemata fest, die für die Paketindexdateien verwendet werden sollen. es ist ein
Zeichenfolge, die eine durch Leerzeichen getrennte Liste mit mindestens einem der folgenden Elemente enthält: „.“ (keine Komprimierung),
„gzip“ und „bzip2“. Der Standardwert für alle Komprimierungsschemata ist „. gzip'.

Pakete::Erweiterungen
Legt die Standardliste der Dateierweiterungen fest, bei denen es sich um Paketdateien handelt. Dies ist die Standardeinstellung
'.deb'.

Quellen::Komprimieren
Dies ähnelt Packages::Compress, außer dass es die Komprimierung für steuert
Quelldateien.

Quellen::Erweiterungen
Legt die Standardliste der Dateierweiterungen fest, bei denen es sich um Quelldateien handelt. Dies ist die Standardeinstellung
'.dsc'.

Inhalt::Komprimieren
Dies ähnelt Packages::Compress, außer dass es die Komprimierung für steuert
Inhaltsdateien.

Übersetzung::Komprimieren
Dies ähnelt Packages::Compress, außer dass es die Komprimierung für steuert
Übersetzung und Masterdatei.

DeLinkLimit
Gibt die Anzahl der Kilobyte an, die pro Lauf aufgehoben (und durch feste Links ersetzt) ​​werden sollen.
Dies wird in Verbindung mit der Einstellung „External-Links“ pro Abschnitt verwendet.

Dateimodus
Gibt den Modus aller erstellten Indexdateien an. Der Standardwert ist 0644. Alle Indexdateien
werden unabhängig von der umask auf diesen Modus eingestellt.

Lange Beschreibung
Gibt an, ob lange Beschreibungen in die Paketdatei aufgenommen oder aufgeteilt werden sollen
in eine Master-Übersetzungsdatei übertragen.

TreeDefault Abschnitt
Legt spezifische Standardwerte für Baumabschnitte fest. Alle diese Variablen sind Substitutionsvariablen
und lassen Sie die Zeichenfolgen $(DIST), $(SECTION) und $(ARCH) durch ihre jeweiligen ersetzen
Werte.

MaxContentsChange
Legt die Anzahl der Kilobyte an Inhaltsdateien fest, die täglich generiert werden. Der
Inhaltsdateien werden im Round-Robin-Verfahren verarbeitet, sodass sie über mehrere Tage hinweg alle neu erstellt werden.

InhaltAlter
Steuert die Anzahl der Tage, die eine Inhaltsdatei ohne Änderung überprüft werden darf.
Wenn dieses Limit überschritten wird, wird die mtime der Inhaltsdatei aktualisiert. Dieser Fall kann auftreten
wenn die Paketdatei so geändert wird, dass kein neuer Inhalt entsteht
Datei [zum Beispiel die Bearbeitung überschreiben]. Eine Verzögerung ist zulässig, in der Hoffnung, dass neue .debs dies tun
installiert werden, was ohnehin eine neue Datei erfordert. Der Standardwert ist 10, die Einheiten sind in Tagen.

Verzeichnis
Legt den Anfang des .deb-Verzeichnisbaums fest. Standardmäßig ist
$(DIST)/$(SECTION)/binary-$(ARCH)/

Quellverzeichnis
Legt den Anfang des Verzeichnisbaums des Quellpakets fest. Standardmäßig ist
$(DIST)/$(SECTION)/source/

Angebote
Legt die Ausgabepaketdatei fest. Der Standardwert ist $(DIST)/$(SECTION)/binary-$(ARCH)/Packages

Quellen
Legt die Ausgabequellendatei fest. Der Standardwert ist $(DIST)/$(SECTION)/source/Sources

Übersetzungen
Legt die Ausgabe-Übersetzungs-Masterdatei mit den langen Beschreibungen fest, sofern dies erforderlich ist
nicht in der Paketdatei enthalten sein. Standardmäßig ist
$(DIST)/$(SECTION)/i18n/Translation-en

Internes Präfix
Legt das Pfadpräfix fest, das dazu führt, dass ein Symlink stattdessen als interner Link betrachtet wird
eines externen Links. Standardmäßig $(DIST)/$(SECTION)/

Inhalte
Legt die Ausgabeinhaltsdatei fest. Der Standardwert ist $(DIST)/$(SECTION)/Contents-$(ARCH). Wenn
Diese Einstellung bewirkt, dass mehrere Paketdateien einer einzelnen Inhaltsdatei zugeordnet werden (wie sie ist).
die Standardeinstellung). apt-ftparchive wird diese Paketdateien zusammen integrieren
automatisch.

Inhalt::Header
Legt fest, dass die Header-Datei der Inhaltsausgabe vorangestellt wird.

BinCacheDB
Legt die binäre Cache-Datenbank fest, die für diesen Abschnitt verwendet werden soll. Mehrere Abschnitte können geteilt werden
die gleiche Datenbank.

Dateiliste
Gibt an, dass statt durch den Verzeichnisbaum zu gehen, apt-ftparchive sollte das lesen
Liste der Dateien aus der angegebenen Datei. Relativen Dateinamen wird das Archiv vorangestellt
Verzeichnis.

SourceFileList
Gibt an, dass statt durch den Verzeichnisbaum zu gehen, apt-ftparchive sollte das lesen
Liste der Dateien aus der angegebenen Datei. Relativen Dateinamen wird das Archiv vorangestellt
Verzeichnis. Dies wird bei der Verarbeitung von Quellindizes verwendet.

Baum Abschnitt
Der Abschnitt „Tree“ definiert einen Standard-Debian-Dateibaum, der aus einem Basisverzeichnis,
dann mehrere Abschnitte in diesem Basisverzeichnis und schließlich jeweils mehrere Architekturen
Abschnitt. Der genaue verwendete Pfad wird durch die Verzeichnisersetzungsvariable definiert.

Der Abschnitt „Baum“ nimmt ein Bereichs-Tag an, das die Variable $(DIST) festlegt und den Stamm von definiert
der Baum (dem Pfad wird ArchiveDir vorangestellt). Typischerweise handelt es sich dabei um eine Einstellung wie z
dists/jessie.

Alle im Abschnitt „TreeDefault“ definierten Einstellungen können in einem Abschnitt „Tree“ verwendet werden als
sowie drei neue Variablen.

Bei der Bearbeitung eines Baumabschnitts apt-ftparchive führt eine Operation aus, die der folgenden ähnelt:

denn ich in Abschnitten tue es
für j in Architekturen tun
Generieren für DIST=scope SECTION=i ARCH=j

Abschnitte
Dies ist eine durch Leerzeichen getrennte Liste von Abschnitten, die unter der Distribution erscheinen;
Typischerweise ist dies so etwas wie „main contrib non-free“.

Architekturen
Dies ist eine durch Leerzeichen getrennte Liste aller Architekturen, die bei der Suche angezeigt werden
Abschnitt. Die spezielle Architektur „Quelle“ wird verwendet, um anzuzeigen, dass dieser Baum über eine verfügt
Quellarchiv. Die Architektur „alle“ signalisiert, dass Architektur bestimmte Dateien mögen
Pakete sollten keine Informationen über die Architektur aller Pakete in allen Dateien enthalten
da sie in einer speziellen Datei verfügbar sein werden.

Lange Beschreibung
Gibt an, ob lange Beschreibungen in die Paketdatei aufgenommen oder aufgeteilt werden sollen
in eine Master-Übersetzungsdatei übertragen.

BinOverride
Legt die binäre Überschreibungsdatei fest. Die Override-Datei enthält Abschnitt, Priorität und
Informationen zur Adresse des Betreuers.

SrcOverride
Legt die Quellüberschreibungsdatei fest. Die Override-Datei enthält Abschnittsinformationen.

ExtraOverride
Legt die binäre zusätzliche Override-Datei fest.

SrcExtraOverride
Legt die zusätzliche Quellüberschreibungsdatei fest.

BinDirectory Abschnitt
Der Abschnitt bindirectory definiert einen binären Verzeichnisbaum ohne spezielle Struktur. Der
Das Scope-Tag gibt den Speicherort des Binärverzeichnisses an und die Einstellungen ähneln denen
der Abschnitt „Baum“ ohne Substitutionsvariablen oder SectionArchitecture-Einstellungen.

Angebote
Legt die Ausgabe der Paketdatei fest.

Quellen
Legt die Ausgabe der Quelldatei fest. Mindestens eines der Pakete oder Quellen ist erforderlich.

Inhalte
Legt die Ausgabe der Inhaltsdatei fest (optional).

BinOverride
Legt die binäre Überschreibungsdatei fest.

SrcOverride
Legt die Quellüberschreibungsdatei fest.

ExtraOverride
Legt die binäre zusätzliche Override-Datei fest.

SrcExtraOverride
Legt die zusätzliche Quellüberschreibungsdatei fest.

BinCacheDB
Legt die Cache-Datenbank fest.

PathPrefix
Fügt allen Ausgabepfaden einen Pfad hinzu.

Dateiliste, SourceFileList
Gibt die Dateilistendatei an.

BINARY KORREKTUR FILE

Die binäre Überschreibungsdatei ist vollständig kompatibel mit dpkg-scanpackages(1). Es enthält vier
durch Leerzeichen getrennte Felder. Das erste Feld ist der Paketname, das zweite ist der
Priorität, um dieses Paket zu erzwingen, der dritte ist der Abschnitt, um dieses Paket zu erzwingen und
Das letzte Feld ist das Betreuer-Permutationsfeld.

Die allgemeine Form des Maintainer-Feldes ist:

alt [// oldn]* => neu

oder einfach,

neu

Das erste Formular ermöglicht die Erstellung einer durch Doppelschrägstriche getrennten Liste alter E-Mail-Adressen
angegeben. Wenn eines davon gefunden wird, wird das Feld „maintainer“ durch „new“ ersetzt. Der
Die zweite Form ersetzt bedingungslos das Maintainer-Feld.

SOURCE KORREKTUR FILE

Die Quellüberschreibungsdatei ist vollständig kompatibel mit dpkg-scansources(1). Es enthält zwei
durch Leerzeichen getrennte Felder. Das erste Feld ist der Name des Quellpakets, das zweite ist der
Abschnitt, um es zuzuweisen.

EXTRA KORREKTUR FILE

Die zusätzliche Override-Datei ermöglicht das Hinzufügen oder Ersetzen beliebiger Tags in der Ausgabe. Es
hat drei Spalten, die erste ist das Paket, die zweite ist das Tag und der Rest von
Die Zeile ist der neue Wert.

OPTIONAL

Alle Befehlszeilenoptionen können mithilfe der Konfigurationsdatei und der Beschreibungen festgelegt werden
Geben Sie die festzulegende Konfigurationsoption an. Für boolesche Optionen können Sie die Konfiguration überschreiben
Datei mit etwas wie -F-,--no-f, -f=nein oder mehrere andere Variationen.

--md5, --sha1, --sha256, --sha512
Generieren Sie die angegebene Prüfsumme. Diese Optionen sind standardmäßig aktiviert, wenn sie deaktiviert sind
Generierte Indexdateien enthalten nach Möglichkeit keine Prüfsummenfelder. Aufbau
Elemente: APT::FTPArchive::Checksum und APT::FTPArchive::Index::Checksum woher Index kann
Seien Sie Pakete, Quellen oder Release und Checksum kann MD5, SHA1, SHA256 oder SHA512 sein.

-d, --db
Verwenden Sie eine binäre Caching-Datenbank. Dies hat keine Auswirkung auf den Generierungsbefehl. Aufbau
Element: APT::FTPArchive::DB.

-q, --ruhig
Ruhig; erzeugt eine Ausgabe, die für die Protokollierung geeignet ist, wobei Fortschrittsanzeigen weggelassen werden. Mehr Fragen
erzeugt mehr Ruhe bis maximal 2. Sie können auch verwenden -q=# für Ruhe sorgen
Ebene und überschreibt die Konfigurationsdatei. Konfigurationselement: leise.

--delink
Delinking durchführen. Wenn die Einstellung „External-Links“ verwendet wird, dann tatsächlich diese Option
ermöglicht die Entlinkung der Dateien. Es ist standardmäßig aktiviert und kann mit deaktiviert werden
--no-delink. Konfigurationselement: APT::FTPArchive::DeLinkAct.

--Inhalt
Führen Sie die Inhaltsgenerierung durch. Wenn diese Option festgelegt ist und Paketindizes erstellt werden
Wenn die Datei mit einer Cache-Datenbank generiert wird, wird auch die Dateiliste extrahiert und darin gespeichert
die DB zur späteren Verwendung. Bei Verwendung des Befehls „generate“ ermöglicht diese Option auch die
Erstellung beliebiger Inhaltsdateien. Die Standardeinstellung ist aktiviert. Konfigurationselement:
APT::FTPArchive::Contents.

-s, --source-override
Wählen Sie die Quellüberschreibungsdatei aus, die mit dem Befehl „sources“ verwendet werden soll. Konfigurationselement:
APT::FTPArchive::SourceOverride.

--schreibgeschützt
Machen Sie die Caching-Datenbanken schreibgeschützt. Konfigurationselement: APT::FTPArchive::ReadOnlyDB.

-a, --Bogen
Akzeptieren Sie in den Paket- und Inhaltsbefehlen nur Paketdateien, die mit *_arch.deb oder übereinstimmen
*_all.deb anstelle aller Paketdateien im angegebenen Pfad. Konfigurationselement:
APT::FTPArchive::Architecture.

APT::FTPArchive::AlwaysStat
apt-ftparchive(1) speichert so viele Metadaten wie möglich in einer zwischengespeicherten Datenbank zwischen. Wenn Pakete vorhanden sind
neu kompiliert und/oder erneut mit derselben Version veröffentlicht wird, führt dies zu Problemen
da die inzwischen veralteten zwischengespeicherten Metadaten wie Größe und Prüfsummen verwendet werden. Mit diesem
Bei aktivierter Option passiert dies nicht mehr, da überprüft wird, ob die Datei vorhanden ist
geändert. Beachten Sie, dass diese Option standardmäßig auf „false“ gesetzt ist, da dies nicht empfohlen wird
Laden Sie mehrere Versionen/Builds eines Pakets mit derselben Versionsnummer hoch, also theoretisch
Niemand wird diese Probleme haben und deshalb sind all diese zusätzlichen Kontrollen nutzlos.

APT::FTPArchive::LongDescription
Diese Konfigurationsoption ist standardmäßig auf „true“ eingestellt und sollte nur dann auf „false“ gesetzt werden, wenn die
Archiv erstellt mit apt-ftparchive(1) stellt auch Übersetzungsdateien bereit. Beachten Sie, dass
Die Translation-en-Masterdatei kann nur im Generate-Befehl erstellt werden.

-h, --help
Zeigen Sie eine kurze Nutzungszusammenfassung an.

-v, --Version
Zeigen Sie die Programmversion an.

-c, --Konfigurationsdatei
Konfigurationsdatei; Geben Sie eine zu verwendende Konfigurationsdatei an. Das Programm liest die
Standardkonfigurationsdatei und dann diese Konfigurationsdatei. Wenn Konfigurationseinstellungen
muss festgelegt werden, bevor die Standardkonfigurationsdateien analysiert werden. Geben Sie eine Datei mit an
APT_CONFIG Umgebungsvariable. Sehen apt.conf(5) für Syntaxinformationen.

-o, --Möglichkeit
Legen Sie eine Konfigurationsoption fest. Dadurch wird eine beliebige Konfigurationsoption festgelegt. Der
Syntax ist -o Foo::Bar=bar. -o und --Möglichkeit kann mehrfach zum Festlegen verwendet werden
verschiedene Möglichkeiten.

Beispiele:

So erstellen Sie eine komprimierte Paketdatei für ein Verzeichnis, das Binärpakete (.deb) enthält:

apt-ftparchive Pakete Verzeichnis | gzip > Pakete.gz

Verwenden Sie apt-ftparchive online über die Dienste von onworks.net