1REBASE-HELPER(1) rebase-helper REBASE-HELPER(1)
2
3
4
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
37
38
39
40
42 rebase-helper is a tool which helps package maintainers to rebase their
43 packages to latest upstream versions.
44
45 It should be executed from a directory containing spec file, sources
46 and patches (usually cloned dist-git repository).
47
48 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
57 -h, --help
58 show help message and exit
59
60 --version
61 show rebase-helper version and exit
62
63 -v, --verbose
64 be more verbose
65
66 --color {always,never,auto}
67 colorize the output, defaults to auto
68
69 --background {dark,light,auto}
70 use color scheme for the given background, defaults to auto
71
72 --results-dir RESULTS_DIR
73 location where the rebase-helper-results directory will be cre‐
74 ated
75
76 --workspace-dir WORKSPACE_DIR
77 location where the rebase-helper-workspace directory will be
78 created
79
80 --buildtool {copr,koji,mock,rpmbuild}
81 build tool to use, defaults to mock
82
83 --srpm-buildtool {mock,rpmbuild}
84 SRPM build tool to use, defaults to rpmbuild
85
86 --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
92 --outputtool {json,text}
93 tool to use for formatting rebase output, defaults to text
94
95 --versioneer {anitya,cpan,hackage,npmjs,pypi,rubygems}
96 tool to use for determining latest upstream version
97
98 --versioneer-blacklist [{anitya,cpan,hackage,npmjs,pypi,rubygems}]
99 prevent specified versioneers from being run
100
101 --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
105 --build-log-hook-blacklist [{files}]
106 prevent specified build log hooks from being run
107
108 --bugzilla-id BUG_ID
109 do a rebase based on Upstream Release Monitoring bugzilla
110
111 --non-interactive
112 do not interact with user
113
114 --favor-on-conflict {downstream,upstream,off}
115 favor downstream or upstream changes when conflicts appear
116
117 --not-download-sources
118 do not download sources
119
120 -w, --keep-workspace
121 do not remove workspace directory after finishing
122
123 --apply-changes
124 apply changes.patch after a successful rebase
125
126 --disable-inapplicable-patches
127 disable inapplicable patches in rebased SPEC file
128
129 --keep-comments
130 do not remove associated comments when removing patches from
131 spec file
132
133 --skip-version-check
134 force rebase even if current version is newer than requested
135 version
136
137 --update-sources
138 update “sources” file and upload new sources to lookaside cache
139
140 --skip-upload
141 skip uploading new sources to lookaside cache
142
143 --force-build-log-hooks
144 enforce running of build log hooks (even in non-interactive
145 mode)
146
147 --builds-nowait
148 do not wait for remote builds to finish
149
150 --build-tasks OLD_TASK,NEW_TASK
151 comma-separated remote build task ids
152
153 --builder-options BUILDER_OPTIONS
154 enable arbitrary local builder option(s), enclose BUILDER_OP‐
155 TIONS in quotes to pass more than one
156
157 --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
161 --lookaside-cache-preset {fedpkg,centpkg,rhpkg,rhpkg-sha512}
162 use specified lookaside cache configuration preset, defaults to
163 fedpkg
164
165 --changelog-entry CHANGELOG_ENTRY
166 text to use as changelog entry, can contain RPM macros, which
167 will be expanded
168
169 --no-changelog-entry
170 do not add a changelog entry at all
171
172 --config-file CONFIG_FILE
173 path to a configuration file, defaults to $XDG_CONFIG_HOME/re‐
174 base-helper.cfg
175
176 -D 'MACRO EXPR', --define 'MACRO EXPR'
177 define an rpm macro, can be used multiple times
178
179 --copr-project-permanent
180 make the created copr project permanent
181
182 --copr-project-frontpage
183 make the created copr project visible on the frontpage
184
185 --copr-chroots COPR_CHROOTS
186 comma-separated list of chroots to create copr project with
187
188 --get-old-build-from-koji
189 do not build old sources, download latest build from Koji in‐
190 stead
191
192 --replace-old-version-with-macro
193 replace old version string with %{version} instead of new ver‐
194 sion string
195
196
197
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-2021, Red Hat
211
212
213
214
2150.26 Sep 27, 2021 REBASE-HELPER(1)