.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R .\" .mso an.tmac .TH "OPAM-UPDATE" 1 "" "Opam 2.5.2" "Opam Manual" .\" Disable hyphenation and ragged-right .nh .ad l .SH "نام (NAME)" opam\-update \- به‌روزرسانی فهرست بسته‌های موجود .SH "خلاصه دستور (SYNOPSIS)" .P \fBopam update\fR [\fIOPTION\fR]… [\fINAMES\fR]… .SH "توضیحات (DESCRIPTION)" .P تعاریف بسته‌ها را به‌روزرسانی می‌کند\N'46' این دستور جدیدترین نسخهٔ مخازن پیکربندی‌شده از طریق \fBopam repository\fR و سورس‌های بسته‌های توسعه‌ایِ نصب‌شده و بسته‌های پین‌شده در سوییچ فعلی را واکشی می‌کند\N'46' برای استفاده از سورس‌ها و تعاریف به‌روزرسانی‌شده، از \fBopam upgrade\fR استفاده کنید\N'46' .SH "آرگومان‌ها (ARGUMENTS)" .TP 4 \fINAMES\fR فهرست نام‌های مخازن یا بسته‌های توسعه‌ای برای به‌روزرسانی\N'46' .SH "گزینه‌ها (OPTIONS)" .TP 4 \fB\N'45'a\fR, \fB\N'45'\N'45'all\fR به‌روزرسانی تمامی مخازن پیکربندی‌شده، نه فقط مواردی که در سوییچ فعلی تنظیم شده‌اند .TP 4 \fB\N'45'\N'45'check\fR به‌روزرسانی را انجام می‌دهد، سپس در صورت وجود هرگونه تغییر در بالادست با کد ۰ و در صورت عدم وجود هیچ تغییری با ۱ بازمی‌گردد\N'46' مخازن یا بسته‌های توسعه‌ای که به‌روزرسانی آن‌ها با خطا مواجه شود، بدون تغییر در نظر گرفته می‌شوند\N'46' همراه با \fB\N'45'\N'45'upgrade\fR، این گزینه بر مرحلهٔ ارتقا اِعمال می‌شود: به این معنا که \fBopam update \N'45'\N'45'upgrade \N'45'\N'45'check\fR مشابه \fBopam update && opam upgrade \N'45'\N'45'check\fR عمل کرده و در صورتی که ارتقایی در دسترس باشد (به‌جای به‌روزرسانی‌های بالادست)، مقدار ۰ را بازمی‌گرداند\N'46' .TP 4 \fB\N'45'\N'45'depexts\fR از مدیر بستهٔ سیستم درخواست می‌کند پایگاه‌های دادهٔ خود را به‌روزرسانی کند (صرف‌نظر از همهٔ بسته‌های opam، مگر اینکه \fB\N'45'\N'45'development\fR یا \fB\N'45'\N'45'repositories\fR نیز مشخص شده باشند)\N'46' این کار عموماً نیازمند دسترسی‌های \fBsudo\fR است\N'46' .TP 4 \fB\N'45'\N'45'development\fR به‌روزرسانی بسته‌های توسعه‌ای (صرف‌نظر از مخازن، مگر اینکه \fB\N'45'\N'45'repositories\fR نیز مشخص شده باشد)\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'R\fR, \fB\N'45'\N'45'repositories\fR به‌روزرسانی مخازن (صرف‌نظر از بسته‌های توسعه‌ای، مگر اینکه \fB\N'45'\N'45'development\fR نیز مشخص شده باشد)\N'46' .TP 4 \fB\N'45'u\fR, \fB\N'45'\N'45'upgrade\fR اجرای خودکار \fBopam upgrade\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 مشخص‌کردن ترجیحات کاربر (\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 آن را روی ۱ تنظیم می‌کند)\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 پاسخ منفی (no) به تمام پرسش‌های بله/خیر opam بدون پرسش از کاربر\N'46' همچنین ببینید: \fB\N'45'\N'45'confirm\N'45'level\fR\N'46' این گزینه معادل با تنظیم \fB$OPAMNO\fR روی "true" است\N'46' .TP 4 \fB\N'45'\N'45'no\N'45'aspcud\fR در \fB2\N'46'1\fR حذف شد\N'46' .TP 4 \fB\N'45'\N'45'no\N'45'auto\N'45'upgrade\fR هنگام پیکربندی یا به‌روزرسانی مخزنی که برای نسخه‌های قدیمی‌تر opam (1\N'46'2) نوشته شده است، opam آن را به‌طور داخلی به قالب فعلی تبدیل می‌کند\N'46' این گزینه این رفتار را غیرفعال می‌کند\N'46' توجه داشته باشید که مخازن باید نگارش قالب خود را در یک فایل \N'39'repo\N'39' در ریشهٔ خود مشخص کنند، در غیر این صورت فرض می‌شود که در قالب قدیمی‌تر هستند\N'46' در هر صورت، بهتر است در صورت امکان مخازن را با استفاده از \fIopam admin upgrade [\N'45'\N'45'mirror URL]\fR به‌صورت دستی ارتقا دهید\N'46' .TP 4 \fB\N'45'\N'45'no\N'45'self\N'45'upgrade\fR ابزار opam در صورت وجود یک فایل اجرایی جدیدتر در \fBOPAMROOT/opam\fR، خود را با آن جایگزین می‌کند\N'46' این گزینه این رفتار را غیرفعال می‌کند\N'46' .TP 4 \fB\N'45'q\fR, \fB\N'45'\N'45'quiet\fR گزینهٔ \fB\N'45'\N'45'verbose\fR را غیرفعال می‌کند\N'46' .TP 4 \fB\N'45'\N'45'root\fR=\fIROOT\fR استفاده از \fIROOT\fR به‌عنوان مسیر ریشهٔ فعلی\N'46' این معادل با تنظیم \fB$OPAMROOT\fR روی \fIROOT\fR است\N'46' .TP 4 \fB\N'45'\N'45'safe\fR, \fB\N'45'\N'45'readonly\fR اطمینان حاصل می‌کند که هیچ چیزی به‌طور خودکار به‌روزرسانی یا بازنویسی نخواهد شد\N'46' برای مثال هنگام فراخوانی از اسکریپت‌های تکمیل خودکار مفید است\N'46' هر زمان که چنین عملیاتی نیاز باشد با خطا مواجه می‌شود؛ همچنین از انتظار برای قفل‌ها اجتناب می‌کند، پرسش‌های تعاملی را رد می‌کند و بر متغیر \fB$OPAMDEBUG\fR اولویت دارد\N'46' این معادل با تنظیم متغیر محیطی \fB$OPAMSAFE\fR است\N'46' .TP 4 \fB\N'45'\N'45'solver\fR=\fICMD\fR مشخص‌کردن حل‌کنندهٔ CUDF برای رفع مشکلات نصب بسته\N'46' این مقدار یا یک حل‌کنندهٔ از پیش‌تعریف‌شده است (این نگارش opam از builtin\N'45'mccs+lp()، builtin\N'45'mccs+glpk، builtin\N'45'dummy\N'45'z3\N'45'solver، builtin\N'45'0install، aspcud، mccs، aspcud\N'45'old و packup پشتیبانی می‌کند) یا یک دستور سفارشی که باید شامل متغیرهای %{input}%، %{output}%، %{criteria}% و در صورت تمایل %{timeout}% باشد\N'46' این معادل با تنظیم \fB$OPAMEXTERNALSOLVER\fR است\N'46' .TP 4 \fB\N'45'\N'45'strict\fR هر زمان که خطایی در تعریف یک بسته یا فایل پیکربندی یافت شود با شکست مواجه شو\N'46' حالت پیش‌فرض ادامهٔ بدون سر و صدا در صورت امکان است\N'46' .TP 4 \fB\N'45'\N'45'switch\fR=\fISWITCH\fR استفاده از \fISWITCH\fR به‌عنوان سوییچ کامپایلر فعلی\N'46' این معادل با تنظیم \fB$OPAMSWITCH\fR روی \fISWITCH\fR است\N'46' .TP 4 \fB\N'45'\N'45'use\N'45'internal\N'45'solver\fR غیرفعال‌کردن هرگونه حل‌کنندهٔ خارجی و استفاده از حل‌کنندهٔ توکار (این امر مستلزم آن است که opam با یک حل‌کنندهٔ داخلی کامپایل شده باشد)\N'46' این معادل با تنظیم \fB$OPAMNOASPCUD\fR یا \fB$OPAMUSEINTERNALSOLVER\fR است\N'46' .TP 4 \fB\N'45'v\fR, \fB\N'45'\N'45'verbose\fR پرحرفی بیشتر خروجی\N'46' یک بار \fB\N'45'v\fR تمام دستورهای بسته‌ها را نشان می‌دهد، تکرار آن دستورهای فراخوانی‌شده به‌طور داخلی (مانند \fItar\fR، \fIcurl\fR، \fIpatch\fR و غیره) را نیز نمایش می‌دهد\N'46' تکرار به تعداد \fIn\fR بار معادل با تنظیم \fB$OPAMVERBOSE\fR روی "\fIn\fR" است\N'46' .TP 4 \fB\N'45'\N'45'version\fR نمایش اطلاعات نگارش\N'46' .TP 4 \fB\N'45'w\fR, \fB\N'45'\N'45'working\N'45'dir\fR هنگام به‌روزرسانی بسته‌های متصل به یک شاخهٔ محلی تحت کنترل نسخه، به‌جای آخرین وضعیت ثبت‌شده (commit) یا ارجاعی (ref) که به آن اشاره دارند، به وضعیت کاری فعلی سورس آن‌ها به‌روزرسانی شود\N'46' از آنجا که دایرکتوری سورس همان‌طور که هست کپی می‌شود، در صورتی که تمیز نباشد ممکن است به شکست ساخت opam منجر شود\N'46' این فقط بسته‌هایی را تحت تأثیر قرار می‌دهد که به‌صراحت در خط فرمان مشخص شده‌اند\N'46' همچنین می‌تواند با \fB$OPAMWORKINGDIR\fR تنظیم شود\N'46' .TP 4 \fB\N'45'y\fR, \fB\N'45'\N'45'yes\fR پاسخ مثبت (yes) به تمام پرسش‌های بله/خیر opam بدون پرسش از کاربر\N'46' همچنین ببینید: \fB\N'45'\N'45'confirm\N'45'level\fR\N'46' این معادل با تنظیم \fB$OPAMYES\fR روی "true" است\N'46'.SH "محیط (ENVIRONMENT)" .P دستور opam از متغیرهای محیطی فهرست‌شده در اینجا استفاده می‌کند\N'46' متغیرهای بولی (Boolean) برای غیرفعال‌سازی باید روی "0"، "no"، "false" یا یک رشتهٔ خالی و برای فعال‌سازی روی "1"، "yes" یا "true" تنظیم شوند\N'46' .P \fIOPAMALLPARENS\fR تمام فیلترها را درون پرانتز قرار می‌دهد\N'46' .P \fIOPAMASSUMEDEPEXTS\fR گزینهٔ `\N'45'\N'45'assume\N'45'depexts\N'39' را ببینید\N'46' .P \fIOPAMAUTOANSWER\fR فقط برای استفادهٔ داخلی\N'46' .P \fIOPAMAUTOREMOVE\fR گزینهٔ حذف `\N'45'\N'45'auto\N'45'remove\N'39' را ببینید\N'46' .P \fIOPAMBESTEFFORT\fR گزینهٔ `\N'45'\N'45'best\N'45'effort\N'39' را ببینید\N'46' .P \fIOPAMBESTEFFORTPREFIXCRITERIA\fR رشته‌ای را تعیین می‌کند که هنگام تنظیم گزینهٔ `\N'45'\N'45'best\N'45'effort\N'39' باید به معیارها پیشوند شود، و انتظار می‌رود که ویژگی `opam\N'45'query\N'39' را در راه‌حل به حداکثر برساند\N'46' .P \fIOPAMBUILDDOC\fR در \fB2\N'46'1\fR حذف شد\N'46' .P \fIOPAMBUILDTEST\fR در \fB2\N'46'1\fR حذف شد\N'46' .P \fIOPAMCLI\fR گزینهٔ `\N'45'\N'45'cli\N'39' را ببینید\N'46' .P \fIOPAMCOLOR\fR هنگامی که روی \fIalways\fR یا \fInever\fR تنظیم شود، مقداری پیش‌فرض برای گزینهٔ `\N'45'\N'45'color\N'39' تعیین می‌کند\N'46' .P \fIOPAMCONFIRMLEVEL\fR گزینهٔ `\N'45'\N'45'confirm\N'45'level` را ببینید\N'46' \fBOPAMCONFIRMLEVEL\fR بر \fBOPAMYES\fR و \fBOPAMNO\fR اولویت دارد\N'46' .P \fIOPAMCRITERIA\fR اولویت‌های کاربر (\fIpreferences\fR) را برای حل وابستگی‌ها مشخص می‌کند\N'46' مقدار پیش‌فرض به نسخهٔ حل‌کننده بستگی دارد؛ برای دانستن تنظیمات فعلی از `config report\N'39' استفاده کنید\N'46' همچنین گزینهٔ \N'45'\N'45'criteria را ببینید\N'46' .P \fIOPAMCUDFFILE\fR گراف cudf را در \fIfile\fR\N'45'actions\N'45'explicit\N'46'dot ذخیره می‌کند\N'46' .P \fIOPAMCUDFTRIM\fR فیلتر کردن بسته‌های نامرتبط را در طول پیش‌پردازش CUDF کنترل می‌کند\N'46' .P \fIOPAMCURL\fR می‌تواند برای انتخاب یک برنامهٔ \N'39'curl\N'39' مشخص استفاده شود\N'46' برای گزینه‌های بیشتر \fIOPAMFETCH\fR را ببینید\N'46' .P \fIOPAMDEBUG\fR گزینه‌های `\N'45'\N'45'debug\N'39' و `\N'45'\N'45'debug\N'45'level\N'39' را ببینید\N'46' .P \fIOPAMDEBUGSECTIONS\fR در صورت تنظیم، پیام‌های اشکال‌زدایی را به فهرستی از بخش‌ها که با فاصله از هم جدا شده‌اند محدود می‌کند\N'46' بخش‌ها می‌توانند به‌صورت اختیاری یک سطح اشکال‌زدایی خاص داشته باشند (برای نمونه، \fBCLIENT:2\fR یا \fBCLIENT CUDF:2\fR)، اما در غیر این صورت از `\N'45'\N'45'debug\N'45'level\N'39' استفاده می‌کنند\N'46' .P \fIOPAMDIGDEPTH\fR میزان تهاجمی بودن جستجو برای تداخل‌ها را در طول پیش‌پردازش CUDF تعیین می‌کند\N'46' .P \fIOPAMDOWNLOADJOBS\fR بیشینهٔ تعداد بارگیری‌های هم‌زمان را تعیین می‌کند\N'46' .P \fIOPAMDROPWORKINGDIR\fR هنگام به‌روزرسانی، بسته‌هایی را که قبلاً با \fB\N'45'\N'45'working\N'45'dir\fR به‌روزرسانی شده بودند بازنویسی می‌کند\N'46' بدون تنظیم این متغیر، opam آن‌ها را بدون تغییر نگه می‌دارد مگر اینکه صریحاً در خط فرمان نام برده شوند\N'46' .P \fIOPAMDRYRUN\fR گزینهٔ `\N'45'\N'45'dry\N'45'run\N'39' را ببینید\N'46' .P \fIOPAMEDITOR\fR ویرایشگر مورد استفاده برای ویرایش فایل‌های opam را تعیین می‌کند، و بر \fI$EDITOR\fR و \fI$VISUAL\fR اولویت دارد\N'46' .P \fIOPAMERRLOGLEN\fR تعداد خطوط گزارش چاپ‌شده هنگام شکست یک زیرفرآیند را تعیین می‌کند\N'46' 0 برای چاپ همه\N'46' .P \fIOPAMEXTERNALSOLVER\fR گزینهٔ `\N'45'\N'45'solver\N'39' را ببینید\N'46' .P \fIOPAMFAKE\fR گزینهٔ `\N'45'\N'45'fake\N'39' را ببینید\N'46' .P \fIOPAMFETCH\fR نحوهٔ بارگیری فایل‌ها را مشخص می‌کند: یا `wget\N'39'، یا `curl\N'39' یا یک دستور سفارشی که در آن متغیرهای \fB%{url}%\fR، \fB%{out}%\fR، \fB%{retry}%\fR، \fB%{compress}%\fR و \fB%{checksum}%\fR جایگزین خواهند شد\N'46' جایگزین مقدار \N'39'download\N'45'command\N'39' از فایل پیکربندی اصلی می‌شود\N'46' .P \fIOPAMFIXUPCRITERIA\fR همانند \fIOPAMUPGRADECRITERIA\fR، اما مخصوص اصلاح و نصب مجدد\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 به هر سؤالی که پرسیده شود پاسخ خیر می‌دهد، گزینه‌های `\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' در حال حاضر تنها پسانهٔ 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 محتوای متغیر \fIvar\fR را هنگام جایگزینی رشته‌های `%{var}%` در فایل‌های `opam` بازنویسی می‌کند\N'46' .P \fIOPAMVAR_package_var\fR محتوای متغیر \fIpackage:var\fR را هنگام جایگزینی رشته‌های `%{package:var}%` در فایل‌های `opam` بازنویسی می‌کند\N'46'.SH "نسخه خط فرمان (CLI VERSION)" .P تمامی اسکریپت‌ها و فراخوانی‌های برنامه‌نویسی‌شدهٔ opam باید از `\N'45'\N'45'cli\N'39' استفاده کنند تا اطمینان حاصل شود که با نسخه‌های بعدی کلاینت opam بدون مشکل و یکپارچه کار می‌کنند\N'46' علاوه بر این، پست‌های وبلاگ یا سایر مستندات نیز می‌توانند از این ویژگی بهره‌مند شوند، زیرا از قدیمی و منسوخ شدن اطلاعات جلوگیری می‌کند\N'46' .P اگرچه opam برای نسخهٔ کنونی فقط از ریشه‌ها (\fI~/\N'46'opam/\fR) پشتیبانی می‌کند، اما سازگاری عقبروی را برای رابط خط فرمان خود فراهم می‌آورد\N'46' .P از آنجا که پشتیبانی از نسخهٔ CLI تنها در opam 2\N'46'1 افزوده شده است، از \fIOPAMCLI\fR برای انتخاب پشتیبانی از 2\N'46'0 استفاده کنید (زیرا opam 2\N'46'0 صرفاً آن را نادیده می‌گیرد)، و برای نسخه‌های 2\N'46'1 (یا جدیدتر) از `\N'45'\N'45'cli=2\N'46'1\N'39' استفاده کنید، چرا که متغیر محیطی کنترل‌کنندهٔ تجزیهٔ نحو شکننده است\N'46' بدین منظور، اگر \fIOPAMCLI\fR نسخهٔ معتبری به‌جز 2\N'46'0 را مشخص کند، و همچنین اگر `\N'45'\N'45'cli=2\N'46'0\N'39' مشخص شده باشد، opam هشداری نمایش می‌دهد\N'46' .P نسخهٔ خط فرمان با استفاده از گزینهٔ `\N'45'\N'45'cli\N'39' یا متغیر محیطی \fIOPAMCLI\fR انتخاب می‌شود\N'46' گزینهٔ `\N'45'\N'45'cli\N'39' ممکن است بیش از یک‌بار مشخص شود که در این حالت آخرین مورد اولویت خواهد داشت\N'46' متغیر \fIOPAMCLI\fR تنها در صورتی بررسی می‌شود که `\N'45'\N'45'cli\N'39' مشخص نشده باشد\N'46' .SH "وضعیت خروج (EXIT STATUS)" .P به‌عنوان استثنایی بر موارد زیر، دستور `exec\N'39' در صورتی که دستور یافت نشود یا قابل اجرا نباشد، مقدار 127 را بازمی‌گرداند و در غیر این صورت، مقدار خروج خود دستور بازگردانده می‌شود\N'46' .TP 4 0 موفقیت، یا درست (true) برای پرسمان‌های بولی\N'46' .TP 4 1 نادرست (False)\N'46' زمانی بازگردانده می‌شود که یک مقدار بازگشتی بولی مورد انتظار باشد، برای مثال هنگام اجرا با \fB\N'45'\N'45'check\fR، یا برای پرسمان‌هایی مانند \fBopam lint\fR\N'46' .TP 4 2 آرگومان‌های نامعتبر خط فرمان، یا آرگومان‌های خط فرمانی که به زمینه‌ای نامعتبر اشاره دارند (مانند فایلی که از قالب مورد انتظار پیروی نمی‌کند)\N'46' .TP 4 5 یافت نشد\N'46' موردی را درخواست کرده‌اید (بسته، نسخه، مخزن، و غیره\N'46') که پیدا نشد\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' دریافت برخی از مخازن دوردست (remotes) از شبکه ممکن نشد\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(1) .SH "گزارش باگ‌ها (BUGS)" .P گزارش‌های باگ را در https://github.com/ocaml/opam/issues بررسی کنید.