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

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

pkgctl build [OPTIONS] [PATH...]

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

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

--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

-I, --install-to-chroot FILE

نصب یک بسته در نسخه کاری chroot

-i, --install-to-host MODE

نصب بسته‌های ساخته‌شده روی سیستم میزبان. مفید زمانی که می‌خواهید بررسی کنید بسته همان‌طور که انتظار می‌رود کار می‌کند.
•هنگامی که MODE برابر all باشد، تمامی بسته‌های ساخته‌شده را نصب می‌کند
•هنگامی که MODE برابر auto باشد، تمامی بسته‌های ساخته‌شده‌ای که در حال حاضر نصب هستند را نصب می‌کند

--pkgver=PKGVER

تنظیم pkgver، بازنشانی pkgrel و به‌روزرسانی چکسام‌ها

--pkgrel=PKGREL

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

--rebuild

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

--update-checksums

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

-e, --edit

ویرایش PKGBUILD پیش از ساخت

-r, --release

کامیت، تگ‌گذاری و انتشار خودکار پس از ساخت
مشخص کردن این گزینه هنگام استفاده از هر یک از گزینه‌های بعدی این بخش الزامی است

-m, --message MSG

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

-u, --db-update

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

-h, --help

نمایش متن راهنما

pkgctl-release(1) pkgctl-db-update(1)

https://gitlab.archlinux.org/archlinux/devtools

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

2026-06-21