jigdo-file - Online în cloud

PROGRAM:

NUME

jigdo-file - Pregătește fișierele pentru Jigsaw Download (distribuție de fișiere uriașe, de exemplu CD
imagini).

REZUMAT

jigdo-file COMMAND
[ --image=cdrom.iso ] [ --jigdo=cdrom.jigdo ] [ --template=cdrom.şablon ] [ --forta ] [
MAI MULT OPŢIUNI ] [ DOSARE ... | --files-from=f ]
Comun COMENZI: face-şablon, face imagine, verifica

DESCRIERE

Jigsaw Download, sau scurt jigdo, este o schemă dezvoltată în primul rând pentru a face mai ușor
distribuiți imagini uriașe ale sistemului de fișiere (de exemplu, imagini CD (ISO9660) sau DVD (UDF)) peste
internet, dar ar putea fi folosit și pentru alte date care sunt greu de gestionat din cauza lor
dimensiune, cum ar fi fișiere audio/video sau pachete software mari.

jigdo încearcă să se asigure că fișierul mare (numit întotdeauna imagine de acum înainte) este descărcat
în piese mici care pot fi stocate pe diferite servere. Persoanele care doresc să descarce
imagine face acest lucru spunând jigdo(1) (NOTĂ IMPLEMENTAT INCA) descărcare instrument pentru a procesa unul
`.jigdo' dosar; folosindu-l, jigdo descarcă piesele și reasambla imaginea. jigdo-file
este folosit pentru a pregăti fișierele pentru descărcare.

Ceea ce face jigdo special este faptul că părțile care sunt folosite pentru a reconstrui imaginea pot avea
orice dimensiune și conținut - trebuie doar să fie conținute într-o regiune adiacentă oriunde în
imaginea.

De exemplu, dacă doriți să distribuiți o imagine ISO9660 care conține un instantaneu al unui
Server FTP, puteți instrui jigdo-file să pregătească datele de descărcare în așa fel încât
când oamenii folosesc jigdo pentru a descărca imaginea, jigdo preia de fapt fișierele individuale
de pe serverul FTP și le adună într-o copie exactă a imaginii dvs. - în timpul
Descarca! (Dacă imaginea nu este un dump de sistem de fișiere, puteți utiliza împărţi(1) pentru a crea mic
părți din care imaginea va fi reasamblată.)

Sunteți complet liber să alegeți unde sunt stocate părțile individuale ale imaginii: Ei
poate fi în directoare complet diferite pe servere diferite (de exemplu, din cauza
constrângeri de stocare/lățime de bandă), dar acest lucru este invizibil pentru persoanele care vă descarcă
imagine. Informațiile despre serverele disponibile trebuie doar adăugate la `.jigdo'dosar
de dvs. înainte de a-l distribui.

Secțiunea „DETALII” de mai jos conține detalii tehnice despre cum funcționează jigdo. „EXEMPLE”
secțiunea listează o serie de scenarii comune și vă poate ajuta să vă faceți o idee despre ce jigdo
este util pentru.

OPŢIUNI

Multe opțiuni sunt specifice unui anumit COMMAND; cele de mai jos sunt generale sau folosite de
mai multe comenzi. Alte opțiuni sunt listate mai jos cu comenzile individuale. Toate
opțiunile sunt ignorate în tăcere dacă nu sunt aplicabile la comanda curentă. Pentru orice
BYTES parametrii opțiunilor, puteți adăuga una dintre literele „k”, „M” sau „G” la
suma pe care o specificați, pentru a indica kilobytes, megabytes sau gigabytes.

-h --Ajutor
Produceți un scurt rezumat al comenzilor și opțiunilor.

-H --ajută-toți
Emite un rezumat complet al comenzilor și opțiunilor.

-v --versiune
Versiunea programului de ieșire.

-i --image=cdrom.iso
Specificați locația fișierului care conține imaginea. Imaginea este fișierul mare care
vrei să distribui.

-j --jigdo=cdrom.jigdo
Specificați locația fișierului de descriere Jigsaw Download. Fișierul jigdo este a
fișier care poate fi citit de om generat de jigdo-file, la care adăugați informații despre toate
serverele pe care urmează să încărcați fișierele. jigdo va descărca acest fișier ca
primul pas de recuperare a imaginii.

-t --template=cdrom.şablon
Specificați locația fișierului „șablon” de imagine. Fișierul șablon este un fișier binar
generat de jigdo-file, conține informații despre cum să reasamblați imaginea și
de asemenea (în formă comprimată) toate datele din imagine care nu au fost găsite în niciunul dintre
părțile.

În funcție de comandă, fiecare dintre aceste trei fișiere este folosit uneori pentru introducere,
uneori pentru ieșire. Dacă fișierul urmează să fie utilizat pentru ieșire pentru o anumită comandă
și fișierul de ieșire există deja, jigdo-file iese cu o eroare, cu excepția cazului în care --forta
este prezent.

În cele mai multe cazuri, va trebui să specificați doar unul dintre -i -j -t, pentru că oricare
numele de fișiere lipsă vor fi deduse din cel specificat. Acest lucru se face mai întâi
eliminarea oricărei extensii din numele furnizat și apoi adăugarea nimicului (dacă
deducerea --imagine), `.jigdo' sau `.sablon'.

-r --report=default|noprogress|quiet|grep
Controlați cât de detaliate este programul și ce format are rezultatul: nici un progres is
la fel ca lipsă cu excepția faptului că nu sunt tipărite mesaje de progres „x% done”. liniştit
restricționează rezultatul la ceea ce este absolut necesar, mai ales mesaje de eroare. grep
este doar diferit de lipsă pentru face-şablon comandă: permite ieșirea în
un simplu ` ', care este util atunci când căutați fișiere binare
în alte fișiere binare.

-f --forta
Suprascrie fișierele de ieșire existente fără a te plânge.

--fără-forță
Acest is il Mod implicit. Refuzați să suprascrieți fișierele de ieșire existente.

-c --cache=jigdo-cache.db
jigdo-file de obicei, trebuie să citească întregul conținut al tuturor DOSARE tu specifici.
Dacă îl utilizați în mod repetat (de exemplu, deoarece faceți disponibilă zilnic o nouă imagine de CD),
memorarea în cache a informațiilor despre fișier va crește viteza programului în mod semnificativ. The
fișierul cache este creat automat dacă nu este încă prezent. Datele sunt de obicei ambele
citit și scris pe el.

--fără-cache
Acest is il Mod implicit. Nu utilizați un cache.

--cache-expiry=SECUNDE
Setați vârsta maximă a intrărilor în cache. Orice intrări mai vechi decât aceasta vor fi eliminate din
cache-ul. Valoarea implicită este de 30 de zile. Puteți adăuga una dintre literele „h”, „d”, „w”,
„m”, „y” pentru a desemna ore, zile, săptămâni, luni sau, respectiv, ani. O valoare de
`0' sau `off' dezactivează expirarea, astfel încât toate intrările vor rămâne în cache pentru totdeauna.
Consultați secțiunea „FIȘIERE CACHE” de mai jos pentru mai multe informații.

