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,sonamecheck}]]
16 [--outputtool {json,text}]
17 [--versioneer {anitya,cpan,hackage,npmjs,pypi,rubygems}]
18 [--versioneer-blacklist [{anitya,cpan,hackage,npmjs,pypi,rubygems}]]
19 [--spec-hook-blacklist [{commit-hash-updater,escape-macros,paths-to-rpm-
20 macros,pypi-url-fix,replace-old-version,ruby-helper,typo-fix}]]
21 [--build-log-hook-blacklist [{files}]] [--bugzilla-id BUG_ID]
22 [--non-interactive] [--favor-on-conflict {downstream,upstream,off}]
23 [--not-download-sources] [-w] [--apply-changes]
24 [--disable-inapplicable-patches] [--skip-version-check]
25 [--update-sources] [--skip-upload] [--force-build-log-hooks]
26 [--builds-nowait] [--build-tasks OLD_TASK,NEW_TASK]
27 [--builder-options BUILDER_OPTIONS]
28 [--srpm-builder-options SRPM_BUILDER_OPTIONS]
29 [--changelog-entry CHANGELOG_ENTRY] [--config-file CONFIG_FILE]
30 [-D 'MACRO EXPR'] [--copr-project-permanent]
31 [--copr-project-frontpage] [--copr-chroots COPR_CHROOTS]
32 [--get-old-build-from-koji] [--replace-old-version-with-macro]
33 [SOURCES]
34
40 rebase-helper is a tool which helps package maintainers to rebase their
41 packages to latest upstream versions.
42 It should be executed from a directory containing spec file, sources
44 and patches (usually cloned dist-git repository).
45 The new version is specified by SOURCES argument, which can be either
47 version number or filename of the new source archive. Starting with
48 version 0.10.0, this argument can be omitted and the new version deter‐
49 mined automatically using one of available versioneers.
50
52 SOURCES
53 version number or filename of the new source archive
54 -h, --help
56 show help message and exit
57 --version
59 show rebase-helper version and exit
60 -v, --verbose
62 be more verbose
63 --color {always,never,auto}
65 colorize the output, defaults to auto
66 --background {dark,light,auto}
68 use color scheme for the given background, defaults to auto
69 --results-dir RESULTS_DIR
71 location where the rebase-helper-results directory will be cre‐
72 ated
73 --workspace-dir WORKSPACE_DIR
75 location where the rebase-helper-workspace directory will be
76 created
77 --buildtool {copr,koji,mock,rpmbuild}
79 build tool to use, defaults to mock
80 --srpm-buildtool {mock,rpmbuild}
82 SRPM build tool to use, defaults to rpmbuild
83 --pkgcomparetool [{abipkgdiff,csmock,licensecheck,pkgdiff,rpmdiff,son‐
85 amecheck}]
86 set of tools to use for package comparison, defaults to abip‐
87 kgdiff,licensecheck,pkgdiff,rpmdiff,sonamecheck if available
88 --outputtool {json,text}
90 tool to use for formatting rebase output, defaults to text
91 --versioneer {anitya,cpan,hackage,npmjs,pypi,rubygems}
93 tool to use for determining latest upstream version
94 --versioneer-blacklist [{anitya,cpan,hackage,npmjs,pypi,rubygems}]
96 prevent specified versioneers from being run
97 --spec-hook-blacklist [{commit-hash-updater,escape-macros,paths-to-rpm-
99 macros,pypi-url-fix,replace-old-version,ruby-helper,typo-fix}]
100 prevent specified spec hooks from being run
101 --build-log-hook-blacklist [{files}]
103 prevent specified build log hooks from being run
104 --bugzilla-id BUG_ID
106 do a rebase based on Upstream Release Monitoring bugzilla
107 --non-interactive
109 do not interact with user
110 --favor-on-conflict {downstream,upstream,off}
112 favor downstream or upstream changes when conflicts appear
113 --not-download-sources
115 do not download sources
116 -w, --keep-workspace
118 do not remove workspace directory after finishing
119 --apply-changes
121 apply changes.patch after a successful rebase
122 --disable-inapplicable-patches
124 disable inapplicable patches in rebased SPEC file
125 --skip-version-check
127 force rebase even if current version is newer than requested
128 version
129 --update-sources
131 update “sources” file and upload new sources to lookaside cache
132 --skip-upload
134 skip uploading new sources to lookaside cache
135 --force-build-log-hooks
137 enforce running of build log hooks (even in non-interactive
138 mode)
139 --builds-nowait
141 do not wait for remote builds to finish
142 --build-tasks OLD_TASK,NEW_TASK
144 comma-separated remote build task ids
145 --builder-options BUILDER_OPTIONS
147 enable arbitrary local builder option(s), enclose
148 BUILDER_OPTIONS in quotes to pass more than one
149 --srpm-builder-options SRPM_BUILDER_OPTIONS
151 enable arbitrary local srpm builder option(s), enclose
152 SRPM_BUILDER_OPTIONS in quotes to pass more than one
153 --changelog-entry CHANGELOG_ENTRY
155 text to use as changelog entry, can contain RPM macros, which
156 will be expanded
157 --config-file CONFIG_FILE
159 path to a configuration file, defaults to $XDG_CON‐
160 FIG_HOME/rebase-helper.cfg
161 -D 'MACRO EXPR', --define 'MACRO EXPR'
163 define an rpm macro, can be used multiple times
164 --copr-project-permanent
166 make the created copr project permanent
167 --copr-project-frontpage
169 make the created copr project visible on the frontpage
170 --copr-chroots COPR_CHROOTS
172 comma-separated list of chroots to create copr project with
173 --get-old-build-from-koji
175 do not build old sources, download latest build from Koji
176 instead
177 --replace-old-version-with-macro
179 replace old version string with %{version} instead of new ver‐
180 sion string
181
185 This program returns 0 if successful, or non-zero if there was an
186 error.
187
189 rpmbuild(8), mock(1), rpmdiff(1), pkgdiff(1), abipkgdiff(1), csmock(1)
190
192 Petr Hráček <phracek@redhat.com>, Tomáš Hozza <thozza@redhat.com>,
193 Nikola Forró <nforro@redhat.com>, František Nečas <fifinecas@seznam.cz>
194
196 2014-2020, Red Hat
1970.22 Mar 31, 2020 REBASE-HELPER(1)