apt-ftparchive – En ligne dans le cloud

PROGRAMME:

Nom

apt-ftparchive - Utilitaire pour générer des fichiers d'index

SYNOPSIS

apt-ftparchive [-dsq] [--md5] [--delink] [--lecture seulement] [--Contenu] [--cambre architecture]
[-o=chaîne de configuration] [-c=fichier_config]
{paquets chemin... [remplacer-fichier [préfixe de chemin]] |
sources chemin... [remplacer-fichier [préfixe de chemin]] | contenu chemin |
libérer chemin | générer fichier_config ... | propre fichier_config |
{-v | --version} | {-h | --help}}

DESCRIPTION

apt-ftparchive est l'outil de ligne de commande qui génère les fichiers d'index qu'APT utilise pour
accéder à une source de distribution. Les fichiers d'index doivent être générés sur le site d'origine en fonction
sur le contenu de ce site.

apt-ftparchive est un sur-ensemble du dpkg-scanpackages(1) programme, intégrant l'intégralité de son
Fonctionnalités via la commande packages. Il contient également un générateur de fichiers de contenu,
contenu et un moyen élaboré de « scripter » le processus de génération pour un
archiver.

Intérieurement apt-ftparchive peut utiliser des bases de données binaires pour mettre en cache le contenu d'un fichier .deb
fichier et il ne dépend d'aucun programme externe en dehors de gzip(1). Lors d'une opération complète
il génère automatiquement des vérifications de modification de fichier et crée le fichier compressé souhaité
fichiers de sortie.

Sauf si -h, ou --Aidez-moi l'option est donnée, l'une des commandes ci-dessous doit être présente.

Forfaits
La commande packages génère un fichier de package à partir d'une arborescence de répertoires. Elle prend en charge
répertoire donné et le recherche récursivement pour les fichiers .deb, en émettant un enregistrement de package
vers la sortie standard pour chaque commande. Cette commande est approximativement équivalente à dpkg-scanpackages (1).

L'option --db peut être utilisé pour spécifier une base de données de mise en cache binaire.

sources
La commande sources génère un fichier d'index source à partir d'une arborescence de répertoires. Elle prend en compte
répertoire donné et le recherche de manière récursive pour les fichiers .dsc, en émettant un enregistrement source
vers la sortie standard pour chaque commande. Cette commande est approximativement équivalente à dpkg-scansources (1).

Si un fichier de remplacement est spécifié, un fichier de remplacement source sera recherché avec
une extension de .src. L'option --source-override permet de modifier la source.
remplacer le fichier qui sera utilisé.

contenu
La commande Contents génère un fichier de contenu à partir d'une arborescence de répertoires. Elle prend en charge
répertoire donné et le recherche de manière récursive pour les fichiers .deb, puis lit la liste des fichiers
de chaque fichier. Il trie ensuite et écrit sur la sortie standard la liste des fichiers correspondants.
Les paquets. Les répertoires ne sont pas écrits en sortie. Si plusieurs paquets possèdent le même
fichier, puis chaque package est séparé par une virgule dans la sortie.

L'option --db peut être utilisé pour spécifier une base de données de mise en cache binaire.

libérer
La commande release génère un fichier Release à partir d'une arborescence de répertoires. Elle est récursive.
recherche dans le répertoire donné les fichiers Packages et Sources non compressés et ceux
compressé avec gzip, bzip2 or lzma ainsi que les fichiers Release et md5sum.txt par défaut
(APT::FTPArchive::Release::Default-Patterns). Des modèles de noms de fichiers supplémentaires peuvent être
ajoutés en les listant dans APT::FTPArchive::Release::Patterns. Ils sont ensuite écrits sur la sortie standard.
un fichier Release contenant (par défaut) un condensé MD5, SHA1, SHA256 et SHA512 pour chaque
fichier.

