jigdo-file - מקוון בענן

תָכְנִית:

שֵׁם

jigdo-file - הכן קבצים להורדת Jigsaw (הפצה של קבצים ענקיים, למשל CD
תמונות).

תַקצִיר

קובץ ג'יגדו פקודה
[ --image=cdrom.iso ] [ --jigdo=cdrom.jigdo ] [ --תבנית=cdrom.template ] [ --כּוֹחַ ] [
נוסף אפשרויות ] [ קבצים ... | --files-from=f ]
Common פקודות: לעשות תבנית, תדמית, לאמת

תיאור

הורדת Jigsaw, או Jigdo קצר, היא תוכנית שפותחה בעיקר כדי להקל עליה
להפיץ תמונות עצומות של מערכת קבצים (למשל תמונות CD (ISO9660) או DVD (UDF) על גבי
אינטרנט, אבל זה יכול לשמש גם לנתונים אחרים שקשה לטפל בהם בגלל זה
גודל, כמו קבצי אודיו/וידאו או חבילות תוכנה גדולות.

jigdo מנסה להבטיח שהקובץ הגדול (תמיד נקרא תמונה מעתה ואילך) יורדת
בחלקים קטנים שניתן לאחסן בשרתים שונים. אנשים שרוצים להוריד את
תמונה לעשות זאת על ידי אמירת ה- ג'יגדו(1) (לֹא מוטמע עדיין) הורד כלי לעיבוד אחד
`.ג'יגדו'קובץ; משתמש בזה, ג'יגדו מוריד את החלקים ומרכיב מחדש את התמונה. קובץ ג'יגדו
משמש להכנת הקבצים להורדה.

מה שמייחד את ג'יגדו הוא שיכולים להיות חלקים המשמשים לשחזור התמונה
כל גודל ותוכן - הם צריכים להיות מוכלים רק באזור רציף בכל מקום בו
התמונה.

לדוגמה, אם ברצונך להפיץ תמונת ISO9660 המכילה תמונת מצב של
שרת FTP, אתה יכול להורות קובץ ג'יגדו להכין את נתוני ההורדה בצורה כזו
כאשר אנשים משתמשים ג'יגדו כדי להוריד את התמונה, ג'יגדו למעשה מביא את הקבצים הבודדים
משרת ה-FTP ומרכיב אותם לעותק מדויק של התמונה שלך - במהלך ה
הורד! (אם התמונה אינה dump של מערכת קבצים, אתה יכול להשתמש לפצל(1) ליצור את הקטן
חלקים שמהם התמונה תורכב מחדש.)

אתה חופשי לחלוטין לבחור היכן מאוחסנים החלקים הבודדים של התמונה: הם
עשוי להיות בספריות שונות לחלוטין בשרתים שונים (למשל בגלל
אילוצי אחסון/רוחב פס), אבל זה בלתי נראה לאנשים שמורידים את שלך
תמונה. יש להוסיף רק את המידע על שרתים זמינים ל- `.ג'יגדוקובץ
על ידך לפני ההפצה.

הסעיף 'פרטים' להלן מכיל פרטים טכניים על אופן הפעולה של ג'יגדו. ה'דוגמאות'
הסעיף מפרט מספר תרחישים נפוצים ועשוי לעזור לך לקבל מושג על איזה ג'יגדו
שימושי עבור.

אפשרויות

אפשרויות רבות הן ספציפיות לפרט פקודה; אלה להלן כלליים או בשימוש על ידי
מספר פקודות. אפשרויות נוספות מפורטות להלן עם הפקודות הבודדות. את כל
האפשרויות מתעלמות בשקט אם הן אינן ישימות לפקודה הנוכחית. לכל
בתים פרמטרים לאפשרויות, אתה יכול להוסיף אחת מהאותיות 'k', 'M' או 'G' ל-
כמות שתציין, כדי לציין קילובייט, מגה-בייט או ג'יגה-בייט.

-h - עזרה
פלט סיכום קצר של פקודות ואפשרויות.

-H --לעזור לכולם
פלט סיכום מלא של פקודות ואפשרויות.

-v --גִרְסָה
גרסת תוכנית פלט.

-i --image=cdrom.iso
ציין את מיקום הקובץ המכיל את התמונה. התמונה היא הקובץ הגדול ש
אתה רוצה להפיץ.

-j --jigdo=cdrom.jigdo
ציין את המיקום של קובץ התיאור של הורד Jigsaw. קובץ ה-jigdo הוא א
קובץ קריא לאדם שנוצר על ידי קובץ ג'יגדו, שאליו אתה מוסיף מידע על הכל
השרתים שאליהם אתה הולך להעלות את הקבצים. ג'יגדו יוריד את הקובץ הזה בתור
השלב הראשון של אחזור התמונה.

-t --תבנית=cdrom.template
ציין את המיקום של קובץ 'תבנית' התמונה. קובץ התבנית הוא קובץ בינארי
נוצר באמצעות קובץ ג'יגדו, הוא מכיל מידע כיצד להרכיב מחדש את התמונה ו
גם (בצורה דחוסה) כל הנתונים מהתמונה שלא נמצאו באף אחת מהן
החלקים.

בהתאם לפקודה, כל אחד משלושת הקבצים הללו משמש לפעמים לקלט,
לפעמים לתפוקה. אם הקובץ אמור לשמש לפלט עבור פקודה מסוימת
וקובץ הפלט כבר קיים, קובץ ג'יגדו יוצא עם שגיאה, אלא אם כן --כּוֹחַ
נוכח.

ברוב המקרים, תצטרך לציין רק אחד מתוך -i -j -t, כי כל
שמות קבצים חסרים ייגזרו מהקובץ שתציין. זה נעשה על ידי ראשון
להסיר כל הרחבה מהשם שסופק ואז לא להוסיף כלום (אם
להסיק --תמונה), `.ג'יגדו' או '.תבנית'.

-r --report=default|noprogress|שקט|grep
שליטה באיזו מילה של התוכנית, ואיזה פורמט יש לפלט: אין התקדמות is
אותו הדבר כמו ברירת מחדל אלא שלא מודפסות הודעות התקדמות של 'x% בוצע'. שֶׁקֶט
מגביל את הפלט למה שנחוץ לחלוטין, בעיקר הודעות שגיאה. grep
שונה רק מ ברירת מחדל עבור לעשות-תבנית פקודה: זה מאפשר פלט פנימה
פשוט ` ' פורמט שימושי בעת חיפוש קבצים בינאריים
בקבצים בינאריים אחרים.

-f --כּוֹחַ
החלף קבצי פלט קיימים מבלי להתלונן.

--ללא כוח
זֶה is מה היא ברירת המחדל. סרב להחליף קבצי פלט קיימים.

-c --cache=jigdo-cache.db
קובץ ג'יגדו בדרך כלל צריך לקרוא את כל התוכן של כל קבצים אתה מציין.
אם אתה משתמש בו שוב ושוב (למשל בגלל שאתה הופך תמונת CD חדשה לזמינה מדי יום),
שמירת מידע הקובץ במטמון תגביר את מהירות התוכנית באופן משמעותי. ה
קובץ המטמון נוצר אוטומטית אם הוא עדיין לא קיים. נתונים הם בדרך כלל גם וגם
לקרוא ממנו ולכתוב אליו.

--ללא מטמון
זֶה is מה היא ברירת המחדל. אל תשתמש במטמון.

--cache-expiry=שניות
הגדר את הגיל המרבי של ערכי המטמון. כל ערכים ישנים מזה יוסרו
המטמון. ברירת המחדל היא 30 יום. אתה יכול להוסיף אחת מהאותיות `h', `d', `w',
'm', 'y' לציון שעות, ימים, שבועות, חודשים או שנים, בהתאמה. ערך של
'0' או 'כבוי' משביתים את התפוגה, כך שכל הערכים יישארו במטמון לנצח.
עיין בסעיף 'קבצי מטמון' למטה למידע נוסף.

--readbuffer=בתים
הגדר גודל של מאגרים פנימיים. ברירת המחדל היא 128k - אם יש לך דיסק מהיר,
הגדלת ערך זה עשויה לעשות קובץ ג'יגדו מהר יותר, אבל באופן כללי, לשנות את זה
לא נחוץ.

--md5-block-size=בתים
לא מעניין פנימי פָּרָמֶטֶר. הגדר את גודל הבלוקים שבהם יש קבצים
מחולקת משנה. ברירת המחדל היא 128k. אם תשנה אותו, כל קובץ מטמון יצטרך להיות
התחדש. כְּלַפֵּי פְּנִים, קובץ ג'יגדו עשוי לבחור להשתמש במקצת יותר או קטן יותר
ערך.

-T --files-from=פילה
קרא את שמות הקבצים והספריות מהקובץ שצוין. אם פילה הוא `-', קרא שמות
מקלט רגיל. כל שורה בקובץ נלקחת כשם, כך שהשמות עשויים
מכיל רווחים, אך לא תווים בשורה חדשה. שורה ריקה גורמת קובץ ג'יגדו להפסיק
קריאה מהקובץ.

למצוא(1) הוא כלי רב עוצמה ליצירת רשימות קבצים, אך הקפד להשתמש ב- `למצוא
סוג fאם אפשר - אחרת, אם אתה מורה למצוא לפלט גם שם קובץ
וקישור סימלי לשם הקובץ הזה, קובץ ג'יגדו יקרא את תוכן הקובץ פעמיים.

--הקס פלט סכומי ביקורת בהקסדצימלי במקום בפורמט דמוי Base64. זה לא אמור להיות
משמש עם לעשות-תבנית הפקודה, כי המתקבל `.ג'יגדו' הקובץ מפר
את `.ג'יגדו' פורמט הקובץ. השימוש המיועד שלו הוא לעשות קובץ ג'יגדו יותר פעולה הדדית
עם כלי עזר אחרים של מעטפת יוניקס כמו אני md5(1).

--ללא הקסם
זֶה is מה היא ברירת המחדל. השתמש בקידוד של סכימי ביקורת דמוי Base64 של jigdo.

--debug[=help|=הכל|=UNIT,~UNIT... ]
הפעל או כבה את פלט ניפוי באגים. רק `--debug' שווה ערך ל-`--debug=all'.
הארגומנט הוא רשימה מופרדת בפסיקים של שמות יחידות שעבורן יש פלט ניפוי באגים
להיות מופעל, או מושבת אם לפני השם מופיע `~'. השם המיוחד 'הכל'
פירושו כל היחידות. כברירת מחדל, פלט איתור באגים כבוי למעט היחידות
`assert' ו`כללי'. הרשימה המדויקת של היחידות הזמינות שעבורן ניתן לבצע איתור באגים
להיות מופעל תלוי אם jigdo הידור עם תמיכה באגים - ה
ניתן להדפיס רשימה עם `--debug=help'.

קבצים שמות של קבצים או ספריות לשימוש כקלט. אלו החלקים שכן
הכלולים בתמונה. במקרה שאחד השמות הוא ספרייה, התוכנית
סורק רקורסיבית את הספרייה ומוסיף את כל הקבצים הכלולים בה. תוך כדי עשייה
זאת, הוא עוקב אחר קישורים סימבוליים, אך נמנע מלולאות סימלינקים.

אם אחד משמות הקבצים מתחיל בתו `-', עליך להקדים את הרשימה של
קבצים עם `--'. לערך של `-' יש לא משמעות מיוחדת ברשימה זו, היא מייצגת
קובץ ששמו הוא מקף בודד.

פקודות

שם הפקודה הוא הארגומנט הראשון ללא אפשרות המועבר אליו קובץ ג'יגדו. לרוב הפקודות יש
קיצורים קצרים וכן שמות ארוכים. אל האני קצר הפקודה שמות צריך לֹא be מְשׁוּמָשׁ in
סקריפטים - שם אולי be שאינו עולה בקנה אחד שינויים ל אוֹתָם in מה היא עתיד!

צור תבנית, MT
קורא תמונה ו קבצים, יוצר `.ג'יגדו'ו'.תבנית'. זוהי הפונקציונליות העיקרית של
קובץ ג'יגדו.

אפשר לציין את שניהם --תמונה=- ו --קבצים-מאת=-. במקרה זה, ראשית הרשימה
של קבצים נקרא מקלט רגיל עד שנתקלת בשורה ריקה. הכל
ההנחה היא כי לאחר מכן הם נתוני התמונה. זה יכול להיות שימושי אם אתה משתמש מקיסופס(1) או
תוכניות דומות שיכולות להפיק את התמונה השלמה על הפלט הסטנדרטי שלהן, בגלל
אין צורך לאחסן את התמונה בדיסק באופן זמני.

אם קבצים הארגומנט מכיל את התווים `//' (Unix) או `\.\' (Windows), יש לזה
משמעות מיוחדת. בקובץ ה-jigdo הסופי שהמשתמשים יורידו, כל אחד מהחלקים הוא
מוזכר בקטע `[חלקים]' עם URI בצורת `תווית:כמה/שם קובץ'. (לִרְאוֹת
'פורמט של קבצי JIGDO' להלן לתיאור מפורט.) הסעיף '[שרתים]' נותן
מיפוי של תוויות לשרתים באינטרנט, עם קווים כמו
`תווית=http://myserver.org/jigdofiles/'. באמצעות מידע זה, ג'יגדו תיצור את
URI להורדה סופית עבור החלק, `http://myserver.org/jigdofiles/some/filename'.
ציון `//' (או `\.\') בשם של קובץ או ספרייה משמש ל'חתימת' השמות ב-
רמת הספרייה הנכונה. לדוגמה, אם נתיב יוניקס של אחד שלך קבצים is
`/path/some/filename', אתה יכול לדעת קובץ ג'יגדו לנתק אחרי `/נתיב' על ידי העברתו
הארגומנט `/path//some/filename', או `/path//' אם ברצונך לסרוק את כל הספרייה.
שמות הנתיבים אינם חייבים להיות מוחלטים; גם `somedirectory//' אפשרי.

--תווית תווית=/נתיב
ציין שם שישמש כשם התווית עבור נתיב בדיסק. (משפיע על הפלט
קובץ jigdo.) אם השתמשת ב-// ב- קבצים טיעונים כמתואר לעיל, קובץ ג'יגדו
כברירת מחדל יבחר שמות תוויות באופן אוטומטי ('A', 'B' וכו'). עם אפשרות זו,
אתה יכול לתת לתוויות שמות משמעותיים יותר. שים לב ששם התווית יהיה רק
משמש אם אחד או יותר קבצים התחל עם `/path//'.

