זוהי הפקודה nbdkit שניתן להפעיל בספק האירוח החינמי של OnWorks באמצעות אחת מתחנות העבודה המקוונות המרובות שלנו, כגון Ubuntu Online, Fedora Online, אמולטור מקוון של Windows או אמולטור מקוון של MAC OS
תָכְנִית:
שֵׁם
nbdkit - ערכת כלים ליצירת שרתי NBD
תַקצִיר
nbdkit [--dump-config] [-f] [-g GROUP] [-i IPADDR]
[-P PIDFILE] [-p PORT] [-r] [--הפעל CMD] [-s]
[-U SOCKET] [-u USER] [-v] [-V]
PLUGIN [מפתח=ערך [מפתח=ערך [...]]]
תיאור
Network Block Device (NBD) הוא פרוטוקול רשת לגישה למכשירי חסימה דרך
רֶשֶׁת. התקני בלוק הם דיסקים קשיחים ודברים שמתנהגים כמו דיסקים קשיחים כמו דיסק
תמונות ומכונות וירטואליות.
"nbdkit" הוא גם ערכת כלים ליצירת שרתי NBD ממקורות "לא שגרתיים" וגם
שם של שרת NBD.
כדי ליצור מקור חדש של מכשיר חסימת רשת, כל מה שאתה צריך לעשות הוא לכתוב כמה דבקים
פונקציות, אולי ב-C, או אולי בשפה ברמה גבוהה כמו Perl או Python. ה
רישוי ליברלי של nbdkit נועד לאפשר לך לקשר את nbdkit עם קנייני
ספריות או לכלול nbdkit בקוד קנייני.
אם אתה רוצה לכתוב תוסף nbdkit, אתה צריך לקרוא nbdkit-plugin(3).
ניתן למצוא מספר תוספים ב-"$libdir/nbdkit/plugins". אתה יכול לתת את הדרך המלאה
הפלאגין, כך:
nbdkit $libdir/nbdkit/plugins/nbdkit-file-plugin.so [...]
אבל בדרך כלל נוח יותר להשתמש בתחביר המקביל הזה:
קובץ nbdkit [...]
$libdir מוגדר בזמן הידור. כדי להדפיס אותו, בצע:
nbdkit --dump-config
דוגמאות
הגש את הקובץ "disk.img" ביציאה 10809:
קובץ nbdkit file=disk.img
הפעל את הפלאגין example1 והתחבר אליו באמצעות דג אורח(1):
דוגמה nbdkit1
guestfish --ro -a nbd://localhost
הפעל את הפלאגין example3 והתחבר אליו באמצעות דג אורח(1):
nbdkit example3 size=1G
guestfish --ro -a nbd://localhost
כדי להציג מידע שימוש על תוסף ספציפי:
nbdkit --עזרה דוגמה1
גלובלי אפשרויות
- עזרה
הצג מידע קצר על שימוש בשורת הפקודה וצא.
--dump-config
זרוק את ערכי התצורה של זמן ההידור וצא.
-f
--חֲזִית
--ללא מזלג
לא מזלג ברקע.
-g קבוצה
--קְבוּצָה קבוצה
שנה קבוצה ל-"GROUP" לאחר ההפעלה. שם קבוצה או מזהה קבוצה מספרי יכול להיות
מְשׁוּמָשׁ.
השרת צריך הרשאות מספיקות כדי להיות מסוגל לעשות זאת. בדרך כלל זה יהיה
מתכוון להפעיל את השרת בתור שורש.
ראה גם -u.
-i IPADDR
--ip-addr IPADDR
--ipaddr IPADDR
האזינו בממשק שצוין. ברירת המחדל היא להאזין בכל הממשקים. לִרְאוֹת
גם -p.
-P PIDFILE
--pid-file PIDFILE
--pidfile PIDFILE
כתוב "PIDFILE" (המכיל את מזהה התהליך של השרת) לאחר ש-nbdkit הופך להיות מוכן
לקבל חיבורים.
אם הקובץ כבר קיים, הוא מוחלף. nbdkit עושה לֹא למחוק את הקובץ מתי
זה יוצא.
-p נמל
--נמל נמל
שנה את מספר יציאת ה-TCP/IP שבו nbdkit משרת בקשות. ברירת המחדל היא 10809.
ראה גם -i.
-r
--לקריאה בלבד
--לקריאה בלבד
הייצוא יהיה לקריאה בלבד. אם לקוח כותב, הוא יקבל שגיאה.
שים לב שחלק מהפלאגינים מטבעם אינם תומכים בכתיבה. עם התוספים האלה -r
אפשרות מתווספת באופן מרומז.
פונקציונליות העתקה על כתיבה (או "תמונת מצב") אינה נתמכת על ידי שרת זה. למרות זאת
אם אתה משתמש ב-qemu כלקוח (או בעקיפין דרך libguestfs) אז זה תומך
צילומי מצב.
--לָרוּץ CMD
הפעל את nbdkit כתת-תהליך שבוי של "CMD". כאשר "CMD" יוצא, nbdkit נהרג. לִרְאוֹת
"CPTIVE NBDKIT" למטה.
מרמז על אפשרות זו --חֲזִית.
-s
--יחיד
--סטדין
אל תתפצל. טפל בחיבור NBD בודד על stdin/stdout. לאחר סגירת stdin, ה
יציאת השרת.
אתה יכול להשתמש באפשרות זו כדי להפעיל את nbdkit מ-inetd, systemd או שרתי-על דומים; אוֹ
רק לבדיקה; או אם אתה רוצה להפעיל את nbdkit בצורה לא קונבנציונלית.
מרמז על אפשרות זו --חֲזִית.
-U שֶׁקַע
--יוניקס שֶׁקַע
-U -
--יוניקס -
קבל חיבורים על שקע התחום של יוניקס "SOCKET" (שהוא נתיב).
nbdkit יוצר את השקע הזה, אבל כנראה יהיו לו הרשאות שגויות (גם
מַתִיר). אם זו בעיה שמשתמש לא מורשה יכול להתחבר לזה
שקע בין הזמן שבו nbdkit מופעלת והמשתמש המורשה מתחבר, אז
הכניסו את השקע לספרייה שיש לה הרשאות מגבילות.
nbdkit עושה זאת לֹא מחק את קובץ ה-socket כשהוא יוצא. על המתקשר למחוק את ה
קובץ socket לאחר השימוש (אחרת אם תנסה להפעיל את nbdkit שוב תקבל קובץ
השגיאה "כתובת כבר בשימוש").
אם שם השקע הוא - ואז nbdkit מייצר שקע פרטי בשם אקראי. זֶה
שימושי עם "CAPTIVE NBDKIT".
-u משתמש
--מִשׁתַמֵשׁ משתמש
שנה את המשתמש ל-"USER" לאחר ההפעלה. ניתן להשתמש בשם משתמש או מזהה משתמש מספרי.
השרת צריך הרשאות מספיקות כדי להיות מסוגל לעשות זאת. בדרך כלל זה יהיה
מתכוון להפעיל את השרת בתור שורש.
ראה גם -g.
-v
--מִלוּלִי
אפשר הודעות מילוליות.
זה רעיון טוב להשתמש -f גם כך שהתהליך לא יתפצל לרקע
(אך לא חובה).
-V
--גִרְסָה
הדפס את מספר הגרסה של nbdkit וצא.
חיבור תְצוּרָה
לאחר ציון שם הפלאגין אתה יכול (אופציונלי, זה תלוי בתוסף) לתת
תצורת תוסף בשורת הפקודה בצורה של "מפתח=ערך". לדוגמה:
קובץ nbdkit file=disk.img
כדי לרשום את כל האפשרויות הנתמכות על ידי תוסף, בצע:
nbdkit --קובץ עזרה
שָׁבוּי NBDKIT
אתה יכול להפעיל את nbdkit כ"תהליך שבוי", באמצעות ה --לָרוּץ אוֹפְּצִיָה. זה אומר ש-nbdkit
פועל כל עוד (לדוגמה) qemu(1) או דג אורח(1) פועל. כאשר אלה יוצאים, nbdkit
נהרג.
כמה דוגמאות אמורות להבהיר זאת.
כדי להפעיל את nbdkit בשבי תחת qemu:
קובץ nbdkit file=disk.img --הפעל את 'qemu -drive file=$nbd,if=virtio'
בשורת הפקודה qemu, $nbd מוחלף אוטומטית בנתיב ה-NBD הנכון כך שהוא
יכול להתחבר לnbdkit. כאשר qemu יוצא, nbdkit נהרג ומנקה אוטומטית.
הפעלת nbdkit בשבי תחת דג אורח:
קובץ nbdkit file=disk.img --הפעל 'guestfish --format=raw -a $nbd -i'
כאשר דג אורח יוצא, nbdkit נהרג.
משתני המעטפת הבאים זמינים ב- --לָרוּץ טענה:
$nbd
כתובת URL שמתייחסת ליציאת nbdkit או לשקע.
שימו לב שיש כאן קסם, מכיוון שלכתובות האתרים של qemu ו-guestfish יש פורמט שונה,
אז nbdkit מנסה לנחש באיזה אתה פועל. אם הקסם לא עובד, נסה להשתמש
המשתנים למטה במקום זאת.
$port
אם ≠ "", מספר היציאה ש-nbdkit מאזין לו.
$unixsocket
אם ≠ "", שקע התחום של Unix שבו nbdkit מאזין.
--לָרוּץ מרמז --חֲזִית. לא ניתן, וכנראה לא רצוי, לקבל
nbdkit מזלג לרקע בעת השימוש --לָרוּץ.
גם כאשר פועל בשבי, nbdkit עדיין מאזין ביציאת ה-TCP/IP הרגילה, אלא אם כן
ציין את -p/-U אפשרויות. אם אתה רוצה nbdkit שבוי פרטי באמת, אז אתה צריך
צור שקע יוניקס אקראי פרטי, כך:
nbdkit -U - תוסף [args] --הפעל '...'
איתותים
"nbdkit" מגיב לאותות הבאים:
"SIGINT"
"SIGQUIT"
"SIGTERM"
השרת יוצא בצורה נקייה.
"SIGPIPE"
אות זה מתעלם.
השתמש ב-nbdkit באינטרנט באמצעות שירותי onworks.net
