lstopo - מקוון בענן

תָכְנִית:

שֵׁם

lstopo, lstopo-no-graphics, hwloc-ls - הצג את הטופולוגיה של המערכת

תַקצִיר

לסטופו [ אפשרויות ]... [ שם הקובץ ]

lstopo-no-graphics [ אפשרויות ]... [ שם הקובץ ]

hwloc-ls [ אפשרויות ]... [ שם הקובץ ]

שים לב כי הולל(7) מספק הסבר מפורט על מערכת hwloc; צריך לקרוא אותו
לפני שקוראים את דף האיש הזה

אפשרויות

--שֶׁל , --פורמט פלט
אכוף את הפלט בפורמט הנתון. עיין בסעיף פורמטים של פלט למטה.

-i , --קֶלֶט
קרא טופולוגיה מקובץ XML (במקום לגלות את הטופולוגיה על
מכונה מקומית). אם הוא "-", נעשה שימוש בקלט הסטנדרטי. תמיכה ב-XML חייבת
הידור ב-hwloc כדי שהאפשרות הזו תהיה שמישה.

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

-i , --קֶלֶט
הדמיית היררכיה מזויפת (במקום לגלות את הטופולוגיה המקומית
מְכוֹנָה). אם הוא "node:2 pu:3", הטופולוגיה תכיל שני NUMA
צמתים עם 3 יחידות עיבוד בכל אחד מהם. ה המחרוזת חייבת להסתיים
עם מספר PUs.

--אם , --פורמט הכנסה
לאכוף את הקלט בפורמט הנתון, בין xml, fsroot ו סינטטי.

--יצוא-סינטטי-דגלים
לאכוף דגלים בעת ייצוא לפורמט הסינטטי. דגלים אלו מועברים ל
hwloc_topology_export_synthetic(). ערך של 2 חוזר לפורמט של hwloc
v1.9. ערך של 3 חוזר לפורמט המינימליסטי המקורי (לפני גרסה 1.9).

-v --מִלוּלִי
כלול פרטים נוספים. ניתן להשתמש בכלי hwloc-info כדי להציג עוד יותר
מידע על חפצים ספציפיים.

-s --שקט
צמצם את כמות הפרטים להצגה.

-f --כּוֹחַ
אם קובץ היעד כבר קיים, החלף אותו.

-l --הגיוני
הצג אינדקסים לוגיים של hwloc במקום אינדקסים פיזיים/מערכת הפעלה (ברירת מחדל עבור המסוף
תְפוּקָה). הקידומת של האינדקסים הללו "L#". המדדים הפיזיים של חלקם
אובייקטים (PU ו-Node כברירת מחדל, כל האובייקטים אם מילוליים) יופיעו כאובייקט
התכונה "P#...".

-p --גוּפָנִי
הצג אינדקסים של מערכת הפעלה/פיזי במקום אינדקסים לוגיים של hwloc (ברירת מחדל עבור גרפי
תְפוּקָה). הקידומת של אינדקסים אלו "P#" במקום "L#" במסוף
פלט.

-c --cpuset
הצג את ערכת העיבוד של כל אובייקט.

-C --cpuset-בלבד
הצג רק את ערכת העיבוד של כל אובייקט; אל תציג שום דבר אחר על
אובייקט.

--סט משימות
הצג מחרוזות ערכת CPU בפורמט המזוהה על ידי תוכנית שורת הפקודה taskset
במקום תבנית מחרוזת הגדרת המעבד הספציפית ל-hwloc. יש לשלב אפשרות זו
עם --cpuset or --cpuset-בלבד, אחרת זה ירמז --cpuset.

--רק
הצג רק אובייקטים מהסוג הנתון בפלט הטקסטואלי.

--להתעלם
התעלם מכל האובייקטים מסוג בטופולוגיה. hwloc תומך בהתעלמות מכל
סוג למעט PUs והתקני I/O. עם זאת lstopo עדיין מציעה התעלמות מ-PU על ידי הסתרה
אובייקטי PU בפלטים הגרפיים והטקסטואליים. שימו לב שלא ניתן להתעלם מ-PU
בפלט ה-XML. שימו לב גם שלא ניתן להתעלם מסוג האובייקט ברמה העליונה
(בדרך כלל מכונה או מערכת).

--ללא מטמונים
אל תציג מטמונים.

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

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

--כל המערכת
אל תשקול מגבלות ניהול.

--לְמַזֵג
אל תציג רמות שאין להן השפעה היררכית. זה מתקשר
hwloc_topology_ignore_all_keep_structure().

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