נסה להשתמש בשמות תוויות שמתחילים באותיות רישיות, כדי לבלבל אותם
ברור משמות פרוטוקולים כמו `http', `ftp'.

--ורי תווית=http://some.server.org/
כברירת מחדל, באמצעות --תווית כפי שתואר לעיל יגרום לשורות של הטופס
`תווית=קובץ:/נתיב/' להיכתב לקטע `[שרתים]' של ג'יגדו הפלט
קוֹבֶץ. אם אתה רוצה לעקוף את ה-URI של `file:' כך שהשורה תיקרא
`תווית=http://some.server.org/', אתה יכול לעשות זאת על ידי ציון --ורי יחד עם
--תווית. נותן רק --ורי תווית=... ללא המקביל --תווית תווית=...
אין השפעה, וגם אם תציין את שניהם, ערך נוסף רק ל-
סעיף `[שרתים]' אם התווית מופנית על ידי רשומת `[חלקים]' אחת לפחות.

הערך המסופק אינו מצוטט על ידי התוכנית; אם הוא מכיל תווים כגון
רווח או כל אחד מהתווים #"'\ אז אתה חייב לצטט אותו. (תחת Unix, אתה יכול
צריך לצטט את הערך פעמיים כדי להגן עליו גם מהקליפה, למשל \\\\ או '\\'
כדי לקבל קו נטוי בודד ב-URI.)

