'\" t
.TH "CARGO\-INSTALL" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-install \- ساخت و نصب باینری Rust
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo install\fR [\fIگزینه‌ها\fR] \fIcrate\fR[@\fIversion\fR]\[u2026]
.br
\fBcargo install\fR [\fIگزینه‌ها\fR] \fB\-\-path\fR \fIpath\fR
.br
\fBcargo install\fR [\fIگزینه‌ها\fR] \fB\-\-git\fR \fIurl\fR [\fIcrate\fR\[u2026]]
.br
\fBcargo install\fR [\fIگزینه‌ها\fR] \fB\-\-list\fR
.SH "توضیحات (DESCRIPTION)"
این دستور مجموعهٔ محلی کریت‌های باینری نصب‌شده توسط Cargo را مدیریت می‌کند. تنها
بسته‌هایی که دارای هدف‌های اجرایی \fB[[bin]]\fR یا \fB[[example]]\fR هستند قابلیت
نصب دارند، و تمامی فایل‌های اجرایی در پوشهٔ \fBbin\fR واقع در ریشهٔ نصب قرار می‌گیرند.
به‌طور پیش‌فرض تنها باینری‌ها نصب می‌شوند و نمونه‌ها (examples) نصب نخواهند شد.
.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'مقدار پیکربندی Cargo برای \fBinstall.root\fR <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
.sp
منابع متعددی وجود دارند که می‌توان یک کریت را از آن‌ها نصب کرد. منبع پیش‌فرض
crates.io است، اما پرچم‌های \fB\-\-git\fR، \fB\-\-path\fR و \fB\-\-registry\fR
می‌توانند این منبع را تغییر دهند. اگر منبع حاوی بیش از یک بسته باشد (مانند crates.io
یا یک مخزن git با چندین کریت)، آرگومان \fIcrate\fR برای مشخص کردن این‌که کدام کریت باید
نصب شود الزامی است.
.sp
کریت‌های دریافت‌شده از crates.io می‌توانند به صورت اختیاری نسخهٔ مورد نظر را از طریق
پرچم \fB\-\-version\fR تعیین کنند، و به همین ترتیب بسته‌های حاصل از مخازن git نیز
می‌توانند شاخه، برچسب یا بازبینی (revision) مد نظر را مشخص نمایند. اگر یک کریت دارای
چندین باینری باشد، با استفاده از آرگومان \fB\-\-bin\fR می‌توان تنها یکی از آن‌ها را به
صورت گزینشی نصب کرد؛ همچنین در صورت تمایل به نصب نمونه‌ها، می‌توان از آرگومان
\fB\-\-example\fR استفاده نمود.
.sp
اگر بسته از قبل نصب شده باشد، در صورتی که نسخهٔ نصب‌شده به‌روز به نظر نرسد، Cargo آن را
مجدداً نصب خواهد کرد. در صورت تغییر هر یک از مقادیر زیر، Cargo اقدام به نصب مجدد بسته می‌کند:
.sp
.RS 4
\h'-04'\(bu\h'+03'نسخه و منبع بسته.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'مجموعه نام‌های باینری‌های نصب‌شده.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'ویژگی‌های (features) انتخاب‌شده.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'پروفایل (\fB\-\-profile\fR).
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'معماری مقصد (\fB\-\-target\fR).
.RE
.sp
نصب با \fB\-\-path\fR همیشه عملیات ساخت و نصب را انجام می‌دهد، مگر اینکه باینری‌های
تداخل‌داری از یک بستهٔ دیگر وجود داشته باشند. پرچم \fB\-\-force\fR می‌تواند برای
اجبار Cargo به نصب مجدد بسته در هر شرایطی استفاده شود.
.sp
اگر منبع crates.io یا \fB\-\-git\fR باشد، کریت به‌طور پیش‌فرض در یک دایرکتوری مقصد موقت
ساخته خواهد شد. برای جلوگیری از این رفتار، دایرکتوری مقصد را می‌توان با تنظیم متغیر
محیطی \fBCARGO_TARGET_DIR\fR روی یک مسیر دلخواه مشخص کرد. این کار به‌ویژه برای
کش کردن خروجی‌های ساخت در سامانه‌های یکپارچه‌سازی مداوم (CI) کاربرد دارد..SS "کار با فایل قفل (Dealing with the Lockfile)"
به‌طور پیش‌فرض، فایل \fBCargo.lock\fR که همراه با بسته قرار دارد نادیده گرفته
خواهد شد. این بدان معناست که Cargo مجدداً محاسبه خواهد کرد که از کدام نسخه‌های وابستگی‌ها
استفاده کند، و احتمالاً از نسخه‌های جدیدتری که از زمان انتشار بسته منتشر شده‌اند
استفاده می‌کند. پرچم \fB\-\-locked\fR می‌تواند برای وادار کردن Cargo به استفاده از
فایل \fBCargo.lock\fR موجود در بسته (در صورت وجود) به کار رود. این ویژگی می‌تواند برای
اطمینان از ساخت‌های بازتولیدپذیر (reproducible builds) و استفاده از همان مجموعه دقیق وابستگی‌هایی
که هنگام انتشار بسته در دسترس بودند، مفید باشد. همچنین اگر نسخه جدیدتری از یک وابستگی
منتشر شود که دیگر روی سیستم شما ساخته نمی‌شود یا مشکلات دیگری دارد، کاربردی است.
نکته منفی استفاده از \fB\-\-locked\fR این است که هیچ‌گونه اصلاحیه یا به‌روزرسانی برای
هیچ‌یک از وابستگی‌ها دریافت نخواهید کرد. توجه داشته باشید که Cargo تا نسخه 1.37 شروع به
انتشار فایل‌های \fBCargo.lock\fR نکرد؛ بدین معنا که بسته‌های منتشرشده با نسخه‌های پیشین،
فایل \fBCargo.lock\fR در دسترس نخواهند داشت.
.SS "کشف پیکربندی (Configuration Discovery)"
این دستور در سطح سیستم یا کاربر عمل می‌کند، نه در سطح پروژه.
این یعنی \fIکشف پیکربندی\fR محلی <https://doc.rust\-lang.org/cargo/reference/config.html#hierarchical\-structure> نادیده گرفته می‌شود.
در عوض، کشف پیکربندی از \fB$CARGO_HOME/config.toml\fR\& آغاز می‌شود.
اگر بسته با \fB\-\-path $PATH\fR نصب شود، پیکربندی محلی استفاده خواهد شد که
کشف آن از \fB$PATH/.cargo/config.toml\fR\& آغاز می‌گردد.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های نصب (Install Options)"
.sp
\fB\-\-vers\fR \fIversion\fR, 
\fB\-\-version\fR \fIversion\fR
.RS 4
مشخص کردن نسخه‌ای برای نصب. این مقدار می‌تواند یک \fIالزام نسخه\fR <https://doc.rust\-lang.org/cargo/reference/specifying\-dependencies.html> مانند \fB~1.2\fR باشد تا Cargo تازه‌ترین نسخه را بر اساس الزام مشخص‌شده انتخاب کند. اگر نسخه دارای عملگر الزام (مانند \fB^\fR یا \fB~\fR) نباشد، باید در قالب \fIMAJOR.MINOR.PATCH\fR باشد و دقیقاً همان نسخه را نصب خواهد کرد؛ برخلاف وابستگی‌های Cargo، با آن به عنوان یک الزام علامت هشتک (caret) برخورد \fIنمی‌شود\fR.
.RE
.sp
\fB\-\-git\fR \fIurl\fR
.RS 4
نشانی Git برای نصب crate مشخص‌شده از آن.
.RE
.sp
\fB\-\-branch\fR \fIbranch\fR
.RS 4
شاخه‌ای (branch) که هنگام نصب از git استفاده می‌شود.
.RE
.sp
\fB\-\-tag\fR \fItag\fR
.RS 4
برچسبی (tag) که هنگام نصب از git استفاده می‌شود.
.RE
.sp
\fB\-\-rev\fR \fIsha\fR
.RS 4
کامیت مشخصی که هنگام نصب از git استفاده می‌شود.
.RE
.sp
\fB\-\-path\fR \fIpath\fR
.RS 4
مسیر سیستم‌فایل به crate محلی برای نصب از آن.
.RE
.sp
\fB\-\-list\fR
.RS 4
فهرست کردن تمام بسته‌های نصب‌شده و نسخه‌های آن‌ها.
.RE
.sp
\fB\-n\fR, 
\fB\-\-dry\-run\fR
.RS 4
(ناپایدار) انجام تمام بررسی‌ها بدون نصب.
.RE
.sp
\fB\-f\fR, 
\fB\-\-force\fR
.RS 4
اجبار به رونویسی crateها یا باینری‌های موجود. این گزینه زمانی که یک بسته
یک باینری هم‌نام با بسته دیگری را نصب کرده باشد، می‌تواند استفاده شود.
همچنین زمانی که چیزی در سیستم تغییر کرده و می‌خواهید مجدداً با آن بسازید،
مانند نسخه جدیدتری از \fBrustc\fR\&، مفید است.
.RE
.sp
\fB\-\-no\-track\fR
.RS 4
به‌طور پیش‌فرض، Cargo بسته‌های نصب‌شده را با یک فایل متادیتا که در دایرکتوری
ریشه نصب ذخیره می‌شود ردیابی می‌کند. این پرچم به Cargo می‌گوید که از آن فایل
استفاده نکرده یا آن را ایجاد نکند. با این پرچم، Cargo از رونویسی هرگونه فایل
موجود خودداری خواهد کرد مگر اینکه از پرچم \fB\-\-force\fR استفاده شود. این پرچم همچنین
توانایی Cargo را در محافظت در برابر چندین فراخوانی هم‌زمان Cargo برای نصب در یک
زمان یکسان غیرفعال می‌کند.
.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\-\-root\fR \fIdir\fR
.RS 4
دایرکتوری برای نصب بسته‌ها در آن.
.RE
.sp
\fB\-\-registry\fR \fIregistry\fR
.RS 4
نام registry مورد استفاده. نام‌های registry در \fIفایل‌های پیکربندی Cargo\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\& تعریف شده‌اند. در صورت عدم تعیین، از registry پیش‌فرض استفاده می‌شود که توسط کلید پیکربندی \fBregistry.default\fR تعریف شده و مقدار پیش‌فرض آن \fBcrates\-io\fR\& است.
.RE
.sp
\fB\-\-index\fR \fIindex\fR
.RS 4
نشانی اینترنتی (URL) نمایه registry مورد استفاده.
.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
نصب برای معماری مقصد مشخص‌شده. حالت پیش‌فرض معماری میزبان است. ساختار کلی سه‌تایی به‌صورت
\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
این گزینه می‌تواند با مقدار پیکربندی \fBbuild.target\fR در \fIconfig value\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\-\-target\-dir\fR \fIdirectory\fR
.RS 4
دایرکتوری برای تمامی مصنوعات تولیدشده و فایل‌های میانی. همچنین می‌تواند با متغیر
محیطی \fBCARGO_TARGET_DIR\fR یا مقدار پیکربندی
\fBbuild.target\-dir\fR در \fIconfig value\fR <https://doc.rust\-lang.org/cargo/reference/config.html> مشخص شود.
به‌طور پیش‌فرض در یک پوشهٔ موقت جدید واقع در
دایرکتوری موقت سیستم قرار می‌گیرد.
.sp
هنگام استفاده از \fB\-\-path\fR، به‌طور پیش‌فرض از دایرکتوری \fBtarget\fR در فضای‌کاری
کریت محلی استفاده خواهد شد، مگر اینکه \fB\-\-target\-dir\fR
مشخص شده باشد.
.RE
.sp
\fB\-\-debug\fR
.RS 4
ساخت با پروفایل \fBdev\fR به‌جای پروفایل \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 "گزینه‌های مانیفست (Manifest Options)"
.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 خود را به crateهایی که به‌صورت محلی بارگیری شده‌اند محدود می‌کند، حتی اگر طبق نسخهٔ محلی نمایه (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 "گزینه‌های متفرقه (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 install \-j1\fR ممکن است موردی را که ساختش موفقیت‌آمیز است بسازد یا نسازد (بسته به اینکه Cargo ابتدا اجرای کدام ساخت را انتخاب کرده باشد)، در حالی که \fBcargo install \-j1 \-\-keep\-going\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
پیام‌های گزارش (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
قالب خروجی برای پیام‌های تشخیصی. می‌تواند چندین بار مشخص شود و شامل مقادیری است که با کاما از هم جدا شده‌اند. مقادیر معتبر:
.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 "گزینه‌های عمومی (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
.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'نصب یا ارتقای یک بسته از crates.io:
.sp
.RS 4
.nf
cargo install ripgrep
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 2.\h'+01'نصب یا نصب مجدد بسته در دایرکتوری فعلی:
.sp
.RS 4
.nf
cargo install \-\-path .
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 3.\h'+01'مشاهده فهرست بسته‌های نصب‌شده:
.sp
.RS 4
.nf
cargo install \-\-list
.fi
.RE
.RE.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-uninstall\fR(1), \fBcargo\-search\fR(1), \fBcargo\-publish\fR(1)