.TH MESON "1" "August 2026" "meson 1.12.0" "User Commands"
.SH "نام (NAME)"
meson \- سیستم ساخت نرم‌افزار سریع و کاربرپسند بر پایه Ninja
.SH "توضیحات (DESCRIPTION)"

مِسون (Meson) یک سیستم ساخت است که برای بهینه‌سازی بهره‌وری برنامه‌نویس طراحی شده است. هدف آن دستیابی به این مهم از طریق ارائه پشتیبانی ساده و آماده‌به‌کار از ابزارها و شیوه‌های مدرن توسعه نرم‌افزار، مانند آزمون‌های واحد، گزارش‌های پوشش کد، Valgrind، Ccache و موارد مشابه است.

فایل اجرایی اصلی مِسون زیردستورهای متعددی را برای دسترسی به تمامی قابلیت‌ها فراهم می‌کند.

.SH "دستور setup"

استفاده از مِسون ساده است و از فرآیند دوفازی متداول در اکثر سیستم‌های ساخت پیروی می‌کند. ابتدا برای پیکربندی ساخت خود، مِسون را اجرا می‌کنید:

.B meson setup [
.I options
.B ] [
.I build directory
.B ] [
.I source directory
.B ]

توجه داشته باشید که دایرکتوری ساخت باید با دایرکتوری سورس کد متفاوت باشد. مِسون از ساخت درون دایرکتوری سورس پشتیبانی نمی‌کند و تلاش برای انجام این کار منجر به خطا خواهد شد.

پس از یک مرحله پیکربندی موفقیت‌آمیز، می‌توانید با اجرای دستور ساخت واقعی در دایرکتوری ساخت، سورس کد را کامپایل کنید. بک‌اند پیش‌فرض مِسون Ninja است که می‌توان آن را به این صورت فراخوانی کرد:

\fBninja [\fR \fItarget\fR \fB]\fR

شما فقط یک بار نیاز به اجرای دستور مِسون دارید: زمانی که برای اولین بار دایرکتوری ساخت خود را پیکربندی می‌کنید. پس از آن تنها کافی است دستور ساخت را اجرا کنید. مِسون به طور خودکار تغییرات ایجادشده در درخت سورس کد شما را تشخیص داده و تمامی فایل‌های مورد نیاز برای ساخت پروژه را بازتولید می‌کند.

مِسون شامل گزینه‌های داخلی متعددی است که می‌توان از آن‌ها برای تنظیم پیکربندی یک دایرکتوری ساخت استفاده کرد؛ پروژه‌ها نیز می‌توانند گزینه‌های سفارشی خود را اضافه کنند. برای مقداردهی به گزینه‌ها، از آرگومان خط فرمان \-D مانند زیر استفاده کنید:

.B meson setup \-Dopt1=value1 \-Dopt2=value2
.I rest of the command line...

.SS "گزینه‌ها (options):"
.TP
\fB\-\-version\fR
چاپ شماره نسخه
.TP
\fB\-\-help\fR
چاپ راهنمای خط فرمان

.SH "دستور configure"

.B meson configure
روشی را برای پیکربندی یک پروژه مِسون از طریق خط فرمان فراهم می‌کند. استفاده از آن ساده است:

.B meson configure [
.I build directory
.B ] [
.I options to set
.B ]

اگر دایرکتوری ساخت مشخص نشود، دایرکتوری جاری به جای آن استفاده می‌شود.

اگر هیچ پارامتری تنظیم نشود،
.B meson configure
مقدار تمامی گزینه‌های ساخت را در کنسول چاپ خواهد کرد.

برای مقداردهی، از آرگومان خط فرمان \-D مانند زیر استفاده کنید:

.B meson configure \-Dopt1=value1 \-Dopt2=value2

.SH "دستور dist"

.B meson dist
یک بایگانی انتشار (release archive) تولید می‌کند.

.B meson dist [
.I options
.B ]