המיפוי שצוין עם an --ורי מתעלמים מהאפשרות אם היא כבר קיימת ב
קובץ ה-Jigdo הפלט.

משתמשים בגרסת Windows עשויים לשים לב שמפרידי הספריות `\' הם
הומר ל- `/' ב-URI של `file:' שנוצרים כברירת מחדל. זה גמור
כדי להגביר את התאימות בין הפלטפורמות של `file:' - ה חסר הדפס פקודה של
גרסת Windows תמיר אוטומטית מחדש את התווים כאשר היא מדפיסה את
URIs. במקרה שאתה מספק 'קובץ:' URI משלך תחת Windows באמצעות --ורי, אתה חייב
החלף גם את `/' ו- `\'.

-0 ל -9
הגדר את כמות הדחיסה בקובץ תבנית הפלט, מ -0 (ללא דחיסה) ל
-9 (דחיסה מקסימלית). ברירת המחדל היא -9, שיכול להפוך את יצירת התבנית
די איטי. כברירת מחדל, אלגוריתם הדחיסה בשימוש זהה לזה של מופעלת דחיסת(1).

--gzip ו --bzip2
בחר בין אלגוריתמי הדחיסה gzip ו-bzip2. ברירת המחדל היא gzip.
Bzip2 בדרך כלל נותן יחס דחיסה טוב יותר, אבל הדחיסה היא משמעותית
איטי יותר מאשר עם gzip.

--min-length=בתים
הגדר אורך מינימלי של חלק עבור קובץ ג'יגדו לחפש אותו בתמונה. ה
ברירת המחדל היא 1k. חלקים קטנים מזה לעולם לא יימצאו בתמונה, אז שלהם
הנתונים ייכללו בקובץ התבנית. אלגוריתם החיפוש המשמש דורש כזה
אורך מינימלי, אחרת יצירת תבניות עשויה להיות אטית ביותר. אם אתה
יודע בוודאות שכל שלך קבצים הם גדולים מכמות מסוימת, אתה יכול
להגביר קובץ ג'יגדוהמהירות של מעט על ידי ציון הכמות עם אפשרות זו.
יש מינימום קשיח של 256 בתים - כל דבר נמוך יותר יעשה זאת בשקט
להיות מוגדר ל-256.

--מיזוג=קובץ
כלול את התוכן של קובץ בפלט `.ג'יגדו'קובץ. הקובץ יכול להכיל נתונים
שברצונך להוסיף לפלט (לדוגמה, קטע `[שרתים]' עם רשימה
של השרתים שלך כערכים), או שזה יכול להיות פלט קובץ ה-jigdo בהפעלה קודמת
of קובץ ג'יגדו.

אפשר לציין את אותו קובץ לקלט איתו --לְמַזֵג ולפלט עם
--ג'יגדו. עם זאת, תצטרך גם להשתמש --כּוֹחַ כדי לגרום לתוכנית לדרוס
הגרסה הישנה של קובץ ה-jigdo עם הגרסה החדשה. קובץ יכול להיות '-' עבור תקן
קֶלֶט.

מתי מוסיף מידע חדש לקובץ שסופק, קובץ ג'יגדו לא יכניס חדש
שורות לתוך הקטע '[חלקים]' אם ערך עבור אותו סכום ביקורת MD5 (אבל לא
בהכרח עם אותו URI!) כבר קיים, והוא לא יכניס שורות חדשות
למקטע `[שרתים]' אם כבר קיים ערך זהה לחלוטין.

מתי קריאה in הקיימת קובץ, ההתנהגות מעט שונה: התוכנית
משמר ערכים בקטע `[חלקים]' עם סכום ביקורת זהה, אך שונה
URIs. עבור ערכים זהים לחלוטין (אותו סכום בדיקה ו-URI), רק ערך אחד הוא
נשמר והכפילויות מוסרות. הקטע '[שרתים]' נשאר
ללא נגע.

--קטע תמונה
זֶה is מה היא ברירת המחדל. סיבות קובץ ג'יגדו כדי להוסיף קטע `[תמונה]' ל-`.ג'יגדו'
קובץ.

כחריג, קטע `[תמונה]' חדש הוא לֹא נוסף אם אתה משתמש --לְמַזֵג ו
הקובץ למיזוג מכיל קטע '[תמונה]' עם שורה שקוראת 'תבנית-
MD5Sum=' (סוף השורה אחרי ה-'='). במקרה זה, נתוני התבנית שנוצרו
ערך הבדיקה של MD5 פשוט מתווסף אחרי ה-'=' של השורה הראשונה של טופס זה
הקובץ - אין קטע `[תמונה]' חדש לגמרי מצורף. התנהגות זו שימושית
כי זה מאפשר לך לעבור דרך --לְמַזֵג קטע `[תמונה]' עם קטע שרירותי
תוכן ולאחר מכן להוסיף את סכום הבדיקה של MD5 באופן אוטומטי על ידי קובץ ג'יגדו. ה
סעיף 'פורמט של קבצי JIGDO' להלן מסביר את תוכן הקטע '[תמונה]' ב
בפירוט רב יותר.

