jigdo-file - En ligne dans le Cloud

PROGRAMME:

Nom

jigdo-file - Préparer des fichiers pour le téléchargement de Jigsaw (distribution de fichiers volumineux, par exemple un CD
images).

SYNOPSIS

fichier jigdo COMMAND
[ --image=cdrom.iso ] [ --jigdo=cdrom.jigdo ] [ --modèle=cdrom.modèle ] [ --Obliger ] [
AUTRES OPTIONS ] [ DES DOSSIERS | --files-from=f ]
Commun COMMANDES : faire un modèle, faire-image, vérifier

DESCRIPTION

Jigsaw Download, ou short jigdo, est un schéma développé principalement pour faciliter
distribuer d'énormes images de système de fichiers (par exemple, des images de CD (ISO9660) ou de DVD (UDF)) sur le
Internet, mais il pourrait également être utilisé pour d'autres données difficiles à gérer en raison de sa
taille, comme des fichiers audio/vidéo ou des progiciels volumineux.

jigdo essaie de s'assurer que le gros fichier (toujours appelé image à partir de maintenant) est téléchargé
en petites pièces qui peuvent être stockées sur différents serveurs. Les personnes qui souhaitent télécharger le
image le faire en disant au jigdo(1) (NE PAS MIS EN ŒUVRE ENCORE) télécharger l'outil pour en traiter un
`.jigdo' déposer; En l'utilisant, jigdo télécharge les pièces et réassemble l'image. fichier jigdo
est utilisé pour préparer les fichiers à télécharger.

Ce qui rend Jigdo spécial, c'est que les pièces qui sont utilisées pour reconstruire l'image peuvent avoir
n'importe quelle taille et contenu - ils doivent seulement être contenus dans une région contiguë n'importe où dans
l'image.

Par exemple, si vous souhaitez diffuser une image ISO9660 qui contient un instantané d'un
serveur FTP, vous pouvez demander fichier jigdo préparer les données de téléchargement de manière à ce que
quand les gens utilisent jigdo pour télécharger l'image, jigdo récupère réellement les fichiers individuels
depuis le serveur FTP et les assemble en une copie exacte de votre image - pendant la
Télécharger! (Si l'image n'est pas un dump du système de fichiers, vous pouvez utiliser scission(1) pour créer le petit
pièces à partir desquelles l'image sera réassemblée.)

Vous êtes totalement libre de choisir où les différentes parties de l'image sont stockées : elles
peuvent se trouver dans des répertoires entièrement différents sur des serveurs différents (par exemple à cause de
contraintes de stockage/bande passante), mais cela est invisible pour les personnes qui téléchargent votre
image. Les informations sur les serveurs disponibles doivent seulement être ajoutées au `.jigdo' fichier
par vous avant de le distribuer.

La section « DÉTAILS » ci-dessous contient des détails techniques sur le fonctionnement de Jigdo. Les « EXEMPLES »
La section répertorie un certain nombre de scénarios courants et peut vous aider à vous faire une idée de ce que jigdo
est utile pour.

OPTIONS

De nombreuses options sont spécifiques à un COMMAND; celles ci-dessous sont générales ou utilisées par
plusieurs commandes. D'autres options sont répertoriées ci-dessous avec les commandes individuelles. Tous
les options sont ignorées en silence si elles ne sont pas applicables à la commande en cours. Pour toute
OCTETS paramètres aux options, vous pouvez ajouter l'une des lettres « k », « M » ou « G » au
montant que vous spécifiez, pour indiquer les kilo-octets, les mégaoctets ou les gigaoctets.

-h --Aidez-moi
Afficher un bref résumé des commandes et des options.

-H --aide-à tous
Récapitulatif complet de sortie des commandes et des options.

-v --version
Version du programme de sortie.

-i --image=cdrom.iso
Spécifiez l'emplacement du fichier contenant l'image. L'image est le gros fichier qui
vous voulez distribuer.

-j --jigdo=cdrom.jigdo
Spécifiez l'emplacement du fichier de description de téléchargement de Jigsaw. Le fichier jigdo est un
fichier lisible par l'homme généré par fichier jigdo, auquel vous ajoutez des informations sur tous
les serveurs sur lesquels vous allez télécharger les fichiers. jigdo téléchargera ce fichier comme
la première étape de récupération de l'image.

-t --modèle=cdrom.modèle
Spécifiez l'emplacement du fichier 'modèle' de l'image. Le fichier modèle est un fichier binaire
généré par fichier jigdo, il contient des informations sur la façon de réassembler l'image et
également (sous forme compressée) toutes les données de l'image qui n'ont été trouvées dans aucun des
les parties.

Selon la commande, chacun de ces trois fichiers est parfois utilisé en entrée,
parfois pour la sortie. Si le fichier doit être utilisé pour la sortie d'une commande particulière
et le fichier de sortie existe déjà, fichier jigdo se termine avec une erreur, à moins que --Obliger
est présent.

