.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "OPAM ADMIN-CHECK" 1 "" "Opam admin 2.5.2" "Opam admin Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
opam\-admin\-check \- اجرای برخی بررسی‌های سازگاری روی یک مخزن
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBopam admin check\fR [\fIOPTION\fR]…
.SH "توضیحات (DESCRIPTION)"
.P
این دستور بررسی‌های سازگاری و یکپارچگی را روی یک مخزن اجرا کرده و گزارشی را در stdout چاپ می‌کند\N'46' این بررسی‌ها شامل بسته‌های غیرقابل‌نصب (برای نمونه به دلیل وابستگی ناموجود) و چرخه‌های وابستگی است\N'46' فیلد \N'39'available\N'39' برای این بررسی‌ها نادیده گرفته می‌شود؛ یعنی فرض بر این است که تمام بسته‌ها در دسترس هستند\N'46' به‌طور پیش‌فرض، تمام بررسی‌ها اجرا می‌شوند\N'46'
.SH "گزینه‌ها (OPTIONS)"
.TP 4
\fB\N'45'\N'45'cycles\fR
انجام بررسی چرخه‌ها (و غیرفعال‌سازی سایر بررسی‌ها به‌طور پیش‌فرض)
.TP 4
\fB\N'45'\N'45'installability\fR
انجام بررسی قابلیت نصب (و غیرفعال‌سازی سایر بررسی‌ها به‌طور پیش‌فرض)
.TP 4
\fB\N'45'\N'45'obsolete\fR
تحلیل و بررسی برای یافتن بسته‌های منسوخ‌شده
.TP 4
\fB\N'45's\fR, \fB\N'45'\N'45'short\fR
تنها نمایش فهرستی از بسته‌های غیرقابل‌نصب
.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 در دسترس نبود، بنابراین برای انتخاب CLI نسخهٔ 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
نادیده گرفتن پین‌های اضافی مورد نیاز بسته‌هایی که چه به‌صورت دستی با \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
پاسخ خیر (no) به تمام پرسش‌های بله/خیر 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' برای مثال هنگام فراخوانی از اسکریپت‌های تکمیل خودکار مفید است\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
پاسخ بله (yes) به تمام پرسش‌های بله/خیر 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، اما مخصوص اصلاح و نصب مجدد\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'
.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 صرفاً آن را نادیده می‌گیرد)، و از `\N'45'\N'45'cli=2\N'46'1\N'39' برای نسخه‌های 2\N'46'1 (یا جدیدتر) بهره ببرید، چرا که کنترل تجزیهٔ نحو از طریق یک متغیر محیطی شکننده است\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 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'