--readbuffer=BYTES
Setați dimensiunea bufferelor interne. Valoarea implicită este 128k - dacă aveți un disc rapid,
creșterea acestei valori poate face jigdo-file mai rapid, dar în general, schimbarea este
nu este necesar.

--md5-block-size=BYTES
Neinteresant intern parametru. Setați dimensiunea blocurilor în care se află fișierele
subdivizat. Valoarea implicită este 128k. Dacă îl schimbați, orice fișier cache va trebui să fie
regenerat. Intern, jigdo-file poate alege să folosească un ceva mai mare sau mai mic
valoare.

-T --files-from=fişier
Citiți numele fișierelor și directorului din fișierul specificat. Dacă fişier este `-', citește numele
de la intrare standard. Fiecare linie din fișier este luată ca nume, așa că numele pot fi
conțin spații, dar nu caractere newline. O linie goală provoacă jigdo-file pentru a opri
citind din dosar.

găsi(1) este un instrument puternic pentru generarea de liste de fișiere, dar asigurați-vă că utilizați `găsi
-Tip f' dacă este posibil - în caz contrar, dacă instruiți găsi pentru a scoate atât un nume de fișier
și un link simbolic către acel nume de fișier, jigdo-file va citi conținutul fișierului de două ori.

--hex Ieșiți sumele de verificare în hexazecimal în loc de format asemănător Base64. Acest lucru nu ar trebui să fie
folosit cu face-şablon comanda, deoarece rezultatul `.jigdofișierul încalcă
`.jigdo' tipul fisierului. Utilizarea sa destinată este de a face jigdo-file mai interoperabil
cu alte utilitare shell Unix, cum ar fi md5sum(1).

--nu-hex
Acest is il Mod implicit. Utilizați codificarea proprie a sumelor de control asemănătoare Base64 de la jigdo.

--debug[=help|=all|=UNITATE,~UNITAT... ]
Porniți sau dezactivați ieșirea de depanare. Doar `--debug' este echivalent cu `--debug=all'.
Argumentul este o listă de nume de unități separate prin virgulă pentru care este rezultatul de depanare
să fie activat sau dezactivat dacă numele este precedat de „~”. Numele special „toate”
înseamnă toate unitățile. În mod implicit, ieșirea de depanare este oprită, cu excepția unităților
„afirmare” și „general”. Lista exactă a unităților disponibile pentru care poate fi depanată
fi pornit depinde dacă jigdo a fost compilat cu suport de depanare - the
lista poate fi tipărită cu `--debug=help'.

DOSARE Numele fișierelor sau directoarelor de utilizat ca intrare. Acestea sunt părțile care sunt
cuprinse în imagine. În cazul în care unul dintre nume este un director, programul
scanează recursiv directorul și adaugă toate fișierele conținute în el. În timp ce face
aceasta, urmează legături simbolice, dar evită buclele de legături simbolice.

Dacă unul dintre numele fișierelor începe cu caracterul „-”, trebuie să precedați lista de
fișiere cu `--'. O valoare a lui `-' are Nu. semnificație specială în această listă, reprezintă
un fișier al cărui nume este o singură cratimă.

COMANDE

Numele comenzii este primul argument fără opțiune căruia i-a fost transmis jigdo-file. Majoritatea comenzilor au
abrevieri scurte precum și nume lungi. mic de statura comandă nume să nu be utilizat in
script-uri - acolo Mai be incompatibil schimbari la lor in il viitor!

FACE-ȘABLON, MT
Citește imagine și DOSARE, creează `.jigdo' și `.sablon'. Aceasta este principala funcționalitate a
jigdo-file.

Este posibil să le specificați pe ambele --image=- și --files-from=-. În acest caz, mai întâi lista
de fișiere este citită de la intrarea standard până când este întâlnită o linie goală. Tot
după aceasta se presupune că sunt datele imaginii. Acest lucru poate fi util dacă utilizați mkisofs(1) sau
programe similare care pot scoate imaginea completă pe ieșirea lor standard, deoarece
nu este nevoie să stocați temporar imaginea pe disc.

