dpkg-source - מקוון בענן

תָכְנִית:

שֵׁם

dpkg-source - כלי מניפולציה של חבילת מקור של דביאן (.dsc).

תַקצִיר

dpkg-source [אוֹפְּצִיָה...] הפקודה

תיאור

dpkg-source אורז ומפרק את ארכיוני המקור של דביאן.

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

פקודות

-x, --לחלץ שם הקובץ.dsc [ספריית פלט]
חלץ חבילת מקור (--לחלץ מאז dpkg 1.17.14). טיעון אחד שאינו אופציונלי
חייב להיות מסופק, שם קובץ בקרת המקור של דביאן (.dsc). אופציונלי
ניתן לספק ארגומנט שני ללא אפשרות כדי לציין את הספרייה לחלץ את
חבילת מקור ל, זה לא חייב להתקיים. אם לא צוינה ספריית פלט, ה-
חבילת המקור מחולצת לתוך ספרייה בשם מָקוֹר-גרסה תחת הזרם
ספריית עבודה.

dpkg-source יקרא את שמות הקבצים האחרים המרכיבים את חבילת המקור
מקובץ הבקרה; ההנחה היא שהם נמצאים באותה ספרייה כמו ה- .dsc.

הקבצים בחבילה שחולצו יקבעו את ההרשאות והבעלות שלהם
לאלה שהיו צפויים אם הקבצים והספריות היו פשוט
נוצר - ספריות וקבצי הפעלה יהיו 0777 וקבצים רגילים יהיו
להיות 0666, שניהם שונו על ידי umask של המחלצים; אם ספריית האב היא setgid
אז גם הספריות שחולצו יהיו, וכל הקבצים והספריות יהיו
לרשת את הבעלות על הקבוצה.

אם חבילת המקור משתמשת בפורמט לא סטנדרטי (כרגע זה אומר את כל הפורמטים
למעט "1.0"), השם שלו יאוחסן ב debian/source/format כך שה-
הבנייה הבאה של חבילת המקור משתמשת באותו פורמט כברירת מחדל.

-b, --לִבנוֹת בספרייה [פרמטרים ספציפיים לפורמט]
בנה חבילת מקור (--לִבנוֹת מאז dpkg 1.17.14). הטיעון הראשון ללא אופציה
נלקח כשם הספרייה המכילה את עץ המקור debianized (כלומר
עם ספריית משנה של דביאן ואולי שינויים בקבצים המקוריים). תלוי ב
פורמט חבילת המקור המשמש לבניית החבילה, פרמטרים נוספים עשויים להיות
קיבל.

dpkg-source יבנה את חבילת המקור עם הפורמט הראשון שנמצא בזה
רשימה מסודרת: הפורמט המצוין ב- --פוּרמָט אפשרות שורת הפקודה, ה
פורמט המצוין ב debian/source/format, "1.0". החזרה ל-"1.0" היא
הוצא משימוש ויוסר מתישהו בעתיד, עליך תמיד
לתעד את פורמט המקור הרצוי בו debian/source/format. ראה סעיף מקור
חֲבִילָה פורמטים לתיאור נרחב של הפורמטים השונים של חבילות המקור.

--פורמט הדפסה בספרייה
הדפס את פורמט המקור שישמש לבניית חבילת המקור אם
dpkg-source --לִבנוֹת בספרייה נקרא (באותם תנאים ובאותם
פרמטרים; מאז dpkg 1.15.5).

--לפני בנייה בספרייה
הפעל את ה-hook המתאים של פורמט חבילת המקור (מאז dpkg 1.15.8). זֶה
הוק נקרא לפני כל בנייה של החבילה (dpkg-buildpackage קורא לזה מאוד
מוקדם אפילו לפני דביאן/כללים לְנַקוֹת). פקודה זו היא אימפוטנטית וניתן לקרוא אותה
מספר פעמים. לא כל פורמטי המקור מיישמים משהו בהוק הזה, ואלו
שבדרך כלל מכינים את עץ המקור לבנייה, למשל על ידי הבטחת זאת
התיקונים של דביאן מוחלים.

--לאחר בנייה בספרייה
הפעל את ה-hook המתאים של פורמט חבילת המקור (מאז dpkg 1.15.8). זֶה
הוק נקרא לאחר כל בנייה של החבילה (dpkg-buildpackage קורא לזה אחרון).
פקודה זו היא אימפוטנטית וניתן לקרוא לה מספר פעמים. לא כל פורמטי המקור
ליישם משהו בהוק הזה, ואלו שכן משתמשים בו בדרך כלל כדי לבטל מה
--לפני בנייה עשה.