Les valeurs des champs de métadonnées supplémentaires dans le fichier Release sont extraites du
variables correspondantes sous APT::FTPArchive::Release, par exemple
APT::FTPArchive::Release::Origin. Les champs pris en charge sont : Origine, Étiquette, Suite,
Version, nom de code, date, validité jusqu'au, architectures, composants, description.

générer
La commande generate est conçue pour être exécutable à partir d'un script cron et crée des index
selon le fichier de configuration fourni. Le langage de configuration offre un moyen flexible de
spécifiant quels fichiers d'index sont construits à partir de quels répertoires, ainsi que fournissant un
moyen simple de maintenir les paramètres requis.

espace extérieur plus propre,
La commande clean nettoie les bases de données utilisées par le fichier de configuration donné en
supprimer tous les enregistrements qui ne sont plus nécessaires.

THE PRODUIRE CONFIGURATION

La commande generate utilise un fichier de configuration pour décrire les archives qui vont être
être généré. Il suit le format de configuration ISC typique tel qu'il apparaît dans les outils ISC tels que
lier 8 et dhcpd. apt.conf(5) contient une description de la syntaxe. Notez que
la configuration générée est analysée de manière sectionnelle, mais apt.conf(5) est analysé dans un arbre
manière. Cela affecte uniquement la manière dont la balise de portée est gérée.

La configuration de génération comporte quatre sections distinctes, chacune décrite ci-dessous.

Dir Blog
La section Dir définit les répertoires standard nécessaires pour localiser les fichiers requis
pendant le processus de génération. Ces répertoires sont précédés de certains chemins relatifs.
défini dans les sections ultérieures pour produire un chemin complet et absolu.

ArchiveDir
Spécifie la racine de l'archive FTP, dans une configuration Debian standard, c'est la
répertoire contenant les nœuds ls-LR et dist.

OverrideDir
Spécifie l'emplacement des fichiers de remplacement.

CacheDir
Spécifie l'emplacement des fichiers de cache.

FileListDir
Spécifie l'emplacement des fichiers de la liste de fichiers, si le paramètre FileList est utilisé ci-dessous.

Réglage par défaut Blog
La section Par défaut spécifie les valeurs par défaut et les paramètres qui contrôlent le fonctionnement de
le générateur. D'autres sections peuvent remplacer ces valeurs par défaut par un paramètre propre à chaque section.

Paquets::Compress
Définit les schémas de compression par défaut à utiliser pour les fichiers d'index des packages. Il s'agit d'un
chaîne contenant une liste séparée par des espaces d'au moins un des éléments suivants : '.' (pas de compression),
« gzip » et « bzip2 ». La valeur par défaut pour tous les schémas de compression est « . gzip ».

Paquets::Extensions
Définit la liste par défaut des extensions de fichiers qui sont des fichiers de package. La valeur par défaut est
'.deb'.

Sources::Compress
Ceci est similaire à Packages::Compress sauf qu'il contrôle la compression pour le
Fichiers sources.

Sources::Extensions
Définit la liste par défaut des extensions de fichiers sources. La valeur par défaut est
'.dsc'.

Contenu::Compresser
Ceci est similaire à Packages::Compress sauf qu'il contrôle la compression pour le
Fichiers de contenu.

Traduction::Compresser
Ceci est similaire à Packages::Compress sauf qu'il contrôle la compression pour le
Traduction-en fichier maître.

Limite de lien
Spécifie le nombre de kilo-octets à dissocier (et à remplacer par des liens physiques) par exécution.
Ceci est utilisé en conjonction avec le paramètre Liens externes par section.

Mode fichier
Spécifie le mode de tous les fichiers d'index créés. La valeur par défaut est 0644. Tous les fichiers d'index
sont définis sur ce mode sans tenir compte du umask.

Description longue
Spécifie si les descriptions longues doivent être incluses dans le fichier Packages ou divisées
dans un fichier maître de traduction-en.

Arbre par défaut Blog
Définit les valeurs par défaut spécifiques aux sections de l'arborescence. Toutes ces variables sont des variables de substitution.
et remplacez les chaînes $(DIST), $(SECTION) et $(ARCH) par leurs valeurs respectives
valeurs.

