jigdo-file - Online nel cloud

PROGRAMMA:

NOME

jigdo-file - Prepara i file per il download di Jigsaw (distribuzione di file di grandi dimensioni, ad es. CD
immagini).

SINOSSI

file jigdo COMANDO
[ --immagine=cdrom.iso ] [ --jigdo=cdrom.jigdo ] [ --template =modello.cdrom ] [ --vigore ] [
ALTRO VERSIONI ] [ FILE ... | --file-da=f ]
Uncommon COMANDI: modello di creazione, fare immagine, verificare

DESCRIZIONE

Jigsaw Download, o breve jigdo, è uno schema sviluppato principalmente per renderlo facile da
distribuire enormi immagini di filesystem (ad es. immagini di CD (ISO9660) o DVD (UDF)) su
Internet, ma potrebbe essere utilizzato anche per altri dati difficili da gestire a causa della sua
dimensioni, come file audio/video o pacchetti software di grandi dimensioni.

jigdo cerca di assicurarsi che il file di grandi dimensioni (chiamato sempre Immagine d'ora in poi) viene scaricato
in piccole parti che possono essere archiviate su server diversi. Le persone che vogliono scaricare il
image fallo dicendo al jigdo(1) (NON IMPLEMENTATO ANCORA) scarica lo strumento per elaborarne uno
`.jigdo' file; usandolo, jigdo scarica le parti e riassembla l'immagine. file jigdo
viene utilizzato per preparare i file per il download.

Ciò che rende speciale jigdo è che le parti che vengono utilizzate per ricostruire l'immagine possono avere
qualsiasi dimensione e contenuto: devono essere contenuti solo in una regione contigua ovunque in
l'immagine.

Ad esempio, se desideri distribuire un'immagine ISO9660 che contiene un'istantanea di un
Server FTP, puoi istruire file jigdo preparare i dati di download in modo tale che
quando le persone usano jigdo per scaricare l'immagine, jigdo recupera effettivamente i singoli file
dal server FTP e li assembla in una copia esatta della tua immagine - durante il
Scarica! (Se l'immagine non è un dump del filesystem, puoi usare dividere(1) per creare il piccolo
parti da cui verrà riassemblata l'immagine.)

Sei completamente libero di scegliere dove memorizzare le singole parti dell'immagine: Loro
possono trovarsi in directory completamente diverse su server diversi (ad esempio a causa di
vincoli di spazio di archiviazione/larghezza di banda), ma questo è invisibile alle persone che scaricano il tuo
Immagine. Le informazioni sui server disponibili devono essere aggiunte solo al `.jigdo' file
da te prima di distribuirlo.

La sezione `DETTAGLI' di seguito contiene dettagli tecnici su come funziona jigdo. Gli 'ESEMPI'
la sezione elenca una serie di scenari comuni e può aiutarti a farti un'idea di cosa jigdo
è utile per.

VERSIONI

Molte opzioni sono specifiche per un particolare COMANDO; quelli sotto sono generali o usati da
diversi comandi. Ulteriori opzioni sono elencate di seguito con i singoli comandi. Tutto
le opzioni vengono ignorate silenziosamente se non sono applicabili al comando corrente. Per ogni
BYTE parametri alle opzioni, puoi aggiungere una delle lettere `k', `M' o `G' al
importo specificato, per indicare kilobyte, megabyte o gigabyte.

-h --Aiuto
Produci un breve riepilogo di comandi e opzioni.

-H --aiuto-tutti
Riepilogo completo dei comandi e delle opzioni.

-v --versione
Versione del programma di output.

-i --immagine=cdrom.iso
Specificare la posizione del file contenente l'immagine. L'immagine è il file di grandi dimensioni che
vuoi distribuire.

-j --jigdo=cdrom.jigdo
Specificare la posizione del file di descrizione del download del puzzle. Il file jigdo è a
file leggibile generato da file jigdo, a cui si aggiungono informazioni su tutto
i server su cui caricare i file. jigdo scaricherà questo file come
il primo passo per recuperare l'immagine.

-t --template =modello.cdrom
Specificare la posizione del file "modello" dell'immagine. Il file modello è un file binario
generato da file jigdo, contiene informazioni su come rimontare l'immagine e
anche (in forma compressa) tutti i dati dell'immagine che non sono stati trovati in nessuno dei
le parti.

A seconda del comando, ciascuno di questi tre file viene utilizzato a volte per l'input,
a volte per l'uscita. Se il file deve essere utilizzato per l'output per un particolare comando
e il file di output esiste già, file jigdo esce con un errore, a meno che --vigore
è presente.

Nella maggior parte dei casi, sarà sufficiente specificarne uno su -i -j -t, perché qualsiasi
i nomi dei file mancanti verranno dedotti da quello specificato. Questo viene fatto per primo
rimuovendo qualsiasi estensione dal nome fornito e quindi non aggiungendo nulla (se
dedurre --Immagine), ".jigdo' o `.modello'.

-r --report=default|noprogress|quiet|grep
Controlla quanto è dettagliato il programma e quale formato ha l'output: nessun progresso is
lo stesso di difetto tranne per il fatto che non vengono stampati messaggi di avanzamento "x% done". silenzioso
limita l'output a ciò che è assolutamente necessario, principalmente messaggi di errore. grep
è solo diverso da difetto per l' fai-modello comando: abilita l'output in
un semplice ` ' formato utile durante la ricerca di file binari
in altri file binari.

-f --vigore
Sovrascrivi i file di output esistenti senza lamentarti.

--no-forza
La sezione is , il predefinito. Rifiuta di sovrascrivere i file di output esistenti.

-c --cache=jigdo-cache.db
file jigdo di solito ha bisogno di leggere l'intero contenuto di tutte le FILE si specifica.
Se lo usi ripetutamente (ad esempio perché rendi disponibile una nuova immagine del CD ogni giorno),
la memorizzazione nella cache delle informazioni sul file aumenterà significativamente la velocità del programma. Il
cache viene creato automaticamente se non è ancora presente. I dati di solito sono entrambi
letto e scritto su di esso.

--nessuna cache
La sezione is , il predefinito. Non utilizzare una cache.

--cache-scadenza=SECONDI
Imposta l'età massima delle voci della cache. Tutte le voci più vecchie di questa verranno rimosse da
la cache. L'impostazione predefinita è 30 giorni. Puoi aggiungere una delle lettere "h", "d", "w",
"m", "y" per indicare rispettivamente ore, giorni, settimane, mesi o anni. Un valore di
"0" o "off" disabilita la scadenza, in modo che tutte le voci rimarranno nella cache per sempre.
Per ulteriori informazioni, vedere la sezione `FILE CACHE' di seguito.

--readbuffer=BYTE
Imposta la dimensione dei buffer interni. Il valore predefinito è 128k - se hai un disco veloce,
aumentare questo valore può rendere file jigdo più veloce, ma in generale, cambiarlo è
non necessario.

--md5-dimensione-blocco=BYTE
Non interessante interno parametro. Imposta la dimensione dei blocchi in cui si trovano i file
suddiviso. Il valore predefinito è 128k. Se lo cambi, qualsiasi file di cache dovrà essere
rigenerato. Internamente, file jigdo può scegliere di utilizzare un leggermente più grande o più piccolo
valore.

-T --file-da=filetto
Legge i nomi di file e directory dal file specificato. Se filetto è `-', leggi i nomi
dall'ingresso standard. Ogni riga del file viene presa come un nome, quindi i nomi possono
contengono spazi, ma non caratteri di nuova riga. Una riga vuota causa file jigdo smettere
lettura dal file.

Find(1) è uno strumento potente per generare elenchi di file, ma assicurati di usare `Find
-Type f'se possibile - altrimenti, se istruisci Find per produrre sia un nome di file
e un collegamento simbolico a quel nome di file, file jigdo leggerà il contenuto del file due volte.

--esadecimale Emetti i checksum in formato esadecimale anziché in formato simile a Base64. Questo non dovrebbe essere
utilizzato con il fai-modello comando, perché il ` . risultante.jigdo'file viola
il `.jigdo' formato del file. La sua destinazione d'uso è quella di fare file jigdo più interoperabile
con altre utilità della shell Unix come md5sum(1).

--no-esadecimale
La sezione is , il predefinito. Usa la codifica dei checksum simile a Base64 di jigdo.

--debug[=aiuto|=tutto|=UNITÀ,~UNITÀ... ]
Attiva o disattiva l'uscita di debug. Solo `--debug' è equivalente a `--debug=all'.
L'argomento è un elenco separato da virgole di nomi di unità per i quali l'output di debug è
da abilitare o disabilitare se il nome è preceduto da `~'. Il nome speciale "tutti"
significa tutte le unità. Per impostazione predefinita, l'uscita di debug è disattivata ad eccezione delle unità
"asserto" e "generale". L'elenco esatto delle unità disponibili per le quali è possibile eseguire il debug
essere attivato dipende dal fatto che jigdo sia stato compilato con il supporto per il debug - il
lista può essere stampata con `--debug=help'.

FILE Nomi di file o directory da utilizzare come input. Queste sono le parti che sono
contenuto nell'immagine. Nel caso in cui uno dei nomi sia una directory, il programma
scansiona ricorsivamente la directory e aggiunge tutti i file in essa contenuti. mentre lo fai
questo, segue i collegamenti simbolici, ma evita i cicli dei collegamenti simbolici.

Se uno dei nomi di file inizia con il carattere `-', devi precedere l'elenco di
file con `--'. Un valore di `-' ha no significato speciale in questa lista, sta per
un file il cui nome è un singolo trattino.

COMANDI

Il nome del comando è il primo argomento non opzione passato a file jigdo. La maggior parte dei comandi ha
abbreviazioni brevi e nomi lunghi. I corto command nomi dovrebbero non be utilizzato in
script - ci può be incompatibile i cambiamenti a loro in , il futuro!

FARE-TEMPLATE, MT
Legge Immagine ed FILE, crea `.jigdo' e `.modello'. Questa è la funzionalità principale di
file jigdo.

È possibile specificare entrambi --immagine=- ed --file-da=-. In questo caso, prima la lista
di file viene letto dallo standard input fino a quando non viene incontrata una riga vuota. Tutto quanto
di seguito si presume che siano i dati dell'immagine. Questo può essere utile se usi mkisofs(1) o
programmi simili che possono produrre l'immagine completa sul loro output standard, perché
non è necessario memorizzare temporaneamente l'immagine su disco.

Se un FILE l'argomento contiene i caratteri `//' (Unix) o `\.\' (Windows), questo ha
significato speciale. Nel file jigdo finale che gli utenti scaricheranno, ciascuna delle parti è
a cui si fa riferimento nella sezione "[Parts]" con un URI nella forma "Label:some/filename". (Vedere
`FORMATO DEI FILE .JIGDO' di seguito per una descrizione dettagliata.) La sezione `[Server]' fornisce
una mappatura delle etichette ai server su Internet, con linee come
`Etichetta=http://myserver.org/jigdofiles/'. Utilizzando queste informazioni, jigdo creerà il
URI di download finale per la parte, `http://myserver.org/jigdofiles/some/filename'.
Specificare `//' (o `\.\') in un nome di file o directory serve a `tagliare' i nomi in
il livello di directory corretto. Ad esempio, se il percorso Unix di uno dei tuoi FILE is
"/percorso/qualche/nomefile", puoi dirlo file jigdo tagliare dopo il `/percorso' passandolo
l'argomento `/path//some/filename', o `/path//' se si desidera scansionare l'intera directory.
I nomi dei percorsi non devono essere assoluti; È possibile anche `somedirectory//'.

--etichetta Etichetta=/percorso
Specificare un nome da utilizzare come nome dell'etichetta per un percorso su disco. (Influenza l'uscita
jigdo.) Se hai usato `//' nel FILE argomentazioni come sopra descritte, file jigdo
per impostazione predefinita, sceglierà automaticamente i nomi delle etichette ("A", "B" ecc.). Con questa opzione,
puoi dare alle etichette nomi più significativi. Nota che il nome dell'etichetta sarà solo
usato se uno o più FILE iniziare con `/percorso//'.

Prova a usare nomi di etichette che iniziano con caratteri maiuscoli, per disambiguarli
chiaramente da nomi di protocollo come `http', `ftp'.

--uri Etichetta=http://some.server.org/
Per impostazione predefinita, utilizzando --etichetta come descritto sopra causerà righe della forma
`Label=file:/path/' da scrivere nella sezione `[Servers]' del jigdo di output
file. Se vuoi sovrascrivere l'URI `file:' in modo che la riga legga
`Etichetta=http://some.server.org/', puoi farlo specificando --uri con
--etichetta. Dare solo --uri Etichetta=... senza il corrispondente --etichetta Etichetta=...
non ha alcun effetto, e anche se si specificano entrambi, una voce viene aggiunta solo a
sezione "[Server]" se l'etichetta è referenziata da almeno una voce "[Parti]".

Il valore fornito non è quotato dal programma; se contiene caratteri come
spazio o uno qualsiasi dei caratteri #"'\ quindi devi citarlo. (Sotto Unix, puoi
è necessario citare il valore due volte per proteggerlo anche dalla shell, ad esempio \\\\ o '\\'
per ottenere una singola barra rovesciata nell'URI.)

La mappatura specificata con an --uri l'opzione viene ignorata se è già presente in
il file jigdo di output.

Gli utenti della versione Windows potrebbero notare che i separatori di directory `\' sono
convertito in `/' negli URI `file:' generati per impostazione predefinita. Questo è fatto
per aumentare la compatibilità multipiattaforma di `file:' - the stampa mancante comando di
la versione per Windows riconvertirà automaticamente i caratteri quando stampa il
URI. Nel caso in cui fornisci i tuoi URI `file:' in Windows usando --uri, devi
scambiare anche `/' e `\'.

-0 a -9
Imposta la quantità di compressione nel file modello di output, da -0 (nessuna compressione) a
-9 (compressione massima). L'impostazione predefinita è -9, che può rendere la generazione del modello
piuttosto lento. Per impostazione predefinita, l'algoritmo di compressione utilizzato è lo stesso di gzip(1).

--gzip ed --bzip2
Scegli tra gli algoritmi di compressione gzip e bzip2. L'impostazione predefinita è gzip.
Bzip2 di solito offre un rapporto di compressione migliore, ma la compressione è significativamente
più lento rispetto a gzip.

--min-lunghezza=BYTE
Imposta la lunghezza minima di una parte per file jigdo per cercarlo nell'immagine. Il
l'impostazione predefinita è 1k. Le parti più piccole di questa non verranno mai trovate nell'immagine, quindi la loro
i dati verranno inclusi nel file modello. L'algoritmo di ricerca utilizzato richiede tale
una lunghezza minima, altrimenti la generazione del modello potrebbe diventare estremamente lenta. Se tu
sai per certo che tutto tuo FILE sono maggiori di una certa quantità, puoi
aumentare file jigdoleggermente la velocità specificando la quantità con questa opzione.
C'è un minimo assoluto cablato di 256 byte - qualsiasi cosa inferiore lo farà silenziosamente
essere impostato su 256.

--unire=RISORSE
Includi il contenuto di RISORSE nell'output `.jigdo' file. Il file può contenere dati
che vuoi aggiungere all'output (ad esempio, una sezione "[Server]" con un elenco
dei tuoi server come voci), oppure può essere il file jigdo emesso da un'esecuzione precedente
of file jigdo.