Dans la plupart des cas, vous n'aurez qu'à spécifier un -i -j -t, parce que tout
les noms de fichiers manquants seront déduits de celui que vous spécifiez. Cela se fait en premier
en supprimant toute extension du nom fourni, puis en n'ajoutant rien (si
déduire --image), `.jigdo' ou '.modèle'.

-r --report=default|noprogress|calme|grep
Contrôlez le niveau de bavardage du programme et le format de la sortie : pas de progrès is
le même que défaut sauf qu'aucun message de progression `x% done' n'est imprimé. calme
restreint la sortie à ce qui est absolument nécessaire, principalement des messages d'erreur. grep
est seulement différent de défaut pour le faire-modèle commande : Elle active la sortie dans
un simple ` ' format utile lors de la recherche de fichiers binaires
dans d'autres fichiers binaires.

-f --Obliger
Écrasez les fichiers de sortie existants sans vous plaindre.

--Pas de force
Ce is le défaut. Refuser d'écraser les fichiers de sortie existants.

-c --cache=jigdo-cache.db
fichier jigdo a généralement besoin de lire l'intégralité du contenu de tous les DES DOSSIERS vous spécifiez.
Si vous l'utilisez à plusieurs reprises (par exemple parce que vous mettez une nouvelle image de CD à disposition quotidiennement),
la mise en cache des informations du fichier augmentera considérablement la vitesse du programme. Les
cache est automatiquement créé s'il n'est pas encore présent. Les données sont généralement à la fois
lu et écrit dessus.

--pas de cache
Ce is le défaut. N'utilisez pas de cache.

--cache-expiration=SECONDS
Définir l'âge maximum des entrées de cache. Toutes les entrées plus anciennes que cela seront supprimées de
la cachette. La valeur par défaut est de 30 jours. Vous pouvez ajouter l'une des lettres « h », « d », « w »,
« m », « y » pour désigner respectivement les heures, les jours, les semaines, les mois ou les années. Une valeur de
« 0 » ou « off » désactive l'expiration, de sorte que toutes les entrées restent dans le cache pour toujours.
Voir la section « FICHIERS CACHE » ci-dessous pour plus d'informations.

--readbuffer=OCTETS
Définir la taille des tampons internes. La valeur par défaut est 128k - si vous avez un disque rapide,
l'augmentation de cette valeur peut rendre fichier jigdo plus rapide, mais en général, le changer est
pas nécessaire.

--md5-block-size=OCTETS
Inintéressant interne paramètre. Définir la taille des blocs dans lesquels les fichiers sont
subdivisé. La valeur par défaut est 128k. Si vous le modifiez, tout fichier cache devra être
régénéré. Intérieurement, fichier jigdo peut choisir d'utiliser un légèrement plus grand ou plus petit
valeur.

-T --files-from=filet
Lit les noms de fichiers et de répertoires à partir du fichier spécifié. Si filet est "-", lire les noms
à partir de l'entrée standard. Chaque ligne du fichier est considérée comme un nom, les noms peuvent donc
contiennent des espaces, mais pas de caractères de nouvelle ligne. Une ligne vide provoque fichier jigdo pour arrêter
lecture du fichier.

trouver(1) est un outil puissant pour générer des listes de fichiers, mais assurez-vous d'utiliser `trouver
De type f' si possible - sinon, si vous demandez trouver pour afficher à la fois un nom de fichier
et un lien symbolique vers ce nom de fichier, fichier jigdo lira le contenu du fichier deux fois.

--hexadécimal Sommes de contrôle de sortie en hexadécimal au lieu du format de type Base64. Cela ne devrait pas être
utilisé avec le faire-modèle commande, car le résultat `.jigdo' fichier viole
le `.jigdo' format de fichier. Son utilisation prévue est de faire fichier jigdo plus interopérable
avec d'autres utilitaires shell Unix comme md5sum (1).

--pas d'hex
Ce is le défaut. Utilisez le propre encodage des sommes de contrôle de type Base64 de jigdo.

--debug[=help|=tout|=UNITÉ,~UNITÉ... ]
Activer ou désactiver la sortie de débogage. Juste `--debug' est équivalent à `--debug=all'.
L'argument est une liste de noms d'unités séparés par des virgules pour lesquels la sortie de débogage est
être activé, ou désactivé si le nom est précédé de `~'. Le nom spécial « tous »
signifie toutes les unités. Par défaut, la sortie de débogage est désactivée sauf pour les unités
« affirmer » et « général ». La liste exacte des unités disponibles pour lesquelles le débogage peut
être activé dépend de si jigdo a été compilé avec le support de débogage - le
la liste peut être imprimée avec `--debug=help'.

DES DOSSIERS Noms de fichiers ou de répertoires à utiliser en entrée. Ce sont les pièces qui sont
contenu dans l'image. Si l'un des noms est un répertoire, le programme
analyse récursivement le répertoire et ajoute tous les fichiers qu'il contient. Tout en faisant
cela, il suit les liens symboliques, mais évite les boucles de liens symboliques.

Si l'un des noms de fichiers commence par le caractère « - », vous devez précéder la liste des
fichiers avec `--'. Une valeur de « - » a aucune signification particulière dans cette liste, il signifie
un fichier dont le nom est un seul tiret.

COMMANDES

Le nom de la commande est le premier argument non optionnel passé à fichier jigdo. La plupart des commandes ont
des abréviations courtes ainsi que des noms longs. La court commander noms devrait ne sauraient be d'utiliser in
scripts - là Au cours de cette réunion, Matthew a obtenu de précieux conseils et Linda lui a demandé de la tenir au courant de ses progrès. be incompatible change à le point de vue de in le avenir!

FAIRE-MODÈLE, MT
Lit image ainsi que DES DOSSIERS, crée `.jigdo' et '.modèle'. C'est la fonctionnalité principale de
fichier jigdo.

Il est possible de spécifier les deux --image=- ainsi que --files-from=-. Dans ce cas, d'abord la liste
des fichiers est lu à partir de l'entrée standard jusqu'à ce qu'une ligne vide soit rencontrée. Tout
la suite est supposée être les données d'image. Cela peut être utile si vous utilisez mkisofs(1) ou
programmes similaires qui peuvent sortir l'image complète sur leur sortie standard, car
il n'est pas nécessaire de stocker temporairement l'image sur le disque.

Si un DES DOSSIERS l'argument contient les caractères `//' (Unix) ou `\.\' (Windows), cela a
sens spécial. Dans le fichier jigdo final que les utilisateurs téléchargeront, chacune des pièces est
référencé dans la section `[Parts]' avec un URI de la forme `Label:some/filename'. (Voir
`FORMAT DES FICHIERS .JIGDO' ci-dessous pour une description détaillée.) La section `[Servers]' donne
un mappage d'étiquettes vers des serveurs sur Internet, avec des lignes comme
`Étiquette=http://myserver.org/jigdofiles/'. En utilisant ces informations, jigdo va créer le
URI de téléchargement final pour la pièce, `http://myserver.org/jigdofiles/some/filename'.
Spécifier `//' (ou `\.\') dans un nom de fichier ou de répertoire sert à `couper' les noms à
le bon niveau de répertoire. Par exemple, si le chemin Unix d'un de vos DES DOSSIERS is
`/chemin/certain/nom de fichier', vous pouvez dire fichier jigdo couper après le `/chemin' en le passant
l'argument `/path//some/filename', ou `/path//' si vous voulez que tout le répertoire soit scanné.
Les noms de chemin n'ont pas besoin d'être absolus ; `somedirectory//' est également possible.

--étiqueter Étiquette=/chemin
Spécifiez un nom à utiliser comme nom d'étiquette pour un chemin sur le disque. (Influence la sortie
jigdo.) Si vous avez utilisé `//' dans le DES DOSSIERS arguments comme décrit ci-dessus, fichier jigdo
par défaut, sélectionnera automatiquement les noms d'étiquette (`A', `B' etc.). Avec cette option,
vous pouvez donner aux étiquettes des noms plus significatifs. Notez que le nom de l'étiquette ne sera
utilisé si un ou plusieurs DES DOSSIERS commencer par `/chemin//'.

Essayez d'utiliser des noms d'étiquette qui commencent par des caractères majuscules, pour les lever d'ambiguïté
clairement à partir de noms de protocoles comme `http', `ftp'.

