'\" t
.TH "CARGO\-UNINSTALL" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-uninstall \- حذف یک باینری Rust
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo uninstall\fR [\fIگزینه‌ها\fR] [\fIspec\fR\[u2026]]
.SH "توضیحات (DESCRIPTION)"
این دستور بسته‌ای را که با \fBcargo\-install\fR(1) نصب شده است حذف می‌کند. آرگومان \fIspec\fR
مشخصه شناسه بسته (package ID specification) برای بسته‌ای است که باید حذف شود (به
\fBcargo\-pkgid\fR(1) مراجعه کنید).
.sp
به‌طور پیش‌فرض تمام باینری‌های یک crate حذف می‌شوند، اما می‌توان از پرچم‌های \fB\-\-bin\fR و
\fB\-\-example\fR برای حذف تنها باینری‌های خاص استفاده کرد.
.sp
ریشه محل نصب، به ترتیب اولویت تعیین می‌شود:
.sp
.RS 4
\h'-04'\(bu\h'+03'گزینه \fB\-\-root\fR
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'متغیر محیطی \fBCARGO_INSTALL_ROOT\fR
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fIمقدار پیکربندی\fR \fBinstall.root\fR در Cargo <https://doc.rust\-lang.org/cargo/reference/config.html>
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'متغیر محیطی \fBCARGO_HOME\fR
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB$HOME/.cargo\fR
.RE
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های حذف (Uninstall Options)"
.sp
\fB\-p\fR, 
\fB\-\-package\fR \fIspec\fR\[u2026]
.RS 4
بسته‌ای که باید حذف شود.
.RE
.sp
\fB\-\-bin\fR \fIname\fR\[u2026]
.RS 4
تنها باینری \fIname\fR را حذف می‌کند.
.RE
.sp
\fB\-\-root\fR \fIdir\fR
.RS 4
دایرکتوری‌ای که بسته‌ها از آن باید حذف شوند.
.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
.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
.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 uninstall ripgrep
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-install\fR(1)