.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "REPRO\-ENV" "1" "2026\-08\-17"
.PP
.SH "نام (NAME)"
.PP
repro\-env \- فایل‌های قفل وابستگی برای محیط‌های ساخت بازتولیدپذیر
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBrepro\-env\fR update
.PP
\fBrepro\-env\fR build \-\- [\fICOMMAND\fR]
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
توصیف وضعیت مورد نظر را در \fBrepro\-env.\&toml\fR نگهداری می‌کند؛ برای نمونه، آخرین نسخه از یک تصویر رسمی کانتینر، با آخرین سطح وصله و آخرین نسخه از برخی بسته‌های اضافی.\&
همچنین حالت حل‌شده را در \fBrepro\-env.\&lock\fR پیگیری می‌کند که نسخه‌ها و چکسام‌های مشخص بسته‌های لازم برای برپاسازی محیط توصیف‌شده را ثبت می‌نماید (در سطح وصله موجود در زمان نگارش).\&
.PP
هدف \fBrepro\-env.\&toml\fR این است که در صورت در دسترس قرار گرفتن وصله‌های جدید، حل مجدد مشخصات کاری بسیار ساده باشد.\& این فایل توسط \fBrepro\-env update\fR خوانده می‌شود.\&
.PP
هدف \fBrepro\-env.\&lock\fR مستندسازی این است که کدام نسخه‌های کامپایلر برای باینری انتشار مرتبط با یک انتشار مشخص به کار رفته‌اند.\& ثبت این اطلاعات برای ساخت‌های بازتولیدپذیر ضروری است و امکان بررسی قانونی و موشکافانه (forensic) محیط ساخت را در آینده فراهم می‌آورد.\& این فایل می‌تواند در مخزن کد منبع کامیت شود یا همراه با باینری کامپایل‌شده، به عنوان یک دست‌سازه (artifact) به انتشار ضمیمه گردد.\& این فایل توسط \fBrepro\-env build\fR خوانده می‌شود.\&
.PP
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
افزایش خروجی ثبت وقایع (می‌تواند چندین بار استفاده شود)
.PP
.RE
\fB\-C\fR \fIpath\fR, \fB\-\-context\fR \fIpath\fR
.RS 4
تغییر دایرکتوری جاری به این مسیر پیش از اجرای زیرفرمان
.PP
.RE
.SH "بروزرسانی (UPDATE)"
.PP
این دستور محیط توصیف‌شده در \fBrepro\-env.\&toml\fR را با آخرین بروزرسانی‌های موجود حل کرده و یک \fBrepro\-env.\&lock\fR می‌نویسد.\& استفاده از این دستور مشابه نحوه استفاده از \fBcargo update\fR است.\&
.PP
\fB\-\-no\-pull\fR
.RS 4
تلاشی برای دریافت (pull) برچسب کانتینر از رجیستری پیش از حل آن انجام ندهد
.PP
.RE
\fB\-k\fR, \fB\-\-keep\fR
.RS 4
کانتینر ساخت حذف نشود، منتظر ctrl\-c بماند
.PP
.RE
.SH "ساخت (BUILD)"
.PP
این دستور یک \fBrepro\-env.\&lock\fR را بارگذاری کرده، محیط توصیف‌شده در آن را درون یک کانتینر برپا می‌کند و دایرکتوری جاری را در مسیر \fB/build\fR داخل کانتینر متصل (mount) می‌سازد.\& سپس \fICOMMAND\fR داده‌شده را درون این کانتینر اجرا می‌کند.\&
.PP
\fB\-f\fR \fIpath\fR, \-\-file \fIpath\fR
.RS 4
فایل قفل وابستگی جهت استفاده
.PP
.RE
\fB\-k\fR, \fB\-\-keep\fR
.RS 4
کانتینر ساخت حذف نشود، منتظر ctrl\-c بماند
.PP
.RE
\fB\-e\fR \fIenv\fR, \fB\fR\-\-env\fB\fR \fIenv\fR
.RS 4
ارسال متغیرهای محیطی به درون کانتینر ساخت (به صورت FOO=bar یا فقط FOO برای جستجوی مقدار آن)
.PP
.RE
.SH "بسته‌ها: آرچ لینوکس (PACKAGES: ARCH LINUX)"
.PP
آرچ لینوکس مجموعه‌ای جامع از کامپایلرهای اخیر را در https://archive.\&archlinux.\&org میزبانی می‌کند.\& می‌توانید یک بخش \fB[packages]\fR با \fBsystem = "archlinux"\fR در \fBrepro\-env.\&toml\fR خود ایجاد کنید تا بسته‌های اضافی را با pacman نصب نمایید.\&
.PP
.nf
.RS 4
# repro\-env\&.toml
[container]
image = "docker\&.io/library/archlinux"

[packages]
system = "archlinux"
dependencies = ["rust\-musl", "lua"]
.fi
.RE
.PP
.SH "بسته‌ها: دبیان (PACKAGES: DEBIAN)"
.PP
دبیان یک انتخاب پرکاربرد است و آرشیوی از تمامی بسته‌های خود را در https://snapshot.\&debian.\&org میزبانی می‌کند.\& می‌توانید یک بخش \fB[packages]\fR با \fBsystem = "debian"\fR در \fBrepro\-env.\&toml\fR خود ایجاد کنید تا بسته‌های اضافی را با apt\-get نصب نمایید.\&
.PP
.nf
.RS 4
# repro\-env\&.toml
[container]
image = "debian:bookworm"

[packages]
system = "debian"
dependencies = ["gcc", "libc6\-dev"]
.fi
.RE
.PP
.SH "نویسندگان (AUTHORS)"
.PP
repro\-env در گیت‌هاب در نشانی https://github.\&com/kpcyrd/repro\-env توسعه داده می‌شود.\&