.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "OPAM ADMIN-FILTER" 1 "" "Opam admin 2.5.2" "Opam admin Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
.P
opam admin\-filter \- پالایش یک مخزن برای نگه‌داشتن تنها بسته‌های انتخاب‌شده
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBopam admin filter\fR [\fB\N'45'\N'45'dry\N'45'run\fR] [\fB\N'45'\N'45'environment\fR=\fIVAR=VALUE[,VAR=VALUE]\fR] [\fB\N'45'\N'45'remove\fR] [\fIOPTION\fR]… [\fIPATTERNS\fR]…
.SH "توضیحات (DESCRIPTION)"
.P
این دستور تمامی تعاریف بسته‌هایی را که با معیارهای جستجو (که مشابه \N'39'opam admin list\N'39' مشخص می‌شوند) مطابقت ندارند، از مخزن حذف می‌کند\N'46'
.SH "انتخاب‌گرهای حساس به ترتیب (ORDER-SENSIBLE SELECTORS)"
.TP 4
\fB\N'45'a\fR, \fB\N'45'\N'45'available\fR
تنها بسته‌هایی را فهرست می‌کند که با توجه به \fBenvironment\fR تعریف‌شده در دسترس هستند\N'46' بدون \fB\N'45'\N'45'environment\fR، این گزینه شامل هر بسته‌ای می‌شود که در دسترس بودن آن در این نقطه قابل حل‌وفصل نباشد\N'46'
.TP 4
\fB\N'45'A\fR, \fB\N'45'\N'45'all\fR
شامل همه بسته‌ها، حتی بسته‌های نصب‌نشده یا غیرقابل‌دسترس
.TP 4
\fB\N'45'\N'45'installable\fR
تنها بسته‌هایی را فهرست می‌کند که با توجه به \fBenvironment\fR تعریف‌شده قابل نصب هستند (این گزینه حل‌کننده را فرامی‌خواند و ممکن است هزینه‌برتر باشد؛ بسته‌ای که به یک بسته غیرقابل‌دسترس وابسته است ممکن است در دسترس باشد، اما هرگز قابل نصب نیست)
.TP 4
\fB\N'45'\N'45'latests\N'45'only\fR
تنها آخرین نسخه از هر بسته را فهرست می‌کند\N'46'
.SH "آرگومان‌ها (ARGUMENTS)"
.TP 4
\fIPATTERNS\fR
الگوهای بسته با الگوهای عام (globs)\N'46' تطبیق با \fBNAME\fR یا \fBNAME\N'46'VERSION\fR
.SH "گزینه‌ها (OPTIONS)"
.TP 4
\fB\N'45'\N'45'dry\N'45'run\fR
فهرست کردن دستورهای حذف، بدون اجرای واقعی آن‌ها
.TP 4
\fB\N'45'\N'45'environment\fR=\fIVAR=VALUE[,VAR=VALUE]\fR
استفاده از محیط opam داده‌شده در قالب فهرستی از انتساب‌های \N'39'var=value\N'39' جداشده با ویرگول هنگام حل متغیرها\N'46' این گزینه برای مثال هنگام محاسبه بسته‌های موجود به کار می‌رود: اگر تعریف نشده باشد، در دسترس بودن بسته‌ها به محض این‌که نتوان آن را صرفاً از روی متغیرهای تعریف‌شده سراسری حل کرد، فرض انگاشته می‌شود\N'46' توجه داشته باشید که مگر در صورت بازنویسی، متغیرهایی مانند \N'39'root\N'39' یا \N'39'opam\N'45'version\N'39' ممکن است از نصب فعلی opam گرفته شوند\N'46' هر آنچه در \fI~/\N'46'opam/config\fR تعریف شده است همواره نادیده گرفته می‌شود\N'46'
.TP 4
\fB\N'45'\N'45'remove\fR
وارونه کردن رفتار؛ حذف بسته‌های منطبق و نگه‌داشتن بسته‌هایی که مطابقت ندارند\N'46'
.SH "گزینه‌های انتخاب بسته (PACKAGE SELECTION OPTIONS)"
.TP 4
\fB\N'45'\N'45'coinstallable\N'45'with\fR=\fIPACKAGES\fR
تنها فهرست کردن بسته‌هایی که با تمام موارد \fBPACKAGES\fR سازگار هستند\N'46'
.TP 4
\fB\N'45'\N'45'conflicts\N'45'with\fR=\fIPACKAGES\fR
فهرست کردن بسته‌هایی که با حداقل یکی از بسته‌های فهرست داده‌شده تداخل اعلام کرده‌اند\N'46' این شامل تداخل‌های تعریف‌شده از طرف بسته‌های موجود در فهرست، از طرف بسته دیگر، یا از طریق فیلد مشترک \fBconflict\N'45'class:\fR می‌شود\N'46'
.TP 4
\fB\N'45'\N'45'depends\N'45'on\fR=\fIPACKAGES\fR
تنها بسته‌هایی را فهرست می‌کند که به یکی از موارد \fBPACKAGES\fR (جداشده با ویرگول) وابسته هستند\N'46'
.TP 4
\fB\N'45'\N'45'depopts\fR
شامل کردن وابستگی‌های اختیاری در درخواست‌های وابستگی\N'46'
.TP 4
\fB\N'45'\N'45'dev\fR
شامل کردن بسته‌های توسعه در وابستگی‌ها\N'46'
.TP 4
\fB\N'45'\N'45'field\N'45'match\fR=\fIFIELD:PATTERN\fR
پالایش بسته‌هایی که دارای تطابق با \fIPATTERN\fR در \fIFIELD\fR داده‌شده هستند
.TP 4
\fB\N'45'\N'45'has\N'45'flag\fR=\fIFLAG\fR
تنها شامل بسته‌هایی می‌شود که پرچم داده‌شده برای آن‌ها تنظیم شده باشد\N'46' پرچم‌های بسته یکی از این موارد هستند: \fBlight\N'45'uninstall\fR \fBverbose\fR \fBplugin\fR \fBcompiler\fR \fBconf\fR
.TP 4
\fB\N'45'\N'45'has\N'45'tag\fR=\fITAG\fR
تنها شامل بسته‌هایی می‌شود که برچسب داده‌شده را دارند
.TP 4
\fB\N'45'\N'45'nobuild\fR
مستثنی کردن وابستگی‌های ساخت (به‌طور پیش‌فرض لحاظ می‌شوند)\N'46'
.TP 4
\fB\N'45'\N'45'or\fR
به جای انتخاب بسته‌هایی که با \fIتمام\fR معیارها مطابقت دارند، بسته‌هایی را انتخاب می‌کند که با \fIهر کدام\fR از آن‌ها تطابق داشته باشند
.TP 4
\fB\N'45'\N'45'post\fR
شامل کردن وابستگی‌هایی که با برچسب \fIpost\fR مشخص شده‌اند\N'46'
.TP 4
\fB\N'45'\N'45'recursive\fR
همراه با `\N'45'\N'45'depends\N'45'on\N'39' و `\N'45'\N'45'required\N'45'by\N'39'، تمام وابستگی‌های ترایا (transitive) را به جای وابستگی‌های مستقیم نمایش می‌دهد\N'46'
.TP 4
\fB\N'45'\N'45'required\N'45'by\fR=\fIPACKAGES\fR
تنها وابستگی‌های موارد \fBPACKAGES\fR (جداشده با ویرگول) را فهرست می‌کند\N'46'
.TP 4
\fB\N'45'\N'45'resolve\fR=\fIPACKAGES\fR
محدود کردن به یک راهکار برای نصب \fIPACKAGES\fR (جداشده با ویرگول)، \fIیعنی\fR یک مجموعه سازگار از بسته‌ها شامل آن‌ها\N'46' این با `\N'45'\N'45'required\N'45'by \N'45'\N'45'recursive` تفاوت ظریفی دارد که قابل پیش‌بینی‌تر است و ناموفق نمی‌شود، اما همه وابستگی‌ها را به صورت مستقل و بدون تضمین سازگاری فهرست می‌کند\N'46' بدون `\N'45'\N'45'installed`، پاسخ مستقل و قائم‌به‌ذات از نصب فعلی است\N'46' با `\N'45'\N'45'installed\N'39'، مقدار بر اساس مجموعه بسته‌های نصب‌شده فعلی محاسبه می‌شود\N'46' گزینه `\N'45'\N'45'no\N'45'switch` راهکار را بیش از پیش از بسته‌های پین‌شده کنونی، معماری و نسخه کامپایلر مستقل می‌سازد\N'46' ترکیب این گزینه با `\N'45'\N'45'depopts\N'39' پشتیبانی نمی‌شود\N'46'
.TP 4
\fB\N'45't\fR, \fB\N'45'\N'45'with\N'45'test\fR, \fB\N'45'\N'45'test\fR
شامل کردن وابستگی‌های صرفاً آزمایشی\N'46'
.TP 4
\fB\N'45'\N'45'with\N'45'dev\N'45'setup\fR
شامل کردن وابستگی‌های صرفاً مخصوص توسعه‌دهنده\N'46'
.TP 4
\fB\N'45'\N'45'with\N'45'doc\fR, \fB\N'45'\N'45'doc\fR
شامل کردن وابستگی‌های صرفاً مستنداتی\N'46'
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.P
این گزینه‌ها میان تمامی دستورها مشترک هستند\N'46'
.TP 4
\fB\N'45'\N'45'best\N'45'effort\fR
در صورت عدم امکان نصب تمامی بسته‌های درخواستی، با شکست متوقف نشو: تلاش کن تا جای ممکن بیشترین تعداد بسته را نصب کنی\N'46' توجه داشته باشید که ممکن است همه حل‌کننده‌های خارجی از این گزینه پشتیبانی نکنند (نسخه‌های اخیر \fIaspcud\fR یا \fImccs\fR باید پشتیبانی کنند)\N'46' این معادل با تنظیم متغیر محیطی \fB$OPAMBESTEFFORT\fR است\N'46'
.TP 4
\fB\N'45'\N'45'cli\fR=\fIMAJOR\N'46'MINOR\fR (مقدار غایب=\fB2\N'46'5\fR)
استفاده از نحو و معانی رابط خط فرمان نسخه \fIMAJOR\N'46'MINOR\fR\N'46' برای هرگونه استفاده ماندگار از opam (اسکریپت‌ها، پست‌های وبلاگ و غیره)، هر نسخه‌ای از opam در همان سری MAJOR مانند نسخه MINOR مشخص‌شده رفتار خواهد کرد\N'46' این پرچم در opam 2\N'46'0 موجود نبود، بنابراین برای انتخاب 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
مشخص کردن \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-امین فراخوانی حل‌کننده در طول اجرای opam است\N'46'
.TP 4
\fB\N'45'\N'45'debug\fR
چاپ پیام‌های اشکال‌زدایی در stderr\N'46' این معادل با مقداردهی "true" به \fB$OPAMDEBUG\fR است\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' این معادل با تنظیم "true" برای \fB$OPAMNO\fR است\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 بار معادل با مقداردهی "\fIn\fR" به \fB$OPAMVERBOSE\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' این معادل با تنظیم "true" برای \fB$OPAMYES\fR است\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' مقدار پیش‌فرض به نسخه حل‌کننده (solver) بستگی دارد؛ از `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 حداکثر تعداد کارگرهای موازی (parallel workers) برای اجرا را تعیین می‌کند\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 به هر سوال پرسیده‌شده پاسخ منفی می‌دهد، گزینه‌های `\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' کارایی کمتری دارد، اما ممکن است به اشکال‌زدایی مشکلات حل‌کننده (solver) کمک کند\N'46'
.P
\fIOPAMREPOSITORYTARRING\fR مخازن را به صورت داخلی به عنوان فایل‌های tar\N'46'gz ذخیره می‌کند\N'46' این قابلیت می‌تواند روی سامانه‌های فایلی که توانایی مناسبی در پیمایش درخت‌های بزرگ فایل ندارند اما حافظه موقت خوبی در /tmp دارند بسیار سریع‌تر باشد\N'46' با این حال در حالت کلی کندتر است\N'46'
.P
\fIOPAMREQUIRECHECKSUMS\fR گزینه `\N'45'\N'45'require\N'45'checksums\N'39' را در صورت در دسترس بودن فعال می‌کند (برای مثال برای `opam install\N'39')\N'46'
.P
\fIOPAMRETRIES\fR تعداد دفعات تلاش مجدد پیش از اعلام شکست در دانلود را تعیین می‌کند\N'46'
.P
\fIOPAMREUSEBUILDDIR\fR گزینه `\N'45'\N'45'reuse\N'45'build\N'45'dir\N'39' را ببینید\N'46'
.P
\fIOPAMROOT\fR گزینه `\N'45'\N'45'root\N'39' را ببینید\N'46' این متغیر به طور خودکار توسط `opam env \N'45'\N'45'root=DIR \N'45'\N'45'set\N'45'root\N'39' تنظیم می‌شود\N'46'
.P
\fIOPAMROOTISOK\fR هنگام اجرا با دسترسی ریشه (root) هشداری صادر نمی‌کند\N'46'
.P
\fIOPAMSAFE\fR گزینه `\N'45'\N'45'safe\N'39' را ببینید\N'46'
.P
\fIOPAMSHOW\fR گزینه `\N'45'\N'45'show\N'39' را ببینید\N'46'
.P
\fIOPAMSKIPUPDATE\fR گزینه `\N'45'\N'45'skip\N'45'updates\N'39' را ببینید\N'46'
.P
\fIOPAMSKIPVERSIONCHECKS\fR برخی از بررسی‌های نسخه را نادیده می‌گیرد\N'46' ناامن است، فقط برای آزمایش سازگاری استفاده شود\N'46'
.P
\fIOPAMSOLVERALLOWSUBOPTIMAL\fR (پیش‌فرض `true\N'39') به برخی حل‌کننده‌ها اجازه می‌دهد در صورت رسیدن به مهلت زمانی (timeout)، باز هم یک راه‌حل برگردانند؛ در حالی که تضمین می‌شود راه‌حل پایدار و سازگار باشد، در این حالت هیچ تضمینی وجود ندارد که با معیارهای بهینه‌سازی مورد انتظار مطابقت داشته باشد\N'46' اگر `true\N'39' باشد، opam با یک هشدار ادامه می‌دهد؛ اگر `false\N'39' باشد، اتمام مهلت زمانی یک خطا در نظر گرفته می‌شود\N'46' در حال حاضر فقط بخش پشتیبان builtin\N'45'z3 این حالت تنزل‌یافته را مدیریت می‌کند\N'46'
.P
\fIOPAMSOLVERTIMEOUT\fR مهلت زمانی مجاز برای حل‌کننده را تغییر می‌دهد\N'46' پیش‌فرض 60\N'46'0 است، برای نامحدود روی 0 تنظیم کنید\N'46' توجه داشته باشید که ممکن است همه حل‌کننده‌ها از این گزینه پشتیبانی نکنند\N'46'
.P
\fIOPAMSOLVERTOLERANCE\fR میزان رواداری نسبت به انتخاب یک راه‌حل بهینه‌نشده توسط حل‌کننده را تغییر می‌دهد (به عنوان مثال ممکن است بسته‌های قدیمی را واکشی کند)\N'46' مقادیر معمول از 0\N'46'0 (بهترین راه‌حل شناخته‌شده برای حل‌کننده) تا 1\N'46'0 (راه‌حل بهینه‌نشده) متغیر است\N'46' پیش‌فرض 0\N'46'0 است\N'46' این گزینه در صورتی مفید است که حل‌کننده نتواند در یک زمان معقول راه‌حلی پیدا کند (به \fB$OPAMSOLVERTIMEOUT\fR مراجعه کنید)\N'46' توجه داشته باشید که ممکن است همه حل‌کننده‌ها از این گزینه پشتیبانی نکنند\N'46'
.P
\fIOPAMSTATS\fR در \fB2\N'46'4\fR حذف شد\N'46'
.P
\fIOPAMSTATUSLINE\fR یک خط وضعیت پویا را نمایش می‌دهد که وضعیت جاری را در پایانه نشان می‌دهد\N'46' (یکی از مقادیر \fBalways\fR، \fBnever\fR یا \fBauto\fR)
.P
\fIOPAMSTRICT\fR در صورت بروز ناسازگاری‌ها (خواندن فایل، وارد کردن switch و غیره\N'46') با خطا متوقف می‌شود\N'46'
.P
\fIOPAMSWITCH\fR گزینه `\N'45'\N'45'switch\N'39' را ببینید\N'46' به طور خودکار توسط `opam env \N'45'\N'45'switch=SWITCH \N'45'\N'45'set\N'45'switch\N'39' تنظیم می‌شود\N'46'
.P
\fIOPAMUNLOCKBASE\fR گزینه نصب `\N'45'\N'45'unlock\N'45'base\N'39' را ببینید\N'46'
.P
\fIOPAMUPGRADECRITERIA\fR اولویت‌های (\fIpreferences\fR) کاربر را برای حل وابستگی هنگام انجام ارتقا مشخص می‌کند\N'46' در صورت تنظیم هر دو، هنگام ارتقا بر \fIOPAMCRITERIA\fR ارجحیت دارد\N'46' همچنین گزینه \N'45'\N'45'criteria را ببینید\N'46'
.P
\fIOPAMUSEINTERNALSOLVER\fR گزینه `\N'45'\N'45'use\N'45'internal\N'45'solver\N'39' را ببینید\N'46'
.P
\fIOPAMUSEOPENSSL\fR در \fB2\N'46'2\fR حذف شد\N'46'
.P
\fIOPAMUTF8\fR استفاده از نویسه‌های UTF8 در خروجی (یکی از مقادیر \fBalways\fR، \fBnever\fR یا \fBauto\fR)\N'46' به طور پیش‌فرض `auto\N'39' است که بر اساس متغیرهای محلی (locale) تعیین می‌شود\N'46'
.P
\fIOPAMUTF8MSGS\fR استفاده از نویسه‌های گسترش‌یافته UTF8 (نمادهای شتر) در پیام‌های opam\N'46' متضمن \fIOPAMUTF8\fR است\N'46' این متغیر به طور پیش‌فرض فقط در macOS فعال است\N'46'
.P
\fIOPAMVALIDATIONHOOK\fR در صورت تنظیم، از دستور `%{hook%}\N'39' برای اعتبارسنجی بروزرسانی مخزن opam استفاده می‌کند\N'46'
.P
\fIOPAMVERBOSE\fR گزینه `\N'45'\N'45'verbose\N'39' را ببینید\N'46'
.P
\fIOPAMVERBOSEON\fR گزینه \N'45'\N'45'verbose\N'45'on را ببینید
.P
\fIOPAMVERSIONLAGPOWER\fR استفاده نشود\N'46'
.P
\fIOPAMWITHDEVSETUP\fR گزینه نصب `\N'45'\N'45'with\N'45'dev\N'45'setup\N'39' را ببینید\N'46'
.P
\fIOPAMWITHDOC\fR گزینه نصب `\N'45'\N'45'with\N'45'doc\N'39' را ببینید\N'46'
.P
\fIOPAMWITHTEST\fR گزینه نصب `\N'45'\N'45'with\N'45'test را ببینید\N'46'
.P
\fIOPAMWORKINGDIR\fR گزینه `\N'45'\N'45'working\N'45'dir\N'39' را ببینید\N'46'
.P
\fIOPAMYES\fR گزینه‌های `\N'45'\N'45'yes\N'39' و `\N'45'\N'45'confirm\N'45'level` را ببینید\N'46' \fBOPAMYES\fR بر \fBOPAMNO\fR اولویت دارد و در صورت تنظیم بودن \fBOPAMCONFIRMLEVEL\fR نادیده گرفته می‌شود\N'46'
.P
\fIOPAMVAR_var\fR محتویات متغیر \fIvar\fR را هنگام جایگزینی رشته‌های `%{var}%` در فایل‌های `opam` بازنویسی می‌کند\N'46'
.P
\fIOPAMVAR_package_var\fR محتویات متغیر \fIpackage:var\fR را هنگام جایگزینی رشته‌های `%{package:var}%` در فایل‌های `opam` بازنویسی می‌کند\N'46'.SH "نسخه خط فرمان (CLI VERSION)"
.P
همه اسکریپت‌ها و فراخوانی‌های برنامه‌نویسی‌شده opam باید از `\N'45'\N'45'cli\N'39' استفاده کنند تا اطمینان حاصل شود که با نسخه‌های بعدی کلاینت opam بدون مشکل و یکپارچه کار می‌کنند\N'46' علاوه بر این، پست‌های وبلاگ یا سایر مستندات نیز می‌توانند از آن بهره‌مند شوند، چرا که مانع از منسوخ شدن اطلاعات می‌شود\N'46'
.P
اگرچه opam تنها از ریشه‌ها (\fI~/\N'46'opam/\fR) برای نسخه فعلی پشتیبانی می‌کند، اما سازگاری عقبرو را برای رابط خط فرمان خود فراهم می‌آورد\N'46'
.P
از آنجا که پشتیبانی از نسخه CLI تنها در opam 2\N'46'1 اضافه شد، از \fIOPAMCLI\fR برای انتخاب پشتیبانی 2\N'46'0 استفاده کنید (زیرا opam 2\N'46'0 صرفاً آن را نادیده می‌گیرد)، و از `\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)\N'46' حل‌کننده نتوانست پاسخی صحیح ارائه دهد\N'46' این وضعیت می‌تواند ناشی از یک حل‌کننده خارجی معیوب یا خطایی در پیکربندی حل‌کننده باشد\N'46'
.TP 4
99
خطای داخلی\N'46' مشکلی پیش آمد، احتمالاً ناشی از یک باگ در خود opam است\N'46'
.TP 4
130
وقفه توسط کاربر\N'46' سیگنال SIGINT دریافت شد، معمولاً به دلیل فشردن کلیدهای Ctrl\N'45'C توسط کاربر\N'46'
.TP 4
0
در صورت موفقیت\N'46'
.TP 4
123
در صورت خطاهای نامشخص گزارش‌شده در خطای استاندارد (stderr)\N'46'
.TP 4
124
در صورت بروز خطاهای تجزیه خط فرمان\N'46'
.TP 4
125
در صورت بروز خطاهای داخلی غیرمنتظره (باگ‌ها)\N'46'
.SH "مستندات بیشتر (FURTHER DOCUMENTATION)"
.P
به https://opam\N'46'ocaml\N'46'org/doc مراجعه کنید\N'46'
.SH "نویسندگان (AUTHORS)"
.P
David Allsopp <david@tarides\N'46'com>
.sp -1
.P
Vincent Bernardoff <vb@luminar\N'46'eu\N'46'org>
.sp -1
.P
Raja Boujbel <raja\N'46'boujbel@ocamlpro\N'46'com>
.sp -1
.P
Kate Deplaix <kit\N'45'ty\N'45'kate@outlook\N'46'com>
.sp -1
.P
Roberto Di Cosmo <roberto@dicosmo\N'46'org>
.sp -1
.P
Thomas Gazagnaire <thomas@gazagnaire\N'46'org>
.sp -1
.P
Louis Gesbert <louis\N'46'gesbert@ocamlpro\N'46'com>
.sp -1
.P
Fabrice Le Fessant <Fabrice\N'46'Le_fessant@inria\N'46'fr>
.sp -1
.P
Anil Madhavapeddy <anil@recoil\N'46'org>
.sp -1
.P
Guillem Rieu <guillem\N'46'rieu@ocamlpro\N'46'com>
.sp -1
.P
Ralf Treinen <ralf\N'46'treinen@pps\N'46'jussieu\N'46'fr>
.sp -1
.P
Frederic Tuong <tuong@users\N'46'gforge\N'46'inria\N'46'fr>
.SH "همچنین ببینید (SEE ALSO)"
.P
opam admin(1)
.SH "گزارش باگ‌ها (BUGS)"
.P
گزارش‌های باگ را در https://github\N'46'com/ocaml/opam/issues بررسی کنید\N'46'