În cazul în care o DOSARE argumentul conține caracterele „//” (Unix) sau „\.\” (Windows), acesta are
sens special. În fișierul jigdo final pe care utilizatorii îl vor descărca, fiecare dintre părți este
referit în secțiunea „[Parți]” cu un URI de forma „Etichetă:unele/nume fișier”. (Vedea
`FORMAT DE FIȘIERE .JIGDO' de mai jos pentru o descriere detaliată.) Secțiunea `[Servere]' oferă
o mapare a etichetelor către servere de pe internet, cu linii ca
`Etichetă=http://myserver.org/jigdofiles/'. Folosind aceste informații, jigdo va crea
URI final de descărcare pentru piesa, `http://myserver.org/jigdofiles/some/filename'.
Specificarea „//” (sau „\.\”) într-un nume de fișier sau director servește la „decuparea” numelor de la
nivelul corect de director. De exemplu, dacă calea Unix a unuia dintre dvs DOSARE is
`/path/some/filename', vă puteți da seama jigdo-file a tăia după `/cale' trecând pe lângă ea
argumentul `/path//some/filename', sau `/path//' dacă doriți ca întregul director să fie scanat.
Numele căilor nu trebuie să fie absolute; `somedirectory//' este de asemenea posibil.

--eticheta Label=/cale
Specificați un nume de utilizat ca nume de etichetă pentru o cale de pe disc. (Influențează rezultatul
jigdo.) Dacă ați folosit `//' în fișierul DOSARE argumentele descrise mai sus, jigdo-file
va alege automat numele etichetelor (`A', `B' etc.). Cu această opțiune,
puteți da etichetelor nume mai semnificative. Rețineți că numele etichetei va fi doar
folosit dacă unul sau mai multe DOSARE începe cu `/path//'.

Încercați să utilizați nume de etichete care încep cu caractere majuscule, pentru a le dezambigua
în mod clar din numele de protocol precum „http”, „ftp”.

--uri Etichetă=http://some.server.org/
Implicit, folosind --eticheta așa cum este descris mai sus va provoca linii de formă
`Label=file:/path/' care urmează să fie scris în secțiunea `[Servere]' din jigdo de ieșire
fişier. Dacă doriți să suprascrieți URI-ul „fișier:” astfel încât linia să citească
`Etichetă=http://some.server.org/', puteți face acest lucru specificând --uri împreuna cu
--eticheta. Dăruind doar --uri Etichetă=... fără corespunzătoare --eticheta Etichetă=...
nu are niciun efect și chiar dacă le specificați pe ambele, o intrare este adăugată doar la
Secțiunea „[Servere]” dacă eticheta este referită de cel puțin o intrare „[Parți]”.

Valoarea furnizată nu este cotată de program; dacă conține caractere precum
spațiu sau oricare dintre caracterele #"'\, atunci trebuie să îl citați. (În Unix, puteți
trebuie să citați valoarea de două ori pentru a o proteja și de shell, de exemplu, \\\\ sau „\\”
pentru a obține o singură bară oblică inversă în URI.)

Maparea specificată cu un --uri opțiunea este ignorată dacă este deja prezentă în
fișierul jigdo de ieșire.

Utilizatorii versiunii Windows pot observa că separatorii de directoare „\” sunt
convertit în `/' în `file:' URI-urile care sunt generate implicit. Acest lucru este făcut
pentru a crește compatibilitatea multiplatformă a `file:' - the imprimare-lipsă comanda de
versiunea Windows va reconverti automat caracterele atunci când imprimă
URI-uri. În cazul în care furnizați propriile URI-uri „fișier:” sub Windows folosind --uri, Trebuie să vă
schimbă, de asemenea, `/' și `\'.

-0 la -9
Setați cantitatea de compresie în fișierul șablon de ieșire, de la -0 (fără compresie) la
-9 (compresie maximă). Valoarea implicită este -9, care poate face generarea șablonului
destul de lent. În mod implicit, algoritmul de compresie utilizat este același ca pentru gzip(1).

--gzip și --bzip2
Alegeți între algoritmii de compresie gzip și bzip2. Valoarea implicită este gzip.
Bzip2 oferă de obicei un raport de compresie mai bun, dar compresia este semnificativă
mai lent decât cu gzip.

--min-length=BYTES
Setați lungimea minimă a unei piese pentru jigdo-file să-l cauți în imagine. The
implicit este 1k. Părți mai mici decât aceasta nu vor fi găsite niciodată în imagine, deci lor
datele vor fi incluse în fișierul șablon. Algoritmul de căutare utilizat necesită acest lucru
o lungime minimă, altfel generarea șablonului ar putea deveni extrem de lentă. daca tu
știi cu siguranță că toate dvs DOSARE sunt mai mari decât o anumită sumă, puteți
creşte jigdo-fileviteză ușor prin specificarea sumei cu această opțiune.
Există un minim absolut cablat de 256 de octeți - orice lucru mai mic va fi în tăcere
fi setat la 256.

--merge=FILE
Includeți conținutul FILE în ieșirea `.jigdo' dosar. Fișierul poate conține date
pe care doriți să îl adăugați la ieșire (de exemplu, o secțiune „[Servere]” cu o listă
a serverelor dvs. ca intrări), sau poate fi fișierul jigdo rezultat dintr-o rulare anterioară
of jigdo-file.

Este posibil să specificați același fișier pentru intrare cu --combina iar pentru ieșire cu
--jigdo. Cu toate acestea, va trebui, de asemenea, să utilizați --forta pentru a face programul să se suprascrie
versiunea veche a fișierului jigdo cu cea nouă. FILE poate fi `-' pentru standard
intrare.

Cand adăugare informații noi în fișierul furnizat, jigdo-file nu va introduce nou
linii în secțiunea „[Parți]” dacă o intrare pentru aceeași sumă de control MD5 (dar nu
neapărat cu același URI!) există deja și nu va insera linii noi
în secțiunea „[Servere]” dacă există deja o intrare complet identică.

Cand lectură in existenta FILE, comportamentul este ușor diferit: Programul
conserve intrări în secțiunea `[Parți]' cu sumă de control identică, dar diferită
URI-uri. Pentru intrări complet identice (aceeași sumă de control și URI), este o singură intrare
păstrate și duplicatele sunt eliminate. Secțiunea „[Servere]” este lăsată
neatins.

--secțiune-imagine
Acest is il Mod implicit. Cauze jigdo-file pentru a adăuga o secțiune „[Imagine]” la „.jigdo'
fișier.

Ca excepție, o nouă secțiune „[Imagine]” este nu adăugat dacă utilizați --combina si
fișierul de îmbinat conține o secțiune „[Imagine]” cu o linie care citește „Șablon-
MD5Sum=' (sfârșitul rândului după `='). În acest caz, datele șablonului generate
Valoarea sumei de control MD5 este doar adăugată după „=” din prima linie a acestui formular în
fișierul - nu este atașată nicio secțiune complet nouă „[Imagine]”. Acest comportament este util
pentru că vă permite să treceți prin --combina o secțiune „[Imagine]” cu arbitrare
conținut și apoi adăugați automat suma de control MD5 de jigdo-file.
secțiunea „FORMAT FIȘIERE .JIGDO” de mai jos explică conținutul secțiunii „[Imagine]” în
detalii mai mari.

--no-image-section
Do nu includeți o secțiune „[Imagine]” în secțiunea „.jigdo' dosar. Trebuie să adăugați unul
dvs. dacă utilizați această opțiune. Cu toate acestea, să faci asta nu este ușor (de asemenea, trebuie
adăugați o linie „Template-MD5Sum” cu suma de verificare corectă sau jigdo se va plânge), deci
utilizarea acestei opțiuni este descurajată.

--secțiunea-servere
Acest is il Mod implicit. Cauze jigdo-file pentru a adăuga o secțiune „[Servere]” la „.jigdo'
fişier. Această secțiune implicită folosește URI-uri „fișier:”, care permite reasamblarea imediată
a imaginii din sistemul de fișiere local și este, de asemenea, util dacă doriți să editați fișierul
fișier manual și înlocuiți URI-urile „fișier:” cu alte URI-uri.

--no-server-section
Do nu adăugați o secțiune `[Servere]' la sfârșitul `.jigdo' dosar. Util de ex. dacă
veți adăuga secțiunea cu un script.

--match-exec=SHELLCOMAND
Ori de câte ori se găsește un fișier în imagine, executați șirul de comandă furnizat de
trecându-l la o cochilie. jigdo-file setează un număr de variabile de mediu cu
informații despre potrivirea fișierului. De exemplu, dacă fișierul `/cale//a/b/fișier' a fost
găsit în imagine și `Label:a/b/file' va fi scris în `.jigdo'
fișier:

· ETICHETA="Label" - Numele etichetei pentru fișier. Exemplul presupune că `--eticheta
Label=/path' a fost specificat de dvs. În absența unei astfel de opțiuni, ETICHETA voi
fi setat dar gol.

· LABELPATH="/path/" - Calea corespunzătoare etichetei sau, cu alte cuvinte, a
prefixul căii fișierului potrivit care va nu apar în rezultatul `.jigdo'
fişier. Este setat chiar și fără nici un `--eticheta' opțiune prezentă. Se termină cu o bară oblică.

· MATCHPATH="a/b/" - Restul căii, fără leafname-ul potrivit
fişier. Este fie gol, fie se termină cu o bară oblică.

· LEAF="fișier" - Numele fișierului potrivit.

· MD5SUM="lNVdUSqbo2yqm33webrhnw" - Suma md5 a fișierului potrivit, asemănător cu Base64
format.

· FILE="/path//a/b/file" - Pentru comoditate, calea completă a fișierului. The
variabila este întotdeauna setată la $LABELPATH$MATCHPATH$LEAF.

Vă rugăm să aveți grijă să citați corect șirul transmis acestei opțiuni, altfel dvs
comanda furnizată nu va funcționa cu numele de fișiere care conțin spații. De exemplu, să
creați o copie de rezervă a legăturilor hard către fișierele potrivite, utilizați următoarea opțiune: --match-
exec='mkdir -p „${LABEL:-.}/$MATCHPATH” && ln -f „$FILE” „${LABEL:-.}/$MATCHPATH$LEAF”'

În mod implicit, nu se execută nicio comandă. Utilizați --match-exec="" pentru a elimina un șir de comandă care
a fost setat cu o utilizare anterioară a acestei opțiuni.

--potrivire lacomă
Acest is il Mod implicit. Imaginează-ți că imaginea ta conține a .gudron dosar care la rândul său
conține un alt fișier x, și că oferiți atât .gudron și fișierele din interiorul acestuia
pe linia de comandă. Când jigdo-file scanează imaginea, întâlnește începutul
a .gudron fișier, apoi fișierul x.

În acest moment, trebuie luată o decizie: În cazul în care fișierul mai mic x fi înregistrat ca
potriviți, sau ar trebui să fie ignorat în favoarea potrivirii mai mari (și, prin urmare, mai bune).
il .gudron fişier? Din păcate, în acest moment nu este clar dacă va exista
fi de fapt o potrivire completă a .gudron, deci implicit, programul preferă cel mic
meci.

--fără-potrivire-lacomă
În cazul în care este prezentă o potrivire parțială mare și a fost o potrivire mai scurtă
confirmat, ignora meciul mic. (Vezi opțiunea de mai sus.)

FAZ-IMAGINE, MI
Citeste `.sablon' și DOSARE, creează imagine (sau `imaginename.tmp'). Oferă un aspect rudimentar
mod de reasamblare a imaginilor - jigdo este de obicei mai potrivit pentru această sarcină. Cu toate acestea, în
în contrast cu jigdo, nu `.jigdo' este necesar.

Dacă imaginea urmează să fie scrisă într-un fișier (și nu într-o ieșire standard), este posibil
creați imaginea în mai mulți pași, cu mai multe invocări de `jigdo-file face-imagine', la fel de
urmează: Mai întâi invoci jigdo-file, specificând cât mai multe fișiere sunt disponibile la aceasta
timp. Programul scanează fișierele, iar cele conținute în imagine sunt copiate în
un fișier temporar, al cărui nume este format prin adăugarea `tmp' la numele fișierului imagine.

Pentru toate fișierele suplimentare care ar putea face parte din imagine, repetați acest proces. Cât de curând
deoarece toate părțile sunt prezente, fișierul temporar va fi trunchiat ușor (pentru a șterge unele
date administrative care jigdo-file anexează la sfârșit) și redenumit imaginea finală
Nume. Posibilitatea reasamblarii imaginii in mai multi pasi este deosebit de utila pt
strângerea de fișiere de pe medii amovibile, de exemplu câteva CD-uri mai vechi.

Scripturi care folosesc face-imagine poate detecta dacă crearea imaginii este completă bifând
starea de ieșire: 0 semnalează crearea cu succes, în timp ce 1 înseamnă că trebuie să existe mai multe fișiere
furnizate. Alte erori duc la o stare de ieșire de 2 („recuperabil”, de exemplu fișierul nu a fost găsit)
sau 3 (nerecuperabil, de exemplu eroare de scriere).

--verifica fisierele
Acest is il Mod implicit. Ori de câte ori orice parte este copiată în imagine, verificați din nou
sumă de control față de suma de control stocată în șablon. Este recomandat ca dvs
lăsați acest lucru pornit, chiar dacă încetinește puțin crearea imaginii.

--no-check-files
Nu verificați sumele de verificare ale fișierelor atunci când le copiați în imagine. Acest lucru poate fi în siguranță
utilizat atunci când nu este utilizat niciun fișier cache (ceea ce înseamnă că fișierele vor fi scrise în fișierul
imagine imediat după scanare) sau întreaga imagine este verificată mai târziu cu
verifica comanda.

PRINT-LIPSĂ, PM
Citeste `.jigdo', `.sablon„și (dacă există) „imaginename.tmp', scoate încă o listă de URI-uri
necesare pentru a reasambla complet imaginea.

Împreună cu face-imagine comanda, aceasta oferă cea mai mare parte a funcționalității jigdo on
linia de comandă.

Pentru fiecare parte care nu este încă prezentă în fișierul imagine temporar, suma de verificare a fișierului este
a căutat în secțiunea `[Parts]' din fișierul jigdo. Orice etichetă din intrarea corespunzătoare
este apoi extins conform definițiilor etichetelor din secțiunea „[Servere]” și tipărit
la ieșire standard. jigdo vă permite să specificați mai multe locații alternative pentru fiecare
etichetă în această secțiune, dar imprimare-lipsă va scoate doar primul pentru fiecare lipsă
parte.

Dacă suma de control nu poate fi găsită în secțiunea „[Parți]” (acest lucru nu ar trebui să se întâmple decât dacă
ați șters acea secțiune), se face în schimb o căutare pentru `MD5Sum:', la fel ca
cu jigdo. (Astfel, dacă doriți să scăpați de secțiunea „[Piese]”, puteți face acest lucru dacă
redenumiți fiecare parte la propria sa sumă de control.)

--uri Etichetă=http://some.server.org/
Ignorați intrările din `.jigdo' pentru orice etichetă cu un URI la alegere.
În exemplul de mai sus, o intrare „[Parți]” a „Etichetă:unele/nume fișier” va cauza
linia `http://some.server.org/some/filename' pentru a fi tipărit.

Valoarea furnizată nu este cotată de program; dacă conține caractere precum
spațiu sau oricare dintre caracterele #"'\, atunci trebuie să îl citați. (În Unix, puteți
trebuie să citați valoarea de două ori pentru a o proteja și de shell, de exemplu, \\\\ sau „\\”
pentru a obține o singură bară oblică inversă în URI.)