--uri Étiquette=http://some.server.org/
Par défaut, en utilisant --étiqueter comme décrit ci-dessus provoquera des lignes de la forme
`Label=file:/path/' à écrire dans la section `[Servers]' du jigdo de sortie
déposer. Si vous souhaitez remplacer l'URI `file:' afin que la ligne lise
`Étiquette=http://some.server.org/', vous pouvez le faire en spécifiant --uri avec
--étiqueter. Donner juste --uri Libellé=... sans le correspondant --étiqueter Libellé=...
n'a aucun effet, et même si vous spécifiez les deux, une entrée n'est ajoutée qu'à la
Section `[Servers]' si l'étiquette est référencée par au moins une entrée `[Parts]'.

La valeur fournie n'est pas citée par le programme ; s'il contient des caractères tels que
espace ou l'un des caractères #"'\ alors vous devez le citer. (Sous Unix, vous pouvez
besoin de citer la valeur deux fois pour la protéger également du shell, par exemple \\\\ ou '\\'
pour obtenir une seule barre oblique inverse dans l'URI.)

Le mappage spécifié avec un --uri L'option est ignorée si elle est déjà présente dans
le fichier jigdo de sortie.

Les utilisateurs de la version Windows peuvent remarquer que les séparateurs de répertoire `\' sont
convertis en `/' dans les URI `file:' qui sont générés par défaut. C'est fait
pour augmenter la compatibilité multiplateforme de `file:' - le impression manquante commande de
la version Windows reconvertira automatiquement les caractères lorsqu'elle imprimera le
URI. Si vous fournissez vos propres URI `file:' sous Windows en utilisant --uri, Vous devez
échangez également `/' et `\'.

-0 à -9
Définir la quantité de compression dans le fichier de modèle de sortie, à partir de -0 (pas de compression) à
-9 (compression maximale). La valeur par défaut est -9, ce qui peut rendre la génération du modèle
assez lent. Par défaut, l'algorithme de compression utilisé est le même que pour gzip (1).

--gzip ainsi que --bzip2
Choisissez entre les algorithmes de compression gzip et bzip2. La valeur par défaut est gzip.
Bzip2 donne généralement un meilleur taux de compression, mais la compression est significativement
plus lent qu'avec gzip.

--min-long=OCTETS
Définir la longueur minimale d'une pièce pour fichier jigdo pour le chercher dans l'image. Les
la valeur par défaut est 1k. Les parties plus petites que cela ne seront jamais trouvées dans l'image, donc leur
les données seront incluses dans le fichier modèle. L'algorithme de recherche utilisé nécessite une telle
une longueur minimale, sinon la génération de modèles pourrait devenir extrêmement lente. Si tu
sachez avec certitude que tous vos DES DOSSIERS sont supérieurs à un certain montant, vous pouvez
augmenter fichier jigdo's speed légèrement en spécifiant le montant avec cette option.
Il y a un minimum absolu câblé de 256 octets - tout ce qui est inférieur sera silencieux
être réglé sur 256.

--merge=DOSSIER
Inclure le contenu de DOSSIER dans la sortie `.jigdo' déposer. Le fichier peut contenir des données
que vous souhaitez ajouter à la sortie (par exemple, une section `[Servers]' avec une liste
de vos serveurs en tant qu'entrées), ou il peut s'agir du fichier jigdo généré par une exécution précédente
of fichier jigdo.

Il est possible de spécifier le même fichier pour l'entrée avec --fusionner et pour la sortie avec
--jigdo. Cependant, vous devrez également utiliser --Obliger faire écraser le programme
l'ancienne version du fichier jigdo avec la nouvelle. DOSSIER peut être "-" pour la norme
contribution.

Quand ajoutant de nouvelles informations au fichier fourni, fichier jigdo n'insérera pas de nouveau
lignes dans la section `[Parts]' si une entrée pour la même somme de contrôle MD5 (mais pas
nécessairement avec le même URI !) existe déjà, et il n'insérera pas de nouvelles lignes
dans la section `[Servers]' si une entrée complètement identique existe déjà.

Quand lire in l'existant DOSSIER, le comportement est légèrement différent : Le programme
conserves entrées dans la section `[Parts]' avec une somme de contrôle identique, mais différente
URI. Pour des entrées complètement identiques (même somme de contrôle et URI), une seule entrée est
conservés et les doublons sont supprimés. La section `[Serveurs]' est laissée
intacte.

--image-section
Ce is le défaut. Causes fichier jigdo pour ajouter une section `[Image]' au `.jigdo'
fichier.

À titre d'exception, une nouvelle section `[Image]' est ne sauraient ajouté si vous utilisez --fusionner et par
fichier à fusionner contient une section `[Image]' avec une ligne qui lit `Template-
MD5Sum=' (fin de ligne après le `='). Dans ce cas, les données de modèle générées
La valeur de la somme de contrôle MD5 est juste ajoutée après le `=' de la première ligne de ce formulaire dans
le fichier - aucune nouvelle section `[Image]' n'est ajoutée. Ce comportement est utile
car il permet de passer par --fusionner une section `[Image]' avec arbitraire
contenu, puis ajouter automatiquement la somme de contrôle MD5 par fichier jigdoL’
la section `FORMAT DES FICHIERS .JIGDO' ci-dessous explique le contenu de la section `[Image]' dans
Plus de détails.

