'\" t
.TH "CARGO\-RUSTC" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-rustc \- کامپایل بستهٔ جاری و ارسال گزینه‌های اضافی به کامپایلر
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo rustc\fR [\fIoptions\fR] [\fB\-\-\fR \fIargs\fR]
.SH "توضیحات (DESCRIPTION)"
هدف مشخص‌شده برای بستهٔ جاری (یا بستهٔ مشخص‌شده با \fB\-p\fR در صورت ارائه) به همراه تمام وابستگی‌های آن کامپایل خواهد شد. تمام \fIargs\fR مشخص‌شده به فراخوانی نهایی کامپایلر ارسال خواهند شد، نه به هیچ‌یک از وابستگی‌ها. توجه داشته باشید که کامپایلر همچنان آرگومان‌هایی مانند \fB\-L\fR، \fB\-\-extern\fR و \fB\-\-crate\-type\fR را بدون قید و شرط دریافت خواهد کرد، و \fIargs\fR مشخص‌شده صرفاً به فراخوانی کامپایلر افزوده می‌شوند.
.sp
برای مستندات مربوط به پرچم‌های rustc به <https://doc.rust\-lang.org/rustc/index.html> مراجعه کنید.
.sp
این دستور مستلزم آن است که در هنگام ارائهٔ آرگومان‌های اضافی، تنها یک هدف در حال کامپایل باشد. اگر بیش از یک هدف برای بستهٔ جاری در دسترس باشد، باید از فیلترهای \fB\-\-lib\fR، \fB\-\-bin\fR و غیره برای انتخاب هدف کامپایل شونده استفاده شود.
.sp
جهت ارسال پرچم‌ها به تمام فرایندهای کامپایلری که توسط Cargo ایجاد می‌شوند، از \fIمتغیر محیطی\fR \fBRUSTFLAGS\fR به نشانی <https://doc.rust\-lang.org/cargo/reference/environment\-variables.html> یا \fIمقدار پیکربندی\fR \fBbuild.rustflags\fR به نشانی <https://doc.rust\-lang.org/cargo/reference/config.html>\& استفاده کنید.
.SH "گزینه‌ها (OPTIONS)"
.SS "انتخاب بسته (Package Selection)"
به‌طور پیش‌فرض، بستهٔ موجود در دایرکتوری کاری جاری انتخاب می‌شود. از پرچم \fB\-p\fR می‌توان برای انتخاب بسته‌ای دیگر در یک فضای کاری (workspace) استفاده کرد.
.sp
\fB\-p\fR \fIspec\fR, 
\fB\-\-package\fR \fIspec\fR
.RS 4
بسته‌ای که باید ساخته شود. برای قالب SPEC به \fBcargo\-pkgid\fR(1) مراجعه کنید.
.RE
.SS "انتخاب هدف (Target Selection)"
هنگامی که هیچ گزینهٔ انتخابی برای هدف تعیین نشود، \fBcargo rustc\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 همچنین از الگوهای عمومی گلوب یونیکس مانند \fB*\fR، \fB?\fR و \fB[]\fR\& پشتیبانی می‌کنند. با این حال، برای جلوگیری از بسط تصادفی الگوهای گلوب توسط پوسته پیش از اینکه Cargo آن‌ها را پردازش کند، باید در اطراف هر الگوی گلوب از نقل‌قول تکی یا جفتی استفاده کنید.
.sp
\fB\-\-lib\fR
.RS 4
کتابخانهٔ بسته را می‌سازد.
.RE
.sp
\fB\-\-bin\fR \fIname\fR\[u2026]
.RS 4
فایل دودویی مشخص‌شده را می‌سازد. این پرچم می‌تواند چندین بار مشخص شود و از الگوهای عمومی گلوب یونیکس پشتیبانی می‌کند.
.RE
.sp
\fB\-\-bins\fR
.RS 4
تمام اهداف دودویی را می‌سازد.
.RE
.sp
\fB\-\-example\fR \fIname\fR\[u2026]
.RS 4
نمونهٔ مشخص‌شده را می‌سازد. این پرچم می‌تواند چندین بار مشخص شود و از الگوهای عمومی گلوب یونیکس پشتیبانی می‌کند.
.RE
.sp
\fB\-\-examples\fR
.RS 4
تمام اهداف نمونه را می‌سازد.
.RE
.sp
\fB\-\-test\fR \fIname\fR\[u2026]
.RS 4
آزمون یکپارچه‌سازی مشخص‌شده را می‌سازد. این پرچم می‌تواند چندین بار مشخص شود و از الگوهای عمومی گلوب یونیکس پشتیبانی می‌کند.
.RE
.sp
\fB\-\-tests\fR
.RS 4
تمام اهدافی را که پرچم مانیفست \fBtest = true\fR برای آن‌ها تنظیم شده است، می‌سازد. به‌طور پیش‌فرض این شامل کتابخانه و فایل‌های دودویی ساخته‌شده به‌عنوان آزمون‌های واحد، و آزمون‌های یکپارچه‌سازی است. توجه داشته باشید که این کار همچنین هرگونه وابستگی مورد نیاز را خواهد ساخت، بنابراین هدف lib ممکن است دو بار ساخته شود (یک بار به‌عنوان آزمون واحد، و یک بار به‌عنوان وابستگی برای فایل‌های دودویی، آزمون‌های یکپارچه‌سازی و غیره). اهداف را می‌توان با تنظیم پرچم \fBtest\fR در تنظیمات مانیفست برای هدف، فعال یا غیرفعال کرد.
.RE
.sp
\fB\-\-bench\fR \fIname\fR\[u2026]
.RS 4
بنچمارک مشخص‌شده را می‌سازد. این پرچم می‌تواند چندین بار مشخص شود و از الگوهای عمومی گلوب یونیکس پشتیبانی می‌کند.
.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
ساخت برای معماری مقصد مشخص‌شده. این پرچم را می‌توان چندین بار مشخص کرد. مقدار پیش‌فرض، معماری میزبان است. قالب کلی این سه‌تایی به‌صورت
\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، که در درون با معماری مقصدِ میزبان جایگزین خواهد شد. این گزینه به‌ویژه زمانی مفید است که در حال کامپایل متقابل برخی کریت‌ها هستید و نمی‌خواهید ماشین میزبان خود را به‌عنوان یک مقصد مشخص کنید (برای مثال، یک \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
ساخت با نمایه داده‌شده.
.sp
زیرفرمان \fBrustc\fR با نمایه‌های نام‌گذاری‌شده زیر با رفتارهای ویژه‌ای برخورد خواهد کرد:
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBcheck\fR \[em] به همان روش دستور \fBcargo\-check\fR(1) با
نمایه \fBdev\fR می‌سازد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBtest\fR \[em] به همان روش دستور \fBcargo\-test\fR(1) می‌سازد،
و ساخت در حالت آزمایشی را فعال می‌کند که آزمون‌ها و گزینه cfg با نام \fBtest\fR
را فعال خواهد کرد. برای جزئیات بیشتر، \fIrustc
tests\fR <https://doc.rust\-lang.org/rustc/tests/index.html> را ببینید.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fBbench\fR \[em] به همان روش دستور \fBcargo\-bench\fR(1) می‌سازد،
شبیه به نمایه \fBtest\fR.
.RE
.sp
برای جزئیات بیشتر درباره نمایه‌ها، \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
.sp
\fB\-\-crate\-type\fR \fIcrate\-type\fR
.RS 4
ساخت برای نوع کریت داده‌شده. این پرچم فهرستی از ۱ یا چند نوع کریت که با کاما از هم
جدا شده‌اند را می‌پذیرد که مقادیر مجاز آن همانند فیلد \fBcrate\-type\fR در مانیفست
برای پیکربندی یک مقصد Cargo است. برای مقادیر ممکن،
\fIفیلد \f(BIcrate\-type\fI\fR <https://doc.rust\-lang.org/cargo/reference/cargo\-targets.html#the\-crate\-type\-field>
را ببینید.
.sp
اگر مانیفست شامل یک فهرست باشد و \fB\-\-crate\-type\fR ارائه شود،
مقدار آرگومان خط فرمان بر آنچه در مانیفست است برتری خواهد داشت.
.sp
این پرچم تنها هنگام ساخت یک مقصد کتابخانه‌ای \fBlib\fR یا \fBexample\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.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
عدم چاپ پیام‌های گزارش (log) مربوط به 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]کوتاه\[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 file) وجود نداشته باشد.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'کارگو (Cargo) به دلیل تحلیل متفاوت وابستگی‌ها تلاش کند فایل قفل را تغییر دهد.
.RE
.sp
می‌تواند در محیط‌هایی که ساخت‌های قطعی (deterministic) مورد نیاز است، مانند خطوط لوله CI، استفاده شود.
.RE
.sp
\fB\-\-offline\fR
.RS 4
از دسترسی Cargo به شبکه به هر دلیلی جلوگیری می‌کند. بدون این گزینه، اگر Cargo نیاز به دسترسی به شبکه داشته باشد و شبکه در دسترس نباشد، با یک خطا متوقف خواهد شد. با این گزینه، Cargo تلاش خواهد کرد تا در صورت امکان بدون شبکه به کار ادامه دهد.
.sp
توجه داشته باشید که این ممکن است به تحلیل متفاوتی از وابستگی‌ها نسبت به حالت برخط (آنلاین) منجر شود. Cargo خود را به کریت‌هایی (crates) که به‌صورت محلی بارگیری شده‌اند محدود می‌کند، حتی اگر طبق نسخهٔ محلی نمایه (index)، نسخهٔ جدیدتری موجود باشد. برای بارگیری وابستگی‌ها پیش از رفتن به حالت آفلاین، دستور \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).
برای اطلاعات بیشتر درباره نحوه کارکرد رونویسی زنجیره‌ابزار، به \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 rustc \-j1\fR ممکن است موردی را که
با موفقیت ساخته می‌شود بسازد یا نسازد (بسته به اینکه Cargo ابتدا ساخت کدام‌یک را برای اجرا
انتخاب کرده باشد)، در حالی که \fBcargo rustc \-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'بررسی اینکه آیا بسته شما (بدون احتساب وابستگی‌ها) از کد ناامن (unsafe) استفاده می‌کند:
.sp
.RS 4
.nf
cargo rustc \-\-lib \-\- \-D unsafe\-code
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 2.\h'+01'آزمایش یک پرچم تجربی روی کامپایلر nightly، مانند این مورد که اندازه
هر نوع داده (type) را چاپ می‌کند:
.sp
.RS 4
.nf
cargo rustc \-\-lib \-\- \-Z print\-type\-sizes
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 3.\h'+01'رونویسی فیلد \fBcrate\-type\fR در Cargo.toml با استفاده از گزینه خط فرمان:
.sp
.RS 4
.nf
cargo rustc \-\-lib \-\-crate\-type lib,cdylib
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-build\fR(1), \fBrustc\fR(1)