.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "OPAM ADMIN-UPDATE-EXTRAFILES" 1 "" "Opam admin 2.5.2" "Opam admin Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
.P
opam admin\N'45'update\N'45'extrafiles \- افزودن extra-files به یک مخزن opam
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBopam admin update\N'45'extrafiles\fR [\fB\N'45'\N'45'hash\fR=\fIHASH_ALGO\fR] [\fB\N'45'\N'45'packages\fR=\fIPACKAGES\fR] [\fIOPTION\fR]…
.SH "توضیحات (DESCRIPTION)"
.P
این دستور تعاریف بسته‌ها را پیمایش کرده و فیلد extrafiles را بر اساس درخواست اضافه می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP 4
\fB\N'45'\N'45'hash\fR=\fIHASH_ALGO\fR
درهم‌سازی (هش) یا درهم‌سازی‌هایی که باید اضافه شوند.
.TP 4
\fB\N'45'p\fR \fIPACKAGES\fR, \fB\N'45'\N'45'packages\fR=\fIPACKAGES\fR
فقط برای بسته‌های داده‌شده فایل‌های اضافی اضافه شود.
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.P
این گزینه‌ها میان همهٔ دستورها مشترک هستند.
.TP 4
\fB\N'45'\N'45'best\N'45'effort\fR
در صورتی که همه بسته‌های درخواستی قابل نصب نباشند با شکست مواجه نشو: تلاش کن تا جای ممکن بیشترین تعداد بسته نصب شوند. توجه داشته باشید که ممکن است همه حل‌کننده‌های خارجی از این گزینه پشتیبانی نکنند (نسخه‌های اخیر \fIaspcud\fR یا \fImccs\fR باید پشتیبانی کنند). این معادل تنظیم متغیر محیطی \fB$OPAMBESTEFFORT\fR است.
.TP 4
\fB\N'45'\N'45'cli\fR=\fIMAJOR\N'46'MINOR\fR (پیش‌فرض=\fB2\N'46'5\fR)
استفاده از نحو و معناشناسی رابط خط فرمان \fIMAJOR\N'46'MINOR\fR. این گزینه برای هرگونه استفاده ماندگار از opam (اسکریپت‌ها، پست‌های وبلاگ و غیره) در نظر گرفته شده است؛ هر نسخه‌ای از opam در همان سری MAJOR مشابه انتشار MINOR مشخص‌شده رفتار خواهد کرد. این پرچم در opam 2.0 در دسترس نبود، بنابراین برای انتخاب CLI نسخه 2.0، به جای استفاده از این پارامتر متغیر محیطی \fBOPAMCLI\fR را روی \fI2\N'46'0\fR تنظیم کنید.
.TP 4
\fB\N'45'\N'45'color\fR=\fIWHEN\fR
رنگی کردن خروجی. \fIWHEN\fR باید یکی از مقادیر \fBalways\fR، \fBnever\fR یا \fBauto\fR باشد.
.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 باشد. می‌تواند بیش از یک بار مشخص شود. اگر \fB\N'45'\N'45'yes\fR یا \fB\N'45'\N'45'no\fR نیز داده شوند، مقدار آخرین \fB\N'45'\N'45'confirm\N'45'level\fR لحاظ می‌شود. این معادل تنظیم متغیر محیطی \fB$OPAMCONFIRMLEVEL\fR است.
.TP 4
\fB\N'45'\N'45'criteria\fR=\fICRITERIA\fR
مشخص کردن \fIترجیحات\fR کاربر برای حل وابستگی‌ها در این اجرا. متغیرهای \fB$OPAMCRITERIA\fR، \fB$OPAMFIXUPCRITERIA\fR و \fB$OPAMUPGRADECRITERIA\fR را لغو می‌کند (override). برای جزئیات در مورد زبان پشتیبانی‌شده و حل‌کننده‌های خارجی موجود، ببینید: \fIhttp://opam\N'46'ocaml\N'46'org/doc/External_solvers\N'46'html\fR. راهنمای کلی برای استفاده از ترجیحات حل‌کننده را می‌توانید در \fIhttp://www\N'46'dicosmo\N'46'org/Articles/usercriteria\N'46'pdf\fR بیابید.
.TP 4
\fB\N'45'\N'45'cudf\fR=\fIFILENAME\fR
گزینه اشکال‌زدایی: ذخیره درخواست‌های CUDF ارسال‌شده به حل‌کننده در \fIFILENAME\fR\N'45'<n>\N'46'cudf، که در آن <n> نشان‌دهنده n\N'45'اُمین فراخوانی حل‌کننده در طول اجرای opam است.
.TP 4
\fB\N'45'\N'45'debug\fR
چاپ پیام‌های اشکال‌زدایی در stderr. این معادل تنظیم \fB$OPAMDEBUG\fR روی "true" است.
.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 آن را روی ۱ تنظیم می‌کند). معادل تنظیم \fB$OPAMDEBUG\fR روی یک عدد صحیح مثبت است.
.TP 4
\fB\N'45'\N'45'git\N'45'version\fR
در صورت تنظیم بودن نسخه git برنامه opam (یعنی اگر از نسخه توسعه استفاده می‌کنید)، آن را چاپ کرده و خارج شو.
.TP 4
\fB\N'45'\N'45'help\fR[=\fIFMT\fR] (پیش‌فرض=\fBauto\fR)
نمایش این راهنما در قالب \fIFMT\fR. مقدار \fIFMT\fR باید یکی از \fBauto\fR، \fBpager\fR، \fBgroff\fR یا \fBplain\fR باشد. با \fBauto\fR، هرگاه متغیر محیطی \fBTERM\fR مقدار \fBdumb\fR داشته باشد یا تعریف نشده باشد، قالب برابر با \fBpager\fR یا \fBplain\fR خواهد بود.
.TP 4
\fB\N'45'\N'45'ignore\N'45'pin\N'45'depends\fR
نادیده گرفتن سنجاق‌کردن‌های (pin) اضافی مورد نیاز بسته‌هایی که سنجاق می‌شوند، چه به صورت دستی از طریق \fIopam pin\fR یا از طریق \fIopam install DIR\fR. این معادل تنظیم \fBIGNOREPINDEPENDS=true\fR است.
.TP 4
\fB\N'45'\N'45'json\fR=\fIFILENAME\fR
ذخیره نتایج اجرای opam در یک فایل خوانا برای رایانه. اگر نام فایل شامل نویسه «%» باشد، با نمایه‌ای جایگزین می‌شود که روی فایل موجود بازنویسی نکند. مشابه تنظیم متغیر \fB$OPAMJSON\fR است.
.TP 4
\fB\N'45'\N'45'no\fR
پاسخ منفی به تمام پرسش‌های بله/خیر opam بدون پرسش از کاربر. همچنین ببینید \fB\N'45'\N'45'confirm\N'45'level\fR. این معادل تنظیم \fB$OPAMNO\fR روی "true" است.
.TP 4
\fB\N'45'\N'45'no\N'45'aspcud\fR
در نسخه \fB2\N'46'1\fR حذف شد.
.TP 4
\fB\N'45'\N'45'no\N'45'auto\N'45'upgrade\fR
هنگام پیکربندی یا به‌روزرسانی مخزنی که برای نسخه‌های پیشین opam (نسخهٔ 1.2) نوشته شده است، opam به صورت درونی آن را به قالب فعلی تبدیل می‌کند. این گزینه این رفتار را غیرفعال می‌کند. توجه داشته باشید که مخازن باید نسخه قالب خود را در یک فایل 'repo' در ریشه خود مشخص کنند، در غیر این صورت فرض می‌شود که در قالب قدیمی هستند. در هر صورت، بهتر است در صورت امکان مخازن را با استفاده از \fIopam admin upgrade [\N'45'\N'45'mirror URL]\fR به صورت دستی ارتقا دهید.
.TP 4
\fB\N'45'q\fR, \fB\N'45'\N'45'quiet\fR
غیرفعال‌سازی \fB\N'45'\N'45'verbose\fR.
.TP 4
\fB\N'45'\N'45'root\fR=\fIROOT\fR
استفاده از \fIROOT\fR به عنوان مسیر ریشه فعلی. این معادل تنظیم \fB$OPAMROOT\fR روی \fIROOT\fR است.
.TP 4
\fB\N'45'\N'45'safe\fR, \fB\N'45'\N'45'readonly\fR
اطمینان حاصل می‌کند که هیچ چیزی به طور خودکار به‌روزرسانی یا بازنویسی نشود. برای نمونه جهت فراخوانی از اسکریپت‌های تکمیل خودکار مفید است. در صورت نیاز به چنین عملیاتی با شکست مواجه می‌شود؛ همچنین از انتظار برای قفل‌ها جلوگیری کرده، پرسش‌های تعاملی را رد می‌کند و متغیر \fB$OPAMDEBUG\fR را لغو می‌کند. این معادل تنظیم متغیر محیطی \fB$OPAMSAFE\fR است.
.TP 4
\fB\N'45'\N'45'solver\fR=\fICMD\fR
مشخص کردن حل‌کننده CUDF برای حل مشکلات نصب بسته. این مقدار می‌تواند یک حل‌کننده از پیش تعریف‌شده باشد (این نسخه از 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}% باشد. این معادل تنظیم \fB$OPAMEXTERNALSOLVER\fR است.
.TP 4
\fB\N'45'\N'45'strict\fR
هر زمان خطایی در تعریف یک بسته یا یک فایل پیکربندی پیدا شود، با شکست متوقف شو. پیش‌فرض این است که در صورت امکان بدون هشدار ادامه داده شود.
.TP 4
\fB\N'45'\N'45'switch\fR=\fISWITCH\fR
استفاده از \fISWITCH\fR به عنوان سوییچ کامپایلر فعلی. این معادل تنظیم \fB$OPAMSWITCH\fR روی \fISWITCH\fR است.
.TP 4
\fB\N'45'\N'45'use\N'45'internal\N'45'solver\fR
غیرفعال کردن هرگونه حل‌کننده خارجی و استفاده از حل‌کننده داخلی (این امر مستلزم آن است که opam با یک حل‌کننده داخلی کامپایل شده باشد). این معادل تنظیم \fB$OPAMNOASPCUD\fR یا \fB$OPAMUSEINTERNALSOLVER\fR است.
.TP 4
\fB\N'45'v\fR, \fB\N'45'\N'45'verbose\fR
پرگویی بیشتر در خروجی. یک بار استفاده از \fB\N'45'v\fR تمام دستورهای بسته را نشان می‌دهد؛ تکرار آن دستورهایی را که به صورت درونی فراخوانی می‌شوند نیز نمایش می‌دهد (برای مثال \fItar\fR، \fIcurl\fR، \fIpatch\fR و غیره). تکرار به تعداد \fIn\fR بار معادل تنظیم \fB$OPAMVERBOSE\fR روی "\fIn\fR" است.
.TP 4
\fB\N'45'\N'45'version\fR
نمایش اطلاعات نسخه.
.TP 4
\fB\N'45'w\fR, \fB\N'45'\N'45'working\N'45'dir\fR
هنگام به‌روزرسانی بسته‌هایی که به یک دایرکتوری محلی و تحت کنترل نسخه متصل هستند، به جای آخرین وضعیت ثبت‌شده (commit) یا مرجعی که به آن اشاره می‌کنند، به وضعیت کاری فعلی منبع آنها به‌روزرسانی شود. از آنجا که دایرکتوری منبع همان‌گونه که هست کپی می‌شود، تمیز نبودن آن ممکن است منجر به شکست ساخت در opam شود. این گزینه فقط بر بسته‌هایی تأثیر می‌گذارد که صریحاً در خط فرمان ذکر شده‌اند. همچنین می‌تواند با \fB$OPAMWORKINGDIR\fR تنظیم شود.
.TP 4
\fB\N'45'y\fR, \fB\N'45'\N'45'yes\fR
پاسخ مثبت به تمام پرسش‌های بله/خیر opam بدون پرسش از کاربر. همچنین ببینید \fB\N'45'\N'45'confirm\N'45'level\fR. این معادل تنظیم \fB$OPAMYES\fR روی "true" است..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' مقدار پیش‌فرض به نسخهٔ حل‌کننده (solver) بستگی دارد؛ برای اطلاع از تنظیم فعلی از `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 حداکثر تعداد کارگرهای موازی (parallel 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' این کار برخی از بخش‌های نهایی‌سازی (finaliser) را نادیده می‌گیرد و همچنین ممکن است به دریافت ردگیری‌های پشتهٔ (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 ارتقای خودکار داخلی مخازنی که قالب قدیمی‌تری دارند به قالب فعلی را در هنگام `update` یا `init` غیرفعال می‌کند\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 این متغیر را روی false تنظیم کنید تا پیش‌پردازش CUDF غیرفعال شود\N'46' کارایی کمتری دارد، اما ممکن است به اشکال‌زدایی مشکلات حل‌کننده کمک کند\N'46'
.P
\fIOPAMREPOSITORYTARRING\fR مخازن را به طور داخلی به صورت فایل‌های tar\N'46'gz ذخیره می‌کند\N'46' این ویژگی در سیستم‌های فایلی که با پیمایش درخت‌های بزرگ عملکرد خوبی ندارند اما دارای حافظهٔ موقت مناسبی در /tmp هستند می‌تواند بسیار سریع‌تر باشد\N'46' با این حال در حالت عمومی کندتر عمل می‌کند\N'46'
.P
\fIOPAMREQUIRECHECKSUMS\fR گزینهٔ `\N'45'\N'45'require\N'45'checksums\N'39' را در صورت در دسترس بودن فعال می‌کند (برای نمونه برای `opam install\N'39')\N'46'
.P
\fIOPAMRETRIES\fR تعداد دفعات تلاش پیش از شکست بارگیری‌ها را مشخص می‌کند\N'46'
.P
\fIOPAMREUSEBUILDDIR\fR گزینهٔ `\N'45'\N'45'reuse\N'45'build\N'45'dir\N'39' را ببینید\N'46'
.P
\fIOPAMROOT\fR گزینهٔ `\N'45'\N'45'root\N'39' را ببینید\N'46' این مقدار به طور خودکار توسط `opam env \N'45'\N'45'root=DIR \N'45'\N'45'set\N'45'root\N'39' تنظیم می‌شود\N'46'
.P
\fIOPAMROOTISOK\fR هنگام اجرا به عنوان کاربر ریشه (root) هشداری صادر نمی‌کند\N'46'
.P
\fIOPAMSAFE\fR گزینهٔ `\N'45'\N'45'safe\N'39' را ببینید\N'46'
.P
\fIOPAMSHOW\fR گزینهٔ `\N'45'\N'45'show\N'39' را ببینید\N'46'
.P
\fIOPAMSKIPUPDATE\fR گزینهٔ `\N'45'\N'45'skip\N'45'updates\N'39' را ببینید\N'46'
.P
\fIOPAMSKIPVERSIONCHECKS\fR برخی از بررسی‌های نسخه را نادیده می‌گیرد\N'46' ناامن است و صرفاً برای آزمودن سازگاری به کار می‌رود\N'46'
.P
\fIOPAMSOLVERALLOWSUBOPTIMAL\fR (پیش‌فرض `true\N'39') به برخی از حل‌کننده‌ها امکان می‌دهد که در صورت اتمام مهلت زمانی (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' به همین منظور، چنانچه \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 برای پرس‌وجوهای بولی (boolean)\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
در صورت بروز خطاهای نامشخص گزارش‌شده روی خروجی استاندارد خطا (standard error)\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 admin(1)
.SH "گزارش باگ‌ها (BUGS)"
.P
گزارش‌های باگ را در https://github\N'46'com/ocaml/opam/issues بررسی کنید.