È possibile specificare lo stesso file per l'input con --unisci e per l'uscita con
--jigdo. Tuttavia, dovrai anche usare --vigore per far sovrascrivere il programma
la vecchia versione del file jigdo con quella nuova. RISORSE può essere `-' per standard
ingresso.

Quando l'aggiunta di nuove informazioni al file fornito, file jigdo non inserirà nuovo
righe nella sezione "[Parts]" se una voce per lo stesso checksum MD5 (ma non)
necessariamente con lo stesso URI!) esiste già e non inserirà nuove righe
nella sezione "[Server]" se esiste già una voce completamente identica.

Quando lettura in l'esistente RISORSE, il comportamento è leggermente diverso: il programma
conserve voci nella sezione "[Parti]" con checksum identico, ma diverso
URI. Per voci completamente identiche (stesso checksum e URI), solo una voce è
conservati e i duplicati vengono rimossi. La sezione "[Server]" è a sinistra
intatto.

--sezione-immagine
La sezione is , il predefinito. Cause file jigdo per aggiungere una sezione "[Immagine]" alla sezione ".jigdo'
file.

Come eccezione, una nuova sezione "[Immagine]" è non aggiunto se si utilizza --unisci e la
file da unire contiene una sezione "[Immagine]" con una riga che dice "Modello-
MD5Sum=' (fine della riga dopo il `='). In questo caso, i dati del modello generato
Il valore di checksum MD5 viene appena aggiunto dopo il `=' della prima riga di questo modulo in
il file - non viene aggiunta alcuna nuova sezione "[Immagine]". Questo comportamento è utile
perché ti permette di passare via --unisci una sezione "[Immagine]" con arbitrario
contenuto e quindi aggiungere automaticamente il checksum MD5 da file jigdo.
la sezione `FORMATO DEI FILE .JIGDO' di seguito spiega il contenuto della sezione `[Immagine]' in
maggiore dettaglio.

