.\" Generated by scdoc 1.11.2
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "rebuildctl" "1" "2023-10-18"
.P
.SH NAME
.P
rebuildctl - Manage and query a \fBrebuilderd\fR(1)
.P
.SH SYNOPSIS
.P
\fBrebuildctl\fR [-vH https://rebuilder.\&example.\&com] [-c /etc/rebuilderd.\&conf] <command>
.P
.SH DESCRIPTION
.P
The rebuildctl binary is used to query and manage \fBrebuilderd\fR instances.\&
Functionality is split into multiple subcommands.\&
.P
.SH STATUS
.P
Lists the available workers and what they are currently working on.\&
.P
\fB--color\fR
.RS 4
Force colors even if stdout is not a tty.\& This is useful with \fBwatch -c\fR.\&
.P
.RE
\fBrebuildctl status\fR
.P
.SH PKGS
.P
.SS LS
.P
List the packages known to rebuilderd along with their status.\&
.P
\fB--color\fR
.RS 4
Force colors even if stdout is not a tty.\& This is useful with \fBwatch -c\fR.\&
.P
.RE
\fB--json\fR
.RS 4
Print the response as json instead of pretty-printing it.\&
.P
.RE
\fB--distro <distro>\fR
.RS 4
Select packages from a specific distro, like \fBarchlinux\fR or \fBdebian\fR.\&
.P
.RE
\fB--suite <suite>\fR
.RS 4
Select packages from a specific suite/repository, like \fBmain\fR, \fBcontrib\fR,
\fBnon-free\fR or \fBcore\fR, \fBextra\fR and \fBcommunity\fR.\&
.P
.RE
\fB--architecture <architecture>\fR
.RS 4
Select packages with a specific architecture.\&
.P
.RE
\fB--name <name>\fR
.RS 4
Select packages with a specific name.\&
.P
.RE
\fB--status <status>\fR
.RS 4
Select packages with a specific status.\& Possible values are \fBGOOD\fR, \fBBAD\fR,
and \fBUNKWN\fR.\&
.P
.RE
\fBrebuildctl pkgs ls\fR --status GOOD
.P
.SS SYNC
.P
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 \fBrebuilderd-sync.\&conf\fR(5).\&
.P
\fB--architecture <architecture>\fR
.RS 4
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.\&
.P
.RE
\fB--release <release>\fR
.RS 4
The releases that should be imported (if needed).\& This option can be
specified multiple times.\&
.P
.RE
\fB--print-json\fR
.RS 4
Do a dry-run and only show what we would sync instead of actually sending
it to rebuilderd.\&
.P
.RE
\fB--maintainer <maintainers>\fR
.RS 4
Only pick packages by specific maintainers.\&
.P
.RE
\fB--pkg <pattern>\fR
.RS 4
Only pick specific packages or packages matching a pattern.\&
.P
.RE
\fB--exclude <pattern>\fR
.RS 4
Always ignore packages that match this pattern, even if it also matches one
of the other filters.\&
.P
.RE
\fBrebuildctl pkgs sync\fR archlinux community --architecture x86_64 \\
.br
	'\&https://ftp.\&halifax.\&rwth-aachen.\&de/archlinux/$repo/os/$arch'\& \\
.br
	--maintainer kpcyrd --print-json
.P
.SS SYNC-PROFILES
.P
This command is very similar to \fBpkgs sync\fR, but reads all the options from a
configuration file instead.\& These profiles are also used by the systemd timer.\&
.P
\fB--color\fR
.RS 4
Force colors even if stdout is not a tty.\& This is useful with \fBwatch -c\fR.\&
.P
.RE
\fB--print-json\fR
.RS 4
Do a dry-run and only show what we would sync instead of actually sending
it to rebuilderd.\&
.P
.RE
\fB--sync-config /etc/rebuilderd-sync.\&conf\fR
.RS 4
The configuration file to read profiles from.\&
.P
.RE
\fBrebuildctl pkgs sync-profile\fR archlinux-core
.P
.SH QUEUE
.P
.SS LS
.P
List the current queue.\&
.P
\fB--color\fR
.RS 4
Force colors even if stdout is not a tty.\& This is useful with \fBwatch -c\fR.\&
.P
.RE
\fB--head\fR
.RS 4
Only show the first 25 items in the queue.\&
.P
.RE
\fB--json\fR
.RS 4
Print the response as json instead of pretty-printing it.\&
.P
.RE
\fBrebuildctl queue ls\fR --head
.P
.SS PUSH
.P
Push a specific package to the work queue again.\& If the version is not provided
we automaticlly select the current one.\&
.P
\fB--architecture\fR
.RS 4
You can optionally filter by architecture.\& Otherwise all matches are added
to the queue.\&
.P
.RE
\fBrebuildctl queue push\fR archlinux community rebuilderd
.P
.SS DROP
.P
Drop a specific package from the work queue.\& Optionally select a specific version to drop.\&
.P
\fBrebuildctl queue drop\fR archlinux community rebuilderd
.P
.SH SEE ALSO
.P
\fBrebuilderd\fR(1), \fBrebuilderd.\&conf\fR(5), \fBrebuilderd-sync.\&conf\fR(5).\&
.P
.SH AUTHORS
.P
rebuilderd was originally written by kpcyrd and is hosted at https://github.\&com/kpcyrd/rebuilderd