debtree - מקוון בענן

תָכְנִית:

שֵׁם

debtree - הצג קשרים בין חבילות

תַקצִיר

עץ חובות [אפשרויות] חבילה

תיאור

יוצר גרפי תלות (בתחביר 'נקודה') עבור החבילה שצוינה. הפלט הוא
נכתב ל-STDOUT וניתן להשתמש בו כקלט עבור הפקודה נקודה(1) מהחבילה
`graphviz'.

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

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

תלות סוגים
סוג התלות בין החבילות הוא לפי סוג הקו וצבע החץ
מציין את התלות:
מבנה תלוי: זהב כהה, מודגש
Build-Depends-Indep: זהב בהיר
תלוי מראש: סגול, מודגש
תלוי: כחול
ממליצה: שחור
מציע: שחור, מנוקד
קונפליקטים: אדום
מספק: חץ ירוק, הפוך

כברירת מחדל, יוצגו דרישות הגרסה עבור תלות והתנגשויות גרסאות
לצד החץ.

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

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

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

ראה גם את האפשרות --show-installed למטה.

וירטואלי חבילות
חבילות וירטואליות יוצגו כצורה מתומנת עם חץ ירוק הפוך מה-
מתן חבילות.

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

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

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

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

חֲבִילָה גירסאות
אם גרסאות מרובות של חבילה זמינות, מידע התלות של ה-
הגרסה הכי זמינה תשמש, למעט חריג אחד. אם האפשרות --show-installed
בשימוש, הגרסה המותקנת תשמש עבור חבילות המותקנות במערכת.

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

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

עבור חלק מהחבילות, למרבה הצער כמעט בלתי אפשרי ליצור תלות שמישה
גרף בשל מספר התלות שיש להם. זה קורה לעתים קרובות עבור meta
חבילות, למשל אלה עבור KDE או GNOME.

אפשרויות

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

--הצג מותקן, -I
הצג אילו חבילות מותקנות במערכת.

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

--show-rdeps, -R
הצג גם תלות הפוכה של החבילה וכל חבילה וירטואלית שהיא מספקת.

תלות הפוכה שאינה מותקנת ייצבעו בצהוב בהיר; מוּתקָן
אלה תכלת. הצגת תלות הפוכה מסוג Suggests אינה נתמכת.

מומלץ להשתמש באפשרות --show-installed בשילוב עם אפשרות זו.
ראה גם את האפשרויות --rdeps-depth ו--max-rdeps. אפשרות זו מתעלמת אם
--build-dep מצוין גם.

--build-dep, -b
הצג תלות בבנייה במקום תלות בחבילה.

חבילות מוצעות לעולם לא ייכללו בגרף תלות בבנייה. אם יש
הן חבילות חלופיות כדי לספק תלות, בדרך כלל רק הראשונה
תוצג חלופה. עם זאת, בשימוש בשילוב עם
---show-installed option, כל החלופות שכבר הותקנו ייכללו עבור
תלות מסופקות (אלא אם כן ניתנת גם האפשרות --no-alternatives).

--קֶשֶׁת=ארכיטקטורה
ציין את הארכיטקטורה (או 'הכל') עבור גרף התלות בבנייה. אם האפשרות
אפשרות --buildep אינה קיימת, אפשרות זו תתעלם. ברירת המחדל היא ה
ארכיטקטורת המערכת בה הפקודה מופעלת.

אם ארכיטקטורת 'הכל' מצוינת, כל תלות הבנייה תוצגנה. אם בכלל
לתלות בבנייה יש 'תנאי ארכיטקטורה', אלה יוצגו ב-a
גרף.

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

--עם-הצעות, -S
כלול חבילות מוצעות; תלות של חבילות מוצעות לעולם אינן נכללות.

--לא-ממליצה
אל תציג חבילות מומלצות.

אפשרות זו תתעלם אם תשתמש בשילוב עם האפשרות --with-suggests.

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

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

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

--ללא גרסאות
אל תראה את הגרסאות עבור תלות מנוסחת.

--ללא עימותים
אל תראה התנגשויות ללא גרסה.

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

אפשרות זו תתעלם אם תעשה בה שימוש בשילוב עם האפשרות --no-conflicts.

--מקסימום עומק=מספר
הגבל את מספר רמות התלות שמועברות.

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

ניתן להשתמש באפשרות גם כדי להקטין את גודל הגרפים.

--rdeps-depth=מספר
המספר המרבי של רמות עבור תלות הפוכה.

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

--max-rdeps=מספר
הגבל את התצוגה של תלות עקיפה לאחור.

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

--לא לדלג
הצג גם תלות שנדחקות כברירת מחדל (למשל libc6).

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

--הצג הכול
הצג את עץ התלות המלא.

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

אפשרות זו מרמזת על האפשרות --no-dislip, אך ניתן להשתמש בה בשילוב עם
--אפשרות עומק מקסימלית. שימו לב כי אפשרות זו אינה משפיעה על סוגי התלות
הכלולים.

--להתחלף, -r
צייר את הגרף מהעיר העליונה במקום משמאל לימין.

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

--שֶׁקֶט, -q
דחק כל הודעת מידע/אזהרה.

--מִלוּלִי, -v
הגבר את מידת המלל.

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

תְצוּרָה

עץ חובות ניתן להגדיר להגביל את הגודל והמורכבות של גרפי תלות. זה
נעשה באמצעות שתי רשימות:

/etc/debtree/skiplist, ~/.debtree/skiplist
רשימה של לדלג חבילות. החבילות הכלולות ברשימה זו אינן נכללות לחלוטין
גרפים. הרשימה צריכה להכיל רק תלות שכל כך נפוצה שכוללת
הם בגרפים רק מבלבלים את הגרף ולא ממש מוסיפים שום מידע.
דוגמאות הן libc6 ו-zlib1g. אם תלות חלופית מכילה רק דלג
חבילות זה יושמט; אם הוא מכיל שילוב של חבילות דילוג וחבילות ללא דילוג,
הנוכחות של חבילות הדילוג תוצג באמצעות אליפסיס ('...').

/etc/debtree/endlist, ~/.debtree/endlist
רשימה של סוף חבילות. חבילות הכלולות ברשימה זו מוצגות בגרף, אבל
התלות שלהם לא תוצג. צורת יהלום משמשת לציון סוף
חֲבִילָה; במקרה של תלות חלופית, שם החבילה יוצג
בין סוגרים: `{...}'.

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