--pas de section-image
Do ne sauraient inclure une section `[Image]' dans le `.jigdo' déposer. Vous devez en ajouter un
vous-même si vous utilisez cette option. Cependant, ce n'est pas facile (vous devez également
ajouter une ligne `Template-MD5Sum' avec la somme de contrôle correcte, ou jigdo va se plaindre), alors
l'utilisation de cette option est déconseillée.

--section-serveurs
Ce is le défaut. Causes fichier jigdo pour ajouter une section `[Servers]' au `.jigdo'
déposer. Cette section par défaut utilise les URI « fichier : », ce qui permet un réassemblage immédiat
de l'image à partir du système de fichiers local, et est également utile si vous souhaitez modifier le
fichier manuellement et remplacez les URI `file:' par d'autres URI.

--pas de section-serveurs
Do ne sauraient ajouter une section `[Servers]' à la fin du `.jigdo' déposer. Utile par exemple si
vous allez ajouter la section avec un script.

--match-exec=COMMANDEMENT SHELL
Chaque fois qu'un fichier est trouvé dans l'image, exécutez la chaîne de commande fournie en
en le passant à une coquille. fichier jigdo configure un certain nombre de variables d'environnement avec
informations sur la correspondance de fichier. Par exemple, si le fichier `/chemin//a/b/fichier' était
trouvé dans l'image et `Label:a/b/file' va être écrit dans le `.jigdo'
fichier:

· LABEL="Label" - Nom de l'étiquette du fichier. L'exemple suppose que `--étiqueter
Label=/path' a été spécifié par vous. En l'absence d'une telle option, LABEL sera
être défini mais vide.

· CHEMIN D'ÉTIQUETTE="/path/" - Le chemin correspondant à l'étiquette, ou en d'autres termes, le
préfixe du chemin du fichier correspondant qui sera ne sauraient apparaissent dans la sortie `.jigdo'
déposer. Est défini même sans aucun `--étiqueter' option présente. Se termine par une barre oblique.

· CHEMIN DE MATCH="a/b/" - Le reste du chemin, sans le nom de feuille du correspondant
déposer. Est soit vide, soit se termine par une barre oblique.

· LEAF="file" - Le nom de feuille du fichier correspondant.

· MD5SUM="lNVdUSqbo2yqm33webrhnw" - La somme md5 du fichier correspondant, en Base64-like
le format.

· DOSSIER="/path//a/b/file" - Pour plus de commodité, le chemin complet du fichier. Les
La variable est toujours définie sur $LABELPATH$MATCHPATH$LEAF.

Attention à bien citer la chaîne passée à cette option, sinon votre
La commande fournie ne fonctionnera pas avec les noms de fichiers contenant des espaces. A titre d'exemple, à
créer une sauvegarde des liens physiques vers les fichiers correspondants, utilisez l'option suivante : --match-
exec='mkdir -p "${LABEL:-.}/$MATCHPATH" && ln -f "$FILE" "${LABEL:-.}/$MATCHPATH$LEAF"'

Par défaut, aucune commande n'est exécutée. Utilisez --match-exec="" pour supprimer une chaîne de commande qui
a été défini avec une utilisation antérieure de cette option.

--correspondance gourmande
Ce is le défaut. Imaginez que votre image contient un .le goudron fichier qui à son tour
contient un autre fichier x, et que vous fournissez à la fois le .le goudron et les fichiers qu'il contient
sur la ligne de commande. Lorsque fichier jigdo scanne l'image, elle rencontre le début
des .le goudron fichier, puis le fichier x.

À ce stade, une décision doit être prise : si le fichier plus petit x être enregistré comme
correspond, ou doit-il être ignoré en faveur de la plus grande (et donc meilleure) correspondance de
le .le goudron déposer? Malheureusement, à ce stade, il n'est pas clair s'il y aura
être en fait un match complet de la .le goudron, donc par défaut, le programme préfère le petit
correspondre.

--pas de correspondance gourmande
Dans le cas où une grande correspondance partielle est présente et une correspondance plus courte a été
confirmé, ignorez la petite allumette. (Voir l'option ci-dessus.)

FAIRE-IMAGE, MI
Lit `.modèle' et DES DOSSIERS, crée image (ou `nomimage.tmp'). Fournit un rudimentaire
façon de réassembler les images - jigdo est généralement mieux adapté à cette tâche. Cependant, dans
contraste avec jigdo, non `.jigdo' est requis.

Si l'image doit être écrite dans un fichier (et non sur une sortie standard), il est possible de
créer l'image en plusieurs étapes, avec plusieurs invocations de `fichier jigdo faire-image', comme
suit : vous invoquez d'abord fichier jigdo, en spécifiant autant de fichiers que disponibles à ce
temps. Le programme analyse les fichiers et ceux qui sont contenus dans l'image sont copiés vers
un fichier temporaire, dont le nom est formé en ajoutant `.tmp' au nom du fichier image.

Pour tous les autres fichiers qui pourraient faire partie de l'image, vous répétez ce processus. Dès que
comme toutes les parties sont présentes, le fichier temporaire sera légèrement tronqué (pour supprimer certaines
données administratives qui fichier jigdo ajoute à la fin) et renommé à l'image finale
Nom. La possibilité de réassembler l'image en plusieurs étapes est particulièrement utile pour
rassembler des fichiers à partir de supports amovibles, par exemple plusieurs anciens CD.

Scripts utilisant faire-image peut détecter si la création de l'image est terminée en vérifiant le
état de sortie : 0 signale une création réussie, tandis que 1 signifie que plus de fichiers doivent être
fourni. D'autres erreurs entraînent un état de sortie de 2 ('récupérable', par exemple fichier introuvable)
ou 3 (non récupérable, par exemple erreur d'écriture).

--Vérifier les fichiers
Ce is le défaut. Chaque fois qu'une partie est copiée sur l'image, revérifiez son
somme de contrôle par rapport à la somme de contrôle stockée dans le modèle. Il est recommandé que vous
laissez-le activé, même si cela ralentit un peu la création d'image.

--no-check-fichiers
Ne vérifiez pas les sommes de contrôle des fichiers lorsque vous les copiez dans l'image. Cela peut être en toute sécurité
utilisé lorsqu'aucun fichier cache n'est utilisé (ce qui signifie que les fichiers seront écrits dans le
image immédiatement après avoir été numérisée) ou l'image entière est vérifiée plus tard avec le
vérifier commander.

IMPRIMER MANQUANT, PM
Lit `.jigdo', '.modèle' et (si présent) `nomimage.tmp', affiche une liste d'URI toujours
nécessaire pour réassembler complètement l'image.

