.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "DUNE-PRINTENV" 1 "" "Dune 3.24.2" "Dune Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
dune-printenv \- نام مستعاری برای دستور \fBenv\fR (چاپ متغیرهای محیطی)
.SH "خلاصه دستور (SYNOPSIS)"
\fBdune printenv\fR [\fIOPTION\fR]… [\fIPATH\fR]
.SH "توضیحات (DESCRIPTION)"
دستور
\fBdune printenv\fR
یک نام مستعار برای
\fBdune env\fR
است.
.PP
برای جزئیات بیشتر به
\fBdune env \-\-help\fR
مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP 4
\fB\-\-action\-stderr\-on\-success\fR=\fIVAL\fR
مشابه \fB\-\-action\-stdout\-on\-success\fR اما برای خروجی استاندارد خطا به جای خروجی استاندارد. یک مقدار پیش‌فرض مناسب برای مخازن بزرگ تک‌ریپو (monorepo) گزینهٔ \fB\-\-action\-stdout\-on\-success=swallow \-\-action\-stderr\-on\-success=must\-be\-empty\fR است. این کار تضمین می‌کند که یک ساخت موفق، خروجی خالی و «تمیز» داشته باشد.
.TP 4
\fB\-\-action\-stdout\-on\-success\fR=\fIVAL\fR
نحوه مدیریت خروجی استاندارد عملیات‌ها را در صورت موفقیت مشخص می‌کند. مقادیر ممکن عبارتند از: \fBprint\fR برای چاپ مستقیم آن در خروجی Dune، \fBswallow\fR برای نادیده گرفتن کامل آن، و \fBmust\-be\-empty\fR برای الزام به اینکه عملیات هیچ خروجی چاپ نکرده باشد. با مقدار \fBmust\-be\-empty\fR، اگر عملیاتی چیزی در خروجی استاندارد خود چاپ کند، Dune آن را ناموفق تلقی خواهد کرد. مقدار پیش‌فرض \fBprint\fR است.
.TP 4
\fB\-\-build\-info\fR
نمایش اطلاعات ساخت.
.TP 4
\fB\-\-display\-separate\-messages\fR
جداسازی پیام‌های خطا با یک خط خالی.
.TP 4
\fB\-\-error\-reporting\fR=\fIVAL\fR (پیش‌فرض=\fBdeterministic\fR)
زمان گزارش خطاهای ساخت را کنترل می‌کند. مقدار \fBearly\fR خطاها را به محض شناسایی گزارش می‌دهد. مقدار \fBdeterministic\fR خطاها را در پایان ساخت با ترتیبی معین و قطعی گزارش می‌کند. مقدار \fBtwice\fR هر خطا را دو بار گزارش می‌دهد: یک بار به محض شناسایی و بار دیگر در پایان ساخت با ترتیبی قطعی.
.TP 4
\fB\-f\fR, \fB\-\-force\fR
اجبار به اجرای مجدد عملیات‌های مرتبط با نام‌های مستعار (alias)، حتی اگر وابستگی‌های آن‌ها تغییر نکرده باشد.
.TP 4
\fB\-\-field\fR=\fIFIELD\fR
فقط چاپ این فیلد. این گزینه را می‌توان چندین بار برای چاپ چندین فیلد تکرار کرد.
.TP 4
\fB\-\-file\-watcher\fR=\fIVAL\fR (پیش‌فرض=\fBautomatic\fR)
سازوکار تشخیص تغییرات در کد منبع. مقدار \fBautomatic\fR باعث می‌شود dune یک برنامه خارجی را برای تشخیص تغییرات اجرا کند. مقدار \fBmanual\fR برای اطلاع‌رسانی دستی تغییر فایل‌ها به dune استفاده می‌شود.
.TP 4
\fB\-\-passive\-watch\-mode\fR
مشابه [\fB\-\-watch\fR]، اما تنها زمانی فرایند ساخت را آغاز می‌کند که از طریق یک فراخوانی RPC خارجی دستور داده شود.
.TP 4
\fB\-\-sandbox\fR=\fIVAL\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_SANDBOX\fR)
تنظیم حالت محیط ایزوله (sandboxing). برخی عملیات‌ها به حالت ایزولاسیون خاصی نیاز دارند و این تنظیم را نادیده می‌گیرند. مقادیر مجاز عبارتند از: none، symlink، copy، hardlink.
.TP 4
\fB\-\-stop\-on\-first\-error\fR
توقف فرایند ساخت به محض برخورد با اولین خطا.
.TP 4
\fB\-w\fR, \fB\-\-watch\fR
به جای پایان دادن به فرایند ساخت پس از تکمیل، به طور مداوم منتظر تغییرات فایل‌ها می‌ماند.
.TP 4
\fB\-\-wait\-for\-filesystem\-clock\fR
ابزار Dune محتوای فایل‌ها را برای بهبود عملکرد افزایشی خلاصه (digest) می‌کند. این دایجست‌ها خود حافظه پنهان دارند. در برخی موارد، Dune برای تضمین قابلیت اطمینان، باید برخی از مدخل‌های کش دایجست را دور بیندازد. این گزینه باعث می‌شود Dune منتظر جلو رفتن ساعت فایل‌سیستم بماند تا نیازی به دور انداختن هیچ مدخلی نباشد. احتمالاً نیازی به این گزینه نخواهید داشت؛ این گزینه بیشتر برای توسعه‌دهندگان Dune مفید است تا تست‌های Dune روی حافظه پنهان دایجست تکرارپذیرتر شوند.
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
این گزینه‌ها میان تمامی دستورها مشترک هستند.
.TP 4
\fB\-\-always\-show\-command\-line\fR
همیشه خط فرمان کامل برنامه‌های اجرا شده توسط dune را نمایش می‌دهد.
.TP 4
\fB\-\-auto\-promote\fR
ترفیع خودکار فایل‌ها. این عمل مشابه اجرای دستور \fBdune promote\fR پس از ساخت است.
.TP 4
\fB\-\-build\-dir\fR=\fIFILE\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_BUILD_DIR\fR)
دایرکتوری ساخت مشخص‌شده. در صورت عدم تعیین، مقدار پیش‌فرض _build است.
.TP 4
\fB\-\-cache\fR=\fIVAL\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_CACHE\fR)
فعال یا غیرفعال کردن حافظه پنهان Dune (یکی از مقادیر \fBdisabled\fR، \fBenabled\-except\-user\-rules\fR یا \fBenabled\fR). پیش‌فرض `enabled\-except\-user\-rules` است.
.TP 4
\fB\-\-cache\-check\-probability\fR=\fIVAL\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_CACHE_CHECK_PROBABILITY\fR)
بررسی تکرارپذیری ساخت با اجرای مجدد قواعد به‌صورت تصادفی و مقایسه نتایج آن‌ها با موارد ذخیره‌شده در حافظه پنهان Dune. توجه: با افزایش احتمال این بررسی‌ها، سرعت ساخت کاهش می‌یابد. احتمال پیش‌فرض صفر است، یعنی هیچ قاعده‌ای بررسی نمی‌شود.
.TP 4
\fB\-\-cache\-storage\-mode\fR=\fIVAL\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_CACHE_STORAGE_MODE\fR)
حالت ذخیره‌سازی حافظه پنهان Dune (یکی از مقادیر \fBauto\fR، \fBhardlink\fR یا \fBcopy\fR). پیش‌فرض `hardlink` است.
.TP 4
\fB\-\-config\-file\fR=\fIFILE\fR
بارگذاری این فایل پیکربندی به جای فایل پیش‌فرض.
.TP 4
\fB\-\-debug\-backtraces\fR
همیشه ردیابی پشته استثناها (backtraces) را چاپ می‌کند.
.TP 4
\fB\-\-debug\-dependency\-path\fR
در صورت بروز خطا، مسیر وابستگی از هدف‌های مشخص‌شده در خط فرمان تا قاعده‌ای که با شکست مواجه شده را چاپ می‌کند.
.TP 4
\fB\-\-debug\-package\-logs\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_DEBUG_PACKAGE_LOGS\fR)
هنگام ساخت بسته‌ها، همیشه گزارش‌های استاندارد را چاپ می‌کند.
.TP 4
\fB\-\-default\-target\fR=\fITARGET\fR (پیش‌فرض=\fB@@default\fR)
تنظیم هدف پیش‌فرضی که در صورت عدم تعیین هدف برای دستور \fBdune build\fR استفاده می‌شود.
.TP 4
\fB\-\-diff\-command\fR=\fIVAL\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_DIFF_COMMAND\fR)
دستور شل مورد استفاده برای مقایسه (diff) فایل‌ها. از \- برای غیرفعال کردن چاپ تفاوت‌ها استفاده کنید.
.TP 4
\fB\-\-disable\-promotion\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_DISABLE_PROMOTION\fR)
غیرفعال کردن تمام قواعد ترفیع (promotion).
.TP 4
\fB\-\-display\fR=\fIMODE\fR
کنترل حالت نمایش Dune. برای جزئیات بیشتر به \fBdune\-config(5)\fR مراجعه کنید. مقادیر معتبر برای این گزینه عبارتند از: progress، verbose، short، quiet یا tui.
.TP 4
\fB\-\-dump\-gc\-stats\fR=\fIFILE\fR
تخلیه آمار جمع‌آوری زباله (GC) در یک فایل پس از تکمیل ساخت.
.TP 4
\fB\-\-help\fR[=\fIFMT\fR] (پیش‌فرض=\fBauto\fR)
نمایش این راهنما در قالب \fIFMT\fR. مقدار \fIFMT\fR باید یکی از موارد \fBauto\fR، \fBpager\fR، \fBgroff\fR یا \fBplain\fR باشد. با مقدار \fBauto\fR، هر زمان که متغیر محیطی \fBTERM\fR برابر با \fBdumb\fR یا تعریف‌نشده باشد، قالب به‌صورت \fBpager\fR یا \fBplain\fR خواهد بود.
.TP 4
\fB\-\-ignore\-promoted\-rules\fR
نادیده گرفتن قواعد دارای (mode promote)، به جز مواردی با (only ...). متغیر %{ignoring_promoted_rules} در فایل‌های dune مشخص می‌کند که این گزینه داده شده است یا خیر.
.TP 4
\fB\-\-instrument\-with\fR=\fIBACKENDS\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_INSTRUMENT_WITH\fR)
فعال‌سازی ابزاردقیق‌سازی (instrumentation) توسط \fBBACKENDS\fR. مقدار \fBBACKENDS\fR فهرستی از نام‌های کتابخانه جداشده با کاما است که هر یک از آن‌ها باید یک بک‌اند ابزاردقیق را اعلان کرده باشد.
.TP 4
\fB\-j\fR \fIJOBS\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_JOBS\fR)
اجرای حداکثر \fIJOBS\fR دستور به‌طور همزمان. مقدار \fIJOBS\fR باید یک عدد صحیح مثبت یا \fBauto\fR برای تشخیص خودکار تعداد هسته‌ها (پیش‌فرض) باشد.
.TP 4
\fB\-\-no\-buffer\fR
خروجی دستورات اجرا شده توسط dune را بافر نمی‌کند. به‌طور پیش‌فرض، dune خروجی زیردستورها را بافر می‌کند تا از تداخل خروجی هنگام اجرای موازی چندین دستور جلوگیری شود. با این حال، این موضوع هنگام اشکال‌زدایی تست‌های طولانی‌مدت می‌تواند مشکل‌ساز باشد. با گزینهٔ \fB\-\-no\-buffer\fR، دستورات دسترسی مستقیم به ترمینال دارند. توجه داشته باشید که در نتیجه این کار، خروجی آن‌ها در فایل گزارش (log) ثبت نخواهد شد. برای جلوگیری از تداخل، باید از این گزینه همراه با \fB\-j 1\fR استفاده کنید. علاوه بر این، باید از \fB\-\-verbose\fR نیز استفاده کنید تا مطمئن شوید دستورات قبل از اجرا چاپ می‌شوند.
.TP 4
\fB\-\-no\-config\fR
عدم بارگذاری فایل پیکربندی.
.TP 4
\fB\-\-no\-print\-directory\fR
پنهان کردن پیام‌های ورود به دایرکتوری ("Entering directory").
.TP 4
\fB\-\-only\-packages\fR=\fIPACKAGES\fR
نادیده گرفتن بخش‌های (stanzas) مربوط به بسته‌ای که در \fBPACKAGES\fR نیست. مقدار \fBPACKAGES\fR فهرستی از نام‌های بسته جداشده با کاما است. توجه داشته باشید که این کار تأثیری مشابه حذف بخش‌های مربوطه از فایل‌های dune دارد. این گزینه عمدتاً برای انتشار (release) در نظر گرفته شده است. در طول فرایند توسعه، احتمالاً چیزی که می‌خواهید ساخت یک هدف خاص \fB<package>.install\fR است.
.TP 4
\fB\-p\fR \fIPACKAGES\fR, \fB\-\-for\-release\-of\-packages\fR=\fIPACKAGES\fR (الزامی)
کوتاه‌نوشتی برای \fB\-\-release \-\-pkg=disabled \-\-only\-packages PACKAGE\fR. شما باید از این گزینه در فایل‌های \fI<package>.opam\fR خود استفاده کنید تا در صورت وجود چندین بسته در پروژه، فقط موارد ضروری ساخته شوند و ساخت‌های تکرارپذیر حاصل شود.
.TP 4
\fB\-\-pkg\fR=\fIVAL\fR
فعال یا غیرفعال کردن مدیریت بسته. رفتار پیش‌فرض بستگی به این دارد که دایرکتوری قفل (lock directory) وجود داشته باشد یا خیر.
.TP 4
\fB\-\-profile\fR=\fIVAL\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_PROFILE\fR)
انتخاب پروفایل ساخت، برای مثال \fBdev\fR یا \fBrelease\fR. مقدار پیش‌فرض \fBdev\fR است.
.TP 4
\fB\-\-promote\-install\-files\fR[=\fIVAL\fR] (پیش‌فرض=\fBtrue\fR)
ترفیع فایل‌های <package>.install تولیدشده به درخت منبع پروژه.
.TP 4
\fB\-\-release\fR
قرار دادن \fBdune\fR در حالت تکرارپذیر \fIانتشار (release)\fR. کوتاه‌نوشتی برای \fB\-\-root . \-\-ignore\-promoted\-rules \-\-no\-config \-\-profile release \-\-always\-show\-command\-line \-\-promote\-install\-files \-\-require\-dune\-project\-file \-\-default\-target @install\fR. شما باید از این گزینه برای ساخت‌های انتشار استفاده کنید. برای مثال، باید از این گزینه در فایل‌های \fI<package>.opam\fR خود استفاده کنید؛ مگر اینکه از قبل از \fB\-p\fR استفاده کرده باشید، چرا که \fB\-p\fR این گزینه را در بر دارد.
.TP 4
\fB\-\-require\-dune\-project\-file\fR[=\fIVAL\fR] (پیش‌فرض=\fBtrue\fR)
در صورت عدم وجود فایل dune-project، با خطا مواجه می‌شود.
.TP 4
\fB\-\-root\fR=\fIDIR\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_ROOT\fR)
استفاده از این دایرکتوری به عنوان ریشه فضای کاری به جای حدس زدن آن. توجه داشته باشید که این گزینه تفسیر هدف‌های داده‌شده در خط فرمان را تغییر نمی‌دهد و تنها برای اسکریپت‌ها در نظر گرفته شده است.
.TP 4
\fB\-\-store\-orig\-source\-dir\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_STORE_ORIG_SOURCE_DIR\fR)
ذخیره مکان اصلی منبع در فراداده‌های dune-package.
.TP 4
\fB\-\-target\-exec\fR=\fITOOLCHAIN=CMD\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_TARGET_EXEC\fR)
دستور پوششی برای اجرای باینری‌های مقصد هنگام کامپایل متقاطع (cross-compiling). قالب: TOOLCHAIN=CMD (به عنوان مثال، 'windows=wine').
.TP 4
\fB\-\-terminal\-persistence\fR=\fIMODE\fR
تغییر نحوه نمایش گزارش نتایج ساخت در کنسول بین بازساخت‌ها در حالت \fB\-\-watch\fR. حالت‌های پشتیبانی‌شده عبارتند از: \fBpreserve\fR، \fBclear\-on\-rebuild\fR، \fBclear\-on\-rebuild\-and\-flush\-history\fR.
.TP 4
\fB\-\-trace\-file\fR=\fIFILE\fR
خروجی داده‌های ردگیری در قالب catapult (سازگار با chrome://tracing).
.TP 4
\fB\-\-verbose\fR
مشابه \fB\-\-display verbose\fR.
.TP 4
\fB\-\-version\fR
نمایش اطلاعات نسخه.
.TP 4
\fB\-\-watch\-exclusions\fR=\fIREGEX\fR
افزودن یک عبارت باقاعده POSIX که دایرکتوری‌های منطبق را از \fB`dune build \-\-watch`\fR مستثنی می‌کند. گزینهٔ \fB\-\-watch\-exclusions\fR را می‌توان برای افزودن چندین استثنا تکرار کرد. همچنین می‌توان از نقطه‌ویرگول (;) به عنوان جداکننده استفاده کرد. اگر هیچ استثنایی مشخص نشود، یک مجموعه پیش‌فرض از استثناها استفاده می‌شود؛ با این حال، اگر \fIیک یا چند\fR گزینهٔ \fB\-\-watch\-exclusions\fR استفاده شود، \fBهیچ‌یک\fR از استثناهای پیش‌فرض اعمال نخواهند شد. استثناهای پیش‌فرض عبارتند از: ^_opam /_opam ^_esy /_esy ^\.#.* /\.#.* ~$ ^#[^#]*#$ /#[^#]*#$ ^4913$ /4913$ /\.git /\.hg :/windows
.TP 4
\fB\-\-workspace\fR=\fIFILE\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_WORKSPACE\fR)
استفاده از این فایل فضای کاری مشخص به جای جستجوی آن.
.TP 4
\fB\-x\fR \fIVAL\fR (در صورت عدم وجود متغیر محیطی \fBDUNE_CROSS_TARGET\fR)
کامپایل متقاطع با استفاده از این زنجیره ابزار.
.SH "راهنمای بیشتر (MORE HELP)"
برای دریافت راهنما دربارهٔ یک دستور خاص، از
\fBdune\fR \fICOMMAND\fR \fB\-\-help\fR
استفاده کنید.
.SH "وضعیت خروج (EXIT STATUS)"
دستور \fBdune printenv\fR با مقادیر زیر خارج می‌شود:
.TP 4
0
در صورت موفقیت.
.TP 4
1
در صورت بروز خطا.
.TP 4
130
اگر با یک سیگنال متوقف شود.
.SH "محیط (ENVIRONMENT)"
این متغیرهای محیطی بر اجرای \fBprintenv\fR تأثیر می‌گذارند:
.TP 4
\fBDUNE_BUILD_DIR\fR
دایرکتوری ساخت مشخص‌شده. در صورت عدم تعیین، _build است.
.TP 4
\fBDUNE_CACHE\fR
فعال یا غیرفعال کردن حافظه پنهان Dune (یکی از مقادیر \fBdisabled\fR، \fBenabled\-except\-user\-rules\fR یا \fBenabled\fR). پیش‌فرض `enabled\-except\-user\-rules` است.
.TP 4
\fBDUNE_CACHE_CHECK_PROBABILITY\fR
بررسی تکرارپذیری ساخت با اجرای مجدد قواعد به‌صورت تصادفی و مقایسه نتایج آن‌ها با موارد ذخیره‌شده در حافظه پنهان Dune. توجه: با افزایش احتمال این بررسی‌ها، سرعت ساخت کاهش می‌یابد. احتمال پیش‌فرض صفر است، یعنی هیچ قاعده‌ای بررسی نمی‌شود.
.TP 4
\fBDUNE_CACHE_STORAGE_MODE\fR
حالت ذخیره‌سازی حافظه پنهان Dune (یکی از مقادیر \fBauto\fR، \fBhardlink\fR یا \fBcopy\fR). پیش‌فرض `hardlink` است.
.TP 4
\fBDUNE_CROSS_TARGET\fR
کامپایل متقاطع با استفاده از این زنجیره ابزار.
.TP 4
\fBDUNE_DEBUG_PACKAGE_LOGS\fR
هنگام ساخت بسته‌ها، همیشه گزارش‌های استاندارد را چاپ می‌کند.
.TP 4
\fBDUNE_DIFF_COMMAND\fR
دستور شل برای مقایسه (diff) فایل‌ها. از \- برای غیرفعال کردن چاپ تفاوت‌ها استفاده کنید.
.TP 4
\fBDUNE_DISABLE_PROMOTION\fR
غیرفعال کردن تمام قواعد ترفیع (promotion).
.TP 4
\fBDUNE_INSTRUMENT_WITH\fR
فعال‌سازی ابزاردقیق‌سازی توسط \fBBACKENDS\fR. مقدار \fBBACKENDS\fR فهرستی از نام‌های کتابخانه جداشده با کاما است که هر یک از آن‌ها باید یک بک‌اند ابزاردقیق را اعلان کرده باشد.
.TP 4
\fBDUNE_JOBS\fR
اجرای حداکثر \fIJOBS\fR دستور به‌طور همزمان. مقدار \fIJOBS\fR باید یک عدد صحیح مثبت یا \fBauto\fR برای تشخیص خودکار تعداد هسته‌ها (پیش‌فرض) باشد.
.TP 4
\fBDUNE_PROFILE\fR
پروفایل ساخت. \fBdev\fR در صورت عدم تعیین، یا \fBrelease\fR در صورتی که \-p تنظیم شده باشد.
.TP 4
\fBDUNE_ROOT\fR
استفاده از این دایرکتوری به عنوان ریشه فضای کاری به جای حدس زدن آن. توجه داشته باشید که این گزینه تفسیر هدف‌های داده‌شده در خط فرمان را تغییر نمی‌دهد و تنها برای اسکریپت‌ها در نظر گرفته شده است.
.TP 4
\fBDUNE_SANDBOX\fR
حالت محیط ایزوله (sandboxing) مورد استفاده به‌طور پیش‌فرض (گزینهٔ \fB\-\-sandbox\fR را ببینید).
.TP 4
\fBDUNE_STORE_ORIG_SOURCE_DIR\fR
ذخیره مکان اصلی منبع در فراداده‌های dune-package.
.TP 4
\fBDUNE_TARGET_EXEC\fR
دستور پوششی برای اجرای باینری‌های مقصد هنگام کامپایل متقاطع. قالب: TOOLCHAIN=CMD (به عنوان مثال، 'windows=wine').
.TP 4
\fBDUNE_WORKSPACE\fR
استفاده از این فایل فضای کاری مشخص به جای جستجوی آن.
.SH "اشکالات (BUGS)"
گزارش‌های اشکال را در نشانی زیر بررسی کنید:
.br
https://github.com/ocaml/dune/issues
.SH "همچنین ببینید (SEE ALSO)"
.BR dune (1)