.SS "گزینه‌ها (options):"
.TP
\fB\-h, \-\-help\fR
نمایش این پیام راهنما و خروج

.TP
\fB\-C WD\fR
دایرکتوری برای ورود (cd) به آن قبل از اجرا

.TP
\fB\-\-allow-dirty\fR
اجازه دادن به عملیات حتی اگر مخزن حاوی تغییرات ثبت‌نشده (uncommitted) باشد.

.TP
\fB\-\-formats FORMATS\fR
لیست جداشده با کاما از انواع بایگانی برای ایجاد. از xztar (پیش‌فرض)، gztar و zip پشتیبانی می‌کند.

.TP
\fB\-\-include\-subprojects\fR
گنجاندن سورس کد زیرپروژه‌هایی که برای ساخت استفاده شده‌اند.

.TP
\fB\-\-no\-tests\fR
بسته‌های تولیدشده ساخته و آزمایش نشوند.

.SH "دستور install"

.B meson install
پروژه را نصب می‌کند.

.B meson install [
.I options
.B ]

.SS "گزینه‌ها (options):"

.TP
\fB\-h, \-\-help\fR
نمایش این پیام راهنما و خروج

.TP
\fB\-C WD\fR
دایرکتوری برای ورود (cd) به آن قبل از اجرا

.TP
\fB\-\-no-rebuild\fR
عدم ساخت مجدد قبل از نصب.

.TP
\fB\-\-only\-changed\fR
فقط بازنویسی فایل‌هایی که قدیمی‌تر از فایل کپی‌شده هستند.

.TP
\fB\-\-quiet\fR
عدم چاپ تک‌تک فایل‌های نصب‌شده.

.TP
\fB\-\-destdir DESTDIR\fR
تنظیم یا لغو متغیر محیطی DESTDIR. (از نسخه 0.57.0)

.TP
\fB\-\-dry\-run, \-n\fR
عملیات نصب واقعی انجام نشود، فقط لاگ‌ها چاپ شوند. (از نسخه 0.57.0)

.TP
\fB\-\-skip\-subprojects [SKIP_SUBPROJECTS]\fR
عدم نصب فایل‌های مربوط به زیرپروژه‌های مشخص‌شده. (از نسخه 0.58.0)

.TP
\fB\-\-tags TAGS\fR
نصب فقط اهدافی که یکی از برچسب‌های داده‌شده را دارند. (از نسخه 0.60.0)

.TP
\fB\-\-strip\fR
حذف نمادهای خطایابی (strip) اهداف، حتی اگر گزینه strip در مرحله configure تنظیم نشده باشد. (از نسخه 0.62.0)

.SH "دستور introspect"

دستور Meson introspect ابزاری است که برای تسهیل ادغام با سایر ابزارها مانند محیط‌های توسعه یکپارچه (IDE) طراحی شده است. خروجی این دستور در قالب JSON است.

.B meson introspect [
.I build directory
.B ] [
.I option
.B ]

اگر دایرکتوری ساخت مشخص نشود، دایرکتوری جاری به جای آن استفاده می‌شود.

.SS "گزینه‌ها (options):"
.TP
\fB\-\-targets\fR
چاپ تمامی اهداف سطح بالا (فایل‌های اجرایی، کتابخانه‌ها و غیره)
.TP
\fB\-\-target\-files\fR
چاپ فایل‌های سورس مربوط به هدف داده‌شده
.TP
\fB\-\-buildsystem\-files\fR
چاپ تمامی فایل‌های تشکیل‌دهنده سیستم ساخت (meson.build، meson.options، meson_options.txt و غیره)
.TP
\fB\-\-tests\fR
چاپ تمامی آزمون‌های واحد
.TP
\fB\-\-help\fR
چاپ راهنمای خط فرمان

.SH "دستور init"

.B meson init
یک پروژه جدید ایجاد می‌کند.

.B meson init [
.I options
.B ] [
.I sourcefile...
.B ]

