1REBASE-HELPER(1) rebase-helper REBASE-HELPER(1)
2
6 rebase-helper - helps you rebase your package to the latest version
7
9 rebase-helper [-h] [--version] [-v] [--color {always,never,auto}]
10 [--background {dark,light,auto}] [--results-dir RESULTS_DIR]
11 [--workspace-dir WORKSPACE_DIR]
12 [--buildtool {copr,koji,mock,rpmbuild}]
13 [--srpm-buildtool {mock,rpmbuild}]
14 [--pkgcomparetool
15 [{abipkgdiff,csmock,licensecheck,pkgdiff,rpmdiff,rpminspect-
16 rpm,rpminspect-srpm,sonamecheck}]]
17 [--outputtool {json,text}]
18 [--versioneer {anitya,cpan,hackage,npmjs,pypi,rubygems}]
19 [--versioneer-blacklist [{anitya,cpan,hackage,npmjs,pypi,rubygems}]]
20 [--spec-hook-blacklist [{commit-hash-updater,escape-macros,paths-to-rpm-
21 macros,pypi-url-fix,replace-old-version,ruby-helper,typo-fix}]]
22 [--build-log-hook-blacklist [{files}]] [--bugzilla-id BUG_ID]
23 [--non-interactive] [--favor-on-conflict {downstream,upstream,off}]
24 [--not-download-sources] [-w] [--apply-changes]
25 [--disable-inapplicable-patches] [--keep-comments]
26 [--skip-version-check] [--update-sources] [--skip-upload]
27 [--force-build-log-hooks] [--builds-nowait]
28 [--build-tasks OLD_TASK,NEW_TASK] [--builder-options BUILDER_OPTIONS]
29 [--srpm-builder-options SRPM_BUILDER_OPTIONS]
30 [--lookaside-cache-preset {fedpkg,centpkg,rhpkg,rhpkg-sha512}]
31 [--changelog-entry CHANGELOG_ENTRY] [--no-changelog-entry]
32 [--config-file CONFIG_FILE] [-D 'MACRO EXPR']
33 [--copr-project-permanent] [--copr-project-frontpage]
34 [--copr-chroots COPR_CHROOTS] [--get-old-build-from-koji]
35 [--replace-old-version-with-macro] [SOURCES]
36
42 rebase-helper is a tool which helps package maintainers to rebase their
43 packages to latest upstream versions.
44 It should be executed from a directory containing spec file, sources
46 and patches (usually cloned dist-git repository).
47 The new version is specified by SOURCES argument, which can be either
49 version number or filename of the new source archive. Starting with
50 version 0.10.0, this argument can be omitted and the new version deter‐
51 mined automatically using one of available versioneers.
52
54 SOURCES
55 version number or filename of the new source archive
56 -h, --help
58 show help message and exit
59 --version
61 show rebase-helper version and exit
62 -v, --verbose
64 be more verbose
65 --color {always,never,auto}
67 colorize the output, defaults to auto
68 --background {dark,light,auto}
70 use color scheme for the given background, defaults to auto
71 --results-dir RESULTS_DIR
73 location where the rebase-helper-results directory will be cre‐
74 ated
75 --workspace-dir WORKSPACE_DIR
77 location where the rebase-helper-workspace directory will be
78 created
79 --buildtool {copr,koji,mock,rpmbuild}
81 build tool to use, defaults to mock
82 --srpm-buildtool {mock,rpmbuild}
84 SRPM build tool to use, defaults to rpmbuild
85 --pkgcomparetool [{abipkgdiff,csmock,licensecheck,pkgdiff,rpmdiff,rp‐
87 minspect-rpm,rpminspect-srpm,sonamecheck}]
88 set of tools to use for package comparison, defaults to abip‐
89 kgdiff,licensecheck,pkgdiff,rpmdiff,rpminspect-rpm,rpmin‐
90 spect-srpm,sonamecheck if available
91 --outputtool {json,text}
93 tool to use for formatting rebase output, defaults to text
94 --versioneer {anitya,cpan,hackage,npmjs,pypi,rubygems}
96 tool to use for determining latest upstream version
97 --versioneer-blacklist [{anitya,cpan,hackage,npmjs,pypi,rubygems}]
99 prevent specified versioneers from being run
100 --spec-hook-blacklist [{commit-hash-updater,escape-macros,paths-to-rpm-
102 macros,pypi-url-fix,replace-old-version,ruby-helper,typo-fix}]
103 prevent specified spec hooks from being run
104 --build-log-hook-blacklist [{files}]
106 prevent specified build log hooks from being run
107 --bugzilla-id BUG_ID
109 do a rebase based on Upstream Release Monitoring bugzilla
110 --non-interactive
112 do not interact with user
113 --favor-on-conflict {downstream,upstream,off}
115 favor downstream or upstream changes when conflicts appear
116 --not-download-sources
118 do not download sources
119 -w, --keep-workspace
121 do not remove workspace directory after finishing
122 --apply-changes
124 apply changes.patch after a successful rebase
125 --disable-inapplicable-patches
127 disable inapplicable patches in rebased SPEC file
128 --keep-comments
130 do not remove associated comments when removing patches from
131 spec file
132 --skip-version-check
134 force rebase even if current version is newer than requested
135 version
136 --update-sources
138 update “sources” file and upload new sources to lookaside cache
139 --skip-upload
141 skip uploading new sources to lookaside cache
142 --force-build-log-hooks
144 enforce running of build log hooks (even in non-interactive
145 mode)
146 --builds-nowait
148 do not wait for remote builds to finish
149 --build-tasks OLD_TASK,NEW_TASK
151 comma-separated remote build task ids
152 --builder-options BUILDER_OPTIONS
154 enable arbitrary local builder option(s), enclose BUILDER_OP‐
155 TIONS in quotes to pass more than one
156 --srpm-builder-options SRPM_BUILDER_OPTIONS
158 enable arbitrary local srpm builder option(s), enclose
159 SRPM_BUILDER_OPTIONS in quotes to pass more than one
160 --lookaside-cache-preset {fedpkg,centpkg,rhpkg,rhpkg-sha512}
162 use specified lookaside cache configuration preset, defaults to
163 fedpkg
164 --changelog-entry CHANGELOG_ENTRY
166 text to use as changelog entry, can contain RPM macros, which
167 will be expanded
168 --no-changelog-entry
170 do not add a changelog entry at all
171 --config-file CONFIG_FILE
173 path to a configuration file, defaults to $XDG_CONFIG_HOME/re‐
174 base-helper.cfg
175 -D 'MACRO EXPR', --define 'MACRO EXPR'
177 define an rpm macro, can be used multiple times
178 --copr-project-permanent
180 make the created copr project permanent
181 --copr-project-frontpage
183 make the created copr project visible on the frontpage
184 --copr-chroots COPR_CHROOTS
186 comma-separated list of chroots to create copr project with
187 --get-old-build-from-koji
189 do not build old sources, download latest build from Koji in‐
190 stead
191 --replace-old-version-with-macro
193 replace old version string with %{version} instead of new ver‐
194 sion string
195
199 This program returns 0 if successful, or non-zero if there was an er‐
200 ror.
201
203 rpmbuild(8), mock(1), rpmdiff(1), pkgdiff(1), abipkgdiff(1), csmock(1)
204
206 Petr Hráček <phracek@redhat.com>, Tomáš Hozza <thozza@redhat.com>,
207 Nikola Forró <nforro@redhat.com>, František Nečas <fifinecas@seznam.cz>
208
210 2014-2022, Red Hat
2110.27 Jul 23, 2022 REBASE-HELPER(1)