ifup - قم بتشغيل واجهة شبكة
ifdown - قم بإيقاف تشغيل واجهة شبكة
ifquery - قم بتحليل تكوين الواجهة
ملخص
ifup [-nv] [--no-act] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS]
-a|IFACE...
ifup -h|--help
ifup -V|--version
ifdown [-nv] [--no-act] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS]
-a|IFACE...
ifquery [-nv] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS] IFACE...
ifquery -l|--list [-nv] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS]
[-a|IFACE...]
ifquery --state [--state-dir=DIR] [--allow CLASS] [-a|IFACE...]
الوصف
يمكن استخدام الأمرين ifup و ifdown لتكوين (أو إلغاء تكوين) واجهات الشبكة بناءً على تعريفات الواجهة في الملف /etc/network/interfaces. يمكن استخدام الأمر ifquery لتحليل تكوينات الواجهات.
الخيارات
يتم تضمين ملخص للخيارات أدناه.
-a، --all
إذا تم تحديده لـ ifup، فسيؤثر على جميع الواجهات التي تم وضع علامة "auto" عليها. يتم تشغيل الواجهات بالترتيب الذي تم تعريفها به في /etc/network/interfaces. عند دمجه مع --allow، فإنه يعمل على جميع الواجهات لفئة معينة بدلاً من ذلك. إذا تم تحديده لـ ifdown، فسيؤثر على جميع الواجهات المحددة. يتم إيقاف تشغيل الواجهات بالترتيب الذي يتم سردها به حاليًا في ملف الحالة. سيتم إيقاف تشغيل الواجهات المعرفة فقط في /etc/network/interfaces.
-f، --force
فرض تكوين أو إلغاء تكوين الواجهة.
--ignore-errors
إذا فشل أي من الأوامر أو البرامج النصية، فاستمر.
-h، --help
عرض ملخص للخيارات.
--allow=CLASS
السماح فقط بالواجهات المدرجة في سطر "allow-CLASS" في /etc/network/interfaces.
-i FILE، --interfaces=FILE
قراءة تعريفات الواجهة من FILE بدلاً من /etc/network/interfaces.
--state-dir=DIR
احتفظ بحالة الواجهة في DIR بدلاً من /run/network.
-X PATTERN، --exclude=PATTERN
استبعاد الواجهات من قائمة الواجهات التي سيتم تشغيلها باستخدام PATTERN. يستخدم PATTERN بناء جملة shell glob عادي. إذا لم يتم استخدام أحرف البدل في shell، فيجب أن يتطابق مع اسم الواجهة المحدد بالضبط. يمكن تحديد هذا الخيار عدة مرات، مما يؤدي إلى استبعاد أكثر من نمط واحد.
-o OPTION=VALUE
قم بتعيين OPTION إلى VALUE كما لو كان في /etc/network/interfaces.
-n، --no-act
لا تقم بتكوين أي واجهات أو تشغيل أي أوامر "up" أو "down".
--no-mappings
لا تقم بتشغيل أي تعيينات. راجع interfaces(5) للحصول على مزيد من المعلومات حول ميزة التعيين.
--no-scripts
لا تقم بتشغيل أي برامج نصية في /etc/network/if-*.d/
--no-loopback
تعطيل المعالجة الخاصة بواجهة loopback. بشكل افتراضي، يتم تحديد واجهة loopback (lo على Linux) داخليًا على أنها واجهة "auto"، لذلك يتم تشغيلها تلقائيًا بواسطة ifup -a. في حالة إعادة تعريف جهاز loopback بواسطة المستخدم، يتم تكوين الواجهة مرة واحدة فقط على أي حال. إذا تم تحديد واجهة أخرى أيضًا على أنها loopback، فسيتم تكوينها كالمعتاد. يؤدي تحديد هذا الخيار إلى تعطيل هذا السلوك، بحيث لا يتم تكوين واجهة loopback تلقائيًا.
-V, --version
يعرض معلومات حقوق النشر والإصدار.
-v, --verbose
يعرض الأوامر أثناء تنفيذها.
-l, --list
بالنسبة لـ ifquery، يسرد جميع الواجهات التي تطابق الفئة المحددة. إذا لم يتم تحديد أي فئة، فإنه يطبع جميع الواجهات المدرجة كـ "auto".
--state
بالنسبة لـ ifquery، يعرض حالة الواجهات. عندما لا يتم تحديد أي واجهات، يسرد جميع الواجهات التي تم تشغيلها مع الواجهات المنطقية المخصصة لها ويخرج برمز حالة يشير إلى النجاح. إذا تم تحديد واجهة واحدة أو أكثر، فإنه يعرض حالة هذه الواجهات فقط؛ يتم إرجاع رمز نجاح إذا كانت جميع الواجهات المعطاة كحجج قيد التشغيل. وإلا، يتم إرجاع 0.
أمثلة
ifup -a
يقوم بتشغيل جميع الواجهات المعرفة باستخدام "auto" في /etc/network/interfaces
ifup eth0
يقوم بتشغيل الواجهة eth0
ifup eth0=home
يقوم بتشغيل الواجهة eth0 كواجهة منطقية باسم "home"
ifdown -a
يقوم بإيقاف تشغيل جميع الواجهات التي تعمل حاليًا.
ifquery -l
يطبع أسماء جميع الواجهات المحددة باستخدام الكلمة الأساسية "auto".
ifquery -l --allow=hotplug
يطبع أسماء جميع الواجهات المحددة باستخدام الكلمة الأساسية "allow-hotplug".
ifquery eth0
يعرض خيارات الواجهة كما هو محدد في تكوين ifupdown. يتم طباعة كل زوج من المفاتيح والقيم في سطر منفصل باستخدام ": " كفاصل.
ملاحظات
ifup، وifdown، وifquery هي في الواقع نفس البرنامج الذي يتم استدعاؤه بأسماء مختلفة.
لا يقوم البرنامج بتكوين واجهات الشبكة مباشرةً؛ بل يقوم بتشغيل أدوات منخفضة المستوى مثل ip لإنجاز المهمة.
عند استدعائه، يتحقق ifdown مما إذا كان ifup لا يزال قيد التشغيل. في هذه الحالة، يتم إرسال SIGTERM إلى ifup.
أثناء إلغاء تكوين الواجهة، يتجاهل ifdown الأخطاء بنفس الطريقة التي يتم بها تحديد --ignore-errors.
الملفات
/etc/network/interfaces
تعريفات واجهات الشبكة. انظر interfaces(5) لمزيد من المعلومات.
/run/network/ifstate
الحالة الحالية لواجهات الشبكة.
التزامن
يستخدم ifupdown تأمينًا لكل واجهة لضمان تشغيل استدعاءات ifup و ifdown المتزامنة لنفس الواجهة بشكل تسلسلي. ومع ذلك، ستتمكن المكالمات لواجهات مختلفة من العمل بالتوازي.
رمز الخروج
بالنسبة لـ ifup و ifdown، سيكون رمز الخروج هو 0 إذا تم تكوين (أو إلغاء تكوين) الواجهات المعطاة بنجاح، و 1 في حالة وجود أي خطأ. تكون نتيجة هذه الأوامر ثابتة؛ سيؤدي تشغيل ifup على واجهة تكون قيد التشغيل بالفعل إلى رمز خروج 0، وبالمثل، سيؤدي تشغيل ifdown على واجهة غير قيد التشغيل أيضًا إلى رمز خروج 0.
عادةً ما يعود ifquery برمز خروج 0 إذا كانت هناك واجهة ذات قسم iface مطابق، و 1 إذا لم يكن هناك قسم مطابق. سيعيد ifquery --state أيضًا برمز خروج 1 إذا كانت الواجهة المعطاة معروفة ولكن لم تكن قيد التشغيل.
الأخطاء/القيود المعروفة
يقوم البرنامج بتسجيل ما إذا كانت واجهات الشبكة قيد التشغيل أم لا. في ظل ظروف استثنائية، يمكن أن تصبح هذه السجلات غير متسقة مع الحالات الفعلية للواجهات. على سبيل المثال، إذا تم تشغيل واجهة باستخدام ifup ثم إلغاء تكوينها باستخدام ifconfig، فسيظل البرنامج يسجلها على أنها قيد التشغيل. لتصحيح ذلك، يمكنك استخدام الخيار --force لفرض تشغيل أو إيقاف تشغيل واجهة، بغض النظر عن الحالة التي يعتقد البرنامج أنها موجودة.
يجب أن يكون الملف /run/network/ifstate قابلاً للكتابة حتى يتمكن ifup أو ifdown من العمل بشكل صحيح. إذا لم يكن هذا الموقع قابلاً للكتابة (على سبيل المثال، لأن نظام الملفات الجذر مُثبَّت للقراءة فقط لأغراض استعادة النظام)، فيجب إنشاء رابط رمزي للملف /run/network/ifstate إلى موقع قابل للكتابة. إذا لم يكن ذلك ممكنًا، فيمكنك استخدام الخيار --force لتشغيل أوامر التكوين أو إلغاء التكوين دون تحديث الملف.
لاحظ أن البرنامج لا يعمل تلقائيًا: لا يقوم ifup بمفرده بتشغيل الواجهات التي تظهر كنتيجة لتثبيت أجهزة، ولا يقوم ifdown بمفرده بإيقاف تشغيل الواجهات التي تختفي كنتيجة لإزالة الأجهزة. لأتمتة تكوين واجهات الشبكة، يجب تثبيت حزم أخرى مثل udev(7) أو ifplugd(8).
المؤلفون
تم إنشاء مجموعة ifupdown بواسطة أنتوني تاونز <_>، ويتم صيانتها حاليًا بواسطة سانتياغو روانو رينكون <_> وخوسيه أورتيجا <_>.
ساعد العديد من الأشخاص الآخرين في تطوير ifupdown بمرور الوقت، راجع /usr/share/doc/ifupdown/changelog.Debian.gz للحصول على التاريخ الكامل.