--sezione-nessuna immagine
Do non includi una sezione "[Immagine]" nella sezione ".jigdo' file. Devi aggiungerne uno
se usi questa opzione. Tuttavia, farlo non è facile (è necessario anche
aggiungi una riga `Template-MD5Sum' con il checksum corretto, oppure jigdo si lamenterà), quindi
l'uso di questa opzione è scoraggiato.

--sezione-server
La sezione is , il predefinito. Cause file jigdo per aggiungere una sezione `[Server]' alla sezione `.jigdo'
file. Questa sezione predefinita usa gli URI `file:', che consente un riassemblaggio immediato
dell'immagine dal filesystem locale, ed è utile anche se si desidera modificare il
file manualmente e sostituire gli URI `file:' con altri URI.

--no-sezione-server
Do non aggiungi una sezione "[Server]" alla fine di ".jigdo' file. Utile ad es. se
stai per aggiungere la sezione con uno script.

--match-exec=COMANDO SHELL
Ogni volta che viene trovato un file nell'immagine, eseguire la stringa di comando fornita con
passandolo a una conchiglia. file jigdo imposta una serie di variabili d'ambiente con
informazioni sulla corrispondenza del file. Ad esempio, se il file `/percorso//a/b/file' era
trovato nell'immagine e `Label:a/b/file' verrà scritto in `.jigdo'
file:

· ETICHETTA="Etichetta" - Nome dell'etichetta per il file. L'esempio presuppone che `--etichetta
Label=/path' è stato specificato da te. In assenza di tale opzione, ETICHETTA volere
essere impostato ma vuoto.

· PERCORSO ETICHETTA="/path/" - Il percorso corrispondente all'etichetta, o in altre parole, il
prefisso del percorso del file corrispondente che sarà non appaiono nell'output `.jigdo'
file. È impostato anche senza `--etichetta' opzione presente. Termina con una barra.

· PERCORSO PARTITA="a/b/" - Il resto del percorso, senza il nome foglia del corrispondente
file. È vuoto o termina con una barra.

· LEAF="file" - Il nome foglia del file corrispondente.

· MD5SOMMA="lNVdUSqbo2yqm33webrhnw" - Il md5sum del file corrispondente, in stile Base64
formato.

· RISORSE="/path//a/b/file" - Per comodità, il percorso completo del file. Il
la variabile è sempre impostata su $LABELPATH$MATCHPATH$LEAF.

Si prega di fare attenzione a citare correttamente la stringa passata a questa opzione, altrimenti il ​​tuo
Il comando fornito non funzionerà con i nomi di file che contengono spazi. Ad esempio, a
creare un backup dei collegamenti reali ai file corrispondenti, utilizzare la seguente opzione: --match-
exec='mkdir -p "${LABEL:-.}/$MATCHPATH" && ln -f "$FILE" "${LABEL:-.}/$MATCHPATH$FOGLIA"'

Per impostazione predefinita, non viene eseguito alcun comando. Usa --match-exec="" per rimuovere una stringa di comando che
è stato impostato con un precedente utilizzo di questa opzione.

--abbinamento goloso
La sezione is , il predefinito. Immagina che la tua immagine contenga un .catrame file che a sua volta
contiene un altro file x, e che fornisci entrambi i .catrame e i file al suo interno
sulla riga di comando. quando file jigdo scansiona l'immagine, incontra l'inizio
della .catrame file, e poi il file x.

A questo punto bisogna prendere una decisione: se il file più piccolo x essere registrato come
abbinato, o dovrebbe essere ignorato a favore della corrispondenza più grande (e quindi migliore) di
, il .catrame file? Purtroppo a questo punto non è chiaro se ci sarà
in realtà essere una partita completa del .catrame, quindi per impostazione predefinita, il programma preferisce il piccolo
incontro.

--nessuna corrispondenza avida
Nel caso in cui sia presente una corrispondenza parziale ampia ed è stata eseguita una corrispondenza più breve
confermato, ignorare il fiammifero. (Vedi l'opzione sopra.)

FARE-IMMAGINE, MI
Legge `.modello' e FILE, crea Immagine (o `nomeimmagine.tmp'). Fornisce un rudimentale
modo di ricomporre le immagini - jigdo di solito è più adatto a questo compito. Tuttavia, in
contrasto con jigdo, non `.jigdo' è richiesto il file.

Se l'immagine deve essere scritta su un file (e non sullo standard output), è possibile
creare l'immagine in più passaggi, con diverse invocazioni di `file jigdo fare-immagine', come
segue: Prima invochi file jigdo, specificando tanti file quanti sono disponibili qui
tempo. Il programma esegue la scansione dei file e quelli contenuti nell'immagine vengono copiati in
un file temporaneo, il cui nome è formato aggiungendo `tMP' al nome del file immagine.

Per tutti gli altri file che potrebbero essere parti dell'immagine, ripeti questo processo. Non appena
poiché tutte le parti sono presenti, il file temporaneo verrà leggermente troncato (per eliminarne alcune
dati amministrativi che file jigdo aggiunge alla fine) e rinominato nell'immagine finale
nome. La possibilità di ricomporre l'immagine in più passaggi è particolarmente utile per
raccolta di file da supporti rimovibili, ad esempio diversi CD più vecchi.

Script che utilizzano fare-immagine può rilevare se la creazione dell'immagine è completa controllando il
stato di uscita: 0 segnala la creazione con successo, mentre 1 significa che devono essere creati più file
fornito. Altri errori determinano uno stato di uscita pari a 2 ("recuperabile", ad es. file non trovato)
o 3 (non recuperabile, ad es. errore di scrittura).

--controlla i file
La sezione is , il predefinito. Ogni volta che una parte viene copiata nell'immagine, ricontrollarla
checksum rispetto al checksum memorizzato nel modello. Si consiglia di
lascialo acceso, anche se rallenta un po' la creazione dell'immagine.

--no-check-file
Non controllare i checksum dei file durante la copia nell'immagine. Questo può essere sicuro
utilizzato quando non viene utilizzato alcun file di cache (il che significa che i file verranno scritti nel
l'immagine subito dopo essere stata scansionata) o l'intera immagine viene controllata in seguito con il
verificare comando.

STAMPA MANCANTE, PM
Legge `.jigdo', `.modello' e (se presente) `nomeimmagine.tmp', emette ancora un elenco di URI
necessario per rimontare completamente l'immagine.

Insieme al fare-immagine comando, questo fornisce la maggior parte delle funzionalità di jigdo on
la riga di comando.

Per ogni parte che non è ancora presente nel file immagine temporaneo, il checksum del file è
cercato nella sezione "[Parts]" del file jigdo. Qualsiasi etichetta nella voce corrispondente
viene quindi espanso secondo le definizioni dell'etichetta nella sezione "[Server]" e stampato
sull'uscita standard. jigdo consente di specificare diverse posizioni alternative per ciascuna
etichetta in questa sezione, ma stampa mancante produrrà solo il primo per ogni mancante
parte.

Se non è possibile trovare il checksum nella sezione "[Parti]" (questo non dovrebbe accadere a meno che
hai cancellato quella sezione), viene invece effettuata una ricerca per `MD5Sum:', proprio come
con jigdo. (Quindi, se vuoi eliminare la sezione "[Parti]", puoi farlo se
rinominare ogni parte con il proprio checksum.)

