rebase-helper man page

rebase-helper — helps you to rebase package to the latest upstream version


rebase-helper [-h] [-v] [-p] [-b] [--buildtool {copr,rpmbuild,koji,mock}]
[--pkgcomparetool {rpmdiff,abipkgdiff,pkgdiff,csmock}]
[--outputtool {text,json}] [-w] [--not-download-sources] [-c]
[--non-interactive] [--comparepkgs-only COMPAREPKGS_DIR] [--builds-nowait]
[--build-tasks OLD_TASK,NEW_TASK] [--results-dir RESULTS_DIR]
[--build-retries BUILD_RETRIES] [--builder-options=BUILDER_OPTIONS] SOURCES


rebase-helper is a tool which helps package maintainers to rebase their packages to latest upstream versions.

It should be executed from a directory containing spec file, sources and patches (usually cloned dist-git repository).

The new version is specified by SOURCES argument, which can be either version number or filename of the new source archive.



new upstream sources

-h, --help

show help message and exit

-v, --verbose

be more verbose (recommended)

-p, --patch-only

only apply patches

-b, --build-only

only build SRPM and RPMs

--buildtool {copr,rpmbuild,koji,mock}

build tool to use, defaults to mock

--pkgcomparetool {rpmdiff,abipkgdiff,pkgdiff,csmock}

set of tools to use for package comparison, defaults to rpmdiff,abipkgdiff,pkgdiff

--outputtool {text,json}

tool to use for formatting rebase output, defaults to text

-w, --keep-workspace

do not remove workspace directory after finishing


do not download sources

-c, --continue

continue previously interrupted rebase


do not interact with user

--comparepkgs-only COMPAREPKGS_DIR

compare already built packages, COMPAREPKGS_DIR must be a directory with the following structure: <dir_name>/{old,new}/RPM


do not wait for koji or copr builds to finish

--build-tasks OLD_TASK,NEW_TASK

comma-separated koji or copr task ids

--results-dir RESULTS_DIR

directory where rebase-helper output will be stored

--build-retries BUILD_RETRIES

number of retries of a failed build, defaults to 2


enable arbitrary local builder option(s), enclose BUILDER_OPTIONS in quotes and note that = before it is mandatory

Exit Status

This program returns 0 if successful, or non-zero if there was an error.

See Also

rpmbuild(8), mock(1), rpmdiff(1), pkgdiff(1), abipkgdiff(1), csmock(1)


Petr Hracek, Tomas Hozza


Feb 11, 2017 0.9 rebase-helper