1. Manuals
  2. Tumbleweed
  3. man-pages-ar
  4. networkctl(1)

Scroll to navigation

NETWORKCTL(1) networkctl NETWORKCTL(1)

الاسم

networkctl - استعلام أو تعديل حالة وصلات الشبكة

موجز

networkctl [خيارات...] أمر [وصلة...]

الوصف

يُستخدم networkctl لاستعلام أو تعديل حالة وصلات الشبكة كما تراها systemd-networkd. يُرجى الرجوع إلى systemd-networkd.service(8) للحصول على مقدمة عن المفاهيم الأساسية والوظائف وبناء الجملة التكويني.

الأوامر

الأوامر التالية مفهومة:

list [نمط...]

يعرض قائمة بالوصلات الموجودة وحالتها. إذا تم تحديد نمط واحد أو أكثر، تُعرض الوصلات المطابقة لأحدها فقط. إذا لم تُحدد وسائط إضافية، يُعرض جميع الوصلات، وإلا تُعرض الوصلات المحددة فقط. يُنتج مخرجات مشابهة لـ: 

IDX LINK         TYPE     OPERATIONAL SETUP


  1 lo           loopback carrier     unmanaged


  2 eth0         ether    routable    configured


  3 virbr0       ether    no-carrier  unmanaged


  4 virbr0-nic   ether    off         unmanaged
سُردت 4 روابط.

الحالة التشغيلية هي إحدى الحالات التالية:

missing

الجهاز مفقود.

أُضيف في الإصدار 245.

off

الجهاز في حالة إيقاف التشغيل.

أُضيف في الإصدار 240.

no-carrier

الجهاز قيد التشغيل، لكنه لا يمتلك ناقلاً بعد.

أُضيف في الإصدار 240.

dormant

الجهاز يمتلك ناقلاً، لكنه ليس جاهزاً بعد لحركة المرور العادية.

أُضيف في الإصدار 240.

degraded-carrier

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

أُضيف في الإصدارة 242.

carrier

الوصلة تمتلك ناقلاً، أو بالنسبة لرئيس الربط أو الجسر، جميع واجهات الشبكة التابعة للربط أو الجسر مستعبدة للرئيس.

أُضيف في الإصدار 240.

degraded

الوصلة تمتلك ناقلاً وعناوين صالحة على الوصلة المحلية المكونة. بالنسبة لرئيس الربط أو الجسر، هذا يعني أن ليس كل واجهات الشبكة التابعة تمتلك ناقلاً ولكن واحدة على الأقل تمتلكه.

أُضيف في الإصدار 240.

enslaved

الوصلة لديها ناقل وهي مستعبدة لواجهة الشبكة الرئيسية للربط أو الجسر.

أُضيف في الإصدارة 242.

routable

الوصلة لديها ناقل وعنوان قابل للتوجيه مهيأ. بالنسبة لسيد الربط أو الجسر، ليس من الضروري أن تمتلك جميع واجهات الشبكة العبد ناقلاً، لكن يجب أن يمتلك واحد على الأقل.

أُضيف في الإصدار 240.

حالة الإعداد هي إحدى التالية:

pending

systemd-udevd(8) لا يزال يعالج الوصلة، لا نعرف بعد ما إذا كنا سنُديرها.

أُضيف في الإصدار 240.

initialized

systemd-udevd(8) عالج الوصلة، لكن لا نعرف بعد ما إذا كنا سنُديرها.

أُضيف في الإصدار 251.

configuring

يجري استرداد تهيئة الوصلة أو يجري تهيئة الوصلة.

أُضيف في الإصدار 240.

configured

تمت تهيئة الوصلة بنجاح.

أُضيف في الإصدار 240.

unmanaged

systemd-networkd لا يعالج الوصلة.

أُضيف في الإصدار 240.

failed

فشل systemd-networkd في تهيئة الوصلة.

أُضيف في الإصدار 240.

linger

الوصلة قد زالت، لكن لم تُسقط بعد بواسطة systemd-networkd.

أُضيف في الإصدار 240.

أُضيف في الإصدارة 219.

status [PATTERN...]