--uri Etichetta=http://some.server.org/
Sostituisci le voci in `.jigdo' per qualsiasi etichetta con un URI di tua scelta.
Con l'esempio sopra, una voce "[Parts]" di "Label:some/filename" causerà il
riga `http://some.server.org/some/filename' da stampare.

Il valore fornito non è quotato dal programma; se contiene caratteri come
spazio o uno qualsiasi dei caratteri #"'\ quindi devi citarlo. (Sotto Unix, puoi
è necessario citare il valore due volte per proteggerlo anche dalla shell, ad esempio \\\\ o '\\'
per ottenere una singola barra rovesciata nell'URI.)

STAMPA-MANCANTE-TUTTO, PMA
Proprio come stampa mancante, questo comando emette un elenco di URI ancora necessari per completare completamente
ricomporre l'immagine. Però, contro tutti i vengono stampate posizioni di download alternative invece di
solo uno. Nell'output, gli URI di un file sono separati dagli URI di altri file con
righe vuote. Il --uri opzione ha lo stesso effetto di per stampa mancante.

VERIFICARE, VER
Legge Immagine (presumibilmente generato con fare-immagine) e `.modello', verifica che sia corretto
checksum dell'immagine.

I dati del modello non contengono solo i checksum delle singole parti, ma anche dei
immagine nel suo insieme. fare-immagine esegue già una serie di controlli interni, ma se tu
come, puoi anche controllare l'immagine con questo comando.

SCANSIONE, SC
Legge tutti i FILE e li inserisce nella cache, a meno che non siano già memorizzati nella cache. Il
--cache l'opzione deve essere presente per questo comando.

--no-scansionare-l'intero file
La sezione is , il predefinito. Questo causa solo il primo --md5-dimensione del blocco byte di ogni file
essere letto. Se la cache viene utilizzata in seguito da file jigdo fare-immagine, il resto di
il file verrà letto una volta che questi primi byte saranno riconosciuti nell'immagine di input.

--scansione-intero-file
Leggi immediatamente l'intero contenuto del file e salvalo nella cache.

MD5SOMMA, MD5
Legge tutti i FILE e stampa i checksum MD5 del loro contenuto. Questo comando è abbastanza
simile a md5sum(1), tranne che il checksum viene emesso nella codifica simile a Base64 che
è usato anche altrove da file jigdo.

I FILE gli argomenti vengono elaborati allo stesso modo degli altri comandi, il che significa
che la ricorsione avviene automaticamente per tutti gli argomenti che sono directory e che
i collegamenti simbolici non sono elencati tranne quando i file a cui puntano non sono raggiungibili
direttamente.

Nella lista di controllo stampata sullo standard output, solo la parte del nome del file che segue
viene stampato qualsiasi `//' (o `\.\' su Windows). Qualunque --cache sarà usato per interrogare i file'
Checksum MD5 e/o scrittura dei checksum dei file scansionati.

