نام (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 مجدداً بازپیاده‌سازی و توسعه داده شد.