'\" t
.TH "CARGO\-FIX" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-fix \- اصلاح خودکار هشدارهای کامپایلر در کد منبع Rust
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo fix\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
این زیردستور Cargo به‌طور خودکار پیشنهادات rustc ناشی از هشدارهای تشخیصی را دریافت کرده و آن‌ها را روی کد منبع شما اعمال می‌کند. هدف این ابزار، خودکارسازی کارهایی است که خود rustc از قبل می‌داند چگونه روش اصلاح آن‌ها را به شما بگوید!
.sp
اجرای \fBcargo fix\fR در پشت صحنه دستور \fBcargo\-check\fR(1) را اجرا می‌کند. هرگونه هشدار قابل اعمال روی کریت شما به‌صورت خودکار برطرف می‌شود (در صورت امکان) و تمام هشدارهای باقی‌مانده پس از اتمام فرآیند بررسی نمایش داده خواهند شد. برای نمونه، اگر می‌خواهید تمام اصلاحات را روی بسته فعلی اعمال کنید، می‌توانید دستور زیر را اجرا نمایید:
.sp
.RS 4
.nf
cargo fix
.fi
.RE
.sp
که رفتاری مشابه \fBcargo check \-\-all\-targets\fR دارد.
.sp
دستور \fBcargo fix\fR تنها قادر به اصلاح کدهایی است که معمولاً با \fBcargo check\fR کامپایل می‌شوند. اگر کدی به‌طور شرطی با ویژگی‌های اختیاری (features) فعال شده باشد، لازم است آن ویژگی‌ها را فعال کنید تا آن کد مورد تحلیل قرار گیرد:
.sp
.RS 4
.nf
cargo fix \-\-features foo
.fi
.RE
.sp
به‌طور مشابه، برای سایر عبارت‌های \fBcfg\fR مانند کدهای مختص به یک پلتفرم خاص، باید گزینه \fB\-\-target\fR را ارسال کنید تا کد برای آن هدف مشخص اصلاح شود.
.sp
.RS 4
.nf
cargo fix \-\-target x86_64\-pc\-windows\-gnu
.fi
.RE
.sp
در صورت بروز هرگونه مشکل در \fBcargo fix\fR یا داشتن هرگونه سوال یا درخواست ویژگی جدید، لطفاً در آدرس <https://github.com/rust\-lang/cargo> یک گزارش مشکل (issue) ثبت کنید.
.SS "مهاجرت نسخه زبانی (Edition migration)"
زیردستور \fBcargo fix\fR همچنین می‌تواند برای مهاجرت یک بسته از یک \fIنسخه زبانی (edition)\fR <https://doc.rust\-lang.org/edition\-guide/editions/transitioning\-an\-existing\-project\-to\-a\-new\-edition.html> به نسخه بعدی استفاده شود. روال کلی به این صورت است:
.sp
.RS 4
\h'-04' 1.\h'+01'دستور \fBcargo fix \-\-edition\fR را اجرا کنید. اگر پروژه شما چندین ویژگی (feature) دارد، استفاده از فلگ \fB\-\-all\-features\fR را نیز در نظر بگیرید. همچنین اگر پروژه‌تان کدهای مختص پلتفرم دارد که توسط ویژگی‌های \fBcfg\fR کنترل می‌شوند، ممکن است بخواهید \fBcargo fix \-\-edition\fR را چند بار با فلگ‌های مختلف \fB\-\-target\fR اجرا کنید.
.RE
.sp
.RS 4
\h'-04' 2.\h'+01'فایل \fBCargo.toml\fR را ویرایش کرده و \fIفیلد edition\fR <https://doc.rust\-lang.org/cargo/reference/manifest.html#the\-edition\-field> را روی نسخه زبانی جدید تنظیم کنید.
.RE
.sp
.RS 4
\h'-04' 3.\h'+01'آزمون‌های پروژه خود را اجرا کنید تا مطمئن شوید همه چیز هنوز کار می‌کند. اگر هشدارهای جدیدی صادر شد، می‌توانید اجرای مجدد \fBcargo fix\fR (بدون فلگ \fB\-\-edition\fR) را برای اعمال پیشنهادات ارائه‌شده توسط کامپایلر در نظر بگیرید.
.RE
.sp
و امیدواریم کار تمام باشد! فقط به یاد داشته باشید که طبق هشدارهای ذکر شده در بالا، \fBcargo fix\fR نمی‌تواند کدهای مربوط به ویژگی‌های غیرفعال یا عبارت‌های \fBcfg\fR را به‌روزرسانی کند. همچنین در برخی موارد نادر، کامپایلر قادر به مهاجرت خودکار تمام کد به نسخه جدید نیست و این امر ممکن است پس از ساخت پروژه با نسخه جدید، نیازمند اعمال تغییرات دستی باشد.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های اصلاح (Fix options)"
.sp
\fB\-\-broken\-code\fR
.RS 4
اصلاح کد حتی اگر از قبل دارای خطاهای کامپایلر باشد. این گزینه زمانی مفید است که \fBcargo fix\fR در اعمال تغییرات ناموفق باشد. این گزینه تغییرات را اعمال کرده و کد خراب را در پوشه کاری باقی می‌گذارد تا بتوانید آن را بررسی کرده و به‌صورت دستی اصلاح کنید.
.RE
.sp
\fB\-\-edition\fR
.RS 4
اعمال تغییراتی که کد را به نسخه زبانی (edition) بعدی به‌روزرسانی می‌کند. این گزینه نسخه زبانی را در مانیفست \fBCargo.toml\fR تغییر نمی‌دهد و این کار باید پس از پایان کار \fBcargo fix \-\-edition\fR به‌صورت دستی انجام شود.
.RE
.sp
\fB\-\-edition\-idioms\fR
.RS 4
اعمال پیشنهادهایی که کد را به سبک ترجیحی و استاندارد برای نسخه زبانی فعلی ارتقا می‌دهد.
.RE
.sp
\fB\-\-allow\-no\-vcs\fR
.RS 4
اصلاح کد حتی اگر هیچ سیستم کنترل نسخه‌ای (VCS) شناسایی نشود.
.RE
.sp
\fB\-\-allow\-dirty\fR
.RS 4
اصلاح کد حتی اگر در پوشه کاری تغییراتی وجود داشته باشد (شامل تغییرات استیج‌شده).
.RE
.sp
\fB\-\-allow\-staged\fR
.RS 4
اصلاح کد حتی اگر در پوشه کاری تغییرات استیج‌شده وجود داشته باشد.
.RE
.SS "انتخاب بسته (Package Selection)"
به‌طور پیش‌فرض، زمانی که هیچ گزینه انتخابی برای بسته‌ها مشخص نشده باشد، بسته‌های انتخاب‌شده به فایل مانیفست بستگی دارند (بر اساس پوشه کاری فعلی در صورتی که \fB\-\-manifest\-path\fR داده نشده باشد). اگر مانیفست، ریشه یک فضای کاری (workspace) باشد، اعضای پیش‌فرض فضای کاری انتخاب می‌شوند؛ در غیر این صورت فقط بسته تعریف‌شده توسط مانیفست انتخاب خواهد شد.
.sp
اعضای پیش‌فرض یک فضای کاری را می‌توان به‌طور صریح با کلید \fBworkspace.default\-members\fR در مانیفست ریشه تعیین کرد. اگر این کلید تنظیم نشده باشد، یک فضای کاری مجازی شامل تمام اعضای فضای کاری خواهد بود (معادل ارسال \fB\-\-workspace\fR) و یک فضای کاری غیرمجازی فقط خود کریت ریشه را در بر خواهد گرفت.
.sp
\fB\-p\fR \fIspec\fR\[u2026],
\fB\-\-package\fR \fIspec\fR\[u2026]
.RS 4
فقط بسته‌های مشخص‌شده را اصلاح می‌کند. برای فرمت SPEC به \fBcargo\-pkgid\fR(1) مراجعه کنید. این فلگ می‌تواند چندین بار تکرار شود و از الگوهای رایج گلوب یونیکس مانند \fB*\fR، \fB?\fR و \fB[]\fR پشتیبانی می‌کند. با این حال، برای جلوگیری از بسط تصادفی الگوهای گلوب توسط پوسته قبل از پردازش توسط 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 استفاده شود. این فلگ می‌تواند چندین بار تکرار شود و از الگوهای رایج گلوب یونیکس مانند \fB*\fR، \fB?\fR و \fB[]\fR پشتیبانی می‌کند. با این حال، برای جلوگیری از بسط تصادفی الگوهای گلوب توسط پوسته قبل از پردازش توسط Cargo، باید در اطراف هر الگو از نقل‌قول تکی یا دوتایی استفاده کنید.
.RE
.SS "انتخاب هدف (Target Selection)"
هنگامی که هیچ گزینه انتخابی برای هدف مشخص نشده باشد، \fBcargo fix\fR تمام هدف‌ها را اصلاح می‌کند (فلگ \fB\-\-all\-targets\fR به‌صورت ضمنی اعمال می‌شود). باینری‌هایی که نیازمند ویژگی‌هایی (\fBrequired\-features\fR) هستند که موجود نیستند، نادیده گرفته می‌شوند.
.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
نمونه (example) مشخص‌شده را اصلاح می‌کند. این فلگ می‌تواند چندین بار تکرار شود و از الگوهای رایج گلوب یونیکس پشتیبانی می‌کند.
.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 برای آن‌ها تنظیم شده است، اصلاح می‌کند. به‌طور پیش‌فرض این شامل کتابخانه و باینری‌های ساخته‌شده به‌عنوان آزمون واحد (unittest) و آزمون‌های یکپارچگی می‌شود. توجه داشته باشید که این کار همچنین تمامی وابستگی‌های مورد نیاز را می‌سازد، بنابراین ممکن است هدف lib دو بار ساخته شود (یک بار به‌عنوان آزمون واحد و یک بار به‌عنوان وابستگی برای باینری‌ها، آزمون‌های یکپارچگی و غیره). هدف‌ها را می‌توان با تنظیم فلگ \fBtest\fR در تنظیمات مانیفست مربوط به آن هدف فعال یا غیرفعال کرد.
.RE
.sp
\fB\-\-bench\fR \fIname\fR\[u2026]
.RS 4
بنچ‌مارک مشخص‌شده را اصلاح می‌کند. این فلگ می‌تواند چندین بار تکرار شود و از الگوهای رایج گلوب یونیکس پشتیبانی می‌کند.
.RE
.sp
\fB\-\-benches\fR
.RS 4
تمام هدف‌هایی را که فلگ مانیفست \fBbench = true\fR برای آن‌ها تنظیم شده است، اصلاح می‌کند. به‌طور پیش‌فرض این شامل کتابخانه و باینری‌های ساخته‌شده به‌عنوان بنچ‌مارک و هدف‌های بنچ می‌شود. توجه داشته باشید که این کار همچنین تمامی وابستگی‌های مورد نیاز را می‌سازد، بنابراین ممکن است هدف 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
فهرستی از ویژگی‌ها که با فاصله یا کاما از هم جدا شده‌اند تا فعال شوند. ویژگی‌های اعضای فضای کاری را می‌توان با ساختار \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
اصلاح برای معماری هدف مشخص‌شده. این فلگ را می‌توان چندین بار مشخص کرد. مقدار پیش‌فرض معماری میزبان است. فرمت کلی triple به‌صورت \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'مسیری به یک مشخصات هدف سفارشی. برای اطلاعات بیشتر به \fIمسیر جستجوی هدف سفارشی\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 در حالت متفاوتی اجرا شود که در آن مصنوعات هدف در یک پوشه جداگانه قرار می‌گیرند. برای جزئیات بیشتر به مستندات \fIحافظه موقت ساخت (build 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
به‌عنوان یک حالت خاص، مشخص کردن نمایه \fBtest\fR همچنین بررسی در حالت آزمایشی را فعال می‌کند که بررسی آزمون‌ها و گزینه cfg با نام \fBtest\fR را فعال خواهد کرد.
برای جزئیات بیشتر به \fIآزمون‌های rustc\fR <https://doc.rust\-lang.org/rustc/tests/index.html> مراجعه کنید.
.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
.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
استفاده از خروجی پرگو. می‌تواند دو بار برای خروجی «بسیار پرگو» مشخص شود که شامل خروجی‌های اضافی مانند هشدارهای وابستگی و خروجی اسکریپت ساخت است.
همچنین می‌تواند با \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
قالب خروجی برای پیام‌های تشخیصی. می‌تواند چندین بار مشخص شود و شامل مقادیری است که با کاما از هم جدا شده‌اند. مقادیر معتبر:
.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 شامل رندر «کوتاه» از 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
می‌توان از آن در محیط‌هایی که نیاز به ساخت‌های قطعی و قطعی‌گرا (deterministic) دارند، مانند خطوط لوله CI استفاده کرد.
.RE
.sp
\fB\-\-offline\fR
.RS 4
از دسترسی Cargo به شبکه به هر دلیلی جلوگیری می‌کند. بدون این فلگ، اگر Cargo نیاز به دسترسی به شبکه داشته باشد و شبکه در دسترس نباشد، با خطا متوقف می‌شود. با این فلگ، Cargo در صورت امکان تلاش می‌کند بدون شبکه کار را پیش ببرد.
.sp
توجه داشته باشید که این ممکن است به تفکیک وابستگی متفاوتی نسبت به حالت آنلاین منجر شود. Cargo خود را به کریت‌هایی محدود می‌کند که به‌صورت محلی دانلود شده‌اند، حتی اگر نسخه جدیدتری همان‌طور که در نسخه محلی ایندکس نشان داده شده وجود داشته باشد. برای دانلود وابستگی‌ها قبل از آفلاین شدن، دستور \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
به جای متوقف کردن ساخت با اولین کریتی که ساخت آن با شکست مواجه شد، تا حد امکان کریت‌های بیشتری را در گراف وابستگی می‌سازد.
.sp
برای نمونه، اگر بسته فعلی به وابستگی‌های \fBfails\fR و \fBworks\fR وابسته باشد که یکی از آن‌ها در ساخت شکست می‌خورد، دستور \fBcargo fix \-j1\fR ممکن است وابستگی موفق را بسازد یا نسازد (بسته به اینکه Cargo کدام یک از دو ساخت را برای اجرا در ابتدا انتخاب کرده باشد)، در حالی که \fBcargo fix \-j1 \-\-keep\-going\fR قطعاً هر دو ساخت را اجرا خواهد کرد، حتی اگر موردی که اول اجرا شده شکست بخورد.
.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 fix
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 2.\h'+01'به‌روزرسانی یک بسته برای آماده‌سازی آن جهت نسخه زبانی (edition) بعدی:
.sp
.RS 4
.nf
cargo fix \-\-edition
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 3.\h'+01'اعمال سبک‌ها و الگوهای پیشنهادی (idioms) برای نسخه زبانی فعلی:
.sp
.RS 4
.nf
cargo fix \-\-edition\-idioms
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-check\fR(1)