.TH iverilog-vpi 1 "Jan 13th, 2026" "" "Version 13.0 (stable)"
.SH "نام (NAME)"
iverilog-vpi \- پیشانه‌ای برای کامپایل ماژول‌های VPI

.SH "خلاصه دستور (SYNOPSIS)"
.B iverilog-vpi
[options]
\fIsourcefile\fP...

.SH "توضیحات (DESCRIPTION)"
.PP
ابزار \fIiverilog\-vpi\fP برای ساده‌سازی فرایند کامپایل ماژول‌های VPI جهت استفاده در Icarus Verilog طراحی شده است. این ابزار فهرستی از فایل‌های منبع C یا C++ را از خط فرمان دریافت کرده و به عنوان خروجی یک ماژول پیوند‌خورده‌ی VPI تولید می‌کند. برای آگاهی از نحوه بارگذاری ماژول پیوندخورده توسط شبیه‌ساز، به صفحه راهنمای \fBvvp\fP(1) مراجعه کنید.

به‌طور پیش‌فرض، نام فایل خروجی بر اساس نخستین فایل منبع نام‌گذاری می‌شود. برای نمونه، اگر نام نخستین فایل منبع \fIfoo.c\fP باشد، خروجی \fIfoo.vpi\fP خواهد بود.

.SH "گزینه‌ها (OPTIONS)"
\fIiverilog\-vpi\fP گزینه‌های زیر را می‌پذیرد:
.TP 8
.B -l\fIlibrary\fP
کتابخانه مشخص‌شده را در فرایند پیوند ماژول VPI می‌گنجاند. این امر به ماژول‌های VPI اجازه می‌دهد به کتابخانه‌های خارجی بیشتری ارجاع دهند.

.TP 8
.B -L\fIdirectory\fP
دایرکتوری \fIdirectory\fP را به فهرست دایرکتوری‌هایی که برای فایل‌های کتابخانه جستجو می‌شوند، اضافه می‌کند.

.TP 8
.B -I\fIdirectory\fP
دایرکتوری \fIdirectory\fP را به فهرست دایرکتوری‌هایی که برای فایل‌های سرآیند جستجو می‌شوند، اضافه می‌کند.

.TP 8
.B -D\fIdefine\fP
ماکرویی با نام \fIdefine\fP تعریف می‌کند.

.TP 8
.B --name=\fIname\fP
به‌طور معمول، نام ماژول خروجی VPI بر اساس نخستین فایل منبع داده‌شده به دستور تعیین می‌شود. این پرچم نام ماژول خروجی vpi را (بدون پسوند .vpi) مشخص می‌کند.

.SH "گزینه‌های ویژه رایانه شخصی (PC-ONLY OPTIONS)"

هنگامی که این ابزار به عنوان یک برنامه بومی ویندوز (با استفاده از زنجیره ابزار MinGW) ساخته شده باشد، \fIiverilog\-vpi\fP به‌طور پیش‌فرض تلاش می‌کند ابزارهای MinGW مورد نیاز برای کامپایل ماژول VPI را در مسیر سیستم (که با متغیر محیطی PATH تعیین شده است) پیدا کند. به عنوان یک راهکار جایگزین، کاربر می‌تواند مکان ابزارهای MinGW را از طریق گزینه زیر تعیین کند.

.TP 8
.B -mingw=\fIpath\fP
مسیر ریشه مجموعه ابزارهای کامپایلر MinGW را به برنامه اعلام می‌کند. زمان اجرای \fBvvp\fP با این کامپایلر ساخته شده است، و این همان کامپایلری است که \fIiverilog\-vpi\fP انتظار دارد برای کامپایل کدهای منبع شما به کار گیرد. اگر این گزینه همراه با فهرستی از فایل‌ها مشخص شود، تنها برای ساخت فعلی اعمال خواهد شد. اگر این گزینه به تنهایی ارائه شود، \fIiverilog\-vpi\fP مسیر \fIpath\fP را در رجیستری ذخیره کرده و برای عملیات بعدی آن را نسبت به مسیر سیستم در اولویت قرار می‌دهد، تا نیازی به تعیین مجدد آن در هر بار اجرای خط فرمان نباشد.

.SH "گزینه‌های اطلاعاتی (INFORMATIONAL OPTIONS)"

ابزار \fIiverilog\-vpi\fP شامل پرچم‌های بیشتری است که به متخصصان Makefile امکان می‌دهد پیکربندی نصب \fIiverilog\fP را بررسی کنند. به این ترتیب، می‌توان Makefileهایی نوشت که فرایند ساخت‌های پیچیده VPI را به صورت بومی و بدون نیاز به درج مقادیر وابسته به سیستم و نصب (hard-coding) مدیریت کنند. در صورت استفاده، این گزینه‌ها باید حتماً یکی‌یکی و بدون همراهی هرگونه گزینه یا دستورالعمل دیگری به کار روند.

.TP 8
.B --install-dir
دایرکتوری نصب ماژول‌های VPI را چاپ می‌کند.

.TP 8
.B --cflags
پرچم‌های کامپایلر (CFLAGS یا CXXFLAGS) مورد نیاز برای کامپایل کد منبع در نظر گرفته شده برای ماژول VPI را چاپ می‌کند.

.TP 8
.B --ldflags
پرچم‌های پیونددهنده (LDFLAGS) مورد نیاز برای پیوند دادن ماژول VPI را چاپ می‌کند.

.TP 8
.B --ldlibs
کتابخانه‌های (LDLIBS) مورد نیاز برای پیوند دادن ماژول VPI را چاپ می‌کند.

.P
نمونه Makefile گنو که از این پرچم‌ها بهره می‌برد:
.IP "" 4
CFLAGS = \-Wall \-O $(CFLAGS_$@)
.br
VPI_CFLAGS := $(shell iverilog-vpi \-\-cflags)
.br
CFLAGS_messagev.o = $(VPI_CFLAGS)
.br
CFLAGS_fifo.o = $(VPI_CFLAGS)
.br
messagev.o fifo.o: transport.h
.br
messagev.vpi: messagev.o fifo.o
.br
	iverilog-vpi $^

.SH "نویسندگان (AUTHORS)"
.nf
Steve Williams (steve@icarus.com)

.SH "همچنین ببینید (SEE ALSO)"
iverilog(1), vvp(1),
.BR "<https://steveicarus.github.io/iverilog>",
.BR "<http://mingw-w64.yaxm.org>",

.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.nf
Copyright \(co  2002\-2026 Stephen Williams

این سند می‌تواند آزادانه بر اساس شرایط ویرایش 2.0 از مجوز عمومی همگانی گنو بازتوزیع شود.