رفتن به محتوای اصلی

استفاده از CLI

اگر در این سند خطایی می‌بینید یا پیشنهادی دارید، در انجمن Mudfish پیام بگذارید.

نمی‌دانم چند نفر از کاربران Mudfish از این منو استفاده می‌کنند، اما اگر سراغ آن آمده‌اید، احتمالاً کاربر پیشرفتهٔ رایانه هستید. :-) خوش آمدید.

در بخش‌های زیر اصطلاحات تخصصی بیشتری به کار می‌رود؛ با دقت بخوانید.

معرفی CLI​

پیش از ساخته شدن Mudfish Launcher، رابط خط فرمان یا CLI تنها ابزار عیب‌یابی بود. اکنون بیشتر تنظیمات از رابط کاربری انجام می‌شود و معمولاً نیازی به CLI نیست.

با این حال، برای تحلیل مشکلات Mudfish، تنظیمات بسیار تخصصی یا مشاهدهٔ وضعیت‌های داخلی که در رابط نمایش داده نمی‌شوند، در حال حاضر راه دیگری جز CLI وجود ندارد.

اتصال به CLI​

ابتدا باید IP و درگاهی را که CLI روی آن گوش می‌دهد پیدا کنید:

  • وارد حساب Mudfish شوید.

  • به «وضعیت → فرایند» بروید. بخش «اطلاعات گزارش» شامل خروجی mudfish.exe از آغاز اجرای برنامه تا زمان فعلی است.

  • در بالای گزارش، خطی با عبارت [INFO] Listening the mangement console... اطلاعات IP و درگاه CLI را نشان می‌دهد. IP همیشه نشانی محلی 127.0.0.1 است و درگاه را سیستم‌عامل خودکار اختصاص می‌دهد.

اکنون در خط فرمان با telnet به آن IP و درگاه وصل شوید. برای نمونه، اگر 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 fail و بسته شدن Mudfish شود. چون توسعه‌دهنده این قابلیت را بسیار، بسیار مناسبِ خودش نوشته است...

برنامهٔ Mudfish Core بر پایهٔ پشتهٔ TCP/IP و چارچوب شبکهٔ FreeBSD نوشته شده است؛ چون من با 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

اگر توضیح کامل هر فرمان را می‌خواهید، در راهنمای FreeBSD جست‌وجو کنید. به‌جز connect، فرمان‌ها باید مانند FreeBSD 8.0 RELEASE کار کنند.

فرمان connect​

   connect
   usage: connect ip port

   connect 68.180.206.184 80
   connection was good (RTT 0.156 secs)

این فرمان از طریق رابط‌های مجازی Mudfish، یعنی re(4) یا msk(4)، اتصال TCP connect(2) را امتحان می‌کند. هدف آن عیب‌یابی امکان اتصال به IP و درگاه موردنظر از طریق Mudfish است.

اگر اتصال ناموفق باشد، خطا یا پیام Timeout چاپ می‌شود؛ در صورت موفقیت، RTT تقریبی نیز نمایش داده می‌شود.