busctl - מקוון בענן

תָכְנִית:

שֵׁם

busctl - התבוננות פנימית באוטובוס

תַקצִיר

busctl [אפשרויות...] [פקודה] [שֵׁם...]

תיאור

busctl עשוי לשמש להתבוננות פנימית ולניטור האוטובוס D-Bus.

אפשרויות

האפשרויות הבאות מובנות:

--כתובת=כתובת
התחבר לאוטובוס המצוין על ידי כתובת במקום להשתמש בברירות מחדל מתאימות לשניהם
המערכת או אוטובוס המשתמש (ראה --מערכת ו --מִשׁתַמֵשׁ אפשרויות).

--הצג-מכונה
בעת הצגת רשימת העמיתים, הצג עמודה המכילה את שמות המכלים שהם
שייך ל. לִרְאוֹת systemd-machined.service(8).

--ייחודי
בעת הצגת רשימת העמיתים, הצג רק שמות "ייחודיים" (של הטופס
":מספר.מספר").

--נרכש
ההפך מ --ייחודי — רק שמות "ידועים" יוצגו.

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

--match=MATCH
בעת הצגת הודעות המוחלפות, הצג רק את התאמת קבוצת המשנה MATCH.

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

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

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

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

--צפוי-תשובה=BOOL
בשימוש עם ה שיחה פקודה, מציינת אם busctl ימתין להשלמת
קריאת השיטה, פלט את נתוני תגובת השיטה שהוחזרו, והחזר הצלחה או
כשל באמצעות קוד היציאה מהתהליך. אם זה מוגדר ל"לא", קריאת השיטה תהיה
הוצא אך לא צפויה תגובה, הכלי מסתיים באופן מיידי, ולפיכך לא
ניתן להציג תגובה, ולא מוחזרת הצלחה או כישלון באמצעות קוד היציאה. ל
רק לדכא פלט של מטען הודעת התשובה, השתמש --שֶׁקֶט מֵעַל. ברירת מחדל ל
"כן".

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

--allow-interactive-authorization=BOOL
בשימוש עם ה שיחה פקודה, מפרט אם השירותים יכולים לאכוף
הרשאה אינטראקטיבית בזמן ביצוע הפעולה, אם מדיניות האבטחה היא כזו
מוגדר לכך. ברירת המחדל היא "כן".

--פסק זמן=שניות
בשימוש עם ה שיחה הפקודה, מציינת את הזמן המקסימלי להמתנה לקריאת השיטה
סִיוּם. אם לא צוינה יחידת זמן, מניח שניות. היחידות האחרות הרגילות הן
מובן גם הוא (ms, us, s, min, h, d, w, month, y). שים לב שפסק זמן זה לא
להחיל אם --expect-reply=לא נעשה שימוש, מכיוון שהכלי אינו ממתין לשום הודעת תשובה
לאחר מכן. כאשר לא מצוין או כאשר הוא מוגדר ל-0, ההנחה היא ברירת המחדל של "25s".

--augment-creds=BOOL
שולט אם נתוני אישורים מדווחים על ידי רשימה or מצב יוגדל עם
נתונים מ-/proc. כאשר זה מופעל, ייתכן שהנתונים המוצגים אינם עקביים, כמו
הנתונים שנקראו מהם / proc עשוי להיות עדכני יותר משאר האישורים
מֵידָע. ברירת המחדל היא "כן".

--מִשׁתַמֵשׁ
שוחח עם מנהל השירות של המשתמש המתקשר, ולא עם מנהל השירות של
המערכת.

--מערכת
שוחח עם מנהל השירות של המערכת. זוהי ברירת המחדל המשתמעת.

-H, -מארח =
בצע את הפעולה מרחוק. ציין שם מארח, או שם משתמש ושם מארח
מופרדים על ידי "@", כדי להתחבר אליו. ניתן להוסיף את שם המארח באופן אופציונלי ב-a
שם מיכל, מופרד על ידי ":", שמתחבר ישירות למיכל ספציפי על
המארח שצוין. זה ישתמש ב-SSH כדי לדבר עם מופע מנהל המחשב המרוחק.
ניתן למנות שמות מיכלים עם machinectl -H HOST.

-M, --מכונה=
בצע פעולה על קונטיינר מקומי. ציין שם מיכל להתחבר אליו.

--ללא איתור
אל תעביר פלט לביפר.

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

-h, - עזרה
הדפיסו טקסט עזרה קצר וצאו.

--גִרְסָה
הדפיסו מחרוזת גרסה קצרה וצאו.

פקודות

הפקודות הבאות מובנות:

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

מצב [שֵׁרוּת]
הצג מידע תהליך ותעודות של שירות אוטובוס (אם מסומן על ידי שירות אוטובוס
שם ייחודי או ידוע), תהליך (אם אחד מצוין על ידי ה-PID המספרי שלו), או ה
בעל האוטובוס (אם לא צוין פרמטר).