MaxContentsChange
Définit le nombre de kilo-octets de fichiers de contenu générés chaque jour.
les fichiers de contenu sont exécutés de manière circulaire, de sorte qu'ils seront tous reconstruits sur plusieurs jours.

ContenuÂge
Contrôle le nombre de jours pendant lesquels un fichier de contenu peut être vérifié sans modification.
Si cette limite est dépassée, l'heure du fichier de contenu est mise à jour. Ce cas peut se produire.
si le fichier du package est modifié de manière à ne pas générer de nouveau contenu
fichier [remplacer la modification par exemple]. Un délai est accordé dans l'espoir que les nouveaux fichiers .deb
être installé, nécessitant de toute façon un nouveau fichier. La valeur par défaut est 10, les unités étant en jours.

Annuaire
Définit le sommet de l'arborescence du répertoire .deb. La valeur par défaut est
$(DIST)/$(SECTION)/binaire-$(ARCH)/

Répertoire source
Définit le sommet de l'arborescence du répertoire du paquet source. La valeur par défaut est
$(DIST)/$(SECTION)/source/

nos différents forfaits
Définit le fichier de packages de sortie. La valeur par défaut est $(DIST)/$(SECTION)/binary-$(ARCH)/Packages.

Références
Définit le fichier source de sortie. La valeur par défaut est $(DIST)/$(SECTION)/source/Sources.

Traduction
Définit le fichier maître de traduction de sortie avec les descriptions longues si elles doivent
ne doit pas être inclus dans le fichier Packages. La valeur par défaut est
$(DIST)/$(SECTION)/i18n/Translation-fr

Préfixe interne
Définit le préfixe de chemin qui fait qu'un lien symbolique est considéré comme un lien interne à la place
d'un lien externe. La valeur par défaut est $(DIST)/$(SECTION)/

Table des matières
Définit le fichier de contenu de sortie. La valeur par défaut est $(DIST)/$(SECTION)/Contents-$(ARCH). Si
ce paramètre provoque le mappage de plusieurs fichiers de packages sur un seul fichier de contenu (tel quel
la valeur par défaut) alors apt-ftparchive intégrera ces fichiers de package ensemble
automatiquement.

Contenu::En-tête
Définit le fichier d'en-tête à ajouter au début de la sortie du contenu.

BinCacheDB
Définit la base de données de cache binaire à utiliser pour cette section. Plusieurs sections peuvent être partagées.
la même base de données.

Liste de fichiers
Spécifie qu'au lieu de parcourir l'arborescence des répertoires, apt-ftparchive devrait lire le
Liste des fichiers du fichier donné. Les noms de fichiers relatifs sont précédés du nom de l'archive.
répertoire.

Liste des fichiers sources
Spécifie qu'au lieu de parcourir l'arborescence des répertoires, apt-ftparchive devrait lire le
Liste des fichiers du fichier donné. Les noms de fichiers relatifs sont précédés du nom de l'archive.
répertoire. Ceci est utilisé lors du traitement des index sources.

Arbre Blog
La section Arbre définit une arborescence de fichiers Debian standard qui se compose d'un répertoire de base,
puis plusieurs sections dans ce répertoire de base et enfin plusieurs architectures dans chaque
section. Le chemin exact utilisé est défini par la variable de substitution Directory.

La section Arbre prend une balise de portée qui définit la variable $(DIST) et définit la racine de
l'arborescence (le chemin est préfixé par ArchiveDir). Il s'agit généralement d'un paramètre tel que
distributions/jessie.

Tous les paramètres définis dans la section TreeDefault peuvent être utilisés dans une section Tree comme
ainsi que trois nouvelles variables.

Lors du traitement d'une section d'arbre apt-ftparchive effectue une opération similaire à :

pour i dans les sections faire
pour j dans Architectures faire
Générer pour DIST=scope SECTION=i ARCH=j

sections
Il s’agit d’une liste de sections séparées par des espaces qui apparaissent sous la distribution ;
généralement, il s'agit de quelque chose comme main contrib non-free

