rebuildctl(1) General Commands Manual rebuildctl(1)

rebuildctl - مدیریت و استعلام از سرویس rebuilderd(1)

rebuildctl [-vH https://rebuilder.example.com] [-c /etc/rebuilderd.conf] <command>

برنامه اجرایی rebuildctl برای استعلام و مدیریت نمونه‌های rebuilderd استفاده می‌شود. عملکرد این برنامه به چندین زیردستور تقسیم شده است.

فهرست کردن کارگزارهای موجود و فرآیندی که در حال حاضر روی آن کار می‌کنند.

--color

اجباری کردن نمایش رنگی حتی اگر stdout یک tty نباشد. این گزینه برای استفاده به همراه watch -c مفید است.

rebuildctl status

فهرست کردن بسته‌های شناخته‌شده برای rebuilderd به همراه وضعیت آن‌ها.

--color

اجباری کردن نمایش رنگی حتی اگر stdout یک tty نباشد. این گزینه برای استفاده به همراه watch -c مفید است.

--json

چاپ پاسخ در قالب json به‌جای قالب‌بندی خوانا (pretty-print).

--distro <distro>

انتخاب بسته‌ها از یک توزیع مشخص، مانند archlinux یا debian.

--suite <suite>

انتخاب بسته‌ها از یک مجموعه/مخزن مشخص، مانند main، contrib، non-free یا core، extra و community.

--architecture <architecture>

انتخاب بسته‌ها با یک معماری مشخص.

--name <name>

انتخاب بسته‌ها با یک نام مشخص.

--status <status>

انتخاب بسته‌ها با یک وضعیت مشخص. مقادیر ممکن عبارتند از GOOD، BAD و UNKWN.

rebuildctl pkgs ls --status GOOD

همگام‌سازی مجموعه‌ای از بسته‌ها در rebuilderd و قرار دادن خودکار آن‌ها در صف بررسی و اعتبارسنجی. برای توضیح دقیق‌تر درباره نحوه کارکرد فیلترها می‌توانید به rebuilderd-sync.conf(5) مراجعه کنید.

--architecture <architecture>

معماری مورد نظر برای واردسازی (در صورت نیاز). این گزینه می‌تواند چندین بار مشخص شود. مقادیر ممکن به توزیع بستگی دارند، مانند x86_64 برای آرچ لینوکس یا amd64 برای دبیان.

--release <release>

انتشارهایی که باید وارد شوند (در صورت نیاز). این گزینه می‌تواند چندین بار مشخص شود.

--print-json

اجرای آزمایشی (dry-run) و فقط نمایش مواردی که همگام‌سازی می‌شدند، به‌جای ارسال واقعی آن‌ها به rebuilderd.

--maintainer <maintainers>

تنها انتخاب بسته‌های متعلق به نگه‌دارندگانی مشخص.

--pkg <pattern>

تنها انتخاب بسته‌های مشخص یا بسته‌های منطبق بر یک الگو.

--exclude <pattern>

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

rebuildctl pkgs sync archlinux community --architecture x86_64 \
'https://ftp.halifax.rwth-aachen.de/archlinux/$repo/os/$arch' \
--maintainer kpcyrd --print-json

این دستور بسیار شبیه به pkgs sync است، اما تمام گزینه‌ها را به‌جای آن از یک فایل پیکربندی می‌خواند. این پروفایل‌ها توسط تایمر systemd نیز استفاده می‌شوند.

--color

اجباری کردن نمایش رنگی حتی اگر stdout یک tty نباشد. این گزینه برای استفاده به همراه watch -c مفید است.

--print-json

اجرای آزمایشی (dry-run) و فقط نمایش مواردی که همگام‌سازی می‌شدند، به‌جای ارسال واقعی آن‌ها به rebuilderd.

--sync-config /etc/rebuilderd-sync.conf

فایل پیکربندی برای خواندن پروفایل‌ها از آن.

rebuildctl pkgs sync-profile archlinux-core

فهرست کردن صف کاری فعلی.

--color

اجباری کردن نمایش رنگی حتی اگر stdout یک tty نباشد. این گزینه برای استفاده به همراه watch -c مفید است.

--head

تنها نمایش ۲۵ مورد اول موجود در صف.

--json

چاپ پاسخ در قالب json به‌جای قالب‌بندی خوانا (pretty-print).

rebuildctl queue ls --head

ارسال مجدد یک بسته مشخص به صف کاری. اگر نسخه مشخص نشده باشد، نسخه فعلی به‌طور خودکار انتخاب می‌شود.

--architecture

می‌توانید به صورت اختیاری بر اساس معماری فیلتر کنید. در غیر این صورت تمامی موارد منطبق به صف اضافه می‌شوند.

rebuildctl queue push archlinux community rebuilderd

حذف یک بسته مشخص از صف کاری. به صورت اختیاری یک نسخه مشخص را برای حذف انتخاب کنید.

rebuildctl queue drop archlinux community rebuilderd

rebuilderd(1), rebuilderd.conf(5), rebuilderd-sync.conf(5).

برنامه rebuilderd در ابتدا توسط kpcyrd نوشته شده است و در نشانی https://github.com/kpcyrd/rebuilderd میزبانی می‌شود

2025-08-29