أظهر معلومات عن الوصلات المحددة: النوع، الحالة، برنامج تشغيل وحدة النواة، العنوان العتادي والـ IP، خوادم DNS المهيأة، إلخ. إذا تم تحديد PATTERN واحد أو أكثر، تُعرض فقط الوصلات المطابقة لأحدها.

عند عدم تحديد وصلات، تُعرض حالة شبكة إجمالية. انظر أيضًا الخيار --all.

يُنتج مخرجات مشابهة لـ:

●        State: routable


  Online state: online


       Address: 10.193.76.5 on eth0


                192.168.122.1 on virbr0


                169.254.190.105 on eth0


                fe80::5054:aa:bbbb:cccc on eth0


       Gateway: 10.193.11.1 (CISCO SYSTEMS, INC.) on eth0


           DNS: 8.8.8.8


                8.8.4.4

في حالة الشبكة الإجمالية، تعتمد حالة الاتصال على حالة الاتصال الفردية لجميع الوصلات المطلوبة. الوصلات المُدارة مطلوبة للاتصال مبدئياً. في هذه الحالة، حالة الاتصال هي إحدى التالية:

unknown

جميع الوصلات لديها حالة اتصال غير معروفة (أي لا توجد وصلات مطلوبة).

أُضيف في الإصدار 249.

offline

جميع الوصلات المطلوبة غير متصلة.

أُضيف في الإصدار 249.

partial

بعض الوصلات المطلوبة متصلة، وليس كلها.

أُضيف في الإصدار 249.

online

جميع الوصلات المطلوبة متصلة.

أُضيف في الإصدار 249.

أُضيف في الإصدارة 219.

lldp [PATTERN...]

عرض الجيران المكتشفين عبر بروتوكول اكتشاف طبقة الوصلة (LLDP). إذا تم تحديد نمط أو أكثر PATTERN، يتم عرض الجيران على تلك الواجهات فقط. وإلا، يتم عرض الجيران المكتشفين على جميع الواجهات. لاحظ أنه لكي تعمل هذه الميزة، يجب تشغيل LLDP= على الواجهة المحددة؛ راجع systemd.network(5) للتفاصيل.

يُنتج مخرجات مشابهة لـ:

LINK    SYSTEM-NAME SYSTEM-DESCRIPTION CHASSIS-ID        PORT-ID PORT-DESCRIPTION CAPS
enp0s25 GS1900      -                  00:e0:4c:00:00:00 2       Port #2           ..b........
علامات القدرات:
o - أخرى؛ p - مكرر؛  b - جسر؛ w - نقطة وصول شبكة WLAN؛ r - موجه؛
t - هاتف؛ d - جهاز كابل DOCSIS؛ a - محطة؛ c - شبكة VLAN للعميل؛
s - شبكة VLAN للخدمة؛ m - مرحل MAC ثنائي المنافذ (TPMR)
يوجد جار واحد مدرج.

أُضيف في الإصدارة 219.

label

عرض تسميات العناوين الرقمية التي يمكن استخدامها لاختيار العنوان. هذه هي نفس المعلومات التي يعرضها ip-addrlabel(8). راجع RFC 3484[1] لمناقشة تسميات العناوين.

يُنتج مخرجات مشابهة لـ:

Prefix/Prefixlen                          Label


        ::/0                                  1


    fc00::/7                                  5


    fec0::/10                                11


    2002::/16                                 2


    3ffe::/16                                12


 2001:10::/28                                 7


    2001::/32                                 6
::ffff:0.0.0.0/96                             4


        ::/96                                 3


       ::1/128                                0

أُضيف في الإصدارة 234.

delete DEVICE...

حذف أجهزة الشبكة الافتراضية. يأخذ اسم الواجهة أو رقم الفهرس.

أُضيف في الإصدار 243.

up DEVICE...

تشغيل الأجهزة. يأخذ اسم الواجهة أو رقم الفهرس.

أُضيف في الإصدار 246.

down DEVICE...

إيقاف الأجهزة. يأخذ اسم الواجهة أو رقم الفهرس.

أُضيف في الإصدار 246.

renew DEVICE...

تجديد التهيئات الديناميكية مثل العناوين المستلمة من خادم DHCP. يأخذ اسم الواجهة أو رقم الفهرس.

أُضيف في الإصدارة 244.

forcerenew DEVICE...

