.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "OPAM-INFO" 1 "" "Opam 2.5.2" "Opam Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
opam\-info \- نام مستعار برای show
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBopam info\fR [\fIOPTION\fR]… [\fIPACKAGES\fR]…
.SH "توضیحات (DESCRIPTION)"
.P
دستور \fBopam\fR\fB info\fR یک نام مستعار برای \fBopam\fR\fB show\fR است\N'46'
.P
برای جزئیات بیشتر به \fBopam\fR\fB show \N'45'\N'45'help\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 "گزینه‌ها (OPTIONS)"
.TP 4
\fB\N'45'\N'45'all\N'45'versions\fR
نمایش اطلاعات تمام بسته‌های منطبق با \fIPACKAGES\fR، بدون محدود شدن به یک بسته منطبق با قیود \fIPACKAGES\fR\N'46'
.TP 4
\fB\N'45'\N'45'empty\N'45'fields\fR
نمایش فیلدهای خالی\N'46' زمانی که \fB\N'45'\N'45'field\fR داده شود، این گزینه به طور ضمنی فعال است\N'46'
.TP 4
\fB\N'45'f\fR \fIFIELDS\fR, \fB\N'45'\N'45'field\fR=\fIFIELDS\fR
تنها مقادیر این فیلدها را نمایش می‌دهد\N'46' فیلدها می‌توانند از میان \fIname\fR، \fIversion\fR، \fIpackage\fR، \fIsynopsis\fR، \fIsynopsis\N'45'or\N'45'target\fR، \fIdescription\fR، \fI<field>\fR، \fI<field>:\fR، \fIinstalled\N'45'version\fR، \fIpin\fR، \fIsource\N'45'hash\fR، \fIopam\N'45'file\fR، \fIall\N'45'installed\N'45'versions\fR، \fIavailable\N'45'versions\fR، \fIall\N'45'versions\fR، \fIrepository\fR، \fIinstalled\N'45'files\fR، \fIvc\N'45'ref\fR و \fIdepexts\fR انتخاب شوند\N'46' چندین فیلد را می‌توان با کاما از هم جدا کرد، که در این صورت عناوین فیلدها چاپ خواهند شد؛ مقدار خام هر فیلد opam\N'45'file را می‌توان با ترکیب با \fB\N'45'\N'45'raw\fR استعلام کرد\N'46'
.TP 4
\fB\N'45'\N'45'file\fR=\fIFILE\fR (absent=\fB\N'45'\fR)
در \fB2\N'46'1\fR حذف شد، به جای آن از \fI\N'45'\N'45'just\N'45'file\fR استفاده کنید\N'46'
.TP 4
\fB\N'45'\N'45'just\N'45'file\fR
بارگذاری و نمایش اطلاعات از فایل‌های داده‌شده (مقادیر مجاز برای \fIPACKAGES\fR مسیرهای فایل یا دایرکتوری هستند)، بدون در نظر گرفتن مخازن یا وضعیت بسته\N'46' این گزینه به طور ضمنی \fB\N'45'\N'45'raw\fR را فعال می‌کند مگر اینکه از \fB\N'45'\N'45'fields\fR استفاده شود\N'46' فقط فیلدهای خام opam\N'45'file قابل استعلام هستند\N'46' اگر هیچ آرگومان PACKAGES مشخص نشده باشد، فایل opam از ورودی استاندارد (stdin) خوانده می‌شود\N'46'
.TP 4
\fB\N'45'\N'45'list\N'45'files\fR
فهرست کردن فایل‌های نصب‌شده توسط بسته\N'46' معادل با \fB\N'45'\N'45'field=installed\N'45'files\fR، و تنها برای بسته‌های نصب‌شده در دسترس است
.TP 4
\fB\N'45'\N'45'no\N'45'lint\fR
هنگام خواندن از فایل‌ها، هشدارها یا خطاهای بررسی ساختار (linting) خروجی داده نشوند
.TP 4
\fB\N'45'\N'45'normalise\fR
چاپ مقادیر فیلدهای opam به شکل نرمال‌شده (بدون خطوط جدید، بدون قلاب‌های ضمنی)
.TP 4
\fB\N'45'\N'45'raw\fR
چاپ فایل خام opam برای این بسته
.TP 4
\fB\N'45'\N'45'sort\fR
مرتب‌سازی فیلدهای opam
.TP 4
\fB\N'45'\N'45'where\fR
چاپ مکان فایل opam مورد استفاده برای این بسته
.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 در دسترس نبود، بنابراین برای انتخاب رابط خط فرمان 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
نادیده گرفتن سنجاق‌های (pins) اضافی مورد نیاز بسته‌هایی که چه به طور دستی از طریق \fIopam pin\fR یا از طریق \fIopam install DIR\fR سنجاق شده‌اند\N'46' این معادل تنظیم \fBIGNOREPINDEPENDS=true\fR است\N'46'
.TP 4
\fB\N'45'\N'45'json\fR=\fIFILENAME\fR
ذخیره نتایج اجرای opam در یک فایل ماشینی\N'45'خوان\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' برای نمونه برای فراخوانی از اسکریپت‌های تکمیل خودکار (completion) مفید است\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' این کار اجرای برخی از نهایی‌سازها را نادیده می‌گیرد و ممکن است به دریافت ردگیری‌های معکوس (backtrace) قابل‌اعتمادتر نیز کمک کند\N'46'
.P
\fIOPAMLOCKED\fR ترکیبی از گزینه‌های `\N'45'\N'45'locked\N'39' و `\N'45'\N'45'lock\N'45'suffix\N'39' است\N'46'
.P
\fIOPAMLOGS\fR \fIlogdir\fR دایرکتوری لاگ را تعیین می‌کند؛ پیش‌فرض یک دایرکتوری موقت در /tmp است
.P
\fIOPAMMAKECMD\fR دستور make سیستمی مورداستفاده را تعیین می‌کند\N'46'
.P
\fIOPAMMERGEOUT\fR خروجی‌های فرآیند، یعنی stderr را در stdout ادغام می‌کند\N'46'
.P
\fIOPAMNO\fR به هر پرسشی پاسخ 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 برای غیرفعال کردن پیش‌پردازش CUDF این متغیر را روی false قرار دهید\N'46' کارایی کمتری دارد، اما ممکن است به اشکال‌زدایی مشکلات حل‌کننده کمک کند\N'46'
.P
\fIOPAMREPOSITORYTARRING\fR مخازن را به‌صورت داخلی به‌شکل فایل‌های tar\N'46'gz ذخیره می‌کند\N'46' این ویژگی می‌تواند روی سیستم‌های فایلی که با پیمایش درخت‌های بزرگ عملکرد خوبی ندارند اما حافظهٔ موقت مناسبی در /tmp دارند بسیار سریع‌تر باشد\N'46' با این حال در حالت کلی کندتر است\N'46'
.P
\fIOPAMREQUIRECHECKSUMS\fR گزینهٔ `\N'45'\N'45'require\N'45'checksums\N'39' را در صورت در دسترس بودن (برای مثال، برای `opam install\N'39') فعال می‌کند\N'46'
.P
\fIOPAMRETRIES\fR تعداد تلاش‌ها را پیش از شکست بارگیری‌ها تعیین می‌کند\N'46'
.P
\fIOPAMREUSEBUILDDIR\fR گزینهٔ `\N'45'\N'45'reuse\N'45'build\N'45'dir\N'39' را ببینید\N'46'
.P
\fIOPAMROOT\fR گزینهٔ `\N'45'\N'45'root\N'39' را ببینید\N'46' این متغیر به‌طور خودکار توسط `opam env \N'45'\N'45'root=DIR \N'45'\N'45'set\N'45'root\N'39' تنظیم می‌شود\N'46'
.P
\fIOPAMROOTISOK\fR هنگام اجرا با کاربر ریشه (root) هشدار نمی‌دهد\N'46'
.P
\fIOPAMSAFE\fR گزینهٔ `\N'45'\N'45'safe\N'39' را ببینید\N'46'
.P
\fIOPAMSHOW\fR گزینهٔ `\N'45'\N'45'show\N'39' را ببینید\N'46'
.P
\fIOPAMSKIPUPDATE\fR گزینهٔ `\N'45'\N'45'skip\N'45'updates\N'39' را ببینید\N'46'
.P
\fIOPAMSKIPVERSIONCHECKS\fR برخی از بررسی‌های نسخه را دور می‌زند\N'46' ناامن است، تنها برای آزمایش سازگاری کاربرد دارد\N'46'
.P
\fIOPAMSOLVERALLOWSUBOPTIMAL\fR (پیش‌فرض `true\N'39') به برخی از حل‌کننده‌ها اجازه می‌دهد در صورت پایان مهلت زمانی (timeout)، همچنان راه‌حلی بازگردانند؛ اگرچه اطمینان وجود دارد که راه‌حل سازگار است، اما در این حالت هیچ تضمینی وجود ندارد که با معیارهای بهینه‌سازی موردانتظار مطابقت داشته باشد\N'46' اگر روی `true\N'39' باشد، opam با یک هشدار ادامه می‌دهد، و اگر روی `false\N'39' باشد، پایان مهلت زمانی یک خطا تلقی می‌شود\N'46' در حال حاضر تنها 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 صرفاً آن را نادیده می‌گیرد)، و از `\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
آرگومان‌های نامعتبر خط فرمان، یا آرگومان‌های خط فرمانی که به یک بافت (context) نامعتبر اشاره دارند (برای مثال فایلی که از قالب مورد انتظار پیروی نمی‌کند)\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'