.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R .\" .mso an.tmac .TH "OPAM ADMIN-MAKE" 1 "" "Opam admin 2.5.2" "Opam admin Manual" .\" Disable hyphenation and ragged-right .nh .ad l .SH "نام (NAME)" .P opam admin\-make \- یک نام مستعار برای \fBindex\fR .SH "خلاصه دستور (SYNOPSIS)" .P \fBopam admin make\fR [\fB\N'45'\N'45'full\N'45'urls\N'45'txt\fR] [\fB\N'45'\N'45'minimal\N'45'urls\N'45'txt\fR] [\fB\N'45'\N'45'no\N'45'urls\N'45'txt\fR] [\fIOPTION\fR]… .SH "توضیحات (DESCRIPTION)" .P دستور \fBopam admin\fR\fB make\fR یک نام مستعار برای \fBopam admin\fR\fB index\fR است\N'46' .P برای جزئیات بیشتر به \fBopam admin\fR\fB index \N'45'\N'45'help\fR مراجعه کنید\N'46' .SH "گزینه‌ها (OPTIONS)" .TP 4 \fB\N'45'\N'45'full\N'45'urls\N'45'txt\fR تولید یک \N'39'urls\N'46'txt\N'39' جامع، برای مخزنی که توسط نسخه‌های پیش از 2\N'46'0 از opam استفاده خواهد شد\N'46' .TP 4 \fB\N'45'\N'45'minimal\N'45'urls\N'45'txt\fR تولید یک فایل \N'39'urls\N'46'txt\N'39' کمینه، که فقط شامل فایل \N'39'repo\N'39' است\N'46' این به نسخه‌های opam پیش از 2\N'46'0 اجازه می‌دهد تا به جای مواجهه با خطا، آن فایل را بخوانند و با فرض تعریف یک فیلد مناسب \N'39'redirect:\N'39'، به درستی به یک مخزن اختصاصی برای نسخه خود هدایت شوند\N'46' این حالت پیش‌فرض است\N'46' .TP 4 \fB\N'45'\N'45'no\N'45'urls\N'45'txt\fR فایل \N'39'urls\N'46'txt\N'39' تولید نشود\N'46' این فایل نمایه از opam نسخه 2\N'46'0 به بعد دیگر مورد نیاز نیست، اما هنوز توسط نسخه‌های قدیمی‌تر استفاده می‌شود\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'46'cudf که در آن نشان‌دهنده 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 نادیده گرفتن وابستگی‌های سنجاق‌شده (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'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'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 به عنوان سوئیچ کامپایلر فعلی\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 هنگام به‌روزرسانی بسته‌هایی که به یک دایرکتوری محلی و تحت کنترل نسخه مقید هستند، به جای آخرین وضعیت کامیت‌شده یا مرجعی که به آن اشاره می‌کنند، به وضعیت کاری فعلی منبع آن‌ها به‌روزرسانی شود\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 \fIترجیحات\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 حداکثر تعداد کارگران موازی (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' این کار برخی بخش‌های نهایی‌ساز (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 به هر سؤالی که پرسیده شود پاسخ منفی می‌دهد، گزینه‌های `\N'45'\N'45'no` و `\N'45'\N'45'confirm\N'45'level` را ببینید\N'46' در صورتی که هر یک از \fBOPAMCONFIRMLEVEL\fR یا \fBOPAMYES\fR تنظیم شده باشند، \fBOPAMNO\fR نادیده گرفته می‌شود\N'46' .P \fIOPAMNOAGGREGATE\fR همراه با `opam admin check\N'39'، بسته‌ها را تجمیع نمی‌کند\N'46' .P \fIOPAMNOASPCUD\fR منسوخ شده است\N'46' .P \fIOPAMNOAUTOUPGRADE\fR ارتقای خودکار داخلی مخازن دارای قالب قدیمی‌تر به قالب فعلی را هنگام اجرای \N'39'update\N'39' یا \N'39'init\N'39' غیرفعال می‌کند\N'46' .P \fIOPAMNOCHECKSUMS\fR در صورت موجود بودن، گزینهٔ \N'45'\N'45'no\N'45'checksums را فعال می‌کند\N'46' .P \fIOPAMNODEPEXTS\fR مدیریت وابستگی‌های سیستمی را غیرفعال می‌کند، گزینهٔ `\N'45'\N'45'no\N'45'depexts\N'39' را ببینید\N'46' .P \fIOPAMNOENVNOTICE\fR داخلی است\N'46' .P \fIOPAMNOSELFUPGRADE\fR گزینهٔ `\N'45'\N'45'no\N'45'self\N'45'upgrade\N'39' را ببینید .P \fIOPAMPINKINDAUTO\fR مشخص می‌کند که آیا هنگام سنجاق کردن (pinning) به یک مسیر محلی، سیستم‌های کنترل نسخه باید شناسایی شوند یا خیر\N'46' از نسخهٔ 1\N'46'3\N'46'0 به طور پیش‌فرض فعال است\N'46' .P \fIOPAMPRECISETRACKING\fR ردیابی دقیق و ریزدانهٔ دایرکتوری‌ها\N'46' .P \fIOPAMPREPRO\fR برای غیرفعال کردن پیش‌پردازش CUDF این مقدار را false بگذارید\N'46' کارایی کمتری دارد، اما ممکن است به اشکال‌زدایی مشکلات حل‌کننده کمک کند\N'46' .P \fIOPAMREPOSITORYTARRING\fR مخازن را در داخل به صورت فایل‌های tar\N'46'gz ذخیره می‌کند\N'46' این ویژگی روی سیستم‌های فایلی که با پیمایش درخت‌های بزرگ عملکرد خوبی ندارند اما دارای حافظهٔ موقت مناسب در /tmp هستند می‌تواند بسیار سریع‌تر باشد\N'46' با این حال در حالت کلی کندتر است\N'46' .P \fIOPAMREQUIRECHECKSUMS\fR در صورت موجود بودن، گزینهٔ `\N'45'\N'45'require\N'45'checksums\N'39' را فعال می‌کند (برای مثال برای `opam install\N'39')\N'46' .P \fIOPAMRETRIES\fR تعداد دفعات تلاش مجدد را پیش از شکست بارگیری‌ها تعیین می‌کند\N'46' .P \fIOPAMREUSEBUILDDIR\fR گزینهٔ `\N'45'\N'45'reuse\N'45'build\N'45'dir\N'39' را ببینید\N'46' .P \fIOPAMROOT\fR گزینهٔ `\N'45'\N'45'root\N'39' را ببینید\N'46' این متغیر به طور خودکار توسط `opam env \N'45'\N'45'root=DIR \N'45'\N'45'set\N'45'root\N'39' تنظیم می‌شود\N'46' .P \fIOPAMROOTISOK\fR هنگام اجرا با دسترسی کاربر ریشه (root) هشداری صادر نمی‌کند\N'46' .P \fIOPAMSAFE\fR گزینهٔ `\N'45'\N'45'safe\N'39' را ببینید\N'46' .P \fIOPAMSHOW\fR گزینهٔ `\N'45'\N'45'show\N'39' را ببینید\N'46' .P \fIOPAMSKIPUPDATE\fR گزینهٔ `\N'45'\N'45'skip\N'45'updates\N'39' را ببینید\N'46' .P \fIOPAMSKIPVERSIONCHECKS\fR برخی از بررسی‌های نسخه را دور می‌زند\N'46' ناامن است، صرفاً برای آزمایش سازگاری استفاده شود\N'46' .P \fIOPAMSOLVERALLOWSUBOPTIMAL\fR (پیش‌فرض `true\N'39') به برخی حل‌کننده‌ها اجازه می‌دهد پس از اتمام مهلت زمانی (timeout)، همچنان راه‌حلی ارائه دهند؛ در حالی که تضمین می‌شود راه‌حل سازگار باقی می‌ماند، هیچ تضمینی در این حالت وجود ندارد که با معیارهای بهینه‌سازی مورد انتظار مطابقت داشته باشد\N'46' اگر `true\N'39' باشد، opam با یک هشدار ادامه خواهد داد، و اگر `false\N'39' باشد، اتمام مهلت زمانی یک خطا در نظر گرفته می‌شود\N'46' در حال حاضر تنها پشتیبان builtin\N'45'z3 این حالت تنزل‌یافته را مدیریت می‌کند\N'46' .P \fIOPAMSOLVERTIMEOUT\fR مهلت زمانی مجاز حل‌کننده را تغییر می‌دهد\N'46' پیش‌فرض 60\N'46'0 است، برای نامحدود کردن آن را روی 0 تنظیم کنید\N'46' توجه داشته باشید که ممکن است همهٔ حل‌کننده‌ها از این گزینه پشتیبانی نکنند\N'46' .P \fIOPAMSOLVERTOLERANCE\fR میزان مدارا را نسبت به انتخاب یک راه‌حل غیربهینه توسط حل‌کننده تغییر می‌دهد (یعنی ممکن است بسته‌های قدیمی را انتخاب کند)\N'46' مقادیر معمول از 0\N'46'0 (بهترین راه‌حل شناخته‌شده توسط حل‌کننده) تا 1\N'46'0 (راه‌حل غیربهینه) متغیر است\N'46' پیش‌فرض 0\N'46'0 است\N'46' این گزینه زمانی مفید است که حل‌کننده نتواند در یک زمان معقول راه‌حلی بیابد (\fB$OPAMSOLVERTIMEOUT\fR را ببینید)\N'46' توجه داشته باشید که ممکن است همهٔ حل‌کننده‌ها از این گزینه پشتیبانی نکنند\N'46' .P \fIOPAMSTATS\fR در \fB2\N'46'4\fR حذف شده است\N'46' .P \fIOPAMSTATUSLINE\fR یک خط وضعیت پویا نمایش می‌دهد که وضعیت فعلی را در پایانه نشان می‌دهد\N'46' (یکی از مقادیر \fBalways\fR، \fBnever\fR یا \fBauto\fR) .P \fIOPAMSTRICT\fR در صورت بروز هرگونه ناسازگاری (خواندن فایل، وارد کردن switch و غیره\N'46') با خطا متوقف می‌شود\N'46' .P \fIOPAMSWITCH\fR گزینهٔ `\N'45'\N'45'switch\N'39' را ببینید\N'46' به طور خودکار توسط `opam env \N'45'\N'45'switch=SWITCH \N'45'\N'45'set\N'45'switch\N'39' تنظیم می‌شود\N'46' .P \fIOPAMUNLOCKBASE\fR گزینهٔ نصب `\N'45'\N'45'unlock\N'45'base\N'39' را ببینید\N'46' .P \fIOPAMUPGRADECRITERIA\fR \fIترجیحات\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'39' را ببینید\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 اضافه شد، برای انتخاب پشتیبانی از 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 .sp -1 .P Vincent Bernardoff .sp -1 .P Raja Boujbel .sp -1 .P Kate Deplaix .sp -1 .P Roberto Di Cosmo .sp -1 .P Thomas Gazagnaire .sp -1 .P Louis Gesbert .sp -1 .P Fabrice Le Fessant .sp -1 .P Anil Madhavapeddy .sp -1 .P Guillem Rieu .sp -1 .P Ralf Treinen .sp -1 .P Frederic Tuong .SH "همچنین ببینید (SEE ALSO)" .P opam admin(1) .SH "گزارش باگ‌ها (BUGS)" .P گزارش باگ‌ها را در https://github.com/ocaml/opam/issues بررسی کنید.