--לְהַגבִּיל
הגבל את הטופולוגיה ל-cpuset הנתון.

--לְהַגבִּיל כריכה
הגבל את הטופולוגיה לכריכת התהליך הנוכחי. אפשרות זו דורשת שימוש
של טופולוגיית המכונה הנוכחית בפועל (או כל טופולוגיה אחרת עם --המערכת הזאת or
כאשר HWLOC_THISSYSTEM מוגדר ל-1 בסביבה).

--restrict-flags
לאכוף דגלים בעת הגבלת הטופולוגיה. ברירת המחדל היא 0. הדגלים האלה הם
עבר ל hwloc_topology_restrict().

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

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

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

--המערכת הזאת
נניח שה-backend שנבחר מספק את הטופולוגיה עבור המערכת שבה אנחנו
רצים. זה שימושי בעת השימוש --לְהַגבִּיל כריכה וטעינת מותאם אישית
טופולוגיה כגון קובץ XML.

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

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

--גודל גופן
הגדר את גודל גופן הטקסט.

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

--horiz, --horiz=
פריסה גרפית אופקית במקום יחס של כמעט 4/3. אם רשימה מופרדת בפסיקים
של סוגים נתון, הפריסה חלה רק על המכולות התואמות.

--vert, --vert=
פריסה גרפית אנכית במקום יחס של כמעט 4/3. אם רשימה מופרדת בפסיקים
של סוגים נתון, הפריסה חלה רק על המכולות התואמות.

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

--ללא אגדה
הסר את מקרא הטקסט בתחתית.

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

--גִרְסָה
דווח על גרסה ויציאה.

תיאור

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

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

תפוקה פורמטים

