'\" t
.\"     Title: pkgctl-build
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-21
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "PKGCTL\-BUILD" "1" "2026-06-21" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
pkgctl-build \- ساخت بسته‌ها در یک محیط chroot تمیز
.SH "خلاصه دستور (SYNOPSIS)"
.sp
pkgctl build [OPTIONS] [PATH.\|.\|.]
.SH "توضیحات (DESCRIPTION)"
.sp
ساخت بسته‌ها در یک محیط chroot تمیز، با ارائه گزینه‌ها و قابلیت‌های گوناگون جهت سفارشی‌سازی فرآیند ساخت بسته.
.sp
به‌طور پیش‌فرض، محیط‌های chroot در مسیر \fI/var/lib/archbuild/\fP قرار دارند.
.SH "گزینه‌های ساخت (BUILD OPTIONS)"
.sp
\fB\-\-arch\fP \fIARCH\fP
.RS 4
مشخص کردن معماری‌های مورد نظر برای ساخت (شناسایی خودکار را غیرفعال می‌کند)
.RE
.sp
\fB\-\-repo\fP \fIREPO\fP
.RS 4
مشخص کردن مخزن هدف برای بسته‌های جدیدی که در هیچ مخزن رسمی قرار ندارند. در هنگام ساخت بسته‌هایی که هنوز در هیچ مخزن رسمی وجود ندارند، به \f(CR\*(Aqextra\*(Aq\fP بازمی‌گردد. در صورتی که بسته از پیش منتشر شده باشد، استفاده از این گزینه مجاز نیست، چرا که سازوکار حفاظتی شناسایی خودکار را دور می‌زند.
.RE
.sp
\fB\-s, \-\-staging\fP
.RS 4
ساخت در برابر مخزن متناظر استیجینگ (staging) از مخزن شناسایی‌شده به‌صورت خودکار
.RE
.sp
\fB\-t, \-\-testing\fP
.RS 4
ساخت در برابر مخزن متناظر آزمایشی (testing) از مخزن شناسایی‌شده به‌صورت خودکار
.RE
.sp
\fB\-o, \-\-offload\fP
.RS 4
ساخت روی یک سرور دوردست و انتقال مصنوعات پس از آن
.RE
.sp
\fB\-\-offload\-host\fP \fIHOST\fP
.RS 4
مشخص کردن ماشین هدف برای آفلود (پیش‌فرض: build.archlinux.org)
.RE
.sp
\fB\-c, \-\-clean\fP
.RS 4
ایجاد مجدد chroot پیش از ساخت
.RE
.sp
\fB\-\-inspect\fP \fIWHEN\fP
.RS 4
اجرای یک شل تعاملی جهت بررسی محیط chroot پس از ساخت. مفید برای آسان‌تر کردن اشکال‌زدایی ساخت بسته.
.br
مقادیر مجاز برای \fIWHEN\fP عبارتند از \f(CR\*(Aqnever\*(Aq\fP، \f(CR\*(Aqalways\*(Aq\fP یا \f(CR\*(Aqfailure\*(Aq\fP
.RE
.sp
\fB\-w, \-\-worker\fP \fISLOT\fP
.RS 4
نام اسلات ورکر (worker)، مفید برای ساخت‌های همزمان. به‌طور پیش‌فرض اسلات به‌صورت خودکار به شماره pts ترمینال tty فعلی اختصاص داده می‌شود. در صورتی که فراخواننده یک tty نباشد، یک اسلات تصادفی بین ۱ تا تعداد واحدهای پردازشی موجود انتخاب می‌شود.
.RE
.sp
\fB\-\-nocheck\fP
.RS 4
عدم اجرای تابع check() در PKGBUILD
.RE
.SH "گزینه‌های نصب (INSTALL OPTIONS)"
.sp
\fB\-I, \-\-install\-to\-chroot\fP \fIFILE\fP
.RS 4
نصب یک بسته در نسخه کاری chroot
.RE
.sp
\fB\-i, \-\-install\-to\-host\fP \fIMODE\fP
.RS 4
نصب بسته‌های ساخته‌شده روی سیستم میزبان. مفید زمانی که می‌خواهید بررسی کنید بسته همان‌طور که انتظار می‌رود کار می‌کند.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
هنگامی که \fIMODE\fP برابر \fIall\fP باشد، تمامی بسته‌های ساخته‌شده را نصب می‌کند
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
هنگامی که \fIMODE\fP برابر \fIauto\fP باشد، تمامی بسته‌های ساخته‌شده‌ای که در حال حاضر نصب هستند را نصب می‌کند
.RE
.RE
.SH "گزینه‌های PKGBUILD (PKGBUILD OPTIONS)"
.sp
\fB\-\-pkgver\fP=\fIPKGVER\fP
.RS 4
تنظیم pkgver، بازنشانی pkgrel و به‌روزرسانی چکسام‌ها
.RE
.sp
\fB\-\-pkgrel\fP=\fIPKGREL\fP
.RS 4
تنظیم pkgrel به یک مقدار مشخص
.RE
.sp
\fB\-\-rebuild\fP
.RS 4
افزایش مقدار متغیر فعلی pkgrel
.RE
.sp
\fB\-\-update\-checksums\fP
.RS 4
محاسبه و به‌روزرسانی اجباری چکسام‌ها با غیرفعال کردن شناسایی خودکار.
.br
فقط باید در شرایط خاص استفاده شود، مانند زمانی که فایل‌های پچ جدیدی به آرایه source اضافه می‌شوند. در طول عملیات بسته‌بندی معمول، چکسام‌ها هنگام ارتقای بسته با استفاده از \f(CR\-\-pkgver\fP به‌طور خودکار به‌روزرسانی می‌شوند یا باید در طول ساخت مجدد تغییرناپذیر باقی بمانند.
.RE
.sp
\fB\-e, \-\-edit\fP
.RS 4
ویرایش PKGBUILD پیش از ساخت
.RE
.SH "گزینه‌های انتشار (RELEASE OPTIONS)"
.sp
\fB\-r, \-\-release\fP
.RS 4
کامیت، تگ‌گذاری و انتشار خودکار پس از ساخت
.br
مشخص کردن این گزینه هنگام استفاده از هر یک از گزینه‌های بعدی این بخش الزامی است
.RE
.sp
\fB\-m, \-\-message\fP \fIMSG\fP
.RS 4
استفاده از <msg> مشخص‌شده به عنوان پیام کامیت
.RE
.sp
\fB\-u, \-\-db\-update\fP
.RS 4
به‌روزرسانی خودکار پایگاه‌داده pacman به عنوان آخرین اقدام
.RE
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-h, \-\-help\fP
.RS 4
نمایش متن راهنما
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
pkgctl\-release(1)
pkgctl\-db\-update(1)
.SH "صفحه خانگی (HOMEPAGE)"
.sp
\fI\c
.URL "https://gitlab.archlinux.org/archlinux/devtools" "" "\fP"
.sp
لطفاً گزارش باگ‌ها و درخواست امکانات جدید را در سامانه پیگیری اشکالات (issue tracker) ارسال کنید. لطفاً نهایت تلاش خود را برای ارائه یک نمونه آزمایشی قابل بازتولید جهت رفع باگ‌ها انجام دهید.