.SS "آرگومان‌های مکانی (positional arguments):"
.TP
sourcefile...
فایل‌های سورس. پیش‌فرض: تمامی فایل‌های شناسایی‌شده در دایرکتوری جاری

.SS "گزینه‌ها (options):"
.TP
\fB\-h, \-\-help\fR
نمایش این پیام راهنما و خروج

.TP
\fB\-C WD\fR
دایرکتوری برای ورود (cd) به آن قبل از اجرا

.TP
\fB\-n NAME, \-\-name NAME\fR
نام پروژه. پیش‌فرض: نام دایرکتوری جاری

.TP
\fB\-e EXECUTABLE, \-\-executable EXECUTABLE\fR
نام فایل اجرایی. پیش‌فرض: نام پروژه

.TP
\fB\-d DEPS, \-\-deps DEPS\fR
وابستگی‌ها، جداشده با کاما

.TP
\fB\-l {c,cpp,cs,cuda,d,fortran,java,objc,objcpp,rust,vala}, \
\-\-language {c,cpp,cs,cuda,d,fortran,java,objc,objcpp,rust,vala}\fR
زبان پروژه. پیش‌فرض: تشخیص خودکار بر اساس فایل‌های سورس

.TP
\fB\-b, \-\-build\fR
ساخت پروژه پس از ایجاد

.TP
\fB\-\-builddir BUILDDIR\fR
دایرکتوری برای ساخت

.TP
\fB\-f, \-\-force\fR
اجبار در بازنویسی فایل‌ها و دایرکتوری‌های موجود.

.TP
\fB\-\-type {executable,library}\fR
نوع پروژه. پیش‌فرض: پروژه از نوع اجرایی (executable)

.TP
\fB\-\-version VERSION\fR
نسخه پروژه. پیش‌فرض: 0.1

.SH "دستور test"

.B meson test
ابزاری کمکی برای اجرای مجموعه‌های آزمون در پروژه‌های مبتنی بر مِسون است. روش پیش‌فرض برای اجرای آزمون‌ها فراخوانی دستور ساخت پیش‌فرض است:

\fBninja [\fR \fItest\fR \fB]\fR

.B meson test
مجموعه ابزار غنی‌تری را برای اجرای آزمون‌ها فراهم می‌کند.

.B meson test
در صورت استفاده با بک‌اند Ninja، اهداف لازم برای اجرای آزمون‌ها را به صورت خودکار بازسازی می‌کند. در صورت شکست ساخت،
.B meson test
کد خروج 125 را برمی‌گرداند. این کد خروج به
.B git bisect run
می‌گوید که کامیت جاری را نادیده بگیرد. بنابراین ریشه‌یابی خطاها با git bisect می‌تواند به راحتی بدین شکل انجام شود:

.B git bisect run meson test -C build_dir

.SS "گزینه‌ها (options):"
.TP
\fB\-\-repeat\fR
اجرای آزمون‌ها به تعداد دفعات مشخص‌شده
.TP
\fB\-\-gdb\fR
اجرای آزمون‌ها تحت gdb
.TP
\fB\-\-list\fR
فهرست کردن تمامی آزمون‌های موجود
.TP
\fB\-\-wrapper\fR
فراخوانی تمامی آزمون‌ها از طریق پوشش‌دهنده مشخص‌شده (مانند valgrind)
.TP
\fB\-C\fR
ورود به دایرکتوری داده‌شده قبل از اجرای آزمون‌ها (باید ریشه دایرکتوری ساخت باشد).
.TP
\fB\-\-suite\fR
اجرای آزمون‌ها در این مجموعه (suite)
.TP
\fB\-\-no\-suite\fR
عدم اجرای آزمون‌ها در این مجموعه
.TP
\fB\-\-exclude\fR
عدم اجرای آزمون‌های نام‌برده‌شده
.TP
\fB\-\-no\-stdsplit\fR
عدم تفکیک stderr و stdout در لاگ‌های آزمون
.TP
\fB\-\-benchmark\fR
اجرای بنچمارک‌ها به جای آزمون‌ها
.TP
\fB\-\-logbase\fR
پایه نام فایل برای نوشتن لاگ‌های آزمون
.TP
\fB\-\-num-processes\fR
تعداد پردازش‌های موازی برای اجرای آزمون‌ها
.TP
\fB\-\-verbose\fR
عدم تغییر مسیر stdout و stderr (نمایش کامل خروجی)
.TP
\fB\-t\fR
ضریب مورد استفاده برای مقادیر مهلت زمانی (timeout) آزمون (معمولاً مقداری مانند 100 برای Valgrind)
.TP
\fB\-\-setup\fR
استفاده از راه‌اندازی آزمون مشخص‌شده
.TP
\fB\-\-slice SLICE/NUM_SLICES\fR
تقسیم آزمون‌ها به NUM_SLICES برش و اجرای برش شماره SLICE. (از نسخه 1.8.0)