إرسال رسالة FORCERENEW إلى جميع العملاء المتصلين، مما يؤدي إلى إعادة تهيئة DHCP. يأخذ اسم الواجهة أو رقم الفهرس.

أُضيف في الإصدار 246.

reconfigure DEVICE...

إعادة تهيئة واجهات الشبكة. يأخذ اسم الواجهة أو رقم الفهرس. لاحظ أن هذا لا يعيد تحميل ملفات .netdev أو .network المقابلة للواجهة المحددة. لذلك، إذا قمت بتحرير ملفات التهيئة، فمن الضروري استدعاء networkctl reload أولاً لتطبيق الإعدادات الجديدة.

أُضيف في الإصدارة 244.

reload

أعد تحميل ملفات .netdev و.network.

إذا وُجد ملف .netdev جديد أو معدّل، فسيُنشأ أو يُحدّث جهاز netdev المقابل على التوالي. لاحظ، إذا كانت الواجهة المقابلة موجودة بالفعل، فقد لا تُطبّق بعض الإعدادات الجديدة. على سبيل المثال، لا يمكن تغيير معرف VLAN بعد إنشاء الواجهة، لذا لن يُؤثّر تغيير [VLAN] Id= إذا كانت واجهة VLAN المطابقة موجودة بالفعل. لتطبيق هذه الإعدادات، يجب إزالة الواجهات يدويًا قبل إعادة التحميل. لاحظ أيضًا أنه حتى إذا أُزيل ملف .netdev، فإن systemd-networkd(8) لا يزيل جهاز netdev الموجود المقابل للملف.

إذا وُجد ملف .network جديد أو معدّل أو مُزال، فستُعاد تهيئة جميع الواجهات التي تطابقت مع الملف.

أُضيف في الإصدارة 244.

edit FILE|@DEVICE...

حرّر ملفات تهيئة الشبكة، والتي تتضمن ملفات .network و.netdev و.link. إذا لم يُعثر على ملف تهيئة شبكة يطابق الاسم المُعطى، فسيُنشأ ملف جديد تحت /etc/ أو /run/، اعتمادًا على ما إذا كان --runtime مُحددًا. بشكل خاص، إذا كان الاسم مسبوقًا بـ "@"، فسيُعامل كواجهة شبكة، وسيُجرى التحرير على ملفات تهيئة الشبكة المرتبطة بها. بالإضافة إلى ذلك، يمكن لصق اسم الواجهة بـ ":network" (مبدئي)، أو ":link"، أو ":netdev"، لاختيار نوع تهيئة الشبكة المراد العمل عليها.

إذا كان --drop-in= مُحددًا، فحرّر ملف الإدراج بدلاً من ملف التهيئة الرئيسي. ما لم يُحدد --no-reload، فسيُعاد تحميل systemd-networkd(8) بعد انتهاء تحرير ملفات .network أو .netdev. ينطبق الشيء نفسه على ملفات .link وsystemd-udevd(8). لاحظ أن إعدادات الوصلة المُغيّرة لا تُطبّق آليًا بعد إعادة التحميل. لتحقيق ذلك، شغّل أحداث uevents للواجهة المقابلة. راجع systemd.link(5) لمزيد من المعلومات.

إذا كان --stdin مُحددًا، فسيُقرأ المحتوى الجديد من الإدخال القياسي. في هذا الوضع، يُتجاهل المحتوى القديم للملف.

أُضيف في الإصدار 254.

cat [FILE|@DEVICE...]

اعرض ملفات تهيئة الشبكة. يُكرّم هذا الأمر البادئة "@" بطريقة مشابهة لـ edit، مع دعم لاحقة إضافية ":all" لعرض جميع أنواع ملفات التهيئة المرتبطة بالواجهة مرة واحدة. عندما لا يُحدد أي وسيط، فسيُعرض networkd.conf(5) وملفات الإدراج الخاصة به.

أُضيف في الإصدار 254.

mask FILE...

اقنع ملفات تهيئة الشبكة، والتي تتضمن ملفات .network و.netdev و.link. سيُنشأ رابط رمزي بالاسم المُعطى تحت /etc/ أو /run/، اعتمادًا على ما إذا كان --runtime مُحددًا، يشير إلى /dev/null. إذا وُجد ملف تهيئة غير فارغ بالاسم المُحدد تحت الدليل الهدف أو دليل ذي أولوية أعلى (مثلًا، يُستخدم --runtime بينما توجد تهيئة موجودة في /etc/)، فتُلغى العملية.

