rebuildctl1
Manage and query a rebuilderd(1)
Usage
rebuildctl [-vH
https://rebuilder.example.com]
[-c
/etc/rebuilderd.conf]
<command>
Overview
The rebuildctl binary is used to query and manage rebuilderd instances. Functionality is split into multiple subcommands.
Status
Lists the available workers and what they are currently working on.
--color
Force colors even if stdout is not a tty. This is useful with watch -c.
rebuildctl status
PKGS
LS
List the packages known to rebuilderd along with their status.
--color
Force colors even if stdout is not a tty. This is useful with watch -c.
--json
Print the response as json instead of pretty-printing it.
--distro <distro>
Select packages from a specific distro, like archlinux or debian.
--suite <suite>
Select packages from a specific suite/repository, like main, contrib, non-free or core, extra and community.
--architecture <architecture>
Select packages with a specific architecture.
--name <name>
Select packages with a specific name.
--status <status>
Select packages with a specific status. Possible values are GOOD, BAD, and UNKWN.
rebuildctl pkgs ls --status GOOD
Sync
Sync a set of packages into rebuilderd and automatically queue them for verification. For an in-depth description of how the filters work you can look into rebuilderd-sync.conf(5).
--architecture <architecture>
The architecture that should be imported (if needed). This option can be specified multiple times. The specific values are distro specific, like x86_64 for Arch Linux or amd64 for debian.
--release <release>
The releases that should be imported (if needed). This option can be specified multiple times.
--print-json
Do a dry-run and only show what we would sync instead of actually sending it to rebuilderd.
--maintainer <maintainers>
Only pick packages by specific maintainers.
--pkg <pattern>
Only pick specific packages or packages matching a pattern.
--exclude <pattern>
Always ignore packages that match this pattern, even if it also matches one of the other filters.
rebuildctl pkgs sync archlinux community --architecture x86_64 \
'https://ftp.halifax.rwth-aachen.de/archlinux/$repo/os/$arch' \
--maintainer kpcyrd --print-json
Sync-profiles
This command is very similar to pkgs sync, but reads all the options from a configuration file instead. These profiles are also used by the systemd timer.
--color
Force colors even if stdout is not a tty. This is useful with watch -c.
--print-json
Do a dry-run and only show what we would sync instead of actually sending it to rebuilderd.
--sync-config /etc/rebuilderd-sync.conf
The configuration file to read profiles from.
rebuildctl pkgs sync-profile archlinux-core
Queue
LS
List the current queue.
--color
Force colors even if stdout is not a tty. This is useful with watch -c.
--head
Only show the first 25 items in the queue.
--json
Print the response as json instead of pretty-printing it.
rebuildctl queue ls --head
Push
Push a specific package to the work queue again. If the version is not provided we automaticlly select the current one.
--architecture
You can optionally filter by architecture. Otherwise all matches are added to the queue.
rebuildctl queue push archlinux community rebuilderd
Drop
Drop a specific package from the work queue. Optionally select a specific version to drop.
rebuildctl queue drop archlinux community rebuilderd
Releases
2 releases since Debian 13 (Trixie); the text changed 1 time.
--color until Debian 13 (Trixie);
--config until Debian 13 (Trixie);
--endpoint until Debian 13 (Trixie);
--help until Debian 13 (Trixie);
--verbose... until Debian 13 (Trixie);
--version until Debian 13 (Trixie);
-C until Debian 13 (Trixie);
-H until Debian 13 (Trixie);
-V until Debian 13 (Trixie);
-c until Debian 13 (Trixie);
-h until Debian 13 (Trixie);
-v until Debian 13 (Trixie).