.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R .\" .mso an.tmac .TH "OPAM-UPGRADE" 1 "" "Opam 2.5.2" "Opam Manual" .\" Disable hyphenation and ragged-right .nh .ad l .SH "نام (NAME)" opam-upgrade \- ارتقای بسته‌های نصب‌شده به آخرین نسخه .SH "خلاصه دستور (SYNOPSIS)" .P \fBopam upgrade\fR [\fIگزینه‌ها\fR]… [\fIبسته‌ها\fR]… .SH "توضیحات (DESCRIPTION)" .P این دستور بسته‌های نصب‌شده را به جدیدترین نسخه‌های موجود ارتقا می‌دهد. به طور دقیق‌تر، این دستور حل‌کننده وابستگی را فراخوانی می‌کند تا وضعیتی سازگار بیابد که در آن \fIبیشتر\fR بسته‌های نصب‌شده به آخرین نسخه‌های خود ارتقا یابند. .P اگر یک دایرکتوری به عنوان آرگومان مشخص شود، هر آنچه که به آن دایرکتوری پین (pin) شده باشد برای ارتقا انتخاب می‌شود. .SH "آرگومان‌ها (ARGUMENTS)" .TP 4 \fIPACKAGES\fR فهرستی از نام بسته‌ها با نسخه اختیاری یا قید محدودیت، مانند `pkg`، `pkg.1.0` یا `pkg>=0.5`؛ یا نام دایرکتوری‌های حاوی توصیف بسته با دایرکتوری صریح (مانند `srcdir/.` یا `.`). .SH "گزینه‌ها (OPTIONS)" .TP 4 \fB\N'45'a\fR, \fB\N'45'\N'45'all\fR اجرای ارتقا برای تمام بسته‌های نصب‌شده. اگر \fIPACKAGES\fR مشخص نشده باشد، این حالت پیش‌فرض است، و می‌تواند در ترکیب با \fIPACKAGES\fR برای ارتقا همراه با اطمینان از نصب شدن یا ماندن برخی بسته‌ها مفید باشد. .TP 4 \fB\N'45'\N'45'check\fR ارتقا را اجرا نکنید؛ فقط بررسی کنید که آیا چیزی قابل ارتقا هست یا خیر. در صورتی که بسته‌ای قابل ارتقا باشد مقدار 0 و اگر چیزی برای ارتقا وجود نداشته باشد مقدار 1 برمی‌گرداند. .TP 4 \fB\N'45'\N'45'fixup\fR بازیابی از وضعیت خراب (مانند وابستگی‌های مفقود، دو بسته ناسازگار نصب‌شده هم‌زمان و غیره). .TP 4 \fB\N'45'\N'45'formula\fR=\fIFORMULA\fR (absent=\fB[]\fR) \fBآزمایشی\fR. تعیین یک فرمول وابستگی برای اعتبارسنجی توسط راه‌حل، علاوه بر ناوردای سوییچ (switch invariant). قالب آن همانند بیان وابستگی‌ها در فایل‌های تعریف بسته است، برای مثال \N'39'"foo" {>= "1.1"}\N'39'. .TP 4 \fB\N'45'\N'45'installed\fR هنگامی که یک دایرکتوری به عنوان آرگومان ارائه می‌شود، بسته‌های پین‌شده‌ای که هنوز نصب نشده‌اند نصب نشوند. .TP 4 \fB\N'45'\N'45'recursive\fR اجازه جستجوی بازگشتی فایل‌های \fB*.opam\fR داده شود. همچنین به \fI\N'45'\N'45'subpath\fR مراجعه کنید. .TP 4 \fB\N'45'\N'45'subpath\fR=\fIPATH\fR فایل‌های \fB*.opam\fR به جای دایرکتوری ریشه از زیردایرکتوری داده‌شده بازیابی می‌شوند. سپس کد مبدأ از زیردایرکتوری هدف گرفته می‌شود، و در داخل فقط این زیردایرکتوری کپی/واکشی می‌گردد. می‌تواند با \fI\N'45'\N'45'recursive\fR ترکیب شود تا جستجوی بازگشتی روی زیرمسیر انجام پذیرد. .SH "گزینه‌های ساخت بسته (PACKAGE BUILD OPTIONS)" .TP 4 \fB\N'45'\N'45'assume\N'45'depexts\fR از مرحله نصب برای بسته‌های سیستمی مفقود صرف‌نظر کرده و در هر صورت کامپایل بسته‌های opam ادامه یابد. در صورت موفقیت‌آمیز بودن نصب، opam دیگر درباره این بسته‌های سیستمی پیامی نمایش نخواهد داد. این گزینه تنها در صورت فعال بودن مدیریت وابستگی‌های خارجی معنادار است. .TP 4 \fB\N'45'b\fR, \fB\N'45'\N'45'keep\N'45'build\N'45'dir\fR نگهداری دایرکتوری‌های ساخت پس از کامپایل بسته‌ها. این معادل تنظیم \fB$OPAMKEEPBUILDDIR\fR روی "true" است. .TP 4 \fB\N'45'\N'45'build\N'45'doc\fR در نسخه \fB2.1\fR حذف شد، به جای آن از \fI\N'45'\N'45'with\N'45'doc\fR استفاده کنید. .TP 4 \fB\N'45'\N'45'build\N'45'test\fR در نسخه \fB2.1\fR حذف شد، به جای آن از \fI\N'45'\N'45'with\N'45'test\fR استفاده کنید. .TP 4 \fB\N'45'd\fR, \fB\N'45'\N'45'with\N'45'doc\fR ساخت مستندات بسته. این گزینه فقط بر بسته‌های مشخص‌شده در خط فرمان تأثیر می‌گذارد. این معادل تنظیم \fB$OPAMWITHDOC\fR (یا گزینه منسوخ‌شده \fB$OPAMBUILDDOC\fR) روی "true" است. .TP 4 \fB\N'45'\N'45'dry\N'45'run\fR شبیه‌سازی دستور، بدون اعمال هیچ‌گونه تغییر واقعی. همچنین می‌تواند با متغیر محیطی \fB$OPAMDEBUG\fR تنظیم شود. .TP 4 \fB\N'45'\N'45'fake\fR این گزینه عملیات را در پایگاه‌داده opam ثبت می‌کند بدون اینکه عملاً آن‌ها را انجام دهد. هشدار: این گزینه خطرناک است و احتمال خراب شدن محیط opam شما وجود دارد. شما احتمالاً به \fB\N'45'\N'45'dry\N'45'run\fR نیاز دارید. به شما \fIهشدار\fR داده شد. .TP 4 \fB\N'45'\N'45'ignore\N'45'constraints\N'45'on\fR[=\fIPACKAGES\fR] (default=\fB\fR) نرم‌افزار opam را مجبور می‌کند که محدودیت‌های نسخه را روی تمام وابستگی‌های بسته‌های فهرست‌شده نادیده بگیرد. این گزینه را می‌توان برای آزمایش سازگاری به کار برد، اما در هنگام استفاده انتظار شکست در ساخت را داشته باشید. توجه داشته باشید که موجود بودن بسته‌ها و همچنین محدودیت‌های نسخه روی وابستگی‌های اختیاری و تعارض‌ها تحت تأثیر قرار نمی‌گیرند. این معادل تنظیم \fB$OPAMIGNORECONSTRAINTS\fR است. .TP 4 \fB\N'45'\N'45'inplace\N'45'build\fR هنگام کامپایل بسته‌ای که منبع آن به یک دایرکتوری محلی متصل است، عملیات ساخت و نصب را مستقیماً در همان دایرکتوری انجام دهید، نه در یک رونوشت تمیز که توسط opam مدیریت می‌شود. این گزینه فقط بر بسته‌هایی اثر می‌گذارد که صریحاً در خط فرمان فهرست شده‌اند. این معادل تنظیم \fB$OPAMINPLACEBUILD\fR روی "true" است. .TP 4 \fB\N'45'j\fR \fIJOBS\fR, \fB\N'45'\N'45'jobs\fR=\fIJOBS\fR تعیین حداکثر تعداد کارهای همزمان برای اجرا. مقدار پیش‌فرض بر اساس تعداد هسته‌ها محاسبه می‌شود. همچنین می‌توانید آن را با متغیر محیطی \fB$OPAMJOBS\fR تنظیم کنید. .TP 4 \fB\N'45'\N'45'lock\N'45'suffix\fR=\fISUFFIX\fR (absent=\fBlocked\fR) تنظیم پسوند فایل‌های قفل‌شده روی \fISUFFIX\fR. .TP 4 \fB\N'45'\N'45'locked\fR در دستوراتی که از فایل‌های opam حاصل از منابع پین‌شده استفاده می‌کنند، در صورتی که نسخه‌ای از فایل با پسوند افزوده \N'46'\fIlocked\fR یافت شود (مانند \fBfoo.opam.locked\fR در کنار \fBfoo.opam\fR)، از آن استفاده خواهد شد. این گزینه برای ارائه مجموعه‌ای مشخص‌تر از وابستگی‌ها و بازتولید شرایط یکسان ساخت بسیار سودمند است. از گزینه \fIlock\fR می‌توان برای تولید این فایل‌ها بر پایه نسخه‌های وابستگی‌های فعلی نصب‌شده روی میزبان استفاده کرد. این معادل تنظیم متغیر محیطی \fB$OPAMLOCKED\fR است. توجه داشته باشید که این گزینه معمولاً بر بسته‌هایی که پیش‌تر پین شده‌اند تأثیری ندارد. .TP 4 \fB\N'45'm\fR \fIMAKE\fR, \fB\N'45'\N'45'make\fR=\fIMAKE\fR در نسخه \fB2.1\fR حذف شد، به جای آن از \fIopam config set[\N'45'global] make MAKE\fR استفاده کنید. .TP 4 \fB\N'45'\N'45'no\N'45'checksums\fR چک‌سام (checksum) آرشیوهای بارگیری‌شده بررسی نشود. این معادل تنظیم \fB$OPAMNOCHECKSUMS\fR روی "true" است. .TP 4 \fB\N'45'\N'45'no\N'45'depexts\fR مدیریت وابستگی‌های خارجی را به‌طور موقت غیرفعال می‌کند. این گزینه زمانی کاربرد دارد که بسته‌ای در مدیر بسته سیستم‌عامل شما موجود نباشد، اما وابستگی لازم را دستی نصب کرده باشید. این گزینه به طور ضمنی \fB\N'45'\N'45'assume\N'45'depexts\fR را فعال می‌کند و موارد استثنا را نیز در صورت موفقیت ذخیره می‌نماید. .TP 4 \fB\N'45'\N'45'require\N'45'checksums\fR رد کردن نصب بسته‌هایی که برای آرشیوهای بالادست خود چک‌سام ارائه نمی‌دهند. این معادل تنظیم \fB$OPAMREQUIRECHECKSUMS\fR روی "true" است. .TP 4 \fB\N'45'\N'45'reuse\N'45'build\N'45'dir\fR استفاده مجدد از دایرکتوری‌های ساخت موجود (که با استفاده از \fB\N'45'\N'45'keep\N'45'build\N'45'dir\fR نگه داشته شده‌اند)، به جای کامپایل از یک کلون تازه از سورس. این روش می‌تواند سریع‌تر باشد، اما اگر سیستم‌های ساخت بسته‌ها ارتقای وابستگی‌ها را به درستی پشتیبانی نکنند ممکن است به خطا بیانجامد. این معادل تنظیم \fB$OPAMREUSEBUILDDIR\fR روی "true" است. .TP 4 \fB\N'45'\N'45'show\N'45'actions\fR فراخوانی حل‌کننده و نمایش اقدامات. هیچ تغییری اعمال نشود. این معادل تنظیم \fB$OPAMSHOW\fR است. .TP 4 \fB\N'45'\N'45'skip\N'45'updates\fR هنگام اجرای نصب، ارتقا یا نصب مجدد بسته‌های پین‌شده به سورس، معمولاً ابتدا از مبدأ به‌روزرسانی می‌شوند. این فلگ این رفتار را غیرفعال کرده و نسخه آن‌ها را در حافظه پنهان نگه می‌دارد. این معادل تنظیم \fB$OPAMSKIPUPDATE\fR است. .TP 4 \fB\N'45't\fR, \fB\N'45'\N'45'with\N'45'test\fR ساخت و \fBاجرای\fR آزمون‌های واحد (unit-tests) بسته. این گزینه فقط بر بسته‌های مشخص‌شده در خط فرمان اثر می‌گذارد. این معادل تنظیم \fB$OPAMWITHTEST\fR (یا گزینه منسوخ‌شده \fB$OPAMBUILDTEST\fR) روی "true" است. .TP 4 \fB\N'45'\N'45'unlock\N'45'base\fR در نسخه \fB2.1\fR حذف شد، به جای آن از \fI\N'45'\N'45'update\N'45'invariant\fR استفاده کنید. .TP 4 \fB\N'45'\N'45'update\N'45'invariant\fR اجازه اعمال تغییرات روی بسته‌های تنظیم‌شده به عنوان پایه سوییچ (معمولاً کامپایلر اصلی). با احتیاط استفاده شود. این معادل تنظیم متغیر محیطی \fB$OPAMUNLOCKBASE\fR است. .TP 4 \fB\N'45'\N'45'verbose\N'45'on\fR=\fIPACKAGES\fR نمایش خروجی با جزئیات بیشتر برای بسته‌های مشخص. این معادل تنظیم \fB$OPAMVERBOSE\fR است. .TP 4 \fB\N'45'\N'45'with\N'45'dev\N'45'setup\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 (absent=\fB2\N'46'5\fR) استفاده از نحو و معناشناسی رابط خط فرمان \fIMAJOR.MINOR\fR. این قابلیت برای هرگونه استفاده دائمی از opam (اسکریپت‌ها، مقالات و غیره) در نظر گرفته شده است؛ هر نسخه‌ای از opam در همان سری MAJOR مشابه نسخه MINOR مشخص‌شده رفتار خواهد کرد. این فلگ در opam 2.0 موجود نبود، بنابراین برای انتخاب CLI نسخه 2.0، متغیر محیطی \fBOPAMCLI\fR را به جای استفاده از این پارامتر روی \fI2.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 تعیین ترجیحات (\fIpreferences\fR) کاربر برای حل وابستگی در این اجرا. متغیرهای \fB$OPAMCRITERIA\fR، \fB$OPAMFIXUPCRITERIA\fR و \fB$OPAMUPGRADECRITERIA\fR را بازنویسی می‌کند. برای جزئیات زبان پشتیبانی‌شده و حل‌کننده‌های خارجی موجود، به \fIhttp://opam.ocaml.org/doc/External_solvers.html\fR مراجعه کنید. راهنمای کلی برای استفاده از ترجیحات حل‌کننده را می‌توان در \fIhttp://www.dicosmo.org/Articles/usercriteria.pdf\fR یافت. .TP 4 \fB\N'45'\N'45'cudf\fR=\fIFILENAME\fR گزینه اشکال‌زدایی: ذخیره درخواست‌های CUDF ارسال‌شده به حل‌کننده در \fIFILENAME\fR\N'45'\N'46'cudf که در آن شماره n-امین فراخوانی حل‌کننده در طول اجرای 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 آن را روی 1 تنظیم می‌کند). معادل تنظیم \fB$OPAMDEBUG\fR روی یک عدد صحیح مثبت است. .TP 4 \fB\N'45'\N'45'git\N'45'version\fR چاپ نسخه گیت opam، در صورت تنظیم بودن (یعنی استفاده از نسخه در حال توسعه)، و سپس خروج. .TP 4 \fB\N'45'\N'45'help\fR[=\fIFMT\fR] (default=\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 نادیده گرفتن پین‌های اضافی مورد نیاز بسته‌هایی که پین می‌شوند، چه به صورت دستی از طریق \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.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'\N'45'no\N'45'self\N'45'upgrade\fR نرم‌افزار opam در صورت وجود، خود را با باینری جدیدتری که در \fBOPAMROOT/opam\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-mccs+lp()، builtin-mccs+glpk، builtin-dummy-z3-solver، builtin-0install، aspcud، mccs، aspcud-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 از متغیرهای محیطی ذکرشده در این بخش استفاده می‌کند. متغیرهای بولی برای غیرفعال‌سازی باید روی "0"، "no"، "false" یا رشته خالی، و برای فعال‌سازی روی "1"، "yes" یا "true" تنظیم شوند. .P \fIOPAMALLPARENS\fR تمام فیلترها را درون پرانتز قرار می‌دهد. .P \fIOPAMASSUMEDEPEXTS\fR به گزینه `\N'45'\N'45'assume\N'45'depexts` مراجعه کنید. .P \fIOPAMAUTOANSWER\fR فقط برای استفاده داخلی. .P \fIOPAMAUTOREMOVE\fR به گزینه حذف `\N'45'\N'45'auto\N'45'remove` مراجعه کنید. .P \fIOPAMBESTEFFORT\fR به گزینه `\N'45'\N'45'best\N'45'effort` مراجعه کنید. .P \fIOPAMBESTEFFORTPREFIXCRITERIA\fR رشته‌ای را مشخص می‌کند که در صورت تنظیم گزینه `\N'45'\N'45'best\N'45'effort` باید به ابتدای معیارها اضافه شود و انتظار می‌رود مقدار ویژگی `opam-query` را در راه‌حل به بیشینه برساند. .P \fIOPAMBUILDDOC\fR در نسخه \fB2.1\fR حذف شد. .P \fIOPAMBUILDTEST\fR در نسخه \fB2.1\fR حذف شد. .P \fIOPAMCLI\fR به گزینه `\N'45'\N'45'cli` مراجعه کنید. .P \fIOPAMCOLOR\fR هنگامی که روی \fIalways\fR یا \fInever\fR تنظیم شود، مقدار پیش‌فرضی را برای گزینه `\N'45'\N'45'color` تعیین می‌کند. .P \fIOPAMCONFIRMLEVEL\fR به گزینه `\N'45'\N'45'confirm\N'45'level` مراجعه کنید. متغیر \fBOPAMCONFIRMLEVEL\fR نسبت به \fBOPAMYES\fR و \fBOPAMNO\fR اولویت دارد. .P \fIOPAMCRITERIA\fR ترجیحات (\fIpreferences\fR) کاربر را برای حل وابستگی‌ها مشخص می‌کند. مقدار پیش‌فرض به نسخه حل‌کننده وابسته است؛ برای مشاهده تنظیمات فعلی از `config report` استفاده کنید. همچنین به گزینه \N'45'\N'45'criteria مراجعه کنید. .P \fIOPAMCUDFFILE\fR گراف cudf را در \fIfile\fR\N'45'actions\N'45'explicit\N'46'dot ذخیره می‌کند. .P \fIOPAMCUDFTRIM\fR فیلتر کردن بسته‌های نامرتبط را در طول پیش‌پردازش CUDF کنترل می‌کند. .P \fIOPAMCURL\fR می‌تواند برای انتخاب برنامه curl مشخصی به کار رود. برای گزینه‌های بیشتر به \fIOPAMFETCH\fR مراجعه کنید. .P \fIOPAMDEBUG\fR به گزینه‌های `\N'45'\N'45'debug` و `\N'45'\N'45'debug\N'45'level` مراجعه کنید. .P \fIOPAMDEBUGSECTIONS\fR در صورت تنظیم، پیام‌های اشکال‌زدایی را به فهرستی از بخش‌های جداشده با فاصله محدود می‌کند. بخش‌ها می‌توانند به طور اختیاری سطح اشکال‌زدایی مشخصی داشته باشند (برای مثال \fBCLIENT:2\fR یا \fBCLIENT CUDF:2\fR)، در غیر این صورت از `\N'45'\N'45'debug\N'45'level` استفاده می‌شود. .P \fIOPAMDIGDEPTH\fR میزان دقت و تهاجمی بودن جستجو برای تعارض‌ها را در حین پیش‌پردازش CUDF تعیین می‌کند. .P \fIOPAMDOWNLOADJOBS\fR حداکثر تعداد بارگیری‌های هم‌زمان را مشخص می‌کند. .P \fIOPAMDROPWORKINGDIR\fR هنگام به‌روزرسانی، بسته‌هایی را که قبلاً با \fB\N'45'\N'45'working\N'45'dir\fR به‌روزرسانی شده‌اند نادیده می‌گیرد. بدون تنظیم این متغیر، opam آن‌ها را بدون تغییر نگه می‌دارد مگر اینکه صریحاً در خط فرمان نام برده شوند. .P \fIOPAMDRYRUN\fR به گزینه `\N'45'\N'45'dry\N'45'run` مراجعه کنید. .P \fIOPAMEDITOR\fR ویرایشگر متن مورد استفاده برای ویرایش فایل‌های opam را مشخص می‌کند و بر \fI$EDITOR\fR و \fI$VISUAL\fR اولویت دارد. .P \fIOPAMERRLOGLEN\fR تعداد خطوط گزارش چاپ‌شده در زمان شکست یک زیرفرایند را تعیین می‌کند؛ 0 برای چاپ تمام خطوط. .P \fIOPAMEXTERNALSOLVER\fR به گزینه `\N'45'\N'45'solver` مراجعه کنید. .P \fIOPAMFAKE\fR به گزینه `\N'45'\N'45'fake` مراجعه کنید. .P \fIOPAMFETCH\fR نحوه بارگیری فایل‌ها را مشخص می‌کند: یکی از گزینه‌های `wget`، `curl` یا دستوری دلخواه که متغیرهای \fB%{url}%\fR، \fB%{out}%\fR، \fB%{retry}%\fR، \fB%{compress}%\fR و \fB%{checksum}%\fR در آن جایگزین خواهند شد. مقدار download-command را از فایل پیکربندی اصلی بازنویسی می‌کند. .P \fIOPAMFIXUPCRITERIA\fR مشابه \fIOPAMUPGRADECRITERIA\fR، اما مخصوص به fixup و نصب مجدد. .P \fIOPAMIGNORECONSTRAINTS\fR به گزینه نصب `\N'45'\N'45'ignore\N'45'constraints\N'45'on` مراجعه کنید. .P \fIOPAMIGNOREPINDEPENDS\fR به گزینه `\N'45'\N'45'ignore\N'45'pin\N'45'depends` مراجعه کنید. .P \fIOPAMINPLACEBUILD\fR به گزینه `\N'45'\N'45'inplace\N'45'build` مراجعه کنید. .P \fIOPAMJOBS\fR حداکثر تعداد پردازش‌های موازی کاری برای اجرا را تعیین می‌کند. .P \fIOPAMJSON\fR ذخیره خروجی json در فایل مشخص‌شده (از نویسه `%` برای شماره‌گذاری فایل‌ها استفاده کنید). .P \fIOPAMKEEPBUILDDIR\fR به گزینه نصب `\N'45'\N'45'keep\N'45'build\N'45'dir` مراجعه کنید. .P \fIOPAMKEEPLOGS\fR به opam اعلام می‌کند که برخی گزارش‌های موقت دستورات و پشتیبان‌ها را حذف نکند. این کار بعضی فرآیندهای پایانی را رد می‌کند و ممکن است به دریافت ردگیری پشته (backtrace) مطمئن‌تر کمک کند. .P \fIOPAMLOCKED\fR ترکیبی از گزینه‌های `\N'45'\N'45'locked` و `\N'45'\N'45'lock\N'45'suffix`. .P \fIOPAMLOGS\fR \fIlogdir\fR دایرکتوری لاگ‌ها را تنظیم می‌کند، پیش‌فرض دایرکتوری موقت در tmp/ است. .P \fIOPAMMAKECMD\fR دستور make سیستمی مورد استفاده را تنظیم می‌کند. .P \fIOPAMMERGEOUT\fR ادغام خروجی‌های فرایند، خروجی خطای استاندارد (stderr) روی خروجی استاندارد (stdout). .P \fIOPAMNO\fR پاسخ خیر به هر پرسش مطرح‌شده، به گزینه‌های `\N'45'\N'45'no` و `\N'45'\N'45'confirm\N'45'level` مراجعه کنید. در صورت تنظیم \fBOPAMCONFIRMLEVEL\fR یا \fBOPAMYES\fR، این متغیر نادیده گرفته می‌شود. .P \fIOPAMNOAGGREGATE\fR در کنار `opam admin check`، بسته‌ها را تجمیع نکنید. .P \fIOPAMNOASPCUD\fR منسوخ‌شده. .P \fIOPAMNOAUTOUPGRADE\fR ارتقای خودکار داخلی مخازن دارای قالب قدیمی‌تر به نسخه فعلی را در هنگام `update` یا `init` غیرفعال می‌کند. .P \fIOPAMNOCHECKSUMS\fR در صورت موجود بودن، گزینه \N'45'\N'45'no\N'45'checksums را فعال می‌کند. .P \fIOPAMNODEPEXTS\fR مدیریت وابستگی‌های سیستمی را غیرفعال می‌کند، به گزینه `\N'45'\N'45'no\N'45'depexts` مراجعه کنید. .P \fIOPAMNOENVNOTICE\fR متغیر داخلی. .P \fIOPAMNOSELFUPGRADE\fR به گزینه `\N'45'\N'45'no\N'45'self\N'45'upgrade` مراجعه کنید. .P \fIOPAMPINKINDAUTO\fR تعیین می‌کند که آیا هنگام پین کردن به یک مسیر محلی، سیستم‌های کنترل نسخه تشخیص داده شوند یا خیر. از نسخه 1.3.0 به صورت پیش‌فرض فعال است. .P \fIOPAMPRECISETRACKING\fR ردیابی دقیق و ریزدانه دایرکتوری‌ها. .P \fIOPAMPREPRO\fR تنظیم روی false برای غیرفعال کردن پیش‌پردازش CUDF. بهره‌وری کمتری دارد، اما ممکن است به اشکال‌زدایی مسائل حل‌کننده کمک کند. .P \fIOPAMREPOSITORYTARRING\fR ذخیره داخلی مخازن به صورت فایل‌های tar.gz. این می‌تواند روی سیستم‌های فایلی که با پویش درخت‌های بزرگ مشکل دارند اما کش مناسبی در tmp/ دارند بسیار سریع‌تر باشد؛ با این حال در حالت عمومی کندتر است. .P \fIOPAMREQUIRECHECKSUMS\fR در صورت در دسترس بودن، گزینه `\N'45'\N'45'require\N'45'checksums` را فعال می‌کند (برای مثال در `opam install`). .P \fIOPAMRETRIES\fR تعداد دفعات تلاش مجدد قبل از اعلام شکست در بارگیری‌ها. .P \fIOPAMREUSEBUILDDIR\fR به گزینه `\N'45'\N'45'reuse\N'45'build\N'45'dir` مراجعه کنید. .P \fIOPAMROOT\fR به گزینه `\N'45'\N'45'root` مراجعه کنید. این متغیر به طور خودکار با `opam env \N'45'\N'45'root=DIR \N'45'\N'45'set\N'45'root` تنظیم می‌شود. .P \fIOPAMROOTISOK\fR هنگام اجرا با کاربر ارشد (root) هشداری نمایش داده نشود. .P \fIOPAMSAFE\fR به گزینه `\N'45'\N'45'safe` مراجعه کنید. .P \fIOPAMSHOW\fR به گزینه `\N'45'\N'45'show` مراجعه کنید. .P \fIOPAMSKIPUPDATE\fR به گزینه `\N'45'\N'45'skip\N'45'updates` مراجعه کنید. .P \fIOPAMSKIPVERSIONCHECKS\fR نادیده گرفتن برخی بررسی‌های نسخه. ناامن است و صرفاً برای تست سازگاری کاربرد دارد. .P \fIOPAMSOLVERALLOWSUBOPTIMAL\fR (پیش‌فرض `true`) به برخی حل‌کننده‌ها اجازه می‌دهد در صورت رسیدن به مهلت زمانی باز هم پاسخی ارائه دهند؛ اگرچه تضمین می‌شود راه‌حل پایدار بماند، اما هیچ تضمینی برای بهینه بودن آن طبق معیارهای مورد انتظار وجود ندارد. اگر `true` باشد، opam با یک هشدار ادامه می‌دهد، اگر `false` باشد پایان مهلت زمانی یک خطا تلقی می‌شود. در حال حاضر فقط بخش builtin-z3 این حالت را پشتیبانی می‌کند. .P \fIOPAMSOLVERTIMEOUT\fR تغییر زمان مجاز حل‌کننده. پیش‌فرض 60.0 است؛ 0 به معنی زمان نامحدود است. ممکن است همه حل‌کننده‌ها این گزینه را پشتیبانی نکنند. .P \fIOPAMSOLVERTOLERANCE\fR میزان تحمل حل‌کننده برای انتخاب یک راه‌حل غیربهینه را تغییر می‌دهد (به عنوان مثال ممکن است بسته‌های قدیمی‌تر را انتخاب کند). مقادیر معمول بین 0.0 (بهترین راه‌حل ممکن) تا 1.0 (راه‌حل غیربهینه) است. پیش‌فرض 0.0 است. این گزینه زمانی که حل‌کننده نتواند در زمان معقول به راه‌حل برسد مفید است (به \fB$OPAMSOLVERTIMEOUT\fR مراجعه کنید). ممکن است همه حل‌کننده‌ها این گزینه را پشتیبانی نکنند. .P \fIOPAMSTATS\fR در نسخه \fB2.4\fR حذف شد. .P \fIOPAMSTATUSLINE\fR نمایش یک نوار وضعیت پویا در ترمینال برای مشاهده فعالیت‌های جاری (یکی از مقادیر \fBalways\fR، \fBnever\fR یا \fBauto\fR). .P \fIOPAMSTRICT\fR اعلام خطا و توقف در صورت هرگونه ناهماهنگی (خواندن فایل، ایمپورت سوییچ و غیره). .P \fIOPAMSWITCH\fR به گزینه `\N'45'\N'45'switch` مراجعه کنید. به صورت خودکار توسط `opam env \N'45'\N'45'switch=SWITCH \N'45'\N'45'set\N'45'switch` تنظیم می‌شود. .P \fIOPAMUNLOCKBASE\fR به گزینه نصب `\N'45'\N'45'unlock\N'45'base` مراجعه کنید. .P \fIOPAMUPGRADECRITERIA\fR تعیین ترجیحات (\fIpreferences\fR) کاربر برای حل وابستگی‌ها در زمان ارتقا. در صورت تنظیم هر دو، در ارتقاها بر \fIOPAMCRITERIA\fR تقدم دارد. همچنین به گزینه \N'45'\N'45'criteria مراجعه کنید. .P \fIOPAMUSEINTERNALSOLVER\fR به گزینه `\N'45'\N'45'use\N'45'internal\N'45'solver` مراجعه کنید. .P \fIOPAMUSEOPENSSL\fR در نسخه \fB2.2\fR حذف شد. .P \fIOPAMUTF8\fR استفاده از کاراکترهای UTF8 در خروجی (یکی از مقادیر \fBalways\fR، \fBnever\fR یا \fBauto\fR؛ پیش‌فرض `auto` بر اساس تنظیمات محلی/locale). .P \fIOPAMUTF8MSGS\fR استفاده از کاراکترهای گسترش‌یافته UTF8 در پیام‌های opam. به طور ضمنی \fIOPAMUTF8\fR را فعال می‌کند. به طور پیش‌فرض فقط در macOS فعال است. .P \fIOPAMVALIDATIONHOOK\fR در صورت تنظیم، از دستور `%{hook%}` برای اعتبارسنجی به‌روزرسانی مخزن opam استفاده می‌کند. .P \fIOPAMVERBOSE\fR به گزینه `\N'45'\N'45'verbose` مراجعه کنید. .P \fIOPAMVERBOSEON\fR به گزینه \N'45'\N'45'verbose\N'45'on مراجعه کنید. .P \fIOPAMVERSIONLAGPOWER\fR استفاده نکنید. .P \fIOPAMWITHDEVSETUP\fR به گزینه نصب `\N'45'\N'45'with\N'45'dev\N'45'setup` مراجعه کنید. .P \fIOPAMWITHDOC\fR به گزینه نصب `\N'45'\N'45'with\N'45'doc` مراجعه کنید. .P \fIOPAMWITHTEST\fR به گزینه نصب `\N'45'\N'45'with\N'45'test` مراجعه کنید. .P \fIOPAMWORKINGDIR\fR به گزینه `\N'45'\N'45'working\N'45'dir` مراجعه کنید. .P \fIOPAMYES\fR به گزینه‌های `\N'45'\N'45'yes` و `\N'45'\N'45'confirm\N'45'level` مراجعه کنید. متغیر \fBOPAMYES\fR نسبت به \fBOPAMNO\fR اولویت دارد و در صورت تنظیم \fBOPAMCONFIRMLEVEL\fR نادیده گرفته می‌شود. .P \fIOPAMVAR_var\fR هنگام جایگزینی رشته‌های `%{var}%` در فایل‌های `opam`، محتوای متغیر \fIvar\fR را بازنویسی می‌کند. .P \fIOPAMVAR_package_var\fR هنگام جایگزینی رشته‌های `%{package:var}%` در فایل‌های `opam`، محتوای متغیر \fIpackage:var\fR را بازنویسی می‌کند. .SH "نسخه خط فرمان (CLI VERSION)" .P تمامی اسکریپت‌ها و فراخوانی‌های برنامه‌نویسی‌شده opam باید از `\N'45'\N'45'cli` استفاده کنند تا عملکرد بدون مشکل آن‌ها در نسخه‌های آتی کلاینت opam تضمین شود. همچنین، راهنماها و مستندات آنلاین نیز می‌توانند از آن بهره‌مند شوند، زیرا مانع قدیمی شدن دستورات می‌شود. .P اگرچه opam فقط از ریشه‌های (~/.opam) برای نسخه فعلی پشتیبانی می‌کند، اما سازگاری عقروعقب را برای رابط خط فرمان خود فراهم می‌سازد. .P از آنجا که پشتیبانی از نسخه CLI فقط در opam 2.1 اضافه شد، برای نسخه 2.0 از \fIOPAMCLI\fR استفاده کنید (چون opam 2.0 آن را نادیده خواهد گرفت)، و برای نسخه‌های 2.1 (یا بالاتر) از `\N'45'\N'45'cli=2.1` استفاده نمایید، چرا که متغیرهای محیطی حاکم بر تجزیه نحو ناپایدارند. به همین دلیل، اگر \fIOPAMCLI\fR نسخه‌ای معتبر غیر از 2.0 را مشخص کند، یا اگر `\N'45'\N'45'cli=2.0` داده شود، opam هشداری نمایش خواهد داد. .P نسخه خط فرمان با گزینه `\N'45'\N'45'cli` یا متغیر محیطی \fIOPAMCLI\fR تعیین می‌شود. گزینه `\N'45'\N'45'cli` را می‌توان چندین بار ذکر کرد که آخرین مورد اولویت خواهد داشت. متغیر \fIOPAMCLI\fR تنها در صورتی بررسی می‌شود که `\N'45'\N'45'cli` ارائه نشده باشد. .SH "وضعیت خروج (EXIT STATUS)" .P به عنوان استثنایی بر موارد زیر، دستور `exec` در صورتی که دستور یافت نشود یا قابل اجرا نباشد مقدار 127، و در غیر این صورت مقدار خروج خود دستور را برمی‌گرداند. .TP 4 0 موفقیت، یا مقدار true در پرس‌وجوهای بولی. .TP 4 1 مقدار False. در شرایطی که مقدار بازگشتی بولی انتظار می‌رود برگردانده می‌شود، مانند اجرا همراه با \fB\N'45'\N'45'check\fR، یا برای پرس‌وجوهایی مانند \fBopam lint\fR. .TP 4 2 آرگومان‌های نامعتبر خط فرمان، یا آرگومان‌هایی که به زمینه‌ای نامعتبر اشاره دارند (مانند فایلی که با فرمت مورد انتظار همخوانی ندارد). .TP 4 5 یافت نشد. موردی که درخواست کرده‌اید (بسته، نسخه، مخزن و غیره) پیدا نشد. .TP 4 10 لغو شده. عملیات نیازمند تأیید بود، اما تأیید ارائه نشد. .TP 4 15 امکان دسترسی به قفل‌های مورد نیاز برای انجام عملیات وجود نداشت. .TP 4 20 هیچ راه‌حلی برای درخواست کاربر یافت نشد. این حالت می‌تواند به عنوان مثال به دلیل درخواست نصب دو بسته ناسازگار رخ دهد. .TP 4 30 خطا در تعریف بسته یا سایر فایل‌های متادیتا. استفاده از \fB\N'45'\N'45'strict\fR بروز این خطا را محتمل‌تر می‌کند. .TP 4 31 خطای اسکریپت بسته. برخی از عملیات بسته ناموفق بودند. این ممکن است خطایی در خود بسته‌ها یا ناشی از ناسازگاری با سیستم شما باشد. این می‌تواند یک خطای جزئی باشد. .TP 4 40 خطای همگام‌سازی. واکشی برخی از ریموت‌ها از شبکه با شکست مواجه شد. این می‌تواند یک خطای جزئی باشد. .TP 4 50 خطای پیکربندی. پیکربندی سیستم یا opam اجازه انجام عملیات را نمی‌دهد و نیاز به رفع اشکال دارد. .TP 4 60 شکست حل‌کننده. حل‌کننده نتوانست پاسخی معتبر ارائه دهد. این می‌تواند ناشی از خراب بودن حل‌کننده خارجی یا خطایی در تنظیمات آن باشد. .TP 4 99 خطای داخلی. مشکلی پیش آمده است که احتمالاً به دلیل وجود باگ در خود opam است. .TP 4 130 وقفه توسط کاربر. سیگنال SIGINT دریافت شد، معمولاً به دلیل فشردن کلیدهای Ctrl-C توسط کاربر. .TP 4 0 در صورت موفقیت. .TP 4 123 در صورت بروز خطاهای نامشخص گزارش‌شده در خروجی استاندارد خطا (stderr). .TP 4 124 در صورت بروز خطاهای تجزیه خط فرمان. .TP 4 125 در صورت بروز خطاهای پیش‌بینی‌نشده داخلی (باگ‌ها). .SH "مستندات بیشتر (FURTHER DOCUMENTATION)" .P به https://opam.ocaml.org/doc مراجعه فرمایید. .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 بررسی کنید.