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] 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 remove-side-tag [-h] TAG
173 Remove a side tag (without merging packages)
174 centpkg request-gated-side-tag [-h] [--base-tag BASE_TAG]
176 Create a new dynamic gated side tag
177 centpkg request-side-tag [-h] [--base-tag BASE_TAG] [--suffix SUFFIX]
179 Create a new side tag
180 centpkg retire [-h] reason
182 Retire a package/module
183 centpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
185 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
186 validation] [--srpm [SRPM]]
187 Request scratch build
188 centpkg sources [-h] [--outdir OUTDIR]
190 Download source files
191 centpkg srpm [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
193 [--arch ARCH] [--define DEFINE] [--md5] ...
194 Create a source rpm
195 centpkg switch-branch [-h] [-l] [--fetch] [branch]
197 Work with branches
198 centpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l] [-d]
200 [tag]
201 Management of git tags
202 centpkg unused-patches [-h]
204 Print list of patches not referenced by name in the specfile
205 centpkg upload [-h] files [files ...]
207 Upload source files
208 centpkg verify-files [-h] [--builddir BUILDDIR] [--buildrootdir BUILD‐
210 ROOTDIR] [--arch ARCH] [--define DEFINE] ...
211 Locally verify %%files section
212 centpkg verrel [-h]
214 Print the name-version-release
215
217 centpkg build
218 usage: centpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
219 [--target TARGET] [--background] [--fail-fast]
220 [--skip-remote-rules-validation]
221 [--skip-nvr-check] [--skip-tag] [--scratch]
222 [--srpm [SRPM]]
223 This command requests a build of the package in the build system. By
225 default it discovers the target to build for based on branch data,
226 and uses the latest commit as the build source.
227 options:
229 -h, --help show this help message and exit
230 --arches [ARCHES ...]
231 Build for specific arches
232 --md5 Use md5 checksums (for older rpm hosts)
233 --nowait Don't wait on build
234 --target TARGET Define build target to build into
235 --background Run the build at a low priority
236 --fail-fast Fail the build immediately if any arch fails
237 --skip-remote-rules-validation
238 Don't check if there's a valid gating.yaml
239 file in the repo, where you can define
240 additional policies for Greenwave gating.
241 --skip-nvr-check Submit build to buildsystem without check if
242 NVR was already built. NVR is constructed
243 locally and may be different from NVR
244 constructed during build on builder.
245 --skip-tag Do not attempt to tag package
246 --scratch Perform a scratch build
247 --srpm [SRPM] Build from an srpm. If no srpm is provided
248 with this option an srpm will be generated
249 from current module content.
250 centpkg chain-build
253 usage: centpkg chain-build [-h] [--arches [ARCHES ...]] [--md5]
254 [--nowait] [--target TARGET]
255 [--background] [--fail-fast]
256 [--skip-remote-rules-validation]
257 [--skip-nvr-check]
258 package [package ...]
259 Build current package in order with other packages.
261 example: centpkg chain-build libwidget libgizmo
263 The current package is added to the end of the CHAIN list.
265 Colons (:) can be used in the CHAIN parameter to define groups of
266 packages. Packages in any single group will be built in parallel
267 and all packages in a group must build successfully and populate
268 the repository before the next group will begin building.
269 For example:
271 centpkg chain-build libwidget libaselib : libgizmo :
273 will cause libwidget and libaselib to be built in parallel, followed
275 by libgizmo and then the current directory package. If no groups are
276 defined, packages will be built sequentially.
277 positional arguments:
279 package List the packages and order you want to
280 build in
281 options:
283 -h, --help show this help message and exit
284 --arches [ARCHES ...]
285 Build for specific arches
286 --md5 Use md5 checksums (for older rpm hosts)
287 --nowait Don't wait on build
288 --target TARGET Define build target to build into
289 --background Run the build at a low priority
290 --fail-fast Fail the build immediately if any arch fails
291 --skip-remote-rules-validation
292 Don't check if there's a valid gating.yaml
293 file in the repo, where you can define
294 additional policies for Greenwave gating.
295 --skip-nvr-check Submit build to buildsystem without check if
296 NVR was already built. NVR is constructed
297 locally and may be different from NVR
298 constructed during build on builder.
299 centpkg ci
302 usage: centpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw]
303 [-t] [-F FILE] [-p] [-s]
304 [files ...]
305 Alias for commit.
307 positional arguments:
309 files Optional list of specific files to commit
310 options:
312 -h, --help show this help message and exit
313 -m MESSAGE, --message MESSAGE
314 Use the given <msg> as the commit message
315 summary
316 --with-changelog Get the last changelog from SPEC as commit
317 message content. This option must be used
318 with -m together.
319 -c, --clog Generate the commit message from the
320 Changelog section
321 --raw Make the clog raw
322 -t, --tag Create a tag for this commit
323 -F FILE, --file FILE Take the commit message from the given file
324 -p, --push Commit and push as one action
325 -s, --signoff Include a signed-off-by
326 centpkg clean
329 usage: centpkg clean [-h] [--dry-run] [-x]
330 This command can be used to clean up your working directory. By
332 default it will follow .gitignore rules.
333 options:
335 -h, --help show this help message and exit
336 --dry-run, -n Perform a dry-run
337 -x Do not follow .gitignore rules
338 centpkg clog
341 usage: centpkg clog [-h] [--raw]
342 This will create a file named "clog" that contains the latest rpm
344 changelog entry. The leading "- " text will be stripped.
345 options:
347 -h, --help show this help message and exit
348 --raw Generate a more "raw" clog without twiddling the
349 contents
350 centpkg clone
353 usage: centpkg clone [-h] [--branches] [--branch BRANCH]
354 [--anonymous] [--depth DEPTH]
355 repo [clone_target] ...
356 This command will clone the named repository from the configured
358 repository base URL. By default it will also checkout the master
359 branch for your working copy.
360 positional arguments:
362 repo Name of the repository to clone
363 clone_target Directory in which to clone the repository
364 extra_args Custom arguments that are passed to the 'git
365 clone'. Use '--' to separate them from other
366 arguments.
367 options:
369 -h, --help show this help message and exit
370 --branches, -B Do an old style checkout with subdirs for
371 branches
372 --branch BRANCH, -b BRANCH
373 Check out a specific branch
374 --anonymous, -a Check out a module anonymously
375 --depth DEPTH Create a shallow clone with a history
376 truncated to the specified number of commits
377 centpkg co
380 usage: centpkg co [-h] [--branches] [--branch BRANCH] [--anonymous]
381 [--depth DEPTH]
382 repo [clone_target] ...
383 Alias for clone.
385 positional arguments:
387 repo Name of the repository to clone
388 clone_target Directory in which to clone the repository
389 extra_args Custom arguments that are passed to the 'git
390 clone'. Use '--' to separate them from other
391 arguments.
392 options:
394 -h, --help show this help message and exit
395 --branches, -B Do an old style checkout with subdirs for
396 branches
397 --branch BRANCH, -b BRANCH
398 Check out a specific branch
399 --anonymous, -a Check out a module anonymously
400 --depth DEPTH Create a shallow clone with a history
401 truncated to the specified number of commits
402 centpkg commit
405 usage: centpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c]
406 [--raw] [-t] [-F FILE] [-p] [-s]
407 [files ...]
408 This invokes a git commit. All tracked files with changes will be
410 committed unless a specific file list is provided. $EDITOR will be
411 used to generate a changelog message unless one is given to the
412 command. A push can be done at the same time.
413 positional arguments:
415 files Optional list of specific files to commit
416 options:
418 -h, --help show this help message and exit
419 -m MESSAGE, --message MESSAGE
420 Use the given <msg> as the commit message
421 summary
422 --with-changelog Get the last changelog from SPEC as commit
423 message content. This option must be used
424 with -m together.
425 -c, --clog Generate the commit message from the
426 Changelog section
427 --raw Make the clog raw
428 -t, --tag Create a tag for this commit
429 -F FILE, --file FILE Take the commit message from the given file
430 -p, --push Commit and push as one action
431 -s, --signoff Include a signed-off-by
432 centpkg compile
435 usage: centpkg compile [-h] [--builddir BUILDDIR]
436 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
437 [--define DEFINE] [--short-circuit]
438 [--nocheck]
439 ...
440 This command calls rpmbuild to compile the source. By default the
442 prep and configure stages will be done as well, unless the short-
443 circuit option is used.
444 positional arguments:
446 extra_args Custom arguments that are passed to the
447 'rpmbuild'. Use '--' to separate them from
448 other arguments.
449 options:
451 -h, --help show this help message and exit
452 --builddir BUILDDIR Define an alternate builddir
453 --buildrootdir BUILDROOTDIR
454 Define an alternate buildrootdir
455 --arch ARCH Prep for a specific arch
456 --define DEFINE Pass custom macros to rpmbuild, may specify
457 multiple times
458 --short-circuit short-circuit compile
459 --nocheck nocheck compile
460 centpkg container-build
463 usage: centpkg container-build [-h] [--target TARGET] [--nowait]
464 [--build-release BUILD_RELEASE]
465 [--isolated]
466 [--koji-parent-build KOJI_PAR‐
467 ENT_BUILD]
468 [--scratch] [--arches [ARCHES ...]]
469 [--repo-url URL [URL ...]]
470 [--signing-intent SIGNING_INTENT]
471 [--skip-remote-rules-validation]
472 [--skip-build]
473 [--compose-id COMPOSE_ID [COMPOSE_ID
474 ...]]
475 [--replace-dependency PKG_MAN‐
476 AGER:NAME:VERSION[:NEW_NAME]
477 [PKG_MANAGER:NAME:VERSION[:NEW_NAME]
478 ...]]
479 Build a container
481 options:
483 -h, --help show this help message and exit
484 --target TARGET Override the default target
485 --nowait Don't wait on build
486 --build-release BUILD_RELEASE
487 Specify a release value for this build's NVR
488 --isolated Do not update floating tags in the registry.
489 You must use the --build-release argument
490 --koji-parent-build KOJI_PARENT_BUILD
491 Specify a Koji NVR for the parent container
492 image. This will override the "FROM" value
493 in your Dockerfile.
494 --scratch Scratch build
495 --arches [ARCHES ...]
496 Limit a scratch or a isolated build to an
497 arch. May have multiple arches.
498 --repo-url URL [URL ...]
499 URLs of yum repo files
500 --signing-intent SIGNING_INTENT
501 Signing intent of the ODCS composes.
502 --skip-remote-rules-validation
503 Don't check if there's a valid gating.yaml
504 file in the repo
505 --skip-build Don't create build, but just modify settings
506 for autorebuilds
507 --compose-id COMPOSE_ID [COMPOSE_ID ...]
508 ODCS composes used. Cannot be used with
509 --signing-intent
510 --replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MAN‐
511 AGER:NAME:VERSION[:NEW_NAME] ...]
512 Cachito dependency replacement
513 centpkg container-build-setup
516 usage: centpkg container-build-setup [-h]
517 (--get-autorebuild | --set-au‐
518 torebuild {true,false})
519 set options for container-build.
521 options:
523 -h, --help show this help message and exit
524 --get-autorebuild Get autorebuild value
525 --set-autorebuild {true,false}
526 Turn autorebuilds on/off
527 centpkg copr-build
530 usage: centpkg copr-build [-h] [--config CONFIG] [--nowait] project
531 Build package in Copr.
533 Note: you need to have set up correct api key. For more information
535 see API KEY section of copr-cli(1) man page.
536 positional arguments:
538 project Name of the project in format USER/PROJECT
539 options:
541 -h, --help show this help message and exit
542 --config CONFIG Path to an alternative Copr configuration file
543 --nowait Don't wait on build
544 centpkg diff
547 usage: centpkg diff [-h] [--cached] [files ...]
548 Use git diff to show changes that have been made to tracked files.
550 By default cached changes (changes that have been git added) will
551 not be shown.
552 positional arguments:
554 files Optionally diff specific files
555 options:
557 -h, --help show this help message and exit
558 --cached View staged changes
559 centpkg flatpak-build
562 usage: centpkg flatpak-build [-h] [--target TARGET] [--nowait]
563 [--build-release BUILD_RELEASE]
564 [--isolated]
565 [--koji-parent-build KOJI_PARENT_BUILD]
566 [--scratch] [--arches [ARCHES ...]]
567 [--repo-url URL [URL ...]]
568 [--signing-intent SIGNING_INTENT]
569 [--skip-remote-rules-validation]
570 [--skip-build]
571 Build a Flatpak
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 --build-release BUILD_RELEASE
579 Specify a release value for this build's NVR
580 --isolated Do not update floating tags in the registry.
581 You must use the --build-release argument
582 --koji-parent-build KOJI_PARENT_BUILD
583 Specify a Koji NVR for the parent container
584 image. This will override the "FROM" value
585 in your Dockerfile.
586 --scratch Scratch build
587 --arches [ARCHES ...]
588 Limit a scratch or a isolated build to an
589 arch. May have multiple arches.
590 --repo-url URL [URL ...]
591 URLs of yum repo files
592 --signing-intent SIGNING_INTENT
593 Signing intent of the ODCS composes.
594 --skip-remote-rules-validation
595 Don't check if there's a valid gating.yaml
596 file in the repo
597 --skip-build Don't create build, but just modify settings
598 for autorebuilds
599 centpkg fork
602 usage: centpkg fork [-h]
603 Create a new fork of the current repository
605 Before the operation, you need to generate an API token at
607 https://gitlab.com/-/profile/personal_access_tokens, select the "api"
608 scope and save it in your local user configuration located
609 at ~/.config/rpkg/centpkg.conf. For example:
610 [centpkg.distgit]
612 token = <api_key_here>
613 Below is a basic example of the command to fork a current repository:
615 centpkg fork
617 options:
619 -h, --help show this help message and exit
620 centpkg gimmespec
623 usage: centpkg gimmespec [-h]
624 Print the spec file name.
626 options:
628 -h, --help show this help message and exit
629 centpkg gitbuildhash
632 usage: centpkg gitbuildhash [-h] build
633 This will show you the commit hash string used to build the provided
635 build n-v-r
636 positional arguments:
638 build name-version-release of the build to query.
639 options:
641 -h, --help show this help message and exit
642 centpkg giturl
645 usage: centpkg giturl [-h]
646 This will show you which git URL would be used in a build command.
648 It uses the git hashsum of the HEAD of the current branch (which may
649 not be pushed).
650 options:
652 -h, --help show this help message and exit
653 centpkg help
656 usage: centpkg help [-h]
657 Show usage.
659 options:
661 -h, --help show this help message and exit
662 centpkg import
665 usage: centpkg import [-h] [--skip-diffs] [--offline] srpm
666 This will extract sources, patches, and the spec file from an srpm
668 and update the current module accordingly. It will import to the
669 current branch by default.
670 positional arguments:
672 srpm Source rpm to import
673 options:
675 -h, --help show this help message and exit
676 --skip-diffs Don't show diffs when import srpms
677 --offline Do not upload files into lookaside cache
678 centpkg install
681 usage: centpkg install [-h] [--builddir BUILDDIR]
682 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
683 [--define DEFINE] [--short-circuit]
684 [--nocheck]
685 ...
686 This will call rpmbuild to run the install section. All leading
688 sections will be processed as well, unless the short-circuit option
689 is used.
690 positional arguments:
692 extra_args Custom arguments that are passed to the
693 'rpmbuild'. Use '--' to separate them from
694 other arguments.
695 options:
697 -h, --help show this help message and exit
698 --builddir BUILDDIR Define an alternate builddir
699 --buildrootdir BUILDROOTDIR
700 Define an alternate buildrootdir
701 --arch ARCH Prep for a specific arch
702 --define DEFINE Pass custom macros to rpmbuild, may specify
703 multiple times
704 --short-circuit short-circuit install
705 --nocheck nocheck install
706 centpkg lint
709 usage: centpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
710 Rpmlint can be configured using the --rpmlintconf/-r option or by
712 setting a <pkgname>.rpmlintrc file in the working directory
713 options:
715 -h, --help show this help message and exit
716 --info, -i Display explanations for reported messages
717 --rpmlintconf RPMLINTCONF, -r RPMLINTCONF
718 Use a specific configuration file for
719 rpmlint
720 centpkg list-side-tags
723 usage: centpkg list-side-tags [-h]
724 [--mine | --user TAG_OWNER | --base-tag
725 BASE_TAG]
726 List existing side-tags.
728 options:
730 -h, --help show this help message and exit
731 --mine List only my side tags
732 --user TAG_OWNER List side tags created by this user
733 --base-tag BASE_TAG List only tags based on this base
734 centpkg local
737 usage: centpkg local [-h] [--builddir BUILDDIR]
738 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
739 [--define DEFINE] [--md5] [--with BCOND_WITH]
740 [--without BCOND_WITHOUT]
741 ...
742 Locally test run of rpmbuild producing binary RPMs. The rpmbuild
744 output will be logged into a file named
745 .build-%{version}-%{release}.log
746 positional arguments:
748 extra_args Custom arguments that are passed to the
749 'rpmbuild'. Use '--' to separate them from
750 other arguments.
751 options:
753 -h, --help show this help message and exit
754 --builddir BUILDDIR Define an alternate builddir
755 --buildrootdir BUILDROOTDIR
756 Define an alternate buildrootdir
757 --arch ARCH Prep for a specific arch
758 --define DEFINE Pass custom macros to rpmbuild, may specify
759 multiple times
760 --md5 Use md5 checksums (for older rpm hosts)
761 --with BCOND_WITH Enable configure option (bcond) for the
762 build
763 --without BCOND_WITHOUT
764 Disable configure option (bcond) for the
765 build
766 centpkg mock-config
769 usage: centpkg mock-config [-h] [--target TARGET] [--arch ARCH]
770 This will generate a mock config based on the buildsystem target
772 options:
774 -h, --help show this help message and exit
775 --target TARGET Override target used for config
776 --arch ARCH Override local arch
777 centpkg mockbuild
780 usage: centpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean]
781 [--no-cleanup-after] [--no-clean-all]
782 [--with BCOND_WITH]
783 [--without BCOND_WITHOUT] [--shell]
784 [--enablerepo ENABLEREPO]
785 [--disablerepo DISABLEREPO]
786 [--enable-network]
787 ...
788 This will use the mock utility to build the package for the
790 distribution detected from branch information. This can be
791 overridden using the global --release option. Your user must be in
792 the local "mock" group.
793 positional arguments:
795 extra_args Custom arguments that are passed to the
796 'mock'. Use '--' to separate them from other
797 arguments.
798 options:
800 -h, --help show this help message and exit
801 --root CONFIG, --mock-config CONFIG
802 Override mock configuration (like mock -r)
803 --md5 Use md5 checksums (for older rpm hosts)
804 --no-clean, -n Do not clean chroot before building package
805 --no-cleanup-after Do not clean chroot after building (if
806 automatic cleanup is enabled
807 --no-clean-all, -N Alias for both --no-clean and --no-cleanup-
808 after
809 --with BCOND_WITH Enable configure option (bcond) for the
810 build
811 --without BCOND_WITHOUT
812 Disable configure option (bcond) for the
813 build
814 --shell Run commands interactively within chroot.
815 Before going into chroot, mockbuild needs to
816 run with --no-cleanup-after in advanced.
817 --enablerepo ENABLEREPO
818 Pass enablerepo option to yum/dnf (may be
819 used more than once)
820 --disablerepo DISABLEREPO
821 Pass disablerepo option to yum/dnf (may be
822 used more than once)
823 --enable-network Enable networking
824 If config file for mock isn't found in the /etc/mock directory, a
826 temporary config directory for mock is created and populated with a
827 config file created with mock-config.
828 centpkg module-build
831 usage: centpkg module-build [-h] [--watch]
832 [--buildrequires name:stream]
833 [--requires name:stream]
834 [--optional key=value]
835 [--file [FILE_PATH]] [--srpm SRPMS]
836 [--scratch]
837 [scm_url] [branch]
838 Build a module using MBS
840 positional arguments:
842 scm_url The module's SCM URL. This defaults to the
843 current repo.
844 branch The module's SCM branch. This defaults to
845 the current checked-out branch.
846 options:
848 -h, --help show this help message and exit
849 --watch, -w Watch the module build
850 --buildrequires name:stream
851 Buildrequires to override in the form of
852 "name:stream"
853 --requires name:stream
854 Requires to override in the form of
855 "name:stream"
856 --optional key=value MBS optional arguments in the form of
857 "key=value". For example: 'centpkg module-
858 build --optional
859 "reuse_components_from=<NSVC>"'. More
860 description including list of available
861 arguments here: https://pagure.io/fm-
862 orchestrator/
863 --file [FILE_PATH] The modulemd yaml file for module scratch
864 build.
865 --srpm SRPMS Include one or more srpms for module scratch
866 build.
867 --scratch Perform a scratch build
868 centpkg module-build-cancel
871 usage: centpkg module-build-cancel [-h] build_id
872 Cancel an MBS module build
874 positional arguments:
876 build_id The ID of the module build to cancel
877 options:
879 -h, --help show this help message and exit
880 centpkg module-build-info
883 usage: centpkg module-build-info [-h] build_id
884 Show information of an MBS module build
886 positional arguments:
888 build_id The ID of the module build
889 options:
891 -h, --help show this help message and exit
892 centpkg module-build-local
895 usage: centpkg module-build-local [-h] [--file [FILE_PATH]]
896 [--srpm SRPMS] [--stream [STREAM]]
897 [--skip-tests]
898 [--add-local-build N:S:V] [-s N:S]
899 [--offline] [-r PATH]
900 Build a module locally using the mbs-manager command
902 options:
904 -h, --help show this help message and exit
905 --file [FILE_PATH] The module's modulemd yaml file. If not
906 specified, a yaml file with the same
907 basename as the name of the repository will
908 be used.
909 --srpm SRPMS Include one or more srpms for module build.
910 --stream [STREAM] The module's stream/SCM branch. This
911 defaults to the current checked-out branch.
912 --skip-tests Adds a macro for skipping the check section
913 --add-local-build N:S:V
914 Import previously finished local module
915 builds into MBS in the format of name:stream
916 or name:stream:version
917 -s N:S, --set-default-stream N:S
918 Set the default stream for given module
919 dependency in case there are multiple
920 streams to choose from.
921 --offline Builds module offline without any external
922 infrastructure
923 -r PATH, --repository PATH
924 Full path to .repo file defining the base
925 module repository to use when --offline is
926 used.
927 centpkg module-build-watch
930 usage: centpkg module-build-watch [-h] build_id [build_id ...]
931 Watch an MBS build
933 positional arguments:
935 build_id The ID of the module build to watch
936 options:
938 -h, --help show this help message and exit
939 centpkg module-overview
942 usage: centpkg module-overview [-h] [--unfinished] [--limit LIMIT]
943 [--owner FAS_ID | --mine]
944 Shows an overview of MBS builds
946 options:
948 -h, --help show this help message and exit
949 --unfinished Show unfinished module builds
950 --limit LIMIT The number of most recent module builds to display
951 --owner FAS_ID List only items of that owner
952 --mine Use current Kerberos name or username
953 centpkg module-scratch-build
956 usage: centpkg module-scratch-build [-h] [--watch]
957 [--buildrequires name:stream]
958 [--requires name:stream]
959 [--optional key=value]
960 [--file [FILE_PATH]]
961 [--srpm SRPMS]
962 [scm_url] [branch]
963 Build a scratch module using MBS
965 positional arguments:
967 scm_url The module's SCM URL. This defaults to the
968 current repo.
969 branch The module's SCM branch. This defaults to
970 the current checked-out branch.
971 options:
973 -h, --help show this help message and exit
974 --watch, -w Watch the module build
975 --buildrequires name:stream
976 Buildrequires to override in the form of
977 "name:stream"
978 --requires name:stream
979 Requires to override in the form of
980 "name:stream"
981 --optional key=value MBS optional arguments in the form of
982 "key=value". For example: 'centpkg module-
983 build --optional
984 "reuse_components_from=<NSVC>"'. More
985 description including list of available
986 arguments here: https://pagure.io/fm-
987 orchestrator/
988 --file [FILE_PATH] The modulemd yaml file for module scratch
989 build.
990 --srpm SRPMS Include one or more srpms for module scratch
991 build.
992 centpkg new
995 usage: centpkg new [-h]
996 This will use git to show a diff of all the changes (even
998 uncommitted changes) since the last git tag was applied.
999 options:
1001 -h, --help show this help message and exit
1002 centpkg new-sources
1005 usage: centpkg new-sources [-h] files [files ...]
1006 This will upload new source file(s) to lookaside cache, and all file
1008 names listed in sources file will be replaced. .gitignore will be
1009 also updated with new uploaded file(s). Please remember to commit
1010 them.
1011 positional arguments:
1013 files
1014 options:
1016 -h, --help show this help message and exit
1017 centpkg patch
1020 usage: centpkg patch [-h] [--rediff] suffix
1021 Create and add a gendiff patch file.
1023 positional arguments:
1025 suffix Look for files with this suffix to diff
1026 options:
1028 -h, --help show this help message and exit
1029 --rediff Recreate gendiff file retaining comments Saves old
1030 patch file with a suffix of ~
1031 Patch file will be named: package-version-suffix.patch and the file
1033 will be added to the repo index
1034 centpkg prep
1037 usage: centpkg prep [-h] [--builddir BUILDDIR]
1038 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1039 [--define DEFINE]
1040 ...
1041 Use rpmbuild to "prep" the sources (unpack the source archive(s) and
1043 apply any patches.)
1044 positional arguments:
1046 extra_args Custom arguments that are passed to the
1047 'rpmbuild'. Use '--' to separate them from
1048 other arguments.
1049 options:
1051 -h, --help show this help message and exit
1052 --builddir BUILDDIR Define an alternate builddir
1053 --buildrootdir BUILDROOTDIR
1054 Define an alternate buildrootdir
1055 --arch ARCH Prep for a specific arch
1056 --define DEFINE Pass custom macros to rpmbuild, may specify
1057 multiple times
1058 centpkg pull
1061 usage: centpkg pull [-h] [--rebase] [--no-rebase]
1062 This command uses git to fetch remote changes and apply them to the
1064 current working copy. A rebase option is available which can be used
1065 to avoid merges.
1066 options:
1068 -h, --help show this help message and exit
1069 --rebase Rebase the locally committed changes on top of the
1070 remote changes after fetching. This can avoid a merge
1071 commit, but does rewrite local history.
1072 --no-rebase Do not rebase, overriding .git settings to the
1073 contrary
1074 See git pull --help for more details
1076 centpkg push
1079 usage: centpkg push [-h] [--force]
1080 Push changes to remote repository.
1082 options:
1084 -h, --help show this help message and exit
1085 --force, -f Force push
1086 centpkg remove-side-tag
1089 usage: centpkg remove-side-tag [-h] TAG
1090 Remove a side tag (without merging packages).
1092 positional arguments:
1094 TAG name of tag to be deleted
1095 options:
1097 -h, --help show this help message and exit
1098 centpkg request-gated-side-tag
1101 usage: centpkg request-gated-side-tag [-h] [--base-tag BASE_TAG]
1102 Create a new dynamic gated side tag.
1104 options:
1106 -h, --help show this help message and exit
1107 --base-tag BASE_TAG name of base tag
1108 centpkg request-side-tag
1111 usage: centpkg request-side-tag [-h] [--base-tag BASE_TAG]
1112 [--suffix SUFFIX]
1113 Create a new side tag.
1115 options:
1117 -h, --help show this help message and exit
1118 --base-tag BASE_TAG name of base tag
1119 --suffix SUFFIX A suffix to be appended to the side tag name.
1120 The suffix must be allowed in Koji
1121 configuration.
1122 centpkg retire
1125 usage: centpkg retire [-h] reason
1126 This command will remove all files from the repo, leave a
1128 dead.package file for rpms or dead.module file for modules, and push
1129 the changes.
1130 positional arguments:
1132 reason Reason for retiring the package/module
1133 options:
1135 -h, --help show this help message and exit
1136 centpkg scratch-build
1139 usage: centpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5]
1140 [--nowait] [--target TARGET]
1141 [--background] [--fail-fast]
1142 [--skip-remote-rules-validation]
1143 [--srpm [SRPM]]
1144 This command will request a scratch build of the package. Without
1146 providing an srpm, it will attempt to build the latest commit, which
1147 must have been pushed. By default all appropriate arches will be
1148 built.
1149 options:
1151 -h, --help show this help message and exit
1152 --arches [ARCHES ...]
1153 Build for specific arches
1154 --md5 Use md5 checksums (for older rpm hosts)
1155 --nowait Don't wait on build
1156 --target TARGET Define build target to build into
1157 --background Run the build at a low priority
1158 --fail-fast Fail the build immediately if any arch fails
1159 --skip-remote-rules-validation
1160 Don't check if there's a valid gating.yaml
1161 file in the repo, where you can define
1162 additional policies for Greenwave gating.
1163 --srpm [SRPM] Build from an srpm. If no srpm is provided
1164 with this option an srpm will be generated
1165 from the current module content.
1166 centpkg sources
1169 usage: centpkg sources [-h] [--outdir OUTDIR]
1170 Download source files
1172 options:
1174 -h, --help show this help message and exit
1175 --outdir OUTDIR Directory to download files into (defaults to
1176 pwd)
1177 centpkg srpm
1180 usage: centpkg srpm [-h] [--builddir BUILDDIR]
1181 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1182 [--define DEFINE] [--md5]
1183 ...
1184 Create a source rpm
1186 positional arguments:
1188 extra_args Custom arguments that are passed to the
1189 'rpmbuild'. Use '--' to separate them from
1190 other arguments.
1191 options:
1193 -h, --help show this help message and exit
1194 --builddir BUILDDIR Define an alternate builddir
1195 --buildrootdir BUILDROOTDIR
1196 Define an alternate buildrootdir
1197 --arch ARCH Prep for a specific arch
1198 --define DEFINE Pass custom macros to rpmbuild, may specify
1199 multiple times
1200 --md5 Use md5 checksums (for older rpm hosts)
1201 centpkg switch-branch
1204 usage: centpkg switch-branch [-h] [-l] [--fetch] [branch]
1205 This command can switch to a local git branch. If provided with a
1207 remote branch name that does not have a local match it will create
1208 one. It can also be used to list the existing local and remote
1209 branches.
1210 positional arguments:
1212 branch Branch name to switch to
1213 options:
1215 -h, --help show this help message and exit
1216 -l, --list List both remote-tracking branches and local branches
1217 --fetch Fetch new data from remote before switch
1218 centpkg tag
1221 usage: centpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE]
1222 [-l] [-d]
1223 [tag]
1224 This command uses git to create, list, or delete tags.
1226 positional arguments:
1228 tag Name of the tag
1229 options:
1231 -h, --help show this help message and exit
1232 -f, --force Force the creation of the tag
1233 -m MESSAGE, --message MESSAGE
1234 Use the given <msg> as the tag message
1235 -c, --clog Generate the tag message from the spec
1236 changelog section
1237 --raw Make the clog raw
1238 -F FILE, --file FILE Take the tag message from the given file
1239 -l, --list List all tags with a given pattern, or all
1240 if not pattern is given
1241 -d, --delete Delete a tag
1242 centpkg unused-patches
1245 usage: centpkg unused-patches [-h]
1246 Print list of patches not referenced by name in the specfile.
1248 options:
1250 -h, --help show this help message and exit
1251 centpkg upload
1254 usage: centpkg upload [-h] files [files ...]
1255 This command will upload new source file(s) to lookaside cache.
1257 Source file names are appended to sources file, and .gitignore will
1258 be also updated with new uploaded file(s). Please remember to commit
1259 them.
1260 positional arguments:
1262 files
1263 options:
1265 -h, --help show this help message and exit
1266 centpkg verify-files
1269 usage: centpkg verify-files [-h] [--builddir BUILDDIR]
1270 [--buildrootdir BUILDROOTDIR]
1271 [--arch ARCH] [--define DEFINE]
1272 ...
1273 Locally run 'rpmbuild -bl' to verify the spec file's %files
1275 sections. This requires a successful run of 'centpkg install' in
1276 advance.
1277 positional arguments:
1279 extra_args Custom arguments that are passed to the
1280 'rpmbuild'. Use '--' to separate them from
1281 other arguments.
1282 options:
1284 -h, --help show this help message and exit
1285 --builddir BUILDDIR Define an alternate builddir
1286 --buildrootdir BUILDROOTDIR
1287 Define an alternate buildrootdir
1288 --arch ARCH Prep for a specific arch
1289 --define DEFINE Pass custom macros to rpmbuild, may specify
1290 multiple times
1291 centpkg verrel
1294 usage: centpkg verrel [-h]
1295 Print the name-version-release.
1297 options:
1299 -h, --help show this help message and exit
1300
1303 https://git.centos.org/centos/centpkg
1304 2021-07-21 centpkg(1)