PRINT-MISS-ALL, PMA
La fel ca imprimare-lipsă, această comandă scoate o listă de URI-uri încă necesare complet
reasamblați imaginea. In orice caz, toate locațiile alternative de descărcare sunt tipărite în loc de
doar unul. În rezultat, URI-urile pentru un fișier sunt separate de URI-urile altor fișiere cu
linii goale. The --uri opțiunea are același efect ca și pentru imprimare-lipsă.

VERIFICA, VER
Citește imagine (generat probabil cu face-imagine) și `.sablon', verifică dacă este corect
suma de control a imaginii.

Datele șablon nu conțin doar sume de control ale părților individuale, ci și ale
imaginea în ansamblu. face-imagine efectuează deja o serie de verificări interne, dar dacă tu
cum ar fi, puteți verifica în plus imaginea cu această comandă.

SCANĂ, SC
Citește toate DOSARE și le introduce în cache, cu excepția cazului în care sunt deja memorate în cache. The
--cache opțiunea trebuie să fie prezentă pentru această comandă.

--no-scan-totul-fișier
Acest is il Mod implicit. Acest lucru provoacă doar primul --md5-block-size octeți ai fiecărui fișier
a fi citit. Dacă memoria cache este folosită mai târziu de jigdo-file face-imagine, restul
fișierul va fi citit odată ce acești primi octeți sunt recunoscuți în imaginea de intrare.

--scanare-întregul-fișier
Citiți imediat întregul conținut al fișierului și stocați-l în cache.

MD5SUM, MD5
Citește toate DOSARE și tipărește sumele de verificare MD5 ale conținutului lor. Această comandă este destul de bună
similar md5sum(1), cu excepția faptului că suma de control este scoasă în codificare de tip Base64 care
este folosit și în altă parte de jigdo-file.

DOSARE argumentele sunt procesate în același mod ca și cu celelalte comenzi, ceea ce înseamnă
că recursiunea are loc automat pentru orice argumente care sunt directoare și că
legăturile simbolice nu sunt listate, cu excepția cazului în care fișierele către care indică nu sunt accesibile
direct.

În lista de sume de control tipărită pe ieșirea standard, doar partea următoare a numelui fișierului
orice `//' (sau `\.\' pe Windows) este tipărit. Orice --cache va fi folosit pentru interogarea fișierelor"
Sumele de control MD5 și/sau scrierea sumelor de control ale fișierelor scanate.

