dpatch - מקוון בענן

תָכְנִית:

שֵׁם

dpatch - מערכת תחזוקה של תיקונים לדביאן

תַקצִיר

dpatch [אפשרויות] הפקודה [טיעוני פיקוד]

תיאור

dpatch היא מערכת תיקון קלה לשימוש עבור חבילות דביאן, דומה במקצת ל-dbs
חבילה, אבל הרבה יותר פשוט לשימוש.

זה מאפשר לך לאחסן תיקונים ותבניות התאמה אישית פשוטות אחרות debian/patches ו
אחרת לא דורש הרבה ארגון מחדש של עץ המקור שלך. כדי לקבל את הטלאים
מיושם בזמן הבנייה, אתה פשוט צריך לכלול קטע קובץ makefile ואז להסתמך על
תיקון/ביטול תיקון מטרה ב לִבנוֹת or לְנַקוֹת שלב של דביאן/כללים. לגמישות נוספת,
אתה יכול להתקשר /usr/bin/dpatch גם ישירות.

אזהרה

dpatch הוצא משימוש, אנא עבור לפורמט חבילת המקור של Debian `3.0 (Quilt)'
במקום זאת. לִרְאוֹת http://wiki.debian.org/Projects/DebSrc3.0#שאלות נפוצות למדריך קצר איך לעשות
זה.

גלובלי אפשרויות

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

אפשרויות גלובליות אלו הן:

--workdir (-ד) DIRECTORY
כברירת מחדל, dpatch מחיל תיקונים על עץ המקור ממנו הוא הופעל. עם זה
אפשרות, אפשר לשנות את זה, ולומר ל-dpatch לעבוד על עץ אחר, אם כי
לוקח את ה-dpatches מהנוכחי.

שימו לב שזה יעביר רק ארגומנט שני ל-dpatch scriptlets, ולא
שנה לספרייה שצוינה. כדי לעשות זאת, השתמש ב- --chdir אפשרות מוסברת
לְהַלָן.

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

יש להשתמש בזה יחד עם --workdir אוֹפְּצִיָה.

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

--כּוֹחַ (-F)
כפה על היישום או ביטול היישום של תיקונים, גם אם dpatch יעשה זאת בדרך כלל
דלג עליהם כי הפעולה כבר בוצעה קודם לכן.

--with-cpp
לאלץ את השימוש ב-cpp. עוקף שימוש ב DPATCH_OPTION_CPP=1 אפשרות ב
debian/patches/00options קובץ.

פקודות

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

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

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

להגיש מועמדות [אפשרויות]
תיקון [אפשרויות]
מחיל dpatch אחד או יותר על עץ העבודה (הספרייה הנוכחית, אם לא
נאמר אחרת). כברירת מחדל, התיקונים שצוינו יוחלו באותו אופן
לפי הסדר שהם צוינו.

אפשרויות
--stampdir=בספרייה, -s=בספרייה
הכנס קבצי חותמות לתוך בספרייה במקום ברירת המחדל debian/patched.
- עזרה (-ח)
הדפס הודעת עזרה קצרה על הפקודה.
--שֶׁקֶט (-q)
מאלץ את הפקודה לא להדפיס שום דבר.
--מִלוּלִי (-v)
משבית הסתרה של פלט הסקריפט.

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

אפשרויות
--stampdir=בספרייה, -s=בספרייה
השתמש בקבצי חותמות ב בספרייה במקום ברירת המחדל debian/patched.
- עזרה (-ח)
הדפס הודעת עזרה קצרה על הפקודה.
--שֶׁקֶט (-q)
מאלץ את הפקודה לא להדפיס שום דבר.
--מִלוּלִי (-v)
משבית הסתרה של פלט הסקריפט.

חתול [אפשרויות]
הדפס מטא-מידע על dpatch, כגון השם, המחבר והתיאור שלו
(כל אחד מהם יכול להיות מושבת עם האפשרות המתאימה).

אפשרויות
--לא-מטא, --desc-בלבד (-נ"מ, -ד)
הדפס רק את תיאור התיקון.
--מחבר בלבד (-ל)
הדפס רק את מחבר התיקון.
--לא-תיאור, (-נד)
אל תדפיס את תיאור התיקון.
- עזרה (-ח)
הדפס הודעת עזרה קצרה על הפקודה.
--שֶׁקֶט (-q)
מאלץ את הפקודה לא להדפיס שום דבר.

רשימה [אפשרויות]
רשום את השם של התיקונים שניתנו. הפקודה הזו לא ממש שימושית, מלבד ה
רשימה-הכל גרסה, המפרטת את כל התיקונים הזמינים.

אפשרויות
- עזרה (-ח)
הדפס הודעת עזרה קצרה על הפקודה.

מצב [אפשרויות]
מדפיס את מצב התיקונים הנתונים - בין אם הם מיושמים על העבודה
עץ או לא.

אפשרויות
--stampdir=בספרייה, -s=בספרייה
השתמש בקבצי חותמות ב בספרייה במקום ברירת המחדל debian/patched.
- עזרה (-ח)
הדפס הודעת עזרה קצרה על הפקודה.
--שֶׁקֶט (-q)
מאלץ את הפקודה לא להדפיס שום דבר.

היכנס [אפשרויות]
מציג את היומן של ניסיונות התיקון שניתנו.

אפשרויות
--stampdir=בספרייה, -s=בספרייה
השתמש בקבצי חותמות ב בספרייה במקום ברירת המחדל debian/patched.
- עזרה (-ח)
הדפס הודעת עזרה קצרה על הפקודה.
--שֶׁקֶט (-q)
מאלץ את הפקודה לא להדפיס שום דבר, אלא את היומנים ללא תוספת
סוכר מלמעלה.

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

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

אפשרויות
--טיעון=גדול מ (-a=arg)
התקשר טלאים עם גדול מ כוויכוח.
- עזרה (-ח)
הדפס הודעת עזרה קצרה על הפקודה.
--שֶׁקֶט (-q)
מאלץ את הפקודה לא להדפיס שום דבר.

שונות פקודות
תבנית תיקון [אפשרויות] [שם תיקון] [תיאור]
הדפס תבנית סקריפט מעין סטנדרטית של dpatch, בהתבסס על המידע שניתן ב-
שורת הפקודה. אם תיאור נתון, הוא יקופל בערך 72 תווים לתוך
מספר שורות בצורה מתאימה.

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

אפשרויות
--הקדים (-p)
הוסף את התבנית ל-STDIN.
- עזרה (-ח)
הדפס הודעת עזרה קצרה על הפקודה.

לעזור (--עֶזרָה, -ח) [הפקודה]
נסה לתת עזרה קצת יותר מפורטת לגבי dpatch עצמו, או לגבי נתון
פקודת dpatch.

גרסה
מדפיס את מספר הגרסה של dpatch ויוצא.

DPATCH IN דיבי זיווד

ישנן שתי דרכים שונות להשתמש ב-dpatch in דביאן/כללים: קורא לזה ישירות, או
לְרַבּוֹת dpatch.make(7). רק השיטה הראשונה תתואר כאן - לשנייה יש
דף מדריך משלו.

הערה: הדוגמאות הבאות דורשות גם הוספת ה- .NOTPARALLEL דגל לראש של
דביאן/כללים שכן רשימות התלות מסתמכות על סדר הביצוע. לְלֹא
.NOTPARALLEL, ייתכן שצו הביצוע שגוי עם שרשורי יוצר מרובים (ה -j
אוֹפְּצִיָה).

ברוב המצבים, אחד ירצה להפעיל dpatch בהקדם בתהליך הבנייה, כמו
אפשרי. כיצד ניתן להשיג זאת תלוי במידה רבה בקיים דביאן/כללים.
עם זאת, בפועל לרוב החבילות יש א לִבנוֹת (אוֹ לבנות-בול), config.status, או
להגדיר (אוֹ configure-stamp) יעד. הדרך הקלה ביותר להפוך את ה-dpatch לראשונה
דבר, צריך רק לכתוב כלל שקורא ל-dpatch, ולהוסיף אותו לרשימה של
תנאים מוקדמים ליעד המתאים (ראה לעיל).

ביטול יישום ה-dpatches יכול להיות קל או קצת יותר מסובך. אם שום דבר ב לְנַקוֹת כלל נוגע
קבצים ששונו על ידי dpatches (יצירת שינויים לא תואמים), אתה יכול להוסיף בבטחה לבטל את התיקון ל
הרשימה של לְנַקוֹת תלות כללים.

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

בואו נסתכל על דוגמה! ראשית, הבה נבחן את החלקים הרלוונטיים של המקור
דביאן/כללים של החבילה הדמיונית שלנו:

config.status: תצורה
./configure --prefix=/ usr --mandir=/ Usr / share
build: config.status
${MAKE}
לְנַקוֹת:
$(testdir)
$(testroot)
${MAKE} disclean
rm -rf debian/imaginary-package debian/files debian/substvars

לאחר ה-dpatchify, זה ייראה כך:

config.status: תצורת תיקון
./configure --prefix=/ usr --mandir=/ Usr / share
build: config.status
${MAKE}
נקי: בטל תיקון נקי
נקי טלאי:
$(testdir)
$(testroot)
${MAKE} disclean
rm -rf debian/imaginary-package debian/files debian/substvars

תיקון: חותמת תיקון
חותמת תיקון:
dpatch application-all
dpatch cat-all >patch-stamp

ביטול תיקון:
dpatch deapply-all
rm -rf patch-stamp debian/patched

מוסיף dpatch סקריפטים ל a חבילה
כשמשתמשים ב-dpatch, בוודאי רוצים לומר למערכת איזה dpatch להחיל, ואיזה
כאלה שיש להשליך. במצב הנפוץ ביותר, צריך רק לרשום את השמות של
dpatches (שמות הקבצים ביחס ל debian/patches) ב debian/patches/00list. הֵם
בדרך כלל יש את ההרחבה ‎.dpatch ואת הסיומת ניתן להשמיט, ובכך קובץ
debian/patches/01_one_patch.dpatch כתוב כ 01_one_patch בתוך debian/patches/00list

עם זאת, ייתכנו מצבים שבהם יש צורך במשהו גמיש יותר, כמו הגשת מועמדות
אותו תיקון רק בשתי ארכיטקטורות, נניח, M68K ו מחשב כוח. אחד פותר את זה בשעה
לפחות שתי דרכים שונות מאוד: האחת היא לרשום את אותו תיקון בשתיהן
debian/patches/00list.m68k ו debian/patches/00list.powerpc, השני הוא להשתמש
DPATCH_OPTION_CPP=1 in debian/patches/00options. קובץ 00list מועבר cpp
פקודה עם DEB_BUILD_ARCH משתנה מוגדר לארכיטקטורה, ו
DEB_BUILD_ARCH_ארכיטקטורה מוגדר ל-1. עם cpp, המדגם שלנו debian/patches/00list
עשוי להיראות כך:

01_manpage_typo
#if defined(DEB_BUILD_ARCH_m68k) || מוגדר (DEB_BUILD_ARCH_powerpc)
/* תיקון זה מתקן שבירה אקראית בזמן בנייה ב-Macintosh boxen. */
02_macintosh_foo
#endif

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

אתה יכול להפעיל את $EDITOR שלך, או להשתמש dpatch-edit-patch, ואתה אמור להיות מוכן.

ברוב המקרים, שבהם קובץ ה-dpatch מיועד רק להחיל תיקון פשוט, יש אפילו
דרך קלה יותר:

dpatch patch-template -p "01_some_patch" "תיקון אקראי" \
debian/patches/01_some_patch.dpatch

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