.SH "دستور wrap"

ابزار Wraptool یک ابزار کمکی برای مدیریت وابستگی‌های سورس کد با استفاده از سرویس آنلاین wrapdb است.

.B meson wrap <
.I command
.B > [
.I options
.B ]

شما باید این دستور را در دایرکتوری ریشه سورس کد پروژه خود اجرا کنید.

.SS "دستورات (commands):"
.TP
\fBlist\fR
فهرست کردن تمامی پروژه‌های موجود
.TP
\fBsearch\fR
جستجوی پروژه‌ها بر اساس نام
.TP
\fBinstall\fR
نصب پروژه‌ای با نام داده‌شده
.TP
\fBupdate\fR
به‌روزرسانی پروژه مشخص‌شده به آخرین نسخه موجود
.TP
\fBinfo\fR
نمایش نسخه‌های موجود از پروژه مشخص‌شده
.TP
\fBstatus\fR
نمایش نسخه‌های نصب‌شده و در دسترس زیرپروژه‌های در حال استفاده

.SH "دستور subprojects"

.B meson subprojects
برای مدیریت زیرپروژه‌ها استفاده می‌شود.

.B meson subprojects [
.I options
.B ] [
.I command
.B ]

.SS "گزینه‌ها (options):"
.TP
\fB\-h, \-\-help\fR
نمایش این پیام راهنما و خروج

.SS "دستورات (commands):"
.TP
\fBupdate\fR
به‌روزرسانی تمامی زیرپروژه‌ها از روی فایل‌های wrap

.TP
\fBcheckout\fR
واکشی و سوئیچ به یک شاخه (فقط git)

.TP
\fBdownload\fR
اطمینان از دریافت زیرپروژه‌ها، حتی اگر در حال استفاده نباشند. زیرپروژه‌هایی که قبلاً دانلود شده‌اند تغییر داده نمی‌شوند. این دستور می‌تواند برای پیش‌دریافت تمام زیرپروژه‌ها و جلوگیری از دانلود حین پیکربندی (configure) استفاده شود.

.TP
\fBforeach\fR
اجرای یک دستور در دایرکتوری هر زیرپروژه.

.TP
\fBpurge\fR
حذف تمامی آثار و خروجی‌های زیرپروژه‌های مبتنی بر wrap

.TP
\fBpackagefiles\fR
مدیریت لایه packagefiles

.SH "دستور rewrite"

.B meson rewrite
تعریف پروژه را تغییر می‌دهد.

.B meson rewrite [
.I options
.B ] [
.I command
.B ]

.SS "گزینه‌ها (options):"

.TP
\fB\-h, \-\-help\fR
نمایش این پیام راهنما و خروج

.TP
\fB\-s SRCDIR, \-\-sourcedir SRCDIR\fR
مسیر به دایرکتوری سورس کد.