אם קיימת רשימה תחת ספריית HOME של המשתמש, הקובץ הזה ישמש במקום זאת
של קובץ ברירת המחדל ב-/etc/debtree/.

ראה גם את האפשרויות --ללא דילוג, --show-all ו--max-depth.

דוגמאות

להלן כמה דוגמאות שימוש בסיסיות עבור עץ חובות. לדוגמאות נרחבות יותר של גרפים
ומידע נוסף, אנא עיין ב עץ חובות אתר אינטרנט: http://collab-
maint.alioth.debian.org/debtree.

$ debtree dpkg >dpkg.dot
צור את גרף התלות עבור החבילה dpkg ושמור את הפלט לקובץ
'dpkg.dot'.

$ dot -Tsvg -o dpkg.svg dpkg.dot
השתמש נקודה(1) כדי ליצור תמונת SVG מקובץ `.dot'.

$ debtree dpkg | dot -Tpng >dpkg.png
צור את גרף התלות עבור החבילה dpkg כתמונת PNG ושמור את המתקבל
פלט לקובץ.

$ debtree -b dpkg | dot -Tps | kghostview - &
צור את גרף התלות בבנייה עבור החבילה dpkg בפורמט פוסטסקריפ ותצוגה
התוצאה באמצעות KDE kghostview(1).

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