LIST-TEMPLATE, LS
Citește un `.sablon' și afișează informații de nivel scăzut despre imagine și toate părțile
conținute în acesta, inclusiv offset, lungime și sumă de control.

De asemenea, puteți utiliza această comandă cu fișiere imagine temporare (prin specificarea a ceva de genul
--template=imagename.tmp) - în acest caz, rezultatul face distincție și între părți care
au fost scrise pe imagine și părți care nu au fost.

Formatul exact de ieșire se poate schimba în mod incompatibil între diferite versiuni de jigdo. The
pot fi ieșite următoarele tipuri de linii diferite. `have-file' apare doar pentru `tmp'
fișiere, indicând un fișier care a fost deja scris cu succes în fișierul temporar:

în șablon decalaj în imagine lungime
nevoie-dosar decalaj în imagine lungime fișier-md5sum filestart-rsyncsum
au-dosar decalaj în imagine lungime fișier-md5sum filestart-rsyncsum
imagine-info lungimea imaginii imagine-md5sum dimensiunea rsyncsum

DETALII

Jigsaw Download a fost creat având în vedere formatul de imagini CD ISO9660 - cu toate acestea,
următoarele se aplică și pentru multe alte formate de sisteme de fișiere, precum și pentru arhivele „tar” și
arhive `zip' necomprimate. O imagine CD conține atât informații pentru organizarea
sistem de fișiere (antet cu numele discului etc., date din directorul ISO9660, date ale extensiilor, cum ar fi
Joliet sau RockRidge, zero padding) și fișierele conținute pe CD. Un important
proprietatea pe care se bazează jigdo este că fiecare fișier este stocat într-o secțiune adiacentă a fișierului
imagine; nu este împărțit în două sau mai multe părți.

Cand jigdo-file primește un număr de fișiere care ar putea fi conținute într-o imagine, detectează
dacă vreunul dintre fișiere este prezent folosind o „sumă de control rulanta” inspirată de cea utilizată
by rsync(1). Datele rezultate sunt scrise în `.sablon': Dacă o secțiune a
imaginea nu a putut fi potrivită (de exemplu, era informații despre director), datele sunt comprimate și
scris direct pe șablon. Cu toate acestea, dacă a fost găsit un fișier care se potrivește, datele acestuia sunt
omis din șablon. În schimb, este doar o referință (o sumă de verificare MD5 a fișierului).
inserat în șablon.

