الاسم

lsns - ادرج مساحات الأسماء

موجز

lsns [خيارات] [معرف فضاء الأسماء]

الوصف

يسرد lsns معلومات حول جميع مساحات الأسماء التي يمكن الوصول إليها حالياً أو حول الـ namespace المعطى. معرف مساحة الأسماء هو رقم inode.

المخرجات المبدئية عرضة للتغيير. لذا كلما كان ذلك ممكناً، يجب تجنب استخدام المخرجات المبدئية في البرامج النصية الخاصة بك. حدد دائماً وضع المخرجات المتوقع (--tree أو --list) والأعمدة صراحةً باستخدام الخيار --output جنباً إلى جنب مع قائمة الأعمدة في البيئات التي تتطلب مخرجات مستقرة.

يعتبر العمود NSFS، الذي يُطبع عند تحديد net للخيار --type، خاصاً؛ حيث يستخدم خلايا متعددة الأسطر. استخدم الخيار --nowrap للتبديل إلى تمثيل السطر الواحد المفصول بفاصلة ",".

لاحظ أن lsns يقرأ المعلومات مباشرة من نظام ملفات /proc وقد يعيد معلومات غير كاملة للمستخدمين غير الجذر. قد يكون نظام ملفات /proc الحالي غير مشترك ومتأثراً بمساحة أسماء PID (راجع unshare --mount-proc لمزيد من التفاصيل). لا يستطيع lsns رؤية مساحات الأسماء المستمرة التي لا تحتوي على عمليات حيث يتم الاحتفاظ بمثيل مساحة الأسماء بواسطة وصلة ربط بـ /proc/معرّف-العملية/ns/نوع.

الخيارات

-H، --list-columns

يسرد الأعمدة التي يمكن تحديدها بالخيار ‎--output‎. يمكن استخدامه مع ‎--json‎ أو ‎--raw‎ للحصول على القائمة بتنسيق مقروء آلياً.

-J، --json

استخدم تنسيق مخرجات JSON.

-l، --list

استخدم تنسيق مخرجات القائمة.

-n، --noheadings

عدم طباعة سطر الترويسة.

-o، --output قائمة

حدد أعمدة المخرجات المراد طباعتها. استخدم --help للحصول على قائمة بجميع الأعمدة المتاحة.

يمكن توسيع القائمة المبدئية للأعمدة إذا حُددت الـ قائمة بالتنسيق +قائمة (على سبيل المثال، lsns -o +PATH).

--output-all

أخرج كافة الأعمدة المتاحة.

-P، --persistent

اعرض فقط مساحات الأسماء التي لا تحتوي على عمليات (وتعرف أيضاً بمساحات الأسماء المستمرة)، التي أُنشئت عن طريق وصل ربط ملفات /proc/pid/ns/type بمسار نظام ملفات.

-p، --task معرّف-العملية

اعرض فقط مساحات الأسماء التي تحتفظ بها العملية ذات الـ معرّف-العملية هذا.

-Q، --filter تعبير

اطبع فقط مساحات الأسماء التي تفي بالشروط المحددة بواسطة التعبير (expr).

هذه الميزة تجريبية. انظر أيضًا scols-filter(5). على سبيل المثال، استبعاد root كاسم مستخدم، ولكن طباعة كل مساحات الأسماء التي تنتمي إليها أكثر من عملية واحدة:

lsns --filter 'USER != "root" and NPROCS > 1'

-r، --raw

استخدام تنسيق المخرجات الخام.

-t، --type نوع

عرض النوع المحدد نوع من مساحات الأسماء فقط. الأنواع المتاحة هي mnt و net و ipc و user و pid و uts و cgroup و time. يمكن إعطاء هذا الخيار أكثر من مرة.

-u، --notruncate

لا تقتطع النص في الأعمدة.

-W، --nowrap

لا تستخدم نصوصًا متعددة الأسطر في الأعمدة.

-T، --tree[=rel]

استخدم تنسيق إخراج شبيه بالشجرة. إذا مُرر process كقيمة لـ rel، فستُطبع شجرة (أو أشجار) العمليات في كل مساحة اسم. هذا هو السلوك المبدئي عند عدم تحديد --tree. إذا مُرر parent، فستُطبع الشجرة (أو الأشجار) المبنية بناءً على علاقة الأب/الابن. إذا مُرر owner، فستُطبع الشجرة (أو الأشجار) المبنية بناءً على علاقة المالك/المملوك. يُستخدم owner كخيار مبدئي عند حذف rel.

-h، --help

اعرض نص المساعدة ثم اخرج.

-V، --version

اعرض الإصدار واخرج.

حالة الخروج

تخرج أداة lsns بإحدى القيم التالية:

0

نجاح.

1

خطأ عام.

2

كان ioctl غير معروف للنواة.

البيئة

LSNS_DEBUG=all

يُفعّل مخرجات تنقيح lsns.

LIBSMARTCOLS_DEBUG=all

يُفعّل مخرجات تصحيح أخطاء libsmartcols.

LIBSMARTCOLS_DEBUG_PADDING=on

يستخدم محارف حشو مرئية.

المؤلفين

Karel Zak <kzak@redhat.com>

انظر أيضاً

nsenter(1)، unshare(1)، clone(2)، namespaces(7)، ioctl_ns(2)، ip-netns(8)، scols-filter(5)

التبليغ عن الأخطاء

لتقارير العِلل، استخدم مُتتبع المشكلات https://github.com/util-linux/util-linux/issues.

التوفر

الأمر lsns جزء من حزمة util-linux التي يمكن تنزيلها من أرشيف نواة لينكس https://www.kernel.org/pub/linux/utils/util-linux/.