PKGCTL-BUILD(1)                                                PKGCTL-BUILD(1)

نام (NAME)
       pkgctl-build - ساخت بسته‌ها در یک محیط chroot تمیز

خلاصه دستور (SYNOPSIS)
       pkgctl build [OPTIONS] [PATH...]

توضیحات (DESCRIPTION)
       ساخت بسته‌ها در یک محیط chroot تمیز، با ارائه گزینه‌ها و قابلیت‌های
       گوناگون جهت سفارشی‌سازی فرآیند ساخت بسته.

       به‌طور پیش‌فرض، محیط‌های chroot در مسیر /var/lib/archbuild/ قرار دارند.

گزینه‌های ساخت (BUILD OPTIONS)
       --arch ARCH
           مشخص کردن معماری‌های مورد نظر برای ساخت (شناسایی خودکار را غیرفعال
           می‌کند)

       --repo REPO
           مشخص کردن مخزن هدف برای بسته‌های جدیدی که در هیچ مخزن رسمی قرار
           ندارند. در هنگام ساخت بسته‌هایی که هنوز در هیچ مخزن رسمی وجود
           ندارند، به 'extra' بازمی‌گردد. در صورتی که بسته از پیش منتشر شده
           باشد، استفاده از این گزینه مجاز نیست، چرا که سازوکار حفاظتی شناسایی
           خودکار را دور می‌زند.

       -s, --staging
           ساخت در برابر مخزن متناظر استیجینگ (staging) از مخزن شناسایی‌شده
           به‌صورت خودکار

       -t, --testing
           ساخت در برابر مخزن متناظر آزمایشی (testing) از مخزن شناسایی‌شده
           به‌صورت خودکار

       -o, --offload
           ساخت روی یک سرور دوردست و انتقال مصنوعات پس از آن

       --offload-host HOST
           مشخص کردن ماشین هدف برای آفلود (پیش‌فرض: build.archlinux.org)

       -c, --clean
           ایجاد مجدد chroot پیش از ساخت

       --inspect WHEN
           اجرای یک شل تعاملی جهت بررسی محیط chroot پس از ساخت. مفید برای
           آسان‌تر کردن اشکال‌زدایی ساخت بسته.
           مقادیر مجاز برای WHEN عبارتند از 'never'، 'always' یا 'failure'

       -w, --worker SLOT
           نام اسلات ورکر (worker)، مفید برای ساخت‌های همزمان. به‌طور پیش‌فرض
           اسلات به‌صورت خودکار به شماره pts ترمینال tty فعلی اختصاص داده
           می‌شود. در صورتی که فراخواننده یک tty نباشد، یک اسلات تصادفی بین ۱
           تا تعداد واحدهای پردازشی موجود انتخاب می‌شود.

       --nocheck
           عدم اجرای تابع check() در PKGBUILD

گزینه‌های نصب (INSTALL OPTIONS)
       -I, --install-to-chroot FILE
           نصب یک بسته در نسخه کاری chroot

       -i, --install-to-host MODE
           نصب بسته‌های ساخته‌شده روی سیستم میزبان. مفید زمانی که می‌خواهید بررسی
           کنید بسته همان‌طور که انتظار می‌رود کار می‌کند.

           •   هنگامی که MODE برابر all باشد، تمامی بسته‌های ساخته‌شده را نصب
               می‌کند

           •   هنگامی که MODE برابر auto باشد، تمامی بسته‌های ساخته‌شده‌ای که در
               حال حاضر نصب هستند را نصب می‌کند

گزینه‌های PKGBUILD (PKGBUILD OPTIONS)
       --pkgver=PKGVER
           تنظیم pkgver، بازنشانی pkgrel و به‌روزرسانی چکسام‌ها

       --pkgrel=PKGREL
           تنظیم pkgrel به یک مقدار مشخص

       --rebuild
           افزایش مقدار متغیر فعلی pkgrel

       --update-checksums
           محاسبه و به‌روزرسانی اجباری چکسام‌ها با غیرفعال کردن شناسایی خودکار.
           فقط باید در شرایط خاص استفاده شود، مانند زمانی که فایل‌های پچ جدیدی
           به آرایه source اضافه می‌شوند. در طول عملیات بسته‌بندی معمول، چکسام‌ها
           هنگام ارتقای بسته با استفاده از --pkgver به‌طور خودکار به‌روزرسانی
           می‌شوند یا باید در طول ساخت مجدد تغییرناپذیر باقی بمانند.

       -e, --edit
           ویرایش PKGBUILD پیش از ساخت

گزینه‌های انتشار (RELEASE OPTIONS)
       -r, --release
           کامیت، تگ‌گذاری و انتشار خودکار پس از ساخت
           مشخص کردن این گزینه هنگام استفاده از هر یک از گزینه‌های بعدی این بخش
           الزامی است

       -m, --message MSG
           استفاده از <msg> مشخص‌شده به عنوان پیام کامیت

       -u, --db-update
           به‌روزرسانی خودکار پایگاه‌داده pacman به عنوان آخرین اقدام

گزینه‌ها (OPTIONS)
       -h, --help
           نمایش متن راهنما

همچنین ببینید (SEE ALSO)
       pkgctl-release(1) pkgctl-db-update(1)

صفحه خانگی (HOMEPAGE)
        <https://gitlab.archlinux.org/archlinux/devtools>

       لطفاً گزارش باگ‌ها و درخواست امکانات جدید را در سامانه پیگیری اشکالات
       (issue tracker) ارسال کنید. لطفاً نهایت تلاش خود را برای ارائه یک نمونه
       آزمایشی قابل بازتولید جهت رفع باگ‌ها انجام دهید.

                                  2026-06-21                   PKGCTL-BUILD(1)