Rețineți că datele șablonului conțin doar date binare, nu conține niciun nume de fișier
sau URI, deoarece nu poate fi editat cu ușurință în cazul în care oricare dintre aceste valori trebuie schimbată.
Toate aceste informații sunt stocate în `.jigdo', un fișier text la care puteți adăuga adrese URL
pentru serverele dvs. Fișierul jigdo oferă o mapare pentru fiecare sumă de control MD5 la unul sau mai multe
locații alternative de descărcare pentru partea corespunzătoare.

În afară de maparea sumelor MD5 la URI-uri, fișierul jigdo conține, de asemenea, un URI care indică
într-o locație de descărcare pentru fișierul șablon. În acest fel, jigdo instrumentul de descărcare are nevoie doar
pentru a primi un URI (cel al `.jigdo') pentru a putea descărca și reasambla fișierul
imagine completă.

FORMAT OF .JIGDO DOSARE

Formatul general al `.jigdofișierele ' urmează pe cele ale lui `.ini', așa cum este folosit și de
Proiecte Gnome și KDE pentru unele date. Fișierul este organizat în secțiuni, fiecare dintre ele
este precedat de o linie care citește „[Sectionname]”. În cadrul fiecărei secțiuni, liniile au forma
`Etichetă=Valoare'. Asemenea linii sunt numite și „înregistrări” mai jos. Toate `.jigdo' fișierele folosesc UTF-8 ca
codificarea caracterelor lor.

Comentariile sunt introduse cu caracterul „#” și se extind până la sfârșitul rândului.
Spațiile albe sunt ignorate la începutul și la sfârșitul liniei, precum și la stânga și la dreapta secțiunii
nume și `=' în intrări. În plus, utilitățile jigdo împart textul fișierului
valoarea de intrare (adică partea de după `=') în cuvinte separate prin spații albe, la fel ca
Shell Unix. Ghilimele simple "" și "" duble pot fi folosite pentru a preveni, de exemplu, URI-urile
care conțin spații albe sunt împărțite. În mod similar, caracterele cu semnificație specială (
caracterele „#\ și spațiu/tab) trebuie să fie ghilimele cu \ pentru a apărea în valoare. Ca și în cazul
shell, există o diferență între „ „ și „ „: în „ „, caracterele „#\ și
spațiile albe își pierd semnificația specială și devin caractere obișnuite, în timp ce în " ",
doar caracterele „# și spațiile albe își pierd semnificația specială - cu alte cuvinte,
Escaperile backslash încă funcționează în interiorul „ „, dar nu în „ „.

`.jigdo' fișierele pot fi opțional comprimate cu gzip(1). jigdo-file iese întotdeauna
fișiere necomprimate, pe care le puteți comprima singur. jigdo-lite suportă single
fișiere necomprimate și comprimate.

(Comportament care se poate schimba în viitor și pe care nu ar trebui să se bazeze: jigdo
în plus, acceptă orice număr de text simplu concatenat și părți gzipped în fișiere
- de exemplu, puteți comprima un `.jigdo' și apoi adăugați câteva rânduri de
date necomprimate până la sfârșit.)

În toate cazurile, `.gz' ar trebui eliminată din numele fișierului - instrumentele vor
determina automat din conținutul fișierului dacă un fișier este comprimat sau nu.

Mai jos este o descriere a numelor de secțiuni individuale utilizate de jigdo.

JIGDO SECȚIUNEA
[Jigdo]
Versiune = 1.1
Generator=jigdo-file/1.0.0

Informații despre versiunea formatului de fișier jigdo folosit și programul care
l-a generat. Ar trebui să existe o astfel de secțiune pe `.jigdo' dosar.

IMAGE SECȚIUNEA
[Imagine]
Nume fișier="nume de fișier pentru economisire on utilizatorului disc"
Șablon=„URI Unde la aduc șablon fişier"
Template-MD5Sum=OQ8riqT1BuyzsrT9964A7g
ShortInfo=o singura linie descriere of il imagine (200 caractere max.)
Info=lung descriere (5000 caractere max.)

Valoarea pentru intrarea „Șablon” poate fi fie o adresă URL (absolută sau relativă la adresa URL
a fișierului jigdo) sau un șir de forma `Etichetă:caii de acces"(NEIMPLICATĂ), așa cum este descris
de mai jos.

Intrarea „Template-MD5Sum” este adăugată de jigdo-file și specifică suma de control MD5 a
generat `.sablon' dosar. Este folosit de jigdo pentru a detecta cazurile în care este descărcat
datele șablonului sunt corupte sau aparțin unei alte imagini.

Spre deosebire de alte valori de intrare, valorile intrărilor „ShortInfo” și „Info” sunt nu împărţi
în cuvinte, în schimb toate citatele sunt păstrate.

Valoarea intrării „Informații” este specială în acest sens jigdo(1) poate analiza opțional marcajul XML
contine. Dacă marcajul are erori, cum ar fi etichete dezechilibrate/neacceptate, șirul este
afișat literal, fără analiza XML. Etichetele acceptate sunt (îndrăzneţ),
(cursiv), (font mașină de scris), (subliniat), (font mai mare),
(font mai mic) și (rupere de linie). Entitățile acceptate includ <
(`<'), > (`>') și & (`&'). Rețineți că întreaga intrare „Informații” trebuie să fie pe o singură linie
fișierul jigdo.

Această secțiune poate apărea de mai multe ori, dar toate, cu excepția primei, vor fi ignorate. Acest
este util, de exemplu, când se creează un `.jigdo' pentru o imagine DVD atunci când aveți deja
`.jigdo' pentru CD-uri cu același conținut: puteți pur și simplu să „[Include]” (a se vedea mai jos).
Fișierele jigdo ale CD-urilor la sfârșitul fișierului jigdo DVD, după secțiunea sa „[Imagine]”.

