.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "OPAM ADMIN-CACHE" 1 "" "Opam admin 2.5.2" "Opam admin Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
opam admin-cache \- پر کردن حافظه نهان محلی از بایگانی بسته‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBopam admin cache\fR [\fIOPTION\fR]… [\fIDIR\fR]
.SH "توضیحات (DESCRIPTION)"
.P
بایگانی‌های همه بسته‌ها را برای پر کردن یک حافظه نهان محلی دانلود می‌کند؛ این حافظه نهان می‌تواند هنگام ارائه مخزن مورد استفاده قرار گیرد\N'46'
.SH "آرگومان‌ها (ARGUMENTS)"
.TP 4
\fIDIR\fR (در صورت عدم ذکر=\fB~/opam/src/opam\N'45'full\N'45'2\N'46'5\N'46'2/_build/default/doc/man/cache\fR)
نام دایرکتوری حافظه نهان جهت استفاده\N'46'
.SH "گزینه‌ها (OPTIONS)"
.TP 4
\fB\N'45'c\fR, \fB\N'45'\N'45'check\N'45'all\fR
یک بررسی کامل یکپارچگی روی حافظه نهان موجود انجام می‌دهد\N'46' اگر این گزینه تنظیم نشود، تنها فایل‌های ناموجود در حافظه نهان پردازش می‌شوند\N'46'`
.TP 4
\fB\N'45'j\fR \fIJOBS\fR, \fB\N'45'\N'45'jobs\fR=\fIJOBS\fR (در صورت عدم ذکر=\fB8\fR)
تعداد دانلودهای موازی
.TP 4
\fB\N'45'\N'45'link\fR=\fIDIR\fR
پیوندهای نمادین معکوس به بایگانی‌های درون \fIDIR\fR، به شکل \fBDIR/PKG\N'46'VERSION/FILENAME\fR ایجاد می‌کند\N'46'
.TP 4
\fB\N'45'n\fR, \fB\N'45'\N'45'no\N'45'repo\N'45'update\fR
فایل \N'39'repo\N'39' را برای اشاره به حافظه نهان تولیدشده (فیلد \N'39'archive\N'45'mirrors:\N'39') بررسی، ایجاد یا به‌روزرسانی نمی‌کند\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
\fIترجیحات\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
پین‌های اضافی مورد نیاز بسته‌هایی که چه به صورت دستی با \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'46' مشابه با تنظیم متغیر \fB$OPAMJSON\fR است\N'46'
.TP 4
\fB\N'45'\N'45'no\fR
بدون پرسش، به تمام سوال‌های بله/خیر opam پاسخ خیر (no) می‌دهد\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) یا مرجعی که به آن اشاره می‌کنند، به وضعیت کاری فعلی سورس آن‌ها به‌روزرسانی می‌کند\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 پاسخ بله (yes) می‌دهد\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 ترجیحات (\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 این را روی false بگذارید تا پیش‌پردازش CUDF غیرفعال شود\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') به برخی از حل‌کننده‌ها اجازه می‌دهد تا پس از اتمام مهلت زمانی همچنان یک راه‌حل بازگردانند؛ در حالی که تضمین می‌شود راه‌حل سازگار بماند، در این حالت هیچ تضمینی وجود ندارد که با معیارهای بهینه‌سازی موردانتظار تطابق داشته باشد\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') با شکست مواجه می‌شود\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' برای این منظور، اگر \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' دریافت برخی از مخازن دوردست (remotes) از شبکه ممکن نشد\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
در صورت خطاهای گوناگون گزارش‌شده در خطای استاندارد (standard error)\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 بررسی کنید.