lxc-execute(1)                                                  lxc-execute(1)

نام (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)

                                  2026-08-01                    lxc-execute(1)