'\" t
.TH "CARGO\-CLEAN" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-clean \- پاک‌سازی مصنوعات تولیدشده
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo clean\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
مصنوعات (artifacts) تولیدشده توسط Cargo در گذشته را از دایرکتوری target حذف می‌کند.
.sp
بدون هیچ گزینه‌ای، دستور \fBcargo clean\fR کل دایرکتوری target را حذف خواهد کرد.
.SH "گزینه‌ها (OPTIONS)"
.SS "انتخاب بسته (Package Selection)"
هنگامی که هیچ بسته‌ای انتخاب نشده باشد، تمام بسته‌ها و وابستگی‌های موجود در workspace پاک‌سازی می‌شوند.
.sp
\fB\-p\fR \fIspec\fR\[u2026], 
\fB\-\-package\fR \fIspec\fR\[u2026]
.RS 4
تنها بسته‌های مشخص‌شده را پاک‌سازی می‌کند. این پرچم می‌تواند چندین بار مشخص شود. برای ساختار SPEC، \fBcargo\-pkgid\fR(1) را ببینید.
.RE
.sp
\fB\-\-workspace\fR
.RS 4
پاک‌سازی مصنوعات مربوط به اعضای workspace.
.RE
.SS "گزینه‌های پاک‌سازی (Clean Options)"
.sp
\fB\-\-dry\-run\fR
.RS 4
خلاصه‌ای از آنچه حذف خواهد شد را بدون حذف هیچ چیزی نمایش می‌دهد. برای نمایش فایل‌های واقعی که حذف خواهند شد، به همراه \fB\-\-verbose\fR استفاده شود.
.RE
.sp
\fB\-\-doc\fR
.RS 4
این گزینه باعث می‌شود \fBcargo clean\fR تنها دایرکتوری \fBdoc\fR را در دایرکتوری target حذف کند.
.RE
.sp
\fB\-\-release\fR
.RS 4
تمام مصنوعات موجود در دایرکتوری \fBrelease\fR را حذف می‌کند.
.RE
.sp
\fB\-\-profile\fR \fIname\fR
.RS 4
تمام مصنوعات موجود در دایرکتوری با نام profile داده‌شده را حذف می‌کند.
.RE
.sp
\fB\-\-target\-dir\fR \fIdirectory\fR
.RS 4
دایرکتوری برای تمامی مصنوعات تولیدشده و فایل‌های میانی. همچنین می‌تواند با متغیر محیطی \fBCARGO_TARGET_DIR\fR یا مقدار پیکربندی \fBbuild.target\-dir\fR در <https://doc.rust\-lang.org/cargo/reference/config.html>\& مشخص شود. مقدار پیش‌فرض آن، دایرکتوری \fBtarget\fR در ریشهٔ workspace است.
.RE
.sp
\fB\-\-target\fR \fItriple\fR
.RS 4
پاک‌سازی برای معماری مقصد (target) مشخص‌شده. این پرچم می‌تواند چندین بار مشخص شود. مقدار پیش‌فرض، معماری میزبان (host) است. ساختار کلی سه‌گانه (triple) به‌صورت
\fB<arch><sub>\-<vendor>\-<sys>\-<abi>\fR\& است.
.sp
مقادیر ممکن:
.sp
.RS 4
\h'-04'\(bu\h'+03'هر target پشتیبانی‌شده در \fBrustc \-\-print target\-list\fR\&.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB"host\-tuple"\fR، که در داخل با target میزبان جایگزین خواهد شد. این مقدار به‌ویژه زمانی مفید است که در حال کامپایل متقابل (cross-compile) برخی crateها هستید و نمی‌خواهید ماشین میزبان خود را به‌صورت صریح به‌عنوان یک target مشخص کنید (به‌عنوان مثال، یک \fBxtask\fR در یک پروژهٔ مشترک که ممکن است توسط میزبان‌های مختلف روی آن کار شود).
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'مسیری به یک مشخصات target سفارشی. برای اطلاعات بیشتر، \fICustom Target Lookup Path\fR <https://doc.rust\-lang.org/rustc/targets/custom.html#custom\-target\-lookup\-path> را ببینید.
.RE
.sp
این مورد همچنین می‌تواند با مقدار پیکربندی \fBbuild.target\fR در <https://doc.rust\-lang.org/cargo/reference/config.html>\& مشخص شود.
.sp
توجه داشته باشید که مشخص کردن این پرچم باعث می‌شود Cargo در حالت متفاوتی اجرا شود که در آن مصنوعات target در یک دایرکتوری جداگانه قرار می‌گیرند. برای جزئیات بیشتر، مستندات \fIbuild cache\fR <https://doc.rust\-lang.org/cargo/reference/build\-cache.html> را ببینید.
.RE
.SS "گزینه‌های نمایش (Display Options)"
.sp
\fB\-v\fR, 
\fB\-\-verbose\fR
.RS 4
استفاده از خروجی پرگو (verbose). می‌تواند دو بار برای خروجی «بسیار پرگو» مشخص شود که شامل خروجی‌های اضافی مانند هشدارهای وابستگی و خروجی اسکریپت ساخت است.
همچنین می‌تواند با مقدار پیکربندی \fBterm.verbose\fR در
\fIconfig value\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\& مشخص شود.
.RE
.sp
\fB\-q\fR, 
\fB\-\-quiet\fR
.RS 4
پیام‌های گزارش کارگو را چاپ نمی‌کند.
همچنین می‌تواند با مقدار پیکربندی \fBterm.quiet\fR در
\fIconfig value\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
همچنین می‌تواند با مقدار پیکربندی \fBterm.color\fR در
\fIconfig value\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\& مشخص شود.
.RE
.SS "گزینه‌های مانیفست (Manifest Options)"
.sp
\fB\-\-manifest\-path\fR \fIpath\fR
.RS 4
مسیر فایل \fBCargo.toml\fR. به‌طور پیش‌فرض، Cargo فایل \fBCargo.toml\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'کارگو به دلیل برطرف‌سازی متفاوت وابستگی‌ها تلاش کند فایل قفل را تغییر دهد.
.RE
.sp
این گزینه می‌تواند در محیط‌هایی که ساخت‌های قطعی و تکرارپذیر مورد نظر است، مانند خطوط لولهٔ CI، استفاده شود.
.RE
.sp
\fB\-\-offline\fR
.RS 4
از دسترسی Cargo به شبکه به هر دلیلی جلوگیری می‌کند. بدون این پرچم، اگر Cargo نیاز به دسترسی به شبکه داشته باشد و شبکه در دسترس نباشد، با خطا متوقف خواهد شد. با این پرچم، Cargo در صورت امکان تلاش می‌کند بدون شبکه ادامه دهد.
.sp
توجه داشته باشید که این ممکن است به حل وابستگی متفاوتی نسبت به حالت آنلاین منجر شود. Cargo خود را به crateهایی که به‌صورت محلی دانلود شده‌اند محدود می‌کند، حتی اگر طبق نسخهٔ محلی اندیس، نسخهٔ جدیدتری وجود داشته باشد. برای دانلود وابستگی‌ها پیش از رفتن به حالت آفلاین، دستور \fBcargo\-fetch\fR(1) را ببینید.
.sp
همچنین می‌تواند با مقدار پیکربندی \fBnet.offline\fR در \fIconfig value\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). برای اطلاعات بیشتر در مورد نحوهٔ کارکرد بازنویسی‌های زنجیره ابزار، به \fIrustup documentation\fR <https://rust\-lang.github.io/rustup/overrides.html> مراجعه کنید.
.RE
.sp
\fB\-\-config\fR \fIKEY=VALUE\fR or \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
دایرکتوری کاری فعلی را قبل از اجرای هر عملیات مشخص‌شده تغییر می‌دهد. این موضوع بر مواردی مانند جایی که کارگو به‌طور پیش‌فرض برای مانیفست پروژه (\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
.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: کارگو با موفقیت پایان یافت.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB101\fR: کارگو در تکمیل عملیات با شکست مواجه شد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
\h'-04' 1.\h'+01'حذف کامل دایرکتوری target:
.sp
.RS 4
.nf
cargo clean
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 2.\h'+01'حذف تنها مصنوعات release:
.sp
.RS 4
.nf
cargo clean \-\-release
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-build\fR(1)