1centpkg(1) rpm-packager centpkg(1)
2
6 centpkg - RPM Packaging utility
7
9 centpkg [ global_options ] command [ command_options ] [ command_argu‐
10 ments ]
11 centpkg help
12 centpkg command --help
13
15 centpkg is a script to interact with the RPM Packaging system.
16 Global Options
18 --config CONFIG, -C CONFIG
19 Specify a config file to use
20 --dry-run Perform a dry run.
21 --release RELEASE Override the discovered release from current
22 branch, which is used to determine the build
23 target and value of dist macro. Generally,
24 release is the name of a branch created in
25 your package repository. --release is an
26 alias of --dist, hence --release should be
27 used instead.
28 --name NAME Override repository name. Use --namespace
29 option to change namespace. If not
30 specified, name is discovered from Git push
31 URL or Git URL (last part of path with .git
32 extension removed) or from Name macro in
33 spec file, in that order.
34 --namespace NAMESPACE
35 The package repository namespace. If
36 omitted, default to rpms if namespace is
37 enabled.
38 --user USER Override the discovered user name
39 --password PASSWORD Password for Koji login
40 --runas RUNAS Run Koji commands as a different user
41 --path PATH Define the directory to work in (defaults to
42 cwd)
43 --verbose, -v Run with verbose debug output
44 --debug, -d Run with debug output
45 -q Run quietly only displaying errors
46
48 centpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait] [--target
49 TARGET] [--background] [--fail-fast] [--skip-remote-rules-validation]
50 [--skip-nvr-check] [--custom-user-metadata CUSTOM_USER_METADATA]
51 [--skip-tag] [--scratch] [--srpm [SRPM]] [--srpm-mock] [--rhel-target
52 {exception,zstream,latest,none}]
53 Request build
54 centpkg chain-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
56 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
57 validation] [--skip-nvr-check] [--custom-user-metadata CUS‐
58 TOM_USER_METADATA] package [package ...]
59 Build current package in order with other packages
60 centpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t] [-F
62 FILE] [-p] [-s] [files ...]
63 Alias for commit
64 centpkg clean [-h] [--dry-run] [-x]
66 Remove untracked files
67 centpkg clog [-h] [--raw]
69 Make a clog file containing top changelog entry
70 centpkg clone [-h] [--branches] [--branch BRANCH] [--anonymous]
72 [--depth DEPTH] repo [clone_target] ...
73 Clone and checkout a repository
74 centpkg co [-h] [--branches] [--branch BRANCH] [--anonymous] [--depth
76 DEPTH] repo [clone_target] ...
77 Alias for clone
78 centpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t]
80 [-F FILE] [-p] [-s] [files ...]
81 Commit changes
82 centpkg compile [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOT‐
84 DIR] [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
85 Local test rpmbuild compile
86 centpkg container-build [-h] [--target TARGET] [--nowait] [--back‐
88 ground] [--build-release BUILD_RELEASE] [--isolated] [--koji-parent-
89 build KOJI_PARENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--repo-
90 url URL [URL ...]] [--signing-intent SIGNING_INTENT] [--skip-remote-
91 rules-validation] [--skip-build] [--compose-id COMPOSE_ID [COMPOSE_ID
92 ...]] [--replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME]
93 [PKG_MANAGER:NAME:VERSION[:NEW_NAME] ...]]
94 Build a container
95 centpkg container-build-setup [-h] (--get-autorebuild | --set-autore‐
97 build {true,false})
98 set options for container-build
99 centpkg copr-build [-h] [--config CONFIG] [--nowait] project
101 Build package in Copr
102 centpkg current-state [-h]
104 Show the phase and state of current dist-git branch - Internal
105 Only
106 centpkg diff [-h] [--cached] [files ...]
108 Show changes between commits, commit and working tree, etc
109 centpkg flatpak-build [-h] [--target TARGET] [--nowait] [--background]
111 [--build-release BUILD_RELEASE] [--isolated] [--koji-parent-build
112 KOJI_PARENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--repo-url URL
113 [URL ...]] [--signing-intent SIGNING_INTENT] [--skip-remote-rules-vali‐
114 dation] [--skip-build]
115 Build a Flatpak
116 centpkg fork [-h]
118 Create a new fork of the current repository
119 centpkg gimmespec [-h]
121 Print the spec file name
122 centpkg gitbuildhash [-h] build
124 Print the git hash used to build the provided n-v-r
125 centpkg giturl [-h]
127 Print the git url for building
128 centpkg help [-h]
130 Show usage
131 centpkg import [-h] [--skip-diffs] [--offline] srpm
133 Import srpm content into a module
134 centpkg install [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOT‐
136 DIR] [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
137 Local test rpmbuild install
138 centpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
140 Run rpmlint against local spec and build output if present.
141 centpkg list-side-tags [-h] [--mine | --user TAG_OWNER | --base-tag
143 BASE_TAG]
144 List existing side-tags
145 centpkg local [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
147 [--arch ARCH] [--define DEFINE] [--md5] [--with BCOND_WITH] [--without
148 BCOND_WITHOUT] ...
149 Local test rpmbuild binary
150 centpkg mock-config [-h] [--target TARGET] [--arch ARCH]
152 Generate a mock config
153 centpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean] [--no-
155 cleanup-after] [--no-clean-all] [--with BCOND_WITH] [--without
156 BCOND_WITHOUT] [--shell] [--enablerepo ENABLEREPO] [--disablerepo DIS‐
157 ABLEREPO] [--enable-network] [--srpm-mock] [--use-koji-mock-config |
158 --use-local-mock-config] ...
159 Local test build using mock
160 centpkg module-build [-h] [--watch] [--buildrequires name:stream]
162 [--requires name:stream] [--optional key=value] [--file [FILE_PATH]]
163 [--srpm SRPMS] [--scratch] [scm_url] [branch]
164 Build a module using MBS
165 centpkg module-build-cancel [-h] build_id
167 Cancel an MBS module build
168 centpkg module-build-info [-h] build_id
170 Show information of an MBS module build
171 centpkg module-build-local [-h] [--file [FILE_PATH]] [--srpm SRPMS]
173 [--stream [STREAM]] [--skip-tests] [--add-local-build N:S:V] [-s N:S]
174 [--offline] [-r PATH]
175 Build a module locally using the mbs-manager command
176 centpkg module-build-watch [-h] build_id [build_id ...]
178 Watch an MBS build
179 centpkg module-overview [-h] [--unfinished] [--limit LIMIT] [--owner
181 FAS_ID | --mine]
182 Shows an overview of MBS builds
183 centpkg module-scratch-build [-h] [--watch] [--buildrequires
185 name:stream] [--requires name:stream] [--optional key=value] [--file
186 [FILE_PATH]] [--srpm SRPMS] [scm_url] [branch]
187 Build a scratch module using MBS
188 centpkg new [-h]
190 Diff against last tag
191 centpkg new-sources [-h] [--offline] files [files ...]
193 Upload source files
194 centpkg patch [-h] [--rediff] suffix
196 Create and add a gendiff patch file
197 centpkg pre-push-check [-h] [ref]
199 Check whether the eventual "git push" command could proceed
200 centpkg prep [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
202 [--arch ARCH] [--define DEFINE] ...
203 Local test rpmbuild prep
204 centpkg pull [-h] [--rebase] [--no-rebase]
206 Pull changes from the remote repository and update the working
207 copy.
208 centpkg push [-h] [--force] [--no-verify]
210 Push changes to remote repository
211 centpkg remote [-h] {add} ...
213 Operations with tracked repositories ('remotes'). This is an ex‐
214 perimental interface.
215 centpkg remove-side-tag [-h] TAG
217 Remove a side tag (without merging packages)
218 centpkg request-gated-side-tag [-h] [--base-tag BASE_TAG]
220 Create a new dynamic gated side tag
221 centpkg request-side-tag [-h] [--base-tag BASE_TAG] [--suffix SUFFIX]
223 Create a new side tag
224 centpkg retire [-h] reason
226 Retire a package/module
227 centpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
229 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
230 validation] [--skip-nvr-check] [--custom-user-metadata CUS‐
231 TOM_USER_METADATA] [--srpm [SRPM]] [--srpm-mock]
232 Request scratch build
233 centpkg sources [-h] [--outdir OUTDIR] [--force]
235 Download source files
236 Create a source rpm
238 Create a source rpm
239 centpkg switch-branch [-h] [-l] [--fetch] [branch]
241 Work with branches
242 centpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l] [-d]
244 [tag]
245 Management of git tags
246 centpkg unused-patches [-h]
248 Print list of patches not referenced by name in the specfile
249 centpkg upload [-h] [--offline] files [files ...]
251 Upload source files
252 centpkg verify-files [-h] [--builddir BUILDDIR] [--buildrootdir BUILD‐
254 ROOTDIR] [--arch ARCH] [--define DEFINE] ...
255 Locally verify %%files section
256 centpkg verrel [-h]
258 Print the name-version-release.
259
261 centpkg build
262 usage: centpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
263 [--target TARGET] [--background] [--fail-fast]
264 [--skip-remote-rules-validation]
265 [--skip-nvr-check]
266 [--custom-user-metadata CUSTOM_USER_METADATA]
267 [--skip-tag] [--scratch] [--srpm [SRPM]]
268 [--srpm-mock]
269 [--rhel-target {exception,zstream,latest,none}]
270 This command requests a build of the package in the build
272 system. By
273 default it discovers the target to build for based on branch data,
274 and
275 uses the latest commit as the build source.
276 centpkg now sets the rhel metadata with --rhel-target.
278 * exception - This will build for the current in-devel‐
279 opment Y-stream release.
280 It is equivalent to passing latest when not in the
281 Blocker and Exception Phase.
282 * zstream - If pre-GA of a y-stream release, this will
283 build for 0day.
284 If post-GA of a Y-stream release, this will build for
285 the Z-stream of that release.
286 * latest - This will always build for the next Y-stream
287 release
288 * none - This will not build in brew. No rhel metadata
289 is set.
290 options:
292 -h, --help show this help message and exit
293 --arches [ARCHES ...]
294 Build for specific arches
295 --md5 Use md5 checksums (for older rpm hosts)
296 --nowait Don't wait on build
297 --target TARGET Define build target to build into
298 --background Run the build at a low priority
299 --fail-fast Fail the build immediately if any arch fails
300 --skip-remote-rules-validation
301 Don't check if there's a valid gating.yaml
302 file in the repo, where you can define
303 additional policies for Greenwave gating.
304 --skip-nvr-check Submit build to buildsystem without check if
305 NVR was already built. NVR is constructed
306 locally and may be different from NVR
307 constructed during build on builder.
308 --custom-user-metadata CUSTOM_USER_METADATA
309 Provide a JSON string of custom metadata to
310 be deserialized and stored under the build's
311 extra.custom_user_metadata field
312 --skip-tag Do not attempt to tag package
313 --scratch Perform a scratch build
314 --srpm [SRPM] Build from an srpm. If no srpm is provided
315 with this option an srpm will be generated
316 from current module content.
317 --srpm-mock Build from an srpm. Source rpm will be
318 generated in 'mock' instead of 'rpmbuild'.
319 --rhel-target {exception,zstream,latest,none}
320 Set the rhel-target metadata
321 centpkg chain-build
324 usage: centpkg chain-build [-h] [--arches [ARCHES ...]] [--md5]
325 [--nowait] [--target TARGET]
326 [--background] [--fail-fast]
327 [--skip-remote-rules-validation]
328 [--skip-nvr-check]
329 [--custom-user-metadata CUSTOM_USER_META‐
330 DATA]
331 package [package ...]
332 Build current package in order with other packages.
334 example: centpkg chain-build libwidget libgizmo
336 The current package is added to the end of the CHAIN list.
338 Colons (:) can be used in the CHAIN parameter to define groups of
339 packages. Packages in any single group will be built in parallel
340 and all packages in a group must build successfully and populate
341 the repository before the next group will begin building.
342 For example:
344 centpkg chain-build libwidget libaselib : libgizmo :
346 will cause libwidget and libaselib to be built in parallel, followed
348 by libgizmo and then the current directory package. If no groups are
349 defined, packages will be built sequentially.
350 positional arguments:
352 package List the packages and order you want to
353 build in
354 options:
356 -h, --help show this help message and exit
357 --arches [ARCHES ...]
358 Build for specific arches
359 --md5 Use md5 checksums (for older rpm hosts)
360 --nowait Don't wait on build
361 --target TARGET Define build target to build into
362 --background Run the build at a low priority
363 --fail-fast Fail the build immediately if any arch fails
364 --skip-remote-rules-validation
365 Don't check if there's a valid gating.yaml
366 file in the repo, where you can define
367 additional policies for Greenwave gating.
368 --skip-nvr-check Submit build to buildsystem without check if
369 NVR was already built. NVR is constructed
370 locally and may be different from NVR
371 constructed during build on builder.
372 --custom-user-metadata CUSTOM_USER_METADATA
373 Provide a JSON string of custom metadata to
374 be deserialized and stored under the build's
375 extra.custom_user_metadata field
376 centpkg ci
379 usage: centpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw]
380 [-t] [-F FILE] [-p] [-s]
381 [files ...]
382 Alias for commit.
384 positional arguments:
386 files Optional list of specific files to commit
387 options:
389 -h, --help show this help message and exit
390 -m MESSAGE, --message MESSAGE
391 Use the given <msg> as the commit message
392 summary
393 --with-changelog Get the last changelog from SPEC as commit
394 message content. This option must be used
395 with -m together.
396 -c, --clog Generate the commit message from the
397 Changelog section
398 --raw Make the clog raw
399 -t, --tag Create a tag for this commit
400 -F FILE, --file FILE Take the commit message from the given file
401 -p, --push Commit and push as one action
402 -s, --signoff Include a signed-off-by
403 centpkg clean
406 usage: centpkg clean [-h] [--dry-run] [-x]
407 This command can be used to clean up your working directory. By
409 default it will follow .gitignore rules. Patterns listed in
410 .git/info/exclude won'tbe removed either.
411 options:
413 -h, --help show this help message and exit
414 --dry-run, -n Perform a dry-run
415 -x Do not follow .gitignore and .git/info/exclude
416 rules
417 centpkg clog
420 usage: centpkg clog [-h] [--raw]
421 This will create a file named "clog" that contains the latest rpm
423 changelog entry. The leading "- " text will be stripped.
424 options:
426 -h, --help show this help message and exit
427 --raw Generate a more "raw" clog without twiddling the
428 contents
429 centpkg clone
432 usage: centpkg clone [-h] [--branches] [--branch BRANCH]
433 [--anonymous] [--depth DEPTH]
434 repo [clone_target] ...
435 This command will clone the named repository from the configured
437 repository base URL. By default it will also checkout the master
438 branch for your working copy.
439 positional arguments:
441 repo Name of the repository to clone. It should
442 not be a Git URL. Should be 'namespace/repo-
443 name' in case of namespaced dist-git.
444 Otherwise, just 'repo-name'. Namespace
445 examples are 'rpms', 'container', 'modules',
446 'flatpaks'. Default namespace 'rpms' can be
447 ignored.
448 clone_target Directory in which to clone the repository
449 extra_args Custom arguments that are passed to the 'git
450 clone'. Use '--' to separate them from other
451 arguments.
452 options:
454 -h, --help show this help message and exit
455 --branches, -B Do an old style checkout with subdirs for
456 branches
457 --branch BRANCH, -b BRANCH
458 Check out a specific branch
459 --anonymous, -a Check out a module anonymously
460 --depth DEPTH Create a shallow clone with a history
461 truncated to the specified number of commits
462 centpkg co
465 usage: centpkg co [-h] [--branches] [--branch BRANCH] [--anonymous]
466 [--depth DEPTH]
467 repo [clone_target] ...
468 Alias for clone.
470 positional arguments:
472 repo Name of the repository to clone. It should
473 not be a Git URL. Should be 'namespace/repo-
474 name' in case of namespaced dist-git.
475 Otherwise, just 'repo-name'. Namespace
476 examples are 'rpms', 'container', 'modules',
477 'flatpaks'. Default namespace 'rpms' can be
478 ignored.
479 clone_target Directory in which to clone the repository
480 extra_args Custom arguments that are passed to the 'git
481 clone'. Use '--' to separate them from other
482 arguments.
483 options:
485 -h, --help show this help message and exit
486 --branches, -B Do an old style checkout with subdirs for
487 branches
488 --branch BRANCH, -b BRANCH
489 Check out a specific branch
490 --anonymous, -a Check out a module anonymously
491 --depth DEPTH Create a shallow clone with a history
492 truncated to the specified number of commits
493 centpkg commit
496 usage: centpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c]
497 [--raw] [-t] [-F FILE] [-p] [-s]
498 [files ...]
499 This invokes a git commit. All tracked files with changes will be
501 committed unless a specific file list is provided. $EDITOR will be
502 used to generate a changelog message unless one is given to the
503 command. A push can be done at the same time.
504 positional arguments:
506 files Optional list of specific files to commit
507 options:
509 -h, --help show this help message and exit
510 -m MESSAGE, --message MESSAGE
511 Use the given <msg> as the commit message
512 summary
513 --with-changelog Get the last changelog from SPEC as commit
514 message content. This option must be used
515 with -m together.
516 -c, --clog Generate the commit message from the
517 Changelog section
518 --raw Make the clog raw
519 -t, --tag Create a tag for this commit
520 -F FILE, --file FILE Take the commit message from the given file
521 -p, --push Commit and push as one action
522 -s, --signoff Include a signed-off-by
523 centpkg compile
526 usage: centpkg compile [-h] [--builddir BUILDDIR]
527 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
528 [--define DEFINE] [--short-circuit]
529 [--nocheck]
530 ...
531 This command calls rpmbuild to compile the source. By default the
533 prep and configure stages will be done as well, unless the short-
534 circuit option is used.
535 positional arguments:
537 extra_args Custom arguments that are passed to the
538 'rpmbuild'. Use '--' to separate them from
539 other arguments.
540 options:
542 -h, --help show this help message and exit
543 --builddir BUILDDIR Define an alternate builddir
544 --buildrootdir BUILDROOTDIR
545 Define an alternate buildrootdir
546 --arch ARCH Prep for a specific arch
547 --define DEFINE Pass custom macros to rpmbuild, may specify
548 multiple times
549 --short-circuit short-circuit compile
550 --nocheck nocheck compile
551 centpkg container-build
554 usage: centpkg container-build [-h] [--target TARGET] [--nowait]
555 [--background]
556 [--build-release BUILD_RELEASE]
557 [--isolated]
558 [--koji-parent-build KOJI_PAR‐
559 ENT_BUILD]
560 [--scratch] [--arches [ARCHES ...]]
561 [--repo-url URL [URL ...]]
562 [--signing-intent SIGNING_INTENT]
563 [--skip-remote-rules-validation]
564 [--skip-build]
565 [--compose-id COMPOSE_ID [COMPOSE_ID
566 ...]]
567 [--replace-dependency PKG_MAN‐
568 AGER:NAME:VERSION[:NEW_NAME]
569 [PKG_MANAGER:NAME:VERSION[:NEW_NAME]
570 ...]]
571 Build a container
573 options:
575 -h, --help show this help message and exit
576 --target TARGET Override the default target
577 --nowait Don't wait on build
578 --background Run the build at a lower priority
579 --build-release BUILD_RELEASE
580 Specify a release value for this build's NVR
581 --isolated Do not update floating tags in the registry.
582 You must use the --build-release argument
583 --koji-parent-build KOJI_PARENT_BUILD
584 Specify a Koji NVR for the parent container
585 image. This will override the "FROM" value
586 in your Dockerfile.
587 --scratch Scratch build
588 --arches [ARCHES ...]
589 Limit a scratch or a isolated build to an
590 arch. May have multiple arches.
591 --repo-url URL [URL ...]
592 URLs of yum repo files
593 --signing-intent SIGNING_INTENT
594 Signing intent of the ODCS composes. If
595 specified, this must be one of the signing
596 intent names configured on the OSBS server.
597 If unspecified, the server will use the
598 signing intent of the compose_ids you
599 specify, or the server's
600 default_signing_intent. To view the full
601 list of possible names, see
602 atomic_reactor.config in osbs-build.log.
603 --skip-remote-rules-validation
604 Don't check if there's a valid gating.yaml
605 file in the repo
606 --skip-build Don't create build, but just modify settings
607 for autorebuilds
608 --compose-id COMPOSE_ID [COMPOSE_ID ...]
609 Existing ODCS composes to use (specify
610 integers). OSBS will not generate new ODCS
611 composes. Cannot be used with --signing-
612 intent.
613 --replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MAN‐
614 AGER:NAME:VERSION[:NEW_NAME] ...]
615 Cachito dependency replacement
616 centpkg container-build-setup
619 usage: centpkg container-build-setup [-h]
620 (--get-autorebuild | --set-au‐
621 torebuild {true,false})
622 set options for container-build.
624 options:
626 -h, --help show this help message and exit
627 --get-autorebuild Get autorebuild value
628 --set-autorebuild {true,false}
629 Turn autorebuilds on/off
630 centpkg copr-build
633 usage: centpkg copr-build [-h] [--config CONFIG] [--nowait] project
634 Build package in Copr.
636 Note: you need to have set up correct api key. For more information
638 see API KEY section of copr-cli(1) man page.
639 positional arguments:
641 project Name of the project in format USER/PROJECT
642 options:
644 -h, --help show this help message and exit
645 --config CONFIG Path to an alternative Copr configuration file
646 --nowait Don't wait on build
647 centpkg current-state
650 usage: centpkg current-state [-h]
651 Show the phase and state of current dist-git branch - Internal Only.
653 options:
655 -h, --help show this help message and exit
656 centpkg diff
659 usage: centpkg diff [-h] [--cached] [files ...]
660 Use git diff to show changes that have been made to tracked files.
662 By default cached changes (changes that have been git added) will
663 not be shown.
664 positional arguments:
666 files Optionally diff specific files
667 options:
669 -h, --help show this help message and exit
670 --cached View staged changes
671 centpkg flatpak-build
674 usage: centpkg flatpak-build [-h] [--target TARGET] [--nowait]
675 [--background]
676 [--build-release BUILD_RELEASE]
677 [--isolated]
678 [--koji-parent-build KOJI_PARENT_BUILD]
679 [--scratch] [--arches [ARCHES ...]]
680 [--repo-url URL [URL ...]]
681 [--signing-intent SIGNING_INTENT]
682 [--skip-remote-rules-validation]
683 [--skip-build]
684 Build a Flatpak
686 options:
688 -h, --help show this help message and exit
689 --target TARGET Override the default target
690 --nowait Don't wait on build
691 --background Run the build at a lower priority
692 --build-release BUILD_RELEASE
693 Specify a release value for this build's NVR
694 --isolated Do not update floating tags in the registry.
695 You must use the --build-release argument
696 --koji-parent-build KOJI_PARENT_BUILD
697 Specify a Koji NVR for the parent container
698 image. This will override the "FROM" value
699 in your Dockerfile.
700 --scratch Scratch build
701 --arches [ARCHES ...]
702 Limit a scratch or a isolated build to an
703 arch. May have multiple arches.
704 --repo-url URL [URL ...]
705 URLs of yum repo files
706 --signing-intent SIGNING_INTENT
707 Signing intent of the ODCS composes. If
708 specified, this must be one of the signing
709 intent names configured on the OSBS server.
710 If unspecified, the server will use the
711 signing intent of the compose_ids you
712 specify, or the server's
713 default_signing_intent. To view the full
714 list of possible names, see
715 atomic_reactor.config in osbs-build.log.
716 --skip-remote-rules-validation
717 Don't check if there's a valid gating.yaml
718 file in the repo
719 --skip-build Don't create build, but just modify settings
720 for autorebuilds
721 centpkg fork
724 usage: centpkg fork [-h]
725 Create a new fork of the current repository
727 Before the operation, you need to generate an API token at
729 https://gitlab.com/-/profile/personal_access_tokens, select the "api"
730 scope and save it in your local user configuration located
731 at ~/.config/rpkg/centpkg.conf. For example:
732 [centpkg.distgit]
734 token = <api_key_here>
735 Below is a basic example of the command to fork a current repository:
737 centpkg fork
739 options:
741 -h, --help show this help message and exit
742 centpkg gimmespec
745 usage: centpkg gimmespec [-h]
746 Print the spec file name.
748 options:
750 -h, --help show this help message and exit
751 centpkg gitbuildhash
754 usage: centpkg gitbuildhash [-h] build
755 This will show you the commit hash string used to build the provided
757 build n-v-r
758 positional arguments:
760 build name-version-release of the build to query.
761 options:
763 -h, --help show this help message and exit
764 centpkg giturl
767 usage: centpkg giturl [-h]
768 This will show you which git URL would be used in a build command.
770 It uses the git hashsum of the HEAD of the current branch (which may
771 not be pushed).
772 options:
774 -h, --help show this help message and exit
775 centpkg help
778 usage: centpkg help [-h]
779 Show usage.
781 options:
783 -h, --help show this help message and exit
784 centpkg import
787 usage: centpkg import [-h] [--skip-diffs] [--offline] srpm
788 This will extract sources, patches, and the spec file from an srpm
790 and update the current module accordingly. It will import to the
791 current branch by default.
792 positional arguments:
794 srpm Source rpm to import
795 options:
797 -h, --help show this help message and exit
798 --skip-diffs Don't show diffs when import srpms
799 --offline Do not upload files into lookaside cache
800 centpkg install
803 usage: centpkg install [-h] [--builddir BUILDDIR]
804 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
805 [--define DEFINE] [--short-circuit]
806 [--nocheck]
807 ...
808 This will call rpmbuild to run the install section. All leading
810 sections will be processed as well, unless the short-circuit option
811 is used.
812 positional arguments:
814 extra_args Custom arguments that are passed to the
815 'rpmbuild'. Use '--' to separate them from
816 other arguments.
817 options:
819 -h, --help show this help message and exit
820 --builddir BUILDDIR Define an alternate builddir
821 --buildrootdir BUILDROOTDIR
822 Define an alternate buildrootdir
823 --arch ARCH Prep for a specific arch
824 --define DEFINE Pass custom macros to rpmbuild, may specify
825 multiple times
826 --short-circuit short-circuit install
827 --nocheck nocheck install
828 centpkg lint
831 usage: centpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
832 Rpmlint can be configured using the --rpmlintconf/-r option or by
834 setting a <pkgname>.rpmlintrc file in the working directory
835 options:
837 -h, --help show this help message and exit
838 --info, -i Display explanations for reported messages
839 --rpmlintconf RPMLINTCONF, -r RPMLINTCONF
840 Use a specific configuration file for
841 rpmlint
842 centpkg list-side-tags
845 usage: centpkg list-side-tags [-h]
846 [--mine | --user TAG_OWNER | --base-tag
847 BASE_TAG]
848 List existing side-tags.
850 options:
852 -h, --help show this help message and exit
853 --mine List only my side tags
854 --user TAG_OWNER List side tags created by this user
855 --base-tag BASE_TAG List only tags based on this base
856 centpkg local
859 usage: centpkg local [-h] [--builddir BUILDDIR]
860 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
861 [--define DEFINE] [--md5] [--with BCOND_WITH]
862 [--without BCOND_WITHOUT]
863 ...
864 Locally test run of rpmbuild producing binary RPMs. The rpmbuild
866 output will be logged into a file named
867 .build-%{version}-%{release}.log
868 positional arguments:
870 extra_args Custom arguments that are passed to the
871 'rpmbuild'. Use '--' to separate them from
872 other arguments.
873 options:
875 -h, --help show this help message and exit
876 --builddir BUILDDIR Define an alternate builddir
877 --buildrootdir BUILDROOTDIR
878 Define an alternate buildrootdir
879 --arch ARCH Prep for a specific arch
880 --define DEFINE Pass custom macros to rpmbuild, may specify
881 multiple times
882 --md5 Use md5 checksums (for older rpm hosts)
883 --with BCOND_WITH Enable configure option (bcond) for the
884 build
885 --without BCOND_WITHOUT
886 Disable configure option (bcond) for the
887 build
888 centpkg mock-config
891 usage: centpkg mock-config [-h] [--target TARGET] [--arch ARCH]
892 This will generate a mock config based on the buildsystem target
894 options:
896 -h, --help show this help message and exit
897 --target TARGET Override target used for config
898 --arch ARCH Override local arch
899 centpkg mockbuild
902 usage: centpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean]
903 [--no-cleanup-after] [--no-clean-all]
904 [--with BCOND_WITH]
905 [--without BCOND_WITHOUT] [--shell]
906 [--enablerepo ENABLEREPO]
907 [--disablerepo DISABLEREPO]
908 [--enable-network] [--srpm-mock]
909 [--use-koji-mock-config | --use-local-mock-
910 config]
911 ...
912 This will use the mock utility to build the package for the
914 distribution detected from branch information. This can be
915 overridden using the global --release option. Your user must be in
916 the local "mock" group.
917 positional arguments:
919 extra_args Custom arguments that are passed to the
920 'mock'. Use '--' to separate them from other
921 arguments.
922 options:
924 -h, --help show this help message and exit
925 --root CONFIG, --mock-config CONFIG
926 Override mock configuration (like mock -r)
927 --md5 Use md5 checksums (for older rpm hosts)
928 --no-clean, -n Do not clean chroot before building package
929 --no-cleanup-after Do not clean chroot after building (if
930 automatic cleanup is enabled
931 --no-clean-all, -N Alias for both --no-clean and --no-cleanup-
932 after
933 --with BCOND_WITH Enable configure option (bcond) for the
934 build
935 --without BCOND_WITHOUT
936 Disable configure option (bcond) for the
937 build
938 --shell Run commands interactively within chroot.
939 Before going into chroot, mockbuild needs to
940 run with --no-cleanup-after in advanced.
941 --enablerepo ENABLEREPO
942 Pass enablerepo option to yum/dnf (may be
943 used more than once)
944 --disablerepo DISABLEREPO
945 Pass disablerepo option to yum/dnf (may be
946 used more than once)
947 --enable-network Enable networking
948 --srpm-mock Generate source rpm with 'mock' and then run
949 'mockbuild' using this source rpm
950 --use-koji-mock-config
951 Download Mock configuration from Kojihub,
952 instead of using the local Mock
953 configuration in mock-core-configs.rpm.
954 --use-local-mock-config
955 Enforce use of local Mock configuration.
956 If config file for mock isn't found in the /etc/mock directory, a
958 temporary config directory for mock is created and populated with a
959 config file created with mock-config.
960 centpkg module-build
963 usage: centpkg module-build [-h] [--watch]
964 [--buildrequires name:stream]
965 [--requires name:stream]
966 [--optional key=value]
967 [--file [FILE_PATH]] [--srpm SRPMS]
968 [--scratch]
969 [scm_url] [branch]
970 Build a module using MBS
972 positional arguments:
974 scm_url The module's SCM URL. This defaults to the
975 current repo.
976 branch The module's SCM branch. This defaults to
977 the current checked-out branch.
978 options:
980 -h, --help show this help message and exit
981 --watch, -w Watch the module build
982 --buildrequires name:stream
983 Buildrequires to override in the form of
984 "name:stream"
985 --requires name:stream
986 Requires to override in the form of
987 "name:stream"
988 --optional key=value MBS optional arguments in the form of
989 "key=value". For example: 'centpkg module-
990 build --optional
991 "reuse_components_from=<NSVC>"'. More
992 description including list of available
993 arguments here: https://pagure.io/fm-
994 orchestrator/
995 --file [FILE_PATH] The modulemd yaml file for module scratch
996 build.
997 --srpm SRPMS Include one or more srpms for module scratch
998 build.
999 --scratch Perform a scratch build
1000 centpkg module-build-cancel
1003 usage: centpkg module-build-cancel [-h] build_id
1004 Cancel an MBS module build
1006 positional arguments:
1008 build_id The ID of the module build to cancel
1009 options:
1011 -h, --help show this help message and exit
1012 centpkg module-build-info
1015 usage: centpkg module-build-info [-h] build_id
1016 Show information of an MBS module build
1018 positional arguments:
1020 build_id The ID of the module build
1021 options:
1023 -h, --help show this help message and exit
1024 centpkg module-build-local
1027 usage: centpkg module-build-local [-h] [--file [FILE_PATH]]
1028 [--srpm SRPMS] [--stream [STREAM]]
1029 [--skip-tests]
1030 [--add-local-build N:S:V] [-s N:S]
1031 [--offline] [-r PATH]
1032 Build a module locally using the mbs-manager command
1034 options:
1036 -h, --help show this help message and exit
1037 --file [FILE_PATH] The module's modulemd yaml file. If not
1038 specified, a yaml file with the same
1039 basename as the name of the repository will
1040 be used.
1041 --srpm SRPMS Include one or more srpms for module build.
1042 --stream [STREAM] The module's stream/SCM branch. This
1043 defaults to the current checked-out branch.
1044 --skip-tests Adds a macro for skipping the check section
1045 --add-local-build N:S:V
1046 Import previously finished local module
1047 builds into MBS in the format of name:stream
1048 or name:stream:version
1049 -s N:S, --set-default-stream N:S
1050 Set the default stream for given module
1051 dependency in case there are multiple
1052 streams to choose from.
1053 --offline Builds module offline without any external
1054 infrastructure
1055 -r PATH, --repository PATH
1056 Full path to .repo file defining the base
1057 module repository to use when --offline is
1058 used.
1059 centpkg module-build-watch
1062 usage: centpkg module-build-watch [-h] build_id [build_id ...]
1063 Watch an MBS build
1065 positional arguments:
1067 build_id The ID of the module build to watch
1068 options:
1070 -h, --help show this help message and exit
1071 centpkg module-overview
1074 usage: centpkg module-overview [-h] [--unfinished] [--limit LIMIT]
1075 [--owner FAS_ID | --mine]
1076 Shows an overview of MBS builds
1078 options:
1080 -h, --help show this help message and exit
1081 --unfinished Show unfinished module builds
1082 --limit LIMIT The number of most recent module builds to display
1083 --owner FAS_ID List only items of that owner
1084 --mine Use current Kerberos name or username
1085 centpkg module-scratch-build
1088 usage: centpkg module-scratch-build [-h] [--watch]
1089 [--buildrequires name:stream]
1090 [--requires name:stream]
1091 [--optional key=value]
1092 [--file [FILE_PATH]]
1093 [--srpm SRPMS]
1094 [scm_url] [branch]
1095 Build a scratch module using MBS
1097 positional arguments:
1099 scm_url The module's SCM URL. This defaults to the
1100 current repo.
1101 branch The module's SCM branch. This defaults to
1102 the current checked-out branch.
1103 options:
1105 -h, --help show this help message and exit
1106 --watch, -w Watch the module build
1107 --buildrequires name:stream
1108 Buildrequires to override in the form of
1109 "name:stream"
1110 --requires name:stream
1111 Requires to override in the form of
1112 "name:stream"
1113 --optional key=value MBS optional arguments in the form of
1114 "key=value". For example: 'centpkg module-
1115 build --optional
1116 "reuse_components_from=<NSVC>"'. More
1117 description including list of available
1118 arguments here: https://pagure.io/fm-
1119 orchestrator/
1120 --file [FILE_PATH] The modulemd yaml file for module scratch
1121 build.
1122 --srpm SRPMS Include one or more srpms for module scratch
1123 build.
1124 centpkg new
1127 usage: centpkg new [-h]
1128 This will use git to show a diff of all the changes (even
1130 uncommitted changes) since the last git tag was applied.
1131 options:
1133 -h, --help show this help message and exit
1134 centpkg new-sources
1137 usage: centpkg new-sources [-h] [--offline] files [files ...]
1138 This will upload new source file(s) to lookaside cache, and all file
1140 names listed in sources file will be replaced. .gitignore will be
1141 also updated with new uploaded file(s). Please remember to commit
1142 them.
1143 positional arguments:
1145 files
1146 options:
1148 -h, --help show this help message and exit
1149 --offline Do all the steps except uploading into lookaside cache
1150 centpkg patch
1153 usage: centpkg patch [-h] [--rediff] suffix
1154 Create and add a gendiff patch file.
1156 positional arguments:
1158 suffix Look for files with this suffix to diff
1159 options:
1161 -h, --help show this help message and exit
1162 --rediff Recreate gendiff file retaining comments Saves old
1163 patch file with a suffix of ~
1164 Patch file will be named: package-version-suffix.patch and the file
1166 will be added to the repo index
1167 centpkg pre-push-check
1170 usage: centpkg pre-push-check [-h] [ref]
1171 Performs few checks of the repository before pushing changes.
1173 "git push" command itself is not part of this check.
1174 Checks include:
1176 * parse specfile for source files and verifies it is noted also
1177 in the 'sources' file.
1178 * verifies, that all source files from 'sources' file were uploaded
1180 to the lookaside cache.
1181 Checks can be performed manually by executing 'pre-push-check' com‐
1183 mand.
1184 But originally, it is designed to be executed automatically right be‐
1185 fore
1186 'git push' command is started. Every time the 'git push' command
1187 is executed, the 'pre-push' hook script runs first.
1188 Path: <repository_directory>/.git/hooks/pre-push
1190 This hook script is created after a new repository is cloned. Previ‐
1192 ously
1193 created repositories don't contain this hook script.
1194 To disable these checks, remove the hook script.
1196 positional arguments:
1198 ref Reference to the commit that will be checkedAccepts
1199 hash or reference for example 'refs/heads/f37'
1200 options:
1202 -h, --help show this help message and exit
1203 centpkg prep
1206 usage: centpkg prep [-h] [--builddir BUILDDIR]
1207 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1208 [--define DEFINE]
1209 ...
1210 Use rpmbuild to "prep" the sources (unpack the source archive(s) and
1212 apply any patches.)
1213 positional arguments:
1215 extra_args Custom arguments that are passed to the
1216 'rpmbuild'. Use '--' to separate them from
1217 other arguments.
1218 options:
1220 -h, --help show this help message and exit
1221 --builddir BUILDDIR Define an alternate builddir
1222 --buildrootdir BUILDROOTDIR
1223 Define an alternate buildrootdir
1224 --arch ARCH Prep for a specific arch
1225 --define DEFINE Pass custom macros to rpmbuild, may specify
1226 multiple times
1227 centpkg pull
1230 usage: centpkg pull [-h] [--rebase] [--no-rebase]
1231 This command uses git to fetch remote changes and apply them to the
1233 current working copy. A rebase option is available which can be used
1234 to avoid merges.
1235 options:
1237 -h, --help show this help message and exit
1238 --rebase Rebase the locally committed changes on top of the
1239 remote changes after fetching. This can avoid a merge
1240 commit, but does rewrite local history.
1241 --no-rebase Do not rebase, overriding .git settings to the
1242 contrary
1243 See git pull --help for more details
1245 centpkg push
1248 usage: centpkg push [-h] [--force] [--no-verify]
1249 Push changes to remote repository.
1251 options:
1253 -h, --help show this help message and exit
1254 --force, -f Force push
1255 --no-verify Bypass the pre-push hook script. No check of the
1256 branch will prevent the push.
1257 centpkg remote
1260 usage: centpkg remote [-h] {add} ...
1261 Operations with tracked repositories ('remotes'). This is an
1263 experimental interface.
1264 options:
1266 -h, --help show this help message and exit
1267 subcommands:
1269 Operations with tracked repositories ('remotes'). This is an
1270 experimental interface. Please note that some or all current
1271 functionality is subject to change. Without parameters list of
1272 remotes will be shown.
1273 {add}
1275 centpkg remove-side-tag
1278 usage: centpkg remove-side-tag [-h] TAG
1279 Remove a side tag (without merging packages).
1281 positional arguments:
1283 TAG name of tag to be deleted
1284 options:
1286 -h, --help show this help message and exit
1287 centpkg request-gated-side-tag
1290 usage: centpkg request-gated-side-tag [-h] [--base-tag BASE_TAG]
1291 Create a new dynamic gated side tag.
1293 options:
1295 -h, --help show this help message and exit
1296 --base-tag BASE_TAG name of base tag
1297 centpkg request-side-tag
1300 usage: centpkg request-side-tag [-h] [--base-tag BASE_TAG]
1301 [--suffix SUFFIX]
1302 Create a new side tag.
1304 options:
1306 -h, --help show this help message and exit
1307 --base-tag BASE_TAG name of base tag
1308 --suffix SUFFIX A suffix to be appended to the side tag name.
1309 The suffix must be allowed in Koji
1310 configuration.
1311 centpkg retire
1314 usage: centpkg retire [-h] reason
1315 This command will remove all files from the repo, leave a
1317 dead.package file for rpms or dead.module file for modules, and push
1318 the changes.
1319 positional arguments:
1321 reason Reason for retiring the package/module
1322 options:
1324 -h, --help show this help message and exit
1325 centpkg scratch-build
1328 usage: centpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5]
1329 [--nowait] [--target TARGET]
1330 [--background] [--fail-fast]
1331 [--skip-remote-rules-validation]
1332 [--skip-nvr-check]
1333 [--custom-user-metadata CUS‐
1334 TOM_USER_METADATA]
1335 [--srpm [SRPM]] [--srpm-mock]
1336 This command will request a scratch build of the package. Without
1338 providing an srpm, it will attempt to build the latest commit, which
1339 must have been pushed. By default all appropriate arches will be
1340 built.
1341 options:
1343 -h, --help show this help message and exit
1344 --arches [ARCHES ...]
1345 Build for specific arches
1346 --md5 Use md5 checksums (for older rpm hosts)
1347 --nowait Don't wait on build
1348 --target TARGET Define build target to build into
1349 --background Run the build at a low priority
1350 --fail-fast Fail the build immediately if any arch fails
1351 --skip-remote-rules-validation
1352 Don't check if there's a valid gating.yaml
1353 file in the repo, where you can define
1354 additional policies for Greenwave gating.
1355 --skip-nvr-check Submit build to buildsystem without check if
1356 NVR was already built. NVR is constructed
1357 locally and may be different from NVR
1358 constructed during build on builder.
1359 --custom-user-metadata CUSTOM_USER_METADATA
1360 Provide a JSON string of custom metadata to
1361 be deserialized and stored under the build's
1362 extra.custom_user_metadata field
1363 --srpm [SRPM] Build from an srpm. If no srpm is provided
1364 with this option an srpm will be generated
1365 from the current module content.
1366 --srpm-mock Build from an srpm. Source rpm will be
1367 generated in 'mock' instead of 'rpmbuild'.
1368 centpkg sources
1371 usage: centpkg sources [-h] [--outdir OUTDIR] [--force]
1372 Download source files
1374 options:
1376 -h, --help show this help message and exit
1377 --outdir OUTDIR Directory to download files into (defaults to
1378 pwd)
1379 --force Download all sources, even if unused or otherwise
1380 excluded by default.
1381 centpkg srpm
1384 usage: Create a source rpm
1385 This command wraps "rpmbuild -bs", roughly equivalent to:
1387 rpmbuild -bs mypackage.spec --define "_topdir ." --de‐
1389 fine "_sourcedir ." --define "_srcrpmdir ." --define "dist
1390 .el8"
1391 To include files in the SRPM, the files must be in the current
1393 working directory (this depends on the package layout used),
1394 and you must reference each file with SourceXXXX: or PatchXXXX:
1395 directives in your .spec file.
1396 positional arguments:
1398 extra_args Custom arguments that are passed to the
1399 'rpmbuild'. Use '--' to separate them from
1400 other arguments.
1401 options:
1403 -h, --help show this help message and exit
1404 --builddir BUILDDIR Define an alternate builddir
1405 --buildrootdir BUILDROOTDIR
1406 Define an alternate buildrootdir
1407 --arch ARCH Prep for a specific arch
1408 --define DEFINE Pass custom macros to rpmbuild, may specify
1409 multiple times
1410 --md5 Use md5 checksums (for older rpm hosts)
1411 --srpm-mock Create source rpm in 'mock' instead of
1412 'rpmbuild'
1413 --no-clean, -n Only for --srpm-mock: Do not clean chroot
1414 before building package
1415 --no-cleanup-after Only for --srpm-mock: Do not clean chroot
1416 after building if automatic cleanup is
1417 enabled
1418 --no-clean-all, -N Only for --srpm-mock: Alias for both --no-
1419 clean and --no-cleanup-after
1420 centpkg switch-branch
1423 usage: centpkg switch-branch [-h] [-l] [--fetch] [branch]
1424 This command can switch to a local git branch. If provided with a
1426 remote branch name that does not have a local match it will create
1427 one. It can also be used to list the existing local and remote
1428 branches.
1429 positional arguments:
1431 branch Branch name to switch to
1432 options:
1434 -h, --help show this help message and exit
1435 -l, --list List both remote-tracking branches and local branches
1436 --fetch Fetch new data from remote before switch
1437 centpkg tag
1440 usage: centpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE]
1441 [-l] [-d]
1442 [tag]
1443 This command uses git to create, list, or delete tags.
1445 positional arguments:
1447 tag Name of the tag
1448 options:
1450 -h, --help show this help message and exit
1451 -f, --force Force the creation of the tag
1452 -m MESSAGE, --message MESSAGE
1453 Use the given <msg> as the tag message
1454 -c, --clog Generate the tag message from the spec
1455 changelog section
1456 --raw Make the clog raw
1457 -F FILE, --file FILE Take the tag message from the given file
1458 -l, --list List all tags with a given pattern, or all
1459 if not pattern is given
1460 -d, --delete Delete a tag
1461 centpkg unused-patches
1464 usage: centpkg unused-patches [-h]
1465 Print list of patches not referenced by name in the specfile.
1467 options:
1469 -h, --help show this help message and exit
1470 centpkg upload
1473 usage: centpkg upload [-h] [--offline] files [files ...]
1474 This command will upload new source file(s) to lookaside cache.
1476 Source file names are appended to sources file, and .gitignore will
1477 be also updated with new uploaded file(s). Please remember to commit
1478 them.
1479 positional arguments:
1481 files
1482 options:
1484 -h, --help show this help message and exit
1485 --offline Do all the steps except uploading into lookaside cache
1486 centpkg verify-files
1489 usage: centpkg verify-files [-h] [--builddir BUILDDIR]
1490 [--buildrootdir BUILDROOTDIR]
1491 [--arch ARCH] [--define DEFINE]
1492 ...
1493 Locally run 'rpmbuild -bl' to verify the spec file's %files
1495 sections. This requires a successful run of 'centpkg install' in
1496 advance.
1497 positional arguments:
1499 extra_args Custom arguments that are passed to the
1500 'rpmbuild'. Use '--' to separate them from
1501 other arguments.
1502 options:
1504 -h, --help show this help message and exit
1505 --builddir BUILDDIR Define an alternate builddir
1506 --buildrootdir BUILDROOTDIR
1507 Define an alternate buildrootdir
1508 --arch ARCH Prep for a specific arch
1509 --define DEFINE Pass custom macros to rpmbuild, may specify
1510 multiple times
1511 centpkg verrel
1514 usage: centpkg verrel [-h]
1515 Print the name-version-release.
1517 options:
1519 -h, --help show this help message and exit
1520
1523 https://git.centos.org/centos/centpkg
1524 2023-09-07 centpkg(1)