.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "OPAM-LIST" 1 "" "Opam 2.5.2" "Opam Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
.P
opam\-list \- نمایش فهرست بسته‌های موجود\N'46'
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBopam list\fR [\fB\N'45'\N'45'check\fR] [\fB\N'45'\N'45'no\N'45'depexts\fR] [\fB\N'45'\N'45'silent\fR] [\fIOPTION\fR]… [\fIPATTERNS\fR]…
.SH "توضیحات (DESCRIPTION)"
.P
فهرست کردن بسته‌های گزینش‌شده opam\N'46'
.P
بدون آرگومان، این دستور فهرست بسته‌های نصب‌شده فعلی را نمایش می‌دهد\N'46' با مشخص کردن آرگومان‌های الگو، تمام بسته‌های موجودی را که با یکی از الگوها مطابقت دارند فهرست می‌کند\N'46'
.P
مگر در صورت استفاده از گزینه \fB\N'45'\N'45'short\fR، قالب خروجی در هر سطر یک بسته را نمایش می‌دهد و هر سطر شامل نام بسته، نسخه نصب‌شده یا `\N'45'\N'45'\N'39' در صورت نصب نبودن بسته، و یک توضیح کوتاه است\N'46' در حالت رنگی، زیر نام بسته‌هایی که به‌صورت دستی نصب شده‌اند (برخلاف بسته‌هایی که به‌دلیل وابستگی‌ها به‌طور خودکار نصب شده‌اند) خط کشیده می‌شود\N'46'
.P
برای مشاهده تمام روش‌های انتخاب بسته‌ها جهت نمایش، بخش \fBگزینه‌های انتخاب بسته (PACKAGE SELECTION OPTIONS)\fR و برای شخصی‌سازی قالب خروجی، بخش \fBOUTPUT FORMAT OPTIONS\fR را ببینید\N'46'
.P
برای توضیحات دقیق‌تر درباره بسته‌ها، دستور \fBopam show\fR را ببینید\N'46' برای قابلیت‌های جستجوی پیشرفته درون فرا‌داده‌های بسته‌ها، دستور \fBopam search\fR را ببینید\N'46'
.SH "آرگومان‌ها (ARGUMENTS)"
.TP 4
\fIPATTERNS\fR
الگوهای بسته با نویسه‌های عام (globs)\N'46' مگر اینکه \fB\N'45'\N'45'search\fR مشخص شده باشد، این الگوها با \fBNAME\fR یا \fBNAME\N'46'VERSION\fR مطابقت داده می‌شوند\N'46'
.SH "انتخاب‌گرهای حساس به ترتیب (ORDER-SENSIBLE SELECTORS)"
.P
این گزینه‌ها به ترتیبی که به دستور داده می‌شوند حساس هستند\N'46' برای مثال: \fB\N'45'\N'45'available \N'45'\N'45'latests\N'45'only\fR ابتدا همه بسته‌های موجود را فهرست کرده و سپس تنها آخرین نسخه از بسته‌ها را در آن مجموعه برمی‌گزیند؛ در حالی که \fB\N'45'\N'45'latests\N'45'only \N'45'\N'45'available\fR ابتدا همه آخرین نسخه‌های بسته‌ها را فهرست می‌کند و سپس تنها مواردی را که در آن مجموعه در دسترس هستند نشان می‌دهد\N'46'
.TP 4
\fB\N'45'a\fR, \fB\N'45'\N'45'available\fR
تنها بسته‌هایی را فهرست می‌کند که در سیستم فعلی موجود هستند
.TP 4
\fB\N'45'A\fR, \fB\N'45'\N'45'all\fR
شامل همه بسته‌ها، حتی بسته‌های نصب‌نشده یا ناموجود
.TP 4
\fB\N'45'\N'45'base\fR
در نسخه \fB2\N'46'1\fR حذف شده است، به جای آن از \fI\N'45'\N'45'invariant\fR استفاده کنید\N'46'
.TP 4
\fB\N'45'i\fR, \fB\N'45'\N'45'installed\fR
تنها بسته‌های نصب‌شده را فهرست می‌کند\N'46' در صورتی که هیچ آرگومان دیگری داده نشود، این حالت پیش‌فرض است
.TP 4
\fB\N'45'\N'45'installable\fR
تنها بسته‌هایی را فهرست می‌کند که روی switch فعلی قابل نصب هستند (این گزینه حل‌کننده وابستگی‌ها را فراخوانی می‌کند و ممکن است هزینه‌برتر باشد؛ بسته‌ای که به یک بسته ناموجود وابسته است ممکن است در دسترس باشد، اما هرگز قابل نصب نیست)
.TP 4
\fB\N'45'\N'45'invariant\fR
تنها پایه تغییرناپذیر switch فعلی (یعنی بسته‌های invariant) را فهرست می‌کند
.TP 4
\fB\N'45'\N'45'latests\N'45'only\fR
تنها آخرین نسخه از هر بسته را فهرست می‌کند\N'46'
.TP 4
\fB\N'45'\N'45'pinned\fR
تنها بسته‌های پین‌شده (pinned) را فهرست می‌کند
.TP 4
\fB\N'45'\N'45'roots\fR, \fB\N'45'\N'45'installed\N'45'roots\fR
تنها بسته‌هایی را فهرست می‌کند که صراحتاً نصب شده‌اند، بدون در نظر گرفتن بسته‌هایی که به عنوان وابستگی نصب شده‌اند
.SH "گزینه‌های انتخاب بسته (PACKAGE SELECTION OPTIONS)"
.P
این گزینه‌ها بدون توجه به ترتیبی که به دستور داده شده‌اند، همیشه با یک ترتیب مشخص و ثابت به دستور اعمال می‌شوند\N'46'
.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'no\N'45'switch\fR
فهرست کردن مواردی که از مخازن در دسترس هستند، بدون در نظر گرفتن وضعیت switch فعلی (یا هر switch دیگری) (بسته‌های نصب‌شده، پین‌شده و غیره\N'46')
.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'owns\N'45'file\fR=\fIFILE\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'repos\fR=\fIREPOS\fR
تنها شامل بسته‌هایی می‌شود که مبدأ آن‌ها یکی از مخازن داده‌شده باشد (مگر اینکه \fIno\N'45'switch\fR نیز مشخص شده باشد، این گزینه بسته‌های پین‌شده را مستثنی می‌کند)\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'\N'45'search\fR
الگوهای \fIPATTERNS\fR را با توضیحات کامل بسته‌ها مطابقت می‌دهد و تطابق همه آن‌ها را الزامی می‌کند، به جای اینکه حداقل یکی از آن‌ها با نام بسته مطابقت داشته باشد (مگر اینکه \fB\N'45'\N'45'or\fR نیز مشخص شده باشد)\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
شامل کردن وابستگی‌های فقط آزمایشی (test-only)\N'46'
.TP 4
\fB\N'45'\N'45'with\N'45'dev\N'45'setup\fR
شامل کردن وابستگی‌های مخصوص توسعه‌دهنده (dev-only)\N'46'
.TP 4
\fB\N'45'\N'45'with\N'45'doc\fR, \fB\N'45'\N'45'doc\fR
شامل کردن وابستگی‌های فقط مستنداتی (doc-only)\N'46'.SH "گزینه‌های قالب خروجی (OUTPUT FORMAT OPTIONS)"
.TP 4
\fB\N'45'\N'45'columns\fR=\fICOLUMNS\fR
انتخاب ستون‌ها برای نمایش از میان: \fBname\fR، \fBversion\fR، \fBpackage\fR، \fBsynopsis\fR، \fBsynopsis\N'45'or\N'45'target\fR، \fBdescription\fR، \fB<field>:\fR، \fBinstalled\N'45'version\fR، \fBpin\fR، \fBsource\N'45'hash\fR، \fBopam\N'45'file\fR، \fBall\N'45'installed\N'45'versions\fR، \fBavailable\N'45'versions\fR، \fBall\N'45'versions\fR، \fBrepository\fR، \fBinstalled\N'45'files\fR، \fBvc\N'45'ref\fR، \fBdepexts\fR\N'46' مقدار پیش‌فرض در صورت حضور \fI\N'45'\N'45'short\fR برابر با \fBname\fR، و در غیر این صورت \fBname\fR، \fBinstalled\N'45'version\fR و \fBsynopsis\N'45'or\N'45'target\fR است\N'46'
.TP 4
\fB\N'45'e\fR، \fB\N'45'\N'45'external\fR، \fB\N'45'\N'45'depexts\fR
به‌جای نمایش بسته‌ها، وابستگی‌های خارجی آن‌ها که با سیستم فعلی مرتبط هستند را نمایش می‌دهد\N'46' این گزینه سایر گزینه‌های نمایش را مستثنی می‌کند\N'46' به‌جای استفاده مستقیم از این گزینه، احتمالاً بهتر است به سراغ افزونه‌ی `depext\N'39' بروید که از مدیر بسته‌ی سیستم شما برای مدیریت نصب وابستگی‌ها استفاده خواهد کرد\N'46' دستور `opam depext\N'39' را اجرا کنید\N'46'
.TP 4
\fB\N'45'\N'45'normalise\fR
چاپ مقادیر فیلدهای opam به‌صورت استانداردسازی‌شده (نرمال‌شده)\N'46'
.TP 4
\fB\N'45'S\fR، \fB\N'45'\N'45'sort\fR
مرتب‌سازی بسته‌ها به ترتیب وابستگی (یعنی ترتیبی که در آن بتوان آن‌ها را به‌صورت جداگانه نصب کرد)\N'46'
.TP 4
\fB\N'45's\fR، \fB\N'45'\N'45'short\fR
سرایند را چاپ نمی‌کند و ستون‌های پیش‌فرض را تنها به \fBname\fR تنظیم می‌کند\N'46' اگر به گنجاندن نگارش‌های بسته نیاز دارید، به‌جای آن از \fB\N'45'\N'45'columns=package\fR استفاده کنید\N'46'
.TP 4
\fB\N'45'\N'45'separator\fR=\fISTRING\fR (absent=\fB \fR)
تنظیم رشته‌ی جداکننده‌ی ستون‌ها\N'46'
.TP 4
\fB\N'45'V\fR، \fB\N'45'\N'45'all\N'45'versions\fR
به‌طور معمول، هنگامی که چندین نگارش از یک بسته مطابقت داشته باشند، تنها یک نگارش در خروجی نمایش داده می‌شود (نگارش نصب‌شده، نگارش سنجاق‌شده (pinned)، یا در صورت عدم وجود، بالاترین نگارش در دسترس یا بالاترین نگارش)\N'46' این پرچم این رفتار را غیرفعال کرده و همه‌ی نگارش‌های منطبق را نشان می‌دهد\N'46' همچنین قالب پیش‌فرض نمایش را تغییر می‌دهد تا به‌جای تنها نام بسته‌ها، نگارش‌های بسته را نیز شامل شود (حتی هنگامی که \N'45'\N'45'short تنظیم شده باشد)\N'46' هنگامی که یک نام بسته‌ی منفرد و بدون الگو در خط فرمان ارائه شود، این پرچم به‌طور خودکار فعال می‌شود\N'46'
.TP 4
\fB\N'45'\N'45'vars\fR=\fI[VAR=STR,\N'46'\N'46'\N'46']\fR
تعریف مقیدسازی‌های متغیر داده‌شده\N'46' معمولاً همراه با \fB\N'45'\N'45'external\fR برای بازنویسی مقادیر \fIarch\fR، \fIos\fR، \fIos\N'45'distribution\fR، \fIos\N'45'version\fR و \fIos\N'45'family\fR کاربرد دارد\N'46'
.TP 4
\fB\N'45'\N'45'wrap\fR
شکستن خطوط طولانی (wrap)؛ حالت پیش‌فرض، کوتاه‌سازی (truncate) هنگام نمایش در ترمینال، یا حفظ آن به همان شکل در غیر این صورت است\N'46'
.SH "گزینه‌ها (OPTIONS)"
.TP 4
\fB\N'45'\N'45'check\fR
چیزی در خروجی نمی‌نویسد، در صورتی که فهرست خالی نباشد با کد بازگشتی 0 و در غیر این صورت با 1 خارج می‌شود\N'46'
.TP 4
\fB\N'45'\N'45'no\N'45'depexts\fR
غیرفعال کردن مدیریت وابستگی‌های خارجی برای پرس‌وجو\N'46' این گزینه می‌تواند برای گنجاندن بسته‌هایی که به دلیل عدم دسترسی به یک وابستگی سیستمی، به‌عنوان غیرقابل‌دسترس علامت‌گذاری شده‌اند استفاده شود\N'46'
.TP 4
\fB\N'45'\N'45'silent\fR
در نگارش \fB2\N'46'1\fR حذف شد، به‌جای آن از \fI\N'45'\N'45'check\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 (absent=\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-امین فراخوانی حل‌کننده در طول اجرای opam است\N'46'
.TP 4
\fB\N'45'\N'45'debug\fR
چاپ پیام‌های اشکال‌زدایی در stderr\N'46' این معادل با تنظیم \fB$OPAMDEBUG\fR روی "true" است\N'46'
.TP 4
\fB\N'45'\N'45'debug\N'45'level\fR=\fILEVEL\fR
مشابه \fB\N'45'\N'45'debug\fR، اما امکان تعیین سطح اشکال‌زدایی را فراهم می‌کند (\fB\N'45'\N'45'debug\fR آن را به 1 تنظیم می‌کند)\N'46' معادل با تنظیم \fB$OPAMDEBUG\fR روی یک عدد صحیح مثبت\N'46'
.TP 4
\fB\N'45'\N'45'git\N'45'version\fR
چاپ نگارش git مربوط به opam، در صورت تنظیم بودن (یعنی در صورتی که از یک نگارش توسعه استفاده می‌کنید)، و خروج\N'46'
.TP 4
\fB\N'45'\N'45'help\fR[=\fIFMT\fR] (default=\fBauto\fR)
نمایش این راهنما در قالب \fIFMT\fR\N'46' مقدار \fIFMT\fR باید یکی از \fBauto\fR، \fBpager\fR، \fBgroff\fR یا \fBplain\fR باشد\N'46' با انتخاب \fBauto\fR، هرگاه متغیر محیطی \fBTERM\fR برابر با \fBdumb\fR یا تعریف‌نشده باشد، قالب به‌صورت \fBpager\fR یا \fBplain\fR خواهد بود\N'46'
.TP 4
\fB\N'45'\N'45'ignore\N'45'pin\N'45'depends\fR
نادیده گرفتن سنجاق‌های (pins) اضافی مورد نیاز بسته‌هایی که چه به‌صورت دستی از طریق \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 در یک فایل ماشین‌خوان (computer-readable)\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'\N'45'no\N'45'self\N'45'upgrade\fR
در صورت وجود، opam خود را با فایل باینری جدیدتری که در \fBOPAMROOT/opam\fR یافت شود جایگزین می‌کند\N'46' این گزینه این رفتار را غیرفعال می‌کند\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
غیرفعال کردن تمامی حل‌کننده‌های خارجی و استفاده از حل‌کننده‌ی توکار (built-in) (این امر مستلزم آن است که 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) به تمام پرسش‌های بله/خیر 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 است، اما مختص به رفع اشکال (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' این کار اجرای برخی از نهایی‌سازها را لغو می‌کند و همچنین ممکن است به دریافت ردگیری‌های پشته (backtraces) قابل‌اعتمادتر کمک کند\N'46'
.P
\fIOPAMLOCKED\fR ترکیبی از گزینه‌های `\N'45'\N'45'locked\N'39' و `\N'45'\N'45'lock\N'45'suffix\N'39'\N'46'
.P
\fIOPAMLOGS\fR \fIlogdir\fR دایرکتوری گزارش‌ها را تعیین می‌کند، مقدار پیش‌فرض یک دایرکتوری موقت در /tmp است
.P
\fIOPAMMAKECMD\fR دستور make سیستمی مورد استفاده را مشخص می‌کند\N'46'
.P
\fIOPAMMERGEOUT\fR خروجی‌های فرایند را ادغام می‌کند، stderr روی stdout\N'46'
.P
\fIOPAMNO\fR به هر سؤالی پاسخ خیر می‌دهد، گزینه‌های `\N'45'\N'45'no` و `\N'45'\N'45'confirm\N'45'level` را ببینید\N'46' در صورت تنظیم بودن هر یک از \fBOPAMCONFIRMLEVEL\fR یا \fBOPAMYES\fR، مقدار \fBOPAMNO\fR نادیده گرفته می‌شود\N'46'
.P
\fIOPAMNOAGGREGATE\fR در دستور `opam admin check\N'39'، از تجمیع بسته‌ها جلوگیری می‌کند\N'46'
.P
\fIOPAMNOASPCUD\fR منسوخ شده است\N'46'
.P
\fIOPAMNOAUTOUPGRADE\fR ارتقای خودکار داخلی مخازن دارای قالب قدیمی به نسخه فعلی را هنگام \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 تعیین می‌کند که آیا هنگام الصاق (pinning) به یک مسیر محلی، سیستم‌های کنترل نسخه شناسایی شوند یا خیر\N'46' از نسخه 1\N'46'3\N'46'0 به طور پیش‌فرض فعال است\N'46'
.P
\fIOPAMPRECISETRACKING\fR ردیابی دقیق و ریزدانه‌ای دایرکتوری‌ها\N'46'
.P
\fIOPAMPREPRO\fR برای غیرفعال کردن پیش‌پردازش CUDF این مقدار را روی false قرار دهید\N'46' کارایی کمتری دارد، اما ممکن است به اشکال‌زدایی مشکلات حل‌کننده کمک کند\N'46'
.P
\fIOPAMREPOSITORYTARRING\fR مخازن را در داخل به صورت فایل‌های tar\N'46'gz ذخیره می‌کند\N'46' این ویژگی می‌تواند روی سیستم‌فایل‌هایی که در پیمایش درخت‌های بزرگ عملکرد خوبی ندارند اما دارای حافظه پنهان مناسب در /tmp هستند بسیار سریع‌تر باشد\N'46' با این حال در حالت کلی کندتر عمل می‌کند\N'46'
.P
\fIOPAMREQUIRECHECKSUMS\fR گزینه `\N'45'\N'45'require\N'45'checksums\N'39' را در صورت در دسترس بودن فعال می‌کند (مثلاً برای `opam install\N'39')\N'46'
.P
\fIOPAMRETRIES\fR تعداد دفعات تلاش مجدد قبل از شکست در دانلود را تعیین می‌کند\N'46'
.P
\fIOPAMREUSEBUILDDIR\fR گزینه `\N'45'\N'45'reuse\N'45'build\N'45'dir\N'39' را ببینید\N'46'
.P
\fIOPAMROOT\fR گزینه `\N'45'\N'45'root\N'39' را ببینید\N'46' این متغیر به طور خودکار توسط `opam env \N'45'\N'45'root=DIR \N'45'\N'45'set\N'45'root\N'39' تنظیم می‌شود\N'46'
.P
\fIOPAMROOTISOK\fR هنگام اجرا با کاربر ریشه (root) هشداری نمی‌دهد\N'46'
.P
\fIOPAMSAFE\fR گزینه `\N'45'\N'45'safe\N'39' را ببینید\N'46'
.P
\fIOPAMSHOW\fR گزینه `\N'45'\N'45'show\N'39' را ببینید\N'46'
.P
\fIOPAMSKIPUPDATE\fR گزینه `\N'45'\N'45'skip\N'45'updates\N'39' را ببینید\N'46'
.P
\fIOPAMSKIPVERSIONCHECKS\fR برخی از بررسی‌های نسخه را نادیده می‌گیرد\N'46' ناامن است و صرفاً برای آزمایش سازگاری کاربرد دارد\N'46'
.P
\fIOPAMSOLVERALLOWSUBOPTIMAL\fR (پیش‌فرض `true\N'39') به برخی از حل‌کننده‌ها اجازه می‌دهد در صورت رسیدن به مهلت زمانی (timeout) همچنان پاسخی ارائه دهند؛ هرچند تضمین می‌شود که راه‌حل سازگار بماند، اما تضمینی وجود ندارد که با معیارهای بهینه‌سازی مورد انتظار هم‌خوانی داشته باشد\N'46' اگر `true\N'39' باشد، opam با یک هشدار ادامه می‌دهد؛ اگر `false\N'39' باشد، پایان مهلت زمانی یک خطا تلقی می‌شود\N'46' در حال حاضر فقط موتور builtin\N'45'z3 این حالت تنزل‌یافته را مدیریت می‌کند\N'46'
.P
\fIOPAMSOLVERTIMEOUT\fR زمان مجاز برای حل‌کننده را تغییر می‌دهد\N'46' مقدار پیش‌فرض 60\N'46'0 است، برای زمان نامحدود آن را روی 0 قرار دهید\N'46' توجه داشته باشید که ممکن است همه حل‌کننده‌ها از این گزینه پشتیبانی نکنند\N'46'
.P
\fIOPAMSOLVERTOLERANCE\fR میزان تساهل نسبت به انتخاب یک راه‌حل غیربهینه توسط حل‌کننده (یعنی امکان دریافت بسته‌های قدیمی‌تر) را تغییر می‌دهد\N'46' مقادیر معمول بین 0\N'46'0 (بهترین راه‌حل شناخته‌شده برای حل‌کننده) تا 1\N'46'0 (راه‌حل بهینه‌نشده) متغیر است\N'46' مقدار پیش‌فرض 0\N'46'0 است\N'46' این گزینه در صورتی که حل‌کننده نتواند در زمانی معقول پاسخی بیابد مفید است (\fB$OPAMSOLVERTIMEOUT\fR را ببینید)\N'46' توجه داشته باشید که ممکن است همه حل‌کننده‌ها از این گزینه پشتیبانی نکنند\N'46'
.P
\fIOPAMSTATS\fR در \fB2\N'46'4\fR حذف شد\N'46'
.P
\fIOPAMSTATUSLINE\fR یک نوار وضعیت پویا را در ترمینال نمایش می‌دهد که وضعیت فعلی را نشان می‌دهد\N'46' (یکی از مقادیر \fBalways\fR، \fBnever\fR یا \fBauto\fR)
.P
\fIOPAMSTRICT\fR در صورت بروز ناهماهنگی‌ها (خواندن فایل، وارد کردن 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' برای این منظور، opam در صورتی که \fIOPAMCLI\fR نسخه‌ای معتبر به جز 2\N'46'0 را مشخص کند، و همچنین در صورتی که `\N'45'\N'45'cli=2\N'46'0\N'39' مشخص شده باشد، هشداری نمایش می‌دهد\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
در صورت بروز خطاهای نامشخص گزارش‌شده در خطای استاندارد (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(1)
.SH "گزارش باگ‌ها (BUGS)"
.P
گزارش‌های باگ را در https://github\N'46'com/ocaml/opam/issues بررسی کنید.