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.

dhcp-lease الواجهة [الرمز[:التنسيق]] ...
    يُظهر رسالة DHCP لعقد الإيجار المُكتسَب (أي رسالة DHCPACK المُستلمة). يأخذ اسم واجهة ورموز خيارات DHCP اختيارية. إذا لم يُحدد رمز خيار، يُظهر كلًا من رأس رسالة DHCP وجميع الخيارات. إذا حُدد رمز خيار واحد أو أكثر، تُعرض الخيارات المُحددة فقط.

    عند الاستدعاء مع الخيار --json=، تُعرض رسالة DHCP بأكملها بتنسيق JSON. في هذه الحالة، تُتجاهل أي رموز خيارات مُحددة.

    مبدئيًا، يُعرض كل خيار بتنسيق قابل للقراءة البشرية، اعتمادًا على الخيار. على سبيل المثال، تُعرض عناوين خادم DNS كقائمة عناوين IP (مثل "192.0.2.1")، ويُعرض وقت الإيجار كمدة زمنية قابلة للقراءة البشرية (مثل "8h").

    قد يتبع كل رمز خيار اختياريًا مُنسق، مفصول بنقطتين (مثل "42:address"). قد يكون هذا مفيدًا إذا لم يكن التنسيق المبدئي مناسبًا.

    المُنسقات التالية مدعومة:

    auto
        استخدم التنسيق المبدئي.

    hex
        أظهر البايتات الخام بالنظام الست عشري، مفصولة بنقطتين.

    flag
        عامل الخيار كبيانات ذات طول صفري واعرض "yes".

    bool
        عامل الخيار كقيمة منطقية من 1 بايت واعرض "yes" أو "no".

    uint8
        عامل الخيار كعدد صحيح غير مُشار إليه من 1 بايت.

    uint16
        عامل الخيار كعدد صحيح غير مُشار إليه من 2 بايت.

    time
        عامل الخيار كقيمة زمنية من 4 بايت بالثواني واعرضها كمدة زمنية قابلة للقراءة البشرية.

    string
        عامل الخيار كسلسلة محارف.

    address
        عامل الخيار كعنوان IPv4 واحد أو أكثر واعرضها بشكل قابل للقراءة البشرية.

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

        $ networkctl dhcp-lease eth0
        Header:
                      KEY VALUE
           Hardware Type: ETHER
        Hardware Address: 41:42:43:31:32:33
          Client Address: 192.0.2.123
          Server Address: 192.0.2.1

        Options:
        CODE NAME               DATA
           1 subnet mask        255.255.255.0
           3 router             192.0.2.1
           6 domain name server 192.0.2.1
          12 hostname           test-node
          15 domain name        lan
          28 broadcast address  192.0.2.255
          42 NTP server         192.0.2.11
                                192.0.2.12
          51 lease time         1d
          53 message type       5
          54 server identifier  192.0.2.1
          58 renewal time       11h 5min 38s
          59 rebinding time     20h 5min 38s
         119 domain search      hoge.example.com
                                foo.example.com

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

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 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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