PĂRȚI SECȚIUNEA
[Părți]
xJNkjrq8NYMraeGavUpllw=LabelA:part0
GoTResP2EC6Lb_2wTsqOoQ=LabelA:part1
kyfebwu6clbYqqWUdFIyaw=LabelB:some/path/part2
-J9UAimo0Bqg9c0oOXI1mQ=http://some.where.com/part3

Toate liniile din secțiune, care furnizează maparea de la sumele de control MD5 la URI, au
același format: În partea stângă a `=', suma de control (codificată cu un tip Base64
codificare) este dat, iar în dreapta un șir corespunzător părții cu aceasta
suma de control; fie un URI complet, fie un șir de formă `Etichetă:caii de acces', care este
extins în unul sau mai multe URI-uri prin căutarea definițiilor pentru Etichetă în
Secțiunea „[Servere]”.

În cazul în care o anumită sumă de control MD5 nu poate fi găsită în nicio secțiune „[Pieți]” de către jigdo,
programul va efectua o căutare pentru `MD5Sum:', de exemplu pentru
„MD5Sum:xJNkjrq8NYMraeGavUpllw” dacă ați șters linia pentru „part0” de mai sus.

O sumă de control care apare de mai multe ori în această secțiune indică o descărcare alternativă
locații pentru piesa.

În fișier poate exista orice număr de secțiuni „[Parți]”; toate sunt considerate când
căutând sumele de control MD5.

jigdo-file pune întotdeauna secțiunea `[Parts]' la sfârșitul fișierului și chiar
rearanjează orice fișier specificat cu --combina să aibă la sfârșit o singură astfel de secțiune. Acest
se face pentru a permite jigdo pentru a afișa informațiile din secțiunea „[Imagine]” în timp ce
restul acelui fișier este încă în curs de descărcare.

SERVERE SECȚIUNEA
[Servere]
LabelA=http://myserver.org/
LabelA=ftp://mirror.myserver.org/
LabelB=LabelC:subdirector/
LabelC=http://some.where.com/jigdo/

Toate liniile din secțiune, care furnizează maparea de la etichetele serverului la server
locații, au același format: în partea stângă a „=” este dat numele etichetei și
în dreapta valoarea la care extinde numele etichetei.

Un nume de etichetă care apare de mai multe ori în această secțiune indică o descărcare alternativă
locații pentru piesele care folosesc eticheta din secțiunea „[Piese]”. Această notație face
este foarte ușor să adăugați oglinzi la fișierul jigdo.

După cum se arată în exemplul de mai sus, valorile etichetelor pot face referire la alte etichete. În
în acest caz, intrarea „LabelB:some/path/part2” din secțiunea „[Parts]” se va extinde la
`http://some.where.com/jigdo/subdirectory/some/path/part2'. Bucle în etichetă
definițiile au ca rezultat un comportament nedefinit și trebuie evitate.

În fișier poate exista orice număr de secțiuni „[Servere]”; toate sunt considerate când
căutând etichete. Oricare dintre „[Parți]” sau „[Servere]”, dar nu ambele, pot fi omise din
fișierul jigdo.

CUM SECȚIUNEA
[Cometariu]
Orice text, cu excepția acelui rând, nu trebuie să înceapă cu „[”.

Tot textul care urmează unui rând „[Comentariu]” sau „[comentar]” este ignorat, până la următorul rând cu
o etichetă de secțiune.

INCLUDE DIRECTIVĂ
[Include http://some.url/file.jigdo]

Liniile acestui formular fac ca conținutul fișierului jigdo specificat să fie descărcat și
analizat la fel ca fișierul principal jigdo. Efectul va fi același cu copierea conținutului inclus
conținutul fișierului în fișierul care conține directiva include. (Excepție: Oricare
URL-urile relative sunt întotdeauna rezolvate folosind adresa URL a `.jigdo' fișier care conține asta
URL relativă.)

Argumentul URL poate fi un URL absolut sau relativ. Se presupune că URL-urile relative sunt
relativ la adresa URL a fișierului jigdo care conține directiva include. Include can
fi imbricat, dar este o eroare crearea unei bucle de directive include. Este nu posibil
pentru a utiliza URL-uri de forma `Etichetă:caii de acces'.

Adresa URL nu poate fi citată cu „”. Orice caracter `]' din argument trebuie să fie scapat ca
„%5D” și orice spații ca „%20”.

Directivele Include sunt acceptate numai de jigdo, sunt ignorate de jigdo-lite.

O directivă include încheie orice secțiune anterioară, dar nu începe una nouă. În
cu alte cuvinte, o nouă secțiune trebuie întotdeauna începută după linia include, jigdo nu
permiteți ca intrările normale să apară sub „[Include]”.

CACHE DOSARE

Orice fișier specificat cu --cache opțiunea este utilizată pentru a stoca informații despre DOSARE
prezentat la jigdo-file. La interogarea memoriei cache, un fișier este considerat neschimbat (și
datele stocate în cache sunt utilizate) numai dacă numele fișierului, dimensiunea fișierului și ora ultimei modificări (mtime) se potrivesc
exact. Pentru potrivirea numelui de fișier, nu este folosit întregul nume de fișier, ci doar partea
după orice „//”, astfel încât orice modificări aduse părții de dinainte de „//” nu vor invalida
cache-ul.

Intrările vechi din cache sunt șterse din cache dacă nu au fost citite sau scrise
pentru perioada de timp specificată cu --cache-expiry. Intrările sunt nu imediat eliminat
din cache dacă fișierul la care se referă nu mai există - acest lucru face posibil
stocați în cache informații despre fișierele de pe medii amovibile.

Expirarea memoriei cache are loc doar după jigdo-file și-a făcut munca principală - dacă există intrări vechi
sunt accesate înainte ca expirarea să aibă loc, acestea vor fi păstrate. De exemplu, dacă programul este
rulează folosind timpul de expirare implicit de 30 de zile, dar accesează un fișier cache cu intrări
generat acum 2 luni, apoi intrări în acel cache voi fi luate în considerare, și numai acestea
intrările din cache care nu au fost necesare în timpul rulării programului vor fi expirate.

