'\" t
.TH "CARGO\-PKGID" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-pkgid \- چاپ مشخصه کامل یک بسته
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo pkgid\fR [\fIoptions\fR] [\fIspec\fR]
.SH "توضیحات (DESCRIPTION)"
با دریافت یک آرگومان \fIspec\fR، مشخصه‌ساز شناسه بسته (Package ID) کامل را برای یک بسته یا وابستگی در فضای کاری فعلی چاپ می‌کند. این دستور در صورتی که \fIspec\fR دارای ابهام باشد و مشخص نباشد به کدام بسته در گراف وابستگی‌ها اشاره می‌کند، خطایی ایجاد خواهد کرد. اگر هیچ \fIspec\fR مشخص نشود، مشخصه‌ساز بسته محلی چاپ خواهد شد.
.sp
این دستور نیازمند در دسترس بودن فایل قفل (lockfile) و واکشی شدن وابستگی‌ها است.
.sp
مشخصه‌ساز بسته شامل نام، نسخه و URL منبع است. شما مجاز هستید تا زمانی که تنها با یک بسته مطابقت داشته باشد، از مشخصه‌سازهای جزئی برای تطبیق مختصر یک بسته خاص استفاده کنید. این مشخصه‌ساز توسط بخش‌های دیگر Cargo مانند \fBcargo\-metadata\fR(1) و \fIپیام‌های JSON\fR <https://doc.rust\-lang.org/cargo/reference/external\-tools.html#json\-messages> صادرشده توسط Cargo نیز استفاده می‌شود.
.sp
قالب یک \fIspec\fR می‌تواند یکی از موارد زیر باشد:

.TS
allbox tab(:);
lt lt.
T{
ساختار SPEC
T}:T{
نمونه SPEC
T}
T{
\fIname\fR
T}:T{
\fBbitflags\fR
T}
T{
\fIname\fR\fB@\fR\fIversion\fR
T}:T{
\fBbitflags@1.0.4\fR
T}
T{
\fIurl\fR
T}:T{
\fBhttps://github.com/rust\-lang/cargo\fR
T}
T{
\fIurl\fR\fB#\fR\fIversion\fR
T}:T{
\fBhttps://github.com/rust\-lang/cargo#0.33.0\fR
T}
T{
\fIurl\fR\fB#\fR\fIname\fR
T}:T{
\fBhttps://github.com/rust\-lang/crates.io\-index#bitflags\fR
T}
T{
\fIurl\fR\fB#\fR\fIname\fR\fB@\fR\fIversion\fR
T}:T{
\fBhttps://github.com/rust\-lang/cargo#crates\-io@0.21.0\fR
T}
.TE
.sp
.sp
دستور زبان مشخصه‌سازی در فصل \fIPackage ID Specifications\fR <https://doc.rust\-lang.org/cargo/reference/pkgid\-spec.html>\& موجود است.
.SH "گزینه‌ها (OPTIONS)"
.SS "انتخاب بسته (Package Selection)"
.sp
\fB\-p\fR \fIspec\fR, 
\fB\-\-package\fR \fIspec\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
پیام‌های لاگ کارگو را چاپ نمی‌کند.
همچنین می‌تواند با \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 "گزینه‌های مانیفست (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'فایل قفل وجود نداشته باشد.
.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
همچنین می‌تواند با \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 "گزینه‌های عمومی (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
دایرکتوری کاری فعلی را قبل از اجرای هر عملیات مشخص‌شده تغییر می‌دهد. این امر مواردی مانند جایی که 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: کارگو با موفقیت پایان یافت.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'\fB101\fR: کارگو در تکمیل عملیات ناموفق بود.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
\h'-04' 1.\h'+01'دریافت مشخصه بسته برای بسته \fBfoo\fR:
.sp
.RS 4
.nf
cargo pkgid foo
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 2.\h'+01'دریافت مشخصه بسته برای نسخه 1.0.0 از \fBfoo\fR:
.sp
.RS 4
.nf
cargo pkgid foo@1.0.0
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 3.\h'+01'دریافت مشخصه بسته برای \fBfoo\fR از crates.io:
.sp
.RS 4
.nf
cargo pkgid https://github.com/rust\-lang/crates.io\-index#foo
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 4.\h'+01'دریافت مشخصه بسته برای \fBfoo\fR از یک بسته محلی:
.sp
.RS 4
.nf
cargo pkgid file:///path/to/local/package#foo
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-generate\-lockfile\fR(1), \fBcargo\-metadata\fR(1),
\fIPackage ID Specifications\fR <https://doc.rust\-lang.org/cargo/reference/pkgid\-spec.html>, \fIJSON messages\fR <https://doc.rust\-lang.org/cargo/reference/external\-tools.html#json\-messages>