Avec la faire-image commande, cela fournit la plupart des fonctionnalités de jigdo on
la ligne de commande.

Pour chaque partie qui n'est pas encore présente dans le fichier image temporaire, la somme de contrôle du fichier est
recherché dans la section `[Parts]' du fichier jigdo. Toute étiquette dans l'entrée correspondante
est ensuite développé selon les définitions d'étiquette dans la section `[Servers]' et imprimé
sur sortie standard. jigdo vous permet de spécifier plusieurs emplacements alternatifs pour chaque
étiquette dans cette section, mais impression manquante n'affichera que le premier pour chaque manquant
partie.

Si la somme de contrôle ne peut pas être trouvée dans la section « [Parts] » (cela ne devrait pas se produire à moins que
vous avez supprimé cette section), une recherche est effectuée à la place pour `MD5Sum :', juste comme
avec jigdo. (Ainsi, si vous souhaitez vous débarrasser de la section `[Pièces]', vous pouvez le faire si vous
renommer chaque partie avec sa propre somme de contrôle.)

--uri Étiquette=http://some.server.org/
Remplacer les entrées dans le `.jigdo' pour n'importe quelle étiquette avec l'URI de votre choix.
Avec l'exemple ci-dessus, une entrée `[Parts]' de `Label:some/filename' provoquera le
ligne `http://some.server.org/some/filename' à imprimer.

La valeur fournie n'est pas citée par le programme ; s'il contient des caractères tels que
espace ou l'un des caractères #"'\ alors vous devez le citer. (Sous Unix, vous pouvez
besoin de citer la valeur deux fois pour la protéger également du shell, par exemple \\\\ ou '\\'
pour obtenir une seule barre oblique inverse dans l'URI.)

IMPRIMER-MANQUANT-TOUT, PMA
Tout comme impression manquante, cette commande affiche une liste d'URI encore nécessaires pour
remonter l'image. Cependant, TOUTE les emplacements de téléchargement alternatifs sont imprimés au lieu de
juste un. Dans la sortie, les URI d'un fichier sont séparés des URI des autres fichiers avec
lignes vierges. Les --uri l'option a le même effet que pour impression manquante.

VÉRIFIER, VER
Lit image (probablement généré avec faire-image) et `.modèle', vérifie l'exactitude
somme de contrôle de l'image.

Les données du modèle ne contiennent pas seulement les sommes de contrôle des pièces individuelles, mais aussi des
image dans son ensemble. faire-image effectue déjà un certain nombre de contrôles internes, mais si vous
comme, vous pouvez également vérifier l'image avec cette commande.

ANALYSE, SC
Lit tous les DES DOSSIERS et les entre dans le cache, à moins qu'ils ne soient déjà mis en cache. Les
--cache L'option doit être présente pour cette commande.

--pas d'analyse du fichier entier
Ce is le défaut. Cela ne provoque que le premier --md5-block-size octets de chaque fichier
être lu. Si le cache est utilisé ultérieurement par fichier jigdo faire-image, le reste de la
sera lu une fois ces premiers octets reconnus dans l'image d'entrée.

--scan-fichier entier
Lisez immédiatement tout le contenu du fichier et stockez-le dans le cache.

MD5SOMME, MD5
Lit tous les DES DOSSIERS et imprime les sommes de contrôle MD5 de leur contenu. Cette commande est assez
similaire à md5sum(1), sauf que la somme de contrôle est sortie dans l'encodage de type Base64 qui
est également utilisé ailleurs par fichier jigdo.

La DES DOSSIERS les arguments sont traités de la même manière qu'avec les autres commandes, c'est-à-dire
que la récursivité a lieu automatiquement pour tous les arguments qui sont des répertoires, et que
les liens symboliques ne sont pas répertoriés, sauf lorsque le ou les fichiers vers lesquels ils pointent ne sont pas accessibles
directement.

Dans la liste des sommes de contrôle imprimées sur la sortie standard, seule la partie du nom de fichier qui suit
tout `//' (ou `\.\' sous Windows) est imprimé. Tout --cache sera utilisé pour interroger les fichiers'
Sommes de contrôle MD5 et/ou écriture des sommes de contrôle des fichiers numérisés.

LISTE-MODÈLE, LS
Lit un `.modèle' et génère des informations de bas niveau sur l'image et toutes les parties
qu'il contient, y compris le décalage, la longueur et la somme de contrôle.

Vous pouvez également utiliser cette commande avec des fichiers image temporaires (en spécifiant quelque chose comme
--template=nomimage.tmp) - dans ce cas, la sortie distingue également les parties qui
ont été écrits sur l'image et les parties qui ne l'ont pas été.

Le format de sortie exact peut changer de manière incompatible entre les différentes versions de jigdo. Les
les différents types de lignes suivants peuvent être sortis. `avoir-fichier' ne se produit que pour `.tmp'
fichiers, indiquant un fichier qui a déjà été écrit avec succès dans le fichier temporaire :

dans le modèle décalage dans l'image longueur
fichier-besoin décalage dans l'image longueur fichier-md5sum filestart-rsyncsum
avoir-fichier décalage dans l'image longueur fichier-md5sum filestart-rsyncsum
info-image longueur de l'image image-md5sum taille-rsyncsum

DÉTAILS

Jigsaw Download a été créé avec le format des images de CD ISO9660 à l'esprit - cependant, le
ce qui suit s'applique également à de nombreux autres formats de système de fichiers, ainsi qu'aux archives `tar' et
archives « zip » non compressées. Une image CD contient à la fois des informations pour organiser le
système de fichiers (en-tête avec nom de disque, etc., données de répertoire ISO9660, données d'extensions telles que
Joliet ou RockRidge, zéro remplissage) et les fichiers contenus sur le CD. Un important
La propriété sur laquelle jigdo s'appuie est que chaque fichier est stocké dans une section contiguë du
image; il n'est pas divisé en deux ou plusieurs parties.

Quand fichier jigdo reçoit un certain nombre de fichiers pouvant être contenus dans une image, il détecte
si l'un des fichiers est présent en utilisant une "somme de contrôle glissante" inspirée de celle utilisée
by rsync(1). Les données résultantes sont écrites dans le `.modèle' fichier : si une section du
l'image n'a pas pu être mise en correspondance (par exemple, il s'agissait d'informations sur le répertoire), les données sont compressées et
écrit directement sur le modèle. Cependant, si un fichier correspondant a été trouvé, ses données sont
omis du modèle. Au lieu de cela, seule une référence (une somme de contrôle MD5 du fichier) est
inséré dans le modèle.