ELENCO-MODELLO, LS
Legge un `.modello' file ed emette informazioni di basso livello sull'immagine e su tutte le parti
contenuto in esso, inclusi offset, lunghezza e checksum.

Puoi anche usare questo comando con file immagine temporanei (specificando qualcosa come
--template=nomeimmagine.tmp) - in tal caso, l'output distingue anche tra parti che
sono stati scritti nell'immagine e nelle parti che non lo sono.

L'esatto formato di output può cambiare in modo incompatibile tra le diverse versioni di jigdo. Il
possono essere emessi i seguenti diversi tipi di linee. "have-file" si verifica solo per "tMP'
file, indicando un file che è già stato scritto con successo nel file temporaneo:

nel modello offset nell'immagine lunghezza
bisogno-file offset nell'immagine lunghezza file-md5sum filestart-rsyncsum
avere-file offset nell'immagine lunghezza file-md5sum filestart-rsyncsum
info-immagine lunghezza dell'immagine immagine-md5sum rsyncsum-dimensione

DETTAGLI

Jigsaw Download è stato creato pensando al formato delle immagini CD ISO9660, tuttavia,
quanto segue si applica anche a molti altri formati di filesystem, nonché agli archivi `tar' e
archivi "zip" non compressi. L'immagine di un CD contiene sia le informazioni per organizzare il
filesystem (intestazione con nome del disco ecc., dati della directory ISO9660, dati di estensioni come
Joliet o RockRidge, zero padding) e i file contenuti nel CD. Un importante
proprietà su cui si basa jigdo è che ogni file è memorizzato in una sezione contigua di
Immagine; non è diviso in due o più parti.

