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_config] [-c=fichier_config]
{paquets chemin... [remplacer-fichier [préfixe de chemin]] |
sources chemin... [remplacer-fichier [préfixe de chemin]] | Contenu chemin |
libérer chemin | produire fichier_config ... | nettoyer fichier_config |
{-v | --version} | {-h | --aider}}

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 de dpkg-scanpackages(1) programme, intégrant l'intégralité de son
fonctionnalité via la commande packages. Il contient également un générateur de fichier de contenu,
contenu, et un moyen élaboré de « script » du 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 repose sur aucun programme externe à part gzip(1). Lorsque vous faites un plein
le générer effectue automatiquement des vérifications de changement de fichier et crée le fichier compressé souhaité
fichiers de sortie.

Sauf si -hou --Aidez-moi 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. Il faut le
répertoire donné et le recherche récursivement pour les fichiers .deb, émettant un enregistrement de package
à stdout pour chacun. 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. Il faut le
répertoire donné et le recherche récursivement pour les fichiers .dsc, émettant un enregistrement source
à stdout pour chacun. Cette commande est approximativement équivalente à dpkg-scansources (1).

Si un fichier de substitution est spécifié, un fichier de substitution source sera recherché avec
une extension de .src. L'option --source-override peut être utilisée pour changer 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. Il faut le
répertoire donné et le recherche récursivement pour les fichiers .deb et lit la liste des fichiers
de chaque fichier. Il trie ensuite et écrit sur stdout la liste des fichiers correspondant à
paquets. Les répertoires ne sont pas écrits dans la sortie. Si plusieurs packages possèdent le même
fichier, 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. Il récursivement
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 nom de fichier supplémentaires peuvent être
ajoutés en les listant dans APT::FTPArchive::Release::Patterns. Il écrit ensuite sur stdout
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 supportés sont : Origine, Label, Suite,
Version, Nom de code, Date, Valide 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 donné. Le langage de configuration fournit un moyen flexible de
en spécifiant quels fichiers d'index sont construits à partir de quels répertoires, ainsi qu'en 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.

LES PRODUIRE CONFIGURATION

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

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

Dir Section
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 suivantes pour produire un chemin absolu complet.

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

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

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

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

Réglage par défaut Section
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 par section.

Paquets::Compresser
Définit les schémas de compression par défaut à utiliser pour les fichiers d'index de package. C'est un
chaîne qui contient une liste séparée par des espaces d'au moins l'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'.

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

Sources::Compresser
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 qui sont des fichiers source. Cette 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.

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

Filemode
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 réglés sur ce mode sans tenir compte du umask.

Longue description
Spécifie si les descriptions longues doivent être incluses dans le fichier Packages ou fractionnées
dans un fichier maître Translation-en.

ArbrePar défaut Section
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.

MaxContentsChange
Définit le nombre de kilo-octets de fichiers de contenu générés chaque jour. Les
les fichiers de contenu sont arrondis de manière à ce qu'ils soient 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, le mtime du fichier de contenu est mis à jour. Ce cas peut se produire
si le fichier de package est modifié de telle manière qu'il n'en résulte pas un nouveau contenu
fichier [modifier modifier par exemple]. Une suspension est autorisée 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 sont en jours.

Annuaire
Définit le haut de l'arborescence des répertoires .deb. Par défaut à
$(DIST)/$(SECTION)/binaire-$(ARCH)/

SrcRépertoire
Définit le haut de l'arborescence des répertoires du package source. Par défaut à
$(DIST)/$(SECTION)/source/

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

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

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

Préfixe interne
Définit le préfixe de chemin qui fait qu'un lien symbolique est plutôt considéré comme un lien interne
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 entraîne le mappage de plusieurs fichiers de packages sur un seul fichier de contenu (tel qu'il est
la valeur par défaut) puis apt-ftparchive intégrera ces fichiers de package ensemble
automatiquement.

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

BinCacheDB
Définit la base de données de cache binaire à utiliser pour cette section. Plusieurs sections peuvent partager
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éfixés par l'archive
répertoire.

ListeFichier Source
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éfixés par l'archive
annuaire. Ceci est utilisé lors du traitement des index sources.

Arbre Section
La section Tree 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 de répertoire.

La section Tree prend une balise scope 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
distes/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 ne
pour j dans Architectures faire
Générer pour DIST=portée SECTION=i ARCH=j

sections
Il s'agit d'une liste de sections séparées par des espaces qui apparaissent sous la distribution ;
typiquement c'est quelque chose comme main contrib non-free

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

Longue description
Spécifie si les descriptions longues doivent être incluses dans le fichier Packages ou fractionnées
dans un fichier maître Translation-en.

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

SrcOverride
Définit le fichier de remplacement source. Le fichier de remplacement contient des informations de section.

Supplément
Définit le fichier binaire de remplacement supplémentaire.

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

Répertoire Bin Section
La section bindirectory définit une arborescence de répertoires binaires sans structure particulière. Les
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 d'Architecture de Section.

Formules
Définit la sortie du fichier Packages.

Sources
Définit la sortie du fichier Sources. Au moins un des packages ou sources 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 source.

Supplément
Définit le fichier binaire de remplacement supplémentaire.

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, ListeFichier Source
Spécifie le fichier de liste de fichiers.

LES BINARY OVERRIDE DOSSIER

Le fichier de remplacement binaire 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é pour forcer ce paquet à, la troisième est la section pour forcer ce paquet à et
le dernier champ est le champ de permutation du mainteneur.

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

ancien [// ancien]* => nouveau

ou simplement,

neufs

Le premier formulaire permet de créer une liste d'anciennes adresses e-mail séparées par une double barre oblique.
spécifié. Si l'un d'entre eux est trouvé, alors new est remplacé par le champ mainteneur. Les
la seconde forme remplace inconditionnellement le champ mainteneur.

LES 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 est le nom du package source, le second est le
section pour l'attribuer.

LES EXTRA OVERRIDE DOSSIER

Le fichier de remplacement supplémentaire permet d'ajouter ou de remplacer n'importe quelle balise arbitraire dans la sortie. Ce
a 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, le
les fichiers d'index générés n'auront pas les champs de somme de contrôle dans la mesure du possible. Configuration
Éléments : APT :: FTPArchive ::Checksums et APT :: FTPArchive ::Sommaire::Checksums De Sommaire vous
ê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 de mise en cache binaire. Cela n'a aucun effet sur la commande de génération. Configuration
Élément : APT::FTPArchive::DB.

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

--delink
Effectuez la déliaison. Si le paramètre Liens externes est utilisé, cette option est en fait
permet de dissocier les fichiers. Il est activé par défaut et peut être désactivé avec
--pas de déconnexion. Élément de configuration : APT::FTPArchive::DeLinkAct.

--Contenu
Effectuer la génération de contenu. Lorsque cette option est définie et que les index des packages sont
généré avec une base de données de 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 tout fichier de contenu. La valeur par défaut est activée. Élément de configuration :
APT::FTPArchive::Contenu.

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

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

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

APT :: FTPArchive :: AlwaysStat
apt-ftparchive(1) cache autant que possible de métadonnées dans un cachedb. Si les colis sont
recompilé et/ou republié avec la même version à nouveau, cela entraînera des problèmes
car les métadonnées mises en cache désormais obsolètes, telles que la taille et les sommes de contrôle, seront utilisées. Avec ça
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é de
télécharger plusieurs versions/builds d'un paquet 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. Noter 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 ainsi que --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

Utilisez apt-ftparchive en ligne en utilisant les services onworks.net