--לְבַצֵעַ [בספרייה]...
הקלט שינויים בעץ המקור שנפרק בו בספרייה (מאז dpkg 1.16.1). זֶה
הפקודה יכולה לקחת פרמטרים משלימים בהתאם לפורמט המקור. זה יהיה
הוצא שגיאה עבור פורמטים שבהם הפעולה הזו לא אומרת כלום.

-?, - עזרה
הצג את הודעת השימוש וצא.

--גִרְסָה
הצג את הגרסה וצא.

אפשרויות

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

-lChangelog-קובץ
מציין את קובץ יומן השינויים שממנו יש לקרוא מידע. ברירת המחדל היא
debian/changelog. אם ניתן עם שם נתיב יחסי זה מתפרש החל מ-
הספרייה ברמה העליונה של עץ המקור.

-Fפורמט יומן שינויים
מציין את הפורמט של יומן השינויים. לִרְאוֹת dpkg-parsechangelog(1) למידע
לגבי פורמטים חלופיים.

--פורמט=ערך
השתמש בפורמט הנתון לבניית חבילת המקור (מאז dpkg 1.14.17). זה עושה
לעקוף כל פורמט שניתן ב debian/source/format.

-Vשם=ערך
הגדר משתנה החלפת פלט. לִרְאוֹת deb-substvars(5) לדיון ב
החלפת פלט.

-Tקובץ substvars
קרא משתני החלפה ב קובץ substvars; ברירת המחדל היא לא לקרוא אף קובץ.
ניתן להשתמש באפשרות זו מספר פעמים לקריאת משתני החלפה מרבים
קבצים (מאז dpkg 1.15.6).

-Dשדה=ערך
עוקף או הוסף שדה של קובץ בקרת פלט.

-Uשדה
הסר שדה של קובץ בקרת פלט.

-Zדְחִיסָה, --דְחִיסָה=דְחִיסָה
ציין את הדחיסה לשימוש עבור קובצי tarball ו-diff שנוצרו (--דְחִיסָה
מאז dpkg 1.15.5). שימו לב שאופציה זו לא תגרום לטרבולים קיימים
דחוס מחדש, זה משפיע רק על קבצים חדשים. הערכים הנתמכים הם: מופעלת דחיסת, bzip2, lzma
ו xz. ברירת המחדל היא xz עבור פורמטים 2.0 ומעלה, ו מופעלת דחיסת עבור פורמט 1.0. xz
נתמך רק מאז dpkg 1.15.5.

-zרָמָה, --רמת דחיסה=רָמָה
רמת דחיסה לשימוש (--רמת דחיסה מאז dpkg 1.15.5). כמו עם -Z it
משפיע רק על קבצים חדשים שנוצרו. הערכים הנתמכים הם: 1 ל 9, הטוב ביותר, ו מָהִיר.
ברירת המחדל היא 9 עבור gzip ו-bzip2, 6 עבור xz ו-lzma.

-i[regex], --התעלם[=regex]
אתה יכול לציין ביטוי רגולרי של perl כדי להתאים לקבצים שאתה רוצה לסנן מהם
רשימת הקבצים עבור ה-diff (--התעלם מאז dpkg 1.15.6). (רשימה זו היא
נוצר על ידי פקודת find.) (אם חבילת המקור נבנית כגרסה 3
חבילת מקור באמצעות VCS, ניתן להשתמש בזה כדי להתעלם משינויים לא מחויבים ב
קבצים ספציפיים. שימוש ב-i.* יתעלם מכולם.)

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

זה מאוד עוזר לחתוך קבצים זרים שנכללים ב-diff,
למשל אם אתה שומר את המקור שלך במערכת בקרת גרסאות ורוצה להשתמש ב-
Checkout כדי לבנות חבילת מקור מבלי לכלול את הקבצים הנוספים ו
ספריות שהוא יכיל בדרך כלל (למשל CVS/, .cvsignore, .svn/). ה
ברירת המחדל regex כבר ממצה מאוד, אבל אם אתה צריך להחליף אותו, בבקשה
שים לב שכברירת מחדל זה יכול להתאים לכל חלק של נתיב, אז אם אתה רוצה להתאים את
התחלה של שם קובץ או רק שמות קבצים מלאים, תצטרך לספק את הדרוש
עוגן (למשל '(^|/)', '($|/)') בעצמך.

