.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "OPAM-TREE" 1 "" "Opam 2.5.2" "Opam Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
.P
opam\-tree \- رسم جنگل وابستگی بسته‌های نصب‌شده
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBopam tree\fR [\fB\N'45'\N'45'recursive\fR] [\fB\N'45'\N'45'subpath\fR=\fIPATH\fR] [\fIOPTION\fR]… [\fIPACKAGES\fR]…
.SH "توضیحات (DESCRIPTION)"
.P
این دستور جنگل بسته‌های در حال حاضر نصب‌شده را به‌صورت طرح گرافیکی یونی‌کد/اسکی (Unicode/ASCII\-art) نمایش می‌دهد\N'46'
.P
بدون آرگومان، جنگل وابستگی بسته‌هایی را رسم می‌کند که هیچ وابسته‌ای ندارند\N'46' با آرگومان‌های بسته‌ها، جنگل بسته‌های مشخص‌شده را رسم می‌کند\N'46' هنگامی که بسته‌های نصب‌نشده در آرگومان‌ها مشخص شوند، پیش از رسم جنگل تلاش می‌کند نصب آن‌ها را شبیه‌سازی کند\N'46'
.P
هنگامی که گزینهٔ \fB\N'45'\N'45'rev\N'45'deps\fR استفاده شود، به جای آن جنگل وابستگی معکوس را رسم می‌کند\N'46' بدون آرگومان، جنگل بسته‌هایی را رسم می‌کند که هیچ وابستگی‌ای ندارند\N'46' با آرگومان‌های بسته‌ها، جنگل بسته‌های مشخص‌شده را رسم می‌کند\N'46' توجه داشته باشید که در صورت استفاده از این گزینه، بسته‌های نصب‌نشده نادیده گرفته می‌شوند\N'46'
.P
هنگامی که یک بسته دو بار یا بیشتر در جنگل ظاهر شود، دفعات دوم یا بعدی آن بسته به عنوان تکراری علامت‌گذاری شده و با نماد \fI[*]\fR مشخص می‌شوند\N'46' هر زیردرختی که ریشه در چنین موارد تکراری داشته باشد، برای جلوگیری از افزونگی کوتاه‌سازی خواهد شد\N'46'
.P
برای مشاهدهٔ تمامی راه‌های انتخاب بسته‌ها جهت نمایش، بخش‌های \fBگزینه‌های پالایش درخت (TREE FILTERING OPTIONS)\fR و \fBگزینه‌های انتخاب بسته (PACKAGE SELECTION OPTIONS)\fR، و برای سفارشی‌سازی قالب خروجی، بخش \fBگزینه‌های قالب خروجی (OUTPUT FORMAT OPTIONS)\fR را ببینید\N'46'
.P
برای مشاهدهٔ فهرست ساده‌ای از بسته‌ها که ممکن است نصب نشده باشند، \fBopam list\fR را ببینید\N'46'
.SH "آرگومان‌ها (ARGUMENTS)"
.TP 4
\fIPACKAGES\fR
فهرستی از نام بسته‌ها، همراه با نسخه یا قید اختیاری، مانند `pkg\N'39' ،`pkg\N'46'1\N'46'0\N'39' یا `pkg>=0\N'46'5\N'39'؛ یا نام فایل‌ها یا دایرکتوری‌های حاوی توصیف بسته، همراه با ذکر صریح دایرکتوری (مانند `\N'46'/foo\N'46'opam\N'39' یا `\N'46'\N'39')
.SH "گزینه‌های ساخت درخت (TREE BUILDING OPTIONS)"
.TP 4
\fB\N'45'\N'45'deps\fR
رسم یک جنگل وابستگی، با شروع از بسته‌هایی که توسط هیچ بستهٔ دیگری نیاز نیستند (این حالت پیش‌فرض است)\N'46'
.TP 4
\fB\N'45'\N'45'rev\N'45'deps\fR
رسم یک جنگل وابستگی معکوس، با شروع از بسته‌هایی که هیچ وابستگی‌ای ندارند\N'46'
.SH "گزینه‌های پالایش درخت (TREE FILTERING OPTIONS)"
.P
این گزینه‌ها فقط زمانی اعمال می‌شوند که \fIPACKAGES\fR مشخص شده باشند\N'46'
.TP 4
\fB\N'45'\N'45'leads\N'45'to\fR
تنها شاخه‌هایی را نمایش می‌دهد که به یکی از \fIPACKAGES\fR منتهی می‌شوند\N'46'
.TP 4
\fB\N'45'\N'45'roots\N'45'from\fR
تنها درخت‌هایی را نمایش می‌دهد که ریشه در یکی از \fIPACKAGES\fR دارند (این حالت پیش‌فرض است)\N'46'
.SH "گزینه‌های انتخاب بسته (PACKAGE SELECTION OPTIONS)"
.TP 4
\fB\N'45'\N'45'dev\fR
گنجاندن بسته‌های توسعه در وابستگی‌ها\N'46'
.TP 4
\fB\N'45'\N'45'no\N'45'switch\fR
نادیده گرفتن switch فعال و شبیه‌سازی نصب بسته‌ها از یک switch خالی برای رسم جنگل
.TP 4
\fB\N'45'\N'45'post\fR
گنجاندن وابستگی‌هایی با برچسب \fIpost\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
گنجاندن وابستگی‌های صرفاً آزمایشی\N'46'
.TP 4
\fB\N'45'\N'45'with\N'45'dev\N'45'setup\fR
گنجاندن وابستگی‌های صرفاً مخصوص توسعه‌دهنده\N'46'
.TP 4
\fB\N'45'\N'45'with\N'45'doc\fR, \fB\N'45'\N'45'doc\fR
گنجاندن وابستگی‌های صرفاً مربوط به مستندات\N'46'
.SH "گزینه‌های قالب خروجی (OUTPUT FORMAT OPTIONS)"
.TP 4
\fB\N'45'\N'45'no\N'45'constraint\fR
قیدهای نسخه مانند \fI(>= 1\N'46'0\N'46'0)\fR را نمایش نده\N'46'
.SH "گزینه‌ها (OPTIONS)"
.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'\N'45'subpath\fR=\fIPATH\fR
فایل‌های \fB*\N'46'opam\fR به جای دایرکتوری اصلی، از زیردایرکتوری داده‌شده بازیابی می‌شوند\N'46' سپس سورس‌ها از زیردایرکتوری هدف برداشته می‌شوند، به‌صورت داخلی فقط این زیردایرکتوری کپی/دریافت می‌شود\N'46' می‌تواند با \fI\N'45'\N'45'recursive\fR ترکیب شود تا جستجوی بازگشتی روی subpath انجام گیرد\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\-امین فراخوانی حل‌کننده در طول اجرای 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
سنجاق‌های (pin) اضافی مورد نیاز بسته‌هایی که سنجاق می‌شوند را نادیده بگیر، چه به‌طور دستی از طریق \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'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
در صورت وجود یک فایل اجرایی جدیدتر در مسیر \fBOPAMROOT/opam\fR، برنامهٔ opam خود را با آن جایگزین می‌کند\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
هنگام به‌روزرسانی بسته‌هایی که به یک دایرکتوری محلی با کنترل نسخه مقید هستند، به وضعیت کاری فعلی سورس آن‌ها به‌روزرسانی کن، نه به آخرین وضعیت کامیت‌شده یا ارجاعی (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' متغیرهای بولی باید برای غیرفعال‌سازی روی "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 و reinstall\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 حداکثر تعداد پردازش‌های کارگری (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 مشخص می‌کند که آیا سیستم‌های کنترل نسخه هنگام سنجاق کردن به یک مسیر محلی شناسایی شوند یا خیر\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' این ویژگی می‌تواند در سیستم‌های فایلی که با پیمایش درخت‌های بزرگ عملکرد خوبی ندارند اما دارای حافظه موقت (caching) مناسب در /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'
.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 افزوده شد، برای انتخاب پشتیبانی از 2\N'46'0 از متغیر محیطی \fIOPAMCLI\fR استفاده کنید (زیرا 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\N'46'com/ocaml/opam/issues بررسی کنید\N'46'