Architectures
Il s'agit d'une liste séparée par des espaces de toutes les architectures qui apparaissent dans la recherche
section. L'architecture spéciale « source » est utilisée pour indiquer que cet arbre a une
archive source. L'architecture « all » indique que des fichiers spécifiques à l'architecture, comme
Les packages ne doivent pas inclure d'informations sur l'architecture de tous les packages dans tous les fichiers
car ils seront disponibles dans un fichier dédié.

Description longue
Spécifie si les descriptions longues doivent être incluses dans le fichier Packages ou divisées
dans un fichier maître de traduction-en.

BinOverride
Définit le fichier binaire de remplacement. Ce fichier contient la section, la priorité et
informations sur l'adresse du responsable.

SrcOverride
Définit le fichier de remplacement source. Ce fichier contient les informations de section.

ExtraOverride
Définit le fichier de remplacement supplémentaire binaire.

SrcExtraOverride
Définit le fichier de remplacement supplémentaire source.

Répertoire Bin Blog
La section bindirectory définit une arborescence de répertoires binaires sans structure particulière.
La balise scope spécifie l'emplacement du répertoire binaire et les paramètres sont similaires à
la section Arbre sans variables de substitution ni paramètres SectionArchitecture.

nos différents forfaits
Définit la sortie du fichier Packages.

Références
Définit la sortie du fichier sources. Au moins un package ou une source est requis.

Table des matières
Définit la sortie du fichier de contenu (facultatif).

BinOverride
Définit le fichier de remplacement binaire.

SrcOverride
Définit le fichier de remplacement de la source.

ExtraOverride
Définit le fichier de remplacement supplémentaire binaire.

SrcExtraOverride
Définit le fichier de remplacement supplémentaire source.

BinCacheDB
Définit la base de données de cache.

Préfixe de chemin
Ajoute un chemin à tous les chemins de sortie.

Liste de fichiers, Liste des fichiers sources
Spécifie le fichier de liste de fichiers.

THE BINARY OVERRIDE DOSSIER

Le fichier binaire de remplacement est entièrement compatible avec dpkg-scanpackages(1). Il contient quatre
champs séparés par des espaces. Le premier champ est le nom du package, le second est le
priorité à laquelle forcer ce paquet, la troisième est la section à laquelle forcer ce paquet et
le champ final est le champ de permutation du mainteneur.

La forme générale du champ mainteneur est :