Notez que les données du modèle ne contiennent que des données binaires, elles ne contiennent aucun nom de fichier
ou URI, car il ne peut pas être facilement modifié au cas où l'une de ces valeurs devrait être modifiée.
Toutes ces informations sont stockées dans le `.jigdo' fichier, un fichier texte auquel vous pouvez ajouter des URL
pour votre(vos) serveur(s). Le fichier jigdo fournit un mappage pour chaque somme de contrôle MD5 à un ou plusieurs
emplacements de téléchargement alternatifs pour la partie correspondante.

Outre le mappage des sommes MD5 aux URI, le fichier jigdo contient également un pointage URI
vers un emplacement de téléchargement pour le fichier modèle. De cette façon, le jigdo l'outil de téléchargement n'a besoin que
se voir attribuer un URI (celui du `.jigdo') pour pouvoir télécharger et réassembler le
image complète.

Format OF .JIGDO DES DOSSIERS

Le format global de `.jigdo' les fichiers suit celui de `.ini', comme également utilisé par le
Projets Gnome et KDE pour certaines données. Le fichier est organisé en sections, dont chacune
est précédé d'une ligne indiquant '[Sectionname]'. Dans chaque section, les lignes ont la forme
'Étiquette=Valeur'. Ces lignes sont également appelées « entrées » ci-dessous. Tout `.jigdo' les fichiers utilisent UTF-8 comme
leur codage de caractères.

Les commentaires sont introduits par le caractère `#' et s'étendent jusqu'à la fin de la ligne.
Les espaces sont ignorés au début et à la fin de la ligne ainsi qu'à gauche et à droite de la section
les noms et le `=' dans les entrées. De plus, les utilitaires jigdo divisent le texte du
valeur d'entrée (c'est-à-dire la partie après le `=') en mots séparés par des espaces, un peu comme le
Shell Unix. Les guillemets simples '' et doubles "" peuvent être utilisés pour empêcher que, par exemple, les URI
contenant des espaces sont séparés. De même, les caractères ayant une signification particulière (le
les caractères '"#\ et espace/tab) doivent être entre guillemets \ pour apparaître dans la valeur. Comme avec le
shell, il y a une différence entre ' ' et " " : à l'intérieur de ' ', les caractères "#\ et
les espaces perdent leur signification particulière et deviennent des caractères ordinaires, alors qu'à l'intérieur de " ",
seuls les caractères '# et les espaces perdent leur signification particulière - en d'autres termes,
les échappements de barre oblique inverse fonctionnent toujours à l'intérieur de " ", mais pas de " ".

`.jigdo' les fichiers peuvent éventuellement être compressés avec gzip (1). fichier jigdo sort toujours
fichiers non compressés, que vous pouvez compresser vous-même. jigdo-lite prend en charge simple
fichiers non compressés et compressés.

(Comportement susceptible de changer dans le futur et sur lequel il ne faut pas se fier : jigdo
prend également en charge n'importe quel nombre de parties en texte clair concaténées et gzippées dans les fichiers
- par exemple, vous pouvez compresser un `.jigdo' puis ajoutez quelques lignes de
données non compressées jusqu'à la fin.)

Dans tous les cas, le `.gz' doit être supprimée du nom de fichier - les outils
déterminer automatiquement à partir du contenu du fichier si un fichier est compressé ou non.

Vous trouverez ci-dessous une description des noms de section individuels utilisés par jigdo.

JIGDO SECTION
[Jigdo]
Version = 1.1
Générateur=jigdo-file/1.0.0

Informations sur la version du format de fichier jigdo utilisé et le programme qui
l'a généré. Il devrait y avoir une telle section par `.jigdo' déposer.

IMAGE SECTION
[Image]
Nom de fichier="nom de fichier en économie on utilisateur disque"
Modèle="URI De à rapporter modèle déposer"
Template-MD5Sum=OQ8riqT1BuyzsrT9964A7g
Informations courtes =une seule ligne la description of le image (200 caractères maximum)
Infos=Long la description (5000 caractères maximum)

La valeur de l'entrée 'Modèle' peut être soit une URL (absolue ou relative à l'URL
du fichier jigdo) ou une chaîne de la forme `Libellé:chemin d'accès«(NON MISE EN OEUVRE), comme décrit
ci-dessous.

L'entrée `Template-MD5Sum' est ajoutée par fichier jigdo et spécifie la somme de contrôle MD5 du
généré `.modèle' déposer. Il est utilisé par jigdo pour détecter les cas où le téléchargement
les données du modèle sont corrompues ou appartiennent à une image différente.

Contrairement aux autres valeurs d'entrée, les valeurs des entrées « ShortInfo » et « Info » sont ne sauraient scission
en mots, au lieu de cela, toutes les citations sont préservées.

La valeur de l'entrée 'Info' est spéciale en ce que jigdo(1) peut éventuellement analyser le balisage XML
il contient. Si le balisage contient des erreurs telles que des balises déséquilibrées/non prises en charge, la chaîne est
affiché littéralement, sans analyse XML. Les balises prises en charge sont (gras),
(italique), (police de machine à écrire), (souligner), (police plus grande),
(police plus petite) et (saut de ligne). Les entités prises en charge incluent <
(`<'), > (`>') et & (`&'). Notez que toute l'entrée 'Info' doit être sur une seule ligne dans
le fichier jigdo.

Cette section peut apparaître plusieurs fois, mais toutes, sauf la première, seront ignorées. Cette
est utile par exemple lors de la création d'un `.jigdo' pour une image DVD lorsque vous avez déjà
`.jigdo' pour les CD avec le même contenu : vous pouvez simplement « [Inclure] » (voir ci-dessous) le
Les fichiers jigdo des CD à la fin du fichier jigdo du DVD, après sa section `[Image]'.

PIÈCES SECTION
[Les pièces]
xJNkjrq8NYMraeGavUpllw=ÉtiquetteA:part0
GoTResP2EC6Lb_2wTsqOoQ=ÉtiquetteA:part1
kyfebwu6clbYqqWUdFIyaw=ÉtiquetteB:some/path/part2
-J9UAimo0Bqg9c0oOXI1mQ=http://some.where.com/part3

Toutes les lignes de la section, qui fournissent le mappage des sommes de contrôle MD5 aux URI, ont le
même format : sur le côté gauche du `=' la somme de contrôle (encodée avec un
encodage) est donné, et à droite une chaîne correspondant à la partie avec ce
somme de contrôle ; soit un URI complet, soit une chaîne de la forme `Libellé:chemin d'accès', lequel est
étendu en un ou plusieurs URI en recherchant la ou les définitions du Libellé dans l'
section `[Serveurs]'.

Dans le cas où une somme de contrôle MD5 particulière ne peut être trouvée dans aucune section « [Parts] » par jigdo,
programme effectuera une recherche de `MD5Sum :', par exemple pour
`MD5Sum:xJNkjrq8NYMraeGavUpllw' si vous avez supprimé la ligne pour `part0' ci-dessus.

Une somme de contrôle apparaissant plusieurs fois dans cette section indique un téléchargement alternatif
emplacements pour la pièce.

Il peut y avoir n'importe quel nombre de sections `[Parts]' dans le fichier ; ils sont tous pris en compte lorsque
recherche des sommes de contrôle MD5.

fichier jigdo place toujours la section `[Parts]' à la fin du fichier, et même
réorganise tout fichier spécifié avec --fusionner n'avoir qu'une seule de ces sections à la fin. Cette
est fait pour permettre jigdo pour afficher les informations de la section `[Image]' pendant que le
le reste de ce fichier est toujours en cours de téléchargement.

LES SERVEURS SECTION
[Les serveurs]
ÉtiquetteA=http://myserver.org/
ÉtiquetteA=ftp://mirror.myserver.org/
LabelB=LabelC:sous-répertoire/
ÉtiquetteC=http://some.where.com/jigdo/

Toutes les lignes de la section, qui fournit le mappage des étiquettes de serveur à serveur
emplacements, ont le même format : sur le côté gauche du `=' le nom de l'étiquette est donné, et
sur la droite, la valeur vers laquelle développer le nom de l'étiquette.

Un nom d'étiquette apparaissant plusieurs fois dans cette section indique un téléchargement alternatif
emplacements pour les pièces qui utilisent l'étiquette dans la section `[Parts]'. Cette notation fait
il est très facile d'ajouter des miroirs au fichier jigdo.

Comme le montre l'exemple ci-dessus, les valeurs d'étiquette peuvent elles-mêmes faire référence à d'autres étiquettes. Dans
dans ce cas, l'entrée `LabelB:some/path/part2' dans la section `[Parts]' s'étendra à
`http://some.where.com/jigdo/subdirectory/some/path/part2'. Boucles dans l'étiquette
les définitions entraînent un comportement indéfini et doivent être évitées.

Il peut y avoir n'importe quel nombre de sections `[Servers]' dans le fichier ; ils sont tous pris en compte lorsque
recherche d'étiquettes. L'un ou l'autre de `[Parts]' ou `[Servers]', mais pas les deux, peut être omis de
le fichier jigdo.

COMMENTAIRE SECTION
[Commentaire]
Tout texte, sauf que les lignes ne doivent pas commencer par `['.

Tout le texte suivant une ligne `[Commentaire]' ou `[commentaire]' est ignoré, jusqu'à la ligne suivante avec
une étiquette de section.

COMPRENDRE DIRECTIF
[Comprendre http://some.url/file.jigdo]

Les lignes de ce formulaire entraînent le téléchargement du contenu du fichier jigdo spécifié et
analysé comme le fichier jigdo principal. L'effet sera le même que la copie du inclus
le contenu du fichier dans le fichier qui contient la directive include. (Exception : tout
les URL relatives sont toujours résolues à l'aide de l'URL du `.jigdo' fichier qui contient que
URL relative.)

L'argument URL peut être une URL absolue ou relative. Les URL relatives sont supposées être
par rapport à l'URL du fichier jigdo qui contient la directive include. Comprend peut
être imbriqué, mais c'est une erreur de créer une boucle de directives d'inclusion. Il est ne sauraient possible
pour utiliser des URL de la forme `Libellé:chemin d'accès'.

L'URL ne peut pas être entre guillemets "". Tous les caractères `]' dans l'argument doivent être échappés comme
`%5D', et tous les espaces comme `%20'.

Les directives d'inclusion ne sont prises en charge que par jigdo, ils sont ignorés par jigdo-lite.

Une directive include termine toute section précédente, mais n'en démarre pas une nouvelle. Dans
en d'autres termes, une nouvelle section doit toujours être démarrée après la ligne d'inclusion, jigdo ne collecte
permettre aux entrées normales d'apparaître sous le `[Inclure]'.

CACHE DES DOSSIERS

Tout fichier spécifié avec le --cache L'option est utilisée pour stocker des informations sur le DES DOSSIERS
présenté à fichier jigdo. Lors de l'interrogation du cache, un fichier est considéré comme inchangé (et le
les données mises en cache sont utilisées) uniquement si le nom du fichier, la taille du fichier et l'heure de la dernière modification (mtime) correspondent
exactement. Pour la correspondance de nom de fichier, le nom de fichier entier n'est pas utilisé, mais seulement la partie
après tout `//', de sorte que toute modification apportée à la partie avant le `//' n'invalidera pas
la cachette.

Les anciennes entrées du cache sont supprimées du cache si elles n'ont pas été lues ou écrites dans
pour la durée spécifiée avec --cache-expiration. Les entrées sont ne sauraient immédiatement retiré
du cache si le fichier auquel ils font référence n'existe plus - cela permet de
cache les informations sur les fichiers sur les supports amovibles.

L'expiration du cache n'a lieu que après fichier jigdo a fait son travail principal - si d'anciennes entrées
sont consultés avant l'expiration, ils seront conservés. Par exemple, si le programme est
exécuter en utilisant le délai d'expiration par défaut de 30 jours, mais accède à un fichier cache avec des entrées
généré il y a 2 mois, puis entrées dans ce cache sera être pris en considération, et seuls ceux
les entrées de cache qui n'étaient pas nécessaires pendant l'exécution du programme seront expirées.

En raison d'une particularité de la bibliothèque de base de données sous-jacente (libdb3), les fichiers de cache ne
rétrécir, ils ne font que grandir. Si un grand nombre d'entrées a expiré dans votre fichier cache et
vous voulez qu'il rétrécisse, vous pouvez soit le supprimer (bien sûr, alors tout aura
à régénérer) ou utilisez les utilitaires accompagnant libdb3 pour vider et restaurer le
base de données, avec une commande comme `db3_dump ancien-cache.db | db3_load nouveau-cache.db'. Pour Debian,
ces programmes sont fournis dans le paquet `libdb3-util'.

Si un autre --md5-block-size est spécifié, le fichier entier doit être relu pour
mettre à jour son entrée de cache. Si un autre --Longueur minimale est spécifié, seul le premier
Les octets `md5-block-size' du fichier doivent être relus.

EXEMPLES

EN TRAIN DE PRÉPARER VOTRE CD IMAGE POUR DISTRIBUTION
Vous avez créé une image CD `image.iso' à partir de certains des fichiers stockés dans le répertoire
`/accueil/ftp' sur votre disque dur, qui est également disponible en ligne sous le nom `ftp://monsite.org'. Comme
vous ne voulez pas perdre de l'espace en hébergeant efficacement les mêmes données deux fois (une fois en tant que fichiers sur
le serveur FTP, une fois à l'intérieur de l'image), et vous en avez marre de l'abandon des téléchargements des utilisateurs
après 200 Mo et leur redémarrage du téléchargement des dizaines de fois, vous décidez d'utiliser jigdo.
Comment préparez-vous l'image pour le téléchargement ?

En fait, une seule commande est nécessaire :

fichier jigdo faire-modèle --image=image.iso --jigdo=/home/ftp/image.jigdo
--template=/home/ftp/image.template /accueil/ftp// --étiqueter Monsite=/accueil/ftp --uri
Monsite=ftp://monsite.org/

Les gens peuvent maintenant pointer jigdo à `ftp://monsite.org/image.jigdo' pour télécharger votre image. Les
le fichier modèle doit être accessible en tant que `ftp://monsite.org/image.template'.

Notez que rien ne vous empêche de faire de même pour un serveur FTP qui n'est pas
administré par vous - dans ce cas, il vous suffit d'héberger le `.jigdo' et '.modèle'
fichiers sur votre propre serveur/page d'accueil.

EN TRAIN DE PRÉPARER AN ARBITRAIRE LARGE DOSSIER POUR DISTRIBUTION
Nous supposons que vous avez un gros fichier qui n'est pas un système de fichiers, par exemple `film.mpeg'. Parce que
de problèmes d'espace, vous souhaitez répartir les données sur deux serveurs.

Dans ce cas, les parties de l'image doivent être générées artificiellement avec le scission
commander. Par exemple, pour créer des morceaux de 4 Mo chacun, utilisez `scission -b 4m film.mpeg partie'.
Copiez les fichiers résultants `partieXX' dans deux répertoires '1' et '2' que vous créez,
selon la façon dont vous souhaitez que les fichiers soient répartis entre les serveurs. Ensuite, créez le
fichiers jigdo et modèles avec `fichier jigdo faire-modèle --image=film.mpeg 1 // 2 //'. Tu
devra éditer le `.jigdo' et fournissez les bons URI pour les deux serveurs qui
vous allez télécharger le `partieXX' fichiers vers.

PERSONNALISÉ VERSIONS OF Démarche Qualité
Parce qu'il est possible d'attribuer un URI différent pour chaque partie d'une image si nécessaire,
jigdo est très flexible. Un seul exemple est la possibilité de versions personnalisées de
images : supposons que quelqu'un distribue une image de CD et que vous vouliez en faire quelques
de petits changements et redistribuez votre propre version. Vous téléchargez le `officiel.iso' CD
image avec jigdo (en lui passant l'URL de `officiel.jigdo'), écrivez-le sur CD-R, faites votre
changements (par exemple, l'ajout de fichiers à partir du `mes dossiers' sur votre disque dur) et produisez votre
propre version, `maversion.iso'. Ensuite, vous instruisez fichier jigdo pour créer le jigdo et
modèles de fichiers pour votre image modifiée, à l'aide de la commande

fichier jigdo faire-modèle --image=maversion.iso /mnt/cdrom/ mes dossiers// --étiqueter
Mes=mesfichiers/ --uri Mon=http://my.homepage.net/ --merge=officiel.jigdo
tandis que `officiel.iso' est monté sous '/mnt/cdrom'. En utilisant --fusionner, tu as dit jigdo-
filet prendre le contenu de `officiel.jigdo', ajoutez-y une nouvelle section '[Image]' pour
`maversion.iso' et écrivez le fichier jigdo résultant dans `maversion.jigdo' - alors maintenant
`maversion.jigdo' propose deux images à télécharger, la version originale et votre version modifiée
version. (Si vous ne voulez pas qu'il propose la version officielle, modifiez-le et supprimez le
Section `[Image]' qui répertorie `officiel.iso'.)