--הרחיב-הבדל-התעלם=regex
הביטוי הרגולרי perl שצוין ירחיב את ערך ברירת המחדל שבו נעשה שימוש
--התעלם והערך הנוכחי שלו, אם מוגדר (מאז dpkg 1.15.6). זה עושה זאת על ידי
שרשור "|regex" לערך הקיים. אפשרות זו נוחה לשימוש
debian/source/options כדי לא לכלול כמה קבצים שנוצרו אוטומטית מהתיקון האוטומטי
דוֹר.

-I[דפוס קובץ], --טאר-התעלם[=דפוס קובץ]
אם תצוין אפשרות זו, הדפוס יועבר אל זפתשל (1). --לא לכלול
אפשרות כאשר היא נקראת ליצור קובץ .orig.tar או .tar (--טאר-התעלם since
dpkg 1.15.6). לדוגמה, -ICVS יגרום ל-tar לדלג מעל ספריות CVS כאשר
יצירת קובץ ‎.tar.gz. ניתן לחזור על האפשרות מספר פעמים לרשימה
דפוסים מרובים לא לכלול.

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

הערה: אמנם יש להם מטרות דומות, -i ו -I יש תחביר שונה מאוד ו
סֵמַנטִיקָה. -i ניתן לציין רק פעם אחת ולוקח ביטוי רגולרי תואם perl
אשר מותאם לנתיב היחסי המלא של כל קובץ. -I יכול לציין מרובים
פעמים ולוקח דפוס שם קובץ עם תווים כלליים של מעטפת. הדפוס מוחל על
נתיב יחסי מלא אבל גם לכל חלק של השביל בנפרד. הסמנטיקה המדויקת של
של זפת --לא לכלול האפשרות קצת מסובכת, ראה
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.

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

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

--לא בדיקה
אין לבדוק חתימות וסיכומי בדיקה לפני הפריקה (מאז dpkg 1.14.17).

--דרוש-חתימה חוקית
סרב לפרוק את חבילת המקור אם היא לא מכילה חתימת OpenPGP ש
ניתן לאמת (מאז dpkg 1.15.0) עם זה של המשתמש trustedkeys.gpg מחזיק מפתחות,
אחד ממחזיקי המפתחות הספציפיים לספק, או אחד ממחזיקי המפתחות הרשמיים של דביאן
(/usr/share/keyrings/debian-keyring.gpg ו
/usr/share/keyrings/debian-maintainers.gpg).

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

מקור חֲבִילָה פורמטים

אם אינך יודע באיזה פורמט מקור להשתמש, סביר להניח שתבחר "3.0 (שמיכה)"
או "3.0 (יליד)". ראה https://wiki.debian.org/Projects/DebSrc3.0 למידע על
פריסה של פורמטים אלה בתוך דביאן.

פוּרמָט: 1.0
חבילת מקור בפורמט זה מורכבת מא .orig.tar.gz קשור לא .diff.gz
או רווק .tar.gz (במקרה זה אומרים שהחבילה היא יליד).

מחלץ

חילוץ חבילה מקורית היא חילוץ פשוט של הטרבול הבודד במטרה
מַדרִיך. חילוץ חבילה שאינה מקורית מתבצעת על ידי פריקה תחילה של .orig.tar.gz ו
לאחר מכן הנחת התיקון הכלול ב- .diff.gz קוֹבֶץ. חותמת הזמן של כל הקבצים שתוקנו
מאופס לזמן החילוץ של חבילת המקור (זה מונע הטיית חותמת זמן מובילה
לבעיות כאשר קבצים שנוצרו אוטומטית מתוקנים). ההבדל יכול ליצור קבצים חדשים (ה
כל ספריית debian נוצרת כך) אך לא ניתן להסיר קבצים (קבצים ריקים יהיו
עוֹדֵף).

בִּניָן

בניית חבילה מקורית היא רק יצירת טארבול יחיד עם ספריית המקור.
בניית חבילה שאינה מקורית כרוכה בחילוץ ה-tarball המקורי בנפרד
ספריית ".orig" ומחדשת את .diff.gz על ידי השוואת חבילת המקור בספרייה
עם ספריית ‎.orig.

לִבנוֹת אפשרויות (עם --לִבנוֹת):

אם מסופק ארגומנט שני ללא אפשרות, זה צריך להיות שם המקור המקורי
ספרייה או tarfile או המחרוזת הריקה אם החבילה היא חבילה ספציפית לדביאן וכן
אין הבדלי דביאניזציה. אם לא יסופק טיעון שני אז dpkg-source יהיה להסתכל
עבור תעריף המקור המקורי package_upstream-version.orig.tar.gz או המקור
ספריית מקור בספרייה.orig תלוי ב -sX ארגומנטים.