Datorită unei particularități a bibliotecii baze de date de bază (libdb3), fișierele cache nu sunt niciodată
se micsoreaza, doar cresc. Dacă un număr mare de intrări a expirat din fișierul dvs. cache și
vrei să se micșoreze, poți fie să-l ștergi (desigur, atunci totul va avea
pentru a fi regenerat) sau utilizați utilitățile care însoțesc libdb3 pentru a descărca și restaura fișierul
baza de date, cu o comandă de genul `db3_dump vechi-cache.db | db3_load new-cache.db'. Pentru Debian,
aceste programe sunt furnizate în pachetul `libdb3-util'.

Dacă un diferit --md5-block-size este specificat, întregul fișier trebuie recitit
actualizați intrarea în cache. Dacă un diferit --min-lungime este specificat, doar primul
`md5-block-size' octeții fișierului trebuie recitiți.

EXEMPLE

PREGĂTIREA TA CD IMAGE PENTRU DISTRIBUTION
Ați creat o imagine de CD `imagine.iso' din unele dintre fișierele stocate în director
`/home/ftp' pe harddiscul dvs., care este disponibil și online ca `ftp://mysite.org'. La fel de
nu doriți să pierdeți spațiu găzduind efectiv aceleași date de două ori (o dată ca fișiere pe
serverul FTP, odată în interiorul imaginii), și te-ai săturat de anularea descărcărilor utilizatorilor
după 200 MB și repornind descărcarea de zeci de ori, decideți să utilizați jigdo.
Cum pregătiți imaginea pentru descărcare?

De fapt, este necesară o singură comandă:

jigdo-file face-şablon --image=image.iso --jigdo=/home/ftp/image.jigdo
--template=/home/ftp/image.template /home/ftp// --eticheta Mysite=/home/ftp --uri
Mysite=ftp://mysite.org/

Oamenii pot indica acum jigdo la `ftp://mysite.org/image.jigdo' pentru a vă descărca imaginea. The
fișierul șablon trebuie să fie accesibil ca `ftp://mysite.org/image.template'.

Rețineți că nimic nu vă împiedică să faceți același lucru pentru un server FTP care nu este
administrat de dvs. - în acest caz, trebuie doar să găzduiți fișierul `.jigdo' și `.sablon'
fișiere pe propriul server/pagina de pornire.

PREGĂTIREA AN ARBITRAR LARGE FILE PENTRU DISTRIBUTION
Presupunem că aveți un fișier mare care nu este un sistem de fișiere, de exemplu `film.mpeg'. pentru că
de probleme de spațiu, doriți să distribuiți datele pe două servere.

În acest caz, părțile imaginii trebuie generate artificial cu ajutorul împărţi
comanda. De exemplu, pentru a crea bucăți de 4 MB fiecare, utilizați `împărţi -b 4m film.mpeg parte'.
Copiați fișierele rezultate `parteaXX'în două directoare'1' și `2pe care tu creezi,
în funcție de modul în care doriți să fie distribuite fișierele între servere. Apoi, creați
jigdo și fișiere șablon cu `jigdo-file face-şablon --image=movie.mpeg 1 // 2 //'. Tu
va trebui să editați `.jigdo' și furnizați URI-urile potrivite pentru cele două servere care
veți încărca fișierul `parteaXX' fișiere către.

PERSONALIZATE VERSIUNI OF IMAGINI
Deoarece este posibil să atribuiți un URI diferit pentru fiecare parte a unei imagini dacă este necesar,
jigdo este foarte flexibil. Un singur exemplu este posibilitatea unor versiuni personalizate ale
imagini: Să presupunem că cineva distribuie o imagine CD și că doriți să faceți câteva
mici modificări ale acestuia și redistribuiți-vă propria versiune. Descărcați `oficial.iso'CD
imagine cu jigdo (trecându-i adresa URL a lui `oficial.jigdo'), scrieți-l pe CD-R, faceți-vă
modificări (să zicem, adăugarea de fișiere din `fișierele mele' directorul de pe harddisc) și produceți
propria versiune, `versiunea mea.iso'. În continuare, instruiți jigdo-file pentru a crea jigdo-ul și
fișiere șablon pentru imaginea dvs. modificată, folosind comanda

jigdo-file face-şablon --image=myversion.iso /mnt/cdrom/ fișierele mele// --eticheta
My=myfiles/ --uri Al meu=http://my.homepage.net/ --merge=official.jigdo
în timp ce `oficial.iso' este montat sub `/mnt/cdrom'. Prin utilizarea --combina, ai spus tu jigdo-
fişier a lua conținutul lui `oficial.jigdo', adăugați o nouă secțiune „[Imagine]” pentru
`versiunea mea.iso' și scrieți fișierul jigdo rezultat în `myversion.jigdo' - asa ca acum
`myversion.jigdo' oferă două imagini pentru descărcare, versiunea originală și cea modificată
versiune. (Dacă nu doriți ca acesta să ofere versiunea oficială, editați-o și eliminați
Secțiunea „[Imagine]” care listează `oficial.iso'.)

Acum puteți încărca fișierul `.jigdo', fișierul `.sablon' și, de asemenea, fișierele din `fișierele mele'
la `http://my.homepage.net/'. Astfel, pentru ca oamenii să descarce imaginea ta modificată, o faci
nu trebuie să încărcați întregul conținut al imaginii în spațiul dvs. web, dar numai modificările dvs
făcut!

(În cazul în care ați făcut doar foarte puține modificări, puteți, de asemenea, să omiteți parametrul `myfiles' în
comanda de mai sus, apoi toate modificările dvs. ajung în noul fișier șablon.)

COMBINAREA MULTE JIGDO-GESTIONAT IMAGINI ÎN ONE
De asemenea, nu este nicio problemă să combinați date din mai multe surse care folosesc jigdo. De exemplu, dacă
din cinci servere diferite și neînrudite, fiecare distribuie o imagine CD diferită prin
jigdo, puteți crea o imagine DVD personalizată care conține datele de pe toate aceste CD-uri.
Când oamenii folosesc jigdo pentru a descărca imaginea, fișierele individuale de pe DVD sunt preluate
din aceleași surse ca și CD-urile originale.

În consecință, chiar dacă veți distribui un fișier de 3.2 GB prin spațiul dvs. web, fișierul
cantitatea reală de date care este stocată pe serverul dvs. va fi doar de ordinea câtorva
MB.

Utilizați jigdo-file online folosind serviciile onworks.net