--קטע ללא תמונה
Do לֹא כלול קטע `[תמונה]' ב-`.ג'יגדו'קובץ. אתה צריך להוסיף אחד
את עצמך אם אתה משתמש באפשרות זו. עם זאת, לעשות את זה לא קל (אתה גם צריך
הוסף שורת 'Template-MD5Sum' עם סכום הבדיקה הנכון, או ג'יגדו יתלונן), אז
השימוש באפשרות זו אינו מעודד.

--מדור-שרתים
זֶה is מה היא ברירת המחדל. סיבות קובץ ג'יגדו כדי להוסיף קטע `[שרתים]' ל-`.ג'יגדו'
קוֹבֶץ. סעיף ברירת מחדל זה משתמש ב-URI של 'קובץ:', המאפשר הרכבה מיידית מחדש
של התמונה ממערכת הקבצים המקומית, והוא שימושי גם אם ברצונך לערוך את
קובץ ידני והחלף את ה-URI של `file:' ב-URI אחרים.

--מדור ללא שרתים
Do לֹא הוסף קטע `[שרתים]' בסוף ה-`.ג'יגדו'קובץ. שימושי למשל אם
אתה הולך לצרף את הקטע עם סקריפט.

--match-exec=SHELLCOMMAND
בכל פעם שנמצא קובץ בתמונה, בצע את מחרוזת הפקודה שסופקה על ידי
להעביר אותו לקליפה. קובץ ג'יגדו מגדיר מספר משתני סביבה עם
מידע על התאמת הקובץ. לדוגמה, אם הקובץ `/path//a/b/file' היה
נמצא בתמונה ו- `Label:a/b/file' ייכתב אל `.ג'יגדו'
קובץ:

· LABEL="Label" - שם התווית עבור הקובץ. הדוגמה מניחה ש`--תווית
Label=/path' צוין על ידך. בהיעדר אפשרות כזו, LABEL יצטרך
להיות מוגדר אך ריק.

· LABELPATH="/path/" - הנתיב המתאים לתווית, או במילים אחרות, ה-
קידומת של נתיב הקובץ המותאם שתעשה זאת לֹא מופיעים בפלט `.ג'יגדו'
קוֹבֶץ. מוגדר גם ללא כל `--תוויתאפשרות קיימת. מסתיים בקו נטוי.

· MATCHPATH="a/b/" - שאר הנתיב, ללא שם העלה של התואם
קוֹבֶץ. הוא ריק או מסתיים בקו נטוי.

· עלה="file" - שם העלה של הקובץ המותאם.

· MD5SUM="lNVdUSqbo2yqm33webrhnw" - ה-md5sum של הקובץ המותאם, בדומה ל-Base64
פורמט.

· קובץ="/path//a/b/file" - מטעמי נוחות, הנתיב המלא של הקובץ. ה
המשתנה תמיד מוגדר ל-$LABELPATH$MATCHPATH$LEAF.

אנא היזהר לצטט נכון את המחרוזת שהועברה לאפשרות זו, אחרת שלך
הפקודה שסופקה לא תעבוד עם שמות קבצים המכילים רווחים. כדוגמה, ל
צור גיבוי של קישורים קשיחים לקבצים התואמים, השתמש באפשרות הבאה: --match-
exec='mkdir -p "${LABEL:-.}/$MATCHPATH" && ln -f "$FILE" "${LABEL:-.}/$MATCHPATH$LEAF"'

כברירת מחדל, לא מבוצעת פקודה. השתמש ב--match-exec="" כדי להסיר מחרוזת פקודה אשר
הוגדר עם שימוש מוקדם יותר באפשרות זו.

--תאוות בצע
זֶה is מה היא ברירת המחדל. תאר לעצמך שהתמונה שלך מכילה א .זֶפֶת קובץ אשר בתורו
מכיל קובץ נוסף x, וכי אתה מספק את שניהם .זֶפֶת והקבצים שבתוכו
בשורת הפקודה. מתי קובץ ג'יגדו סורק את התמונה, הוא נתקל בהתחלה
של .זֶפֶת קובץ, ולאחר מכן הקובץ x.

בשלב זה יש להחליט: האם התיק הקטן יותר x להירשם כ
תואם, או שיש להתעלם ממנו לטובת ההתאמה הגדולה יותר (ולכן טובה יותר) של
מה היא .זֶפֶת קוֹבֶץ? למרבה הצער, בשלב זה לא ברור אם כן
למעשה להיות התאמה מלאה של .זֶפֶת, אז כברירת מחדל, התוכנית מעדיפה את הקטן
להתאים.

--לא-חמדן-התאמה
במקרה בו קיימת התאמה חלקית גדולה והייתה התאמה קצרה יותר
אישר, התעלם מההתאמה הקטנה. (ראה את האפשרות למעלה.)

עשה-תמונה, MI
קורא `.תבנית'ו קבצים, יוצר תמונה (או `imagename.tmp'). מספק בסיס ראשוני
דרך להרכיב תמונות מחדש - ג'יגדו בדרך כלל מתאים יותר למשימה זו. עם זאת, ב
בניגוד ל ג'יגדו, לא `.ג'יגדוקובץ ' נדרש.

אם התמונה אמורה להיכתב לקובץ (ולא לפלט סטנדרטי), אפשר
צור את התמונה בכמה שלבים, עם כמה קריאות של `קובץ ג'יגדו לעשות-תמונה', כפי ש
כדלקמן: אתה קורא לראשונה קובץ ג'יגדו, תוך ציון קבצים רבים ככל הזמינים כאן
זְמַן. התוכנית סורקת את הקבצים, ואלה הכלולים בתמונה מועתקים אליהם
קובץ זמני, ששמו נוצר על ידי הוספה של `.tmp' לשם קובץ התמונה.

