.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "OPAM ADMIN-LINT" 1 "" "Opam admin 2.5.2" "Opam admin Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
.P
opam\-admin\-lint \- اجرای 'opam lint' و گزارش‌گیری از وضعیت کل مخزن
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBopam admin lint\fR [\fIOPTION\fR]… [\fIINT\fR]…
.SH "توضیحات (DESCRIPTION)"
.P
این دستور نتایج اعتبارسنجی (linting) را روی تمام فایل‌های یک مخزن گردآوری می‌کند\N'46' هشدارهایی و خطاهایی که باید نمایش داده شوند یا پنهان بمانند قابل انتخاب هستند\N'46'
.SH "آرگومان‌ها (ARGUMENTS)"
.TP 4
\fIINT\fR
فقط نمایش این هشدارها
.SH "گزینه‌ها (OPTIONS)"
.TP 4
\fB\N'45'i\fR \fIINT\fR, \fB\N'45'\N'45'ignore\N'45'packages\fR=\fIINT\fR
نادیده گرفتن بسته‌هایی که یکی از این هشدارها یا خطاها را دارند\N'46'
.TP 4
\fB\N'45'l\fR, \fB\N'45'\N'45'list\fR
تنها فهرست کردن نام بسته‌ها، بدون نمایش جزئیات هشدار
.TP 4
\fB\N'45's\fR, \fB\N'45'\N'45'short\fR
تنها چاپ بسته‌ها و شماره‌های هشدار/خطا، بدون ارائه توضیحات
.TP 4
\fB\N'45'W\fR, \fB\N'45'\N'45'warn\N'45'error\fR
بازگرداندن وضعیت شکست روی هرگونه هشدار، نه فقط روی خطاها
.TP 4
\fB\N'45'x\fR \fIINT\fR, \fB\N'45'\N'45'exclude\fR=\fIINT\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 (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
تعیین ترجیحات کاربر (\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امین فراخوانی حل‌کننده در طول اجرای 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 آن را روی ۱ تنظیم می‌کند)\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
پاسخ منفی (no) به تمامی پرسش‌های yes/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
هنگام به‌روزرسانی بسته‌های متصل به یک دایرکتوری محلی تحت سیستم کنترل نسخه، به‌روزرسانی بر مبنای وضعیت کاری فعلی سورس آن‌ها صورت می‌گیرد نه آخرین کامیت ثبت‌شده یا رفرنسی که به آن اشاره می‌کنند\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) به تمام پرسش‌های yes/no در 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 ترجیحات (\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' این عمل برخی مراحل پایانی را نادیده می‌گیرد و ممکن است در دسترسی به ردیابی پشته (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') به برخی حل‌کننده‌ها امکان می‌دهد که در صورت اتمام مهلت زمانی، همچنان پاسخی ارائه کنند؛ اگرچه پاسخ همچنان منسجم باقی می‌ماند، اما تضمینی وجود ندارد که با معیارهای بهینه‌سازی مورد انتظار تطابق داشته باشد\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 اولویت‌های کاربر (\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' است که از لوکال سیستم تشخیص داده می‌شود\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' در صورتی که دستور یافت نشود یا قابل اجرا نباشد مقدار ۱۲۷ و در غیر این صورت مقدار خروج خود دستور را برمی‌گرداند\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
شکست حل‌کننده\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
.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