'\" t
.TH "CARGO\-GENERATE\-LOCKFILE" "1"
.nh
.ad l
.ss \n[.ss] 0
.SH "نام (NAME)"
cargo\-generate\-lockfile \- تولید فایل قفل برای یک بسته
.SH "خلاصه دستور (SYNOPSIS)"
\fBcargo generate\-lockfile\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
این دستور فایل قفل \fBCargo.lock\fR را برای بسته یا فضای‌کاری (workspace) فعلی ایجاد می‌کند. اگر فایل قفل از قبل وجود داشته باشد، با آخرین نسخهٔ در دسترس از هر بسته بازسازی خواهد شد.
.sp
همچنین \fBcargo\-update\fR(1) را ببینید که قادر به ایجاد فایل قفل \fBCargo.lock\fR است و گزینه‌های بیشتری برای کنترل رفتار به‌روزرسانی دارد.
.SH "گزینه‌ها (OPTIONS)"
.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\-\-ignore\-rust\-version\fR
.RS 4
نادیده گرفتن مشخصهٔ \fBrust\-version\fR در بسته‌ها.
.RE
.sp
\fB\-\-publish\-time\fR \fIyyyy\-mm\-ddThh:mm:ssZ\fR
.RS 4
آخرین زمان انتشار مجاز برای بسته‌های رجیستری (ناپایدار)
.sp
این یک فیلتر با نهایت تلاش (best\-effort) روی بسته‌های مجاز است، از جمله:
.sp
.RS 4
\h'-04'\(bu\h'+03'بسته‌های متعلق به رجیستری‌های پشتیبانی‌نشده همیشه پذیرفته می‌شوند
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'تنها وضعیت yank فعلی مد نظر قرار می‌گیرد، نه وضعیت آن در زمان \fB\-\-publish\-time\fR
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'دقت زمان انتشار
.RE
.RE
.sp
\fB\-\-locked\fR
.RS 4
اطمینان حاصل می‌کند که دقیقاً همان وابستگی‌ها و نسخه‌های استفاده‌شده در زمان ایجاد اولیهٔ فایل \fBCargo.lock\fR موجود، به کار روند. کارگو در صورت بروز هر یک از سناریوهای زیر با خطا خارج خواهد شد:
.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
جلوگیری از دسترسی کارگو به شبکه به هر دلیلی. بدون این پرچم، اگر کارگو نیاز به دسترسی به شبکه داشته باشد و شبکه در دسترس نباشد، با خطا متوقف خواهد شد. با این پرچم، کارگو تلاش خواهد کرد در صورت امکان بدون شبکه به کار خود ادامه دهد.
.sp
توجه داشته باشید که این کار ممکن است منجر به تفکیک وابستگی متفاوتی نسبت به حالت آنلاین شود. کارگو خود را به 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 "گزینه‌های عمومی (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 generate\-lockfile
.fi
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
\fBcargo\fR(1), \fBcargo\-update\fR(1)