-זה, -sp, -sk, -סו ו -סר לא יחליף תעריפים או ספריות קיימות. אם זה
הרצוי אז -sA, -sP, -sK, -שֶׁלוֹ ו -sR צריך להשתמש במקום.

-sk מציין לצפות למקור המקורי כ-tarfile, כברירת מחדל package_upstream-
גרסה.orig.tar.הארכה. זה ישאיר את המקור המקורי הזה במקומו בתור א
tarfile, או העתק אותו לספרייה הנוכחית אם הוא עדיין לא שם. הטארבול
ייפרק לתוך בספרייה.orig לדור ההפרש.

-sp כמו -sk אבל יסיר את הספרייה שוב לאחר מכן.

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

-סר כמו -סו אך יסיר את הספרייה לאחר השימוש בה.

-אס מציין שהמקור המקורי זמין הן כספרייה והן כקובץ
tarfile. dpkg-source ישתמש בספרייה כדי ליצור את ה-diff, אבל ב-tarfile כדי
ליצור את .dsc. יש להשתמש באפשרות זו בזהירות - אם המדריך ו-tarfile
לא תואמים ייווצר ארכיון מקור רע.

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

-זה or -sA
מציין לחפש את ארכיון המקור המקורי כ-tarfile או כספרייה -
הארגומנט השני, אם קיים, יכול להיות אחד, או המחרוזת הריקה (זה שווה ערך
לשימוש -sn). אם תימצא tarfile הוא יפרק אותו כדי ליצור את ה-diff and
הסר אותו לאחר מכן (זה שווה ערך ל -sp); אם תימצא ספריה היא תמצא
ארוז אותו כדי ליצור את המקור המקורי והסר אותו לאחר מכן (זה שווה ערך
ל -סר); אם אף אחד מהם לא נמצא, הוא יניח שלחבילה אין דביאזציה
diffs, רק ארכיון מקור פשוט (זה שווה ערך ל -sn). אם שניהם
נמצאות אז dpkg-source יתעלם מהספרייה, יחליף אותה, אם -sA היה
שצוין (זה שווה ערך ל -sP) או העלה שגיאה אם -זה צוין. -sA
הוא ברירת המחדל.

--הפסק בשינויים במעלה הזרם
התהליך נכשל אם ההבדל שנוצר מכיל שינויים בקבצים מחוץ ל-
ספריית המשנה של debian (מאז dpkg 1.15.8). אפשרות זו אינה מותרת להיכנס
debian/source/options אבל ניתן להשתמש בו debian/source/local-options.

להוציא אפשרויות (עם --לחלץ):

בכל המקרים כל עץ מקור מקורי קיים יוסר.

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

-סו מפרק את עץ המקור המקורי.

-sn מבטיח שהמקור המקורי לא מועתק לספרייה הנוכחית ולא
פורק. כל עץ מקור מקורי שהיה בספרייה הנוכחית עדיין
הוסר.

כל -sX אפשרויות סותרות זו את זו. אם אתה מציין יותר מאחד רק האחרון
יהיה בשימוש.

--דלג על דביאזציה
מדלג על יישום ה-debian diff על גבי המקורות במעלה הזרם (מאז dpkg
1.15.1).

פוּרמָט: 2.0
חילוץ נתמך מאז dpkg 1.13.9, בניין נתמך מאז dpkg 1.14.8. גם ידוע
כמו פאה ועט. פורמט זה אינו מומלץ לשימוש נרחב, הפורמט "3.0 (שמיכה)"
מחליף אותו. Wig&pen היה המפרט הראשון של חבילת מקור מהדור החדש
פורמט.

ההתנהגות של פורמט זה זהה לפורמט "3.0 (שמיכה)" פרט לכך
אינו משתמש ברשימה מפורשת של תיקונים. כל הקבצים ב debian/patches/ תואם את perl
הבעה רגילה [\w-]+ חייבים להיות תיקונים תקפים: הם מוחלים בזמן החילוץ.

בעת בניית חבילת מקור חדשה, כל שינוי במקור במעלה הזרם מאוחסן בתיקון
בשם zz_debian-diff-auto.

