.\" 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 "rebuilderd-sync.conf" "5" "2023-10-18"
.P
.SH NAME
.P
rebuilderd-sync.\&conf - \fBrebuildctl pkgs sync-profile\fR configuration files
.P
.SH SYNOPSIS
.P
/etc/rebuilderd-sync.\&conf
.P
.SH DESCRIPTION
.P
This file allows configuring profiles that can be started with a systemd timer
or a cronjob.\& This way you don'\&t need to provide these options on the
commandline all the time.\&
.P
.SH OPTIONS
.P
\fIdistro=\fR
.RS 4
The name of the distro, currently either \fBarchlinux\fR or \fBdebian\fR.\&
.P
.RE
\fIsuite=\fR
.RS 4
This is for packages that have multiple suites/repositories, like \fBmain\fR,
\fBcontrib\fR, \fBnon-free\fR or \fBcore\fR, \fBextra\fR and \fBcommunity\fR.\&
.P
.RE
\fIarchitectures=\fR
.RS 4
The architectures of the package list we want to import.\&
.P
.RE
\fIreleases=\fR
.RS 4
Import specific releases.\& This option has no effect in rolling-release
distributions like Arch Linux but is important for eg.\& Debian.\& If the same
version is present in multiple releases the package is only imported once.\&
.P
.RE
\fIsource=\fR
.RS 4
This is the url we want to import from.\& For Arch Linux this might look
like:
.P
.nf
.RS 4
source = "https://ftp\&.halifax\&.rwth-aachen\&.de/archlinux/$repo/os/$arch"
.fi
.RE
.P
.RE
\fImaintainers=\fR (optional)
.RS 4
Select packages from specific maintainers.\& The strings are supposed to match
the beginning of the packager field of the packages.\&
.P
.nf
.RS 4
maintainers = ["kpcyrd", "Levente Polyak"]
.fi
.RE
.P
.RE
\fIpkgs=\fR (optional)
.RS 4
Select packages by name:
.P
.nf
.RS 4
pkgs = ["rebuilderd", "python-*"]
.fi
.RE
.P
.RE
\fIexcludes=\fR (optional)
.RS 4
If a package matches one of these patterns it'\&s \fBalways\fR going to be ignored.\&
.P
.nf
.RS 4
excludes = ["tensorflow*"]
.fi
.RE
.P
.RE
Both \fBpkgs=\fR and \fBexcludes=\fR support glob patterns.\& If \fBmaintainers=\fR and
\fBpkgs=\fR are both not set then every package is selected.\&
.P
.SH EXAMPLE
.P
.nf
.RS 4
## rebuild all of core
[profile\&."archlinux-core"]
distro = "archlinux"
suite = "core"
architecture = "x86_64"
source = "https://ftp\&.halifax\&.rwth-aachen\&.de/archlinux/$repo/os/$arch"

## rebuild community packages of specific maintainers, or allow-list packages by name\&.
## If no filter is set, all packages are imported, if both filters are set the package only
## has to match one of them to be included\&.
#[profile\&."archlinux-community"]
#distro = "archlinux"
#suite = "community"
#architecture = "x86_64"
#source = "https://ftp\&.halifax\&.rwth-aachen\&.de/archlinux/$repo/os/$arch"
#maintainers = ["somebody"]
#pkgs = ["some-pkg", "python-*"]
#excludes = ["tensorflow*"]
.fi
.RE
.P
.SH AUTOMATIC SYNC
.P
Enable the systemd timer to automatically sync specific profiles:
.P
.nf
.RS 4
systemctl enable --now rebuilderd-sync@archlinux-core\&.timer
.fi
.RE
.P
The argument behind the @ is refering to the section in the config file.\&
.P
.SH SEE ALSO
.P
\fBrebuilderd\fR(1), \fBrebuildctl\fR(1).\&
.P
.SH AUTHORS
.P
rebuilderd was originally written by kpcyrd and is hosted at https://github.\&com/kpcyrd/rebuilderd