.\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH lxc-ls 1 2026-08-01 "" ""
.SH "نام (NAME)"
lxc-ls \- فهرست کردن کانتینرهای موجود در سیستم
.SH "خلاصه دستور (SYNOPSIS)"
'nh
.fi
.ad l
\fBlxc-ls\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-1] [--active] [--frozen] [--running] [--stopped] [--defined] [-f] [-F \fIformat\fR] [-g \fIgroups\fR] [--nesting=\fINUM\fR] [--filter=\fIregex\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH "توضیحات (DESCRIPTION)"
دستور \fBlxc-ls\fR کانتینرهای موجود در سیستم را فهرست می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP 
\*(T<\fB\-1\fR\*(T> 
نمایش یک مدخل در هر سطر (پیش‌فرض هنگامی که /dev/stdout یک tty نباشد).
.TP 
\*(T<\fB\-\-active\fR\*(T> 
فقط فهرست کردن کانتینرهای فعال (مشابه با --frozen --running).
.TP 
\*(T<\fB\-\-frozen\fR\*(T> 
فقط فهرست کردن کانتینرهای منجمدشده (frozen).
.TP 
\*(T<\fB\-\-running\fR\*(T> 
فقط فهرست کردن کانتینرهای در حال اجرا.
.TP 
\*(T<\fB\-\-stopped\fR\*(T> 
فقط فهرست کردن کانتینرهای متوقف‌شده.
.TP 
\*(T<\fB\-\-defined\fR\*(T> 
فقط فهرست کردن کانتینرهای تعریف‌شده.
.TP 
\*(T<\fB\-f,\-\-fancy\fR\*(T> 
استفاده از خروجی ستونی و زیبا (fancy).
.TP 
\*(T<\fB\-F,\-\-fancy\-format \fR\*(T>\fIformat\fR 
فهرستی از ستون‌های جداشده با کاما جهت نمایش در خروجی ستونی. فهرست فیلدهای پذیرفته‌شده و پیش‌فرض در --help ذکر شده است.
.TP 
\*(T<\fB\-g,\-\-groups \fR\*(T>\fIgroups\fR 
فهرستی از گروه‌های جداشده با کاما که کانتینر برای نمایش داده شدن باید عضو آن‌ها باشد. این پارامتر می‌تواند چندین بار داده شود.
.TP 
\*(T<\fB\-\-nesting=\fR\*(T>\fINUM\fR 
نمایش کانتینرهای تودرتو (nested). تعداد سطوح تودرتویی برای نمایش را می‌توان با مشخص کردن یک عدد به عنوان آرگومان تعیین کرد.
.TP 
\*(T<\fB\-\-filter=\fR\*(T>\fIregex\fR 
عبارت باقاعده (regular expression) داده‌شده به \fBlxc-ls\fR روی نام کانتینر اعمال خواهد شد. این عبارت در قالب عبارات باقاعده تعمیم‌یافته POSIX است. همچنین می‌توان آن را به عنوان آرگومان اضافی بدون استفاده صریح از \*(T<\fB\-\-filter\fR\*(T> مشخص کرد.
.SH "مثال‌ها (EXAMPLES)"
.TP 
lxc-ls --fancy
تمامی کانتینرها را فهرست می‌کند؛ در هر سطر یک کانتینر را به همراه نام، وضعیت و نشانی‌های ipv4 و ipv6 آن نمایش می‌دهد.
.TP 
lxc-ls --active -1
کانتینرهای فعال را فهرست کرده و خروجی را در یک ستون نمایش می‌دهد.
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
این گزینه‌ها بین اکثر دستورات lxc مشترک هستند.
.TP 
\*(T<\fB\-?, \-h, \-\-help\fR\*(T>
چاپ پیام راهنمای استفاده، کامل‌تر از حالت معمول.
.TP 
\*(T<\fB\-\-usage\fR\*(T>
نمایش پیام نحوه استفاده.
.TP 
\*(T<\fB\-q, \-\-quiet\fR\*(T>
حالت بی‌صدا.
.TP 
\*(T<\fB\-P, \-\-lxcpath=\fR\*(T>\fIPATH\fR
استفاده از یک مسیر جایگزین برای کانتینر. مسیر پیش‌فرض /var/lib/lxc است.
.TP 
\*(T<\fB\-o, \-\-logfile=\fR\*(T>\fIFILE\fR
ارسال خروجی لاگ به یک فایل گزارش جایگزین \fIFILE\fR. حالت پیش‌فرض بدون فایل گزارش است.
.TP 
\*(T<\fB\-l, \-\-logpriority=\fR\*(T>\fILEVEL\fR
تنظیم اولویت لاگ روی \fILEVEL\fR. اولویت لاگ پیش‌فرض \*(T<ERROR\*(T> است. مقادیر ممکن عبارتند از:
\*(T<FATAL\*(T>، \*(T<ALERT\*(T>،
\*(T<CRIT\*(T>،
\*(T<WARN\*(T>، \*(T<ERROR\*(T>،
\*(T<NOTICE\*(T>، \*(T<INFO\*(T>،
\*(T<DEBUG\*(T>، \*(T<TRACE\*(T>.
.PP
توجه داشته باشید که این گزینه اولویت رویدادها را در فایل گزارش جایگزین تعیین می‌کند و تاثیری بر رویدادهای ERROR در stderr ندارد.
.TP 
\*(T<\fB\-n, \-\-name=\fR\*(T>\fINAME\fR
استفاده از شناسه کانتینر \fINAME\fR. قالب شناسه کانتینر یک رشته حروفی-عددی است.
.TP 
\*(T<\fB\-\-rcfile=\fR\*(T>\fIFILE\fR
تعیین فایل پیکربندی برای تنظیم قابلیت‌های مجازی‌سازی و جداسازی کانتینر.
.PP
این فایل پیکربندی در صورت وجود، حتی اگر از قبل یک فایل پیکربندی در کانتینر ایجادشده قبلی (از طریق lxc-create) وجود داشته باشد، استفاده خواهد شد.
.TP 
\*(T<\fB\-\-version\fR\*(T>
نمایش شماره نسخه.
.SH "همچنین ببینید (SEE ALSO)"
\fBlxc\fR(7),
\fBlxc-create\fR(1),
\fBlxc-copy\fR(1),
\fBlxc-destroy\fR(1),
\fBlxc-start\fR(1),
\fBlxc-stop\fR(1),
\fBlxc-execute\fR(1),
\fBlxc-console\fR(1),
\fBlxc-monitor\fR(1),
\fBlxc-wait\fR(1),
\fBlxc-cgroup\fR(1),
\fBlxc-ls\fR(1),
\fBlxc-info\fR(1),
\fBlxc-freeze\fR(1),
\fBlxc-unfreeze\fR(1),
\fBlxc-attach\fR(1),
\fBlxc.conf\fR(5)
.SH "تاریخچه (HISTORY)"
در ابتدا به عنوان یک اسکریپت شل توسط Daniel Lezcano و Serge Hallyn نوشته شد. سپس توسط Stéphane Graber در پایتون بازپیاده‌سازی و گسترش یافت و پس از آن توسط Christian Brauner در زبان C مجدداً بازپیاده‌سازی و توسعه داده شد.