نام (NAME)

lxc-execute - اجرای یک برنامه در داخل کانتینر

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

lxc-execute
{-n name} [-d] [-f config_file] [-s KEY=VAL] [-u, --uid uid] [-g, --gid gid] [-- command]

توضیحات (DESCRIPTION)

دستور lxc-execute دستور (command) مشخص‌شده را درون کانتینر تعیین‌شده با name اجرا می‌کند.

این ابزار، کانتینر را بر اساس پیکربندی تعریف‌شده قبلی توسط دستور lxc-create یا با پارامتر فایل پیکربندی راه‌اندازی می‌کند. اگر هیچ پیکربندی مشخص نشده باشد، از جداسازی پیش‌فرض استفاده می‌شود.

این دستور عمدتاً زمانی استفاده می‌شود که می‌خواهید به‌سرعت یک برنامه کاربردی را درون یک محیط ایزوله‌شده راه‌اندازی کنید.

دستور lxc-execute دستور مشخص‌شده را از طریق یک فرایند میانی به نام lxc-init در کانتینر اجرا می‌کند. این lxc-init پس از راه‌اندازی دستور مشخص‌شده، منتظر پایان یافتن آن و تمام فرایندهای فرزندخوانده دیگر (reparented) خواهد ماند (جهت پشتیبانی از دیمن‌ها در کانتینر). به عبارت دیگر، در کانتینر، فرایند lxc-init شناسه pid برابر با 1 دارد و نخستین فرایند برنامه کاربردی دارای شناسه pid برابر با 2 خواهد بود.

فرایند فوق، lxc-init، برای فوروارد کردن سیگنال‌های دریافتی به دستور آغازشده طراحی شده است.

گزینه‌ها (OPTIONS)

-f, --rcfile config_file: مشخص کردن فایل پیکربندی جهت تنظیم قابلیت‌های مجازی‌سازی و جداسازی کانتینر.

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

-s, --define KEY=VAL: تخصیص مقدار VAL به متغیر پیکربندی KEY. این مقدار بر هر تخصیصی که در config_file انجام شده باشد برتری خواهد داشت.
-d, --daemon: اجرای کانتینر به صورت یک دیمن (پس‌زمینه). از آنجا که کانتینر دیگر tty ندارد، در صورت بروز خطا هیچ پیامی نمایش داده نخواهد شد و برای بررسی خطا می‌توان از فایل گزارش استفاده کرد.
-u, --uid uid: اجرای command با شناسه کاربری (مقدار عددی) uid در داخل کانتینر.
--g, --gid gid: اجرای command با شناسه گروهی (مقدار عددی) gid در داخل کانتینر.
--: پایان گزینه‌ها را اعلام کرده و پردازش بیشتر گزینه‌ها را غیرفعال می‌کند. هر آرگومانی پس از -- به عنوان آرگومان دستور command در نظر گرفته می‌شود.

این گزینه زمانی مفید است که می‌خواهید گزینه‌هایی را به command ارسال کنید و نمی‌خواهید lxc-execute آن‌ها را تفسیر کند.

گزینه‌های عمومی (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: نمایش شماره نسخه.

عیب‌یابی (DIAGNOSTIC)

The container is busy: کانتینر مشخص‌شده در حال حاضر برنامه‌ای را اجرا می‌کند. پیش از استفاده مجدد از این کانتینر باید آن را متوقف کنید یا یک کانتینر جدید بسازید.

همچنین ببینید (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)