ancien [// ancien]* => nouveau

ou simplement,

nouvelle

La première forme permet de créer une liste d'anciennes adresses e-mail séparées par une double barre oblique.
spécifié. Si l'un de ces éléments est trouvé, alors "new" remplace le champ du mainteneur.
la deuxième forme remplace inconditionnellement le champ du mainteneur.

THE SOURCE OVERRIDE DOSSIER

Le fichier de remplacement source est entièrement compatible avec dpkg-scansources(1). Il contient deux
champs séparés par des espaces. Le premier champ correspond au nom du paquet source, le second au
section pour l'attribuer.

THE EXTRA OVERRIDE DOSSIER

Le fichier de remplacement supplémentaire permet d'ajouter ou de remplacer n'importe quelle balise arbitraire dans la sortie. Il
comporte trois colonnes, la première est le package, la seconde est la balise et le reste de
la ligne est la nouvelle valeur.

OPTIONS

Toutes les options de la ligne de commande peuvent être définies à l'aide du fichier de configuration, les descriptions
indiquer l'option de configuration à définir. Pour les options booléennes, vous pouvez remplacer la configuration
fichier en utilisant quelque chose comme -F-,--non-f, -f=non ou plusieurs autres variantes.

--md5, --sha1, --sha256, --sha512
Générer la somme de contrôle donnée. Ces options sont activées par défaut ; lorsqu'elles sont désactivées,
Les fichiers d'index générés ne contiendront pas de champs de somme de contrôle, si possible. Configuration
Éléments : APT::FTPArchive::Checksums et APT::FTPArchive::Sommaire::Checksums où Sommaire Vous pouvez
être des packages, des sources ou des versions et Checksums peut être MD5, SHA1, SHA256 ou SHA512.

-d, --db
Utilisez une base de données avec cache binaire. Cela n'a aucun effet sur la commande generate. Configuration
Élément : APT::FTPArchive::DB.

-q, --silencieux
Silencieux ; produit une sortie adaptée à la journalisation, sans indicateurs de progression. Plus de questions
produira plus de silence jusqu'à un maximum de 2. Vous pouvez également utiliser -q=# pour mettre le silence
niveau, remplaçant le fichier de configuration. Élément de configuration : silencieux.

--delink
Effectuer la suppression des liens. Si le paramètre « Liens externes » est utilisé, cette option
Permet de dissocier les fichiers. Cette option est activée par défaut et peut être désactivée avec
--no-delink. Élément de configuration : APT::FTPArchive::DeLinkAct.

--Contenu
Générer le contenu. Lorsque cette option est activée et que les index de paquets sont en cours
généré avec une base de données cache, la liste des fichiers sera également extraite et stockée dans
la base de données pour une utilisation ultérieure. Lors de l'utilisation de la commande generate, cette option permet également
Création de fichiers de contenu. Cette option est activée par défaut. Élément de configuration :
APT::FTPArchive::Contenu.

-s, --source-override
Sélectionnez le fichier de remplacement de source à utiliser avec la commande sources. Élément de configuration :
APT::FTPArchive::SourceOverride.

--lecture seulement
Rendre les bases de données de mise en cache en lecture seule. Élément de configuration : APT::FTPArchive::ReadOnlyDB.

-a, --cambre
Accepter dans les commandes packages et contents uniquement les fichiers de package correspondant à *_arch.deb ou
*_all.deb au lieu de tous les fichiers du paquet dans le chemin indiqué. Élément de configuration :
APT::FTPArchive::Architecture.

APT::FTPArchive::AlwaysStat
apt-ftparchive(1) met en cache autant de métadonnées que possible dans une base de données cache. Si les paquets sont
recompilé et/ou republié avec la même version, cela entraînera des problèmes
car les métadonnées en cache, désormais obsolètes, comme la taille et les sommes de contrôle, seront utilisées.
option activée, cela ne se produira plus car il sera vérifié si le fichier a été
modifié. Notez que cette option est définie sur « false » par défaut, car il n'est pas recommandé
télécharger plusieurs versions/builds d'un package avec le même numéro de version, donc en théorie
personne n'aura ces problèmes et donc tous ces contrôles supplémentaires sont inutiles.

APT::FTPArchive::LongDescription
Cette option de configuration est définie par défaut sur « true » et ne doit être définie sur « false » que si le
Archive générée avec apt-ftparchive(1) fournit également des fichiers de traduction. Notez que
Le fichier maître Translation-en ne peut être créé que dans la commande generate.

-h, --Aidez-moi
Afficher un bref résumé de l'utilisation.

-v, --version
Afficher la version du programme.

-c, --config-fichier
Fichier de configuration; Spécifiez un fichier de configuration à utiliser. Le programme lira le
fichier de configuration par défaut puis ce fichier de configuration. Si les paramètres de configuration
doivent être définis avant que les fichiers de configuration par défaut ne soient analysés spécifiez un fichier avec
le APT_CONFIG variable d'environnement. Voir apt.conf(5) pour les informations de syntaxe.

-o, --option
Définissez une option de configuration ; Cela définira une option de configuration arbitraire. Les
la syntaxe est -o Foo ::Bar=bar. -o et --option peut être utilisé plusieurs fois pour régler
différentes options.

EXEMPLES

Pour créer un fichier Packages compressé pour un répertoire contenant des packages binaires (.deb) :

apt-ftparchive Forfaits annuaire | gzip > Packages.gz

Utiliser apt-ftparchive en ligne à l'aide des services onworks.net