'\" t
.TH "CARGO\-BUILD" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-build \- کامپایل بسته جاری
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo build\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
کامپایل بسته‌های محلی و تمام وابستگی‌های آن‌ها.
.SH "گزینه‌ها (OPTIONS)"
.SS "انتخاب بسته (Package Selection)"
به‌طور پیش‌فرض، زمانی که هیچ گزینهٔ انتخابی برای بسته مشخص نشده باشد، بسته‌های انتخاب‌شده
به فایل مانیفستِ انتخاب‌شده بستگی دارند (اگر \fB\-\-manifest\-path\fR داده نشده باشد،
بر اساس دایرکتوری کاری فعلی تعیین می‌شود). اگر مانیفست ریشهٔ یک فضای کاری (workspace) باشد،
اعضای پیش‌فرض فضای کاری انتخاب می‌شوند، در غیر این صورت تنها بسته‌ای که توسط
مانیفست تعریف شده است انتخاب خواهد شد.
.sp
اعضای پیش‌فرض یک فضای کاری را می‌توان به‌صراحت با کلید
\fBworkspace.default\-members\fR در مانیفست ریشه تنظیم کرد. اگر این مقدار تنظیم نشده باشد،
یک فضای کاری مجازی شامل تمام اعضای فضای کاری خواهد بود (معادل ارسال
\fB\-\-workspace\fR)، و یک فضای کاری غیرمجازی تنها شامل خودِ crate ریشه خواهد بود.
.sp
\fB\-p\fR \fIspec\fR\[u2026], 
\fB\-\-package\fR \fIspec\fR\[u2026]
.RS 4
تنها بسته‌های مشخص‌شده را می‌سازد. برای اطلاعات دربارهٔ قالب
SPEC به \fBcargo\-pkgid\fR(1) مراجعه کنید. این پرچم می‌تواند چندین بار مشخص شود و از الگوهای
عمومی glob در یونیکس مانند \fB*\fR، \fB?\fR و \fB[]\fR\& پشتیبانی می‌کند. با این حال، برای جلوگیری از بسط
تصادفی الگوهای glob توسط پوستهٔ شما پیش از پردازش آن‌ها توسط Cargo، باید در اطراف هر الگو از
نقل‌قول‌های تکی یا جفتی استفاده کنید.
.RE
.sp
\fB\-\-workspace\fR
.RS 4
تمام اعضای موجود در فضای کاری را می‌سازد.
.RE
.sp
\fB\-\-all\fR
.RS 4
نام مستعار منسوخ‌شده برای \fB\-\-workspace\fR\&.
.RE
.sp
\fB\-\-exclude\fR \fISPEC\fR\[u2026]
.RS 4
بسته‌های مشخص‌شده را مستثنی می‌کند. باید در کنار پرچم
\fB\-\-workspace\fR استفاده شود. این پرچم می‌تواند چندین بار مشخص شود و از
الگوهای عمومی glob در یونیکس مانند \fB*\fR، \fB?\fR و \fB[]\fR\& پشتیبانی می‌کند. با این حال، برای
جلوگیری از بسط تصادفی الگوهای glob توسط پوسته پیش از پردازش آن‌ها توسط Cargo، باید در اطراف
هر الگو از نقل‌قول‌های تکی یا جفتی استفاده کنید.
.RE
.SS "انتخاب هدف (Target Selection)"
زمانی که هیچ گزینه‌ای برای انتخاب هدف ارائه نشده باشد، \fBcargo build\fR تمام
هدف‌های دودویی (binary) و کتابخانه‌ایِ بسته‌های انتخاب‌شده را می‌سازد. در صورتی که فایل‌های دودویی
دارای \fBrequired\-features\fR باشند که ناموجود است، نادیده گرفته می‌شوند.
.sp
اگر یک آزمون یکپارچه‌سازی یا بنچ‌مارک برای ساخت انتخاب شده باشد، هدف‌های دودویی
به‌طور خودکار ساخته می‌شوند. این کار به آزمون یکپارچه‌سازی اجازه می‌دهد تا فایل دودویی
را برای سنجش و آزمایش رفتار آن اجرا کند.
\fIمتغیر محیطی\fR \fBCARGO_BIN_EXE_<name>\fR
<https://doc.rust\-lang.org/cargo/reference/environment\-variables.html#environment\-variables\-cargo\-sets\-for\-crates>
هنگام ساخت و اجرای آزمون یکپارچه‌سازی تنظیم می‌شود تا بتواند با استفاده از
\fIماکروی \f(BIenv\fR <https://doc.rust\-lang.org/std/macro.env.html> یا
\fIتابع \f(BIvar\fR <https://doc.rust\-lang.org/std/env/fn.var.html> مکان فایل
اجرایی را مشخص کند.
.sp
ارسال پرچم‌های انتخاب هدف، تنها هدف‌های مشخص‌شده را خواهد ساخت.
.sp
توجه داشته باشید که پرچم‌های \fB\-\-bin\fR، \fB\-\-example\fR، \fB\-\-test\fR و \fB\-\-bench\fR نیز
از الگوهای عمومی glob در یونیکس مانند \fB*\fR، \fB?\fR و \fB[]\fR\& پشتیبانی می‌کنند. با این حال، برای
جلوگیری از بسط تصادفی الگوهای glob توسط پوسته پیش از پردازش آن‌ها توسط Cargo، باید در
اطراف هر الگوی glob از نقل‌قول‌های تکی یا جفتی استفاده کنید.
.sp
\fB\-\-lib\fR
.RS 4
کتابخانهٔ بسته را می‌سازد.
.RE
.sp
\fB\-\-bin\fR \fIname\fR\[u2026]
.RS 4
فایل دودویی مشخص‌شده را می‌سازد. این پرچم می‌تواند چندین بار مشخص شود
و از الگوهای عمومی glob در یونیکس پشتیبانی می‌کند.
.RE
.sp
\fB\-\-bins\fR
.RS 4
تمام هدف‌های دودویی را می‌سازد.
.RE
.sp
\fB\-\-example\fR \fIname\fR\[u2026]
.RS 4
نمونهٔ مشخص‌شده را می‌سازد. این پرچم می‌تواند چندین بار مشخص شود
و از الگوهای عمومی glob در یونیکس پشتیبانی می‌کند.
.RE
.sp
\fB\-\-examples\fR
.RS 4
تمام هدف‌های نمونه را می‌سازد.
.RE
.sp
\fB\-\-test\fR \fIname\fR\[u2026]
.RS 4
آزمون یکپارچه‌سازی مشخص‌شده را می‌سازد. این پرچم می‌تواند
چندین بار مشخص شود و از الگوهای عمومی glob در یونیکس پشتیبانی می‌کند.
.RE
.sp
\fB\-\-tests\fR
.RS 4
تمام هدف‌هایی را که پرچم \fBtest = true\fR در مانیفست برای آن‌ها تنظیم
شده است، می‌سازد. به‌طور پیش‌فرض این مورد شامل کتابخانه و فایل‌های دودویی ساخته‌شده
به‌عنوان آزمون‌های واحد، و آزمون‌های یکپارچه‌سازی است. توجه داشته باشید که این کار
هرگونه وابستگی موردنیاز را نیز می‌سازد، بنابراین ممکن است هدف lib دو بار ساخته شود
(یک بار به‌عنوان آزمون واحد، و یک بار به‌عنوان وابستگی برای فایل‌های دودویی، آزمون‌های یکپارچه‌سازی و غیره).
می‌توان هدف‌ها را با تنظیم پرچم \fBtest\fR در تنظیمات مانیفست برای آن هدف، فعال یا غیرفعال کرد.
.RE
.sp
\fB\-\-bench\fR \fIname\fR\[u2026]
.RS 4
بنچ‌مارک مشخص‌شده را می‌سازد. این پرچم می‌تواند چندین بار
مشخص شود و از الگوهای عمومی glob در یونیکس پشتیبانی می‌کند.
.RE
.sp
\fB\-\-benches\fR
.RS 4
تمام هدف‌هایی را که پرچم \fBbench = true\fR در مانیفست برای آن‌ها تنظیم
شده است، می‌سازد. به‌طور پیش‌فرض این مورد شامل کتابخانه و فایل‌های دودویی ساخته‌شده
به‌عنوان بنچ‌مارک، و هدف‌های bench است. توجه داشته باشید که این کار هرگونه
وابستگی موردنیاز را نیز می‌سازد، بنابراین ممکن است هدف lib دو بار ساخته شود
(یک بار به‌عنوان بنچ‌مارک، و یک بار به‌عنوان وابستگی برای فایل‌های دودویی، بنچ‌مارک‌ها و غیره).
می‌توان هدف‌ها را با تنظیم پرچم \fBbench\fR در تنظیمات مانیفست برای آن هدف، فعال یا غیرفعال کرد.
.RE
.sp
\fB\-\-all\-targets\fR
.RS 4
تمام هدف‌ها را می‌سازد. این معادل مشخص‌کردن \fB\-\-lib \-\-bins \-\-tests \-\-benches \-\-examples\fR\& است.
.RE.SS "انتخاب ویژگی‌ها (Feature Selection)"
پرچم‌های ویژگی به شما اجازه می‌دهند تعیین کنید کدام ویژگی‌ها فعال شوند. هنگامی که هیچ
گزینهٔ ویژگی داده نشود، ویژگی \fBdefault\fR برای هر بستهٔ انتخاب‌شده
فعال می‌شود.
.sp
برای جزئیات بیشتر، \fIمستندات ویژگی‌ها\fR <https://doc.rust\-lang.org/cargo/reference/features.html#command\-line\-feature\-options>
را ببینید.
.sp
\fB\-F\fR \fIfeatures\fR, 
\fB\-\-features\fR \fIfeatures\fR
.RS 4
فهرستی از ویژگی‌ها که با فاصله یا کاما از هم جدا شده‌اند تا فعال شوند. ویژگی‌های اعضای
فضای کاری (workspace) می‌توانند با نحو \fBpackage\-name/feature\-name\fR فعال شوند. این پرچم می‌تواند
چندین بار مشخص شود، که در این صورت تمام ویژگی‌های مشخص‌شده را فعال می‌کند.
.RE
.sp
\fB\-\-all\-features\fR
.RS 4
تمام ویژگی‌های موجود در همهٔ بسته‌های انتخاب‌شده را فعال می‌کند.
.RE
.sp
\fB\-\-no\-default\-features\fR
.RS 4
ویژگی \fBdefault\fR بسته‌های انتخاب‌شده را فعال نمی‌کند.
.RE
.SS "گزینه‌های کامپایل (Compilation Options)"
.sp
\fB\-\-target\fR \fItriple\fR
.RS 4
برای معماری مقصد (target) مشخص‌شده ساخت را انجام می‌دهد. این پرچم می‌تواند چندین بار مشخص شود. مقدار پیش‌فرض معماری میزبان است. ساختار کلی این سه‌تایی به صورت
\fB<arch><sub>\-<vendor>\-<sys>\-<abi>\fR\& است.
.sp
مقادیر ممکن:
.sp
.RS 4
\h'-04'\(bu\h'+03'هر مقصد پشتیبانی‌شده در \fBrustc \-\-print target\-list\fR\&.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB"host\-tuple"\fR، که در درون با مقصدِ میزبان جایگزین خواهد شد. این گزینه به‌ویژه زمانی مفید است که در حال کامپایل متقابل (cross-compiling) برخی کریت‌ها هستید و نمی‌خواهید ماشین میزبان خود را به عنوان یک مقصد مشخص کنید (برای مثال، یک \fBxtask\fR در یک پروژهٔ مشترک که ممکن است توسط میزبان‌های متعددی روی آن کار شود).
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'مسیری به مشخصات یک مقصد سفارشی. برای اطلاعات بیشتر، \fICustom Target Lookup Path\fR <https://doc.rust\-lang.org/rustc/targets/custom.html#custom\-target\-lookup\-path> را ببینید.
.RE
.sp
این مورد همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBbuild.target\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\& مشخص شود.
.sp
توجه داشته باشید که مشخص کردن این پرچم باعث می‌شود Cargo در حالت متفاوتی اجرا شود که در آن
مصنوعات مقصد در یک دایرکتوری جداگانه قرار می‌گیرند. برای جزئیات بیشتر،
مستندات \fIbuild cache\fR <https://doc.rust\-lang.org/cargo/reference/build\-cache.html> را ببینید.
.RE
.sp
\fB\-r\fR, 
\fB\-\-release\fR
.RS 4
مصنوعات بهینه‌سازی‌شده را با نمایهٔ \fBrelease\fR می‌سازد.
همچنین برای انتخاب یک نمایهٔ خاص بر اساس نام، گزینهٔ \fB\-\-profile\fR را ببینید.
.RE
.sp
\fB\-\-profile\fR \fIname\fR
.RS 4
با نمایهٔ داده‌شده ساخت را انجام می‌دهد.
برای جزئیات بیشتر در مورد نمایه‌ها، \fIمرجع\fR <https://doc.rust\-lang.org/cargo/reference/profiles.html> را ببینید.
.RE
.sp
\fB\-\-timings\fR
.RS 4
اطلاعات مربوط به مدت‌زمان هر کامپایل را خروجی می‌دهد و اطلاعات همزمانی را
در طول زمان دنبال می‌کند.
.sp
در پایان ساخت، یک فایل \fBcargo\-timing.html\fR در دایرکتوری \fBtarget/cargo\-timings\fR
نوشته خواهد شد. در صورتی که بخواهید یک اجرای قبلی را بررسی کنید، یک گزارش اضافی
همراه با برچسب زمان در نام فایل آن نیز نوشته می‌شود. این گزارش‌ها صرفاً برای
استفادهٔ انسان مناسب هستند و داده‌های زمان‌بندی ماشین‌خوان ارائه نمی‌دهند.
.RE
.SS "گزینه‌های خروجی (Output Options)"
.sp
\fB\-\-target\-dir\fR \fIdirectory\fR
.RS 4
دایرکتوری برای تمامی مصنوعات تولیدشده و فایل‌های میانی. همچنین می‌تواند
با متغیر محیطی \fBCARGO_TARGET_DIR\fR یا \fIمقدار پیکربندی\fR
\fBbuild.target\-dir\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\& مشخص شود.
پیش‌فرض آن پوشهٔ \fBtarget\fR در ریشهٔ فضای کاری است.
.RE
.sp
\fB\-\-artifact\-dir\fR \fIdirectory\fR
.RS 4
مصنوعات نهایی را در این دایرکتوری کپی می‌کند.
.sp
این گزینه ناپایدار است و فقط در
\fIکانال nightly\fR <https://doc.rust\-lang.org/book/appendix\-07\-nightly\-rust.html>
در دسترس است و برای فعال‌سازی به پرچم \fB\-Z unstable\-options\fR نیاز دارد.
برای اطلاعات بیشتر <https://github.com/rust\-lang/cargo/issues/6790> را ببینید.
.RE
.SS "گزینه‌های نمایش (Display Options)"
.sp
\fB\-v\fR, 
\fB\-\-verbose\fR
.RS 4
استفاده از خروجی پرگو (verbose). می‌تواند دو بار برای خروجی \[lq]بسیار پرگو\[rq] مشخص شود
که شامل خروجی‌های اضافی مانند هشدارهای وابستگی و خروجی اسکریپت ساخت است.
همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBterm.verbose\fR
<https://doc.rust\-lang.org/cargo/reference/config.html>\& مشخص شود.
.RE
.sp
\fB\-q\fR, 
\fB\-\-quiet\fR
.RS 4
پیام‌های لاگ cargo را چاپ نمی‌کند.
همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBterm.quiet\fR
<https://doc.rust\-lang.org/cargo/reference/config.html>\& مشخص شود.
.RE
.sp
\fB\-\-color\fR \fIwhen\fR
.RS 4
زمان استفاده از خروجی رنگی را کنترل می‌کند. مقادیر معتبر:
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBauto\fR (پیش‌فرض): به صورت خودکار پشتیبانی از رنگ در ترمینال را
تشخیص می‌دهد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBalways\fR: همیشه رنگ‌ها را نمایش می‌دهد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBnever\fR: هرگز رنگ‌ها را نمایش نمی‌دهد.
.RE
.sp
همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBterm.color\fR
<https://doc.rust\-lang.org/cargo/reference/config.html>\& مشخص شود.
.RE
.sp
\fB\-\-message\-format\fR \fIfmt\fR
.RS 4
قالب خروجی برای پیام‌های تشخیصی (diagnostic). می‌تواند چندین بار مشخص شود
و شامل مقادیری است که با کاما از هم جدا شده‌اند. مقادیر معتبر:
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBhuman\fR (پیش‌فرض): نمایش در یک قالب متنی خوانا برای انسان. با
\fBshort\fR و \fBjson\fR تداخل دارد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBshort\fR: ارسال پیام‌های متنی کوتاه‌تر و خوانا برای انسان. با \fBhuman\fR
و \fBjson\fR تداخل دارد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBjson\fR: ارسال پیام‌های JSON به stdout. برای جزئیات بیشتر،
\fIمرجع\fR <https://doc.rust\-lang.org/cargo/reference/external\-tools.html#json\-messages>
را ببینید. با \fBhuman\fR و \fBshort\fR تداخل دارد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBjson\-diagnostic\-short\fR: تضمین می‌کند که فیلد \fBrendered\fR در پیام‌های JSON حاوی
رندر \[lq]short\[rq] از rustc باشد. همراه با \fBhuman\fR یا \fBshort\fR قابل استفاده نیست.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBjson\-diagnostic\-rendered\-ansi\fR: تضمین می‌کند که فیلد \fBrendered\fR در پیام‌های JSON
شامل کدهای رنگی تعبیه‌شدهٔ ANSI برای رعایت طرح رنگ پیش‌فرض rustc باشد.
همراه با \fBhuman\fR یا \fBshort\fR قابل استفاده نیست.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBjson\-render\-diagnostics\fR: به Cargo دستور می‌دهد که پیام‌های تشخیصی rustc را
در پیام‌های JSON چاپ‌شده نگنجاند، بلکه خود Cargo پیام‌های تشخیصی
JSON دریافتی از rustc را رندر کند. پیام‌های تشخیصی JSON خود Cargo و سایر موارد
دریافتی از rustc همچنان منتشر می‌شوند. همراه با \fBhuman\fR یا \fBshort\fR قابل استفاده نیست.
.RE
.RE.SS "گزینه‌های مانیفست (Manifest Options)"
.sp
\fB\-\-manifest\-path\fR \fIpath\fR
.RS 4
مسیر فایل \fBCargo.toml\fR. به‌طور پیش‌فرض، Cargo به دنبال فایل
\fBCargo.toml\fR در دایرکتوری فعلی یا هر یک از دایرکتوری‌های والد می‌گردد.
.RE
.sp
\fB\-\-ignore\-rust\-version\fR
.RS 4
نادیده گرفتن مشخصهٔ \fBrust\-version\fR در بسته‌ها.
.RE
.sp
\fB\-\-locked\fR
.RS 4
تضمین می‌کند که دقیقاً همان وابستگی‌ها و نسخه‌هایی استفاده شوند که هنگام تولید
اولیهٔ فایل \fBCargo.lock\fR فعلی ایجاد شده بودند. در صورت بروز هر یک از
سناریوهای زیر، Cargo با خطا خارج خواهد شد:
.sp
.RS 4
\h'-04'\(bu\h'+03'فایل lock موجود نباشد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'برنامه Cargo به دلیل حل متفاوت وابستگی‌ها، برای تغییر فایل lock تلاش کند.
.RE
.sp
این گزینه می‌تواند در محیط‌هایی که ساخت‌های قطعی و تکرارپذیر مورد نیاز است،
مانند خطوط لولهٔ CI، استفاده شود.
.RE
.sp
\fB\-\-offline\fR
.RS 4
از دسترسی Cargo به شبکه به هر دلیلی جلوگیری می‌کند. بدون این پرچم،
اگر Cargo نیاز به دسترسی به شبکه داشته باشد و شبکه در دسترس نباشد،
با خطا متوقف خواهد شد. با این پرچم، Cargo تلاش خواهد کرد در صورت امکان
بدون شبکه کار را ادامه دهد.
.sp
توجه داشته باشید که این کار ممکن است منجر به حل وابستگی متفاوتی نسبت به حالت برخط شود.
Cargo خود را به crateهایی که به‌صورت محلی بارگیری شده‌اند محدود می‌کند، حتی اگر
طبق نسخهٔ محلی نمایه، نسخهٔ جدیدتری وجود داشته باشد. برای بارگیری وابستگی‌ها قبل از
آفلاین شدن، دستور \fBcargo\-fetch\fR(1) را ببینید.
.sp
همچنین می‌تواند با \fIمقدار پیکربندی\fR \fBnet.offline\fR در <https://doc.rust\-lang.org/cargo/reference/config.html>\& تعیین شود.
.RE
.sp
\fB\-\-frozen\fR
.RS 4
معادل تعیین هر دو گزینهٔ \fB\-\-locked\fR و \fB\-\-offline\fR به‌صورت هم‌زمان است.
.RE
.SS "گزینه‌های عمومی (Common Options)"
.sp
\fB+\fR\fItoolchain\fR
.RS 4
اگر Cargo با rustup نصب شده باشد و نخستین آرگومان \fBcargo\fR با \fB+\fR
آغاز شود، به‌عنوان نام زنجیره ابزار (toolchain) متعلق به rustup تفسیر خواهد شد
(مانند \fB+stable\fR یا \fB+nightly\fR).
برای اطلاعات بیشتر در مورد نحوهٔ عملکرد جایگزینی toolchain،
\fIمستندات rustup\fR را در <https://rust\-lang.github.io/rustup/overrides.html> ببینید.
.RE
.sp
\fB\-\-config\fR \fIKEY=VALUE\fR یا \fIPATH\fR
.RS 4
یک مقدار پیکربندی Cargo را بازنویسی می‌کند. این آرگومان باید در ساختار نحوی TOML به‌صورت \fBKEY=VALUE\fR
یا به‌عنوان مسیری به یک فایل پیکربندی اضافی ارائه شود. این پرچم می‌تواند چندین بار تعیین شود.
برای اطلاعات بیشتر \fIبخش بازنویسی‌های خط فرمان\fR را در <https://doc.rust\-lang.org/cargo/reference/config.html#command\-line\-overrides> ببینید.
.RE
.sp
\fB\-C\fR \fIPATH\fR
.RS 4
دایرکتوری کاری فعلی را قبل از اجرای هرگونه عملیات تعیین‌شده تغییر می‌دهد. این امر بر مواردی
مانند جایی که cargo به‌طور پیش‌فرض برای مانیفست پروژه (\fBCargo.toml\fR) جستجو می‌کند، و
همچنین دایرکتوری‌های مورد جستجو برای یافتن \fB\&.cargo/config.toml\fR تأثیر می‌گذارد.
این گزینه باید قبل از نام دستور ظاهر شود، برای مثال \fBcargo \-C path/to/my\-project build\fR\&.
.sp
این گزینه فقط در \fIکانال nightly\fR در <https://doc.rust\-lang.org/book/appendix\-07\-nightly\-rust.html> در دسترس است و برای فعال‌سازی به پرچم \fB\-Z unstable\-options\fR نیاز دارد (مشاهده کنید:
\fI#10098\fR <https://github.com/rust\-lang/cargo/issues/10098>).
.RE
.sp
\fB\-h\fR, 
\fB\-\-help\fR
.RS 4
اطلاعات راهنما را چاپ می‌کند.
.RE
.sp
\fB\-Z\fR \fIflag\fR
.RS 4
پرچم‌های ناپایدار (فقط nightly) برای Cargo. برای جزئیات، دستور \fBcargo \-Z help\fR را اجرا کنید.
.RE
.SS "گزینه‌های متفرقه (Miscellaneous Options)"
.sp
\fB\-j\fR \fIN\fR, 
\fB\-\-jobs\fR \fIN\fR
.RS 4
تعداد وظایف موازی برای اجرا. همچنین می‌تواند با \fIمقدار پیکربندی\fR
\fBbuild.jobs\fR در <https://doc.rust\-lang.org/cargo/reference/config.html>\& تعیین شود.
پیش‌فرض آن تعداد پردازنده‌های منطقی است. اگر منفی باشد، حداکثر تعداد
وظایف موازی را برابر با تعداد پردازنده‌های منطقی به‌علاوه مقدار ارائه‌شده تنظیم می‌کند.
اگر رشتهٔ \fBdefault\fR ارائه شود، مقدار به حالت پیش‌فرض بازگردانده می‌شود.
نباید 0 باشد.
.RE
.sp
\fB\-\-keep\-going\fR
.RS 4
تا جای ممکن بیشترین تعداد crate در نمودار وابستگی را می‌سازد، به‌جای اینکه
با اولین موردی که ساخت آن ناموفق شد فرآیند ساخت را متوقف کند.
.sp
برای مثال اگر بستهٔ فعلی وابسته به وابستگی‌های \fBfails\fR و \fBworks\fR باشد و
ساخت یکی از آن‌ها با شکست مواجه شود، دستور \fBcargo build \-j1\fR بسته به اینکه
Cargo کدام یک را ابتدا برای اجرا انتخاب کند ممکن است بسته‌ای را که با موفقیت ساخته
می‌شود بسازد یا نسازد؛ در حالی که دستور \fBcargo build \-j1 \-\-keep\-going\fR قطعاً هر
دو ساخت را اجرا خواهد کرد، حتی اگر موردی که اول اجرا شده با شکست مواجه شود.
.RE
.sp
\fB\-\-future\-incompat\-report\fR
.RS 4
گزارشی از ناسازگاری‌های آینده (future\-incompat) برای هشدارهای ناسازگاری
آینده که در طول اجرای این دستور ایجاد شده‌اند را نمایش می‌دهد.
.sp
به \fBcargo\-report\fR(1) مراجعه کنید
.RE.SH "محیط (ENVIRONMENT)"
برای جزئیات دربارهٔ متغیرهای محیطی که Cargo می‌خواند، \fIمرجع\fR <https://doc.rust\-lang.org/cargo/reference/environment\-variables.html> را
ببینید.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB0\fR: عملیات Cargo با موفقیت انجام شد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB101\fR: عملیات Cargo ناموفق بود.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
\h'-04' 1.\h'+01'ساخت بستهٔ محلی و تمام وابستگی‌های آن:
.sp
.RS 4
.nf
cargo build
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 2.\h'+01'ساخت همراه با بهینه‌سازی‌ها:
.sp
.RS 4
.nf
cargo build \-\-release
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-rustc\fR(1)