פוּרמָט: 3.0 (יָלִיד)
נתמך מאז dpkg 1.14.17. פורמט זה הוא הרחבה של פורמט החבילה המקורית as
מוגדר בפורמט 1.0. זה תומך בכל שיטות הדחיסה והוא יתעלם כברירת מחדל
כל קבצים וספריות ספציפיות ל-VCS, כמו גם קבצים זמניים רבים (ראה ערך ברירת מחדל
קשור ל -I אפשרות ב - עזרה תְפוּקָה).

פוּרמָט: 3.0 (שמיכה)
נתמך מאז dpkg 1.14.17. חבילת מקור בפורמט זה מכילה לפחות
טארבול מקורי (.orig.tar.שלוחה איפה שלוחה יכול להיות gz, bz2, lzma ו xz) ודביאן
טארבול (.debian.tar.שלוחה). זה יכול להכיל גם כדורי טרבול מקוריים נוספים
(.orig-רְכִיב.זֶפֶת.שלוחה). רְכִיב יכול להכיל רק תווים אלפאנומריים ומקפים
('-').

מחלץ

תחילה חולצים את ה-tarball המקורי הראשי, ואז כל ה-tarballs המקוריים הנוספים
חולץ בספריות משנה הנקראות על שם ה רְכִיב חלק משם הקובץ שלהם (כל קדם-
הספרייה הקיימת מוחלפת). ה-tarball של debian מוחלץ על גבי המקור
ספרייה לאחר הסרה מוקדמת של כל קובץ קיים דביאן מַדרִיך. שימו לב שהדביאן
tarball חייב להכיל א דביאן ספריית משנה אבל היא יכולה להכיל גם קבצים בינאריים בחוץ
של אותה ספרייה (ראה --include-binaries אוֹפְּצִיָה).

כל התיקונים הרשומים ב debian/patches/debian.series or debian/patches/series הם אז
מיושם. אם נעשה שימוש בקובץ הקודם והאחרון אינו קיים (או שהוא קישור סימן),
ואז האחרון מוחלף בקישור סימלי לראשון. זה נועד לפשט את השימוש
of שמיכה כדי לנהל את סט התיקונים. שים לב עם זאת שבזמן dpkg-source ניתוחים
סדרה נכונה קבצים עם אפשרויות מפורשות המשמשות עבור יישום תיקון (מאוחסנים בכל אחד מהם
שורה אחרי שם קובץ התיקון ורווח אחד או יותר), הוא אכן מתעלם מהאפשרויות הללו ו
תמיד צפו לטלאים שניתן להחיל עם -p1 אופציה של תיקון. כך הוא יפלוט
אזהרה כאשר הוא נתקל באפשרויות כאלה, והבנייה צפויה להיכשל.

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

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

דומה ל שמיכההתנהגות ברירת המחדל של התיקונים יכולים להסיר גם קבצים.

הקובץ .pc/applied-patches נוצר אם כמה תיקונים הוחלו במהלך
מיצוי.

בִּניָן

כל הכדורים המקוריים שנמצאים בספרייה הנוכחית נשלפים באופן זמני
ספרייה על-ידי ביצוע אותו היגיון כמו ב- unpack, ספריית debian מועתקת
בספרייה הזמנית, וכל התיקונים מלבד התיקון האוטומטי
(debian-changes-גרסה or דביאן-שינויים, תלוי ב --single-debian-patch) הם
מיושם. הספרייה הזמנית מושווה לספריית חבילת המקור. כאשר
ה-diff אינו ריק, ה-build נכשל אלא אם כן --single-debian-patch or --התחייבות אוטומטית כבר
בשימוש, ובמקרה זה ההפרש מאוחסן בתיקון האוטומטי. אם התיקון האוטומטי הוא
נוצר/נמחק, הוא נוסף/הוסר מקובץ הסדרה ומהקובץ שמיכה מטא נתונים.

כל שינוי בקובץ בינארי אינו בר ייצוג ב-diff ובכך יוביל לכשל
אלא אם כן המתחזק החליט בכוונה לכלול את הקובץ הבינארי שהשתנה ב-
debian tarball (על ידי רישום זה ב debian/source/include-binaries). גם הבנייה תיכשל
אם הוא מוצא קבצים בינאריים בספריית המשנה של דביאן אלא אם כן הם הוסדרו לרשימה הלבנה
דרך debian/source/include-binaries.

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

ההבדל שנוצר אוטומטית אינו כולל שינויים בקבצים ספציפיים ל-VCS
קבצים זמניים רבים (ראה ערך ברירת מחדל המשויך ל -i אפשרות ב - עזרה תְפוּקָה). ב
במיוחד, ה .מחשב ספרייה בשימוש על ידי שמיכה הוא מתעלם במהלך היצירה של האוטומטי
תיקון.

