.TH VNG "1" "2026\-07\-06" "virtme\-ng 1.41" "virtme\-ng"
.SH "نام (NAME)"
vng \- اجرای سریع هسته‌ها درون یک اسنپ‌شات مجازی‌سازی‌شده از سیستم زنده
.SH "خلاصه دستور (SYNOPSIS)"
.B vng
[-h] [--version] [--run [RUN] | --build | --clean | --dump DUMP | --mcp] [--dry-run] [--no-virtme-ng-init] [--empty-passwords] [--pin [PIN]] [--gdb] [--snaps] [--debug] [--kconfig] [--skip-modules] [--commit COMMIT] [--config CONFIG] [--configitem CONFIGITEM] [--busybox PATH_TO_BUSYBOX] [--qemu QEMU] [--name NAME] [--user USER] [--shell BINARY] [--root ROOT] [--root-release ROOT_RELEASE] [--rw] [--force-9p] [--disable-microvm] [--disable-kvm] [--disable-monitor] [--cwd CWD] [--rodir RODIR] [--rwdir RWDIR] [--overlay-rwdir OVERLAY_RWDIR] [--cpus CPUS] [--memory MEMORY] [--numa MEM[,cpus=FIRST_CPU1[-LAST_CPU1]][,cpus=FIRST_CPU2[-LAST_CPU2]]...] [--numa-distance SRC,DST=VAL] [--balloon] [--network NETWORK] [--no-dhcp] [--net-mac-address NET_MAC_ADDRESS] [--disk PATH] [--exec EXEC] [--append APPEND] [--force-initramfs] [--sound] [--graphics] [--verbose] [--quiet] [--qemu-opts QEMU_OPTS] [--build-host BUILD_HOST] [--build-host-exec-prefix BUILD_HOST_EXEC_PREFIX] [--build-host-vmlinux] [--arch ARCH] [--cross-compile CROSS_COMPILE] [--force] [--nvgpu [GPU PCI Address]] [--vfio-pci PCI_ADDRESS] [--console [PORT]] [--console-client [PORT]] [--ssh [PORT]] [--ssh-client [PORT]] [--ssh-tcp] [--remote-cmd COMMAND] [--systemd] [envs ...]
.SH "توضیحات (DESCRIPTION)"
ساخت و اجرای هسته‌ها درون یک اسنپ‌شات مجازی‌سازی‌شده از سیستم زنده شما

.TP
\fBenvs\fR
متغیرهای اضافی Makefile

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-version\fR, \fB\-V\fR
نمایش شماره نسخه برنامه و خروج

.TP
\fB\-\-dry\-run\fR
تنها نمایش دستورها بدون اجرای واقعی آن‌ها.

.TP
\fB\-\-no\-virtme\-ng\-init\fR
بازگشت به virtme\-init مبتنی بر bash (کاربردی برای اشکال‌زدایی/توسعه)

.TP
\fB\-\-empty\-passwords\fR
استفاده از گذرواژه‌های خالی برای تمامی کاربران

.TP
\fB\-\-pin\fR \fI\,[PIN]\/\fR, \fB\-P\fR \fI\,[PIN]\/\fR
سنجاق کردن هر ریسه vCPU در QEMU به یک پردازنده متمایز میزبان. اگر بدون آرگومان مشخص شود، تمام پردازنده‌های میزبان استفاده می‌شوند. اگر همراه با آرگومان داده شود، باید فهرستی/محدوده‌ای از پردازنده‌ها باشد (مانند 0,1,3\-5,9). نکته: در هر لحظه تنها یک مهمان virtme\-ng می‌تواند سنجاق شود؛ سنجاق کردن چندین مهمان virtme\-ng هنوز پشتیبانی نمی‌شود.

.TP
\fB\-\-gdb\fR
پیوست کردن یک نشست اشکال‌زدایی به نمونه در حال اجرا که با \-\-debug آغاز شده است

.TP
\fB\-\-snaps\fR
اجازه اجرای snapها درون virtme\-ng

