'\" t
.\"     Title: lsns
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: System Administration
.\"    Source: util-linux 2.42.3
.\"  Language: Persian
.\"
.TH "LSNS" "8" "2026-09-02" "util\-linux 2.42.3" "System Administration"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
lsns \- فهرست کردن فضاهای نام (Namespaces) در لینوکس
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBlsns\fP [options] [\fInamespace ID\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBlsns\fP اطلاعات مربوط به تمام فضاهای نام (namespaces) دردسترس فعلی یا فضای نام مشخص‌شده (\fInamespace\fP) را فهرست می‌کند. شناسه \fInamespace\fP یک شماره inode است.
.sp
خروجی پیش‌فرض ممکن است تغییر کند. بنابراین تا حد امکان، باید از استفاده از خروجی‌های پیش‌فرض در اسکریپت‌های خود خودداری کنید. در محیط‌هایی که به یک خروجی پایدار نیاز است، همواره حالت خروجی مورد انتظار (\fB\-\-tree\fP یا \fB\-\-list\fP) و ستون‌ها را با استفاده از گزینه \fB\-\-output\fP به همراه فهرستی از ستون‌ها به صراحت مشخص کنید.
.sp
ستون \fBNSFS\fP که هنگام تعیین \fBnet\fP برای گزینه \fB\-\-type\fP چاپ می‌شود، خاص است؛ این ستون از سلول‌های چندخطی استفاده می‌کند. برای تغییر به نمایش تک‌خطی جداشده با «,» از گزینه \fB\-\-nowrap\fP استفاده کنید.
.sp
توجه داشته باشید که \fBlsns\fP اطلاعات را مستقیماً از فایل‌سیستم \fI/proc\fP می‌خواند و برای کاربران غیر ریشه (non-root) ممکن است اطلاعات ناقصی بازگرداند. فایل‌سیستم فعلی \fI/proc\fP ممکن است اشتراک‌زدایی شده (unshared) باشد و تحت تأثیر یک فضای نام PID قرار گیرد (برای جزئیات بیشتر \fBunshare \-\-mount\-proc\fP را ببینید). دستور \fBlsns\fP قادر به دیدن فضاهای نام پایداری (persistent namespaces) که فاقد فرآیند هستند و نمونه فضای نام آن‌ها توسط یک bind mount به /proc/\fIpid\fP/ns/\fItype\fP نگه داشته شده است، نیست.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-H\fP, \fB\-\-list\-columns\fP
.RS 4
فهرست کردن ستون‌هایی که می‌توان با گزینه \fB\-\-output\fP مشخص کرد.
می‌توان از آن همراه با \fB\-\-json\fP یا \fB\-\-raw\fP برای دریافت فهرست در یک قالب ماشین‌خوان استفاده کرد.
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
استفاده از قالب خروجی JSON.
.RE
.sp
\fB\-l\fP, \fB\-\-list\fP
.RS 4
استفاده از قالب خروجی فهرستی.
.RE
.sp
\fB\-n\fP, \fB\-\-noheadings\fP
.RS 4
چاپ نکردن خط سرستون.
.RE
.sp
\fB\-o\fP, \fB\-\-output\fP \fIlist\fP
.RS 4
مشخص کردن ستون‌های خروجی برای چاپ. از \fB\-\-help\fP برای دریافت فهرست تمام ستون‌های پشتیبانی‌شده استفاده کنید.
.sp
در صورتی که \fIlist\fP در قالب \fB+\fP\fIlist\fP مشخص شود (برای نمونه \fBlsns \-o +PATH\fP)، فهرست پیش‌فرض ستون‌ها گسترش می‌یابد.
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
نمایش تمامی ستون‌های موجود در خروجی.
.RE
.sp
\fB\-P\fP, \fB\-\-persistent\fP
.RS 4
نمایش تنها فضاهای نام بدون فرآیند (فضاهای نام پایدار یا persistent)، ایجاد شده با اتصال (bind mount) فایل‌های /proc/pid/ns/type به یک مسیر در سیستم‌فایل.
.RE
.sp
\fB\-p\fP, \fB\-\-task\fP \fIPID\fP
.RS 4
نمایش تنها فضاهای نام نگه‌داشته‌شده توسط فرآیند دارای این \fIPID\fP.
.RE
.sp
\fB\-Q\fP, \fB\-\-filter\fP \fIexpr\fP
.RS 4
تنها فضاهای نامی را چاپ کن که با شرایط مشخص‌شده توسط عبارت (expr) مطابقت دارند.
.sp
این قابلیت آزمایشی (EXPERIMENTAL) است. همچنین \fBscols\-filter\fP(5) را ببینید. برای نمونه، نام کاربری root را مستثنی کن، اما تمام فضاهای نامی را که بیش از یک فرآیند به آن‌ها تعلق دارد چاپ کن:
.RE
.RS 3
.ll -.6i
.sp
.if n .RS 4
.nf
.fam C
lsns \-\-filter \*(AqUSER != "root" and NPROCS > 1\*(Aq
.fam
.fi
.if n .RE
.br
.RE
.ll
.sp
\fB\-r\fP, \fB\-\-raw\fP
.RS 4
استفاده از قالب خروجی خام.
.RE
.sp
\fB\-t\fP, \fB\-\-type\fP \fItype\fP
.RS 4
نمایش تنها نوع (\fItype\fP) مشخص‌شده از فضاهای نام. انواع پشتیبانی‌شده عبارتند از \fBmnt\fP، \fBnet\fP، \fBipc\fP، \fBuser\fP، \fBpid\fP، \fButs\fP، \fBcgroup\fP و \fBtime\fP. این گزینه می‌تواند بیش از یک بار مشخص شود.
.RE
.sp
\fB\-u\fP, \fB\-\-notruncate\fP
.RS 4
کوتاه نکردن متن در ستون‌ها.
.RE
.sp
\fB\-W\fP, \fB\-\-nowrap\fP
.RS 4
استفاده نکردن از متن چندخطی در ستون‌ها.
.RE
.sp
\fB\-T\fP, \fB\-\-tree\fP[\fB=\fP\fIrel\fP]
.RS 4
استفاده از قالب خروجی درختی. اگر \fBprocess\fP به عنوان \fIrel\fP مشخص شود، درخت(های) فرآیند را در هر فضای نام چاپ می‌کند. این حالت پیش‌فرض در صورت عدم تعیین \fB\-\-tree\fP است. اگر \fBparent\fP داده شود، درخت(های) ساخته‌شده بر اساس رابطه والد/فرزند را چاپ می‌کند. اگر \fBowner\fP داده شود، درخت(های) ساخته‌شده بر اساس رابطه مالک/تحت‌تملک را چاپ می‌کند. در صورت حذف \fIrel\fP، مقدار \fBowner\fP به عنوان پیش‌فرض استفاده می‌شود.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.sp
ابزار \fBlsns\fP با یکی از مقادیر زیر خارج می‌شود:
.sp
\fB0\fP
.RS 4
موفقیت.
.RE
.sp
\fB1\fP
.RS 4
خطای عمومی.
.RE
.sp
\fB2\fP
.RS 4
یک دستور ioctl برای هسته ناشناخته بود.
.RE
.SH "محیط (ENVIRONMENT)"
.sp
\fBLSNS_DEBUG\fP=all
.RS 4
خروجی اشکال‌زدایی دستور \fBlsns\fP را فعال می‌کند.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG\fP=all
.RS 4
خروجی اشکال‌زدایی libsmartcols را فعال می‌کند.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG_PADDING\fP=on
.RS 4
استفاده از نویسه‌های فاصله‌گذاری مرئی.
.RE
.sp
\fBLIBSMARTCOLS_JSON\fP=compact|lines
.RS 4
کنترل قالب خروجی JSON هنگام استفاده از \fB\-\-json\fP. مقادیر پشتیبانی‌شده عبارتند از
\fBcompact\fP برای خروجی JSON با کمترین فضای خالی، و \fBlines\fP برای قالب خطوط JSON
(یک شیء JSON در هر خط). اگر مقداردهی نشود یا روی هر مقدار دیگری تنظیم شود،
از JSON با قالب‌بندی زیبا (pretty\-printed) استفاده می‌شود.
.RE
.SH "نویسندگان (AUTHORS)"
.sp
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBnsenter\fP(1),
\fBunshare\fP(1),
\fBclone\fP(2),
\fBnamespaces\fP(7),
\fBioctl_ns\fP(2),
\fBip\-netns\fP(8),
\fBscols\-filter\fP(5)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری مشکلات" "."
استفاده کنید.
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBlsns\fP بخشی از بسته util\-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "آرشیو کرنل لینوکس" "."
دریافت کرد.