הערה: dpkg-source --לפני בנייה (ו --לִבנוֹת) יבטיח שכל התיקונים הרשומים ב-
קובץ series מוחלים כך שבבניית חבילה יוחלו תמיד כל התיקונים. זה עושה
זאת על ידי מציאת תיקונים שלא הוחלו (הם רשומים ב- סדרה קובץ אבל לא ב
.pc/applied-patches), ואם ניתן להחיל את התיקון הראשון בסט הזה ללא שגיאות, זה
יישם את כולם. האפשרות --ללא הכנה ניתן להשתמש כדי להשבית התנהגות זו.

הקלטה שינויים

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

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

אם יצירת התיקון מזהה קבצים בינאריים שהשתנו, הם יהיו אוטומטית
הוספתי ל debian/source/include-binaries כך שהם יגמרו ב-tarball של debian
(בדיוק כמו dpkg-source --include-binaries --לִבנוֹת הייתי עושה).

לִבנוֹת אפשרויות

--allow-version-of-quilt-db=גרסה
להתיר dpkg-source כדי לבנות את חבילת המקור אם הגרסה של שמיכה מטה
הוא זה שצוין, גם אם dpkg-source לא יודע על זה (מאז dpkg
1.15.5.4). למעשה זה אומר שהגרסה הנתונה של שמיכה מטא נתונים הוא
תואם לגרסה 2 זה dpkg-source תומך כרגע. הגרסה של
מה היא שמיכה מטא נתונים מאוחסנים ב .pc/.version.

--include-removal
אל תתעלם מקבצים שהוסרו ותכלול אותם בתיקון שנוצר אוטומטית.

--include-timestamp
כלול חותמת זמן בתיקון שנוצר אוטומטית.

--include-binaries
הוסף את כל הקבצים הבינאריים שהשתנו ב-tarball של debian. הוסף אותם גם ל
debian/source/include-binaries: הם יתווספו כברירת מחדל בגירסאות הבאות
ובכך אין צורך יותר באפשרות זו.

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

--single-debian-patch
השתמש debian/patches/debian-changes במקום debian/patches/debian-changes-גרסה
עבור שם התיקון האוטומטי שנוצר במהלך הבנייה (מאז dpkg 1.15.5.4).
אפשרות זו שימושית במיוחד כאשר החבילה נשמרת ב-VCS ו-a
לא ניתן ליצור באופן מהימן ערכת תיקון. במקום ההפרש הנוכחי עם במעלה הזרם
יש לאחסן במדבקה אחת. האפשרות תוכנס
debian/source/local-options ויהיה מלווה בא
debian/source/local-patch-header קובץ המסביר כיצד השינויים בדביאן יכולים להיות הטובים ביותר
נבדק, למשל ב-VCS שבו נעשה שימוש.

--create-empty-orig
צור אוטומטית את ה-tarball המקורי הראשי כריק אם הוא חסר ואם
יש כדורים מקוריים משלימים (מאז dpkg 1.15.6). אפשרות זו היא
נועד לשמש כאשר חבילת המקור היא רק חבילה של חבילות מרובות במעלה הזרם
תוכנה והיכן שאין תוכנה "ראשית".

--לא-לא-להחיל תיקונים, --לא חל-טלאים
כברירת מחדל, dpkg-source יבטל אוטומטית את החלת התיקונים ב- --לאחר בנייה
וו אם זה עשה אותם במהלך --לפני בנייה (--לא חל-טלאים מאז dpkg
1.15.8, --לא-לא-חל-טלאים מאז dpkg 1.16.5). האפשרויות האלה מאפשרות לך
השבת או הפעל בכוח את תהליך ביטול היישום של התיקון. האפשרויות האלה הן
מותר להיכנס רק debian/source/local-options כך שכל חבילות המקור שנוצרו
יש את אותה התנהגות כברירת מחדל.

--הפסק בשינויים במעלה הזרם
התהליך נכשל אם נוצר תיקון אוטומטי (מאז dpkg 1.15.8).
ניתן להשתמש באפשרות זו כדי להבטיח שכל השינויים נרשמו כהלכה ב
נפרד שמיכה תיקונים לפני בניית חבילת המקור. אפשרות זו לא
מורשה להכנס debian/source/options אבל ניתן להשתמש בו debian/source/local-options.

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

להוציא אפשרויות

--דלג על דביאזציה
מדלג על חילוץ של Tarball של debian על גבי המקורות במעלה הזרם (מאז dpkg
1.15.1).

