.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "OPAM-UNPIN" 1 "" "Opam 2.5.2" "Opam Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
.P
opam-unpin \- نام مستعاری برای \fBpin remove\fR\N'46'
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBopam unpin\fR [\fIOPTION\fR]… [\fIARG\fR]…
.SH "توضیحات (DESCRIPTION)"
.P
دستور \fBopam\fR\fB unpin\fR نام مستعاری برای \fBopam\fR\fB pin remove\fR است\N'46'
.P
برای جزئیات بیشتر به \fBopam\fR\fB pin \N'45'\N'45'help\fR مراجعه کنید\N'46'
.SH "گزینه‌های ساخت بسته (PACKAGE BUILD OPTIONS)"
.TP 4
\fB\N'45'\N'45'assume\N'45'depexts\fR
از مرحله نصب بسته‌های سیستمی ناموجود صرف‌نظر می‌کند و در هر حال تلاش می‌کند کامپایل بسته‌های opam را ادامه دهد\N'46' اگر نصب موفقیت‌آمیز باشد، opam دیگر درباره این بسته‌های سیستمی سؤالی نمی‌پرسد\N'46' تنها زمانی معنا دارد که مدیریت وابستگی‌های خارجی فعال باشد\N'46'
.TP 4
\fB\N'45'b\fR, \fB\N'45'\N'45'keep\N'45'build\N'45'dir\fR
دایرکتوری‌های ساخت را پس از کامپایل بسته‌ها نگه می‌دارد\N'46' این معادل تنظیم \fB$OPAMKEEPBUILDDIR\fR روی "true" است\N'46'
.TP 4
\fB\N'45'\N'45'build\N'45'doc\fR
در \fB2\N'46'1\fR حذف شد، به‌جای آن از \fI\N'45'\N'45'with\N'45'doc\fR استفاده کنید\N'46'
.TP 4
\fB\N'45'\N'45'build\N'45'test\fR
در \fB2\N'46'1\fR حذف شد، به‌جای آن از \fI\N'45'\N'45'with\N'45'test\fR استفاده کنید\N'46'
.TP 4
\fB\N'45'd\fR, \fB\N'45'\N'45'with\N'45'doc\fR
مستندات بسته را می‌سازد\N'46' این مورد فقط بسته‌های فهرست‌شده در خط فرمان را تحت تأثیر قرار می‌دهد\N'46' این معادل تنظیم \fB$OPAMWITHDOC\fR (یا متغیر منسوخ‌شده \fB$OPAMBUILDDOC\fR) روی "true" است\N'46'
.TP 4
\fB\N'45'\N'45'dry\N'45'run\fR
دستور را شبیه‌سازی می‌کند، اما در عمل هیچ تغییری اعمال نمی‌کند\N'46' این مورد همچنین می‌تواند با متغیر محیطی \fB$OPAMDEBUG\fR تنظیم شود\N'46'
.TP 4
\fB\N'45'\N'45'fake\fR
این گزینه اقدامات را بدون انجام واقعی آن‌ها در پایگاه داده opam ثبت می‌کند\N'46' هشدار: این گزینه خطرناک است و احتمالاً محیط opam شما را خراب می‌کند\N'46' شما احتمالاً \fB\N'45'\N'45'dry\N'45'run\fR را می‌خواهید\N'46' به شما \fIهشدار\fR داده شده است\N'46'
.TP 4
\fB\N'45'\N'45'ignore\N'45'constraints\N'45'on\fR[=\fIPACKAGES\fR] (پیش‌فرض=\fB\fR)
برنامه opam را وادار می‌کند تا محدودیت‌های نسخه را در تمام وابستگی‌ها به بسته‌های فهرست‌شده نادیده بگیرد\N'46' این گزینه می‌تواند برای آزمایش سازگاری استفاده شود، اما انتظار داشته باشید که هنگام استفاده از آن، ساخت‌ها با شکست مواجه شوند\N'46' توجه داشته باشید که در دسترس بودن بسته‌ها و همچنین محدودیت‌های نسخه در وابستگی‌های اختیاری و تداخل‌ها بدون تغییر می‌مانند\N'46' این معادل تنظیم \fB$OPAMIGNORECONSTRAINTS\fR است\N'46'
.TP 4
\fB\N'45'\N'45'inplace\N'45'build\fR
هنگام کامپایل بسته‌ای که منبع آن به یک دایرکتوری محلی متصل است، عملیات ساخت و نصب را به‌جای یک نسخه تمیزِ مدیریت‌شده توسط opam، مستقیماً در همان دایرکتوری پردازش می‌کند\N'46' این فقط بسته‌هایی را تحت تأثیر قرار می‌دهد که صریحاً در خط فرمان فهرست شده‌اند\N'46' این معادل تنظیم \fB$OPAMINPLACEBUILD\fR روی "true" است\N'46'
.TP 4
\fB\N'45'j\fR \fIJOBS\fR, \fB\N'45'\N'45'jobs\fR=\fIJOBS\fR
حداکثر تعداد کارهای هم‌روند را برای استفاده تعیین می‌کند\N'46' مقدار پیش‌فرض از تعداد هسته‌ها محاسبه می‌شود\N'46' همچنین می‌توانید آن را با استفاده از متغیر محیطی \fB$OPAMJOBS\fR تنظیم کنید\N'46'
.TP 4
\fB\N'45'\N'45'lock\N'45'suffix\fR=\fISUFFIX\fR (در صورت عدم وجود=\fBlocked\fR)
پسوند فایل‌های قفل‌شده را روی \fISUFFIX\fR تنظیم می‌کند\N'46'
.TP 4
\fB\N'45'\N'45'locked\fR
در دستوراتی که از فایل‌های opam دریافت‌شده از منابع سنجاق‌شده استفاده می‌کنند، اگر گونه‌ای از فایل با پسوند اضافه‌شده \N'46'\fIlocked\fR یافت شود (برای نمونه \fBfoo\N'46'opam\N'46'locked\fR در کنار \fBfoo\N'46'opam\fR)، به‌جای آن استفاده خواهد شد\N'46' این معمولاً برای ارائه مجموعه‌ای مشخص‌تر از وابستگی‌ها و بازتولید شرایط ساخت مشابه مفید است و به همین دلیل این نام را گرفته است\N'46' گزینه \fIlock\fR را می‌توان برای ایجاد چنین فایل‌هایی، بر اساس نسخه‌های وابستگی‌های فعلیِ نصب‌شده روی میزبان استفاده کرد\N'46' این معادل تنظیم متغیر محیطی \fB$OPAMLOCKED\fR است\N'46' توجه داشته باشید که این گزینه معمولاً بسته‌های از قبل سنجاق‌شده را تحت تأثیر قرار نمی‌دهد\N'46'
.TP 4
\fB\N'45'm\fR \fIMAKE\fR, \fB\N'45'\N'45'make\fR=\fIMAKE\fR
در \fB2\N'46'1\fR حذف شد، به‌جای آن از \fIopam config set[\N'45'global] make MAKE\fR استفاده کنید\N'46'
.TP 4
\fB\N'45'\N'45'no\N'45'checksums\fR
چک‌سام آرشیوهای بارگیری‌شده را بررسی نمی‌کند\N'46' این معادل تنظیم \fB$OPAMNOCHECKSUMS\fR روی "true" است\N'46'
.TP 4
\fB\N'45'\N'45'no\N'45'depexts\fR
مدیریت وابستگی‌های خارجی را موقتاً غیرفعال می‌کند\N'46' این می‌تواند زمانی استفاده شود که بسته‌ای در مدیر بسته سیستم شما موجود نیست، اما وابستگی مورد نیاز را دستی نصب کرده‌اید\N'46' شامل \fB\N'45'\N'45'assume\N'45'depexts\fR نیز می‌شود و در صورت موفقیت، استثناها را نیز ذخیره می‌کند\N'46'
.TP 4
\fB\N'45'\N'45'require\N'45'checksums\fR
نصب بسته‌هایی که برای آرشیوهای بالادست چک‌سام ارائه نمی‌دهند را رد می‌کند\N'46' این معادل تنظیم \fB$OPAMREQUIRECHECKSUMS\fR روی "true" است\N'46'
.TP 4
\fB\N'45'\N'45'reuse\N'45'build\N'45'dir\fR
به‌جای کامپایل کردن از یک کلون تازه از منبع، از دایرکتوری‌های ساخت موجود (که با استفاده از \fB\N'45'\N'45'keep\N'45'build\N'45'dir\fR نگه داشته شده‌اند) مجدداً استفاده می‌کند\N'46' این می‌تواند سریع‌تر باشد، اما در صورتی که سیستم‌های ساخت بسته‌ها ارتقای وابستگی‌ها را به‌خوبی مدیریت نکنند، می‌تواند منجر به شکست شود\N'46' این معادل تنظیم \fB$OPAMREUSEBUILDDIR\fR روی "true" است\N'46'
.TP 4
\fB\N'45'\N'45'show\N'45'actions\fR
حل‌کننده (solver) را فراخوانی کرده و اقدامات را نمایش می‌دهد\N'46' هیچ تغییری اعمال نمی‌کند\N'46' این معادل تنظیم \fB$OPAMSHOW\fR است\N'46'
.TP 4
\fB\N'45'\N'45'skip\N'45'updates\fR
هنگام اجرای install، upgrade یا reinstall بر روی بسته‌های سنجاق‌شده به منبع، آنها معمولاً ابتدا از مبدأ خود به‌روزرسانی می‌شوند\N'46' این پرچم آن رفتار را غیرفعال کرده و آنها را در نسخه موجود در حافظه نهان (cache) نگه می‌دارد\N'46' این معادل تنظیم \fB$OPAMSKIPUPDATE\fR است\N'46'
.TP 4
\fB\N'45't\fR, \fB\N'45'\N'45'with\N'45'test\fR
آزمون‌های واحد بسته را می‌سازد و \fBrun\fR (اجرا) می‌کند\N'46' این فقط بر بسته‌های فهرست‌شده در خط فرمان تأثیر می‌گذارد\N'46' این معادل تنظیم \fB$OPAMWITHTEST\fR (یا متغیر منسوخ‌شده \fB$OPAMBUILDTEST\fR) روی "true" است\N'46'
.TP 4
\fB\N'45'\N'45'unlock\N'45'base\fR
در \fB2\N'46'1\fR حذف شد، به‌جای آن از \fI\N'45'\N'45'update\N'45'invariant\fR استفاده کنید\N'46'
.TP 4
\fB\N'45'\N'45'update\N'45'invariant\fR
امکان اعمال تغییرات روی بسته‌های تنظیم‌شده به عنوان پایه سوییچ (معمولاً کامپایلر اصلی) را فراهم می‌کند\N'46' با احتیاط استفاده کنید\N'46' این معادل تنظیم متغیر محیطی \fB$OPAMUNLOCKBASE\fR است
.TP 4
\fB\N'45'\N'45'verbose\N'45'on\fR=\fIPACKAGES\fR
خروجی با جزئیات بیشتر در مورد بسته‌های مشخص\N'46' این معادل تنظیم \fB$OPAMVERBOSE\fR است\N'46'
.TP 4
\fB\N'45'\N'45'with\N'45'dev\N'45'setup\fR
شامل کردن وابستگی‌های مختص ابزارهای توسعه\N'46'
.SH "گزینه‌ها (OPTIONS)"
.TP 4
\fB\N'45'\N'45'all\fR
هنگام برداشتن سنجاق، همه سنجاق‌های موجود در سوییچ مشخص‌شده را حذف می‌کند\N'46'
.TP 4
\fB\N'45'\N'45'current\fR
هنگام سنجاق کردن، از نسخه و متاداده‌های فعلیِ نصب‌شده بسته استفاده می‌کند: این کار از نصب‌های مجدد ناشی از تغییرات متاداده بالادست جلوگیری کرده و همچنین می‌تواند برای نگه‌داشتن بسته‌ای که در بالادست حذف شده است استفاده شود\N'46'
.TP 4
\fB\N'45'\N'45'dev\N'45'repo\fR
سنجاق کردن به منبع بسته بالادست برای جدیدترین نسخه توسعه
.TP 4
\fB\N'45'e\fR, \fB\N'45'\N'45'edit\fR
همراه با \fIopam pin add\fR، فایل opam را پس از سنجاق کردن مشابه `opam pin edit\N'39' ویرایش می‌کند\N'46'
.TP 4
\fB\N'45'k\fR \fIKIND\fR, \fB\N'45'\N'45'kind\fR=\fIKIND\fR
نوع سنجاق کردن را تعیین می‌کند\N'46' باید یکی از موارد \fBversion\fR، \fBpath\fR، \fBhttp\fR، \fBgit\fR، \fBdarcs\fR، \fBhg\fR، \fBnone\fR یا \fBauto\fR باشد\N'46' اگر تعیین نشده یا \fIauto\fR باشد، از قالب مقصد استنباط می‌شود و در صورتی که سامانه کنترل نسخه‌ای در دایرکتوری مورد نظر شناسایی شود، پیش‌فرض کنترل نسخه مناسب خواهد بود، وگرنه پیش‌فرض \fIpath\fR است\N'46' می‌توان \fIOPAMPINKINDAUTO\fR را روی "0" قرار داد تا تشخیص خودکار کنترل نسخه غیرفعال شود\N'46' از \fInone\fR برای سنجاق کردن بدون مقصد (برای بسته‌های مجازی) استفاده کنید\N'46'
.TP 4
\fB\N'45'n\fR, \fB\N'45'\N'45'no\N'45'action\fR
صرفاً وضعیت سنجاق جدید را ثبت می‌کند و برای نصب (مجدد) یا حذف بسته‌های تحت تأثیر اعلانی نشان نمی‌دهد\N'46'
.TP 4
\fB\N'45'\N'45'normalise\fR
فهرست بسته‌های موجود برای سنجاق کردن را در قالب `name\N'46'version^url` چاپ می‌کند که برای `opam pin add` قابل فهم است\N'46' تنها با زیردستور scan در دسترس است\N'46' نمونه‌ای از کاربرد: `opam pin scan \N'46' \N'45'\N'45'normalise | grep foo | xargs opam pin add`
.TP 4
\fB\N'45'\N'45'recursive\fR
جستجوی بازگشتی فایل‌های \fB*\N'46'opam\fR را مجاز می‌کند\N'46' همچنین \fI\N'45'\N'45'subpath\fR را ببینید\N'46'
.TP 4
\fB\N'45's\fR, \fB\N'45'\N'45'short\fR
خروجی فهرست‌های خام نام‌ها، یک نام در هر خط، بدون نمایش هیچ جزئیاتی\N'46'
.TP 4
\fB\N'45'\N'45'subpath\fR=\fIPATH\fR
فایل‌های \fB*\N'46'opam\fR به‌جای دایرکتوری اصلی از زیردایرکتوری داده‌شده بازیابی می‌شوند\N'46' سپس منابع از زیردایرکتوری هدف گرفته می‌شوند و در عمل تنها همین زیردایرکتوری کپی یا دریافت می‌شود\N'46' می‌توان آن را با \fI\N'45'\N'45'recursive\fR ترکیب کرد تا جستجوی بازگشتی روی زیرمسیر انجام شود\N'46'
.TP 4
\fB\N'45'\N'45'with\N'45'version\fR=\fIVERSION\fR
نسخه سنجاق را برای \fIPACKAGES\fR نام‌برده‌شده یا بسته‌های دریافت‌شده از \fITARGET\fR روی \fIVERSION\fR تنظیم می‌کند\N'46' این گزینه بر هر مشخصه نسخه دیگری (فیلد نسخه در فایل opam، آرگومان \fBname\N'46'vers\fR) اولویت دارد\N'46' هنگام سنجاق کردن به یک نسخه، منبع بسته از آن نسخه استفاده می‌شود، اما به عنوان \fIVERSION\fR به opam اعلام می‌شود\N'46' استفاده از \fB\N'45'\N'45'with\N'45'version\fR معادل استفاده از \fB\N'45'\N'45'edit\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
تعیین اولویت‌های (\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'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' برای مثال هنگام فراخوانی از اسکریپت‌های تکمیل دستور (completion scripts) مفید است\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) یا مرجعی (ref) که به آن اشاره دارند، به وضعیت کاری فعلی کد منبع آن‌ها به‌روزرسانی می‌کند\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 حداکثر تعداد کارگران موازی برای اجرا را تعیین می‌کند\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' این کار برخی اقدامات پایانی (finalisers) را نادیده می‌گیرد و ممکن است به دریافت ردگیری‌های معتبرتر پشته (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 به هر سؤالی پاسخ 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 ارتقای داخلی خودکار مخازن با قالب قبلی به قالب کنونی را در `update\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' بازدهی کمتری دارد، اما ممکن است به اشکال‌زدایی مشکلات حل‌کننده (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') به برخی حل‌کننده‌ها اجازه می‌دهد پس از اتمام مهلت زمانی همچنان پاسخی ارائه دهند؛ اگرچه تضمین می‌شود که پاسخ پایدار و سازگار بماند، اما هیچ تضمینی نیست که با معیارهای بهینه‌سازی مورد انتظار مطابقت داشته باشد\N'46' اگر `true\N'39' باشد، opam با یک هشدار ادامه می‌دهد و اگر `false\N'39' باشد، اتمام مهلت زمانی خطا تلقی می‌شود\N'46' در حال حاضر فقط backend توکار 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 صرفاً آن را نادیده می‌گیرد)، و برای نسخه‌های 2\N'46'1 (یا بالاتر) از `\N'45'\N'45'cli=2\N'46'1\N'39' استفاده نمایید، زیرا متغیر محیطی که تجزیه نحوی را کنترل می‌کند شکننده است\N'46' به همین منظور، اگر \fIOPAMCLI\fR نسخه‌ای معتبر غیر از 2\N'46'0 را مشخص کند، و همچنین اگر `\N'45'\N'45'cli=2\N'46'0\N'39' مشخص شده باشد، opam یک هشدار نمایش می‌دهد\N'46'
.P
نسخه خط فرمان با استفاده از گزینه `\N'45'\N'45'cli\N'39' یا متغیر محیطی \fIOPAMCLI\fR انتخاب می‌شود\N'46' گزینه `\N'45'\N'45'cli\N'39' ممکن است بیش از یک بار مشخص شود که در این حالت آخرین مورد اولویت دارد\N'46' متغیر \fIOPAMCLI\fR تنها در صورتی بررسی می‌شود که `\N'45'\N'45'cli\N'39' داده نشده باشد\N'46'
.SH "وضعیت خروج (EXIT STATUS)"
.P
به عنوان استثنایی بر موارد زیر، دستور `exec\N'39' در صورتی که دستور یافت نشود یا قابل اجرا نباشد مقدار 127، و در غیر این صورت مقدار خروج خود دستور را برمی‌گرداند\N'46'
.TP 4
0
موفقیت، یا درست (true) برای پرس‌وجوهای بولی\N'46'
.TP 4
1
نادرست (False)\N'46' هنگامی که یک مقدار بازگشتی بولی انتظار می‌رود برگردانده می‌شود؛ مثلاً هنگام اجرا با \fB\N'45'\N'45'check\fR، یا برای پرس‌وجوهایی مانند \fBopam lint\fR\N'46'
.TP 4
2
آرگومان‌های خط فرمان نادرست، یا آرگومان‌های خط فرمانی که به یک زمینه نامعتبر اشاره دارند (مثلاً فایلی که از قالب مورد انتظار پیروی نمی‌کند)\N'46'
.TP 4
5
یافت نشد\N'46' چیزی (بسته، نسخه، مخزن، و غیره) درخواست شده که پیدا نشد\N'46'
.TP 4
10
لغو شد\N'46' عملیات نیازمند تأیید بود که داده نشد\N'46'
.TP 4
15
امکان دستیابی به قفل‌های مورد نیاز برای عملیات وجود نداشت\N'46'
.TP 4
20
هیچ راه‌حلی برای درخواست کاربر وجود ندارد\N'46' این امر می‌تواند مثلاً به دلیل درخواست برای نصب دو بسته ناسازگار رخ دهد\N'46'
.TP 4
30
خطا در تعریف بسته، یا سایر فایل‌های متادیتا\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
در صورت بروز خطاهای تفکیک‌نشده گزارش‌شده در خطای استاندارد\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.com/ocaml/opam/issues بررسی کنید.