.TP
\fB\-\-debug\fR
شروع نمونه با اشکال‌زدایی فعال: اجازه ایجاد رونوشت خرابی (crash dump)، اتصال یک نشست اشکال‌زدایی با GDB و غیره.

.TP
\fB\-\-kconfig\fR, \fB\-k\fR
تنها بازنویسی .config هسته بدون ساخت/اجرای هیچ‌چیز

.TP
\fB\-\-skip\-modules\fR, \fB\-S\fR
اجرای یک ساخت بسیار سریع با نادیده گرفتن ماژول‌های خارجی (بدون پشتیبانی از ماژول‌های خارجی)

.TP
\fB\-\-commit\fR \fI\,COMMIT\/\fR, \fB\-c\fR \fI\,COMMIT\/\fR
استفاده از یک هسته مشخص‌شده با شناسه کامیت، برچسب (tag) یا شاخه (branch) خاص

.TP
\fB\-\-config\fR \fI\,CONFIG\/\fR, \fB\-\-custom\fR \fI\,CONFIG\/\fR, \fB\-f\fR \fI\,CONFIG\/\fR
استفاده از یک (یا چند) فایل قطعه‌کد .config هسته، یا '\-' برای stdin

.TP
\fB\-\-configitem\fR \fI\,CONFIGITEM\/\fR
افزودن یک CONFIG_ITEM=val پس از \-\-config <fragments>؛ این موارد تنظیمات قبلی پیکربندی را بازنویسی می‌کنند

.TP
\fB\-\-busybox\fR \fI\,PATH_TO_BUSYBOX\/\fR
استفاده از فایل باینری مشخص‌شده busybox

.TP
\fB\-\-qemu\fR \fI\,QEMU\/\fR
استفاده از فایل باینری مشخص‌شده QEMU

.TP
\fB\-\-name\fR \fI\,NAME\/\fR
تنظیم نام میزبان مهمان و پرچم \-name در qemu

.TP
\fB\-\-user\fR \fI\,USER\/\fR
تغییر کاربر درون مهمان (پیش‌فرض همان کاربر سیستم میزبان است)

.TP
\fB\-\-shell\fR \fI\,BINARY\/\fR
بازنویسی شل پیش‌فرض کاربر

.TP
\fB\-\-root\fR \fI\,ROOT\/\fR
ارائه یک chroot خاص جهت استفاده درون هسته مجازی‌سازی‌شده (کاربردی به همراه \-\-arch)

.TP
\fB\-\-root\-release\fR \fI\,ROOT_RELEASE\/\fR
استفاده از یک انتشار هدف Ubuntu برای ایجاد یک chroot جدید (استفاده به همراه \-\-root)

.TP
\fB\-\-rw\fR
دادن دسترسی خواندن/نوشتن به سیستم فایل ریشه مهمان. هشدار: این کار می‌تواند برای سیستم فایل میزبان خطرناک باشد!

.TP
\fB\-\-force\-9p\fR
استفاده از سیستم فایل قدیمی 9p به عنوان rootfs

.TP
\fB\-\-disable\-microvm\fR
خودداری از استفاده از معماری "microvm" در QEMU (تنها روی x86_64)

.TP
\fB\-\-disable\-kvm\fR
خودداری از استفاده از مجازی‌سازی سخت‌افزاری / KVM

.TP
\fB\-\-disable\-monitor\fR
غیرفعال کردن مانیتور STDIO در QEMU

.TP
\fB\-\-cwd\fR \fI\,CWD\/\fR
تغییر دایرکتوری کاری مهمان (پیش‌فرض در صورت امکان همان دایرکتوری کاری فعلی است)

.TP
\fB\-\-rodir\fR \fI\,RODIR\/\fR
ارائه یک دایرکتوری فقط‌خواندنی به مهمان. استفاده از \-\-rodir=path یا \-\-rodir=guestpath=hostpath

.TP
\fB\-\-rwdir\fR \fI\,RWDIR\/\fR
ارائه یک دایرکتوری خواندن/نوشتن به مهمان. استفاده از \-\-rwdir=path یا \-\-rwdir=guestpath=hostpath