כברירת מחדל, אם אין שם קובץ פלט ספציפי, הפלט נשלח לחלון גרפי if
אפשרי בסביבה הנוכחית (משתנה סביבת DISPLAY מוגדר ב-Unix וכו').
אחרת, סיכום טקסט מוצג במסוף.

שם הקובץ בשורת הפקודה קובע בדרך כלל את הפורמט של הפלט. ישנם
כמה שמות קבצים המציינים פורמטים והתקנים ספציפיים של פלט (למשל, שם קובץ של "-"
יוציא סיכום טקסט ל-stdout), אך רוב שמות הקבצים מציינים את הפלט הרצוי
פורמט לפי הסיומת שלהם (למשל, "topo.png" loading="lazy" יוציא קובץ בפורמט PNG).

ניתן לשנות את הפורמט של הפלט עם "--of". לדוגמה, "--of pdf" יהיה
צור קובץ בפורמט PDF על הפלט הסטנדרטי, בעוד "--of fig toto" יוציא א
קובץ בפורמט Xfig בשם "toto".

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

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

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

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

תאנה פלט ייצוג של המפה שניתן לטעון ב-Xfig.

PDF אם lstopo הידור עם התמיכה המתאימה, lstopo מוציא ייצוג PDF
של המפה.

ps אם lstopo הידור עם התמיכה המתאימה, lstopo מוציא Postscript
ייצוג המפה.

png אם lstopo הידור עם התמיכה המתאימה, lstopo מוציא ייצוג PNG
של המפה.

SVG אם lstopo הידור עם התמיכה המתאימה, lstopo מוציא SVG
ייצוג המפה.

סינטטי
אם הטופולוגיה היא סימטרית (מה שמצריך שלאובייקט השורש יש את שלו
symmetric_subtree set), lstopo מוציא מחרוזת תיאור סינתטית. זֶה
ניתן לעשות שימוש חוזר בפלט כתיאור טופולוגיה סינתטית של קלט מאוחר יותר. ציין זאת
התקני קלט/פלט גורמים לרוב לאסימטריה בטופולוגיה. הוספת --no-io עשויה להיות שימושית כאשר
הייצוא הסינטטי נכשל. עיין גם בסעיף טופולוגיות סינתטיות ב-
תיעוד.

xml אם lstopo הידור עם התמיכה המתאימה, lstopo מוציא XML
ייצוג המפה. ניתן לעשות בו שימוש חוזר מאוחר יותר, אפילו במכונה אחרת, עם
lstopo --input, משתנה הסביבה HWLOC_XMLFILE, או ה-
הפונקציה hwloc_topology_set_xml().

ניתן להשתמש בשמות המיוחדים הבאים:

- שלח סיכום טקסט אל stdout.

/dev/stdout
שלח סיכום טקסט אל stdout. זה למעשה זהה לציון "-".

-.
אם שם הקובץ כולו הוא "-. ", lstopo מתנהג כאילו "--of -" היה
given, כלומר קובץ בפורמט הנתון נשלח לפלט הסטנדרטי.

עיין בפלט של "lstopo --help" עבור רשימה ספציפית של פורמטים של פלט גרפי
נתמך בהתקנת hwloc שלך.

צבעים

מעבדים בודדים נצבעים בתבניות הפלט הגרפי כדי לציין שונה
מאפיינים:

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

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

אדום המעבד אינו בסט המותר (ראה להלן).

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

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

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

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

המותאם אישית צבעים

ניתן לאכוף את הצבע של כל אובייקט בפלט הגרפי על ידי ציון א
תכונת המידע "lstopoStyle" באובייקט זה. הערך שלו צריך להיות מופרד בנקודה-פסיק
רשימה של " =#rrggbb" כאשר rr, gg ו-bb הם רכיבי ה-RGB של צבע, כל אחד
בין 0 ל-255, בהקסדצימלי (00 עד ff). אולי

רקע
מגדיר את צבע הרקע של תיבת האובייקט הראשי.

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

טקסט מגדיר את צבע הטקסט המציג את שם האובייקט, הסוג, האינדקס וכו'.

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

ניתן להוסיף את המידע "lstopoStyle" לטופולוגיות XML שנשמרו זמנית עם hwloc-
הערה, או עם hwloc_obj_add_info(). לדוגמה, כדי להציג את כל אובייקטי הליבה בכחול
(עם שמות לבנים):

lstopo save.xml
hwloc-annotate save.xml save.xml core:all info lstopoStyle
"Background=#0000ff;Text=#ffffff"
lstopo -i save.xml

מערך

בפלט הגרפי שלה, lstopo משתמש בהיוריסטיקה מלבנית פשוטה כדי לנסות להשיג 4/3
יחס בין רוחב לגובה. עם זאת, במקרה הספציפי של צמתי NUMA, הפריסה
הוא תמיד מלבן שטוח, כדי להימנע מלאפשר למשתמש להאמין בטופולוגיה מסוימת של NUMA
(lstopo לא מסוגלת לעבד את זה עדיין). הפריסה של רמה עשויה להשתנות עם
--vert, --horiz ו- --rect.

דוגמאות

כדי להציג את טופולוגיית המכונה במצב טקסטואלי:

lstopo-no-graphics

כדי להציג את טופולוגיית המכונה במצב ascii-art:

lstopo-no-graphics -.ascii

לתצוגה במצב גרפי (בהנחה שמשתנה הסביבה DISPLAY מוגדר ל-a
ערך רלוונטי):

לסטופו

כדי לייצא את הטופולוגיה לקובץ PNG:

lstopo file.png

כדי לייצא קובץ XML במחשב ולהציג מאוחר יותר את הפלט הגרפי המתאים ב-
מכונה אחרת:

machine1$ lstopo file.xml

machine2$ lstopo --input file.xml

כדי לשמור את טופולוגיית המכונה הנוכחית ל-XML ולאחר מכן לטעון אותה מחדש מהר יותר בזמן שדומם
מחשיב את זה כמכונה הנוכחית:

$ lstopo file.xml
<...>
$ lstopo --input file.xml --thisssystem

כדי להגביל טופולוגיית XML למעבדים פיזיים 0, 1, 4 ו-5 בלבד:

lstopo --input file.xml --restrict 0x33 newfile.xml

כדי להגביל טופולוגיית XML לצומת numa בלבד שהאינדקס הלוגי שלו הוא 1:

lstopo --input file.xml --restrict $(hwloc-calc --input file.xml node:1) newfile.xml

כדי להציג תקציר של הטופולוגיה:

lstopo -s

לקבלת פרטים נוספים על הטופולוגיה:

lstopo -v

כדי להציג רק ליבות:

lstopo --רק ליבה

כדי להציג ערכות מעבד:

lstopo --cpuset

כדי להציג רק את ערכות המעבד של החבילה:

חבילת lstopo --only --cpuset-only

הדמיית היררכיה מזויפת; דוגמה זו מציגה עם 2 צמתים NUMA של 2 יחידות מעבד:

lstopo --קלט "n:2 2"

לספור את מספר המעבדים הלוגיים במערכת

lstopo --רק pu | wc -l

כדי לצרף את המהדורה והגרסה של הליבה לאגדה הגרפית:

lstopo --append-legend "גרסת ליבה: $(uname -r)" --append-legend "גרסת ליבה:
$(uname -v)"

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