.\" -*- 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-execute 1 2026-08-01 "" ""
.SH "نام (NAME)"
lxc-execute \- اجرای یک برنامه در داخل کانتینر
.SH "خلاصه دستور (SYNOPSIS)"
'nh
.fi
.ad l
\fBlxc-execute\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
{-n \fIname\fR} [-d] [-f \fIconfig_file\fR] [-s KEY=VAL] [-u, --uid \fIuid\fR] [-g, --gid \fIgid\fR] [-- \fIcommand\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH "توضیحات (DESCRIPTION)"
دستور \fBlxc-execute\fR دستور (\fIcommand\fR) مشخص‌شده را درون کانتینر تعیین‌شده با \fIname\fR اجرا می‌کند.
.PP
این ابزار، کانتینر را بر اساس پیکربندی تعریف‌شده قبلی توسط دستور lxc-create یا با پارامتر فایل پیکربندی راه‌اندازی می‌کند. اگر هیچ پیکربندی مشخص نشده باشد، از جداسازی پیش‌فرض استفاده می‌شود.
.PP
این دستور عمدتاً زمانی استفاده می‌شود که می‌خواهید به‌سرعت یک برنامه کاربردی را درون یک محیط ایزوله‌شده راه‌اندازی کنید.
.PP
دستور \fBlxc-execute\fR دستور مشخص‌شده را از طریق یک فرایند میانی به نام \fBlxc-init\fR در کانتینر اجرا می‌کند. این lxc-init پس از راه‌اندازی دستور مشخص‌شده، منتظر پایان یافتن آن و تمام فرایندهای فرزندخوانده دیگر (reparented) خواهد ماند (جهت پشتیبانی از دیمن‌ها در کانتینر). به عبارت دیگر، در کانتینر، فرایند \fBlxc-init\fR شناسه pid برابر با 1 دارد و نخستین فرایند برنامه کاربردی دارای شناسه pid برابر با 2 خواهد بود.
.PP
فرایند فوق، \fBlxc-init\fR، برای فوروارد کردن سیگنال‌های دریافتی به دستور آغازشده طراحی شده است.
.SH "گزینه‌ها (OPTIONS)"
.TP 
\*(T<\fB\-f, \-\-rcfile \fR\*(T>\fIconfig_file\fR 
مشخص کردن فایل پیکربندی جهت تنظیم قابلیت‌های مجازی‌سازی و جداسازی کانتینر.
.PP
این فایل پیکربندی در صورت وجود، حتی اگر از قبل یک فایل پیکربندی در کانتینر ایجادشده قبلی (از طریق lxc-create) وجود داشته باشد، استفاده خواهد شد.
.TP 
\*(T<\fB\-s, \-\-define \fR\*(T>\fIKEY=VAL\fR 
تخصیص مقدار \fIVAL\fR به متغیر پیکربندی \fIKEY\fR. این مقدار بر هر تخصیصی که در \fIconfig_file\fR انجام شده باشد برتری خواهد داشت.
.TP 
\*(T<\fB\-d, \-\-daemon\fR\*(T> 
اجرای کانتینر به صورت یک دیمن (پس‌زمینه). از آنجا که کانتینر دیگر tty ندارد، در صورت بروز خطا هیچ پیامی نمایش داده نخواهد شد و برای بررسی خطا می‌توان از فایل گزارش استفاده کرد.
.TP 
\*(T<\fB\-u, \-\-uid \fR\*(T>\fIuid\fR 
اجرای \fIcommand\fR با شناسه کاربری (مقدار عددی) \fIuid\fR در داخل کانتینر.
.TP 
\*(T<\fB\-\-g, \-\-gid \fR\*(T>\fIgid\fR 
اجرای \fIcommand\fR با شناسه گروهی (مقدار عددی) \fIgid\fR در داخل کانتینر.
.TP 
\*(T<\fB\-\-\fR\*(T>
پایان گزینه‌ها را اعلام کرده و پردازش بیشتر گزینه‌ها را غیرفعال می‌کند. هر آرگومانی پس از -- به عنوان آرگومان دستور \fIcommand\fR در نظر گرفته می‌شود.
.PP
این گزینه زمانی مفید است که می‌خواهید گزینه‌هایی را به \fIcommand\fR ارسال کنید و نمی‌خواهید \fBlxc-execute\fR آن‌ها را تفسیر کند.
.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 "عیب‌یابی (DIAGNOSTIC)"
.TP 
The container is busy
کانتینر مشخص‌شده در حال حاضر برنامه‌ای را اجرا می‌کند. پیش از استفاده مجدد از این کانتینر باید آن را متوقف کنید یا یک کانتینر جدید بسازید.
.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)