.TP
\fB\-\-overlay\-rwdir\fR \fI\,OVERLAY_RWDIR\/\fR
ارائه یک دایرکتوری که برای مهمان خواندن/نوشتن است اما در میزبان فقط‌خواندنی می‌باشد. استفاده از \-\-overlay\-rwdir=path.

.TP
\fB\-\-cpus\fR \fI\,CPUS\/\fR, \fB\-p\fR \fI\,CPUS\/\fR
تنظیم تعداد پردازنده‌های مهمان (پرچم \-smp در qemu)

.TP
\fB\-\-memory\fR \fI\,MEMORY\/\fR, \fB\-m\fR \fI\,MEMORY\/\fR
تنظیم اندازه حافظه مهمان (پرچم \-m در qemu)

.TP
\fB\-\-numa\fR \fI\,MEM[,cpus=FIRST_CPU1[\-LAST_CPU1]][,cpus=FIRST_CPU2[\-LAST_CPU2]]...\/\fR
ایجاد یک گره NUMA در مهمان. از این گزینه چندین بار برای ایجاد گره‌های NUMA بیشتر استفاده کنید. اندازه کل حافظه اختصاص‌یافته به گره‌های NUMA باید با اندازه حافظه مهمان (مشخص‌شده با \-\-memory/\-m) مطابقت داشته باشد. این گزینه به طور ضمنی معماری microvm را غیرفعال می‌کند.

.TP
\fB\-\-numa\-distance\fR \fI\,SRC,DST=VAL\/\fR
تنظیم فاصله VAL بین گره‌های NUMA مبدا (SRC) و مقصد (DST). از این گزینه چندین بار برای تعیین چندین فاصله بین گره‌های NUMA استفاده کنید. این گزینه تنها همراه با \-\-numa استفاده می‌شود.

.TP
\fB\-\-balloon\fR
اجازه به میزبان برای درخواست آزادسازی حافظه از مهمان

.TP
\fB\-\-network\fR \fI\,NETWORK\/\fR, \fB\-n\fR \fI\,NETWORK\/\fR
فعال‌سازی دسترسی شبکه: user، bridge(=<br>)، loop

.TP
\fB\-\-no\-dhcp\fR
غیرفعال کردن پیکربندی DHCP برای رابط‌های شبکه.

.TP
\fB\-\-net\-mac\-address\fR \fI\,NET_MAC_ADDRESS\/\fR
آدرس MAC جهت انتساب به رابط NIC، مانند 52:54:00:12:34:56. آخرین بایت (octet) برای دستگاه‌های شبکه بعدی افزایش خواهد یافت.

.TP
\fB\-\-disk\fR \fI\,PATH\/\fR, \fB\-D\fR \fI\,PATH\/\fR
افزودن یک فایل به عنوان دیسک virtio\-scsi (می‌تواند چندین بار استفاده شود)

.TP
\fB\-\-exec\fR \fI\,EXEC\/\fR, \fB\-e\fR \fI\,EXEC\/\fR
اجرای یک دستور درون هسته و خروج

.TP
\fB\-\-append\fR \fI\,APPEND\/\fR, \fB\-a\fR \fI\,APPEND\/\fR
گزینه‌های بوت اضافی هسته (می‌تواند چندین بار استفاده شود)

.TP
\fB\-\-force\-initramfs\fR
استفاده از یک initramfs حتی در صورتی که غیرضروری باشد

.TP
\fB\-\-sound\fR
فعال‌سازی دستگاه صوتی (در صورتی که معماری از آن پشتیبانی کند).TP
\fB\-\-graphics\fR, \fB\-g\fR
نمایش خروجی گرافیکی به‌جای استفاده از کنسول.

.TP
\fB\-\-verbose\fR, \fB\-v\fR
افزایش میزان جزئیات خروجی کنسول.

.TP
\fB\-\-quiet\fR, \fB\-q\fR
لغو حالت پرجزئیات (غیرفعال‌سازی \fB\-\-verbose\fR).

