نام (NAME)

lsns - فهرست کردن فضاهای نام (Namespaces) در لینوکس

خلاصه دستور (SYNOPSIS)

lsns [options] [namespace ID]

توضیحات (DESCRIPTION)

دستور lsns اطلاعات مربوط به تمام فضاهای نام (namespaces) دردسترس فعلی یا فضای نام مشخص‌شده (namespace) را فهرست می‌کند. شناسه namespace یک شماره inode است.

خروجی پیش‌فرض ممکن است تغییر کند. بنابراین تا حد امکان، باید از استفاده از خروجی‌های پیش‌فرض در اسکریپت‌های خود خودداری کنید. در محیط‌هایی که به یک خروجی پایدار نیاز است، همواره حالت خروجی مورد انتظار (--tree یا --list) و ستون‌ها را با استفاده از گزینه --output به همراه فهرستی از ستون‌ها به صراحت مشخص کنید.

ستون NSFS که هنگام تعیین net برای گزینه --type چاپ می‌شود، خاص است؛ این ستون از سلول‌های چندخطی استفاده می‌کند. برای تغییر به نمایش تک‌خطی جداشده با «,» از گزینه --nowrap استفاده کنید.

توجه داشته باشید که lsns اطلاعات را مستقیماً از فایل‌سیستم /proc می‌خواند و برای کاربران غیر ریشه (non-root) ممکن است اطلاعات ناقصی بازگرداند. فایل‌سیستم فعلی /proc ممکن است اشتراک‌زدایی شده (unshared) باشد و تحت تأثیر یک فضای نام PID قرار گیرد (برای جزئیات بیشتر unshare --mount-proc را ببینید). دستور lsns قادر به دیدن فضاهای نام پایداری (persistent namespaces) که فاقد فرآیند هستند و نمونه فضای نام آن‌ها توسط یک bind mount به /proc/pid/ns/type نگه داشته شده است، نیست.

گزینه‌ها (OPTIONS)

-H, --list-columns

فهرست کردن ستون‌هایی که می‌توان با گزینه --output مشخص کرد. می‌توان از آن همراه با --json یا --raw برای دریافت فهرست در یک قالب ماشین‌خوان استفاده کرد.

-J, --json

استفاده از قالب خروجی JSON.

-l, --list

استفاده از قالب خروجی فهرستی.

-n, --noheadings

چاپ نکردن خط سرستون.

-o, --output list

مشخص کردن ستون‌های خروجی برای چاپ. از --help برای دریافت فهرست تمام ستون‌های پشتیبانی‌شده استفاده کنید.

در صورتی که list در قالب +list مشخص شود (برای نمونه lsns -o +PATH)، فهرست پیش‌فرض ستون‌ها گسترش می‌یابد.

--output-all

نمایش تمامی ستون‌های موجود در خروجی.

-P, --persistent

نمایش تنها فضاهای نام بدون فرآیند (فضاهای نام پایدار یا persistent)، ایجاد شده با اتصال (bind mount) فایل‌های /proc/pid/ns/type به یک مسیر در سیستم‌فایل.

-p, --task PID

نمایش تنها فضاهای نام نگه‌داشته‌شده توسط فرآیند دارای این PID.

-Q, --filter expr

تنها فضاهای نامی را چاپ کن که با شرایط مشخص‌شده توسط عبارت (expr) مطابقت دارند.

این قابلیت آزمایشی (EXPERIMENTAL) است. همچنین scols-filter(5) را ببینید. برای نمونه، نام کاربری root را مستثنی کن، اما تمام فضاهای نامی را که بیش از یک فرآیند به آن‌ها تعلق دارد چاپ کن:

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

-r, --raw

استفاده از قالب خروجی خام.

-t, --type type

نمایش تنها نوع (type) مشخص‌شده از فضاهای نام. انواع پشتیبانی‌شده عبارتند از mnt، net، ipc، user، pid، uts، cgroup و time. این گزینه می‌تواند بیش از یک بار مشخص شود.

-u, --notruncate

کوتاه نکردن متن در ستون‌ها.

-W, --nowrap

استفاده نکردن از متن چندخطی در ستون‌ها.

-T, --tree[=rel]

استفاده از قالب خروجی درختی. اگر process به عنوان rel مشخص شود، درخت(های) فرآیند را در هر فضای نام چاپ می‌کند. این حالت پیش‌فرض در صورت عدم تعیین --tree است. اگر parent داده شود، درخت(های) ساخته‌شده بر اساس رابطه والد/فرزند را چاپ می‌کند. اگر owner داده شود، درخت(های) ساخته‌شده بر اساس رابطه مالک/تحت‌تملک را چاپ می‌کند. در صورت حذف rel، مقدار owner به عنوان پیش‌فرض استفاده می‌شود.

-h, --help

نمایش متن راهنما و خروج.

-V, --version

نمایش نسخه و خروج.

وضعیت خروج (EXIT STATUS)

ابزار lsns با یکی از مقادیر زیر خارج می‌شود:

0

موفقیت.

1

خطای عمومی.

2

یک دستور ioctl برای هسته ناشناخته بود.

محیط (ENVIRONMENT)

LSNS_DEBUG=all

خروجی اشکال‌زدایی دستور lsns را فعال می‌کند.

LIBSMARTCOLS_DEBUG=all

خروجی اشکال‌زدایی libsmartcols را فعال می‌کند.

LIBSMARTCOLS_DEBUG_PADDING=on

استفاده از نویسه‌های فاصله‌گذاری مرئی.

LIBSMARTCOLS_JSON=compact|lines

کنترل قالب خروجی JSON هنگام استفاده از --json. مقادیر پشتیبانی‌شده عبارتند از compact برای خروجی JSON با کمترین فضای خالی، و lines برای قالب خطوط JSON (یک شیء JSON در هر خط). اگر مقداردهی نشود یا روی هر مقدار دیگری تنظیم شود، از JSON با قالب‌بندی زیبا (pretty-printed) استفاده می‌شود.

نویسندگان (AUTHORS)

Karel Zak <kzak@redhat.com>

همچنین ببینید (SEE ALSO)

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

گزارش باگ‌ها (REPORTING BUGS)

برای گزارش باگ‌ها از سامانه پیگیری مشکلات https://github.com/util-linux/util-linux/issues. استفاده کنید.

در دسترس بودن (AVAILABILITY)

دستور lsns بخشی از بسته util-linux است که می‌توان آن را از آرشیو کرنل لینوکس https://www.kernel.org/pub/linux/utils/util-linux. دریافت کرد.