.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH vmexec-run 1  "run " 
.SH "نام (NAME)"
vmexec\-run \- اجرای یک دستور در یک ماشین مجازی جدید
.SH "خلاصه دستور (SYNOPSIS)"
\fBvmexec run\fR [\fB\-d\fR|\fB\-\-detach\fR] [\fB\-\-rm\fR] [\fB\-\-vmid\fR] [\fB\-\-disable\-kvm\fR] [\fB\-m\fR|\fB\-\-memory\fR] [\fB\-e\fR|\fB\-\-env\fR] [\fB\-w\fR|\fB\-\-workdir\fR] [\fB\-v\fR|\fB\-\-volume\fR] [\fB\-\-pmem\fR] [\fB\-p\fR|\fB\-\-publish\fR] [\fB\-s\fR|\fB\-\-ssh\-timeout\fR] [\fB\-i\fR|\fB\-\-interactive\fR] [\fB\-t\fR|\fB\-\-tty\fR] [\fB\-\-show\-vm\-window\fR] [\fB\-\-pull\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIIMAGE_SOURCE\fR> [\fIARGS\fR] 
.SH "توضیحات (DESCRIPTION)"
یک دستور را در یک ماشین مجازی جدید اجرا می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-d\fR, \fB\-\-detach\fR
اجرای ماشین مجازی در پس‌زمینه و چاپ شناسه ماشین مجازی.
.TP
\fB\-\-rm\fR
حذف داده‌های زمان اجرای ماشین مجازی پس از خروج.
.TP
\fB\-\-vmid\fR \fI<VMID>\fR
شناسه ماشین مجازی.

اگر مشخص نشود، یک شناسه تصادفی تولید خواهد شد.
.TP
\fB\-\-disable\-kvm\fR
اجرای ماشین مجازی با TCG به‌جای KVM.

این گزینه بیشتر در محیط‌هایی که KVM در دسترس نیست مفید خواهد بود. بسیار کندتر خواهد بود اما ممکن است در برخی زمینه‌ها قابل قبول باشد.
.TP
\fB\-m\fR, \fB\-\-memory\fR \fI<MEMORY>\fR
محدودیت حافظه برای ماشین مجازی بر حسب گیگابایت.

باید یک عدد صحیح با حداقل مقدار ۱ باشد.

اگر مشخص نشود، تمام حافظه در دسترس میزبان استفاده می‌شود.
.TP
\fB\-e\fR, \fB\-\-env\fR \fI<ENV>\fR
تنظیم متغیرهای محیطی برای فرایند درون ماشین مجازی.

می‌تواند چندین بار مشخص شود.

قالب مورد انتظار: KEY=VALUE
.TP
\fB\-w\fR, \fB\-\-workdir\fR \fI<WORKDIR>\fR
دایرکتوری کاری درون ماشین مجازی.

دایرکتوری کاری پیش‌فرض برای اجرای برنامه‌ها درون ماشین مجازی به ایمیج بستگی دارد. در بیشتر موارد، /root خواهد بود.
.TP
\fB\-v\fR, \fB\-\-volume\fR \fI<VOLUMES>\fR
سوار کردن اتصالی (bind mount) یک حجم در ماشین مجازی.

می‌تواند چندین بار مشخص شود.

قالب مورد انتظار: source:dest[:ro]

عبارت `ro` می‌تواند به‌صورت اختیاری برای مشخص کردن اتصال فقط‌خواندنی ارائه شود.

مثال: $PWD/src:/mnt:ro
.TP
\fB\-\-pmem\fR \fI<PMEMS>\fR
سوار کردن یک فایل دستگاه virtio\-pmem در ماشین مجازی.

ممکن است بخواهید این کار را برای دور زدن حافظه موقت صفحات (page cache) مهمان انجام دهید. این مورد زمانی مهم است که بیش از ظرفیت به میزبان منابع تخصیص می‌دهید (overprovisioning؛ یعنی اختصاص مجموع حافظه بیشتر به ماشین‌های مجازی نسبت به آنچه میزبان در واقعیت دارد) و بار کاریِ نوشتنِ سنگینی دارید. برای اطلاعات بیشتر، ببینید: https://www.qemu.org/docs/master/system/devices/virtio\-pmem.html

می‌تواند چندین بار مشخص شود.

اندازه بر حسب گیگابایت است.

قالب مورد انتظار: dest:<size>

مثال: /var/lib:20
.TP
\fB\-p\fR, \fB\-\-publish\fR \fI<PUBLISHED_PORTS>\fR
انتشار یک درگاه از ماشین مجازی به میزبان.

می‌تواند چندین بار مشخص شود.

قالب مورد انتظار: [[hostip:][hostport]:]vmport

مقدار `hostip` اختیاری است و اگر مشخص نشود، درگاه روی تمام IPهای میزبان متصل (bind) خواهد شد.

مقدار `hostport` اختیاری است و اگر ارائه نشود، همان مقدار `vmport` برای پورت میزبان استفاده خواهد شد.

در حال حاضر فقط IPv4 برای `hostip` پشتیبانی می‌شود.
.TP
\fB\-s\fR, \fB\-\-ssh\-timeout\fR \fI<SSH_TIMEOUT>\fR [پیش‌فرض: 20]
مهلت زمانی اتصال SSH.

تلاش برای این مدت زمان (به ثانیه) جهت اتصال به کارساز SSH ماشین مجازی.
.TP
\fB\-i\fR, \fB\-\-interactive\fR \fI<INTERACTIVE>\fR [پیش‌فرض: auto]
در دسترس قرار دادن STDIN برای فرایند ماشین مجازی.

اگر \*(Aqauto\*(Aq باشد، در صورت در دسترس بودن تلاش می‌کند از stdin بخواند و در صورت عدم دسترسی کاری انجام نمی‌دهد. اگر \*(Aqalways\*(Aq باشد، تلاش می‌کند از stdin بخواند و در صورت در دسترس نبودن stdin متوقف می‌شود.
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
always
.IP \(bu 2
never
.IP \(bu 2
auto
.RE
.TP
\fB\-t\fR, \fB\-\-tty\fR \fI<TTY>\fR [پیش‌فرض: auto]
تخصیص یک pseudo\-TTY برای ماشین مجازی.

اگر \*(Aqauto\*(Aq باشد، در صورتی که vmexec از یک ترمینال تعاملی اجرا شود فعال خواهد شد.
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
always
.IP \(bu 2
never
.IP \(bu 2
auto
.RE
.TP
\fB\-\-show\-vm\-window\fR
نمایش یک پنجره که ماشین مجازی در حال اجرا را نشان می‌دهد.

این گزینه بیشتر برای رفع اشکال خطاهای راه‌اندازی (بوت) مفید است.
.TP
\fB\-\-pull\fR \fI<PULL>\fR [پیش‌فرض: missing]
زمان دریافت (pull) ایمیج جدید.
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
missing
.IP \(bu 2
never
.IP \(bu 2
newer
.RE
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq).
.TP
<\fIIMAGE_SOURCE\fR>
یک سیستم‌عامل (مانند archlinux) یا مسیری به یک ایمیج.

انواع سیستم‌عامل ممکن: archlinux
.TP
[\fIARGS\fR]
آرگومان‌ها برای اجرا درون ماشین مجازی.