Maintenant, vous pouvez télécharger le `.jigdo' fichier, le `.modèle' ainsi que les fichiers dans `mes dossiers'
à `http://my.homepage.net/'. Ainsi, pour que les gens téléchargent votre image modifiée, vous
ne sauraient devez télécharger le contenu complet de l'image sur votre espace Web, mais seuls les changements que vous
fabriqué!

(Au cas où vous n'auriez fait que très peu de modifications, vous pouvez également omettre le paramètre `myfiles' dans
la commande ci-dessus, puis toutes vos modifications se retrouvent dans le nouveau fichier modèle.)

COMBINAISON BEAUCOUP GÉRÉ PAR JIGDO Démarche Qualité EN ONE
Ce n'est pas non plus un problème de combiner des données provenant de plusieurs sources qui utilisent jigdo. Par exemple, si
de cinq serveurs différents et indépendants, chacun distribue une image de CD différente via
jigdo, vous pouvez créer une image DVD personnalisée contenant les données de tous ces CD.
Quand les gens utilisent jigdo pour télécharger votre image, les fichiers individuels sur le DVD sont récupérés
provenant des mêmes sources que les CD originaux.

Par conséquent, même si vous allez diffuser un fichier de 3.2 Go via votre espace web, le
la quantité réelle de données stockées sur votre serveur ne sera que de l'ordre de plusieurs
MB.

Utilisez jigdo-file en ligne en utilisant les services onworks.net