--דילוג על תיקונים
אין להחיל מדבקות בסוף החילוץ (מאז dpkg 1.14.18).

פוּרמָט: 3.0 (המותאם אישית)
נתמך מאז dpkg 1.14.17. הפורמט הזה מיוחד. זה לא מייצג מקור אמיתי
פורמט חבילה אך ניתן להשתמש בו כדי ליצור חבילות מקור עם קבצים שרירותיים.

לִבנוֹת אפשרויות

כל הארגומנטים שאינם אופציונליים נלקחים כקבצים לשילוב בחבילת המקור שנוצרה.
הם חייבים להתקיים ורצוי שהם נמצאים בספרייה הנוכחית. לפחות קובץ אחד חייב להיות
נָתוּן.

--target-format=ערך
דרוש. מגדיר את הפורמט האמיתי של חבילת המקור שנוצרה. הנוצר
קובץ .dsc יכיל את הערך הזה פוּרמָט שדה ולא "3.0 (מותאם אישית)".

פוּרמָט: 3.0 (גיט)
נתמך מאז dpkg 1.14.17. פורמט זה הוא ניסיוני.

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

מחלץ

החבילה משובטת כמאגר git לספריית היעד. אם יש
קובץ gitshallow, הוא מותקן כ .git/Shallow בתוך מאגר git המשובט.

שים לב שכברירת מחדל למאגר החדש ייצא אותו סניף שהיה
נבדק במקור המקורי. (בדרך כלל "מאסטר", אבל זה יכול להיות כל דבר.) כל
סניפים אחרים יהיו זמינים תחת שלטים/מקור/.

בִּניָן

לפני שנמשיך הלאה, נעשות כמה בדיקות כדי לוודא שאין לנו שום
התעלם משינויים לא מחויבים.

git-bundle(1) משמש ליצירת חבילה של מאגר git. כברירת מחדל, הכל
סניפים ותגים במאגר כלולים בחבילה.

לִבנוֹת אפשרויות

--git-ref=נ"צ
מאפשר ציון גיט ref לכלול בחבילת git. השימוש משבית את ברירת המחדל
התנהגות של הכללת כל הענפים והתגים. ניתן לציין מספר פעמים. ה
נ"צ יכול להיות שם של סניף או תג שיש לכלול. זה יכול להיות גם כל פרמטר
שאפשר להעביר ל git-rev-list(1). לדוגמה, לכלול רק את המאסטר
סניף, שימוש --git-ref=לִשְׁלוֹט. לכלול את כל התגים והענפים, למעט ה
סניף פרטי, שימוש --git-ref=--את כל --git-ref=^פרטי

--git-depth=מספר
יוצר שיבוט רדוד עם היסטוריה קטועה למספר שצוין של
תיקונים.

פוּרמָט: 3.0 (bzr)
נתמך מאז dpkg 1.14.17. פורמט זה הוא ניסיוני. זה יוצר כדור כדור בודד
המכיל את מאגר bzr.

מחלץ

הטארבול פורק ואז bzr משמש לקופה את הסניף הנוכחי.

בִּניָן

לפני שנמשיך הלאה, נעשות כמה בדיקות כדי לוודא שאין לנו שום
התעלם משינויים לא מחויבים.

לאחר מכן, החלק הספציפי של VCS של ספריית המקור מועתק לחלק זמני
מַדרִיך. לפני שהספרייה הזמנית הזו נארזה ב-tarball, ניקוי שונים
נעשה כדי לחסוך במקום.

דיאגנוסטיקה

לא מָקוֹר פוּרמָט מפורט in debian/source/format
הקובץ debian/source/format צריך להתקיים תמיד ולציין את פורמט המקור הרצוי.
עבור תאימות לאחור, התבנית "1.0" היא ההנחה כאשר הקובץ אינו קיים מלבדך
לא צריך להסתמך על זה: בשלב מסוים בעתיד dpkg-source ישונה לכשל
כאשר הקובץ הזה לא קיים.

הרציונל הוא שפורמט "1.0" הוא כבר לא הפורמט המומלץ, אתה צריך בדרך כלל
בחר אחד מהפורמטים החדשים יותר ("3.0 (שמיכה)", "3.0 (מקורי)"), אבל dpkg-source לא יעשה
זה אוטומטית עבורך. אם אתה רוצה להמשיך להשתמש בפורמט הישן, אתה צריך לעשות זאת
מפורש על זה והכניס "1.0". debian/source/format.

