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]
52 Request build
53 centpkg chain-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
55 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
56 validation] [--skip-nvr-check] [--custom-user-metadata CUS‐
57 TOM_USER_METADATA] package [package ...]
58 Build current package in order with other packages
59 centpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t] [-F
61 FILE] [-p] [-s] [files ...]
62 Alias for commit
63 centpkg clean [-h] [--dry-run] [-x]
65 Remove untracked files
66 centpkg clog [-h] [--raw]
68 Make a clog file containing top changelog entry
69 centpkg clone [-h] [--branches] [--branch BRANCH] [--anonymous]
71 [--depth DEPTH] repo [clone_target] ...
72 Clone and checkout a repository
73 centpkg co [-h] [--branches] [--branch BRANCH] [--anonymous] [--depth
75 DEPTH] repo [clone_target] ...
76 Alias for clone
77 centpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t]
79 [-F FILE] [-p] [-s] [files ...]
80 Commit changes
81 centpkg compile [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOT‐
83 DIR] [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
84 Local test rpmbuild compile
85 centpkg container-build [-h] [--target TARGET] [--nowait] [--back‐
87 ground] [--build-release BUILD_RELEASE] [--isolated] [--koji-parent-
88 build KOJI_PARENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--repo-
89 url URL [URL ...]] [--signing-intent SIGNING_INTENT] [--skip-remote-
90 rules-validation] [--skip-build] [--compose-id COMPOSE_ID [COMPOSE_ID
91 ...]] [--replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME]
92 [PKG_MANAGER:NAME:VERSION[:NEW_NAME] ...]]
93 Build a container
94 centpkg container-build-setup [-h] (--get-autorebuild | --set-autore‐
96 build {true,false})
97 set options for container-build
98 centpkg copr-build [-h] [--config CONFIG] [--nowait] project
100 Build package in Copr
101 centpkg diff [-h] [--cached] [files ...]
103 Show changes between commits, commit and working tree, etc
104 centpkg flatpak-build [-h] [--target TARGET] [--nowait] [--background]
106 [--build-release BUILD_RELEASE] [--isolated] [--koji-parent-build
107 KOJI_PARENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--repo-url URL
108 [URL ...]] [--signing-intent SIGNING_INTENT] [--skip-remote-rules-vali‐
109 dation] [--skip-build]
110 Build a Flatpak
111 centpkg fork [-h]
113 Create a new fork of the current repository
114 centpkg gimmespec [-h]
116 Print the spec file name
117 centpkg gitbuildhash [-h] build
119 Print the git hash used to build the provided n-v-r
120 centpkg giturl [-h]
122 Print the git url for building
123 centpkg help [-h]
125 Show usage
126 centpkg import [-h] [--skip-diffs] [--offline] srpm
128 Import srpm content into a module
129 centpkg install [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOT‐
131 DIR] [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
132 Local test rpmbuild install
133 centpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
135 Run rpmlint against local spec and build output if present.
136 centpkg list-side-tags [-h] [--mine | --user TAG_OWNER | --base-tag
138 BASE_TAG]
139 List existing side-tags
140 centpkg local [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
142 [--arch ARCH] [--define DEFINE] [--md5] [--with BCOND_WITH] [--without
143 BCOND_WITHOUT] ...
144 Local test rpmbuild binary
145 centpkg mock-config [-h] [--target TARGET] [--arch ARCH]
147 Generate a mock config
148 centpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean] [--no-
150 cleanup-after] [--no-clean-all] [--with BCOND_WITH] [--without
151 BCOND_WITHOUT] [--shell] [--enablerepo ENABLEREPO] [--disablerepo DIS‐
152 ABLEREPO] [--enable-network] [--srpm-mock] [--use-koji-mock-config |
153 --use-local-mock-config] ...
154 Local test build using mock
155 centpkg module-build [-h] [--watch] [--buildrequires name:stream]
157 [--requires name:stream] [--optional key=value] [--file [FILE_PATH]]
158 [--srpm SRPMS] [--scratch] [scm_url] [branch]
159 Build a module using MBS
160 centpkg module-build-cancel [-h] build_id
162 Cancel an MBS module build
163 centpkg module-build-info [-h] build_id
165 Show information of an MBS module build
166 centpkg module-build-local [-h] [--file [FILE_PATH]] [--srpm SRPMS]
168 [--stream [STREAM]] [--skip-tests] [--add-local-build N:S:V] [-s N:S]
169 [--offline] [-r PATH]
170 Build a module locally using the mbs-manager command
171 centpkg module-build-watch [-h] build_id [build_id ...]
173 Watch an MBS build
174 centpkg module-overview [-h] [--unfinished] [--limit LIMIT] [--owner
176 FAS_ID | --mine]
177 Shows an overview of MBS builds
178 centpkg module-scratch-build [-h] [--watch] [--buildrequires
180 name:stream] [--requires name:stream] [--optional key=value] [--file
181 [FILE_PATH]] [--srpm SRPMS] [scm_url] [branch]
182 Build a scratch module using MBS
183 centpkg new [-h]
185 Diff against last tag
186 centpkg new-sources [-h] [--offline] files [files ...]
188 Upload source files
189 centpkg patch [-h] [--rediff] suffix
191 Create and add a gendiff patch file
192 centpkg prep [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
194 [--arch ARCH] [--define DEFINE] ...
195 Local test rpmbuild prep
196 centpkg pull [-h] [--rebase] [--no-rebase]
198 Pull changes from the remote repository and update the working
199 copy.
200 centpkg push [-h] [--force]
202 Push changes to remote repository
203 centpkg remote [-h] {add} ...
205 Operations with tracked repositories ('remotes'). This is an ex‐
206 perimental interface.
207 centpkg remove-side-tag [-h] TAG
209 Remove a side tag (without merging packages)
210 centpkg request-gated-side-tag [-h] [--base-tag BASE_TAG]
212 Create a new dynamic gated side tag
213 centpkg request-side-tag [-h] [--base-tag BASE_TAG] [--suffix SUFFIX]
215 Create a new side tag
216 centpkg retire [-h] reason
218 Retire a package/module
219 centpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
221 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
222 validation] [--skip-nvr-check] [--custom-user-metadata CUS‐
223 TOM_USER_METADATA] [--srpm [SRPM]] [--srpm-mock]
224 Request scratch build
225 centpkg sources [-h] [--outdir OUTDIR]
227 Download source files
228 Create a source rpm
230 Create a source rpm
231 centpkg switch-branch [-h] [-l] [--fetch] [branch]
233 Work with branches
234 centpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l] [-d]
236 [tag]
237 Management of git tags
238 centpkg unused-patches [-h]
240 Print list of patches not referenced by name in the specfile
241 centpkg upload [-h] [--offline] files [files ...]
243 Upload source files
244 centpkg verify-files [-h] [--builddir BUILDDIR] [--buildrootdir BUILD‐
246 ROOTDIR] [--arch ARCH] [--define DEFINE] ...
247 Locally verify %%files section
248 centpkg verrel [-h]
250 Print the name-version-release.
251
253 centpkg build
254 usage: centpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
255 [--target TARGET] [--background] [--fail-fast]
256 [--skip-remote-rules-validation]
257 [--skip-nvr-check]
258 [--custom-user-metadata CUSTOM_USER_METADATA]
259 [--skip-tag] [--scratch] [--srpm [SRPM]]
260 [--srpm-mock]
261 This command requests a build of the package in the build system. By
263 default it discovers the target to build for based on branch data,
264 and uses the latest commit as the build source.
265 options:
267 -h, --help show this help message and exit
268 --arches [ARCHES ...]
269 Build for specific arches
270 --md5 Use md5 checksums (for older rpm hosts)
271 --nowait Don't wait on build
272 --target TARGET Define build target to build into
273 --background Run the build at a low priority
274 --fail-fast Fail the build immediately if any arch fails
275 --skip-remote-rules-validation
276 Don't check if there's a valid gating.yaml
277 file in the repo, where you can define
278 additional policies for Greenwave gating.
279 --skip-nvr-check Submit build to buildsystem without check if
280 NVR was already built. NVR is constructed
281 locally and may be different from NVR
282 constructed during build on builder.
283 --custom-user-metadata CUSTOM_USER_METADATA
284 Provide a JSON string of custom metadata to
285 be deserialized and stored under the build's
286 extra.custom_user_metadata field
287 --skip-tag Do not attempt to tag package
288 --scratch Perform a scratch build
289 --srpm [SRPM] Build from an srpm. If no srpm is provided
290 with this option an srpm will be generated
291 from current module content.
292 --srpm-mock Build from an srpm. Source rpm will be
293 generated in 'mock' instead of 'rpmbuild'.
294 centpkg chain-build
297 usage: centpkg chain-build [-h] [--arches [ARCHES ...]] [--md5]
298 [--nowait] [--target TARGET]
299 [--background] [--fail-fast]
300 [--skip-remote-rules-validation]
301 [--skip-nvr-check]
302 [--custom-user-metadata CUSTOM_USER_META‐
303 DATA]
304 package [package ...]
305 Build current package in order with other packages.
307 example: centpkg chain-build libwidget libgizmo
309 The current package is added to the end of the CHAIN list.
311 Colons (:) can be used in the CHAIN parameter to define groups of
312 packages. Packages in any single group will be built in parallel
313 and all packages in a group must build successfully and populate
314 the repository before the next group will begin building.
315 For example:
317 centpkg chain-build libwidget libaselib : libgizmo :
319 will cause libwidget and libaselib to be built in parallel, followed
321 by libgizmo and then the current directory package. If no groups are
322 defined, packages will be built sequentially.
323 positional arguments:
325 package List the packages and order you want to
326 build in
327 options:
329 -h, --help show this help message and exit
330 --arches [ARCHES ...]
331 Build for specific arches
332 --md5 Use md5 checksums (for older rpm hosts)
333 --nowait Don't wait on build
334 --target TARGET Define build target to build into
335 --background Run the build at a low priority
336 --fail-fast Fail the build immediately if any arch fails
337 --skip-remote-rules-validation
338 Don't check if there's a valid gating.yaml
339 file in the repo, where you can define
340 additional policies for Greenwave gating.
341 --skip-nvr-check Submit build to buildsystem without check if
342 NVR was already built. NVR is constructed
343 locally and may be different from NVR
344 constructed during build on builder.
345 --custom-user-metadata CUSTOM_USER_METADATA
346 Provide a JSON string of custom metadata to
347 be deserialized and stored under the build's
348 extra.custom_user_metadata field
349 centpkg ci
352 usage: centpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw]
353 [-t] [-F FILE] [-p] [-s]
354 [files ...]
355 Alias for commit.
357 positional arguments:
359 files Optional list of specific files to commit
360 options:
362 -h, --help show this help message and exit
363 -m MESSAGE, --message MESSAGE
364 Use the given <msg> as the commit message
365 summary
366 --with-changelog Get the last changelog from SPEC as commit
367 message content. This option must be used
368 with -m together.
369 -c, --clog Generate the commit message from the
370 Changelog section
371 --raw Make the clog raw
372 -t, --tag Create a tag for this commit
373 -F FILE, --file FILE Take the commit message from the given file
374 -p, --push Commit and push as one action
375 -s, --signoff Include a signed-off-by
376 centpkg clean
379 usage: centpkg clean [-h] [--dry-run] [-x]
380 This command can be used to clean up your working directory. By
382 default it will follow .gitignore rules. Patterns listed in
383 .git/info/exclude won'tbe removed either.
384 options:
386 -h, --help show this help message and exit
387 --dry-run, -n Perform a dry-run
388 -x Do not follow .gitignore and .git/info/exclude
389 rules
390 centpkg clog
393 usage: centpkg clog [-h] [--raw]
394 This will create a file named "clog" that contains the latest rpm
396 changelog entry. The leading "- " text will be stripped.
397 options:
399 -h, --help show this help message and exit
400 --raw Generate a more "raw" clog without twiddling the
401 contents
402 centpkg clone
405 usage: centpkg clone [-h] [--branches] [--branch BRANCH]
406 [--anonymous] [--depth DEPTH]
407 repo [clone_target] ...
408 This command will clone the named repository from the configured
410 repository base URL. By default it will also checkout the master
411 branch for your working copy.
412 positional arguments:
414 repo Name of the repository to clone. It should
415 not be a Git URL. Should be 'namespace/repo-
416 name' in case of namespaced dist-git.
417 Otherwise, just 'repo-name'. Namespace
418 examples are 'rpms', 'container', 'modules',
419 'flatpaks'. Default namespace 'rpms' can be
420 ignored.
421 clone_target Directory in which to clone the repository
422 extra_args Custom arguments that are passed to the 'git
423 clone'. Use '--' to separate them from other
424 arguments.
425 options:
427 -h, --help show this help message and exit
428 --branches, -B Do an old style checkout with subdirs for
429 branches
430 --branch BRANCH, -b BRANCH
431 Check out a specific branch
432 --anonymous, -a Check out a module anonymously
433 --depth DEPTH Create a shallow clone with a history
434 truncated to the specified number of commits
435 centpkg co
438 usage: centpkg co [-h] [--branches] [--branch BRANCH] [--anonymous]
439 [--depth DEPTH]
440 repo [clone_target] ...
441 Alias for clone.
443 positional arguments:
445 repo Name of the repository to clone. It should
446 not be a Git URL. Should be 'namespace/repo-
447 name' in case of namespaced dist-git.
448 Otherwise, just 'repo-name'. Namespace
449 examples are 'rpms', 'container', 'modules',
450 'flatpaks'. Default namespace 'rpms' can be
451 ignored.
452 clone_target Directory in which to clone the repository
453 extra_args Custom arguments that are passed to the 'git
454 clone'. Use '--' to separate them from other
455 arguments.
456 options:
458 -h, --help show this help message and exit
459 --branches, -B Do an old style checkout with subdirs for
460 branches
461 --branch BRANCH, -b BRANCH
462 Check out a specific branch
463 --anonymous, -a Check out a module anonymously
464 --depth DEPTH Create a shallow clone with a history
465 truncated to the specified number of commits
466 centpkg commit
469 usage: centpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c]
470 [--raw] [-t] [-F FILE] [-p] [-s]
471 [files ...]
472 This invokes a git commit. All tracked files with changes will be
474 committed unless a specific file list is provided. $EDITOR will be
475 used to generate a changelog message unless one is given to the
476 command. A push can be done at the same time.
477 positional arguments:
479 files Optional list of specific files to commit
480 options:
482 -h, --help show this help message and exit
483 -m MESSAGE, --message MESSAGE
484 Use the given <msg> as the commit message
485 summary
486 --with-changelog Get the last changelog from SPEC as commit
487 message content. This option must be used
488 with -m together.
489 -c, --clog Generate the commit message from the
490 Changelog section
491 --raw Make the clog raw
492 -t, --tag Create a tag for this commit
493 -F FILE, --file FILE Take the commit message from the given file
494 -p, --push Commit and push as one action
495 -s, --signoff Include a signed-off-by
496 centpkg compile
499 usage: centpkg compile [-h] [--builddir BUILDDIR]
500 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
501 [--define DEFINE] [--short-circuit]
502 [--nocheck]
503 ...
504 This command calls rpmbuild to compile the source. By default the
506 prep and configure stages will be done as well, unless the short-
507 circuit option is used.
508 positional arguments:
510 extra_args Custom arguments that are passed to the
511 'rpmbuild'. Use '--' to separate them from
512 other arguments.
513 options:
515 -h, --help show this help message and exit
516 --builddir BUILDDIR Define an alternate builddir
517 --buildrootdir BUILDROOTDIR
518 Define an alternate buildrootdir
519 --arch ARCH Prep for a specific arch
520 --define DEFINE Pass custom macros to rpmbuild, may specify
521 multiple times
522 --short-circuit short-circuit compile
523 --nocheck nocheck compile
524 centpkg container-build
527 usage: centpkg container-build [-h] [--target TARGET] [--nowait]
528 [--background]
529 [--build-release BUILD_RELEASE]
530 [--isolated]
531 [--koji-parent-build KOJI_PAR‐
532 ENT_BUILD]
533 [--scratch] [--arches [ARCHES ...]]
534 [--repo-url URL [URL ...]]
535 [--signing-intent SIGNING_INTENT]
536 [--skip-remote-rules-validation]
537 [--skip-build]
538 [--compose-id COMPOSE_ID [COMPOSE_ID
539 ...]]
540 [--replace-dependency PKG_MAN‐
541 AGER:NAME:VERSION[:NEW_NAME]
542 [PKG_MANAGER:NAME:VERSION[:NEW_NAME]
543 ...]]
544 Build a container
546 options:
548 -h, --help show this help message and exit
549 --target TARGET Override the default target
550 --nowait Don't wait on build
551 --background Run the build at a lower priority
552 --build-release BUILD_RELEASE
553 Specify a release value for this build's NVR
554 --isolated Do not update floating tags in the registry.
555 You must use the --build-release argument
556 --koji-parent-build KOJI_PARENT_BUILD
557 Specify a Koji NVR for the parent container
558 image. This will override the "FROM" value
559 in your Dockerfile.
560 --scratch Scratch build
561 --arches [ARCHES ...]
562 Limit a scratch or a isolated build to an
563 arch. May have multiple arches.
564 --repo-url URL [URL ...]
565 URLs of yum repo files
566 --signing-intent SIGNING_INTENT
567 Signing intent of the ODCS composes. If
568 specified, this must be one of the signing
569 intent names configured on the OSBS server.
570 If unspecified, the server will use the
571 signing intent of the compose_ids you
572 specify, or the server's
573 default_signing_intent. To view the full
574 list of possible names, see REACTOR_CONFIG
575 in orchestrator.log.
576 --skip-remote-rules-validation
577 Don't check if there's a valid gating.yaml
578 file in the repo
579 --skip-build Don't create build, but just modify settings
580 for autorebuilds
581 --compose-id COMPOSE_ID [COMPOSE_ID ...]
582 Use existing ODCS composes (specify
583 integers). Cannot be used with --signing-
584 intent.
585 --replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MAN‐
586 AGER:NAME:VERSION[:NEW_NAME] ...]
587 Cachito dependency replacement
588 centpkg container-build-setup
591 usage: centpkg container-build-setup [-h]
592 (--get-autorebuild | --set-au‐
593 torebuild {true,false})
594 set options for container-build.
596 options:
598 -h, --help show this help message and exit
599 --get-autorebuild Get autorebuild value
600 --set-autorebuild {true,false}
601 Turn autorebuilds on/off
602 centpkg copr-build
605 usage: centpkg copr-build [-h] [--config CONFIG] [--nowait] project
606 Build package in Copr.
608 Note: you need to have set up correct api key. For more information
610 see API KEY section of copr-cli(1) man page.
611 positional arguments:
613 project Name of the project in format USER/PROJECT
614 options:
616 -h, --help show this help message and exit
617 --config CONFIG Path to an alternative Copr configuration file
618 --nowait Don't wait on build
619 centpkg diff
622 usage: centpkg diff [-h] [--cached] [files ...]
623 Use git diff to show changes that have been made to tracked files.
625 By default cached changes (changes that have been git added) will
626 not be shown.
627 positional arguments:
629 files Optionally diff specific files
630 options:
632 -h, --help show this help message and exit
633 --cached View staged changes
634 centpkg flatpak-build
637 usage: centpkg flatpak-build [-h] [--target TARGET] [--nowait]
638 [--background]
639 [--build-release BUILD_RELEASE]
640 [--isolated]
641 [--koji-parent-build KOJI_PARENT_BUILD]
642 [--scratch] [--arches [ARCHES ...]]
643 [--repo-url URL [URL ...]]
644 [--signing-intent SIGNING_INTENT]
645 [--skip-remote-rules-validation]
646 [--skip-build]
647 Build a Flatpak
649 options:
651 -h, --help show this help message and exit
652 --target TARGET Override the default target
653 --nowait Don't wait on build
654 --background Run the build at a lower priority
655 --build-release BUILD_RELEASE
656 Specify a release value for this build's NVR
657 --isolated Do not update floating tags in the registry.
658 You must use the --build-release argument
659 --koji-parent-build KOJI_PARENT_BUILD
660 Specify a Koji NVR for the parent container
661 image. This will override the "FROM" value
662 in your Dockerfile.
663 --scratch Scratch build
664 --arches [ARCHES ...]
665 Limit a scratch or a isolated build to an
666 arch. May have multiple arches.
667 --repo-url URL [URL ...]
668 URLs of yum repo files
669 --signing-intent SIGNING_INTENT
670 Signing intent of the ODCS composes. If
671 specified, this must be one of the signing
672 intent names configured on the OSBS server.
673 If unspecified, the server will use the
674 signing intent of the compose_ids you
675 specify, or the server's
676 default_signing_intent. To view the full
677 list of possible names, see REACTOR_CONFIG
678 in orchestrator.log.
679 --skip-remote-rules-validation
680 Don't check if there's a valid gating.yaml
681 file in the repo
682 --skip-build Don't create build, but just modify settings
683 for autorebuilds
684 centpkg fork
687 usage: centpkg fork [-h]
688 Create a new fork of the current repository
690 Before the operation, you need to generate an API token at
692 https://gitlab.com/-/profile/personal_access_tokens, select the "api"
693 scope and save it in your local user configuration located
694 at ~/.config/rpkg/centpkg.conf. For example:
695 [centpkg.distgit]
697 token = <api_key_here>
698 Below is a basic example of the command to fork a current repository:
700 centpkg fork
702 options:
704 -h, --help show this help message and exit
705 centpkg gimmespec
708 usage: centpkg gimmespec [-h]
709 Print the spec file name.
711 options:
713 -h, --help show this help message and exit
714 centpkg gitbuildhash
717 usage: centpkg gitbuildhash [-h] build
718 This will show you the commit hash string used to build the provided
720 build n-v-r
721 positional arguments:
723 build name-version-release of the build to query.
724 options:
726 -h, --help show this help message and exit
727 centpkg giturl
730 usage: centpkg giturl [-h]
731 This will show you which git URL would be used in a build command.
733 It uses the git hashsum of the HEAD of the current branch (which may
734 not be pushed).
735 options:
737 -h, --help show this help message and exit
738 centpkg help
741 usage: centpkg help [-h]
742 Show usage.
744 options:
746 -h, --help show this help message and exit
747 centpkg import
750 usage: centpkg import [-h] [--skip-diffs] [--offline] srpm
751 This will extract sources, patches, and the spec file from an srpm
753 and update the current module accordingly. It will import to the
754 current branch by default.
755 positional arguments:
757 srpm Source rpm to import
758 options:
760 -h, --help show this help message and exit
761 --skip-diffs Don't show diffs when import srpms
762 --offline Do not upload files into lookaside cache
763 centpkg install
766 usage: centpkg install [-h] [--builddir BUILDDIR]
767 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
768 [--define DEFINE] [--short-circuit]
769 [--nocheck]
770 ...
771 This will call rpmbuild to run the install section. All leading
773 sections will be processed as well, unless the short-circuit option
774 is used.
775 positional arguments:
777 extra_args Custom arguments that are passed to the
778 'rpmbuild'. Use '--' to separate them from
779 other arguments.
780 options:
782 -h, --help show this help message and exit
783 --builddir BUILDDIR Define an alternate builddir
784 --buildrootdir BUILDROOTDIR
785 Define an alternate buildrootdir
786 --arch ARCH Prep for a specific arch
787 --define DEFINE Pass custom macros to rpmbuild, may specify
788 multiple times
789 --short-circuit short-circuit install
790 --nocheck nocheck install
791 centpkg lint
794 usage: centpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
795 Rpmlint can be configured using the --rpmlintconf/-r option or by
797 setting a <pkgname>.rpmlintrc file in the working directory
798 options:
800 -h, --help show this help message and exit
801 --info, -i Display explanations for reported messages
802 --rpmlintconf RPMLINTCONF, -r RPMLINTCONF
803 Use a specific configuration file for
804 rpmlint
805 centpkg list-side-tags
808 usage: centpkg list-side-tags [-h]
809 [--mine | --user TAG_OWNER | --base-tag
810 BASE_TAG]
811 List existing side-tags.
813 options:
815 -h, --help show this help message and exit
816 --mine List only my side tags
817 --user TAG_OWNER List side tags created by this user
818 --base-tag BASE_TAG List only tags based on this base
819 centpkg local
822 usage: centpkg local [-h] [--builddir BUILDDIR]
823 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
824 [--define DEFINE] [--md5] [--with BCOND_WITH]
825 [--without BCOND_WITHOUT]
826 ...
827 Locally test run of rpmbuild producing binary RPMs. The rpmbuild
829 output will be logged into a file named
830 .build-%{version}-%{release}.log
831 positional arguments:
833 extra_args Custom arguments that are passed to the
834 'rpmbuild'. Use '--' to separate them from
835 other arguments.
836 options:
838 -h, --help show this help message and exit
839 --builddir BUILDDIR Define an alternate builddir
840 --buildrootdir BUILDROOTDIR
841 Define an alternate buildrootdir
842 --arch ARCH Prep for a specific arch
843 --define DEFINE Pass custom macros to rpmbuild, may specify
844 multiple times
845 --md5 Use md5 checksums (for older rpm hosts)
846 --with BCOND_WITH Enable configure option (bcond) for the
847 build
848 --without BCOND_WITHOUT
849 Disable configure option (bcond) for the
850 build
851 centpkg mock-config
854 usage: centpkg mock-config [-h] [--target TARGET] [--arch ARCH]
855 This will generate a mock config based on the buildsystem target
857 options:
859 -h, --help show this help message and exit
860 --target TARGET Override target used for config
861 --arch ARCH Override local arch
862 centpkg mockbuild
865 usage: centpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean]
866 [--no-cleanup-after] [--no-clean-all]
867 [--with BCOND_WITH]
868 [--without BCOND_WITHOUT] [--shell]
869 [--enablerepo ENABLEREPO]
870 [--disablerepo DISABLEREPO]
871 [--enable-network] [--srpm-mock]
872 [--use-koji-mock-config | --use-local-mock-
873 config]
874 ...
875 This will use the mock utility to build the package for the
877 distribution detected from branch information. This can be
878 overridden using the global --release option. Your user must be in
879 the local "mock" group.
880 positional arguments:
882 extra_args Custom arguments that are passed to the
883 'mock'. Use '--' to separate them from other
884 arguments.
885 options:
887 -h, --help show this help message and exit
888 --root CONFIG, --mock-config CONFIG
889 Override mock configuration (like mock -r)
890 --md5 Use md5 checksums (for older rpm hosts)
891 --no-clean, -n Do not clean chroot before building package
892 --no-cleanup-after Do not clean chroot after building (if
893 automatic cleanup is enabled
894 --no-clean-all, -N Alias for both --no-clean and --no-cleanup-
895 after
896 --with BCOND_WITH Enable configure option (bcond) for the
897 build
898 --without BCOND_WITHOUT
899 Disable configure option (bcond) for the
900 build
901 --shell Run commands interactively within chroot.
902 Before going into chroot, mockbuild needs to
903 run with --no-cleanup-after in advanced.
904 --enablerepo ENABLEREPO
905 Pass enablerepo option to yum/dnf (may be
906 used more than once)
907 --disablerepo DISABLEREPO
908 Pass disablerepo option to yum/dnf (may be
909 used more than once)
910 --enable-network Enable networking
911 --srpm-mock Generate source rpm with 'mock' and then run
912 'mockbuild' using this source rpm
913 --use-koji-mock-config
914 Download Mock configuration from Kojihub,
915 instead of using the local Mock
916 configuration in mock-core-configs.rpm.
917 --use-local-mock-config
918 Enforce use of local Mock configuration.
919 If config file for mock isn't found in the /etc/mock directory, a
921 temporary config directory for mock is created and populated with a
922 config file created with mock-config.
923 centpkg module-build
926 usage: centpkg module-build [-h] [--watch]
927 [--buildrequires name:stream]
928 [--requires name:stream]
929 [--optional key=value]
930 [--file [FILE_PATH]] [--srpm SRPMS]
931 [--scratch]
932 [scm_url] [branch]
933 Build a module using MBS
935 positional arguments:
937 scm_url The module's SCM URL. This defaults to the
938 current repo.
939 branch The module's SCM branch. This defaults to
940 the current checked-out branch.
941 options:
943 -h, --help show this help message and exit
944 --watch, -w Watch the module build
945 --buildrequires name:stream
946 Buildrequires to override in the form of
947 "name:stream"
948 --requires name:stream
949 Requires to override in the form of
950 "name:stream"
951 --optional key=value MBS optional arguments in the form of
952 "key=value". For example: 'centpkg module-
953 build --optional
954 "reuse_components_from=<NSVC>"'. More
955 description including list of available
956 arguments here: https://pagure.io/fm-
957 orchestrator/
958 --file [FILE_PATH] The modulemd yaml file for module scratch
959 build.
960 --srpm SRPMS Include one or more srpms for module scratch
961 build.
962 --scratch Perform a scratch build
963 centpkg module-build-cancel
966 usage: centpkg module-build-cancel [-h] build_id
967 Cancel an MBS module build
969 positional arguments:
971 build_id The ID of the module build to cancel
972 options:
974 -h, --help show this help message and exit
975 centpkg module-build-info
978 usage: centpkg module-build-info [-h] build_id
979 Show information of an MBS module build
981 positional arguments:
983 build_id The ID of the module build
984 options:
986 -h, --help show this help message and exit
987 centpkg module-build-local
990 usage: centpkg module-build-local [-h] [--file [FILE_PATH]]
991 [--srpm SRPMS] [--stream [STREAM]]
992 [--skip-tests]
993 [--add-local-build N:S:V] [-s N:S]
994 [--offline] [-r PATH]
995 Build a module locally using the mbs-manager command
997 options:
999 -h, --help show this help message and exit
1000 --file [FILE_PATH] The module's modulemd yaml file. If not
1001 specified, a yaml file with the same
1002 basename as the name of the repository will
1003 be used.
1004 --srpm SRPMS Include one or more srpms for module build.
1005 --stream [STREAM] The module's stream/SCM branch. This
1006 defaults to the current checked-out branch.
1007 --skip-tests Adds a macro for skipping the check section
1008 --add-local-build N:S:V
1009 Import previously finished local module
1010 builds into MBS in the format of name:stream
1011 or name:stream:version
1012 -s N:S, --set-default-stream N:S
1013 Set the default stream for given module
1014 dependency in case there are multiple
1015 streams to choose from.
1016 --offline Builds module offline without any external
1017 infrastructure
1018 -r PATH, --repository PATH
1019 Full path to .repo file defining the base
1020 module repository to use when --offline is
1021 used.
1022 centpkg module-build-watch
1025 usage: centpkg module-build-watch [-h] build_id [build_id ...]
1026 Watch an MBS build
1028 positional arguments:
1030 build_id The ID of the module build to watch
1031 options:
1033 -h, --help show this help message and exit
1034 centpkg module-overview
1037 usage: centpkg module-overview [-h] [--unfinished] [--limit LIMIT]
1038 [--owner FAS_ID | --mine]
1039 Shows an overview of MBS builds
1041 options:
1043 -h, --help show this help message and exit
1044 --unfinished Show unfinished module builds
1045 --limit LIMIT The number of most recent module builds to display
1046 --owner FAS_ID List only items of that owner
1047 --mine Use current Kerberos name or username
1048 centpkg module-scratch-build
1051 usage: centpkg module-scratch-build [-h] [--watch]
1052 [--buildrequires name:stream]
1053 [--requires name:stream]
1054 [--optional key=value]
1055 [--file [FILE_PATH]]
1056 [--srpm SRPMS]
1057 [scm_url] [branch]
1058 Build a scratch module using MBS
1060 positional arguments:
1062 scm_url The module's SCM URL. This defaults to the
1063 current repo.
1064 branch The module's SCM branch. This defaults to
1065 the current checked-out branch.
1066 options:
1068 -h, --help show this help message and exit
1069 --watch, -w Watch the module build
1070 --buildrequires name:stream
1071 Buildrequires to override in the form of
1072 "name:stream"
1073 --requires name:stream
1074 Requires to override in the form of
1075 "name:stream"
1076 --optional key=value MBS optional arguments in the form of
1077 "key=value". For example: 'centpkg module-
1078 build --optional
1079 "reuse_components_from=<NSVC>"'. More
1080 description including list of available
1081 arguments here: https://pagure.io/fm-
1082 orchestrator/
1083 --file [FILE_PATH] The modulemd yaml file for module scratch
1084 build.
1085 --srpm SRPMS Include one or more srpms for module scratch
1086 build.
1087 centpkg new
1090 usage: centpkg new [-h]
1091 This will use git to show a diff of all the changes (even
1093 uncommitted changes) since the last git tag was applied.
1094 options:
1096 -h, --help show this help message and exit
1097 centpkg new-sources
1100 usage: centpkg new-sources [-h] [--offline] files [files ...]
1101 This will upload new source file(s) to lookaside cache, and all file
1103 names listed in sources file will be replaced. .gitignore will be
1104 also updated with new uploaded file(s). Please remember to commit
1105 them.
1106 positional arguments:
1108 files
1109 options:
1111 -h, --help show this help message and exit
1112 --offline Do all the steps except uploading into lookaside cache
1113 centpkg patch
1116 usage: centpkg patch [-h] [--rediff] suffix
1117 Create and add a gendiff patch file.
1119 positional arguments:
1121 suffix Look for files with this suffix to diff
1122 options:
1124 -h, --help show this help message and exit
1125 --rediff Recreate gendiff file retaining comments Saves old
1126 patch file with a suffix of ~
1127 Patch file will be named: package-version-suffix.patch and the file
1129 will be added to the repo index
1130 centpkg prep
1133 usage: centpkg prep [-h] [--builddir BUILDDIR]
1134 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1135 [--define DEFINE]
1136 ...
1137 Use rpmbuild to "prep" the sources (unpack the source archive(s) and
1139 apply any patches.)
1140 positional arguments:
1142 extra_args Custom arguments that are passed to the
1143 'rpmbuild'. Use '--' to separate them from
1144 other arguments.
1145 options:
1147 -h, --help show this help message and exit
1148 --builddir BUILDDIR Define an alternate builddir
1149 --buildrootdir BUILDROOTDIR
1150 Define an alternate buildrootdir
1151 --arch ARCH Prep for a specific arch
1152 --define DEFINE Pass custom macros to rpmbuild, may specify
1153 multiple times
1154 centpkg pull
1157 usage: centpkg pull [-h] [--rebase] [--no-rebase]
1158 This command uses git to fetch remote changes and apply them to the
1160 current working copy. A rebase option is available which can be used
1161 to avoid merges.
1162 options:
1164 -h, --help show this help message and exit
1165 --rebase Rebase the locally committed changes on top of the
1166 remote changes after fetching. This can avoid a merge
1167 commit, but does rewrite local history.
1168 --no-rebase Do not rebase, overriding .git settings to the
1169 contrary
1170 See git pull --help for more details
1172 centpkg push
1175 usage: centpkg push [-h] [--force]
1176 Push changes to remote repository.
1178 options:
1180 -h, --help show this help message and exit
1181 --force, -f Force push
1182 centpkg remote
1185 usage: centpkg remote [-h] {add} ...
1186 Operations with tracked repositories ('remotes'). This is an
1188 experimental interface.
1189 options:
1191 -h, --help show this help message and exit
1192 subcommands:
1194 Operations with tracked repositories ('remotes'). This is an
1195 experimental interface. Please note that some or all current
1196 functionality is subject to change. Without parameters list of
1197 remotes will be shown.
1198 {add}
1200 centpkg remove-side-tag
1203 usage: centpkg remove-side-tag [-h] TAG
1204 Remove a side tag (without merging packages).
1206 positional arguments:
1208 TAG name of tag to be deleted
1209 options:
1211 -h, --help show this help message and exit
1212 centpkg request-gated-side-tag
1215 usage: centpkg request-gated-side-tag [-h] [--base-tag BASE_TAG]
1216 Create a new dynamic gated side tag.
1218 options:
1220 -h, --help show this help message and exit
1221 --base-tag BASE_TAG name of base tag
1222 centpkg request-side-tag
1225 usage: centpkg request-side-tag [-h] [--base-tag BASE_TAG]
1226 [--suffix SUFFIX]
1227 Create a new side tag.
1229 options:
1231 -h, --help show this help message and exit
1232 --base-tag BASE_TAG name of base tag
1233 --suffix SUFFIX A suffix to be appended to the side tag name.
1234 The suffix must be allowed in Koji
1235 configuration.
1236 centpkg retire
1239 usage: centpkg retire [-h] reason
1240 This command will remove all files from the repo, leave a
1242 dead.package file for rpms or dead.module file for modules, and push
1243 the changes.
1244 positional arguments:
1246 reason Reason for retiring the package/module
1247 options:
1249 -h, --help show this help message and exit
1250 centpkg scratch-build
1253 usage: centpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5]
1254 [--nowait] [--target TARGET]
1255 [--background] [--fail-fast]
1256 [--skip-remote-rules-validation]
1257 [--skip-nvr-check]
1258 [--custom-user-metadata CUS‐
1259 TOM_USER_METADATA]
1260 [--srpm [SRPM]] [--srpm-mock]
1261 This command will request a scratch build of the package. Without
1263 providing an srpm, it will attempt to build the latest commit, which
1264 must have been pushed. By default all appropriate arches will be
1265 built.
1266 options:
1268 -h, --help show this help message and exit
1269 --arches [ARCHES ...]
1270 Build for specific arches
1271 --md5 Use md5 checksums (for older rpm hosts)
1272 --nowait Don't wait on build
1273 --target TARGET Define build target to build into
1274 --background Run the build at a low priority
1275 --fail-fast Fail the build immediately if any arch fails
1276 --skip-remote-rules-validation
1277 Don't check if there's a valid gating.yaml
1278 file in the repo, where you can define
1279 additional policies for Greenwave gating.
1280 --skip-nvr-check Submit build to buildsystem without check if
1281 NVR was already built. NVR is constructed
1282 locally and may be different from NVR
1283 constructed during build on builder.
1284 --custom-user-metadata CUSTOM_USER_METADATA
1285 Provide a JSON string of custom metadata to
1286 be deserialized and stored under the build's
1287 extra.custom_user_metadata field
1288 --srpm [SRPM] Build from an srpm. If no srpm is provided
1289 with this option an srpm will be generated
1290 from the current module content.
1291 --srpm-mock Build from an srpm. Source rpm will be
1292 generated in 'mock' instead of 'rpmbuild'.
1293 centpkg sources
1296 usage: centpkg sources [-h] [--outdir OUTDIR]
1297 Download source files
1299 options:
1301 -h, --help show this help message and exit
1302 --outdir OUTDIR Directory to download files into (defaults to
1303 pwd)
1304 centpkg srpm
1307 usage: Create a source rpm
1308 This command wraps "rpmbuild -bs", roughly equivalent to:
1310 rpmbuild -bs mypackage.spec --define "_topdir ." --de‐
1312 fine "_sourcedir ." --define "_srcrpmdir ." --define "dist
1313 .el8"
1314 To include files in the SRPM, the files must be in the current
1316 working directory (this depends on the package layout used),
1317 and you must reference each file with SourceXXXX: or PatchXXXX:
1318 directives in your .spec file.
1319 positional arguments:
1321 extra_args Custom arguments that are passed to the
1322 'rpmbuild'. Use '--' to separate them from
1323 other arguments.
1324 options:
1326 -h, --help show this help message and exit
1327 --builddir BUILDDIR Define an alternate builddir
1328 --buildrootdir BUILDROOTDIR
1329 Define an alternate buildrootdir
1330 --arch ARCH Prep for a specific arch
1331 --define DEFINE Pass custom macros to rpmbuild, may specify
1332 multiple times
1333 --md5 Use md5 checksums (for older rpm hosts)
1334 --srpm-mock Create source rpm in 'mock' instead of
1335 'rpmbuild'
1336 --no-clean, -n Only for --srpm-mock: Do not clean chroot
1337 before building package
1338 --no-cleanup-after Only for --srpm-mock: Do not clean chroot
1339 after building if automatic cleanup is
1340 enabled
1341 --no-clean-all, -N Only for --srpm-mock: Alias for both --no-
1342 clean and --no-cleanup-after
1343 centpkg switch-branch
1346 usage: centpkg switch-branch [-h] [-l] [--fetch] [branch]
1347 This command can switch to a local git branch. If provided with a
1349 remote branch name that does not have a local match it will create
1350 one. It can also be used to list the existing local and remote
1351 branches.
1352 positional arguments:
1354 branch Branch name to switch to
1355 options:
1357 -h, --help show this help message and exit
1358 -l, --list List both remote-tracking branches and local branches
1359 --fetch Fetch new data from remote before switch
1360 centpkg tag
1363 usage: centpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE]
1364 [-l] [-d]
1365 [tag]
1366 This command uses git to create, list, or delete tags.
1368 positional arguments:
1370 tag Name of the tag
1371 options:
1373 -h, --help show this help message and exit
1374 -f, --force Force the creation of the tag
1375 -m MESSAGE, --message MESSAGE
1376 Use the given <msg> as the tag message
1377 -c, --clog Generate the tag message from the spec
1378 changelog section
1379 --raw Make the clog raw
1380 -F FILE, --file FILE Take the tag message from the given file
1381 -l, --list List all tags with a given pattern, or all
1382 if not pattern is given
1383 -d, --delete Delete a tag
1384 centpkg unused-patches
1387 usage: centpkg unused-patches [-h]
1388 Print list of patches not referenced by name in the specfile.
1390 options:
1392 -h, --help show this help message and exit
1393 centpkg upload
1396 usage: centpkg upload [-h] [--offline] files [files ...]
1397 This command will upload new source file(s) to lookaside cache.
1399 Source file names are appended to sources file, and .gitignore will
1400 be also updated with new uploaded file(s). Please remember to commit
1401 them.
1402 positional arguments:
1404 files
1405 options:
1407 -h, --help show this help message and exit
1408 --offline Do all the steps except uploading into lookaside cache
1409 centpkg verify-files
1412 usage: centpkg verify-files [-h] [--builddir BUILDDIR]
1413 [--buildrootdir BUILDROOTDIR]
1414 [--arch ARCH] [--define DEFINE]
1415 ...
1416 Locally run 'rpmbuild -bl' to verify the spec file's %files
1418 sections. This requires a successful run of 'centpkg install' in
1419 advance.
1420 positional arguments:
1422 extra_args Custom arguments that are passed to the
1423 'rpmbuild'. Use '--' to separate them from
1424 other arguments.
1425 options:
1427 -h, --help show this help message and exit
1428 --builddir BUILDDIR Define an alternate builddir
1429 --buildrootdir BUILDROOTDIR
1430 Define an alternate buildrootdir
1431 --arch ARCH Prep for a specific arch
1432 --define DEFINE Pass custom macros to rpmbuild, may specify
1433 multiple times
1434 centpkg verrel
1437 usage: centpkg verrel [-h]
1438 Print the name-version-release.
1440 options:
1442 -h, --help show this help message and exit
1443
1446 https://git.centos.org/centos/centpkg
1447 2022-12-16 centpkg(1)