עבור כל הקבצים הנוספים שיכולים להיות חלקים מהתמונה, אתה חוזר על תהליך זה. בהקדם
מכיוון שכל החלקים קיימים, הקובץ הזמני יקוצץ מעט (כדי למחוק חלק
נתונים מנהליים כי קובץ ג'יגדו מצורף בסוף) ושם שונה לתמונה הסופית
שֵׁם. האפשרות להרכיב מחדש את התמונה במספר שלבים שימושית במיוחד עבור
איסוף קבצים ממדיה נשלפת, למשל מספר תקליטורים ישנים יותר.

סקריפטים באמצעות לעשות-תמונה יכול לזהות אם יצירת התמונה הושלמה על ידי סימון ה-
סטטוס יציאה: 0 מסמן יצירה מוצלחת, בעוד ש-1 אומר שצריך להיות יותר קבצים
מסופק. שגיאות אחרות גורמות למצב יציאה של 2 ('ניתן לשחזר', למשל הקובץ לא נמצא)
או 3 (לא ניתן לשחזור, למשל שגיאת כתיבה).

--צ'ק-קבצים
זֶה is מה היא ברירת המחדל. בכל פעם שחלק כלשהו מועתק לתמונה, בדוק אותה מחדש
סכום בדיקה מול סכום הבדיקה המאוחסן בתבנית. מומלץ לך
השאר את זה מופעל, גם אם זה מאט מעט את יצירת התמונה.

--ללא בדיקת קבצים
אל תבדוק את סיכומי הבדיקה של הקבצים בעת העתקתם לתמונה. זה יכול להיות בבטחה
משמש כאשר לא נעשה שימוש בקובץ מטמון (מה שאומר שקבצים ייכתבו ל-
תמונה מיד לאחר סריקה) או שכל התמונה נבדקת מאוחר יותר עם
לאמת פקודה.

חסר הדפסה, PM
קורא `.ג'יגדו', `.תבנית' ו (אם קיים) 'imagename.tmp', מוציא רשימה של URIs עדיין
נדרש כדי להרכיב מחדש את התמונה לחלוטין.

ביחד עם ה לעשות-תמונה הפקודה, זה מספק את רוב הפונקציונליות של ג'יגדו on
שורת הפקודה.

עבור כל חלק שעדיין לא קיים בקובץ התמונה הזמני, סכום הבדיקה של הקובץ הוא
חפש בקטע '[חלקים]' של קובץ ה-jigdo. כל תווית בערך המתאים
לאחר מכן מורחב בהתאם להגדרות התווית בסעיף `[שרתים]' ומודפס
על פלט סטנדרטי. ג'יגדו מאפשר לך לציין מספר מיקומים חלופיים עבור כל אחד מהם
תווית בסעיף זה, אבל חסר הדפס יוציא רק את הראשון עבור כל חסר
חֵלֶק.

אם לא ניתן למצוא את סכום הבדיקה בקטע `[חלקים]' (זה לא אמור לקרות אלא אם כן
מחקת את הקטע הזה), במקום נעשה חיפוש עבור `MD5Sum:', בדיוק כמו
עם ג'יגדו. (לכן, אם אתה רוצה להיפטר מקטע '[חלקים]', אתה יכול לעשות זאת אם אתה
שנה את שם כל חלק לסכום ביקורת משלו.)

--ורי תווית=http://some.server.org/
עוקף את הערכים ב- `.ג'יגדו' עבור כל תווית עם URI לבחירתך.
עם הדוגמה שלמעלה, ערך '[חלקים]' של 'תווית:כמה/שם קובץ' יגרום ל-
שורה `http://some.server.org/some/filename' להדפיס.

הערך המסופק אינו מצוטט על ידי התוכנית; אם הוא מכיל תווים כגון
רווח או כל אחד מהתווים #"'\ אז אתה חייב לצטט אותו. (תחת Unix, אתה יכול
צריך לצטט את הערך פעמיים כדי להגן עליו גם מהקליפה, למשל \\\\ או '\\'
כדי לקבל קו נטוי בודד ב-URI.)

הדפס-חסר-הכל, PMA
בדיוק כמו חסר הדפס, פקודה זו מפיקה רשימה של URIs שעדיין נדרשים לחלוטין
להרכיב את התמונה מחדש. למרות זאת, את כל מיקומי הורדה חלופיים מודפסים במקום
רק אחד. בפלט, ה-URI של קובץ מופרדים מ-URI של קבצים אחרים עם
שורות ריקות. ה --ורי לאופציה יש את אותה השפעה כמו ל חסר הדפס.

תאשר, VER
קורא תמונה (ככל הנראה נוצר עם לעשות-תמונה) ו`.תבנית', בודק נכון
סכום בדיקה של התמונה.

נתוני התבנית אינם מכילים רק סיכומי ביקורת של החלקים הבודדים, אלא גם של
התמונה בכללותה. לעשות-תמונה כבר מבצע מספר בדיקות פנימיות, אבל אם אתה
כמו, אתה יכול בנוסף לבדוק את התמונה עם הפקודה הזו.

לִסְרוֹק, SC
קורא את כל קבצים ומכניס אותם למטמון, אלא אם כן הם כבר מאוחסנים. ה
--מטמון האפשרות חייבת להיות קיימת עבור פקודה זו.

--ללא סריקה של כל הקובץ
זֶה is מה היא ברירת המחדל. זה רק גורם לראשון ---md5-block-size בתים של כל קובץ
להיקרא. אם המטמון משמש מאוחר יותר על ידי קובץ ג'יגדו לעשות-תמונה, שאר ה
הקובץ ייקרא ברגע שהבתים הראשונים הללו יזוהו בתמונת הקלט.

--סרוק את כל הקובץ
קרא מיד את כל תוכן הקובץ ואחסן אותם במטמון.

MD5SUM, MD5
קורא את כל קבצים ומדפיס סכומי בדיקה MD5 של תוכנם. הפקודה הזו די
דומה אני md5(1), אלא שסכום הבדיקה מופק בקידוד דמוי Base64 אשר
משמש גם במקומות אחרים על ידי קובץ ג'יגדו.

אל האני קבצים ארגומנטים מעובדים באותו אופן כמו עם הפקודות האחרות, כלומר
רקורסיה מתרחשת אוטומטית עבור כל ארגומנטים שהם ספריות, וזה
קישורים סמליים אינם רשומים אלא כאשר הקבצים שהם מצביעים עליהם אינם נגישים
באופן ישיר.

ברשימת הסכמים המודפסת על פלט רגיל, רק החלק של שם הקובץ הבא
כל `//' (או `\.\' ב-Windows) מודפס. כל --מטמון ישמש לשאילתת קבצים'
סכומי ביקורת MD5 ו/או כתיבת סכומי ביקורת של קבצים סרוקים.

תבנית רשימה, LS
קורא `.תבנית' קובץ ומוציא מידע ברמה נמוכה על התמונה ועל כל החלקים
הכלולים בו, לרבות קיזוז, אורך וסכום ביקורת.

אתה יכול גם להשתמש בפקודה זו עם קבצי תמונה זמניים (על ידי ציון משהו כמו
--template=imagename.tmp) - במקרה כזה, הפלט גם מבדיל בין חלקים ש
נכתבו לתמונה וחלקים שלא.

פורמט הפלט המדויק עשוי להשתנות באופן לא תואם בין גרסאות ג'יגדו שונות. ה
ניתן להפיק פלט בעקבות סוגים שונים של קווים. `have-file' מופיע רק עבור `.tmp'
קבצים, המציינים קובץ שכבר נכתב בהצלחה לקובץ הזמני:

בתבנית היסט בתמונה אורך
צריך-קובץ היסט בתמונה אורך file-md5sum filestart-rsyncsum
יש-קובץ היסט בתמונה אורך file-md5sum filestart-rsyncsum
מידע-תמונה אורך תמונה image-md5sum rsyncsum-size

פרטים

Jigsaw Download נוצרה עם הפורמט של תמונות CD ISO9660 בחשבון - עם זאת, ה
הבא חל גם על פורמטים רבים אחרים של מערכת קבצים, כמו גם על 'tar' ארכיונים ו
ארכיוני 'zip' לא דחוסים. תמונת CD מכילה גם מידע לארגון
מערכת קבצים (כותרת עם שם דיסק וכו', נתוני ספריית ISO9660, נתונים של הרחבות כגון
Joliet או RockRidge, אפס ריפוד) והקבצים הכלולים בתקליטור. חשוב
המאפיין ש-jigdo מסתמך עליו הוא שכל קובץ מאוחסן בקטע אחד רציף של ה-
תמונה; הוא אינו מפוצל לשני חלקים או יותר.

