.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R .\" .mso an.tmac .TH "OPAM-ENV" 1 "" "Opam 2.5.2" "Opam Manual" .\" Disable hyphenation and ragged-right .nh .ad l .SH "نام (NAME)" opam\-env \- چاپ مقادیر انتسابی متغیرهای مناسب پوسته در خروجی استاندارد .SH "خلاصه دستور (SYNOPSIS)" .P \fBopam env\fR [\fIOPTION\fR]… .SH "توضیحات (DESCRIPTION)" .P مقادیر متناظر متغیرهای محیطیِ تنظیم‌شده در سوییچ کنونی (مانند PATH) را در قالبی برمی‌گرداند که توسط یک پوسته (shell) قابل ارزیابی باشد. با گزینهٔ \fI\N'45'v\fR، توضیحاتی در قالب کامنت اضافه می‌شود که علت یا بستهٔ مبدأ هر انتساب را مستند می‌کند. کاربردی‌ترین روش استفاده از آن به‌صورت \fBeval $(opam env)\fR است تا دستورهای بعدی پوسته در بافتار مناسب opam ارزیابی و اجرا شوند. .P این دستور یک میان‌بر و معادل \fBopam config env\fR است. .SH "گزینه‌ها (OPTIONS)" .TP 4 \fB\N'45'\N'45'check\fR در صورتی که محیط از قبل به‌روز باشد با وضعیت 0 و در غیر این صورت پس از چاپ فهرست متغیرهای به‌روزنشده، با وضعیت 1 خارج می‌شود. .TP 4 \fB\N'45'\N'45'inplace\N'45'path\fR هنگام به‌روزرسانی متغیر \fIPATH\fR، به‌جای قرار دادن مسیر جدید در ابتدای آن، هر مسیر از پیش موجود opam را در همان جای خود جایگزین می‌کند. این بدان معناست که برنامه‌های نصب‌شده در opam که در اولویت جستجو پنهان (shadowed) شده بودند، پس از اجرای \fBopam env\fR نیز همچنان پنهان باقی خواهند ماند. .TP 4 \fB\N'45'\N'45'revert\fR به‌جای اعمال تغییرات، متغیرهای محیطی را در حالتی که به‌روزرسانی‌های انجام‌شده توسط opam بازگردانی (revert) شده‌اند در خروجی چاپ می‌کند. .TP 4 \fB\N'45'\N'45'set\N'45'root\fR همراه با زیردستورهای \fBenv\fR و \fBexec\fR، متغیر \fIOPAMROOT\fR را نیز تنظیم می‌کند تا اطمینان حاصل شود فراخوانی‌های بعدی opam از همان ریشه (root) استفاده خواهند کرد. .TP 4 \fB\N'45'\N'45'set\N'45'switch\fR همراه با زیردستورهای \fBenv\fR و \fBexec\fR، متغیر \fIOPAMSWITCH\fR را نیز تنظیم می‌کند تا اطمینان حاصل شود فراخوانی‌های بعدی opam از همان سوییچ فعلی استفاده خواهند کرد. .TP 4 \fB\N'45'\N'45'sexp\fR چاپ متغیرهای محیطی در قالب یک عبارت نمادین (s\-expression) به‌جای قالب پوسته. .TP 4 \fB\N'45'\N'45'shell\fR=\fISHELL\fR حالت پیکربندی محیط opam را متناسب با \fISHELL\fR تعیین می‌کند. باید یکی از موارد \fBbash\fR، \fBsh\fR، \fBcsh\fR، \fBzsh\fR، \fBfish\fR، \fBpwsh\fR، \fBcmd\fR یا \fBpowershell\fR باشد. به‌طور پیش‌فرض از روی فرایندهای والد و متغیر $SHELL تشخیص داده می‌شود. .SH "گزینه‌های عمومی (COMMON OPTIONS)" .P این گزینه‌ها میان همهٔ دستورها مشترک هستند. .TP 4 \fB\N'45'\N'45'best\N'45'effort\fR در صورتی که نصب تمام بسته‌های درخواستی امکان‌پذیر نباشد، با شکست مواجه نشو: تلاش کن تا جای ممکن بیشترین تعداد بسته نصب شوند. توجه داشته باشید که ممکن است همهٔ حل‌کننده‌های خارجی از این گزینه پشتیبانی نکنند (نسخه‌های اخیر \fIaspcud\fR یا \fImccs\fR باید پشتیبانی کنند). این گزینه معادل تنظیم متغیر محیطی \fB$OPAMBESTEFFORT\fR است. .TP 4 \fB\N'45'\N'45'cli\fR=\fIMAJOR\N'46'MINOR\fR (پیش‌فرض=\fB2\N'46'5\fR) استفاده از نحو و معناشناسی رابط خط فرمان مربوط به نسخهٔ \fIMAJOR\N'46'MINOR\fR. این ویژگی برای هرگونه استفادهٔ مداوم از opam (اسکریپت‌ها، پست‌های وبلاگ و غیره) در نظر گرفته شده است؛ هر نسخه‌ای از opam در همان سری MAJOR، رفتاری مطابق با نسخهٔ MINOR مشخص‌شده خواهد داشت. این پرچم در opam 2.0 در دسترس نبود، بنابراین برای انتخاب CLI نسخهٔ 2.0، متغیر محیطی \fBOPAMCLI\fR را به‌جای استفاده از این پارامتر بر روی \fI2\N'46'0\fR تنظیم کنید. .TP 4 \fB\N'45'\N'45'color\fR=\fIWHEN\fR رنگی‌کردن خروجی. مقدار \fIWHEN\fR باید یکی از گزینه‌های \fBalways\fR، \fBnever\fR یا \fBauto\fR باشد. .TP 4 \fB\N'45'\N'45'confirm\N'45'level\fR=\fILEVEL\fR سطح تأیید؛ مقدار \fILEVEL\fR باید یکی از مقادیر \fBask\fR، \fBno\fR، \fByes\fR یا \fBunsafe\N'45'yes\fR باشد. این گزینه می‌تواند بیش از یک بار مشخص شود. اگر \fB\N'45'\N'45'yes\fR یا \fB\N'45'\N'45'no\fR نیز داده شوند، مقدار آخرین \fB\N'45'\N'45'confirm\N'45'level\fR لحاظ می‌شود. این گزینه معادل تنظیم متغیر \fB$OPAMCONFIRMLEVEL\fR است. .TP 4 \fB\N'45'\N'45'criteria\fR=\fICRITERIA\fR مشخص کردن ترجیحات (\fIpreferences\fR) کاربر برای حل وابستگی‌ها در این اجرا. این گزینه بر مقادیر \fB$OPAMCRITERIA\fR، \fB$OPAMFIXUPCRITERIA\fR و \fB$OPAMUPGRADECRITERIA\fR اولویت دارد. برای دریافت جزئیات بیشتر در مورد زبان پشتیبانی‌شده و حل‌کننده‌های خارجی موجود، به \fIhttp://opam.ocaml.org/doc/External_solvers.html\fR مراجعه کنید. یک راهنمای جامع برای استفاده از ترجیحات حل‌کننده را می‌توانید در \fIhttp://www.dicosmo.org/Articles/usercriteria.pdf\fR بیابید. .TP 4 \fB\N'45'\N'45'cudf\fR=\fIFILENAME\fR گزینهٔ اشکال‌زدایی: ذخیرهٔ درخواست‌های CUDF ارسال‌شده به حل‌کننده در \fIFILENAME\fR\N'45'\N'46'cudf که در آن نشان‌دهندهٔ n\-امین فراخوانی حل‌کننده در طول اجرای opam است. .TP 4 \fB\N'45'\N'45'debug\fR چاپ پیام‌های اشکال‌زدایی در خروجی استاندارد خطا (stderr). این معادل تنظیم \fB$OPAMDEBUG\fR بر روی "true" است. .TP 4 \fB\N'45'\N'45'debug\N'45'level\fR=\fILEVEL\fR مشابه \fB\N'45'\N'45'debug\fR، اما امکان تعیین سطح اشکال‌زدایی را فراهم می‌کند (\fB\N'45'\N'45'debug\fR آن را روی 1 تنظیم می‌کند). معادل تنظیم \fB$OPAMDEBUG\fR بر روی یک عدد صحیح مثبت است. .TP 4 \fB\N'45'\N'45'git\N'45'version\fR چاپ نسخهٔ git برنامهٔ opam در صورت وجود (یعنی زمانی که از نسخهٔ در حال توسعه استفاده می‌کنید) و خروج. .TP 4 \fB\N'45'\N'45'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\N'45'\N'45'ignore\N'45'pin\N'45'depends\fR نادیده گرفتن پین‌های اضافی مورد نیاز بسته‌هایی که چه به‌صورت دستی از طریق \fIopam pin\fR و چه از طریق \fIopam install DIR\fR پین شده‌اند. این معادل تنظیم \fBIGNOREPINDEPENDS=true\fR است. .TP 4 \fB\N'45'\N'45'json\fR=\fIFILENAME\fR ذخیرهٔ نتایج اجرای opam در یک فایل ماشین‌خوان. اگر نام فایل شامل نویسهٔ «%» باشد، با شاخصی جایگزین می‌شود که مانع از بازنویسی فایل‌های موجود می‌گردد. مشابه تنظیم متغیر \fB$OPAMJSON\fR. .TP 4 \fB\N'45'\N'45'no\fR پاسخ منفی (no) به تمام پرسش‌های بله/خیر opam بدون درخواست از کاربر. همچنین گزینهٔ \fB\N'45'\N'45'confirm\N'45'level\fR را ببینید. این معادل تنظیم \fB$OPAMNO\fR بر روی "true" است. .TP 4 \fB\N'45'\N'45'no\N'45'aspcud\fR در نسخهٔ \fB2\N'46'1\fR حذف شده است. .TP 4 \fB\N'45'\N'45'no\N'45'auto\N'45'upgrade\fR هنگام پیکربندی یا به‌روزرسانی مخزنی که برای نسخهٔ قدیمی‌تر opam (1.2) نوشته شده است، opam به‌طور داخلی آن را به قالب فعلی تبدیل می‌کند. این گزینه این رفتار را غیرفعال می‌سازد. توجه داشته باشید که مخازن باید نسخهٔ قالب خود را در یک فایل \(aqrepo\(aq در ریشهٔ خود تعریف کنند، در غیر این صورت فرض می‌شود که در قالب قدیمی‌تر هستند. در هر صورت، ارتقای دستی مخازن با استفاده از \fIopam admin upgrade [\N'45'\N'45'mirror URL]\fR در صورت امکان ارجحیت دارد. .TP 4 \fB\N'45'\N'45'no\N'45'self\N'45'upgrade\fR در صورت وجود باینری جدیدتر در \fBOPAMROOT/opam\fR، ابزار opam خود را با آن جایگزین می‌کند. این گزینه این رفتار را غیرفعال می‌سازد. .TP 4 \fB\N'45'q\fR, \fB\N'45'\N'45'quiet\fR غیرفعال کردن \fB\N'45'\N'45'verbose\fR. .TP 4 \fB\N'45'\N'45'root\fR=\fIROOT\fR استفاده از \fIROOT\fR به‌عنوان مسیر ریشهٔ فعلی. این معادل تنظیم \fB$OPAMROOT\fR بر روی \fIROOT\fR است. .TP 4 \fB\N'45'\N'45'safe\fR, \fB\N'45'\N'45'readonly\fR اطمینان حاصل می‌کند که هیچ‌چیز به‌طور خودکار به‌روزرسانی یا بازنویسی نخواهد شد. برای مثال برای فراخوانی از اسکریپت‌های تکمیل خودکار (completion) مفید است. در صورت نیاز به چنین عملیاتی با شکست مواجه می‌شود؛ همچنین از انتظار برای قفل‌ها جلوگیری می‌کند، پرسش‌های تعاملی را رد می‌کند و مقدار متغیر \fB$OPAMDEBUG\fR را نادیده می‌گیرد. این گزینه معادل تنظیم متغیر محیطی \fB$OPAMSAFE\fR است. .TP 4 \fB\N'45'\N'45'solver\fR=\fICMD\fR تعیین حل‌کنندهٔ CUDF مورد استفاده برای رفع مسائل نصب بسته‌ها. این حل‌کننده یا یک حل‌کنندهٔ از پیش تعریف‌شده است (این نسخه از opam از builtin\-mccs+lp()، builtin\-mccs+glpk، builtin\-dummy\-z3\-solver، builtin\-0install، aspcud، mccs، aspcud\-old و packup پشتیبانی می‌کند)، یا یک دستور سفارشی که باید شامل متغیرهای %{input}%، %{output}%، %{criteria}%، و در صورت تمایل %{timeout}% باشد. این معادل تنظیم \fB$OPAMEXTERNALSOLVER\fR است. .TP 4 \fB\N'45'\N'45'strict\fR در صورت یافتن هرگونه خطا در تعریف بسته یا فایل پیکربندی، با شکست مواجه شو. حالت پیش‌فرض ادامه دادن بدون هشدار در صورت امکان است. .TP 4 \fB\N'45'\N'45'switch\fR=\fISWITCH\fR استفاده از \fISWITCH\fR به‌عنوان سوییچ کامپایلر فعلی. این گزینه معادل تنظیم \fB$OPAMSWITCH\fR بر روی \fISWITCH\fR است. .TP 4 \fB\N'45'\N'45'use\N'45'internal\N'45'solver\fR غیرفعال کردن هرگونه حل‌کنندهٔ خارجی و استفاده از حل‌کنندهٔ داخلی (این گزینه مستلزم آن است که opam با یک حل‌کنندهٔ داخلی کامپایل شده باشد). این معادل تنظیم \fB$OPAMNOASPCUD\fR یا \fB$OPAMUSEINTERNALSOLVER\fR است. .TP 4 \fB\N'45'v\fR, \fB\N'45'\N'45'verbose\fR نمایش جزئیات بیشتر. یک بار استفاده از \fB\N'45'v\fR تمام دستورهای مربوط به بسته‌ها را نمایش می‌دهد؛ تکرار آن، دستورهای فراخوانی‌شده به‌صورت داخلی (مانند \fItar\fR، \fIcurl\fR، \fIpatch\fR و غیره) را نیز نمایش می‌دهد. تکرار \fIn\fR بار معادل تنظیم \fB$OPAMVERBOSE\fR بر روی "\fIn\fR" است. .TP 4 \fB\N'45'\N'45'version\fR نمایش اطلاعات نسخه. .TP 4 \fB\N'45'w\fR, \fB\N'45'\N'45'working\N'45'dir\fR هنگام به‌روزرسانی بسته‌هایی که به یک دایرکتوری محلیِ تحت کنترل نسخه متصل هستند، به‌جای آخرین وضعیت ثبت‌شده (commit) یا مرجعی (ref) که به آن اشاره دارند، آن‌ها را به وضعیت کاری فعلیِ سورس به‌روزرسانی کن. از آن‌جا که دایرکتوری سورس همان‌گونه که هست کپی می‌شود، تمیز نبودن آن ممکن است منجر به شکست ساخت opam شود. این گزینه فقط بر بسته‌هایی تأثیر می‌گذارد که صریحاً در خط فرمان ذکر شده‌اند. همچنین می‌تواند با \fB$OPAMWORKINGDIR\fR تنظیم شود. .TP 4 \fB\N'45'y\fR, \fB\N'45'\N'45'yes\fR پاسخ مثبت (yes) به تمام پرسش‌های بله/خیر opam بدون درخواست از کاربر. همچنین گزینهٔ \fB\N'45'\N'45'confirm\N'45'level\fR را ببینید. این معادل تنظیم \fB$OPAMYES\fR بر روی "true" است..SH "محیط (ENVIRONMENT)" .P دستور opam از متغیرهای محیطی فهرست‌شده در اینجا استفاده می‌کند\N'46' متغیرهای بولی (Boolean) برای غیرفعال‌سازی باید روی "0"، "no"، "false" یا یک رشتهٔ خالی، و برای فعال‌سازی روی "1"، "yes" یا "true" تنظیم شوند\N'46' .P \fIOPAMALLPARENS\fR تمام فیلترها را درون پرانتز قرار می‌دهد\N'46' .P \fIOPAMASSUMEDEPEXTS\fR گزینهٔ `\N'45'\N'45'assume\N'45'depexts\N'39' را ببینید\N'46' .P \fIOPAMAUTOANSWER\fR فقط برای استفادهٔ داخلی\N'46' .P \fIOPAMAUTOREMOVE\fR گزینهٔ حذف `\N'45'\N'45'auto\N'45'remove\N'39' را ببینید\N'46' .P \fIOPAMBESTEFFORT\fR گزینهٔ `\N'45'\N'45'best\N'45'effort\N'39' را ببینید\N'46' .P \fIOPAMBESTEFFORTPREFIXCRITERIA\fR رشته‌ای را مشخص می‌کند که در صورت تنظیم گزینهٔ `\N'45'\N'45'best\N'45'effort\N'39' باید پیش از معیارها قرار گیرد، و انتظار می‌رود ویژگی `opam\N'45'query\N'39' را در پاسخ به حداکثر برساند\N'46' .P \fIOPAMBUILDDOC\fR در نگارش \fB2\N'46'1\fR حذف شد\N'46' .P \fIOPAMBUILDTEST\fR در نگارش \fB2\N'46'1\fR حذف شد\N'46' .P \fIOPAMCLI\fR گزینهٔ `\N'45'\N'45'cli\N'39' را ببینید\N'46' .P \fIOPAMCOLOR\fR هنگامی که روی \fIalways\fR یا \fInever\fR تنظیم شود، مقدار پیش‌فرضی را برای گزینهٔ `\N'45'\N'45'color\N'39' تعیین می‌کند\N'46' .P \fIOPAMCONFIRMLEVEL\fR گزینهٔ `\N'45'\N'45'confirm\N'45'level` را ببینید\N'46' متغیر \fBOPAMCONFIRMLEVEL\fR نسبت به \fBOPAMYES\fR و \fBOPAMNO\fR اولویت دارد\N'46' .P \fIOPAMCRITERIA\fR اولویت‌های کاربر (\fIpreferences\fR) را برای حل وابستگی‌ها مشخص می‌کند\N'46' مقدار پیش‌فرض به نگارش حل‌کننده بستگی دارد؛ برای دانستن تنظیمات فعلی از `config report\N'39' استفاده کنید\N'46' همچنین گزینهٔ \N'45'\N'45'criteria را ببینید\N'46' .P \fIOPAMCUDFFILE\fR گراف cudf را در \fIfile\fR\N'45'actions\N'45'explicit\N'46'dot ذخیره می‌کند\N'46' .P \fIOPAMCUDFTRIM\fR پالایش بسته‌های نامرتبط را در حین پیش‌پردازش CUDF کنترل می‌کند\N'46' .P \fIOPAMCURL\fR می‌تواند برای انتخاب یک برنامهٔ \N'39'curl\N'39' مشخص به کار رود\N'46' برای گزینه‌های بیشتر \fIOPAMFETCH\fR را ببینید\N'46' .P \fIOPAMDEBUG\fR گزینه‌های `\N'45'\N'45'debug\N'39' و `\N'45'\N'45'debug\N'45'level\N'39' را ببینید\N'46' .P \fIOPAMDEBUGSECTIONS\fR در صورت تنظیم، پیام‌های اشکال‌زدایی را به فهرست بخش‌های جداشده با فاصله محدود می‌کند\N'46' بخش‌ها می‌توانند اختیاری دارای سطح اشکال‌زدایی مشخصی باشند (برای مثال، \fBCLIENT:2\fR یا \fBCLIENT CUDF:2\fR)، اما در غیر این صورت از `\N'45'\N'45'debug\N'45'level\N'39' استفاده می‌کنند\N'46' .P \fIOPAMDIGDEPTH\fR میزان سخت‌گیرانه بودن جستجو برای تداخل‌ها را در حین پیش‌پردازش CUDF تعیین می‌کند\N'46' .P \fIOPAMDOWNLOADJOBS\fR حداکثر تعداد بارگیری‌های هم‌زمان را تنظیم می‌کند\N'46' .P \fIOPAMDROPWORKINGDIR\fR در هنگام به‌روزرسانی، بسته‌هایی را که پیش‌تر با \fB\N'45'\N'45'working\N'45'dir\fR به‌روزرسانی شده‌اند بازنویسی می‌کند\N'46' بدون تنظیم این متغیر، opam آن‌ها را بدون تغییر نگه می‌دارد مگر اینکه صراحتاً در خط فرمان نام برده شوند\N'46' .P \fIOPAMDRYRUN\fR گزینهٔ `\N'45'\N'45'dry\N'45'run\N'39' را ببینید\N'46' .P \fIOPAMEDITOR\fR ویرایشگری را که برای ویرایش پرونده‌های opam استفاده می‌شود تعیین می‌کند، و بر \fI$EDITOR\fR و \fI$VISUAL\fR تقدم دارد\N'46' .P \fIOPAMERRLOGLEN\fR تعداد خطوط گزارش چاپ‌شده در هنگام شکست یک زیرفرآیند را مشخص می‌کند\N'46' مقدار 0 برای چاپ تمام خطوط است\N'46' .P \fIOPAMEXTERNALSOLVER\fR گزینهٔ `\N'45'\N'45'solver\N'39' را ببینید\N'46' .P \fIOPAMFAKE\fR گزینهٔ `\N'45'\N'45'fake\N'39' را ببینید\N'46' .P \fIOPAMFETCH\fR نحوهٔ بارگیری پرونده‌ها را مشخص می‌کند: یکی از `wget\N'39'، `curl\N'39' یا یک دستور سفارشی که در آن متغیرهای \fB%{url}%\fR، \fB%{out}%\fR، \fB%{retry}%\fR، \fB%{compress}%\fR و \fB%{checksum}%\fR جایگزین می‌شوند\N'46' این مقدار بر مقدار \N'39'download\N'45'command\N'39' در پروندهٔ پیکربندی اصلی تقدم دارد\N'46' .P \fIOPAMFIXUPCRITERIA\fR همانند \fIOPAMUPGRADECRITERIA\fR است، اما ویژهٔ fixup و نصب مجدد است\N'46' .P \fIOPAMIGNORECONSTRAINTS\fR گزینهٔ نصب `\N'45'\N'45'ignore\N'45'constraints\N'45'on\N'39' را ببینید\N'46' .P \fIOPAMIGNOREPINDEPENDS\fR گزینهٔ `\N'45'\N'45'ignore\N'45'pin\N'45'depends\N'39' را ببینید\N'46' .P \fIOPAMINPLACEBUILD\fR گزینهٔ `\N'45'\N'45'inplace\N'45'build\N'39' را ببینید\N'46' .P \fIOPAMJOBS\fR حداکثر تعداد پردازش‌های موازی برای اجرا را تعیین می‌کند\N'46' .P \fIOPAMJSON\fR خروجی json را در پروندهٔ داده‌شده ذخیره می‌کند (از نویسهٔ `%\N'39' برای شماره‌گذاری پرونده‌ها استفاده کنید)\N'46' .P \fIOPAMKEEPBUILDDIR\fR گزینهٔ نصب `\N'45'\N'45'keep\N'45'build\N'45'dir\N'39' را ببینید\N'46' .P \fIOPAMKEEPLOGS\fR به opam اعلام می‌کند که برخی گزارش‌های موقت دستورات و برخی پشتیبان‌ها را حذف نکند\N'46' این کار برخی از عملیات پایانی را نادیده می‌گیرد و همچنین ممکن است به دریافت ردگیری‌های پشتهٔ مطمئن‌تر کمک کند\N'46' .P \fIOPAMLOCKED\fR ترکیبی از گزینه‌های `\N'45'\N'45'locked\N'39' و `\N'45'\N'45'lock\N'45'suffix\N'39'\N'46' .P \fIOPAMLOGS\fR \fIlogdir\fR دایرکتوری گزارش‌ها را مشخص می‌کند؛ پیش‌فرض یک دایرکتوری موقت در /tmp است .P \fIOPAMMAKECMD\fR دستور make سیستمی مورد استفاده را تنظیم می‌کند\N'46' .P \fIOPAMMERGEOUT\fR خروجی‌های فرآیند، یعنی stderr را بر روی stdout ادغام می‌کند\N'46' .P \fIOPAMNO\fR به هر پرسشی پاسخ منفی می‌دهد، گزینه‌های `\N'45'\N'45'no` و `\N'45'\N'45'confirm\N'45'level` را ببینید\N'46' در صورتی که هر یک از \fBOPAMCONFIRMLEVEL\fR یا \fBOPAMYES\fR تنظیم شده باشند، \fBOPAMNO\fR نادیده گرفته می‌شود\N'46' .P \fIOPAMNOAGGREGATE\fR در هنگام استفاده با `opam admin check\N'39'، بسته‌ها را تجمیع نمی‌کند\N'46' .P \fIOPAMNOASPCUD\fR منسوخ‌شده\N'46' .P \fIOPAMNOAUTOUPGRADE\fR ارتقای خودکار داخلی مخازن با قالب قدیمی‌تر به قالب فعلی را در هنگام \N'39'update\N'39' یا \N'39'init\N'39' غیرفعال می‌کند\N'46' .P \fIOPAMNOCHECKSUMS\fR گزینهٔ \N'45'\N'45'no\N'45'checksums را در صورت موجود بودن فعال می‌کند\N'46' .P \fIOPAMNODEPEXTS\fR مدیریت وابستگی‌های سیستمی را غیرفعال می‌کند، گزینهٔ `\N'45'\N'45'no\N'45'depexts\N'39' را ببینید\N'46' .P \fIOPAMNOENVNOTICE\fR داخلی\N'46' .P \fIOPAMNOSELFUPGRADE\fR گزینهٔ `\N'45'\N'45'no\N'45'self\N'45'upgrade\N'39' را ببینید .P \fIOPAMPINKINDAUTO\fR تعیین می‌کند که آیا در هنگام سنجاق کردن به یک مسیر محلی، سامانه‌های کنترل نگارش باید شناسایی شوند یا خیر\N'46' از نگارش 1\N'46'3\N'46'0 به طور پیش‌فرض فعال است\N'46' .P \fIOPAMPRECISETRACKING\fR ردیابی دقیق و با جزئیات بالا برای دایرکتوری‌ها\N'46' .P \fIOPAMPREPRO\fR برای غیرفعال کردن پیش‌پردازش CUDF، این را روی false تنظیم کنید\N'46' کارایی کمتری دارد، اما ممکن است به اشکال‌زدایی مشکلات حل‌کننده کمک کند\N'46' .P \fIOPAMREPOSITORYTARRING\fR مخازن را در داخل به صورت پرونده‌های tar\N'46'gz ذخیره می‌کند\N'46' این کار روی سامانه‌های پرونده‌ای که با پیمایش درخت‌های بزرگ به‌خوبی کنار نمی‌آیند اما کَش مناسبی در /tmp دارند بسیار سریع‌تر است\N'46' با این حال در حالت کلی کندتر است\N'46' .P \fIOPAMREQUIRECHECKSUMS\fR گزینهٔ `\N'45'\N'45'require\N'45'checksums\N'39' را در صورت موجود بودن فعال می‌کند (برای مثال برای `opam install\N'39')\N'46' .P \fIOPAMRETRIES\fR تعداد دفعات تلاش دوباره پیش از شکست بارگیری‌ها را مشخص می‌کند\N'46' .P \fIOPAMREUSEBUILDDIR\fR گزینهٔ `\N'45'\N'45'reuse\N'45'build\N'45'dir\N'39' را ببینید\N'46' .P \fIOPAMROOT\fR گزینهٔ `\N'45'\N'45'root\N'39' را ببینید\N'46' این متغیر به طور خودکار توسط `opam env \N'45'\N'45'root=DIR \N'45'\N'45'set\N'45'root\N'39' تنظیم می‌شود\N'46' .P \fIOPAMROOTISOK\fR هنگام اجرا با کاربر ریشه (root) هشداری نمی‌دهد\N'46' .P \fIOPAMSAFE\fR گزینهٔ `\N'45'\N'45'safe\N'39' را ببینید\N'46' .P \fIOPAMSHOW\fR گزینهٔ `\N'45'\N'45'show\N'39' را ببینید\N'46' .P \fIOPAMSKIPUPDATE\fR گزینهٔ `\N'45'\N'45'skip\N'45'updates\N'39' را ببینید\N'46' .P \fIOPAMSKIPVERSIONCHECKS\fR برخی از بررسی‌های نگارش را نادیده می‌گیرد\N'46' ناامن است، و صرفاً برای آزمایش سازگاری کاربرد دارد\N'46' .P \fIOPAMSOLVERALLOWSUBOPTIMAL\fR (پیش‌فرض `true\N'39') به برخی حل‌کننده‌ها اجازه می‌دهد در صورت رسیدن به مهلت زمانی (timeout)، همچنان پاسخی ارائه دهند؛ اگرچه پاسخ قطعاً پایدار و سازگار خواهد بود، اما در این حالت هیچ تضمینی وجود ندارد که با معیارهای بهینه‌سازی مورد انتظار مطابقت داشته باشد\N'46' در صورت `true\N'39' بودن، opam با یک هشدار ادامه خواهد داد؛ در صورت `false\N'39' بودن، رسیدن به مهلت زمانی یک خطا در نظر گرفته می‌شود\N'46' در حال حاضر فقط backend داخلی builtin\N'45'z3 این حالت تنزل‌یافته را مدیریت می‌کند\N'46' .P \fIOPAMSOLVERTIMEOUT\fR زمان مجاز برای حل‌کننده را تغییر می‌دهد\N'46' پیش‌فرض 60\N'46'0 است؛ برای حالت نامحدود روی 0 بگذارید\N'46' توجه داشته باشید که ممکن است همهٔ حل‌کننده‌ها از این گزینه پشتیبانی نکنند\N'46' .P \fIOPAMSOLVERTOLERANCE\fR میزان مدارا را نسبت به انتخاب یک پاسخ غیربهینه توسط حل‌کننده تغییر می‌دهد (یعنی ممکن است بسته‌های قدیمی را انتخاب کند)\N'46' مقادیر معمول از 0\N'46'0 (بهترین پاسخ شناخته‌شده برای حل‌کننده) تا 1\N'46'0 (پاسخ غیربهینه) متغیر است\N'46' پیش‌فرض 0\N'46'0 است\N'46' این گزینه در مواردی که حل‌کننده نمی‌تواند در زمان معقولی پاسخ بیابد سودمند است (\fB$OPAMSOLVERTIMEOUT\fR را ببینید)\N'46' توجه داشته باشید که ممکن است همهٔ حل‌کننده‌ها از این گزینه پشتیبانی نکنند\N'46' .P \fIOPAMSTATS\fR در نگارش \fB2\N'46'4\fR حذف شد\N'46' .P \fIOPAMSTATUSLINE\fR یک خط وضعیت پویا را در ترمینال برای نمایش رویدادهای در حال انجام نشان می‌دهد\N'46' (یکی از گزینه‌های \fBalways\fR، \fBnever\fR یا \fBauto\fR) .P \fIOPAMSTRICT\fR در صورت بروز هرگونه ناسازگاری (خواندن پرونده، وارد کردن سوییچ و غیره) متوقف شده و شکست می‌خورد\N'46' .P \fIOPAMSWITCH\fR گزینهٔ `\N'45'\N'45'switch\N'39' را ببینید\N'46' به طور خودکار توسط `opam env \N'45'\N'45'switch=SWITCH \N'45'\N'45'set\N'45'switch\N'39' تنظیم می‌شود\N'46' .P \fIOPAMUNLOCKBASE\fR گزینهٔ نصب `\N'45'\N'45'unlock\N'45'base\N'39' را ببینید\N'46' .P \fIOPAMUPGRADECRITERIA\fR اولویت‌های کاربر (\fIpreferences\fR) را برای حل وابستگی در زمان ارتقا مشخص می‌کند\N'46' در صورت تنظیم هر دو، در ارتقاها بر \fIOPAMCRITERIA\fR اولویت خواهد داشت\N'46' همچنین گزینهٔ \N'45'\N'45'criteria را ببینید\N'46' .P \fIOPAMUSEINTERNALSOLVER\fR گزینهٔ `\N'45'\N'45'use\N'45'internal\N'45'solver\N'39' را ببینید\N'46' .P \fIOPAMUSEOPENSSL\fR در نگارش \fB2\N'46'2\fR حذف شد\N'46' .P \fIOPAMUTF8\fR استفاده از نویسه‌های UTF8 در خروجی (یکی از گزینه‌های \fBalways\fR، \fBnever\fR یا \fBauto\fR)\N'46' به طور پیش‌فرض `auto\N'39' است که بر اساس محلی‌سازی سیستم (locale) تعیین می‌شود)\N'46' .P \fIOPAMUTF8MSGS\fR استفاده از نویسه‌های گسترش‌یافتهٔ UTF8 (شترها) در پیام‌های opam\N'46' متضمن فعال بودن \fIOPAMUTF8\fR است\N'46' این متغیر به طور پیش‌فرض تنها در macOS تنظیم شده است\N'46' .P \fIOPAMVALIDATIONHOOK\fR در صورت تنظیم، از دستور `%{hook%}\N'39' برای اعتبارسنجی به‌روزرسانی مخزن opam استفاده می‌کند\N'46' .P \fIOPAMVERBOSE\fR گزینهٔ `\N'45'\N'45'verbose\N'39' را ببینید\N'46' .P \fIOPAMVERBOSEON\fR گزینهٔ \N'45'\N'45'verbose\N'45'on را ببینید .P \fIOPAMVERSIONLAGPOWER\fR استفاده نشود\N'46' .P \fIOPAMWITHDEVSETUP\fR گزینهٔ نصب `\N'45'\N'45'with\N'45'dev\N'45'setup\N'39' را ببینید\N'46' .P \fIOPAMWITHDOC\fR گزینهٔ نصب `\N'45'\N'45'with\N'45'doc\N'39' را ببینید\N'46' .P \fIOPAMWITHTEST\fR گزینهٔ نصب `\N'45'\N'45'with\N'45'test را ببینید\N'46' .P \fIOPAMWORKINGDIR\fR گزینهٔ `\N'45'\N'45'working\N'45'dir\N'39' را ببینید\N'46' .P \fIOPAMYES\fR گزینه‌های `\N'45'\N'45'yes\N'39' و `\N'45'\N'45'confirm\N'45'level` را ببینید\N'46' متغیر \fBOPAMYES\fR نسبت به \fBOPAMNO\fR اولویت دارد و در صورت تنظیم \fBOPAMCONFIRMLEVEL\fR نادیده گرفته می‌شود\N'46' .P \fIOPAMVAR_var\fR هنگام جایگزینی رشته‌های `%{var}%` در پرونده‌های `opam`، محتوای متغیر \fIvar\fR را بازنویسی می‌کند\N'46' .P \fIOPAMVAR_package_var\fR هنگام جایگزینی رشته‌های `%{package:var}%` در پرونده‌های `opam`، محتوای متغیر \fIpackage:var\fR را بازنویسی می‌کند\N'46'.SH "نسخه خط فرمان (CLI VERSION)" .P همه اسکریپت‌ها و فراخوانی‌های برنامه‌نویسی‌شده opam باید از `\N'45'\N'45'cli\N'39' استفاده کنند تا اطمینان حاصل شود که با نسخه‌های بعدی کلاینت opam بدون مشکل کار خواهند کرد\N'46' علاوه بر این، پست‌های وبلاگ یا سایر مستندات نیز می‌توانند از آن بهره‌مند شوند، زیرا از کهنه شدن اطلاعات جلوگیری می‌کند\N'46' .P اگرچه opam فقط از ریشه‌ها (\fI~/\N'46'opam/\fR) برای نسخه فعلی پشتیبانی می‌کند، اما سازگاری رو به عقب را برای واسط خط فرمان خود فراهم می‌آورد\N'46' .P از آنجا که پشتیبانی از نسخه CLI تنها در opam 2\N'46'1 اضافه شد، از \fIOPAMCLI\fR برای انتخاب پشتیبانی 2\N'46'0 استفاده کنید (زیرا opam 2\N'46'0 صرفاً آن را نادیده می‌گیرد)، و برای نسخه‌های 2\N'46'1 (یا جدیدتر) از `\N'45'\N'45'cli=2\N'46'1\N'39' استفاده کنید، چرا که متغیر محیطی کنترل‌کننده تجزیه نحو شکننده است\N'46' بدین منظور، opam در صورتی که \fIOPAMCLI\fR نسخه‌ای معتبر غیر از 2\N'46'0 را مشخص کند، و همچنین اگر `\N'45'\N'45'cli=2\N'46'0\N'39' مشخص شده باشد، یک هشدار نمایش می‌دهد\N'46' .P نسخه خط فرمان با استفاده از گزینه `\N'45'\N'45'cli\N'39' یا متغیر محیطی \fIOPAMCLI\fR انتخاب می‌شود\N'46' گزینه `\N'45'\N'45'cli\N'39' ممکن است بیش از یک‌بار مشخص شود، که در این حالت آخرین مورد اولویت دارد\N'46' متغیر \fIOPAMCLI\fR تنها در صورتی بررسی می‌شود که `\N'45'\N'45'cli\N'39' داده نشده باشد\N'46' .SH "وضعیت خروج (EXIT STATUS)" .P به‌عنوان استثنایی بر موارد زیر، دستور `exec\N'39' در صورتی که دستور یافت نشود یا نتوان آن را اجرا کرد مقدار 127، و در غیر این صورت مقدار خروج خود دستور را بازمی‌گرداند\N'46' .TP 4 0 موفقیت، یا true برای پرس‌وجوهای بولی\N'46' .TP 4 1 نادرست (False)\N'46' زمانی بازگردانده می‌شود که یک مقدار بازگشتی بولی انتظار می‌رود، برای مثال هنگام اجرا با \fB\N'45'\N'45'check\fR، یا برای پرس‌وجوهایی مانند \fBopam lint\fR\N'46' .TP 4 2 آرگومان‌های نامعتبر خط فرمان، یا آرگومان‌های خط فرمانی که به یک زمینه نامعتبر اشاره دارند (مثلاً فایلی که از قالب مورد انتظار پیروی نمی‌کند)\N'46' .TP 4 5 یافت نشد\N'46' چیزی (بسته، نسخه، مخزن، و غیره) را درخواست کرده‌اید که پیدا نشد\N'46' .TP 4 10 لغو شد\N'46' عملیات نیاز به تأیید داشت که تأیید داده نشد\N'46' .TP 4 15 امکان دریافت قفل‌های لازم برای عملیات وجود نداشت\N'46' .TP 4 20 هیچ راه‌حلی برای درخواست کاربر وجود ندارد\N'46' برای مثال، این می‌تواند ناشی از درخواست برای نصب دو بسته ناسازگار با یکدیگر باشد\N'46' .TP 4 30 خطا در تعریف بسته یا سایر فایل‌های فراداده (متادیتا)\N'46' استفاده از \fB\N'45'\N'45'strict\fR این خطا را با احتمال بیشتری ایجاد می‌کند\N'46' .TP 4 31 خطای اسکریپت بسته\N'46' برخی از عملیات بسته ناموفق بودند\N'46' این ممکن است خطایی در بسته‌ها یا ناسازگاری با سیستم شما باشد\N'46' این می‌تواند یک خطای جزئی باشد\N'46' .TP 4 40 خطای همگام‌سازی\N'46' امکان دریافت برخی از ریموت‌ها از شبکه وجود نداشت\N'46' این می‌تواند یک خطای جزئی باشد\N'46' .TP 4 50 خطای پیکربندی\N'46' پیکربندی Opam یا سیستم اجازه انجام عملیات را نمی‌دهد و نیاز به رفع اشکال دارد\N'46' .TP 4 60 شکست حل‌کننده (Solver)\N'46' حل‌کننده نتوانست پاسخی معتبر بازگرداند\N'46' این امر می‌تواند ناشی از یک حل‌کننده خارجی معیوب یا خطایی در پیکربندی حل‌کننده باشد\N'46' .TP 4 99 خطای داخلی\N'46' مشکلی رخ داده است، احتمالاً به دلیل یک باگ در خود opam\N'46' .TP 4 130 وقفه کاربر\N'46' سیگنال SIGINT دریافت شد، عموماً به دلیل فشردن کلیدهای Ctrl\N'45'C توسط کاربر\N'46' .TP 4 0 در صورت موفقیت\N'46' .TP 4 123 در خطاهای تفکیک‌نشده گزارش‌شده در خروجی خطای استاندارد\N'46' .TP 4 124 در خطاهای تجزیه خط فرمان\N'46' .TP 4 125 در خطاهای غیرمنتظره داخلی (باگ‌ها)\N'46' .SH "مستندات بیشتر (FURTHER DOCUMENTATION)" .P به https://opam\N'46'ocaml\N'46'org/doc مراجعه کنید\N'46' .SH "نویسندگان (AUTHORS)" .P David Allsopp .sp -1 .P Vincent Bernardoff .sp -1 .P Raja Boujbel .sp -1 .P Kate Deplaix .sp -1 .P Roberto Di Cosmo .sp -1 .P Thomas Gazagnaire .sp -1 .P Louis Gesbert .sp -1 .P Fabrice Le Fessant .sp -1 .P Anil Madhavapeddy .sp -1 .P Guillem Rieu .sp -1 .P Ralf Treinen .sp -1 .P Frederic Tuong .SH "همچنین ببینید (SEE ALSO)" .P opam(1) .SH "گزارش باگ‌ها (BUGS)" .P گزارش‌های باگ را در https://github\N'46'com/ocaml/opam/issues بررسی کنید.