.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "OPAM ADMIN-UPGRADE" 1 "" "Opam admin 2.5.2" "Opam admin Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
.P
opam admin\-upgrade \- ارتقای مخازن از نسخه‌های قدیمی‌تر opam
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBopam admin upgrade\fR [\fB\N'45'\N'45'clear\N'45'cache\fR] [\fB\N'45'\N'45'mirror\fR=\fIURL\fR] [\fIOPTION\fR]…
.SH "توضیحات (DESCRIPTION)"
.P
این دستور مخازن مربوط به نسخه‌های قبلی opam را خوانده و آن‌ها را به مخازنی سازگار با نسخه فعلی opam تبدیل می‌کند\N'46' ممکن است بسته‌ها ایجاد یا تغییر نام داده شوند، و هر کامپایلری که در قالب قدیمی (دایرکتوری \N'39'compilers/\N'39') تعریف شده باشد، با استفاده از یک سلسله‌مراتب از پیش تعریف‌شده که فرض را بر کامپایلرهای OCaml می‌گذارد، به بسته تبدیل خواهد شد\N'46'
.SH "گزینه‌ها (OPTIONS)"
.TP 4
\fB\N'45'\N'45'clear\N'45'cache\fR
به‌جای اجرای ارتقا، حافظه موقت (کَش) هَش‌های آرشیو (نگه‌داری‌شده در ~/\N'46'cache) را پاک می‌کند که برای جلوگیری از بارگیری مجدد فایل‌ها جهت محاسبه هَش آن‌ها در هر بار اجرا استفاده می‌شود\N'46'
.TP 4
\fB\N'45'm\fR \fIURL\fR, \fB\N'45'\N'45'mirror\fR=\fIURL\fR
مخزن فعلی را بازنویسی نمی‌کند، بلکه یک آینه (mirror) ارتقایافته را در یک زیرشاخه همراه با تغییرمسیرهای مناسب قرار می‌دهد\N'46' به نشانی URL که مخزن از آن ارائه خواهد شد نیاز دارد تا در تغییرمسیرها قرار دهد (نسخه‌های قدیمی‌تر opam تغییرمسیرهای نسبی را متوجه نمی‌شوند)\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 (absent=\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
تعیین \fIترجیحات\fR کاربر برای حل وابستگی‌ها در این اجرا\N'46' مقادیر \fB$OPAMCRITERIA\fR، \fB$OPAMFIXUPCRITERIA\fR و \fB$OPAMUPGRADECRITERIA\fR را بازنویسی می‌کند\N'46' برای جزئیات درباره زبان پشتیبانی‌شده و حل‌کننده‌های خارجی در دسترس، به <http://opam.ocaml.org/doc/External_solvers.html> مراجعه کنید\N'46' یک راهنمای کلی برای استفاده از ترجیحات حل‌کننده را می‌توان در <http://www.dicosmo.org/Articles/usercriteria.pdf> یافت\N'46'
.TP 4
\fB\N'45'\N'45'cudf\fR=\fIFILENAME\fR
گزینه اشکال‌زدایی: ذخیره درخواست‌های CUDF ارسال‌شده به حل‌کننده در \fIFILENAME\fR\N'45'<n>\N'46'cudf که در آن <n> نشان‌دهنده n-امین فراخوانی حل‌کننده در طول اجرای 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] (default=\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
نادیده گرفتن پین‌های اضافی مورد نیاز بسته‌هایی که پین می‌شوند، چه به صورت دستی از طریق \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'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 به عنوان سوئیچ کامپایلر فعلی\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' متغیرهای دودویی (بولی) باید برای غیرفعال‌سازی بر روی "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 \fIترجیحات\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' این کار برخی بخش‌های پایانی را نادیده می‌گیرد و ممکن است به دریافت ردیابی‌های پشته (backtraces) دقیق‌تر کمک کند\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 ارتقای درونی و خودکار مخازن با قالب قدیمی‌تر به قالب فعلی را در هنگام `update` یا `init` غیرفعال می‌کند\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 در صورت بروز هرگونه ناسازگاری (خواندن فایل، وارد کردن سوئیچ و غیره) با خطا متوقف شو\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 \fIترجیحات\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 افزوده شده است، برای انتخاب پشتیبانی از 2\N'46'0 از \fIOPAMCLI\fR استفاده کنید (چرا که 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
خطا در تعریف بسته یا سایر فایل‌های فراداده (metadata)\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 failure)\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 <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 admin(1)
.SH "گزارش باگ‌ها (BUGS)"
.P
گزارش‌های باگ را در https://github\N'46'com/ocaml/opam/issues بررسی کنید\N'46'