Quando file jigdo viene fornito un numero di file che potrebbero essere contenuti in un'immagine, rileva
se uno qualsiasi dei file è presente utilizzando un "checksum mobile" ispirato a quello utilizzato
by rsync(1). I dati risultanti vengono scritti nel `.modello' file: se una sezione del
non è stato possibile far corrispondere l'immagine (ad es. si trattava di informazioni sulla directory), i dati sono compressi e
scritto direttamente sul modello. Tuttavia, se è stato trovato un file corrispondente, i suoi dati sono
omesso dal modello. Invece, solo un riferimento (un checksum MD5 del file) è
inserito nel modello.

Nota che i dati del modello contengono solo dati binari, non contengono nomi di file
o URI, poiché non può essere facilmente modificato nel caso in cui uno di questi valori debba essere modificato.
Tutte queste informazioni sono memorizzate nel `.jigdo', un file di testo a cui puoi aggiungere URL
per i tuoi server. Il file jigdo fornisce una mappatura per ogni checksum MD5 su uno o più
percorsi di download alternativi per la parte corrispondente.

Oltre alla mappatura delle somme MD5 sugli URI, il file jigdo contiene anche un URI che punta
in una posizione di download per il file modello. In questo modo, il jigdo lo strumento di download ha bisogno solo di
da assegnare un URI (quello del `.jigdo') per poter scaricare e rimontare il
immagine completa.

FORMATO OF .JIGDO FILE

Il formato generale di `.jigdo' segue quello di `. Iniziale', come utilizzato anche da
Progetti Gnome e KDE per alcuni dati. Il file è organizzato in sezioni, ognuna delle quali
è preceduto da una riga che dice "[Nome sezione]". All'interno di ogni sezione, le linee hanno la forma
`Etichetta=Valore'. Tali righe sono anche chiamate "voci" di seguito. Tutto `.jigdo' i file usano UTF-8 come
la loro codifica dei caratteri.

I commenti vengono introdotti con il carattere "#" e si estendono fino alla fine della riga.
Gli spazi bianchi vengono ignorati all'inizio e alla fine della riga, nonché a sinistra e a destra della sezione
nomi e il `=' nelle voci. Inoltre, le utility jigdo suddividono il testo del
valore di ingresso (cioè la parte dopo `=') in parole separate da spazi, proprio come il
shell Unix. È possibile utilizzare le virgolette singole '' e doppie "" per evitare che, ad esempio, gli URI
contenenti spazi bianchi sono divisi. Allo stesso modo, i caratteri con un significato speciale (il
caratteri '"#\ e spazio/tab) devono essere citati con \ per apparire nel valore. Come con
shell, c'è una differenza tra ' ' e " ": All'interno di ' ', i caratteri "#\ e
gli spazi bianchi perdono il loro significato speciale e diventano caratteri ordinari, mentre all'interno di " ",
solo i caratteri '# e gli spazi bianchi perdono il loro significato speciale - in altre parole,
Gli escape backslash funzionano ancora all'interno di " ", ma non di ' '.

`.jigdo' i file possono essere opzionalmente compressi con gzip(1). file jigdo sempre uscite
file non compressi, che puoi comprimere da solo. jigdo-lite supporta il singolo
file non compressi e compressi.

(Comportamento che potrebbe cambiare in futuro e su cui non si dovrebbe fare affidamento: jigdo
supporta inoltre qualsiasi numero di testo normale concatenato e parti gzip nei file
- per esempio, puoi comprimere un `.jigdo' e poi aggiungi un paio di righe di
dati non compressi fino alla fine.)

In tutti i casi, il `.gz' dovrebbe essere rimossa dal nome del file - gli strumenti lo faranno
determinare automaticamente dal contenuto del file se un file è compresso o meno.

Di seguito è riportata una descrizione dei nomi delle singole sezioni utilizzati da jigdo.

JIGDO SEZIONE
[Gioco]
Version = 1.1
Generator=file-jigdo/1.0.0

Informazioni sulla versione del formato di file jigdo utilizzato e sul programma che
lo ha generato. Dovrebbe esserci una di queste sezioni per `.jigdo' file.

IMMAGINE SEZIONE
[Immagine]
Nome file="nome del file per risparmio on degli utenti disco"
Modello="URI where a andare a prendere modello file"
Template-MD5Sum=OQ8riqT1BuyzsrT9964A7g
Informazioni brevi=linea singola descrizione of , il Immagine (200 caratteri massimo)
Informazioni=lungo descrizione (5000 caratteri massimo)

Il valore per la voce "Modello" puòessere un URL (assoluto o relativo all'URL
del file jigdo) o una stringa della forma `Discografica:pathname'(NON IMPLEMENTATO), come descritto
qua sotto.

La voce "Template-MD5Sum" è stata aggiunta da file jigdo e specifica il checksum MD5 del
generato `.modello' file. È usato da jigdo per rilevare i casi in cui il download
i dati del modello sono danneggiati o appartengono a un'immagine diversa.

A differenza di altri valori di ingresso, i valori delle voci "ShortInfo" e "Info" sono non dividere
fino a parole, invece tutte le citazioni sono conservate.

Il valore della voce "Info" è speciale in questo jigdo(1) può facoltativamente analizzare il markup XML
contiene. Se il markup contiene errori come tag non bilanciati/non supportati, la stringa è
visualizzato letteralmente, senza analisi XML. I tag supportati sono (grassetto),
(corsivo), (carattere macchina da scrivere), (sottolineare), (carattere più grande),
(carattere più piccolo) e (interruzione di linea). Le entità supportate includono <
(`<'), > (`>') e & (`&'). Nota che l'intera voce "Info" deve essere su una riga in
il file jigdo.

Questa sezione può essere ripetuta più volte, ma tutte tranne la prima verranno ignorate. Questo
è utile ad esempio quando si crea un `.jigdo' per un'immagine DVD quando lo hai già
`.jigdo' per CD con lo stesso contenuto: puoi semplicemente `[Includi]' (vedi sotto) il
I file jigdo dei CD alla fine del file jigdo del DVD, dopo la sezione "[Immagine]".

PARTI SEZIONE
[Parti]
xJNkjrq8NYMraeGavUpllw=EtichettaA:parte0
GoTResP2EC6Lb_2wTsqOoQ=EtichettaA:parte1
kyfebwu6clbYqqWUdFIyaw=EtichettaB:qualche/percorso/parte2
-J9UAimo0Bqg9c0oOXI1mQ=http://some.where.com/part3

Tutte le righe nella sezione, che fornisce la mappatura dai checksum MD5 agli URI, hanno il
stesso formato: sul lato sinistro di `=' il checksum (codificato con un tipo Base64
codifica) è data, e sulla destra una stringa corrispondente alla parte con questo
somma di controllo; un URI completo o una stringa della forma `Discografica:pathname', che è
espanso in uno o più URI cercando la/le definizione/i per il Discografica nel
sezione "[Server]".

Nel caso in cui non sia possibile trovare un particolare checksum MD5 in nessuna sezione "[Parti]" da jigdo, le
programma eseguirà una ricerca per `MD5Sum:', ad esempio per
`MD5Sum:xJNkjrq8NYMraeGavUpllw' se hai cancellato la riga per `part0' sopra.

Un checksum che appare più volte in questa sezione indica un download alternativo
posizioni per la parte.

Potrebbe esserci un numero qualsiasi di sezioni "[Parti]" nel file; sono tutti considerati quando
cercare i checksum MD5.

file jigdo mette sempre la sezione "[Parts]" alla fine del file, e anche
riorganizza qualsiasi file specificato con --unisci avere solo una di queste sezioni alla fine. Questo
è fatto per consentire jigdo per visualizzare le informazioni dalla sezione "[Immagine]" mentre il
il resto di quel file è ancora in fase di download.

SERVER SEZIONE
[Server]
EtichettaA=http://myserver.org/
EtichettaA=ftp://mirror.myserver.org/
EtichettaB=EtichettaC:sottodirectory/
EtichettaC=http://some.where.com/jigdo/

Tutte le righe nella sezione, che fornisce la mappatura dalle etichette del server al server
locazioni, hanno lo stesso formato: sul lato sinistro di `=' viene dato il nome dell'etichetta, e
a destra il valore a cui espandere il nome dell'etichetta.

Un nome di etichetta che appare più volte in questa sezione indica un download alternativo
posizioni per le parti che utilizzano l'etichetta nella sezione "[Parti]". Questa notazione rende
è molto facile aggiungere mirror al file jigdo.

Come mostrato dall'esempio sopra, i valori dell'etichetta possono fare riferimento ad altre etichette. In
questo caso, la voce `LabelB:some/path/part2' nella sezione `[Parts]' si espanderà in
`http://some.where.com/jigdo/subdirectory/some/path/part2'. Anelli nell'etichetta
le definizioni determinano un comportamento indefinito e devono essere evitate.

Potrebbe esserci un numero qualsiasi di sezioni "[Server]" nel file; sono tutti considerati quando
cercando etichette. Sia "[Parti]" che "[Server]", ma non entrambi, possono essere omessi da
il file jigdo.

COMMENTO SEZIONE
[Commento]
Qualsiasi testo, eccetto che le righe non devono iniziare con "[".

Tutto il testo che segue una riga "[Commento]" o "[commento]" viene ignorato, fino alla riga successiva con
un'etichetta di sezione.

INCLUDERE DIRETTIVA
[Includere http://some.url/file.jigdo]

Le righe di questo modulo causano il download del contenuto del file jigdo specificato e
analizzato proprio come il file jigdo principale. L'effetto sarà lo stesso della copia dell'incluso
contenuto del file nel file che contiene la direttiva include. (Eccezione: Qualsiasi
gli URL relativi vengono sempre risolti utilizzando l'URL del `.jigdo'file che lo contiene
URL relativo.)

