الانتقال إلى المحتوى الرئيسي

استخدام CLI

إذا وجدتم خطأ في الوثيقة أو كانت لديكم اقتراحات، فاتركوا رسالة في منتدى Mudfish على https://forums.mudfish.net.

لا نعرف كم من مستخدمي Mudfish سيستخدمون هذه القائمة، لكن من يستخدم هذه الوظيفة غالبًا مستخدم متقدم للكمبيوتر. :-) يسعدنا لقاؤكم.

قد تتضمن الأقسام التالية كثيرًا من المصطلحات المتخصصة، لذا اقرؤوها بعناية.

مقدمة عن CLI​

قبل إنشاء Mudfish Launcher، كانت CLI (Command Line Interface) وسيلة تصحيح الأخطاء الوحيدة. أما الآن، فمعظم الإعدادات تُضبط عبر الواجهة، وأصبح استخدام CLI أقل شيوعًا.

لكن لتحليل مشكلات Mudfish وضبط أكثر الإعدادات تخصصًا، أو الاطلاع على حالات داخلية لا تظهر إطلاقًا في الواجهة، لا تتوفر حاليًا وسيلة سوى CLI.

الاتصال بواجهة CLI​

للاتصال، يجب أولًا معرفة عنوان IP والمنفذ اللذين تستمع عليهما CLI. للحصول عليهما:

  • سجّلوا الدخول إلى Mudfish أولًا.

  • افتحوا «الحالة → العملية». ستجدون قسم «معلومات السجل». يحتوي على رسائل mudfish.exe من بدء البرنامج إلى الوقت الحالي.

  • ابحثوا قرب بداية السجل عن السطر [INFO] Listening the mangement console...؛ فهو يتضمن IP/PORT الخاصين بـ CLI. يكون IP دائمًا العنوان المحلي 127.0.0.1، ويعيّن نظام التشغيل المنفذ تلقائيًا.

افتحوا موجه الأوامر واتصلوا بهذا IP/PORT باستخدام 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 الحالية إلى تعطل Mudfish بسبب assert fail. فقد كتب المطوّر هذه الوظيفة بطريقة موجهة إلى المطوّرين بدرجة كبيرة جدًا...

بُني 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

للحصول على شرح كامل لكل أمر، ابحثوا عبر هذا الرابط. باستثناء 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 ومنفذ PORT المطلوبين عبر Mudfish.

عند الفشل، تظهر رسالة خطأ أو Timeout، وعند النجاح تظهر أيضًا قيمة RTT المتوقعة.