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
19 centpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait] [--target
20 TARGET] [--background] [--fail-fast] [--skip-remote-rules-validation]
21 [--skip-nvr-check] [--skip-tag] [--scratch] [--srpm [SRPM]]
22 Request build
23 centpkg chain-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
25 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
26 validation] [--skip-nvr-check] package [package ...]
27 Build current package in order with other packages
28 centpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t] [-F
30 FILE] [-p] [-s] [files ...]
31 Alias for commit
32 centpkg clean [-h] [--dry-run] [-x]
34 Remove untracked files
35 centpkg clog [-h] [--raw]
37 Make a clog file containing top changelog entry
38 centpkg clone [-h] [--branches] [--branch BRANCH] [--anonymous]
40 [--depth DEPTH] repo [clone_target] ...
41 Clone and checkout a repository
42 centpkg co [-h] [--branches] [--branch BRANCH] [--anonymous] [--depth
44 DEPTH] repo [clone_target] ...
45 Alias for clone
46 centpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t]
48 [-F FILE] [-p] [-s] [files ...]
49 Commit changes
50 centpkg compile [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOT‐
52 DIR] [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
53 Local test rpmbuild compile
54 centpkg container-build [-h] [--target TARGET] [--nowait] [--build-re‐
56 lease BUILD_RELEASE] [--isolated] [--koji-parent-build KOJI_PAR‐
57 ENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--repo-url URL [URL
58 ...]] [--signing-intent SIGNING_INTENT] [--skip-remote-rules-valida‐
59 tion] [--skip-build] [--compose-id COMPOSE_ID [COMPOSE_ID ...]] [--re‐
60 place-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MAN‐
61 AGER:NAME:VERSION[:NEW_NAME] ...]]
62 Build a container
63 centpkg container-build-setup [-h] (--get-autorebuild | --set-autore‐
65 build {true,false})
66 set options for container-build
67 centpkg copr-build [-h] [--config CONFIG] [--nowait] project
69 Build package in Copr
70 centpkg diff [-h] [--cached] [files ...]
72 Show changes between commits, commit and working tree, etc
73 centpkg flatpak-build [-h] [--target TARGET] [--nowait] [--build-re‐
75 lease BUILD_RELEASE] [--isolated] [--koji-parent-build KOJI_PAR‐
76 ENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--repo-url URL [URL
77 ...]] [--signing-intent SIGNING_INTENT] [--skip-remote-rules-valida‐
78 tion] [--skip-build]
79 Build a Flatpak
80 centpkg fork [-h]
82 Create a new fork of the current repository
83 centpkg gimmespec [-h]
85 Print the spec file name
86 centpkg gitbuildhash [-h] build
88 Print the git hash used to build the provided n-v-r
89 centpkg giturl [-h]
91 Print the git url for building
92 centpkg help [-h]
94 Show usage
95 centpkg import [-h] [--skip-diffs] [--offline] srpm
97 Import srpm content into a module
98 centpkg install [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOT‐
100 DIR] [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
101 Local test rpmbuild install
102 centpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
104 Run rpmlint against local spec and build output if present.
105 centpkg list-side-tags [-h] [--mine | --user TAG_OWNER | --base-tag
107 BASE_TAG]
108 List existing side-tags
109 centpkg local [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
111 [--arch ARCH] [--define DEFINE] [--md5] [--with BCOND_WITH] [--without
112 BCOND_WITHOUT] ...
113 Local test rpmbuild binary
114 centpkg mock-config [-h] [--target TARGET] [--arch ARCH]
116 Generate a mock config
117 centpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean] [--no-
119 cleanup-after] [--no-clean-all] [--with BCOND_WITH] [--without
120 BCOND_WITHOUT] [--shell] [--enablerepo ENABLEREPO] [--disablerepo DIS‐
121 ABLEREPO] [--enable-network] ...
122 Local test build using mock
123 centpkg module-build [-h] [--watch] [--buildrequires name:stream]
125 [--requires name:stream] [--optional key=value] [--file [FILE_PATH]]
126 [--srpm SRPMS] [--scratch] [scm_url] [branch]
127 Build a module using MBS
128 centpkg module-build-cancel [-h] build_id
130 Cancel an MBS module build
131 centpkg module-build-info [-h] build_id
133 Show information of an MBS module build
134 centpkg module-build-local [-h] [--file [FILE_PATH]] [--srpm SRPMS]
136 [--stream [STREAM]] [--skip-tests] [--add-local-build N:S:V] [-s N:S]
137 [--offline] [-r PATH]
138 Build a module locally using the mbs-manager command
139 centpkg module-build-watch [-h] build_id [build_id ...]
141 Watch an MBS build
142 centpkg module-overview [-h] [--unfinished] [--limit LIMIT] [--owner
144 FAS_ID | --mine]
145 Shows an overview of MBS builds
146 centpkg module-scratch-build [-h] [--watch] [--buildrequires
148 name:stream] [--requires name:stream] [--optional key=value] [--file
149 [FILE_PATH]] [--srpm SRPMS] [scm_url] [branch]
150 Build a scratch module using MBS
151 centpkg new [-h]
153 Diff against last tag
154 centpkg new-sources [-h] [--offline] files [files ...]
156 Upload source files
157 centpkg patch [-h] [--rediff] suffix
159 Create and add a gendiff patch file
160 centpkg prep [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
162 [--arch ARCH] [--define DEFINE] ...
163 Local test rpmbuild prep
164 centpkg pull [-h] [--rebase] [--no-rebase]
166 Pull changes from the remote repository and update the working
167 copy.
168 centpkg push [-h] [--force]
170 Push changes to remote repository
171 centpkg remote [-h] {add} ...
173 Operations with tracked repositories ('remotes'). This is an ex‐
174 perimental interface.
175 centpkg remove-side-tag [-h] TAG
177 Remove a side tag (without merging packages)
178 centpkg request-gated-side-tag [-h] [--base-tag BASE_TAG]
180 Create a new dynamic gated side tag
181 centpkg request-side-tag [-h] [--base-tag BASE_TAG] [--suffix SUFFIX]
183 Create a new side tag
184 centpkg retire [-h] reason
186 Retire a package/module
187 centpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
189 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
190 validation] [--skip-nvr-check] [--srpm [SRPM]]
191 Request scratch build
192 centpkg sources [-h] [--outdir OUTDIR]
194 Download source files
195 centpkg srpm [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
197 [--arch ARCH] [--define DEFINE] [--md5] ...
198 Create a source rpm
199 centpkg switch-branch [-h] [-l] [--fetch] [branch]
201 Work with branches
202 centpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l] [-d]
204 [tag]
205 Management of git tags
206 centpkg unused-patches [-h]
208 Print list of patches not referenced by name in the specfile
209 centpkg upload [-h] [--offline] files [files ...]
211 Upload source files
212 centpkg verify-files [-h] [--builddir BUILDDIR] [--buildrootdir BUILD‐
214 ROOTDIR] [--arch ARCH] [--define DEFINE] ...
215 Locally verify %%files section
216 centpkg verrel [-h]
218 Print the name-version-release.
219
221 centpkg build
222 usage: centpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
223 [--target TARGET] [--background] [--fail-fast]
224 [--skip-remote-rules-validation]
225 [--skip-nvr-check] [--skip-tag] [--scratch]
226 [--srpm [SRPM]]
227 This command requests a build of the package in the build system. By
229 default it discovers the target to build for based on branch data,
230 and uses the latest commit as the build source.
231 options:
233 -h, --help show this help message and exit
234 --arches [ARCHES ...]
235 Build for specific arches
236 --md5 Use md5 checksums (for older rpm hosts)
237 --nowait Don't wait on build
238 --target TARGET Define build target to build into
239 --background Run the build at a low priority
240 --fail-fast Fail the build immediately if any arch fails
241 --skip-remote-rules-validation
242 Don't check if there's a valid gating.yaml
243 file in the repo, where you can define
244 additional policies for Greenwave gating.
245 --skip-nvr-check Submit build to buildsystem without check if
246 NVR was already built. NVR is constructed
247 locally and may be different from NVR
248 constructed during build on builder.
249 --skip-tag Do not attempt to tag package
250 --scratch Perform a scratch build
251 --srpm [SRPM] Build from an srpm. If no srpm is provided
252 with this option an srpm will be generated
253 from current module content.
254 centpkg chain-build
257 usage: centpkg chain-build [-h] [--arches [ARCHES ...]] [--md5]
258 [--nowait] [--target TARGET]
259 [--background] [--fail-fast]
260 [--skip-remote-rules-validation]
261 [--skip-nvr-check]
262 package [package ...]
263 Build current package in order with other packages.
265 example: centpkg chain-build libwidget libgizmo
267 The current package is added to the end of the CHAIN list.
269 Colons (:) can be used in the CHAIN parameter to define groups of
270 packages. Packages in any single group will be built in parallel
271 and all packages in a group must build successfully and populate
272 the repository before the next group will begin building.
273 For example:
275 centpkg chain-build libwidget libaselib : libgizmo :
277 will cause libwidget and libaselib to be built in parallel, followed
279 by libgizmo and then the current directory package. If no groups are
280 defined, packages will be built sequentially.
281 positional arguments:
283 package List the packages and order you want to
284 build in
285 options:
287 -h, --help show this help message and exit
288 --arches [ARCHES ...]
289 Build for specific arches
290 --md5 Use md5 checksums (for older rpm hosts)
291 --nowait Don't wait on build
292 --target TARGET Define build target to build into
293 --background Run the build at a low priority
294 --fail-fast Fail the build immediately if any arch fails
295 --skip-remote-rules-validation
296 Don't check if there's a valid gating.yaml
297 file in the repo, where you can define
298 additional policies for Greenwave gating.
299 --skip-nvr-check Submit build to buildsystem without check if
300 NVR was already built. NVR is constructed
301 locally and may be different from NVR
302 constructed during build on builder.
303 centpkg ci
306 usage: centpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw]
307 [-t] [-F FILE] [-p] [-s]
308 [files ...]
309 Alias for commit.
311 positional arguments:
313 files Optional list of specific files to commit
314 options:
316 -h, --help show this help message and exit
317 -m MESSAGE, --message MESSAGE
318 Use the given <msg> as the commit message
319 summary
320 --with-changelog Get the last changelog from SPEC as commit
321 message content. This option must be used
322 with -m together.
323 -c, --clog Generate the commit message from the
324 Changelog section
325 --raw Make the clog raw
326 -t, --tag Create a tag for this commit
327 -F FILE, --file FILE Take the commit message from the given file
328 -p, --push Commit and push as one action
329 -s, --signoff Include a signed-off-by
330 centpkg clean
333 usage: centpkg clean [-h] [--dry-run] [-x]
334 This command can be used to clean up your working directory. By
336 default it will follow .gitignore rules. Patterns listed in
337 .git/info/exclude won'tbe removed either.
338 options:
340 -h, --help show this help message and exit
341 --dry-run, -n Perform a dry-run
342 -x Do not follow .gitignore and .git/info/exclude
343 rules
344 centpkg clog
347 usage: centpkg clog [-h] [--raw]
348 This will create a file named "clog" that contains the latest rpm
350 changelog entry. The leading "- " text will be stripped.
351 options:
353 -h, --help show this help message and exit
354 --raw Generate a more "raw" clog without twiddling the
355 contents
356 centpkg clone
359 usage: centpkg clone [-h] [--branches] [--branch BRANCH]
360 [--anonymous] [--depth DEPTH]
361 repo [clone_target] ...
362 This command will clone the named repository from the configured
364 repository base URL. By default it will also checkout the master
365 branch for your working copy.
366 positional arguments:
368 repo Name of the repository to clone. It should
369 not be a Git URL. Should be 'namespace/repo-
370 name' in case of namespaced dist-git.
371 Otherwise, just 'repo-name'. Namespace
372 examples are 'rpms', 'container', 'modules',
373 'flatpaks'. Default namespace 'rpms' can be
374 ignored.
375 clone_target Directory in which to clone the repository
376 extra_args Custom arguments that are passed to the 'git
377 clone'. Use '--' to separate them from other
378 arguments.
379 options:
381 -h, --help show this help message and exit
382 --branches, -B Do an old style checkout with subdirs for
383 branches
384 --branch BRANCH, -b BRANCH
385 Check out a specific branch
386 --anonymous, -a Check out a module anonymously
387 --depth DEPTH Create a shallow clone with a history
388 truncated to the specified number of commits
389 centpkg co
392 usage: centpkg co [-h] [--branches] [--branch BRANCH] [--anonymous]
393 [--depth DEPTH]
394 repo [clone_target] ...
395 Alias for clone.
397 positional arguments:
399 repo Name of the repository to clone. It should
400 not be a Git URL. Should be 'namespace/repo-
401 name' in case of namespaced dist-git.
402 Otherwise, just 'repo-name'. Namespace
403 examples are 'rpms', 'container', 'modules',
404 'flatpaks'. Default namespace 'rpms' can be
405 ignored.
406 clone_target Directory in which to clone the repository
407 extra_args Custom arguments that are passed to the 'git
408 clone'. Use '--' to separate them from other
409 arguments.
410 options:
412 -h, --help show this help message and exit
413 --branches, -B Do an old style checkout with subdirs for
414 branches
415 --branch BRANCH, -b BRANCH
416 Check out a specific branch
417 --anonymous, -a Check out a module anonymously
418 --depth DEPTH Create a shallow clone with a history
419 truncated to the specified number of commits
420 centpkg commit
423 usage: centpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c]
424 [--raw] [-t] [-F FILE] [-p] [-s]
425 [files ...]
426 This invokes a git commit. All tracked files with changes will be
428 committed unless a specific file list is provided. $EDITOR will be
429 used to generate a changelog message unless one is given to the
430 command. A push can be done at the same time.
431 positional arguments:
433 files Optional list of specific files to commit
434 options:
436 -h, --help show this help message and exit
437 -m MESSAGE, --message MESSAGE
438 Use the given <msg> as the commit message
439 summary
440 --with-changelog Get the last changelog from SPEC as commit
441 message content. This option must be used
442 with -m together.
443 -c, --clog Generate the commit message from the
444 Changelog section
445 --raw Make the clog raw
446 -t, --tag Create a tag for this commit
447 -F FILE, --file FILE Take the commit message from the given file
448 -p, --push Commit and push as one action
449 -s, --signoff Include a signed-off-by
450 centpkg compile
453 usage: centpkg compile [-h] [--builddir BUILDDIR]
454 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
455 [--define DEFINE] [--short-circuit]
456 [--nocheck]
457 ...
458 This command calls rpmbuild to compile the source. By default the
460 prep and configure stages will be done as well, unless the short-
461 circuit option is used.
462 positional arguments:
464 extra_args Custom arguments that are passed to the
465 'rpmbuild'. Use '--' to separate them from
466 other arguments.
467 options:
469 -h, --help show this help message and exit
470 --builddir BUILDDIR Define an alternate builddir
471 --buildrootdir BUILDROOTDIR
472 Define an alternate buildrootdir
473 --arch ARCH Prep for a specific arch
474 --define DEFINE Pass custom macros to rpmbuild, may specify
475 multiple times
476 --short-circuit short-circuit compile
477 --nocheck nocheck compile
478 centpkg container-build
481 usage: centpkg container-build [-h] [--target TARGET] [--nowait]
482 [--build-release BUILD_RELEASE]
483 [--isolated]
484 [--koji-parent-build KOJI_PAR‐
485 ENT_BUILD]
486 [--scratch] [--arches [ARCHES ...]]
487 [--repo-url URL [URL ...]]
488 [--signing-intent SIGNING_INTENT]
489 [--skip-remote-rules-validation]
490 [--skip-build]
491 [--compose-id COMPOSE_ID [COMPOSE_ID
492 ...]]
493 [--replace-dependency PKG_MAN‐
494 AGER:NAME:VERSION[:NEW_NAME]
495 [PKG_MANAGER:NAME:VERSION[:NEW_NAME]
496 ...]]
497 Build a container
499 options:
501 -h, --help show this help message and exit
502 --target TARGET Override the default target
503 --nowait Don't wait on build
504 --build-release BUILD_RELEASE
505 Specify a release value for this build's NVR
506 --isolated Do not update floating tags in the registry.
507 You must use the --build-release argument
508 --koji-parent-build KOJI_PARENT_BUILD
509 Specify a Koji NVR for the parent container
510 image. This will override the "FROM" value
511 in your Dockerfile.
512 --scratch Scratch build
513 --arches [ARCHES ...]
514 Limit a scratch or a isolated build to an
515 arch. May have multiple arches.
516 --repo-url URL [URL ...]
517 URLs of yum repo files
518 --signing-intent SIGNING_INTENT
519 Signing intent of the ODCS composes. If
520 specified, this must be one of the signing
521 intent names configured on the OSBS server.
522 If unspecified, the server will use the
523 signing intent of the compose_ids you
524 specify, or the server's
525 default_signing_intent. To view the full
526 list of possible names, see REACTOR_CONFIG
527 in orchestrator.log.
528 --skip-remote-rules-validation
529 Don't check if there's a valid gating.yaml
530 file in the repo
531 --skip-build Don't create build, but just modify settings
532 for autorebuilds
533 --compose-id COMPOSE_ID [COMPOSE_ID ...]
534 ODCS composes used. Cannot be used with
535 --signing-intent
536 --replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MAN‐
537 AGER:NAME:VERSION[:NEW_NAME] ...]
538 Cachito dependency replacement
539 centpkg container-build-setup
542 usage: centpkg container-build-setup [-h]
543 (--get-autorebuild | --set-au‐
544 torebuild {true,false})
545 set options for container-build.
547 options:
549 -h, --help show this help message and exit
550 --get-autorebuild Get autorebuild value
551 --set-autorebuild {true,false}
552 Turn autorebuilds on/off
553 centpkg copr-build
556 usage: centpkg copr-build [-h] [--config CONFIG] [--nowait] project
557 Build package in Copr.
559 Note: you need to have set up correct api key. For more information
561 see API KEY section of copr-cli(1) man page.
562 positional arguments:
564 project Name of the project in format USER/PROJECT
565 options:
567 -h, --help show this help message and exit
568 --config CONFIG Path to an alternative Copr configuration file
569 --nowait Don't wait on build
570 centpkg diff
573 usage: centpkg diff [-h] [--cached] [files ...]
574 Use git diff to show changes that have been made to tracked files.
576 By default cached changes (changes that have been git added) will
577 not be shown.
578 positional arguments:
580 files Optionally diff specific files
581 options:
583 -h, --help show this help message and exit
584 --cached View staged changes
585 centpkg flatpak-build
588 usage: centpkg flatpak-build [-h] [--target TARGET] [--nowait]
589 [--build-release BUILD_RELEASE]
590 [--isolated]
591 [--koji-parent-build KOJI_PARENT_BUILD]
592 [--scratch] [--arches [ARCHES ...]]
593 [--repo-url URL [URL ...]]
594 [--signing-intent SIGNING_INTENT]
595 [--skip-remote-rules-validation]
596 [--skip-build]
597 Build a Flatpak
599 options:
601 -h, --help show this help message and exit
602 --target TARGET Override the default target
603 --nowait Don't wait on build
604 --build-release BUILD_RELEASE
605 Specify a release value for this build's NVR
606 --isolated Do not update floating tags in the registry.
607 You must use the --build-release argument
608 --koji-parent-build KOJI_PARENT_BUILD
609 Specify a Koji NVR for the parent container
610 image. This will override the "FROM" value
611 in your Dockerfile.
612 --scratch Scratch build
613 --arches [ARCHES ...]
614 Limit a scratch or a isolated build to an
615 arch. May have multiple arches.
616 --repo-url URL [URL ...]
617 URLs of yum repo files
618 --signing-intent SIGNING_INTENT
619 Signing intent of the ODCS composes. If
620 specified, this must be one of the signing
621 intent names configured on the OSBS server.
622 If unspecified, the server will use the
623 signing intent of the compose_ids you
624 specify, or the server's
625 default_signing_intent. To view the full
626 list of possible names, see REACTOR_CONFIG
627 in orchestrator.log.
628 --skip-remote-rules-validation
629 Don't check if there's a valid gating.yaml
630 file in the repo
631 --skip-build Don't create build, but just modify settings
632 for autorebuilds
633 centpkg fork
636 usage: centpkg fork [-h]
637 Create a new fork of the current repository
639 Before the operation, you need to generate an API token at
641 https://gitlab.com/-/profile/personal_access_tokens, select the "api"
642 scope and save it in your local user configuration located
643 at ~/.config/rpkg/centpkg.conf. For example:
644 [centpkg.distgit]
646 token = <api_key_here>
647 Below is a basic example of the command to fork a current repository:
649 centpkg fork
651 options:
653 -h, --help show this help message and exit
654 centpkg gimmespec
657 usage: centpkg gimmespec [-h]
658 Print the spec file name.
660 options:
662 -h, --help show this help message and exit
663 centpkg gitbuildhash
666 usage: centpkg gitbuildhash [-h] build
667 This will show you the commit hash string used to build the provided
669 build n-v-r
670 positional arguments:
672 build name-version-release of the build to query.
673 options:
675 -h, --help show this help message and exit
676 centpkg giturl
679 usage: centpkg giturl [-h]
680 This will show you which git URL would be used in a build command.
682 It uses the git hashsum of the HEAD of the current branch (which may
683 not be pushed).
684 options:
686 -h, --help show this help message and exit
687 centpkg help
690 usage: centpkg help [-h]
691 Show usage.
693 options:
695 -h, --help show this help message and exit
696 centpkg import
699 usage: centpkg import [-h] [--skip-diffs] [--offline] srpm
700 This will extract sources, patches, and the spec file from an srpm
702 and update the current module accordingly. It will import to the
703 current branch by default.
704 positional arguments:
706 srpm Source rpm to import
707 options:
709 -h, --help show this help message and exit
710 --skip-diffs Don't show diffs when import srpms
711 --offline Do not upload files into lookaside cache
712 centpkg install
715 usage: centpkg install [-h] [--builddir BUILDDIR]
716 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
717 [--define DEFINE] [--short-circuit]
718 [--nocheck]
719 ...
720 This will call rpmbuild to run the install section. All leading
722 sections will be processed as well, unless the short-circuit option
723 is used.
724 positional arguments:
726 extra_args Custom arguments that are passed to the
727 'rpmbuild'. Use '--' to separate them from
728 other arguments.
729 options:
731 -h, --help show this help message and exit
732 --builddir BUILDDIR Define an alternate builddir
733 --buildrootdir BUILDROOTDIR
734 Define an alternate buildrootdir
735 --arch ARCH Prep for a specific arch
736 --define DEFINE Pass custom macros to rpmbuild, may specify
737 multiple times
738 --short-circuit short-circuit install
739 --nocheck nocheck install
740 centpkg lint
743 usage: centpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
744 Rpmlint can be configured using the --rpmlintconf/-r option or by
746 setting a <pkgname>.rpmlintrc file in the working directory
747 options:
749 -h, --help show this help message and exit
750 --info, -i Display explanations for reported messages
751 --rpmlintconf RPMLINTCONF, -r RPMLINTCONF
752 Use a specific configuration file for
753 rpmlint
754 centpkg list-side-tags
757 usage: centpkg list-side-tags [-h]
758 [--mine | --user TAG_OWNER | --base-tag
759 BASE_TAG]
760 List existing side-tags.
762 options:
764 -h, --help show this help message and exit
765 --mine List only my side tags
766 --user TAG_OWNER List side tags created by this user
767 --base-tag BASE_TAG List only tags based on this base
768 centpkg local
771 usage: centpkg local [-h] [--builddir BUILDDIR]
772 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
773 [--define DEFINE] [--md5] [--with BCOND_WITH]
774 [--without BCOND_WITHOUT]
775 ...
776 Locally test run of rpmbuild producing binary RPMs. The rpmbuild
778 output will be logged into a file named
779 .build-%{version}-%{release}.log
780 positional arguments:
782 extra_args Custom arguments that are passed to the
783 'rpmbuild'. Use '--' to separate them from
784 other arguments.
785 options:
787 -h, --help show this help message and exit
788 --builddir BUILDDIR Define an alternate builddir
789 --buildrootdir BUILDROOTDIR
790 Define an alternate buildrootdir
791 --arch ARCH Prep for a specific arch
792 --define DEFINE Pass custom macros to rpmbuild, may specify
793 multiple times
794 --md5 Use md5 checksums (for older rpm hosts)
795 --with BCOND_WITH Enable configure option (bcond) for the
796 build
797 --without BCOND_WITHOUT
798 Disable configure option (bcond) for the
799 build
800 centpkg mock-config
803 usage: centpkg mock-config [-h] [--target TARGET] [--arch ARCH]
804 This will generate a mock config based on the buildsystem target
806 options:
808 -h, --help show this help message and exit
809 --target TARGET Override target used for config
810 --arch ARCH Override local arch
811 centpkg mockbuild
814 usage: centpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean]
815 [--no-cleanup-after] [--no-clean-all]
816 [--with BCOND_WITH]
817 [--without BCOND_WITHOUT] [--shell]
818 [--enablerepo ENABLEREPO]
819 [--disablerepo DISABLEREPO]
820 [--enable-network]
821 ...
822 This will use the mock utility to build the package for the
824 distribution detected from branch information. This can be
825 overridden using the global --release option. Your user must be in
826 the local "mock" group.
827 positional arguments:
829 extra_args Custom arguments that are passed to the
830 'mock'. Use '--' to separate them from other
831 arguments.
832 options:
834 -h, --help show this help message and exit
835 --root CONFIG, --mock-config CONFIG
836 Override mock configuration (like mock -r)
837 --md5 Use md5 checksums (for older rpm hosts)
838 --no-clean, -n Do not clean chroot before building package
839 --no-cleanup-after Do not clean chroot after building (if
840 automatic cleanup is enabled
841 --no-clean-all, -N Alias for both --no-clean and --no-cleanup-
842 after
843 --with BCOND_WITH Enable configure option (bcond) for the
844 build
845 --without BCOND_WITHOUT
846 Disable configure option (bcond) for the
847 build
848 --shell Run commands interactively within chroot.
849 Before going into chroot, mockbuild needs to
850 run with --no-cleanup-after in advanced.
851 --enablerepo ENABLEREPO
852 Pass enablerepo option to yum/dnf (may be
853 used more than once)
854 --disablerepo DISABLEREPO
855 Pass disablerepo option to yum/dnf (may be
856 used more than once)
857 --enable-network Enable networking
858 If config file for mock isn't found in the /etc/mock directory, a
860 temporary config directory for mock is created and populated with a
861 config file created with mock-config.
862 centpkg module-build
865 usage: centpkg module-build [-h] [--watch]
866 [--buildrequires name:stream]
867 [--requires name:stream]
868 [--optional key=value]
869 [--file [FILE_PATH]] [--srpm SRPMS]
870 [--scratch]
871 [scm_url] [branch]
872 Build a module using MBS
874 positional arguments:
876 scm_url The module's SCM URL. This defaults to the
877 current repo.
878 branch The module's SCM branch. This defaults to
879 the current checked-out branch.
880 options:
882 -h, --help show this help message and exit
883 --watch, -w Watch the module build
884 --buildrequires name:stream
885 Buildrequires to override in the form of
886 "name:stream"
887 --requires name:stream
888 Requires to override in the form of
889 "name:stream"
890 --optional key=value MBS optional arguments in the form of
891 "key=value". For example: 'centpkg module-
892 build --optional
893 "reuse_components_from=<NSVC>"'. More
894 description including list of available
895 arguments here: https://pagure.io/fm-
896 orchestrator/
897 --file [FILE_PATH] The modulemd yaml file for module scratch
898 build.
899 --srpm SRPMS Include one or more srpms for module scratch
900 build.
901 --scratch Perform a scratch build
902 centpkg module-build-cancel
905 usage: centpkg module-build-cancel [-h] build_id
906 Cancel an MBS module build
908 positional arguments:
910 build_id The ID of the module build to cancel
911 options:
913 -h, --help show this help message and exit
914 centpkg module-build-info
917 usage: centpkg module-build-info [-h] build_id
918 Show information of an MBS module build
920 positional arguments:
922 build_id The ID of the module build
923 options:
925 -h, --help show this help message and exit
926 centpkg module-build-local
929 usage: centpkg module-build-local [-h] [--file [FILE_PATH]]
930 [--srpm SRPMS] [--stream [STREAM]]
931 [--skip-tests]
932 [--add-local-build N:S:V] [-s N:S]
933 [--offline] [-r PATH]
934 Build a module locally using the mbs-manager command
936 options:
938 -h, --help show this help message and exit
939 --file [FILE_PATH] The module's modulemd yaml file. If not
940 specified, a yaml file with the same
941 basename as the name of the repository will
942 be used.
943 --srpm SRPMS Include one or more srpms for module build.
944 --stream [STREAM] The module's stream/SCM branch. This
945 defaults to the current checked-out branch.
946 --skip-tests Adds a macro for skipping the check section
947 --add-local-build N:S:V
948 Import previously finished local module
949 builds into MBS in the format of name:stream
950 or name:stream:version
951 -s N:S, --set-default-stream N:S
952 Set the default stream for given module
953 dependency in case there are multiple
954 streams to choose from.
955 --offline Builds module offline without any external
956 infrastructure
957 -r PATH, --repository PATH
958 Full path to .repo file defining the base
959 module repository to use when --offline is
960 used.
961 centpkg module-build-watch
964 usage: centpkg module-build-watch [-h] build_id [build_id ...]
965 Watch an MBS build
967 positional arguments:
969 build_id The ID of the module build to watch
970 options:
972 -h, --help show this help message and exit
973 centpkg module-overview
976 usage: centpkg module-overview [-h] [--unfinished] [--limit LIMIT]
977 [--owner FAS_ID | --mine]
978 Shows an overview of MBS builds
980 options:
982 -h, --help show this help message and exit
983 --unfinished Show unfinished module builds
984 --limit LIMIT The number of most recent module builds to display
985 --owner FAS_ID List only items of that owner
986 --mine Use current Kerberos name or username
987 centpkg module-scratch-build
990 usage: centpkg module-scratch-build [-h] [--watch]
991 [--buildrequires name:stream]
992 [--requires name:stream]
993 [--optional key=value]
994 [--file [FILE_PATH]]
995 [--srpm SRPMS]
996 [scm_url] [branch]
997 Build a scratch module using MBS
999 positional arguments:
1001 scm_url The module's SCM URL. This defaults to the
1002 current repo.
1003 branch The module's SCM branch. This defaults to
1004 the current checked-out branch.
1005 options:
1007 -h, --help show this help message and exit
1008 --watch, -w Watch the module build
1009 --buildrequires name:stream
1010 Buildrequires to override in the form of
1011 "name:stream"
1012 --requires name:stream
1013 Requires to override in the form of
1014 "name:stream"
1015 --optional key=value MBS optional arguments in the form of
1016 "key=value". For example: 'centpkg module-
1017 build --optional
1018 "reuse_components_from=<NSVC>"'. More
1019 description including list of available
1020 arguments here: https://pagure.io/fm-
1021 orchestrator/
1022 --file [FILE_PATH] The modulemd yaml file for module scratch
1023 build.
1024 --srpm SRPMS Include one or more srpms for module scratch
1025 build.
1026 centpkg new
1029 usage: centpkg new [-h]
1030 This will use git to show a diff of all the changes (even
1032 uncommitted changes) since the last git tag was applied.
1033 options:
1035 -h, --help show this help message and exit
1036 centpkg new-sources
1039 usage: centpkg new-sources [-h] [--offline] files [files ...]
1040 This will upload new source file(s) to lookaside cache, and all file
1042 names listed in sources file will be replaced. .gitignore will be
1043 also updated with new uploaded file(s). Please remember to commit
1044 them.
1045 positional arguments:
1047 files
1048 options:
1050 -h, --help show this help message and exit
1051 --offline Do all the steps except uploading into lookaside cache
1052 centpkg patch
1055 usage: centpkg patch [-h] [--rediff] suffix
1056 Create and add a gendiff patch file.
1058 positional arguments:
1060 suffix Look for files with this suffix to diff
1061 options:
1063 -h, --help show this help message and exit
1064 --rediff Recreate gendiff file retaining comments Saves old
1065 patch file with a suffix of ~
1066 Patch file will be named: package-version-suffix.patch and the file
1068 will be added to the repo index
1069 centpkg prep
1072 usage: centpkg prep [-h] [--builddir BUILDDIR]
1073 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1074 [--define DEFINE]
1075 ...
1076 Use rpmbuild to "prep" the sources (unpack the source archive(s) and
1078 apply any patches.)
1079 positional arguments:
1081 extra_args Custom arguments that are passed to the
1082 'rpmbuild'. Use '--' to separate them from
1083 other arguments.
1084 options:
1086 -h, --help show this help message and exit
1087 --builddir BUILDDIR Define an alternate builddir
1088 --buildrootdir BUILDROOTDIR
1089 Define an alternate buildrootdir
1090 --arch ARCH Prep for a specific arch
1091 --define DEFINE Pass custom macros to rpmbuild, may specify
1092 multiple times
1093 centpkg pull
1096 usage: centpkg pull [-h] [--rebase] [--no-rebase]
1097 This command uses git to fetch remote changes and apply them to the
1099 current working copy. A rebase option is available which can be used
1100 to avoid merges.
1101 options:
1103 -h, --help show this help message and exit
1104 --rebase Rebase the locally committed changes on top of the
1105 remote changes after fetching. This can avoid a merge
1106 commit, but does rewrite local history.
1107 --no-rebase Do not rebase, overriding .git settings to the
1108 contrary
1109 See git pull --help for more details
1111 centpkg push
1114 usage: centpkg push [-h] [--force]
1115 Push changes to remote repository.
1117 options:
1119 -h, --help show this help message and exit
1120 --force, -f Force push
1121 centpkg remote
1124 usage: centpkg remote [-h] {add} ...
1125 Operations with tracked repositories ('remotes'). This is an
1127 experimental interface.
1128 options:
1130 -h, --help show this help message and exit
1131 subcommands:
1133 Operations with tracked repositories ('remotes'). This is an
1134 experimental interface. Please note that some or all current
1135 functionality is subject to change. Without parameters list of
1136 remotes will be shown.
1137 {add}
1139 centpkg remove-side-tag
1142 usage: centpkg remove-side-tag [-h] TAG
1143 Remove a side tag (without merging packages).
1145 positional arguments:
1147 TAG name of tag to be deleted
1148 options:
1150 -h, --help show this help message and exit
1151 centpkg request-gated-side-tag
1154 usage: centpkg request-gated-side-tag [-h] [--base-tag BASE_TAG]
1155 Create a new dynamic gated side tag.
1157 options:
1159 -h, --help show this help message and exit
1160 --base-tag BASE_TAG name of base tag
1161 centpkg request-side-tag
1164 usage: centpkg request-side-tag [-h] [--base-tag BASE_TAG]
1165 [--suffix SUFFIX]
1166 Create a new side tag.
1168 options:
1170 -h, --help show this help message and exit
1171 --base-tag BASE_TAG name of base tag
1172 --suffix SUFFIX A suffix to be appended to the side tag name.
1173 The suffix must be allowed in Koji
1174 configuration.
1175 centpkg retire
1178 usage: centpkg retire [-h] reason
1179 This command will remove all files from the repo, leave a
1181 dead.package file for rpms or dead.module file for modules, and push
1182 the changes.
1183 positional arguments:
1185 reason Reason for retiring the package/module
1186 options:
1188 -h, --help show this help message and exit
1189 centpkg scratch-build
1192 usage: centpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5]
1193 [--nowait] [--target TARGET]
1194 [--background] [--fail-fast]
1195 [--skip-remote-rules-validation]
1196 [--skip-nvr-check] [--srpm [SRPM]]
1197 This command will request a scratch build of the package. Without
1199 providing an srpm, it will attempt to build the latest commit, which
1200 must have been pushed. By default all appropriate arches will be
1201 built.
1202 options:
1204 -h, --help show this help message and exit
1205 --arches [ARCHES ...]
1206 Build for specific arches
1207 --md5 Use md5 checksums (for older rpm hosts)
1208 --nowait Don't wait on build
1209 --target TARGET Define build target to build into
1210 --background Run the build at a low priority
1211 --fail-fast Fail the build immediately if any arch fails
1212 --skip-remote-rules-validation
1213 Don't check if there's a valid gating.yaml
1214 file in the repo, where you can define
1215 additional policies for Greenwave gating.
1216 --skip-nvr-check Submit build to buildsystem without check if
1217 NVR was already built. NVR is constructed
1218 locally and may be different from NVR
1219 constructed during build on builder.
1220 --srpm [SRPM] Build from an srpm. If no srpm is provided
1221 with this option an srpm will be generated
1222 from the current module content.
1223 centpkg sources
1226 usage: centpkg sources [-h] [--outdir OUTDIR]
1227 Download source files
1229 options:
1231 -h, --help show this help message and exit
1232 --outdir OUTDIR Directory to download files into (defaults to
1233 pwd)
1234 centpkg srpm
1237 usage: centpkg srpm [-h] [--builddir BUILDDIR]
1238 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1239 [--define DEFINE] [--md5]
1240 ...
1241 Create a source rpm
1243 positional arguments:
1245 extra_args Custom arguments that are passed to the
1246 'rpmbuild'. Use '--' to separate them from
1247 other arguments.
1248 options:
1250 -h, --help show this help message and exit
1251 --builddir BUILDDIR Define an alternate builddir
1252 --buildrootdir BUILDROOTDIR
1253 Define an alternate buildrootdir
1254 --arch ARCH Prep for a specific arch
1255 --define DEFINE Pass custom macros to rpmbuild, may specify
1256 multiple times
1257 --md5 Use md5 checksums (for older rpm hosts)
1258 centpkg switch-branch
1261 usage: centpkg switch-branch [-h] [-l] [--fetch] [branch]
1262 This command can switch to a local git branch. If provided with a
1264 remote branch name that does not have a local match it will create
1265 one. It can also be used to list the existing local and remote
1266 branches.
1267 positional arguments:
1269 branch Branch name to switch to
1270 options:
1272 -h, --help show this help message and exit
1273 -l, --list List both remote-tracking branches and local branches
1274 --fetch Fetch new data from remote before switch
1275 centpkg tag
1278 usage: centpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE]
1279 [-l] [-d]
1280 [tag]
1281 This command uses git to create, list, or delete tags.
1283 positional arguments:
1285 tag Name of the tag
1286 options:
1288 -h, --help show this help message and exit
1289 -f, --force Force the creation of the tag
1290 -m MESSAGE, --message MESSAGE
1291 Use the given <msg> as the tag message
1292 -c, --clog Generate the tag message from the spec
1293 changelog section
1294 --raw Make the clog raw
1295 -F FILE, --file FILE Take the tag message from the given file
1296 -l, --list List all tags with a given pattern, or all
1297 if not pattern is given
1298 -d, --delete Delete a tag
1299 centpkg unused-patches
1302 usage: centpkg unused-patches [-h]
1303 Print list of patches not referenced by name in the specfile.
1305 options:
1307 -h, --help show this help message and exit
1308 centpkg upload
1311 usage: centpkg upload [-h] [--offline] files [files ...]
1312 This command will upload new source file(s) to lookaside cache.
1314 Source file names are appended to sources file, and .gitignore will
1315 be also updated with new uploaded file(s). Please remember to commit
1316 them.
1317 positional arguments:
1319 files
1320 options:
1322 -h, --help show this help message and exit
1323 --offline Do all the steps except uploading into lookaside cache
1324 centpkg verify-files
1327 usage: centpkg verify-files [-h] [--builddir BUILDDIR]
1328 [--buildrootdir BUILDROOTDIR]
1329 [--arch ARCH] [--define DEFINE]
1330 ...
1331 Locally run 'rpmbuild -bl' to verify the spec file's %files
1333 sections. This requires a successful run of 'centpkg install' in
1334 advance.
1335 positional arguments:
1337 extra_args Custom arguments that are passed to the
1338 'rpmbuild'. Use '--' to separate them from
1339 other arguments.
1340 options:
1342 -h, --help show this help message and exit
1343 --builddir BUILDDIR Define an alternate builddir
1344 --buildrootdir BUILDROOTDIR
1345 Define an alternate buildrootdir
1346 --arch ARCH Prep for a specific arch
1347 --define DEFINE Pass custom macros to rpmbuild, may specify
1348 multiple times
1349 centpkg verrel
1352 usage: centpkg verrel [-h]
1353 Print the name-version-release.
1355 options:
1357 -h, --help show this help message and exit
1358
1361 https://git.centos.org/centos/centpkg
1362 2022-01-19 centpkg(1)