L'argomento URL può essere un URL assoluto o relativo. Si presume che gli URL relativi siano
relativo all'URL del file jigdo che contiene la direttiva include. Include can
essere nidificato, ma è un errore creare un ciclo di direttive di inclusione. è non possibile
utilizzare URL del modulo `Discografica:pathname'.

L'URL non può essere citato con "". Qualsiasi carattere `]' nell'argomento deve essere sottoposto a escape come
"%5D" e qualsiasi spazio come "%20".

Le direttive di inclusione sono supportate solo da jigdo, vengono ignorati da jigdo-lite.

Una direttiva include termina qualsiasi sezione precedente, ma non ne inizia una nuova. In
in altre parole, una nuova sezione deve essere sempre iniziata dopo la riga di inclusione, jigdo non
consentire la visualizzazione delle voci normali sotto "[Includi]".

CACHE FILE

Qualsiasi file specificato con --cache l'opzione viene utilizzata per memorizzare informazioni sul FILE
presentato a file jigdo. Quando si interroga la cache, un file viene considerato invariato (e il
vengono utilizzati i dati memorizzati nella cache) solo se il nome del file, la dimensione del file e l'ora dell'ultima modifica (mtime) corrispondono
Esattamente. Per la corrispondenza del nome del file, non viene utilizzato l'intero nome del file, ma solo la parte
dopo qualsiasi `//', in modo che qualsiasi modifica alla parte prima di `//' non invalidi
la cache.

Le vecchie voci della cache vengono rimosse dalla cache se non sono state lette o scritte
per il periodo di tempo specificato con --cache-scadenza. Le voci sono non immediatamente rimosso
dalla cache se il file a cui si riferiscono non esiste più - questo rende possibile
cache informazioni sui file su supporti rimovibili.

La scadenza della cache avviene solo dopo file jigdo ha svolto il suo lavoro principale - se ci sono vecchie voci
si accede prima della scadenza, saranno conservati. Ad esempio, se il programma è
viene eseguito utilizzando il tempo di scadenza predefinito di 30 giorni, ma accede a un file di cache con le voci
generato 2 mesi fa, quindi le voci in quella cache volere essere considerati, e solo quelli
le voci della cache che non erano necessarie durante l'esecuzione del programma scadranno.