מתי קובץ ג'יגדו ניתנת למספר קבצים שעשויים להיות כלולים בתמונה, הוא מזהה
האם כל אחד מהקבצים קיים באמצעות ` בדיקה מתגלגלת' בהשראת הקבצים שבהם נעשה שימוש
by rsync(1). הנתונים המתקבלים נכתבים ל- `.תבנית' קובץ: אם קטע של
לא ניתן היה להתאים תמונה (למשל זה היה מידע ספרייה), הנתונים דחוסים ו
נכתב ישירות לתבנית. עם זאת, אם נמצא קובץ תואם, הנתונים שלו כן
הושמט מהתבנית. במקום זאת, רק הפניה (סכום ביקורת MD5 של הקובץ).
הוכנס לתבנית.

שימו לב שנתוני התבנית מכילים רק נתונים בינאריים, הם אינם מכילים שמות קבצים כלשהם
או URIs, מכיוון שלא ניתן לערוך אותם בקלות במקרה של שינוי אחד מהערכים הללו.
כל המידע הזה מאוחסן ב- `.ג'יגדוקובץ ', קובץ טקסט שאליו ניתן להוסיף כתובות URL
עבור השרתים שלך. קובץ ה-jigdo מספק מיפוי עבור כל בדיקת MD5 לאחד או יותר
מיקומי הורדה חלופיים עבור החלק המתאים.

מלבד מיפוי של סכומי MD5 ל-URI, קובץ ה-jigdo מכיל גם מצביע URI
למיקום הורדה של קובץ התבנית. בדרך זו, ה ג'יגדו צריך רק כלי הורדה
לתת URI אחד (זה של `.ג'יגדו' קובץ) כדי להיות מסוגל להוריד ולהרכיב מחדש את
תמונה שלמה.

פורמט OF .JIGDO קבצים

הפורמט הכולל של `.ג'יגדוקבצי ' עוקבים אחר זה של `. ראשוני' קבצים, כפי שמשמשים גם את
פרויקטים של Gnome ו-KDE עבור נתונים מסוימים. הקובץ מאורגן לחלקים, שכל אחד מהם
מקדימה שורה שקוראת '[שם סעיף]'. בתוך כל מקטע, שורות יש את הטופס
`תווית=ערך'. שורות כאלה נקראות גם 'כניסות' למטה. הכל `.ג'יגדו' קבצים משתמשים ב-UTF-8 כ
קידוד התווים שלהם.