.TP
\fB\-\-qemu\-opts\fR \fI\,QEMU_OPTS\/\fR, \fB\-o\fR \fI\,QEMU_OPTS\/\fR
آرگومان‌های اضافی برای QEMU (می‌تواند چندین بار استفاده شود) یا تجمیع‌شده با هم: \-\-qemu\-opts='...'

.TP
\fB\-\-build\-host\fR \fI\,BUILD_HOST\/\fR
انجام ساخت کرنل روی یک سرور راه دور (نیازمند دسترسی ssh).

.TP
\fB\-\-build\-host\-exec\-prefix\fR \fI\,BUILD_HOST_EXEC_PREFIX\/\fR
افزودن یک دستور (مانند chroot) به ابتدای دستور make اجراشده روی میزبان ساخت دوردست.

.TP
\fB\-\-build\-host\-vmlinux\fR
کپی کردن vmlinux از میزبان ساخت به سیستم محلی.

.TP
\fB\-\-arch\fR \fI\,ARCH\/\fR
تولید و آزمایش کرنل برای یک معماری خاص (پیش‌فرض، معماری میزبان است؛ در صورت تنظیم، باید همراه با \fB\-\-root\fR استفاده شود).

.TP
\fB\-\-cross\-compile\fR \fI\,CROSS_COMPILE\/\fR
تنظیم پیشوند کامپایل متقاطع (cross\-compile).

.TP
\fB\-\-force\fR
بازنشانی اجباری مخزن git به شاخه یا کامیت هدف (هشدار: این کار ممکن است تغییرات ذخیره‌نشده را حذف کند) و بازنویسی اجباری پیکربندی کرنل.

.TP
\fB\-\-nvgpu\fR \fI\,[GPU PCI Address]\/\fR
افزودن یک پردازنده گرافیکی NVIDIA به‌صورت گذر مستقیم (passthrough).

.TP
\fB\-\-vfio\-pci\fR \fI\,PCI_ADDRESS\/\fR
گذر مستقیم یک دستگاه PCI با استفاده از vfio\-pci (می‌تواند چندین بار استفاده شود)، مانند \-\-vfio\-pci 0000:ce:00.0.

.TP
\fB\-\-systemd\fR
اجرای systemd به‌عنوان فرایند init (آزمایشی).

.SH "عملیات (ACTION)"
.TP
\fB\-\-run\fR \fI\,[RUN]\/\fR, \fB\-r\fR \fI\,[RUN]\/\fR
اجرای یک کرنل مشخص‌شده؛ \fB\-\-run\fR می‌تواند یکی از آرگومان‌های زیر را بپذیرد: ۱) هیچ‌چیز (در این حالت تلاش می‌کند همان کرنل در حال اجرا روی میزبان را بوت کند)، ۲) یک فایل باینری کرنل (مانند ./arch/x86/boot/bzImage)، ۳) یک دایرکتوری (جایی که در آن تلاش می‌کند فایل باینری معتبر کرنل را بیابد)، ۴) یک نسخه بالادستی (upstream)، برای مثال `vng \-\-run v6.6.17` (در این حالت vng یک کرنل بالادستی ازپیش‌کامپایل‌شده را از مخزن اصلی Ubuntu mainline بارگیری خواهد کرد).

.TP
\fB\-\-build\fR, \fB\-b\fR
ساخت کرنل در دایرکتوری جاری (یا به‌صورت راه دور در صورت استفاده همراه با \fB\-\-build\-host\fR).

.TP
\fB\-\-clean\fR, \fB\-x\fR
پاک‌سازی مخزن کرنل (محلی یا راه دور در صورت استفاده همراه با \fB\-\-build\-host\fR).

.TP
\fB\-\-dump\fR \fI\,DUMP\/\fR, \fB\-d\fR \fI\,DUMP\/\fR
ایجاد یک دامپ حافظه (memory dump) از کرنل در حال اجرا (نمونه باید با \fB\-\-debug\fR راه‌اندازی شده باشد).

.TP
\fB\-\-mcp\fR
راه‌اندازی سرور MCP (پروتکل زمینه مدل / Model Context Protocol) برای یکپارچه‌سازی با عامل‌های هوش مصنوعی.