A causa di una particolarità della libreria del database sottostante (libdb3), i file di cache non sono mai
si restringono, crescono solo. Se un numero elevato di voci è scaduto dal file di cache e
vuoi che si riduca, puoi semplicemente eliminarlo (ovviamente allora tutto avrà
da rigenerare) o utilizzare le utility che accompagnano libdb3 per eseguire il dump e ripristinare il
database, con un comando come `db3_scarica vecchia-cache.db | db3_carica nuova-cache.db'. Per Debian,
questi programmi sono forniti nel pacchetto `libdb3-util'.

Se un diverso --md5-dimensione del blocco è specificato, l'intero file deve essere riletto per
aggiorna la sua voce nella cache. Se un diverso --min-lunghezza è specificato, solo il primo
I byte `md5-block-size' del file devono essere riletti.

ESEMPI

PREPARAZIONE AL VOSTRO CD IMMAGINE PER DISTRIBUZIONE
Hai creato un'immagine del CD `immagine.iso' da alcuni dei file memorizzati nella directory
`/casa/ftp' sul disco rigido, disponibile anche online come `ftp://miosito.org'. Come
non vuoi sprecare spazio ospitando efficacemente gli stessi dati due volte (una volta come file su
il server FTP, una volta all'interno dell'immagine), e sei stufo dell'interruzione dei download degli utenti
dopo 200MB e dopo aver riavviato il download decine di volte, decidi di usare jigdo.
Come si prepara l'immagine per il download?

Infatti è necessario un solo comando:

file jigdo fai-modello --image=immagine.iso --jigdo=/home/ftp/image.jigdo
--template=/home/ftp/immagine.template /casa/ftp// --etichetta Il miosito=/home/ftp --uri
Miosito=ftp://miosito.org/

Le persone ora possono indicare jigdo a `ftp://miosito.org/image.jigdo' per scaricare la tua immagine. Il
il file modello deve essere accessibile come `ftp://miosito.org/immagine.template'.

Nota che nulla ti impedisce di fare lo stesso per un server FTP che non lo è
amministrato da te - in tal caso, devi solo ospitare il `.jigdo' e `.modello'
file sul tuo server/home page.

PREPARAZIONE AN ARBITRARIO LARGE RISORSE PER DISTRIBUZIONE
Supponiamo che tu abbia un file di grandi dimensioni che non è un filesystem, ad esempio `film.mpeg'. Perché
di problemi di spazio, si desidera distribuire i dati su due server.

In questo caso, le parti dell'immagine devono essere generate artificialmente con il dividere
comando. Ad esempio, per creare blocchi di 4 MB ciascuno, utilizzare `dividere -b 4m film.mpeg parte'.
Copia i file risultanti `parte XX' in due directory `1' e `2' che crei,
in base a come si desidera distribuire i file tra i server. Quindi, crea il
jigdo e file modello con `file jigdo fai-modello --image=film.mpeg 1 // 2 //'. Voi
sarà necessario modificare il `.jigdo' e fornire gli URI corretti per i due server che
stai per caricare il `parte XX'file in.

PERSONALIZZATI VERSIONI OF IMMAGINI
Poiché è possibile assegnare un URI diverso per ogni parte di un'immagine, se necessario,
jigdo è molto flessibile. Un solo esempio è la possibilità di versioni personalizzate di
immagini: supponiamo che qualcuno stia distribuendo l'immagine di un CD e che tu voglia crearne alcune
piccole modifiche ad esso e ridistribuire la propria versione. Scarica il `ufficiale.iso' CD
immagine con jigdo (passandogli l'URL di `ufficiale.jigdo'), scrivilo su CD-R, crea il tuo
modifiche (diciamo, aggiungendo file da `i miei file' directory sul tuo disco fisso) e produci il tuo
propria versione, `miaversione.iso'. Successivamente, istruisci file jigdo per creare il jigdo e
file modello per l'immagine modificata, utilizzando il comando

file jigdo fai-modello --image=miaversione.iso /mnt/cdrom/ i miei file// --etichetta
Mio=miofile/ --uri mio=http://my.homepage.net/ --merge=ufficiale.jigdo
mentre `ufficiale.iso' è montato sotto `/mnt/cdrom'. Usando --unisci, hai detto jigdo-
filetto prendere il contenuto di `ufficiale.jigdo', aggiungi una nuova sezione '[Immagine]' per
`miaversione.iso' e scrivi il file jigdo risultante in `miaversione.jigdo' - così ora
`miaversione.jigdo' offre due immagini da scaricare, la versione originale e la tua modificata
versione. (Se non vuoi che offra la versione ufficiale, modificala e rimuovi il
Sezione "[Immagine]" che elenca "ufficiale.iso'.)

Ora puoi caricare il `.jigdo', il `.modello' e anche i file in `i miei file'
a `http://my.homepage.net/'. Quindi, affinché le persone scarichino la tua immagine modificata, lo fai
non devi caricare il contenuto completo dell'immagine sul tuo spazio web, ma solo le modifiche che vuoi
fatto!

(Nel caso in cui hai apportato solo pochissime modifiche, puoi anche omettere il parametro `myfiles' in
il comando sopra, quindi tutte le modifiche finiscono nel nuovo file modello.)

COMBINAZIONE MOLTI JIGDO-GESTITO IMMAGINI INTO ONE
Inoltre, non è un problema combinare i dati provenienti da diverse fonti che utilizzano jigdo. Ad esempio, se
di cinque server diversi e non correlati, ognuno distribuisce un'immagine CD diversa tramite
jigdo, puoi creare un'immagine DVD personalizzata che contenga i dati di tutti questi CD.
Quando le persone usano jigdo per scaricare la tua immagine, vengono recuperati i singoli file sul DVD
dalle stesse fonti dei CD originali.

Di conseguenza, anche se distribuirai un file da 3.2 GB tramite il tuo spazio web, il
la quantità effettiva di dati che viene archiviata sul tuo server sarà solo nell'ordine di diversi
MB.

Usa jigdo-file online usando i servizi onworks.net