הערות מוצגות עם התו '#' ומתארכות עד סוף השורה.
מתעלמים מרווח לבן בהתחלה ובסוף השורה וכן משמאל ומימין לקטע
שמות וה-'=' בערכים. יתר על כן, כלי השירות של Jigdo פיצלו את הטקסט של ה-
ערך הזנה (כלומר החלק שאחרי ה- `=') למילים מופרדות ברווח לבן, בדומה ל-
מעטפת יוניקס. ניתן להשתמש במרכאות בודדות '' וכפולות "" כדי למנוע זאת, למשל URIs
המכילים רווח לבן מפוצלים. באופן דומה, דמויות בעלות משמעות מיוחדת (ה
התווים '"#\ ורווח/טאב) חייבים להיות במרכאות עם \ כדי להופיע בערך. כמו ב-
shell, יש הבדל בין ' ' לבין " ": בתוך ' ', התווים "#\ ו
רווח לבן מאבד את המשמעות המיוחדת שלהם והופכים לדמויות רגילות, בעוד שבתוך " ",
רק התווים '# והרווח הלבן מאבדים את המשמעות המיוחדת שלהם - במילים אחרות,
escapes לאחור עדיין פועלות בתוך " ", אבל לא ' '.

`.ג'יגדוניתן לדחוס איתם קבצים באופן אופציונלי מופעלת דחיסת(1). קובץ ג'יגדו תמיד פלטים
קבצים לא דחוסים, שתוכלו לדחוס בעצמכם. ג'יגדו-לייט תומך בסינגל
קבצים לא דחוסים ודחוסים.

(התנהגות שעשויה להשתנות בעתיד ושאין להסתמך עליה: ג'יגדו
תומך בנוסף בכל מספר של טקסט רגיל וחלקים משורשרים בקבצים
- לדוגמה, אתה יכול לדחוס a `.ג'יגדו' ולאחר מכן הוסף כמה שורות של
נתונים לא דחוסים עד הסוף.)

בכל המקרים, ה- `.gzיש להסיר את הסיומת ' משם הקובץ - הכלים יעשו זאת
לקבוע אוטומטית מתוכן הקובץ אם קובץ דחוס או לא.

להלן תיאור של שמות הקטעים הבודדים שבהם השתמש jigdo.

JIGDO SECTION
[ג'יגדו]
גרסה = 1.1
Generator=jigdo-file/1.0.0

מידע על הגרסה של פורמט הקובץ jigdo בשימוש, והתוכנית ש
יצר את זה. צריך להיות סעיף אחד כזה לכל `.ג'יגדוקובץ.

תמונה SECTION
[תמונה]
שם קובץ="שם קובץ ל חסכת on של המשתמש דיסק "
תבנית="URI איפה ל לְהָבִיא תבנית קוֹבֶץ"
Template-MD5Sum=OQ8riqT1BuyzsrT9964A7g
ShortInfo=חד-פעמי תיאור of מה היא תמונה (200 תווים מקסימום)
מידע=ארוך תיאור (5000 תווים מקסימום)

הערך עבור הערך 'תבנית' יכול להיות כתובת URL (אבסולוטית או יחסית לכתובת ה-URL
של קובץ ה-jigdo) או מחרוזת של הטופס `תווית:שם נתיב'(לא מיושם), כפי שתואר
לְהַלָן.

הערך 'Template-MD5Sum' נוסף על ידי קובץ ג'יגדו ומציין את סכום הבדיקה של MD5 של
נוצר `.תבנית'קובץ. הוא משמש על ידי ג'יגדו כדי לזהות מקרים שבהם הורד
נתוני התבנית פגומים או שייכים לתמונה אחרת.

בניגוד לערכי ערכים אחרים, הערכים של הערכים 'ShortInfo' ו-'Info' הם לֹא לפצל
למעלה למילים, במקום זאת כל הציטוטים נשמרים.

הערך של הערך 'מידע' מיוחד בכך ג'יגדו(1) יכול לנתח סימון XML באופן אופציונלי
זה מכיל. אם ב-smart יש שגיאות כגון תגים לא מאוזנים/לא נתמכים, המחרוזת היא
מוצג פשוטו כמשמעו, ללא ניתוח XML. תגים נתמכים הם (נוֹעָז),
(נטה), (גופן במכונת כתיבה), (לָשִׂים דָגֵשׁ), (גופן גדול יותר),
(גופן קטן יותר) ו (שובר שורה). הישויות הנתמכות כוללות <
(`<'), > (`>') ו-& (`&'). שים לב שכל הערך 'מידע' חייב להיות בשורה אחת פנימה
קובץ ה-jigdo.

חלק זה עשוי להתרחש מספר פעמים, אך כולם פרט לראשון יתעלמו. זֶה
שימושי למשל בעת יצירת `.ג'יגדו' עבור תמונת DVD כשכבר יש לך
`.ג'יגדו' קבצים עבור תקליטורים עם אותו תוכן: אתה יכול פשוט '[כלול]' (ראה להלן) את
קובצי ה-Jigdo של תקליטורים בסוף קובץ ה-DVD Jigdo, אחרי הקטע '[תמונה]' שלו.

חלקים SECTION
[חלקים]
xJNkjrq8NYMraeGavUpllw=LabelA:part0
GoTResP2EC6Lb_2wTsqOoQ=LabelA:part1
kyfebwu6clbYqqWUdFIyaw=LabelB:some/path/part2
-J9UAimo0Bqg9c0oOXI1mQ=http://some.where.com/part3

לכל השורות בקטע, המספק את המיפוי מסכימי בדיקה של MD5 ל-URI, יש את
אותו פורמט: בצד שמאל של '=' סכום הבדיקה (מקודד עם Base64 like
קידוד) ניתן, ומצד ימין מחרוזת המתאימה לחלק עם זה
Checksum; או URI שלם או מחרוזת של הטופס `תווית:שם נתיב', כלומר
מורחב ל-URI אחד או יותר על ידי חיפוש ההגדרות של ה- תווית ב
סעיף '[שרתים]'.

במקרה שלא ניתן למצוא סכום בדיקה מסוים של MD5 בקטע `[חלקים]' כלשהו של ג'יגדו, ה
התוכנית תבצע חיפוש עבור `MD5Sum:', למשל עבור
`MD5Sum:xJNkjrq8NYMraeGavUpllw' אם מחקת את השורה עבור `part0' למעלה.

סכום בדיקה המופיע מספר פעמים בסעיף זה מציין הורדה חלופית
מיקומים עבור החלק.

ייתכן שיהיו כל מספר של מקטעי `[חלקים]' בקובץ; כולם נחשבים מתי
מחפש סכימי בדיקה של MD5.

קובץ ג'יגדו תמיד שם את הקטע '[חלקים]' בסוף הקובץ, וזה אפילו
מסדר מחדש כל קובץ שצוין עם --לְמַזֵג שיהיה רק ​​סעיף אחד כזה בסוף. זֶה
נעשה כדי לאפשר ג'יגדו כדי להציג את המידע מקטע `[תמונה]' תוך כדי
שאר הקובץ עדיין בהורדה.

שרתים SECTION
[שרתים]
LabelA=http://myserver.org/
LabelA=ftp://mirror.myserver.org/
LabelB=LabelC:subdirectory/
LabelC=http://some.where.com/jigdo/

כל השורות בקטע, המספק את המיפוי מתוויות שרת לשרת
מיקומים, בעלי אותו פורמט: בצד שמאל של ה- `=' ניתן שם התווית, ו
בצד ימין הערך שאליו יש להרחיב את שם התווית.

שם תווית המופיע מספר פעמים בסעיף זה מציין הורדה חלופית
מיקומים של החלקים המשתמשים בתווית בקטע `[חלקים]'. סימון זה עושה
קל מאוד להוסיף מראות לקובץ ה-jigdo.

כפי שמוצג בדוגמה למעלה, ערכי התווית עשויים להתייחס בעצמם לתוויות אחרות. ב
במקרה זה, הערך `LabelB:some/path/part2' בקטע `[Parts]' יתרחב ל-
`http://some.where.com/jigdo/subdirectory/some/path/part2'. לולאות בתווית
הגדרות גורמות להתנהגות לא מוגדרת ויש להימנע מהן.

ייתכן שיהיו כל מספר של קטעי `[שרתים]' בקובץ; כולם נחשבים מתי
מחפש תוויות. ניתן להשמיט כל אחד מ'[חלקים]' או '[שרתים]', אך לא את שניהם.
קובץ ה-jigdo.

איך SECTION
[תגובה]
כל טקסט, פרט לכך שאסור לשורות להתחיל ב-['.

מתעלמים מכל הטקסט העוקב אחר שורת `[הערה]' או `[הערה]', עד לשורה הבאה עם
תווית מדור.

לִכלוֹל הוֹרָאָה
[לִכלוֹל http://some.url/file.jigdo]

שורות של טופס זה גורמות להורדת התוכן של קובץ ה-jigdo שצוין
מנותח בדיוק כמו קובץ ה-jigdo הראשי. ההשפעה תהיה זהה להעתקת הכלול
תוכן הקובץ לתוך הקובץ המכיל את הוראת include. (חריג: כל
כתובות URL יחסיות תמיד נפתרות באמצעות כתובת האתר של ה- `.ג'יגדו' קובץ שמכיל את זה
כתובת URL יחסית.)

ארגומנט ה-URL יכול להיות כתובת URL מוחלטת או יחסית. ההנחה היא שכתובות URL יחסיות
יחסית לכתובת ה-URL של קובץ ה-jigdo המכיל את הוראת include. כולל פחית
להיות מקונן, אבל זו שגיאה ליצור לולאה של הנחיות כולל. זה לֹא אפשרי
להשתמש בכתובות URL של הטופס `תווית:שם נתיב'.

לא ניתן לצטט את כתובת האתר עם "". כל תווי `]' בארגומנט חייב להיות escape as
`%5D', וכל רווחים בתור `%20'.

הנחיות כלול נתמכות רק על ידי ג'יגדו, הם מתעלמים על ידי ג'יגדו-לייט.

הוראת include מסיימת כל סעיף קודם, אבל היא לא מתחילה קטע חדש. ב
במילים אחרות, תמיד יש להתחיל קטע חדש אחרי שורת ה-include, ג'יגדו לא
אפשר לערכים רגילים להופיע מתחת ל-'[כלול]'.

CACHE קבצים

כל קובץ שצוין עם ה --מטמון אפשרות משמשת לאחסון מידע על קבצים
הוצג ל קובץ ג'יגדו. בעת שאילתת המטמון, קובץ נחשב ללא שינוי (ואת
נעשה שימוש בנתונים במטמון) רק אם שם הקובץ, גודל הקובץ וזמן השינוי האחרון (mtime) תואמים
בְּדִיוּק. עבור התאמת שם הקובץ, לא נעשה שימוש בשם הקובץ כולו, אלא רק בחלק
לאחר כל `//', כך שכל שינוי בחלק שלפני ה-`//' לא יבטל את התוקף
המטמון.

ערכי מטמון ישנים מוסרים מהמטמון אם לא נקראו או נכתבו אליהם
למשך הזמן שצוין עם --cache-expiry. ערכים הם לֹא הוסר מיד
מהמטמון אם הקובץ שהם מתייחסים אליו כבר לא קיים - זה מאפשר
מטמון מידע על קבצים במדיה נשלפת.

תפוגת המטמון מתבצעת רק לאחר קובץ ג'יגדו עשה את העבודה העיקרית שלו - אם יש ערכים ישנים
נגישים לפני שתפוג תוקף מתרחש, הם יישמרו. לדוגמה, אם התוכנית היא
הפעלה באמצעות זמן התפוגה המוגדר כברירת מחדל של 30 יום, אך ניגש לקובץ מטמון עם ערכים
נוצר לפני חודשיים, ואז ערכים במטמון זה יצטרך להיחשב, ורק אלה
פג תוקפם של ערכי מטמון שלא היו נחוצים במהלך הפעלת התוכנית.

בשל המוזרות של ספריית מסד הנתונים הבסיסית (libdb3), קבצי מטמון לעולם אינם
להתכווץ, הם רק גדלים. אם פג תוקף מספר רב של ערכים מקובץ המטמון שלך ו
אתה רוצה שהוא יתכווץ, אתה יכול פשוט למחוק אותו (כמובן אז הכל יהיה
לחידוש) או השתמש בכלי השירות הנלווים ל-libdb3 כדי להטיל ולשחזר את
מסד נתונים, עם פקודה כמו `db3_dump old-cache.db | db3_load new-cache.db'. עבור דביאן,
תוכניות אלה מסופקות בחבילה `libdb3-util'.

אם שונה ---md5-block-size צוין, יש לקרוא מחדש את הקובץ כולו
עדכן את ערך המטמון שלו. אם שונה -- אורך דקות מצוין, רק הראשון
יש לקרוא מחדש בתים של 'md5-block-size' של הקובץ.

דוגמאות

מכין שֶׁלְךָ CD תמונה עבור התפלגות
יצרת תמונת CD `image.iso' מחלק מהקבצים המאוחסנים בספרייה
`/home/ftp' בדיסק הקשיח שלך, שזמין גם באינטרנט בשם 'ftp://mysite.org'. כפי ש
אינך רוצה לבזבז מקום על ידי אירוח יעיל של אותם נתונים פעמיים (פעם אחת כקבצים על
שרת ה-FTP, פעם אחת בתוך התמונה), ונמאס לך שההורדות של המשתמשים מבוטלות
לאחר 200MB והפעלתם מחדש את ההורדה עשרות פעמים, אתה מחליט להשתמש ב-jigdo.
איך מכינים את התמונה להורדה?

למעשה, יש צורך בפקודה אחת בלבד:

קובץ ג'יגדו לעשות-תבנית --image=image.iso --jigdo=/home/ftp/image.jigdo
--template=/home/ftp/image.template /home/ftp// --תווית Mysite=/home/ftp --ורי
Mysite=ftp://mysite.org/

אנשים יכולים עכשיו להצביע ג'יגדו ב`ftp://mysite.org/image.jigdoכדי להוריד את התמונה שלך. ה
קובץ התבנית צריך להיות נגיש בתור `ftp://mysite.org/image.template'.

שים לב ששום דבר לא מונע ממך לעשות את אותו הדבר עבור שרת FTP שלא
מנוהל על ידך - במקרה כזה, אתה רק צריך לארח את `.ג'יגדו'ו'.תבנית'
קבצים בשרת/דף הבית שלך.

מכין AN שרירותי גדול קובץ עבור התפלגות
אנו מניחים שיש לך קובץ גדול שאינו מערכת קבצים, למשל `movie.mpeg'. כי
של בעיות מקום, אתה רוצה להפיץ את הנתונים בשני שרתים.

במקרה זה, חלקי התמונה צריכים להיווצר באופן מלאכותי עם לפצל
פקודה. לדוגמה, כדי ליצור נתחים של 4MB כל אחד, השתמש ב- `לפצל -b 4m movie.mpeg חלק'.
העתק את הקבצים המתקבלים `חלקXX'לשתי ספריות'1'ו'2' שאתה יוצר,
לפי איך שאתה רוצה שהקבצים יפוזרו בין השרתים. לאחר מכן, צור את
קבצי ג'יגדו ותבנית עם `קובץ ג'יגדו לעשות-תבנית --image=movie.mpeg 1 // 2 //'. אתה
יצטרך לערוך את ה-`.ג'יגדו' וספק את ה-URI הנכונים עבור שני השרתים
אתה הולך להעלות את ה-`חלקXX' קבצים ל.

מותאם אישית גרסאות OF IMAGES
מכיוון שניתן להקצות URI שונה לכל חלק בתמונה במידת הצורך,
ג'יגדו מאוד גמיש. רק דוגמה אחת היא האפשרות של גרסאות מותאמות אישית של
תמונות: נניח שמישהו מפיץ תמונת CD ושאתה רוצה ליצור כמה
שינויים קטנים בו והפיצו מחדש את הגרסה שלך. אתה מוריד את ה- `official.iso' תקליטור
תמונה עם ג'יגדו (מעביר לו את כתובת האתר של `official.jigdo'), כתוב אותו ל-CD-R, צור את שלך
שינויים (נניח, הוספת קבצים מה-`הקבצים שלי' בדיסק הקשיח שלך) והפק את שלך
גרסה משלו, `myversion.iso'. לאחר מכן, אתה מורה קובץ ג'יגדו כדי ליצור את הג'יגדו ו
קבצי תבנית עבור התמונה ששונתה, באמצעות הפקודה

קובץ ג'יגדו לעשות-תבנית --image=myversion.iso /mnt/cdrom/ הקבצים שלי// --תווית
שלי=הקבצים שלי/ --ורי שלי=http://my.homepage.net/ --merge=official.jigdo
בזמן `official.iso' מותקן תחת `/mnt/cdrom'. על ידי שימוש ב --לְמַזֵג, אמרת ג'יגדו-
פילה לקחת את התוכן של `official.jigdo', הוסף לו קטע `[תמונה]' חדש עבור
`myversion.iso' וכתוב את קובץ ה-jigdo שהתקבל ל-`myversion.jigdo' - אז עכשיו
`myversion.jigdo' מציע שתי תמונות להורדה, הגרסה המקורית והשינוי שלך
גִרְסָה. (אם אינך רוצה שהיא תציע את הגרסה הרשמית, ערוך אותה והסר את
קטע `[תמונה]' שמפרט את `official.iso'.)

עכשיו אתה יכול להעלות את ה-`.ג'יגדוקובץ ', ה-'.תבנית' קובץ וגם הקבצים ב- `הקבצים שלי'
אל `http://my.homepage.net/'. לכן, כדי שאנשים יורידו את התמונה ששונתה, אתה עושה זאת
לֹא צריך להעלות את תוכן התמונה המלא למרחב האינטרנט שלך, אבל רק את השינויים שאתה
עָשׂוּי!

(במקרה שעשית רק מעט מאוד שינויים, תוכל גם להשמיט את הפרמטר 'myfiles' ב-
הפקודה למעלה, ואז כל השינויים שלך יסתיימו בקובץ התבנית החדש.)

שילוב רב מנוהל JIGDO IMAGES לתוך ONE
כמו כן, אין בעיה לשלב נתונים ממספר מקורות המשתמשים בג'יגדו. לדוגמה, אם
של חמישה שרתים שונים ולא קשורים שכל אחד מהם מפיץ תמונת CD שונה באמצעותם
jigdo, אתה יכול ליצור תמונת DVD מותאמת אישית המכילה את הנתונים מכל התקליטורים הללו.
כשאנשים משתמשים ג'יגדו כדי להוריד את התמונה שלך, הקבצים הבודדים ב-DVD נלקחים
מאותם מקורות כמו התקליטורים המקוריים.

כתוצאה מכך, למרות שתפיץ קובץ בנפח 3.2GB דרך שטח האינטרנט שלך, ה
כמות הנתונים בפועל המאוחסנת בשרת שלך תהיה בסדר גודל של כמה
MBS.

השתמש ב-jigdo-file באינטרנט באמצעות שירותי onworks.net