.TP
\fB\-V, \-\-verbose\fR
فعال‌سازی خروجی با جزئیات کامل

.TP
\fB\-S, \-\-skip\-errors\fR
صرف‌نظر کردن از خطاها به جای متوقف ساختن فرآیند

.SS "دستورات (commands):"

.TP
\fBtarget (tgt)\fR
تغییر دادن یک هدف (target)

.TP
\fBkwargs\fR
تغییر دادن آرگومان‌های کلیدواژه‌ای (keyword arguments)

.TP
\fBdefault-options (def)\fR
تغییر دادن گزینه‌های پیش‌فرض پروژه

.TP
\fBcommand (cmd)\fR
اجرای یک آرایه JSON از دستورات

.SH "دستور compile"

.B meson compile
پروژه را می‌سازد.

.B meson compile [
.I options
.B ] [
.I TARGET...
.B ]

.SS "آرگومان‌های مکانی (positional arguments):"
.TP
\fBTARGET\fR
اهداف برای ساخت. هدف ساختار زیر را دارد:
[PATH_TO_TARGET/]TARGET_NAME.TARGET_SUFFIX[:TARGET_TYPE].

.SS "گزینه‌ها (options):"

.TP
\fB\-h, \-\-help\fR
نمایش این پیام راهنما و خروج

.TP
\fB\-\-clean\fR
پاک‌سازی دایرکتوری ساخت.

.TP
\fB\-C WD\fR
دایرکتوری برای ورود (cd) به آن قبل از اجرا

.TP
\fB\-j JOBS, \-\-jobs JOBS\fR
تعداد پردازش‌های کاری (worker jobs) برای اجرا (در صورت پشتیبانی). اگر مقدار کمتر از ۱ باشد، برنامه ساخت به صورت حدسی تعیین خواهد کرد.

.TP
\fB\-l LOAD_AVERAGE, \-\-load-average LOAD_AVERAGE\fR
میانگین بار سیستم (load average) برای حفظ و تلاش جهت عدم فراتر رفتن از آن (در صورت پشتیبانی).

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

.TP
\fB\-\-ninja\-args NINJA_ARGS\fR
آرگومان‌هایی برای انتقال به `ninja` (فقط روی بک‌اند `ninja` اعمال می‌شود).

.TP
\fB\-\-vs\-args VS_ARGS\fR
آرگومان‌هایی برای انتقال به `msbuild` (فقط روی بک‌اند `vs` اعمال می‌شود).

.TP
\fB\-\-xcode\-args XCODE_ARGS\fR
آرگومان‌هایی برای انتقال به `xcodebuild` (فقط روی بک‌اند `xcode` اعمال می‌شود).

.SH "دستور devenv"

.B meson devenv
دستورات را در محیط توسعه‌دهنده اجرا می‌کند.

.B meson devenv [
.I options
.B ] [
.I command
.B ]

.SS "آرگومان‌های مکانی (positional arguments):"

.TP
\fBcommand\fR
دستور برای اجرا در محیط توسعه‌دهنده (پیش‌فرض: پوسته تعاملی)

.SS "گزینه‌ها (options):"

.TP
\fB\-h, \-\-help\fR
نمایش این پیام راهنما و خروج

.TP
\fB\-C BUILDDIR\fR
مسیر به دایرکتوری ساخت

.TP
\fB\-\-workdir WORKDIR, \-w WORKDIR\fR
دایرکتوری برای ورود (cd) به آن قبل از اجرا (پیش‌فرض: builddir، از نسخه 1.0.0)

.TP
\fB\-\-dump [DUMP]\fR
فقط چاپ متغیرهای محیطی مورد نیاز (از نسخه 0.62.0) یک مسیر فایل اختیاری را می‌پذیرد (از نسخه 1.1.0)

.TP
\fB\-\-dump-format {sh,export,vscode}\fR
فرمت استفاده‌شده با --dump (از نسخه 1.1.0)

.SH "دستور env2mfile"

