'\" t
.TH "CARGO\-LOGIN" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-login \- ورود به یک رجیستری
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo login\fR [\fIگزینه‌ها\fR] [\fB\-\-\fR \fIآرگومان‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
این دستور یک ارائه‌دهندهٔ اعتبارنامه (credential provider) را برای ذخیرهٔ یک توکن اجرا می‌کند، به‌طوری که دستورهای نیازمند احراز هویت، مانند \fBcargo\-publish\fR(1)، به‌صورت خودکار احراز هویت شوند.
.sp
تمام آرگومان‌های پس از دو خط تیره (\fB\-\-\fR) به ارائه‌دهندهٔ اعتبارنامه ارسال می‌شوند.
.sp
برای ارائه‌دهندهٔ اعتبارنامهٔ پیش‌فرض \fBcargo:token\fR، توکن در \fB$CARGO_HOME/credentials.toml\fR ذخیره می‌شود\&. مقدار پیش‌فرض \fBCARGO_HOME\fR دایرکتوری \fB\&.cargo\fR در دایرکتوری خانگی شما است\&.
.sp
اگر برای یک رجیستری ارائه‌دهندهٔ اعتبارنامه‌ای مشخص شده باشد، از آن استفاده خواهد شد. در غیر این صورت، ارائه‌دهنده‌های مشخص‌شده در مقدار پیکربندی \fBregistry.global\-credential\-providers\fR به‌ترتیب از انتهای فهرست بررسی و امتحان خواهند شد.
.sp
مقدار \fItoken\fR از ورودی استاندارد (stdin) خوانده خواهد شد.
.sp
توکن API برای crates.io را می‌توان از <https://crates.io/me> دریافت کرد\&.
.sp
در حفظ و محرمانگی توکن دقت کنید؛ این توکن نباید با هیچ‌کس دیگری به اشتراک گذاشته شود.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های ورود (Login Options)"
.sp
\fB\-\-registry\fR \fIregistry\fR
.RS 4
نام رجیستری مورد استفاده. نام‌های رجیستری در \fIفایل‌های پیکربندی Cargo\fR <https://doc.rust\-lang.org/cargo/reference/config.html> تعریف می‌شوند\&. در صورت عدم تعیین، از رجیستری پیش‌فرض استفاده می‌شود که توسط کلید پیکربندی \fBregistry.default\fR مشخص شده و مقدار پیش‌فرض آن \fBcrates\-io\fR است\&.
.RE
.SS "گزینه‌های نمایش (Display Options)"
.sp
\fB\-v\fR, 
\fB\-\-verbose\fR
.RS 4
استفاده از خروجی پرجزئیات. برای خروجی \[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
پیام‌های لاگ کارگو را چاپ نمی‌کند.
همچنین می‌تواند با \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 آغاز شود، به‌عنوان نام زنجیره ابزار 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 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'ذخیرهٔ توکن برای رجیستری پیش‌فرض:
.sp
.RS 4
.nf
cargo login
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 2.\h'+01'ذخیرهٔ توکن برای یک رجیستری خاص:
.sp
.RS 4
.nf
cargo login \-\-registry my\-registry
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-logout\fR(1), \fBcargo\-publish\fR(1)