lxc-ls(1)                                                            lxc-ls(1)

نام (NAME)
       lxc-ls - فهرست کردن کانتینرهای موجود در سیستم

خلاصه دستور (SYNOPSIS)
       lxc-ls
[-1] [--active] [--frozen] [--running] [--stopped] [--defined] [-f] [-F
format] [-g groups] [--nesting=NUM] [--filter=regex]

توضیحات (DESCRIPTION)
       دستور lxc-ls کانتینرهای موجود در سیستم را فهرست می‌کند.

گزینه‌ها (OPTIONS)
       -1     نمایش یک مدخل در هر سطر (پیش‌فرض هنگامی که /dev/stdout یک tty
              نباشد).

       --active
              فقط فهرست کردن کانتینرهای فعال (مشابه با --frozen --running).

       --frozen
              فقط فهرست کردن کانتینرهای منجمدشده (frozen).

       --running
              فقط فهرست کردن کانتینرهای در حال اجرا.

       --stopped
              فقط فهرست کردن کانتینرهای متوقف‌شده.

       --defined
              فقط فهرست کردن کانتینرهای تعریف‌شده.

       -f,--fancy
              استفاده از خروجی ستونی و زیبا (fancy).

       -F,--fancy-format format
              فهرستی از ستون‌های جداشده با کاما جهت نمایش در خروجی ستونی. فهرست
              فیلدهای پذیرفته‌شده و پیش‌فرض در --help ذکر شده است.

       -g,--groups groups
              فهرستی از گروه‌های جداشده با کاما که کانتینر برای نمایش داده شدن
              باید عضو آن‌ها باشد. این پارامتر می‌تواند چندین بار داده شود.

       --nesting=NUM
              نمایش کانتینرهای تودرتو (nested). تعداد سطوح تودرتویی برای نمایش
              را می‌توان با مشخص کردن یک عدد به عنوان آرگومان تعیین کرد.

       --filter=regex
              عبارت باقاعده (regular expression) داده‌شده به lxc-ls روی نام
              کانتینر اعمال خواهد شد. این عبارت در قالب عبارات باقاعده
              تعمیم‌یافته POSIX است. همچنین می‌توان آن را به عنوان آرگومان اضافی
              بدون استفاده صریح از --filter مشخص کرد.

مثال‌ها (EXAMPLES)
       lxc-ls --fancy
              تمامی کانتینرها را فهرست می‌کند؛ در هر سطر یک کانتینر را به همراه
              نام، وضعیت و نشانی‌های ipv4 و ipv6 آن نمایش می‌دهد.

       lxc-ls --active -1
              کانتینرهای فعال را فهرست کرده و خروجی را در یک ستون نمایش می‌دهد.

گزینه‌های عمومی (COMMON OPTIONS)
       این گزینه‌ها بین اکثر دستورات lxc مشترک هستند.

       -?, -h, --help
              چاپ پیام راهنمای استفاده، کامل‌تر از حالت معمول.

       --usage
              نمایش پیام نحوه استفاده.

       -q, --quiet
              حالت بی‌صدا.

       -P, --lxcpath=PATH
              استفاده از یک مسیر جایگزین برای کانتینر. مسیر پیش‌فرض
              /var/lib/lxc است.

       -o, --logfile=FILE
              ارسال خروجی لاگ به یک فایل گزارش جایگزین FILE. حالت پیش‌فرض بدون
              فایل گزارش است.

       -l, --logpriority=LEVEL
              تنظیم اولویت لاگ روی LEVEL. اولویت لاگ پیش‌فرض ERROR است. مقادیر
              ممکن عبارتند از: FATAL، ALERT، CRIT، WARN، ERROR، NOTICE، INFO،
              DEBUG، TRACE.

       توجه داشته باشید که این گزینه اولویت رویدادها را در فایل گزارش جایگزین
       تعیین می‌کند و تاثیری بر رویدادهای ERROR در stderr ندارد.

       -n, --name=NAME
              استفاده از شناسه کانتینر NAME. قالب شناسه کانتینر یک رشته
              حروفی-عددی است.

       --rcfile=FILE
              تعیین فایل پیکربندی برای تنظیم قابلیت‌های مجازی‌سازی و جداسازی
              کانتینر.

       این فایل پیکربندی در صورت وجود، حتی اگر از قبل یک فایل پیکربندی در
       کانتینر ایجادشده قبلی (از طریق lxc-create) وجود داشته باشد، استفاده
       خواهد شد.

       --version
              نمایش شماره نسخه.

همچنین ببینید (SEE ALSO)
       lxc(7), lxc-create(1), lxc-copy(1), lxc-destroy(1), lxc-start(1), lxc-
       stop(1), lxc-execute(1), lxc-console(1), lxc-monitor(1), lxc-wait(1),
       lxc-cgroup(1), lxc-ls(1), lxc-info(1), lxc-freeze(1), lxc-unfreeze(1),
       lxc-attach(1), lxc.conf(5)

تاریخچه (HISTORY)
       در ابتدا به عنوان یک اسکریپت شل توسط Daniel Lezcano و Serge Hallyn
       نوشته شد. سپس توسط Stéphane Graber در پایتون بازپیاده‌سازی و گسترش یافت
       و پس از آن توسط Christian Brauner در زبان C مجدداً بازپیاده‌سازی و توسعه
       داده شد.

                                  2026-08-01                         lxc-ls(1)