.B meson env2mfile
محیط جاری را به یک فایل cross یا native تبدیل می‌کند.

.B meson env2mfile [
.I options
.B ]

.SS "گزینه‌ها (options):"

.TP
\fB\-h, \-\-help\fR
نمایش این پیام راهنما و خروج

.TP
\fB\-\-debarch DEBARCH\fR
معماری dpkg برای تولید.

.TP
\fB\-\-gccsuffix GCCSUFFIX\fR
یک پسوند نسخه خاص برای gcc در صورت لزوم.

.TP
\fB\-o OUTFILE\fR
فایل خروجی.

.TP
\fB\-\-cross\fR
تولید یک فایل کامپایل چندسکویی (cross compilation).

.TP
\fB\-\-native\fR
تولید یک فایل کامپایل بومی (native compilation).

.TP
\fB\-\-system SYSTEM\fR
تعریف سیستم برای کامپایل چندسکویی.

.TP
\fB\-\-subsystem SUBSYSTEM\fR
تعریف زیرسیستم برای کامپایل چندسکویی.

.TP
\fB\-\-kernel KERNEL\fR
تعریف کرنل برای کامپایل چندسکویی.

.TP
\fB\-\-cpu CPU\fR
تعریف پردازنده (cpu) برای کامپایل چندسکویی.

.TP
\fB\-\-cpu-family CPU_FAMILY\fR
تعریف خانواده پردازنده (cpu family) برای کامپایل چندسکویی.

.TP
\fB\-\-endian {big,little}\fR
تعریف ترتیب بایت‌ها (endianness) برای کامپایل چندسکویی.

.SH "دستور format"

.B meson format
یک فایل سورس مِسون را قالب‌بندی (فرمت) می‌کند.

.B meson format [
.I options
.B ] [
.I sources...
.B ]

.SS "آرگومان‌های مکانی (positional arguments):"

.TP
\fBsources...\fR
فایل‌های سورس مِسون

.SS "گزینه‌ها (options):"

.TP
\fB-h, --help\fR
نمایش این پیام راهنما و خروج

.TP
\fB-q, --check-only\fR
خروج با کد 1 در صورتی که فایل‌ها توسط meson format تغییر داده شوند

.TP
\fB-i, --inplace\fR
قالب‌بندی فایل‌ها درجا (در خود فایل‌ها)

.TP
\fB-r, --recursive\fR
پیمایش بازگشتی زیرپوشه‌ها (نیازمند گزینه --check-only یا --inplace)

.TP
\fB-c meson.format, --configuration meson.format\fR
خواندن پیکربندی از meson.format

.TP
\fB-e, --editor-config\fR
تلاش برای خواندن پیکربندی از .editorconfig

.TP
\fB-o OUTPUT, --output OUTPUT\fR
فایل خروجی (مستلزم داشتن دقیقاً یک ورودی)

.SH "هنگامی که هیچ دستوری مشخص نشده است"

اگر مِسون را بدون زیردستور اجرا کنید، فرض می‌کند که منظور شما
\fBmeson setup\fR
بوده است. با این حال، این نحوه نگارش منسوخ شده است و مِسون در صورت استفاده از آن یک پیام هشدار چاپ می‌کند. شما همیشه باید به صراحت از
\fBmeson setup\fR
استفاده کنید، نه اینکه به رفتار پیش‌فرض اتکا نمایید.

.SH "وضعیت خروج (EXIT STATUS)"

.TP
.B 0
موفقیت‌آمیز.
.TP
.B 1
خطای استفاده، یا خطای پارس یا اجرای meson.build.
.TP
.B 2
خطای داخلی.
.TP
.B 125
دستور
.B meson test
نتوانست اهداف مورد نیاز را بازسازی کند.
.TP

.SH "همچنین ببینید (SEE ALSO)"

https://mesonbuild.com

https://wrapdb.mesonbuild.com

.MR meson-reference 3