מה היא הבדל משנה מה היא הבא בְּמַעֲלֶה הַזֶרֶם קבצים
כאשר משתמשים בפורמט מקור "1.0" זה בדרך כלל רעיון רע לשנות קבצים במעלה הזרם ישירות
מכיוון שהשינויים מסתיימים ובעיקר לא מתועדים בקובץ .diff.gz. במקום אתה
צריך לאחסן את השינויים שלך בתור תיקונים בספריית debian ולהחיל אותם בזמן הבנייה.
כדי להימנע ממורכבות זו, אתה יכול גם להשתמש בפורמט "3.0 (שמיכה)" שמציע זאת
מלידה.

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

חדש נוצר ריק פילה פילה יצטרך לֹא be מיוצג in הבדל
לא ניתן ליצור קבצים ריקים עם קבצי תיקון. לפיכך שינוי זה אינו נרשם ב-
חבילת מקור ואתה מוזהר על כך.

הפעלה מצב Permons of פילה יצטרך לֹא be מיוצג in הבדל
קבצי תיקון אינם מתעדים הרשאות של קבצים ולכן אין הרשאות הפעלה
מאוחסן בחבילת המקור. אזהרה זו מזכירה לך את העובדה הזו.

מיוחד מצב Permons of פילה יצטרך לֹא be מיוצג in הבדל
קבצי תיקון אינם מתעדים הרשאות של קבצים ולכן הרשאות ששונו אינן
מאוחסן בחבילת המקור. אזהרה זו מזכירה לך את העובדה הזו.

קובץ פורמטים

debian/source/format
קובץ זה מכיל בשורה אחת את הפורמט שבו יש להשתמש לבניית המקור
חבילה (פורמטים אפשריים מתוארים לעיל). אסור להכניס חללים מובילים או נגררים.

debian/source/include-binaries
קובץ זה מכיל רשימה של קבצים בינאריים (אחד בכל שורה) שאמורים להיכלל ב-
דביאן טרבול. חללים מובילים ונגררים מופשטים. שורות המתחילות ב'#' הם
הערות ומדלגים עליהם. מתעלמים מהשורות הריקות.

debian/source/options
קובץ זה מכיל רשימה של אפשרויות ארוכות שאמורות להיות מוצמדות אוטומטית ל-
קבוצה של אפשרויות שורת הפקודה של a dpkg-source --לִבנוֹת or dpkg-source --פורמט הדפסה שיחה.
אפשרויות כמו --דְחִיסָה ו --רמת דחיסה מתאימים היטב לקובץ זה.

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

# תן ל-dpkg-source ליצור debian.tar.bz2 עם דחיסה מקסימלית
דחיסה = "bzip2"
רמת דחיסה = 9
# השתמש ב-debian/patches/debian-changes כתיקון אוטומטי
single-debian-patch
# התעלם משינויים בתצורה.{sub,guess}
extend-diff-ignore = "(^|/)(config.sub|config.guess)$"

הערה: פוּרמָט אפשרויות אינן מתקבלות בקובץ זה, עליך להשתמש debian/source/format
במקום.

debian/source/local-options
בדיוק כמו debian/source/options אלא שהקובץ אינו כלול בקובץ שנוצר
חבילת מקור. זה יכול להיות שימושי לאחסן העדפה הקשורה למתחזק או ל-
מאגר VCS שבו מתוחזקת חבילת המקור.

debian/source/local-patch-header ו debian/source/patch-header
טקסט בצורה חופשית שמוצב על גבי התיקון האוטומטי שנוצר בפורמטים "2.0" או
"3.0 (שמיכה)". local-patch-header אינו כלול בחבילת המקור שנוצרה while
כותרת תיקון הוא.

debian/patches/series
קובץ זה מפרט את כל התיקונים שיש להחיל (בסדר הנתון) על גבי הקובץ
חבילת מקור במעלה הזרם. חללים מובילים ונגררים מופשטים. שורות שמתחילות ב
"#' הן הערות ומדלגים עליהן. מתעלמים מהשורות הריקות. השורות הנותרות מתחילות בא
שם קובץ התיקון (ביחס ל- debian/patches/ ספרייה) עד תו הרווח הראשון
או סוף השורה. אופציונאלי שמיכה אפשרויות יכולות לעקוב עד סוף השורה או הראשונה
"#' לפניו רווח אחד או יותר (המסמן את ההתחלה של הערה עד לסוף
קַו).

השתמש ב-dpkg-source מקוון באמצעות שירותי onworks.net