צג [שֵׁרוּת...]
הודעות Dump מוחלפות. אם שֵׁרוּת צוין, הצג הודעות אל או ממנו
עמית, מזוהה בשמו הידוע או הייחודי. אחרת, הצג את כל ההודעות ב-
אוֹטוֹבּוּס. השתמש ב-Ctrl-C כדי לסיים את ה-dump.

ללכוד [שֵׁרוּת...]
דומה צג אבל כותב את הפלט בפורמט pcap (לפרטים, ראה את ליבקאפ
שלח פוּרמָט[1] תיאור. הקפד להפנות את הפלט ל-STDOUT לקובץ.
כלים כמו Wireshark(1) ניתן להשתמש כדי לנתח ולהציג את הקבצים שנוצרו.

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

התבוננות פנימית שֵׁרוּת מטרה [ממשק]
הצג ממשקים, שיטות, מאפיינים ואותות של האובייקט שצוין (זוהה
לפי הנתיב שלו) בשירות שצוין. אם ארגומנט הממשק מועבר, הפלט
מוגבל לחברים בממשק שצוין.

שיחה שֵׁרוּת מטרה ממשק שיטה [SIGNATURE [טיעון...]]
הפעל שיטה והצג את התגובה. לוקח שם שירות, נתיב אובייקט, ממשק
שם ושם שיטה. אם פרמטרים יועברו לקריאת השיטה, חתימה
נדרשת מחרוזת, ואחריה הארגומנטים, המעוצבים בנפרד כמחרוזות. ל
פרטים על העיצוב בשימוש, ראה להלן. כדי לדכא פלט של הנתונים המוחזרים,
להשתמש --שֶׁקֶט אוֹפְּצִיָה.

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

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

לעזור
הצג עזרה בתחביר פקודות.

פרמטר עיצוב

אל האני שיחה ו סט-נכס פקודות לוקחות מחרוזת חתימה ואחריה רשימה של
פרמטרים המעוצבים כמחרוזת (לפרטים על מחרוזות חתימה של D-Bus, ראה את סוּג
מערכת פרק of מה היא אוטובוס D מפרט[2]). עבור סוגים פשוטים, כל פרמטר הבא
החתימה צריכה להיות פשוט ערך הפרמטר המעוצב כמחרוזת. בוליאני חיובי
ערכים עשויים להיות מעוצבים כ-"true", "yes", "on" או "1"; ערכים בוליאניים שליליים עשויים להיות
צוין כ"שקר", "לא", "כבוי" או "0". עבור מערכים, ארגומנט מספרי עבור המספר
יצוינו של הערכים ואחריהם הערכים. עבור גרסאות, החתימה של
התוכן יצוין, ואחריו התוכן. עבור מילונים ומבנים, ה
תוכנם יצוין ישירות.

לדוגמה,

לסת

הוא העיצוב של מחרוזת יחידה "jawoll".

בתור 3 foobar שלום עולם

הוא עיצוב של מערך מחרוזות עם שלושה ערכים, "שלום", "עולם" ו-"foobar".

a{sv} 3 One s Eins Two u 2 כן ב נכון

הוא עיצוב של מערך מילון שממפה מחרוזות לווריאציות, המורכב משלושה
ערכים. למחרוזת "One" מוקצה המחרוזת "Eins". למחרוזת "שניים" מוקצה ה
מספר שלם ללא סימן של 32 סיביות 2. המחרוזת "כן" מוקצה בוליאני חיובי.

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

דוגמאות

דוגמה 1. לכתוב ו חומר עיוני a נכס

שתי הפקודות הבאות כותבות תחילה מאפיין ולאחר מכן קוראים אותו בחזרה. הנכס הוא
נמצא באובייקט "/org/freedesktop/systemd1" של שירות "org.freedesktop.systemd1".
שם הנכס הוא "LogLevel" ב-"org.freedesktop.systemd1.Manager"
מִמְשָׁק. המאפיין מכיל מחרוזת אחת:

# busctl set-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager LogLevel s debug
# busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager LogLevel
של "ניפוי באגים"

דוגמה 2. תַמצִיתִי ו מילולית תְפוּקָה

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

$ busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager Environment
כ-2 "LANG=en_US.UTF-8" "PATH=/ usr / local / sbin:/ usr / local / bin:/ usr / sbin:/ usr / bin"
$ busctl get-property --verbose org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager Environment
מערך "s" {
STRING "LANG=en_US.UTF-8";
STRING "PATH=/ usr / local / sbin:/ usr / local / bin:/ usr / sbin:/ usr / bin";
};

דוגמה 3. מזמין a שִׁיטָה

הפקודה הבאה מפעילה את שיטת "StartUnit" ב-
ממשק "org.freedesktop.systemd1.Manager" של האובייקט "/org/freedesktop/systemd1" של
שירות "org.freedesktop.systemd1", ומעביר לו שתי מחרוזות "cups.service" ו
"החלף". כתוצאה מקריאה למתודה, מתקבל פרמטר נתיב אובייקט בודד ו
מוצגות סדרות

# busctl call org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager StartUnit ss "cups.service" "replace"
o "/org/freedesktop/systemd1/job/42684"

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