דילוג לתוכן הראשי

שימוש ב־CLI

אם מצאתם שגיאה במסמך או שיש לכם הצעה, כתבו בפורום Mudfish.

איני יודע כמה ממשתמשי Mudfish באמת ישתמשו בתפריט הזה, אבל אם אתם משתמשים בו, כנראה שאתם משתמשי מחשב מתקדמים. :-) נעים להכיר.

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

מבוא ל־CLI​

לפני שנוצר Mudfish Launcher, ה־CLI (ממשק שורת הפקודה) היה אמצעי ניפוי השגיאות היחיד. כיום רוב ההגדרות מתבצעות דרך הממשק, ורוב המשתמשים אינם זקוקים ל־CLI.

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

התחברות ל־CLI​

כדי להתחבר ל־CLI, תחילה יש לדעת את כתובת ה־IP ואת היציאה שבהן הוא מאזין. כדי למצוא אותן:

  • תחילה היכנסו לחשבון Mudfish.

  • פתחו „מצב → תהליך”. תמצאו שם סעיף בשם „מידע יומן”. אלה ההודעות שמפיק mudfish.exe, מתחילת הפעלת התוכנית ועד לרגע הנוכחי.

  • בחלק העליון של היומן חפשו שורה שמתחילה ב־„[INFO] Listening the mangement console...”. שורה זו מכילה את כתובת ה־IP ואת יציאת ה־CLI. כתובת ה־IP מוגדרת תמיד ככתובת המקומית 127.0.0.1, והיציאה מוקצית אוטומטית על ידי מערכת ההפעלה.

כעת פתחו שורת פקודה והתחברו לכתובת וליציאה באמצעות telnet. לדוגמה, אם מופיע 127.0.0.1:35323, התחברו כך:

   C:\> telnet 127.0.0.1 35323

   -----------------------------
   MUDFISH CLI v2.0.8
   -----------------------------

   Type 'help' for command list.
   Type 'quit' to close CLI session.

פקודות CLI​

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

ליבת Mudfish מבוססת על מחסנית TCP/IP ועל תשתית הרשת של FreeBSD. (זו המערכת שאני מכיר הכי טוב... אהמ...) לכן הפקודות שב־CLI דומות מאוד לפקודות שמספק FreeBSD, וגם אופן השימוש דומה.

לאחר ההתחברות ל־CLI, הפעילו את הפקודה help כדי לראות את רשימת הפקודות הנתמכות כעת.

   help
       arp                 Address resolution display and control
       connect             Test a connection to the remote
       help                Show this help message
       ifconfig            Configure network interface parameters
       netstat             Show network status
       ping                send ICMP ECHO_REQUEST packets to network hosts
       route               Manually manipulate the routing tables
       quit                Exit CLI interface
       sysctl              Get or set kernel state

להסבר מלא על כל פקודה, חפשו בדפי המדריך. למעט connect, הפקודות אמורות לפעול כמו ב־FreeBSD 8.0 RELEASE.

הפקודה connect​

   connect
   usage: connect ip port

   connect 68.180.206.184 80
   connection was good (RTT 0.156 secs)

פקודה זו מנסה ליצור חיבור TCP באמצעות connect(2) דרך הממשקים הווירטואליים של Mudfish, ‏re(4) או msk(4). היא מיועדת לניפוי שגיאות, כדי לבדוק אם אפשר להתחבר לכתובת ה־IP וליציאה הרצויות דרך Mudfish.

בכישלון חיבור תוצג הודעת שגיאה או Timeout; בהצלחה יוצג גם ערך RTT משוער.