يُكرّم هذا الأمر --no-reload بنفس طريقة edit.

أُضيف في الإصدار 256.

unmask FILE...

أزل القناع عن ملفات تهيئة الشبكة، أي عكس تأثير mask. لاحظ أن هذا الأمر يعمل بغض النظر عن نطاق الدليل، أي أن --runtime ليس له تأثير.

يُكرّم هذا الأمر --no-reload بنفس طريقة edit وmask.

أُضيف في الإصدار 256.

persistent-storage BOOL

أخطر systemd-networkd.service(8) بأن التخزين الدائم للخدمة جاهز. يُستدعى هذا بواسطة systemd-networkd-persistent-storage.service. عادةً، لا ينبغي استدعاء هذا الأمر يدويًا من قبل المستخدمين أو المسؤولين.

أُضيف في الإصدار 256.

الخيارات

الخيارات التالية مفهومة:

-a --all

اعرض جميع الوصلات مع status.

أُضيف في الإصدارة 219.

-s --stats

اعرض إحصائيات الوصلة مع status.

أُضيف في الإصدار 243.

-l، --full

لا تضع علامة حذف (حذف الأطراف) في المخرجات.

أُضيف في الإصدار 245.

-n، --lines=

عند الاستخدام مع status، يتحكم في عدد أسطر اليومية المراد عرضها، بدءًا من الأحدث. يأخذ وسيط عدد صحيح موجب. يؤول مبدئيًا إلى 10.

أُضيف في الإصدار 245.

--drop-in=الاسم

عند استخدامه مع edit، حرّر ملف الإدراج NAME بدلاً من ملف التهيئة الرئيسي.

أُضيف في الإصدار 254.

--no-reload

عند استخدامه مع edit أو mask أو unmask، لن يُعاد تحميل systemd-networkd.service(8) أو systemd-udevd.service(8) بعد انتهاء العملية.

أُضيف في الإصدار 254.

--runtime

عند استخدامه مع edit أو mask، اعمل على الملف تحت /run/ بدلاً من /etc/.

أُضيف في الإصدار 256.

--stdin

عند استخدامه مع edit، ستُقرأ محتويات الملف من الإدخال القياسي ولن يُطلق المحرر. في هذا الوضع، تُستبدل المحتويات القديمة للملف آليًا. هذا مفيد لـ "تحرير" التهيئة من النصوص البرمجية، خاصةً بحيث تُنشأ أدلة الإدراج وتُملأ دفعة واحدة.

قد تُحرّر إدراجات متعددة في هذا الوضع مع --drop-in=، وتُكتب نفس المحتويات لجميعها. وإلا، يُتوقع ملف تهيئة رئيسي واحد بالضبط.

أُضيف في الإصدار 257.

--no-ask-password

لا تسأل المستخدم عن الاستيثاق للعمليات ذات الامتيازات.

--json=وضع

يظهر المخرجات منسقة بصيغة JSON. يتوقع أحد الخيارات: "short" (لأقصر مخرج ممكن دون أي مسافات زائدة أو فواصل أسطر)، أو "pretty" (لنسخة جميلة من المخرج نفسه، مع إزاحة وفواصل أسطر) أو "off" (لإيقاف مخرجات JSON، وهو الخيار المبدئي).

-h، --help

اطبع نص مساعدة قصير واخرج.

--version

اطبع سلسلة إصدار قصيرة واخرج.

--no-legend

لا تطبع مفتاح الرموز، أي ترويسات الأعمدة والتذييل المزود بالتلميحات.

--no-pager

لا تمرر المخرجات إلى برنامج عرض (pager).

حالة الخروج

عند النجاح، يُعاد الرقم 0، وإلا فيُعاد رمز فشل غير صفري.

انظر أيضًا

systemd-networkd.service(8)، systemd.network(5)، systemd.netdev(5)، ip(8)

ملاحظات

1.
RFC 3484
https://tools.ietf.org/html/rfc3484

ترجمة

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.

systemd 260.1