.SH "کنسول راه دور (REMOTE CONSOLE)"
.TP
\fB\-\-console\fR \fI\,[PORT]\/\fR
فعال‌سازی یک سرور جهت ارتباط بعدی از سمت میزبان با استفاده از \fB\-\-console\-client\fR. به‌طور پیش‌فرض، یک کنسول ساده با استفاده از اتصال VSOCK و socat برای پروکسی ارائه خواهد شد.

.TP
\fB\-\-console\-client\fR \fI\,[PORT]\/\fR
اتصال به یک ماشین مجازی راه‌اندازی‌شده با گزینه \fB\-\-console\fR جهت کنترل راه دور.

.TP
\fB\-\-ssh\fR \fI\,[PORT]\/\fR
فعال‌سازی سرور SSH جهت ارتباط بعدی از سمت میزبان با استفاده از \fB\-\-ssh\-client\fR.

.TP
\fB\-\-ssh\-client\fR \fI\,[PORT]\/\fR
اتصال به یک ماشین مجازی راه‌اندازی‌شده با گزینه \fB\-\-ssh\fR جهت کنترل راه دور.

.TP
\fB\-\-ssh\-tcp\fR
استفاده از پروتکل TCP برای اتصال SSH به سیستم مهمان.

.TP
\fB\-\-remote\-cmd\fR \fI\,COMMAND\/\fR
اجرای دستوری متفاوت از مقدار پیش‌فرض در ماشین مجازی (\fB\-\-server\fR)، یا راه‌اندازی این دستور به‌جای محیط خط فرمان خطی (\fB\-\-client\fR)..SH "یادداشت‌ها (COMMENTS)"
ابزار virtme\-ng به شما امکان می‌دهد تا به‌سادگی و به‌سرعت یک هستهٔ لینوکس (Linux kernel) را بر اساس کد منبع، دوباره کامپایل و آزمایش کنید. این ابزار امکان بازکامپایل هسته را به‌جای چندین ساعت، در عرض چند دقیقه فراهم می‌کند؛ سپس هسته به‌طور خودکار در یک محیط مجازی‌سازی‌شده اجرا می‌شود که یک رونوشت دقیق copy\-on\-write از سیستم فعال شماست؛ بدین معنا که هرگونه تغییر ایجادشده در محیط مجازی، تأثیری بر سیستم میزبان نخواهد داشت.

برای انجام این کار، یک پیکربندی کمینه (با حداقل پشتیبانی لازم برای آزمایش هسته در qemu) ایجاد می‌شود، سپس هستهٔ انتخاب‌شده با استفاده از سیستم‌فایل میزبان به‌عنوان یک اسنپ‌شات (snapshot) به‌روش copy\-on\-write، به‌طور خودکار ساخته و در qemu اجرا می‌گردد.

این بدان معناست که می‌توانید بدون نگرانی و بدون تأثیر بر میزبان، کل سیستم‌فایل را نابود کنید، هسته را با کرش مواجه سازید و غیره.

نکته: هسته‌های تولیدشده با virtme\-ng فاقد بسیاری از ویژگی‌ها هستند تا زمان ساخت به کمترین حد ممکن برسد و هم‌زمان هسته‌ای کاربردی در اختیارتان بگذارد که قادر به اجرای آزمایش‌ها و بررسی‌های شما باشد.

ابزار virtme\-ng بر پایهٔ virtme توسعه یافته است که توسط Andy Lutomirski <luto@kernel.org> نوشته شده است.

.SH "نویسنده (AUTHOR)"
.nf
برنامهٔ virtme\-ng توسط Andrea Righi <arighi@nvidia.com> نوشته شده است
.fi
.nf
بر پایهٔ virtme اثر Andy Lutomirski <luto@kernel.org>
.fi

.SH "توزیع (DISTRIBUTION)"
جدیدترین نسخهٔ virtme\-ng را می‌توان از نشانی زیر دریافت کرد:
.UR https://github.com/arighi/virtme\-ng
.UE