.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "OPAM-REMOTE" 1 "" "Opam 2.5.2" "Opam Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
.P
opam\-remote \- نام مستعاری برای \fBrepository\fR
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBopam remote\fR [\fB\N'45'\N'45'kind\fR=\fIKIND\fR] [\fB\N'45'\N'45'rank\fR=\fIRANK\fR] [\fB\N'45'\N'45'short\fR] [\fIOPTION\fR]… [\fICOMMAND\fR] [\fIARG\fR]…
.SH "توضیحات (DESCRIPTION)"
.P
دستور \fBopam\fR\fB remote\fR یک نام مستعار برای \fBopam\fR\fB repository\fR است\N'46'
.P
برای جزئیات بیشتر، \fBopam\fR\fB repository \N'45'\N'45'help\fR را ببینید\N'46'
.SH "گزینه‌های تعیین دامنه (SCOPE SPECIFICATION OPTIONS)"
.TP 4
\fB\N'45'a\fR, \fB\N'45'\N'45'all\N'45'switches\fR
اعمال روی انتخاب‌های تمام switchهای پیکربندی‌شده\N'46'
.TP 4
\fB\N'45'\N'45'dont\N'45'select\fR
هیچ انتخابی را به‌روزرسانی نکن\N'46'
.TP 4
\fB\N'45'\N'45'on\N'45'switches\fR=\fISWITCHES\fR
اعمال روی انتخاب‌های فهرست ارائه‌شده از switchها\N'46'
.TP 4
\fB\N'45'\N'45'set\N'45'default\fR
اعمال روی انتخاب مخزن پیش‌فرضی که برای switchهای تازه‌ایجادشده استفاده می‌شود\N'46'
.TP 4
\fB\N'45'\N'45'this\N'45'switch\fR
اعمال روی انتخاب‌های switch جاری (این حالت پیش‌فرض است)\N'46'
.SH "گزینه‌ها (OPTIONS)"
.TP 4
\fB\N'45'k\fR \fIKIND\fR, \fB\N'45'\N'45'kind\fR=\fIKIND\fR
نوع مخزن مورد استفاده را مشخص می‌کند (یکی از موارد \fBhttp\fR، \fBlocal\fR، \fBgit\fR، \fBdarcs\fR یا \fBhg\fR)\N'46'
.TP 4
\fB\N'45'\N'45'rank\fR=\fIRANK\fR (در صورت نبود=\fB1\fR)
رتبه مخزن را در فهرست مخازن پیکربندی‌شده تعیین می‌کند\N'46' تعاریف بسته‌ها با ترتیب رتبه صعودی در مخازن جستجو می‌شوند، بنابراین ۱ بالاترین اولویت است\N'46' اعداد صحیح منفی می‌توانند برای انتخاب از کمترین اولویت استفاده شوند، به‌طوری که \N'45'1 آخرین مورد خواهد بود\N'46' در غیر این صورت می‌توان از \fBset\N'45'repos\fR برای تعیین صریح کل فهرست مخازن به طور یکجا استفاده کرد\N'46'
.TP 4
\fB\N'45's\fR, \fB\N'45'\N'45'short\fR
فهرستی خام از نام‌ها را، یک نام در هر خط، بدون نمایش جزئیات در خروجی چاپ می‌کند\N'46'
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.P
این گزینه‌ها میان تمامی دستورها مشترک هستند\N'46'
.TP 4
\fB\N'45'\N'45'best\N'45'effort\fR
اگر تمام بسته‌های درخواستی قابل نصب نباشند با شکست مواجه نشو: تلاش کن تا جای ممکن بیشترین بسته‌ها نصب شوند\N'46' توجه داشته باشید که ممکن است همه حل‌کننده‌های خارجی از این گزینه پشتیبانی نکنند (نسخه‌های اخیر \fIaspcud\fR یا \fImccs\fR باید پشتیبانی کنند)\N'46' این معادل با تنظیم متغیر محیطی \fB$OPAMBESTEFFORT\fR است\N'46'
.TP 4
\fB\N'45'\N'45'cli\fR=\fIMAJOR\N'46'MINOR\fR (در صورت نبود=\fB2\N'46'5\fR)
از نحو و معناشناسی رابط خط فرمان \fIMAJOR\N'46'MINOR\fR استفاده می‌کند\N'46' این گزینه برای هرگونه استفاده ماندگار از opam (اسکریپت‌ها، پست‌های وبلاگ و غیره) در نظر گرفته شده است؛ هر نسخه‌ای از opam در همان سری MAJOR مانند انتشار MINOR مشخص‌شده رفتار خواهد کرد\N'46' این پرچم در opam 2\N'46'0 در دسترس نبود، بنابراین برای انتخاب رابط خط فرمان 2\N'46'0، به جای استفاده از این پارامتر، متغیر محیطی \fBOPAMCLI\fR را بر روی \fI2\N'46'0\fR تنظیم کنید\N'46'
.TP 4
\fB\N'45'\N'45'color\fR=\fIWHEN\fR
خروجی را رنگی می‌کند\N'46' مقدار \fIWHEN\fR باید یکی از موارد \fBalways\fR، \fBnever\fR یا \fBauto\fR باشد\N'46'
.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 باشد\N'46' می‌تواند بیش از یک بار مشخص شود\N'46' اگر \fB\N'45'\N'45'yes\fR یا \fB\N'45'\N'45'no\fR نیز داده شده باشند، مقدار آخرین \fB\N'45'\N'45'confirm\N'45'level\fR لحاظ می‌شود\N'46' این معادل با تنظیم متغیر محیطی \fB$OPAMCONFIRMLEVEL\fR است\N'46'
.TP 4
\fB\N'45'\N'45'criteria\fR=\fICRITERIA\fR
ترجیحات (\fIpreferences\fR) کاربر را برای حل وابستگی در این اجرا مشخص می‌کند\N'46' بر \fB$OPAMCRITERIA\fR، \fB$OPAMFIXUPCRITERIA\fR و \fB$OPAMUPGRADECRITERIA\fR اولویت دارد\N'46' برای جزئیات مربوط به زبان پشتیبانی‌شده و حل‌کننده‌های خارجی موجود، \fIhttp://opam\N'46'ocaml\N'46'org/doc/External_solvers\N'46'html\fR را ببینید\N'46' یک راهنمای جامع برای استفاده از ترجیحات حل‌کننده را می‌توان در \fIhttp://www\N'46'dicosmo\N'46'org/Articles/usercriteria\N'46'pdf\fR یافت\N'46'
.TP 4
\fB\N'45'\N'45'cudf\fR=\fIFILENAME\fR
گزینه اشکال‌زدایی: درخواست‌های CUDF ارسال‌شده به حل‌کننده را در \fIFILENAME\fR\N'45'<n>\N'46'cudf ذخیره می‌کند که در آن <n> نشان‌دهنده n\N'45'اُمین فراخوانی حل‌کننده در طول اجرای opam است\N'46'
.TP 4
\fB\N'45'\N'45'debug\fR
پیام‌های اشکال‌زدایی را در stderr چاپ می‌کند\N'46' این معادل با تنظیم \fB$OPAMDEBUG\fR بر روی "true" است\N'46'
.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 تنظیم می‌کند)\N'46' معادل با تنظیم \fB$OPAMDEBUG\fR بر روی یک عدد صحیح مثبت است\N'46'
.TP 4
\fB\N'45'\N'45'git\N'45'version\fR
در صورت تنظیم بودن نسخه git برنامه opam (یعنی زمانی که از نسخه توسعه استفاده می‌کنید)، آن را چاپ کرده و خارج می‌شود\N'46'
.TP 4
\fB\N'45'\N'45'help\fR[=\fIFMT\fR] (پیش‌فرض=\fBauto\fR)
این راهنما را در قالب \fIFMT\fR نمایش می‌دهد\N'46' مقدار \fIFMT\fR باید یکی از موارد \fBauto\fR، \fBpager\fR، \fBgroff\fR یا \fBplain\fR باشد\N'46' با مقدار \fBauto\fR، هر زمان که متغیر محیطی \fBTERM\fR برابر با \fBdumb\fR یا تعریف‌نشده باشد، قالب برابر با \fBpager\fR یا \fBplain\fR خواهد بود\N'46'
.TP 4
\fB\N'45'\N'45'ignore\N'45'pin\N'45'depends\fR
سنجاق‌های (pin) اضافی مورد نیاز بسته‌هایی که چه به صورت دستی از طریق \fIopam pin\fR و چه از طریق \fIopam install DIR\fR سنجاق شده‌اند را نادیده می‌گیرد\N'46' این معادل با تنظیم \fBIGNOREPINDEPENDS=true\fR است\N'46'
.TP 4
\fB\N'45'\N'45'json\fR=\fIFILENAME\fR
نتایج اجرای opam را در یک فایل ماشین‌خوان ذخیره می‌کند\N'46' اگر نام فایل شامل نویسه `%\N'39' باشد، با نمایه‌ای جایگزین می‌شود که روی فایلی از پیش موجود بازنویسی نکند\N'46' مشابه با تنظیم متغیر \fB$OPAMJSON\fR است\N'46'
.TP 4
\fB\N'45'\N'45'no\fR
بدون پرسش، به تمام سؤالات بله/خیر opam پاسخ منفی می‌دهد\N'46' همچنین \fB\N'45'\N'45'confirm\N'45'level\fR را ببینید\N'46' این معادل با تنظیم \fB$OPAMNO\fR بر روی "true" است\N'46'
.TP 4
\fB\N'45'\N'45'no\N'45'aspcud\fR
در نسخه \fB2\N'46'1\fR حذف شد\N'46'
.TP 4
\fB\N'45'\N'45'no\N'45'auto\N'45'upgrade\fR
هنگام پیکربندی یا به‌روزرسانی مخزنی که برای نسخه‌های قدیمی‌تر opam نوشته شده است (1\N'46'2)، opam در داخل آن را به قالب فعلی تبدیل می‌کند\N'46' این گزینه این رفتار را غیرفعال می‌کند\N'46' توجه داشته باشید که مخازن باید نسخه قالب خود را در یک فایل \N'39'repo\N'39' در ریشه خود تعریف کنند، در غیر این صورت فرض می‌شود که در قالب قدیمی هستند\N'46' در هر صورت، در صورت امکان ارتقای دستی مخازن با استفاده از \fIopam admin upgrade [\N'45'\N'45'mirror URL]\fR ترجیح دارد\N'46'
.TP 4
\fB\N'45'\N'45'no\N'45'self\N'45'upgrade\fR
در صورت وجود فایل باینری جدیدتر در \fBOPAMROOT/opam\fR، برنامه opam خود را با آن جایگزین می‌کند\N'46' این گزینه این رفتار را غیرفعال می‌کند\N'46'
.TP 4
\fB\N'45'q\fR, \fB\N'45'\N'45'quiet\fR
گزینه \fB\N'45'\N'45'verbose\fR را غیرفعال می‌کند\N'46'
.TP 4
\fB\N'45'\N'45'root\fR=\fIROOT\fR
از \fIROOT\fR به عنوان مسیر ریشه فعلی استفاده می‌کند\N'46' این معادل با تنظیم متغیر محیطی \fB$OPAMROOT\fR بر روی \fIROOT\fR است\N'46'
.TP 4
\fB\N'45'\N'45'safe\fR, \fB\N'45'\N'45'readonly\fR
اطمینان حاصل می‌کند که هیچ چیزی به طور خودکار به‌روزرسانی یا بازنویسی نشود\N'46' به عنوان مثال برای فراخوانی از اسکریپت‌های تکمیل خودکار (completion) مفید است\N'46' هرگاه چنین عملیاتی مورد نیاز باشد با شکست مواجه می‌شود؛ همچنین از انتظار برای قفل‌ها جلوگیری می‌کند، از پرسش‌های تعاملی صرف‌نظر می‌کند و بر متغیر \fB$OPAMDEBUG\fR تقدم دارد\N'46' این معادل با تنظیم متغیر محیطی \fB$OPAMSAFE\fR است\N'46'
.TP 4
\fB\N'45'\N'45'solver\fR=\fICMD\fR
حل‌کننده CUDF مورد استفاده برای حل مشکلات نصب بسته‌ها را مشخص می‌کند\N'46' این مقدار می‌تواند یک حل‌کننده از پیش تعریف‌شده باشد (این نسخه از opam از builtin\N'45'mccs+lp()، builtin\N'45'mccs+glpk، builtin\N'45'dummy\N'45'z3\N'45'solver، builtin\N'45'0install، aspcud، mccs، aspcud\N'45'old و packup پشتیبانی می‌کند)، یا یک دستور سفارشی که باید شامل متغیرهای %{input}%، %{output}%، %{criteria}% و به صورت اختیاری %{timeout}% باشد\N'46' این معادل با تنظیم متغیر محیطی \fB$OPAMEXTERNALSOLVER\fR است\N'46'
.TP 4
\fB\N'45'\N'45'strict\fR
هرگاه خطایی در تعریف یک بسته یا فایل پیکربندی پیدا شود با خطا متوقف شو\N'46' حالت پیش‌فرض ادامه بی‌صدا در صورت امکان است\N'46'
.TP 4
\fB\N'45'\N'45'switch\fR=\fISWITCH\fR
از \fISWITCH\fR به عنوان switch جاری کامپایلر استفاده می‌کند\N'46' این معادل با تنظیم متغیر محیطی \fB$OPAMSWITCH\fR بر روی \fISWITCH\fR است\N'46'
.TP 4
\fB\N'45'\N'45'use\N'45'internal\N'45'solver\fR
هرگونه حل‌کننده خارجی را غیرفعال کرده و از حل‌کننده توکار استفاده می‌کند (این امر نیازمند این است که opam با حل‌کننده توکار کامپایل شده باشد)\N'46' این معادل با تنظیم متغیرهای محیطی \fB$OPAMNOASPCUD\fR یا \fB$OPAMUSEINTERNALSOLVER\fR است\N'46'
.TP 4
\fB\N'45'v\fR, \fB\N'45'\N'45'verbose\fR
توضیحات و جزئیات بیشتری در خروجی نمایش می‌دهد\N'46' یک بار درج \fB\N'45'v\fR تمام دستورهای مربوط به بسته‌ها را نشان می‌دهد؛ تکرار آن دستورهای فراخوانی‌شده به صورت داخلی (مانند \fItar\fR، \fIcurl\fR، \fIpatch\fR و غیره) را نیز نمایش می‌دهد\N'46' تکرار به تعداد \fIn\fR بار معادل با تنظیم متغیر محیطی \fB$OPAMVERBOSE\fR بر روی "\fIn\fR" است\N'46'
.TP 4
\fB\N'45'\N'45'version\fR
اطلاعات نسخه را نمایش می‌دهد\N'46'
.TP 4
\fB\N'45'w\fR, \fB\N'45'\N'45'working\N'45'dir\fR
هنگام به‌روزرسانی بسته‌های متصل به یک دایرکتوری محلی و تحت کنترل نسخه، به جای آخرین وضعیت ثبت‌شده (commit) یا ارجاعی (ref) که به آن اشاره دارند، به وضعیت کاری فعلی سورس آن‌ها به‌روزرسانی می‌کند\N'46' از آنجا که دایرکتوری سورس همان‌گونه که هست کپی می‌شود، تمیز نبودن آن ممکن است به شکست ساخت opam منجر شود\N'46' این گزینه فقط بر بسته‌هایی تأثیر می‌گذارد که به صراحت در خط فرمان مشخص شده‌اند\N'46' همچنین می‌تواند از طریق متغیر محیطی \fB$OPAMWORKINGDIR\fR تنظیم شود\N'46'
.TP 4
\fB\N'45'y\fR, \fB\N'45'\N'45'yes\fR
بدون پرسش، به تمام سؤالات بله/خیر opam پاسخ مثبت می‌دهد\N'46' همچنین \fB\N'45'\N'45'confirm\N'45'level\fR را ببینید\N'46' این معادل با تنظیم متغیر محیطی \fB$OPAMYES\fR بر روی "true" است\N'46'.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 و reinstall\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' این متغیر برخی عملیات پایانی را نادیده می‌گیرد و همچنین ممکن است به دریافت ردگیری‌های پشته (backtrace) مطمئن‌تر کمک کند\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 به هر سؤالی پاسخ no می‌دهد، گزینه‌های `\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' در حال حاضر فقط بخش پشتیبان 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 در صورت بروز هرگونه ناسازگاری (خواندن فایل، وارد کردن switch و غیره) با خطا متوقف می‌شود\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 محتوای متغیر \fIvar\fR را هنگام جایگزینی رشته‌های `%{var}%` در فایل‌های `opam` بازنویسی می‌کند\N'46'
.P
\fIOPAMVAR_package_var\fR محتوای متغیر \fIpackage:var\fR را هنگام جایگزینی رشته‌های `%{package:var}%` در فایل‌های `opam` بازنویسی می‌کند\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' بدین منظور، اگر \fIOPAMCLI\fR نسخه‌ای معتبر غیر از 2\N'46'0 را مشخص کند، و همچنین در صورتی که `\N'45'\N'45'cli=2\N'46'0\N'39' مشخص شده باشد، opam یک هشدار نمایش می‌دهد\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
در صورت بروز خطاهای نامشخص گزارش‌شده در خروجی خطای استاندارد (stderr)\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 <david@tarides\N'46'com>
.sp -1
.P
Vincent Bernardoff <vb@luminar\N'46'eu\N'46'org>
.sp -1
.P
Raja Boujbel <raja\N'46'boujbel@ocamlpro\N'46'com>
.sp -1
.P
Kate Deplaix <kit\N'45'ty\N'45'kate@outlook\N'46'com>
.sp -1
.P
Roberto Di Cosmo <roberto@dicosmo\N'46'org>
.sp -1
.P
Thomas Gazagnaire <thomas@gazagnaire\N'46'org>
.sp -1
.P
Louis Gesbert <louis\N'46'gesbert@ocamlpro\N'46'com>
.sp -1
.P
Fabrice Le Fessant <Fabrice\N'46'Le_fessant@inria\N'46'fr>
.sp -1
.P
Anil Madhavapeddy <anil@recoil\N'46'org>
.sp -1
.P
Guillem Rieu <guillem\N'46'rieu@ocamlpro\N'46'com>
.sp -1
.P
Ralf Treinen <ralf\N'46'treinen@pps\N'46'jussieu\N'46'fr>
.sp -1
.P
Frederic Tuong <tuong@users\N'46'gforge\N'46'inria\N'46'fr>
.SH "همچنین ببینید (SEE ALSO)"
.P
opam(1)
.SH "گزارش باگ‌ها (BUGS)"
.P
گزارش‌های باگ را در https://github\N'46'com/ocaml/opam/issues بررسی کنید\N'46'