'\" t
.TH "CARGO\-INFO" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-info \- نمایش اطلاعات درباره یک بسته
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo info\fR [\fIگزینه‌ها\fR] \fIspec\fR
.SH "توضیحات (DESCRIPTION)"
این دستور اطلاعات مربوط به یک بسته را نمایش می‌دهد. این فرمان داده‌ها را از فایل Cargo.toml بسته واکشی کرده
و در قالبی خوانا برای انسان ارائه می‌دهد.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های اطلاعات (Info Options)"
.sp
\fIspec\fR
.RS 4
واکشی اطلاعات درباره بسته مشخص‌شده. \fIspec\fR می‌تواند یک شناسه بسته (package ID) باشد؛ برای ساختار SPEC،
\fBcargo\-pkgid\fR(1) را ببینید.
اگر بسته مشخص‌شده بخشی از فضای کاری (workspace) فعلی باشد، اطلاعات از فایل محلی Cargo.toml نمایش داده خواهد شد.
اگر فایل \fBCargo.lock\fR وجود نداشته باشد، ایجاد خواهد شد. اگر نگارشی مشخص نشده باشد، نگارش مناسب بر اساس
حداقل نگارش پشتیبانی‌شدهٔ راست (MSRV) انتخاب خواهد شد.
.RE
.sp
\fB\-\-index\fR \fIindex\fR
.RS 4
نشانی اینترنتی (URL) نمایه مخزن مورد استفاده.
.RE
.sp
\fB\-\-registry\fR \fIregistry\fR
.RS 4
نام مخزن (registry) مورد استفاده. نام‌های مخزن در \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
عدم چاپ پیام‌های گزارش (log) کارگو.
همچنین می‌تواند از طریق \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\-\-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
توجه داشته باشید که این کار ممکن است منجر به برطرف‌سازی متفاوتی از وابستگی‌ها نسبت به حالت آنلاین شود.
کارگو خود را به کریت‌هایی محدود می‌کند که به صورت محلی دانلود شده‌اند، حتی اگر طبق نسخه محلی نمایه،
نگارش جدیدتری وجود داشته باشد. برای بارگیری وابستگی‌ها پیش از رفتن به حالت آفلاین،
دستور \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 یا \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'بررسی بستهٔ \fBserde\fR از crates.io:
.sp
.RS 4
.nf
 cargo info serde
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 2.\h'+01'بررسی بستهٔ \fBserde\fR با نگارش \fB1.0.0\fR:
.sp
.RS 4
.nf
 cargo info serde@1.0.0
.fi
.RE
.RE
.sp
.RS 4
\h'-04' 3.\h'+01'بررسی بستهٔ \fBserde\fR از یک مخزن محلی:
.sp
.RS 4
.nf
 cargo info serde \-\-registry my\-registry
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-search\fR(1)