.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "OPAM-INIT" 1 "" "Opam 2.5.2" "Opam Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
.P
opam\-init \- مقداردهی اولیه وضعیت opam یا تنظیم گزینه‌های init
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBopam init\fR [\fIOPTION\fR]… [\fINAME\fR] [\fIADDRESS\fR]
.SH "توضیحات (DESCRIPTION)"
.P
مقداردهی اولیه وضعیت opam، یا به‌روزرسانی گزینه‌های init برای opam\N'46'
.P
دستور \fBinit\fR یک «opam root» محلی (به‌طور پیش‌فرض \fI~/\N'46'opam/\fR مگر اینکه توسط \fI\N'45'\N'45'root\fR یا متغیر محیطی \fIOPAMROOT\fR لغو شده باشد) را مقداردهی اولیه می‌کند که داده‌ها و بسته‌های opam را در خود نگه می‌دارد\N'46' این یک گام ضروری برای عملکرد عادی opam است\N'46' مخازن نرم‌افزاری اولیه دریافت می‌شوند، و بر اساس پیکربندی و گزینه‌ها، یک \N'39'switch\N'39' اولیه نیز می‌تواند نصب شود\N'46' این موارد را می‌توان بعداً با استفاده از \fBopam switch\fR و \fBopam repository\fR پیکربندی کرد\N'46'
.P
مخزن اولیه و مقادیر پیش‌فرض را می‌توان از طریق فایل پیکربندی موجود در \fI~/\N'46'opamrc\fR یا \fI/etc/opamrc\fR تنظیم کرد\N'46'
.P
علاوه بر این، این دستور امکان شخصی‌سازی برخی جنبه‌های یکپارچه‌سازی شل opam را هم در اجرای اولیه (برای جلوگیری از گفتگوی تعاملی) و هم در هر زمان دیگری فراهم می‌کند\N'46'
.SH "آرگومان‌ها (ARGUMENTS)"
.TP 4
\fIADDRESS\fR
آدرس مخزن بسته‌های اولیه، هنگام ایجاد یک opam root جدید\N'46'
.TP 4
\fINAME\fR (absent=\fBdefault\fR)
نام مخزن اولیه، هنگام ایجاد یک opam root جدید\N'46'
.SH "گزینه‌ها (OPTIONS)"
.TP 4
\fB\N'45'a\fR, \fB\N'45'\N'45'auto\N'45'setup\fR
انجام خودکار راه‌اندازی کامل، شامل افزودن یک سطر به فایل‌های راه‌انداز شل شما\N'46'
.TP 4
\fB\N'45'\N'45'bare\fR
مقداردهی اولیه وضعیت opam، بدون راه‌اندازی هیچ switch کامپایلری در این مرحله\N'46'
.TP 4
\fB\N'45'\N'45'bypass\N'45'checks\fR
صرف‌نظر کردن از بررسی ابزارهای لازم یا توصیه‌شده، و فرض اینکه همه چیز مرتب است
.TP 4
\fB\N'45'c\fR \fIPACKAGE\fR, \fB\N'45'\N'45'compiler\fR=\fIPACKAGE\fR
تعیین کامپایلر برای نصب (هنگام ایجاد یک switch اولیه)
.TP 4
\fB\N'45'\N'45'config\fR=\fIFILE\fR
استفاده از فایل پیکربندی init داده‌شده\N'46' در صورت تکرار، آخرین مورد بالاترین اولویت را دارد (\fBیعنی\fR هر فیلد مقدار خود را از آخرین جایی که تعریف شده است دریافت می‌کند)\N'46' مشخص کردن یک URL که به فایل پیکربندی اشاره دارد نیز مجاز است\N'46'
.TP 4
\fB\N'45'\N'45'cygwin\N'45'extra\N'45'packages\fR=\fICYGWIN_PACKAGES\fR
\fBفقط در Windows (آزمایشی)\fR\N'46' مشخص کردن بسته‌های اضافی برای نصب با \fB\N'45'\N'45'cygwin\N'45'internal\N'45'install\fR
.TP 4
\fB\N'45'\N'45'cygwin\N'45'internal\N'45'install\fR
\fBفقط در Windows (آزمایشی)\fR\N'46' اجازه به opam برای راه‌اندازی و مدیریت یک نصب داخلی Cygwin (توصیه‌شده)
.TP 4
\fB\N'45'\N'45'cygwin\N'45'local\N'45'install\fR
\fBفقط در Windows (آزمایشی)\fR\N'46' استفاده از نصب از پیش موجود Cygwin
.TP 4
\fB\N'45'\N'45'cygwin\N'45'location\fR=\fIDIR\fR
\fBفقط در Windows (آزمایشی)\fR\N'46' تعیین مکان ریشه Cygwin
.TP 4
\fB\N'45'\N'45'disable\N'45'completion\fR
غیرفعال کردن تکمیل خودکار شل در اسکریپت‌های init برای opam\N'46'
.TP 4
\fB\N'45'\N'45'disable\N'45'sandboxing\fR
استفاده از پیکربندی پیش‌فرض با غیرفعال بودن sandboxing (توجه داشته باشید که اگر \fB\N'45'\N'45'no\N'45'opamrc\fR مشخص نشده باشد یا از \fB\N'45'\N'45'config\fR استفاده شود، این مورد ممکن است توسط `opamrc\N'39' لغو شود)\N'46' استفاده از این گزینه با مسئولیت خودتان است؛ بدون sandboxing این احتمال وجود دارد که اسکریپت یک بستهٔ معیوب تمامی فایل‌های شما را پاک کند\N'46'
.TP 4
\fB\N'45'\N'45'disable\N'45'shell\N'45'hook\fR
غیرفعال کردن ثبت قلاب شل (shell hook) در اسکریپت‌های init برای opam\N'46'
.TP 4
\fB\N'45'\N'45'dot\N'45'profile\fR=\fIFILENAME\fR
نام فایل پیکربندی جهت به‌روزرسانی به‌جای \fI~/\N'46'profile\fR یا \fI~/\N'46'zshrc\fR بر اساس تشخیص شل\N'46'
.TP 4
\fB\N'45'\N'45'enable\N'45'completion\fR
راه‌اندازی تکمیل خودکار شل در اسکریپت‌های init برای opam، برای شل‌های پشتیبانی‌شده\N'46'
.TP 4
\fB\N'45'\N'45'enable\N'45'shell\N'45'hook\fR
راه‌اندازی اسکریپت‌های init در opam برای ثبت یک قلاب شل که به‌طور خودکار محیط شل را در هر خط اعلان (prompt) به‌روز نگه می‌دارد\N'46'
.TP 4
\fB\N'45'\N'45'git\N'45'location\fR=\fIDIR\fR
\fBفقط در Windows (آزمایشی)\fR\N'46' مشخص کردن دایرکتوری باینری git\N'46' اطمینان حاصل کنید که شامل bash در همان دایرکتوری نباشد
.TP 4
\fB\N'45'i\fR, \fB\N'45'\N'45'interactive\fR
اجرای تعاملی راه‌اندازی (این حالت پیش‌فرض برای اجرای اولیه است، یا زمانی که گزینه‌های خاص‌تری مشخص نشده باشند)
.TP 4
\fB\N'45'k\fR \fIKIND\fR, \fB\N'45'\N'45'kind\fR=\fIKIND\fR
مشخص کردن نوع مخزن مورد استفاده (یکی از \fBhttp\fR، \fBlocal\fR، \fBgit\fR، \fBdarcs\fR یا \fBhg\fR)\N'46'
.TP 4
\fB\N'45'n\fR, \fB\N'45'\N'45'no\N'45'setup\fR
پیکربندی شل کاربر را برای راه‌اندازی opam به‌روزرسانی نکن\N'46' همچنین به معنای \fB\N'45'\N'45'disable\N'45'shell\N'45'hook\fR است، مگر اینکه \fB\N'45'\N'45'interactive\fR فعال باشد یا به‌صورت دیگری مشخص شده باشد
.TP 4
\fB\N'45'\N'45'no\N'45'cygwin\N'45'setup\fR
\fBآزمایشی\fR\N'46' عدم راه‌اندازی Cygwin
.TP 4
\fB\N'45'\N'45'no\N'45'git\N'45'location\fR
\fBآزمایشی\fR\N'46' دایرکتوری باینری git مشخص نشود و برای تعیین آن نیز سوالی پرسیده نشود\N'46'
.TP 4
\fB\N'45'\N'45'no\N'45'opamrc\fR
فایل‌های `/etc/opamrc\N'39' یا `~/\N'46'opamrc\N'39' خوانده نشوند: تنها از تنظیمات پیش‌فرض و فایل‌های مشخص‌شده از طریق \fB\N'45'\N'45'config\fR استفاده شود
.TP 4
\fB\N'45'\N'45'reinit\fR
اجرای مجدد بررسی‌ها و راه‌اندازی اولیه بر اساس opamrc، حتی اگر این یک opam root جدید نباشد
.TP 4
\fB\N'45'\N'45'shell\fR=\fISHELL\fR
تنظیم حالت پیکربندی برای محیط opam متناسب با \fISHELL\fR\N'46' یکی از \fBbash\fR، \fBsh\fR، \fBcsh\fR، \fBzsh\fR، \fBfish\fR، \fBpwsh\fR، \fBcmd\fR یا \fBpowershell\fR\N'46' به‌طور پیش‌فرض از روی فرآیندهای والد و متغیر $SHELL حدس زده می‌شود\N'46'
.TP 4
\fB\N'45'\N'45'shell\N'45'setup\fR
راه‌اندازی خودکار پیکربندی شل کاربر برای opam، به عنوان مثال افزودن یک خط به فایل `~/\N'46'profile\N'39'\N'46'
.TP 4
\fB\N'45'\N'45'show\N'45'default\N'45'opamrc\fR
چاپ پیکربندی پیش‌فرض توکار در stdout و خروج.SH "فایل پیکربندی (CONFIGURATION FILE)"
.P
هر فیلدی از پیکربندی اولیه‌ی توکار را می‌توان از طریق \fI~/\N'46'opamrc\fR، \fI/etc/opamrc\fR، یا فایلی که با \fI\N'45'\N'45'config\fR مشخص شده، بازنویسی کرد\N'46' پیکربندی پیش‌فرض برای این نسخه از opam را می‌توان با استفاده از \fB\N'45'\N'45'show\N'45'default\N'45'opamrc\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] (default=\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 (absent=\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
حل‌کننده را فراخوانی کرده و عملیات را نمایش می‌دهد\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' این پرچم رفتار مذکور را غیرفعال کرده و آن‌ها را در نسخه‌ی موجود در حافظه‌ی پنهان نگه می‌دارد\N'46' این معادل تنظیم \fB$OPAMSKIPUPDATE\fR است\N'46'
.TP 4
\fB\N'45't\fR, \fB\N'45'\N'45'with\N'45'test\fR
آزمون‌های واحد بسته را ساخته و \fBاجرا می‌کند\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
امکان اعمال تغییرات بر روی بسته‌های تنظیم‌شده به عنوان پایه‌ی switch (معمولاً کامپایلر اصلی) را فراهم می‌کند\N'46' با احتیاط استفاده شود\N'46' این معادل تنظیم متغیر محیطی \fB$OPAMUNLOCKBASE\fR است\N'46'
.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 "گزینه‌های عمومی (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
\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' این معادل تنظیم \fB$OPAMDEBUG\fR بر روی "true" است\N'46'
.TP 4
\fB\N'45'\N'45'debug\N'45'level\fR=\fILEVEL\fR
مشابه \fB\N'45'\N'45'debug\fR، اما امکان تعیین سطح اشکال‌زدایی را فراهم می‌کند (\fB\N'45'\N'45'debug\fR آن را بر روی ۱ تنظیم می‌کند)\N'46' معادل تنظیم \fB$OPAMDEBUG\fR بر روی یک عدد صحیح مثبت است\N'46'
.TP 4
\fB\N'45'\N'45'git\N'45'version\fR
نسخه‌ی git مربوط به opam را در صورت تعیین بودن (یعنی زمانی که از یک نسخه‌ی توسعه استفاده می‌کنید) چاپ کرده و خارج می‌شود\N'46'
.TP 4
\fB\N'45'\N'45'help\fR[=\fIFMT\fR] (default=\fBauto\fR)
نمایش این راهنما در قالب \fIFMT\fR\N'46' مقدار \fIFMT\fR باید یکی از مقادیر \fBauto\fR، \fBpager\fR، \fBgroff\fR یا \fBplain\fR باشد\N'46' با گزینه‌ی \fBauto\fR، هر زمان که متغیر محیطی \fBTERM\fR برابر با \fBdumb\fR یا تعریف‌نشده باشد، قالب به صورت \fBpager\fR یا \fBplain\fR خواهد بود\N'46'
.TP 4
\fB\N'45'\N'45'ignore\N'45'pin\N'45'depends\fR
پین‌های اضافی مورد نیاز بسته‌هایی را که پین می‌شوند (چه به صورت دستی از طریق \fIopam pin\fR یا از طریق \fIopam install DIR\fR)، نادیده می‌گیرد\N'46' این معادل تنظیم \fBIGNOREPINDEPENDS=true\fR است\N'46'
.TP 4
\fB\N'45'\N'45'json\fR=\fIFILENAME\fR
نتایج اجرای opam را در یک فایل ماشین‌خوان ذخیره می‌کند\N'46' اگر نام فایل شامل نویسه‌ی `%\N'39' باشد، با شاخصی جایگزین می‌شود که از رونویسی فایل‌های موجود جلوگیری کند\N'46' مشابه تنظیم متغیر \fB$OPAMJSON\fR است\N'46'
.TP 4
\fB\N'45'\N'45'no\fR
بدون پرسش به تمام سؤالات بله/خیر 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 به عنوان switch کامپایلر فعلی استفاده می‌کند\N'46' این معادل تنظیم \fB$OPAMSWITCH\fR بر روی \fISWITCH\fR است\N'46'
.TP 4
\fB\N'45'\N'45'use\N'45'internal\N'45'solver\fR
هرگونه حل‌کننده‌ی خارجی را غیرفعال کرده و از حل‌کننده‌ی درونی استفاده می‌کند (این نیازمند آن است که opam با یک حل‌کننده‌ی توکار کامپایل شده باشد)\N'46' این معادل تنظیم \fB$OPAMNOASPCUD\fR یا \fB$OPAMUSEINTERNALSOLVER\fR است\N'46'
.TP 4
\fB\N'45'v\fR, \fB\N'45'\N'45'verbose\fR
توضیحات بیشتر و پرجزئیات‌تر ارائه می‌دهد\N'46' یک بار درج \fB\N'45'v\fR تمام دستورهای بسته را نشان می‌دهد؛ با تکرار آن دستورهای فراخوانی‌شده به صورت داخلی نیز نمایش داده می‌شوند (مانند \fItar\fR، \fIcurl\fR، \fIpatch\fR و غیره)\N'46' تکرار به تعداد \fIn\fR بار معادل تنظیم \fB$OPAMVERBOSE\fR بر روی "\fIn\fR" است\N'46'
.TP 4
\fB\N'45'\N'45'version\fR
نمایش اطلاعات نسخه\N'46'
.TP 4
\fB\N'45'w\fR, \fB\N'45'\N'45'working\N'45'dir\fR
هنگام به‌روزرسانی بسته‌های متصل به یک پوشه‌ی محلی و تحت سیستم کنترل نسخه، به جای آخرین وضعیت ثبت‌شده (commit) یا ارجاعی که به آن اشاره می‌کنند، به وضعیت کاری فعلی سورس آن‌ها به‌روزرسانی می‌کند\N'46' از آنجا که پوشه‌ی سورس همان‌طور که هست کپی می‌شود، اگر تمیز نباشد ممکن است به خرابی ساخت opam منجر شود\N'46' این گزینه فقط بر بسته‌هایی که به صراحت در خط فرمان فهرست شده‌اند تأثیر می‌گذارد\N'46' همچنین می‌تواند با متغیر \fB$OPAMWORKINGDIR\fR تنظیم شود\N'46'
.TP 4
\fB\N'45'y\fR, \fB\N'45'\N'45'yes\fR
بدون پرسش به تمام سؤالات بله/خیر 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' این کار برخی بخش‌های پایانی را نادیده می‌گیرد و همچنین ممکن است به دریافت ردگیری‌های پشته (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 ارتقای خودکار داخلی مخازن با قالب‌های پیشین به قالب فعلی را هنگام \N'39'update\N'39' یا \N'39'init\N'39' غیرفعال می‌کند\N'46'
.P
\fIOPAMNOCHECKSUMS\fR در صورت موجود بودن، گزینهٔ \N'45'\N'45'no\N'45'checksums را فعال می‌کند\N'46'
.P
\fIOPAMNODEPEXTS\fR مدیریت وابستگی‌های سیستمی را غیرفعال می‌کند؛ گزینهٔ `\N'45'\N'45'no\N'45'depexts\N'39' را ببینید\N'46'
.P
\fIOPAMNOENVNOTICE\fR داخلی\N'46'
.P
\fIOPAMNOSELFUPGRADE\fR گزینهٔ `\N'45'\N'45'no\N'45'self\N'45'upgrade\N'39' را ببینید
.P
\fIOPAMPINKINDAUTO\fR تعیین می‌کند که آیا هنگام پین کردن به یک مسیر محلی، سیستم‌های کنترل نسخه شناسایی شوند یا خیر\N'46' از نسخهٔ 1\N'46'3\N'46'0 به طور پیش‌فرض فعال است\N'46'
.P
\fIOPAMPRECISETRACKING\fR ردیابی دقیق و ریزدانهٔ دایرکتوری‌ها\N'46'
.P
\fIOPAMPREPRO\fR این مقدار را روی false تنظیم کنید تا پیش‌پردازش CUDF غیرفعال شود\N'46' کارایی کمتری دارد، اما ممکن است به اشکال‌زدایی مشکلات حل‌کننده کمک کند\N'46'
.P
\fIOPAMREPOSITORYTARRING\fR مخازن را در ساختار داخلی به صورت فایل‌های tar\N'46'gz ذخیره می‌کند\N'46' این ویژگی می‌تواند روی سیستم‌های فایلی که با پیمایش درخت‌های بزرگ به‌خوبی کنار نمی‌آیند اما کش مناسبی در /tmp دارند بسیار سریع‌تر باشد\N'46' با این حال در حالت کلی کندتر است\N'46'
.P
\fIOPAMREQUIRECHECKSUMS\fR گزینهٔ `\N'45'\N'45'require\N'45'checksums\N'39' را در صورت در دسترس بودن فعال می‌کند (برای نمونه برای `opam install\N'39')\N'46'
.P
\fIOPAMRETRIES\fR تعداد دفعات تلاش پیش از ناموفق اعلام شدن دانلودها را مشخص می‌کند\N'46'
.P
\fIOPAMREUSEBUILDDIR\fR گزینهٔ `\N'45'\N'45'reuse\N'45'build\N'45'dir\N'39' را ببینید\N'46'
.P
\fIOPAMROOT\fR گزینهٔ `\N'45'\N'45'root\N'39' را ببینید\N'46' این متغیر به طور خودکار توسط `opam env \N'45'\N'45'root=DIR \N'45'\N'45'set\N'45'root\N'39' تنظیم می‌شود\N'46'
.P
\fIOPAMROOTISOK\fR هنگام اجرا با دسترسی ریشه (root) هشداری نمایش نمی‌دهد\N'46'
.P
\fIOPAMSAFE\fR گزینهٔ `\N'45'\N'45'safe\N'39' را ببینید\N'46'
.P
\fIOPAMSHOW\fR گزینهٔ `\N'45'\N'45'show\N'39' را ببینید\N'46'
.P
\fIOPAMSKIPUPDATE\fR گزینهٔ `\N'45'\N'45'skip\N'45'updates\N'39' را ببینید\N'46'
.P
\fIOPAMSKIPVERSIONCHECKS\fR برخی از بررسی‌های نسخه را نادیده می‌گیرد\N'46' ناامن است، صرفاً برای آزمودن سازگاری استفاده شود\N'46'
.P
\fIOPAMSOLVERALLOWSUBOPTIMAL\fR (پیش‌فرض `true\N'39') به برخی از حل‌کننده‌ها اجازه می‌دهد که پس از به پایان رسیدن مهلت زمانی نیز پاسخی بازگردانند؛ اگرچه سازگاری پاسخ همچنان تضمین‌شده است، اما در این حالت هیچ تضمینی نیست که با معیارهای بهینه‌سازی مورد انتظار همخوانی داشته باشد\N'46' اگر `true\N'39' باشد، opam با یک هشدار ادامه می‌دهد؛ اگر `false\N'39' باشد، اتمام مهلت زمانی یک خطا در نظر گرفته می‌شود\N'46' در حال حاضر فقط بخش پشتیبان داخلی builtin\N'45'z3 این حالت تنزل‌یافته را مدیریت می‌کند\N'46'
.P
\fIOPAMSOLVERTIMEOUT\fR مهلت زمانی مجاز برای حل‌کننده را تغییر می‌دهد\N'46' مقدار پیش‌فرض 60\N'46'0 است؛ برای حالت نامحدود روی 0 تنظیم کنید\N'46' توجه داشته باشید که ممکن است همهٔ حل‌کننده‌ها از این گزینه پشتیبانی نکنند\N'46'
.P
\fIOPAMSOLVERTOLERANCE\fR میزان رواداری در برابر انتخاب یک پاسخ بهینه‌نشده توسط حل‌کننده را تغییر می‌دهد (به عنوان مثال ممکن است بسته‌های قدیمی را انتخاب کند)\N'46' مقادیر معمول بین 0\N'46'0 (بهترین پاسخ شناخته‌شده برای حل‌کننده) تا 1\N'46'0 (پاسخ بهینه‌نشده) متغیر است\N'46' مقدار پیش‌فرض 0\N'46'0 است\N'46' این گزینه در صورتی مفید است که حل‌کننده نتواند در زمانی معقول پاسخی بیابد (به \fB$OPAMSOLVERTIMEOUT\fR مراجعه کنید)\N'46' توجه داشته باشید که ممکن است همهٔ حل‌کننده‌ها از این گزینه پشتیبانی نکنند\N'46'
.P
\fIOPAMSTATS\fR در نسخهٔ \fB2\N'46'4\fR حذف شد\N'46'
.P
\fIOPAMSTATUSLINE\fR یک خط وضعیت پویا را در ترمینال نمایش می‌دهد که وضعیت فعلی را نشان می‌دهد\N'46' (یکی از مقادیر \fBalways\fR، \fBnever\fR یا \fBauto\fR)
.P
\fIOPAMSTRICT\fR در صورت بروز هرگونه ناسازگاری (خواندن فایل، وارد کردن سوییچ و غیره) با خطا متوقف می‌شود\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
از آنجا که پشتیبانی از نسخه رابط خط فرمان تنها در 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
در صورت خطاهای نامشخص گزارش‌شده روی خروجی خطای استاندارد\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 بررسی کنید.