'\" t
.TH "CARGO\-OWNER" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-owner \- مدیریت مالکان یک کریت در رجیستری Crates.io
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo owner\fR [\fIگزینه‌ها\fR] \fB\-\-add\fR \fIlogin\fR [\fIکریت\fR]
.br
\fBcargo owner\fR [\fIگزینه‌ها\fR] \fB\-\-remove\fR \fIlogin\fR [\fIکریت\fR]
.br
\fBcargo owner\fR [\fIگزینه‌ها\fR] \fB\-\-list\fR [\fIکریت\fR]
.SH "توضیحات (DESCRIPTION)"
این دستور مالکان یک کریت در رجیستری را ویرایش می‌کند. مالکان یک کریت می‌توانند نسخه‌های جدید را بارگذاری کرده و نسخه‌های قدیمی را غیرفعال (yank) کنند. مالکان غیرتیمی نیز می‌توانند فهرست مالکان را تغییر دهند، بنابراین احتیاط کنید!
.sp
برای اجرای این دستور باید با گزینه
\fB\-\-token\fR
یا با استفاده از
\fBcargo\-login\fR(1)
احراز هویت شده باشید.
.sp
اگر نام کریت مشخص نشود، از نام بسته در دایرکتوری جاری استفاده خواهد شد.
.sp
برای اطلاعات بیشتر درباره مالکان و انتشار،
\fIمرجع کارگو\fR <https://doc.rust\-lang.org/cargo/reference/publishing.html#cargo\-owner>
را ببینید.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های مالک (Owner Options)"
.sp
\fB\-a\fR,
\fB\-\-add\fR \fIlogin\fR\[u2026]
.RS 4
دعوت از کاربر یا تیم مشخص‌شده به عنوان مالک.
.RE
.sp
\fB\-r\fR,
\fB\-\-remove\fR \fIlogin\fR\[u2026]
.RS 4
حذف کاربر یا تیم مشخص‌شده از فهرست مالکان.
.RE
.sp
\fB\-l\fR,
\fB\-\-list\fR
.RS 4
فهرست کردن مالکان یک کریت.
.RE
.sp
\fB\-\-token\fR \fItoken\fR
.RS 4
توکن API مورد استفاده هنگام احراز هویت. این مقدار توکن ذخیره‌شده در فایل اطلاعات کاربری (credentials که توسط
\fBcargo\-login\fR(1)
ایجاد می‌شود) را لغو و جایگزین می‌کند.
.sp
متغیرهای محیطی
\fIپیکربندی کارگو\fR <https://doc.rust\-lang.org/cargo/reference/config.html>
را می‌توان برای لغو توکن‌های ذخیره‌شده در فایل اطلاعات کاربری استفاده کرد. توکن برای crates.io را می‌توان با متغیر محیطی
\fBCARGO_REGISTRY_TOKEN\fR
مشخص کرد. توکن‌های سایر رجیستری‌ها را می‌توان با متغیرهای محیطی به شکل
\fBCARGO_REGISTRIES_NAME_TOKEN\fR
مشخص نمود که در آن
\fBNAME\fR
نام رجیستری با حروف بزرگ است.
.RE
.sp
\fB\-\-index\fR \fIindex\fR
.RS 4
نشانی اینترنتی (URL) ایندکس رجیستری مورد استفاده.
.RE
.sp
\fB\-\-registry\fR \fIregistry\fR
.RS 4
نام رجیستری مورد استفاده. نام‌های رجیستری در
\fIفایل‌های پیکربندی کارگو\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
استفاده از خروجی با جزئیات. برای خروجی بسیار پرجزئیات می‌توان دو بار مشخص کرد که شامل خروجی‌های اضافی مانند هشدارهای وابستگی و خروجی اسکریپت ساخت می‌شود. همچنین می‌توان آن را با مقدار پیکربندی
\fBterm.verbose\fR
در
\fIتنظیمات کارگو\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\&
مشخص نمود.
.RE
.sp
\fB\-q\fR,
\fB\-\-quiet\fR
.RS 4
عدم چاپ پیام‌های گزارش (log) کارگو. همچنین می‌توان آن را با مقدار پیکربندی
\fBterm.quiet\fR
در
\fIتنظیمات کارگو\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
در
\fIتنظیمات کارگو\fR <https://doc.rust\-lang.org/cargo/reference/config.html>\&
مشخص نمود.
.RE
.SS "گزینه‌های عمومی (Common Options)"
.sp
\fB+\fR\fItoolchain\fR
.RS 4
اگر کارگو با 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 or \fIPATH\fR
.RS 4
بازنویسی مقدار پیکربندی کارگو. آرگومان باید در ساختار نحوی 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) برای کارگو. برای جزئیات
\fBcargo \-Z help\fR
را اجرا کنید.
.RE
.SH "محیط (ENVIRONMENT)"
برای جزئیات درباره متغیرهای محیطی که کارگو می‌خواند،
\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 owner \-\-list foo
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 2.\h'+01'دعوت از یک مالک برای بسته:
.sp
.RS 4
.nf
cargo owner \-\-add username foo
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 3.\h'+01'حذف یک مالک از بسته:
.sp
.RS 4
.nf
cargo owner \-\-remove username foo
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-login\fR(1), \fBcargo\-publish\fR(1)