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 --dist DIST Deprecated. Use --release instead. You can
29 use --dist for a while for backward-
30 compatibility. It will be disabled in future
31 version.
32 --module-name MODULE_NAME
33 Deprecated. Use combination of --name and
34 --namespace. Override the module name.
35 Otherwise it is discovered from: Git push
36 URL or Git URL (last part of path with .git
37 extension removed) or from name macro in
38 spec file. In that order.
39 --name NAME Override repository name. Use --namespace
40 option to change namespace. If not
41 specified, name is discovered from Git push
42 URL or Git URL (last part of path with .git
43 extension removed) or from Name macro in
44 spec file, in that order.
45 --namespace NAMESPACE
46 The package repository namespace. If
47 omitted, default to rpms if namespace is
48 enabled.
49 --user USER Override the discovered user name
50 --password PASSWORD Password for Koji login
51 --runas RUNAS Run Koji commands as a different user
52 --path PATH Define the directory to work in (defaults to
53 cwd)
54 --verbose, -v Run with verbose debug output
55 --debug, -d Run with debug output
56 -q Run quietly only displaying errors
57
59 centpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait] [--target
60 TARGET] [--background] [--fail-fast] [--skip-remote-rules-validation]
61 [--skip-nvr-check] [--skip-tag] [--scratch] [--srpm [SRPM]]
62 Request build
63 centpkg chain-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
65 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
66 validation] [--skip-nvr-check] package [package ...]
67 Build current package in order with other packages
68 centpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t] [-F
70 FILE] [-p] [-s] [files ...]
71 Alias for commit
72 centpkg clean [-h] [--dry-run] [-x]
74 Remove untracked files
75 centpkg clog [-h] [--raw]
77 Make a clog file containing top changelog entry
78 centpkg clone [-h] [--branches] [--branch BRANCH] [--anonymous]
80 [--depth DEPTH] repo [clone_target] ...
81 Clone and checkout a repository
82 centpkg co [-h] [--branches] [--branch BRANCH] [--anonymous] [--depth
84 DEPTH] repo [clone_target] ...
85 Alias for clone
86 centpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t]
88 [-F FILE] [-p] [-s] [files ...]
89 Commit changes
90 centpkg compile [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOT‐
92 DIR] [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
93 Local test rpmbuild compile
94 centpkg container-build [-h] [--target TARGET] [--nowait] [--build-re‐
96 lease BUILD_RELEASE] [--isolated] [--koji-parent-build KOJI_PAR‐
97 ENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--repo-url URL [URL
98 ...]] [--signing-intent SIGNING_INTENT] [--skip-remote-rules-valida‐
99 tion] [--skip-build] [--compose-id COMPOSE_ID [COMPOSE_ID ...]] [--re‐
100 place-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MAN‐
101 AGER:NAME:VERSION[:NEW_NAME] ...]]
102 Build a container
103 centpkg container-build-setup [-h] (--get-autorebuild | --set-autore‐
105 build {true,false})
106 set options for container-build
107 centpkg copr-build [-h] [--config CONFIG] [--nowait] project
109 Build package in Copr
110 centpkg diff [-h] [--cached] [files ...]
112 Show changes between commits, commit and working tree, etc
113 centpkg flatpak-build [-h] [--target TARGET] [--nowait] [--build-re‐
115 lease BUILD_RELEASE] [--isolated] [--koji-parent-build KOJI_PAR‐
116 ENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--repo-url URL [URL
117 ...]] [--signing-intent SIGNING_INTENT] [--skip-remote-rules-valida‐
118 tion] [--skip-build]
119 Build a Flatpak
120 centpkg fork [-h]
122 Create a new fork of the current repository
123 centpkg gimmespec [-h]
125 Print the spec file name
126 centpkg gitbuildhash [-h] build
128 Print the git hash used to build the provided n-v-r
129 centpkg giturl [-h]
131 Print the git url for building
132 centpkg help [-h]
134 Show usage
135 centpkg import [-h] [--skip-diffs] [--offline] srpm
137 Import srpm content into a module
138 centpkg install [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOT‐
140 DIR] [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
141 Local test rpmbuild install
142 centpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
144 Run rpmlint against local spec and build output if present.
145 centpkg list-side-tags [-h] [--mine | --user TAG_OWNER | --base-tag
147 BASE_TAG]
148 List existing side-tags
149 centpkg local [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
151 [--arch ARCH] [--define DEFINE] [--md5] [--with BCOND_WITH] [--without
152 BCOND_WITHOUT] ...
153 Local test rpmbuild binary
154 centpkg mock-config [-h] [--target TARGET] [--arch ARCH]
156 Generate a mock config
157 centpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean] [--no-
159 cleanup-after] [--no-clean-all] [--with BCOND_WITH] [--without
160 BCOND_WITHOUT] [--shell] [--enablerepo ENABLEREPO] [--disablerepo DIS‐
161 ABLEREPO] [--enable-network] ...
162 Local test build using mock
163 centpkg module-build [-h] [--watch] [--buildrequires name:stream]
165 [--requires name:stream] [--optional key=value] [--file [FILE_PATH]]
166 [--srpm SRPMS] [--scratch] [scm_url] [branch]
167 Build a module using MBS
168 centpkg module-build-cancel [-h] build_id
170 Cancel an MBS module build
171 centpkg module-build-info [-h] build_id
173 Show information of an MBS module build
174 centpkg module-build-local [-h] [--file [FILE_PATH]] [--srpm SRPMS]
176 [--stream [STREAM]] [--skip-tests] [--add-local-build N:S:V] [-s N:S]
177 [--offline] [-r PATH]
178 Build a module locally using the mbs-manager command
179 centpkg module-build-watch [-h] build_id [build_id ...]
181 Watch an MBS build
182 centpkg module-overview [-h] [--unfinished] [--limit LIMIT] [--owner
184 FAS_ID | --mine]
185 Shows an overview of MBS builds
186 centpkg module-scratch-build [-h] [--watch] [--buildrequires
188 name:stream] [--requires name:stream] [--optional key=value] [--file
189 [FILE_PATH]] [--srpm SRPMS] [scm_url] [branch]
190 Build a scratch module using MBS
191 centpkg new [-h]
193 Diff against last tag
194 centpkg new-sources [-h] files [files ...]
196 Upload source files
197 centpkg patch [-h] [--rediff] suffix
199 Create and add a gendiff patch file
200 centpkg prep [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
202 [--arch ARCH] [--define DEFINE] ...
203 Local test rpmbuild prep
204 centpkg pull [-h] [--rebase] [--no-rebase]
206 Pull changes from the remote repository and update the working
207 copy.
208 centpkg push [-h] [--force]
210 Push changes to remote repository
211 centpkg remove-side-tag [-h] TAG
213 Remove a side tag (without merging packages)
214 centpkg request-side-tag [-h] [--base-tag BASE_TAG] [--suffix SUFFIX]
216 Create a new side tag
217 centpkg retire [-h] reason
219 Retire a package/module
220 centpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
222 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
223 validation] [--srpm [SRPM]]
224 Request scratch build
225 centpkg sources [-h] [--outdir OUTDIR]
227 Download source files
228 centpkg srpm [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
230 [--arch ARCH] [--define DEFINE] [--md5] ...
231 Create a source rpm
232 centpkg switch-branch [-h] [-l] [--fetch] [branch]
234 Work with branches
235 centpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l] [-d]
237 [tag]
238 Management of git tags
239 centpkg unused-patches [-h]
241 Print list of patches not referenced by name in the specfile
242 centpkg upload [-h] files [files ...]
244 Upload source files
245 centpkg verify-files [-h] [--builddir BUILDDIR] [--buildrootdir BUILD‐
247 ROOTDIR] [--arch ARCH] [--define DEFINE] ...
248 Locally verify %%files section
249 centpkg verrel [-h]
251 Print the name-version-release
252
254 centpkg build
255 usage: centpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
256 [--target TARGET] [--background] [--fail-fast]
257 [--skip-remote-rules-validation]
258 [--skip-nvr-check] [--skip-tag] [--scratch]
259 [--srpm [SRPM]]
260 This command requests a build of the package in the build system. By
262 default it discovers the target to build for based on branch data,
263 and uses the latest commit as the build source.
264 optional arguments:
266 -h, --help show this help message and exit
267 --arches [ARCHES ...]
268 Build for specific arches
269 --md5 Use md5 checksums (for older rpm hosts)
270 --nowait Don't wait on build
271 --target TARGET Define build target to build into
272 --background Run the build at a low priority
273 --fail-fast Fail the build immediately if any arch fails
274 --skip-remote-rules-validation
275 Don't check if there's a valid gating.yaml
276 file in the repo, where you can define
277 additional policies for Greenwave gating.
278 --skip-nvr-check Submit build to buildsystem without check if
279 NVR was already built. NVR is constructed
280 locally and may be different from NVR
281 constructed during build on builder.
282 --skip-tag Do not attempt to tag package
283 --scratch Perform a scratch build
284 --srpm [SRPM] Build from an srpm. If no srpm is provided
285 with this option an srpm will be generated
286 from current module content.
287 centpkg chain-build
290 usage: centpkg chain-build [-h] [--arches [ARCHES ...]] [--md5]
291 [--nowait] [--target TARGET]
292 [--background] [--fail-fast]
293 [--skip-remote-rules-validation]
294 [--skip-nvr-check]
295 package [package ...]
296 Build current package in order with other packages.
298 example: centpkg chain-build libwidget libgizmo
300 The current package is added to the end of the CHAIN list.
302 Colons (:) can be used in the CHAIN parameter to define groups of
303 packages. Packages in any single group will be built in parallel
304 and all packages in a group must build successfully and populate
305 the repository before the next group will begin building.
306 For example:
308 centpkg chain-build libwidget libaselib : libgizmo :
310 will cause libwidget and libaselib to be built in parallel, followed
312 by libgizmo and then the current directory package. If no groups are
313 defined, packages will be built sequentially.
314 positional arguments:
316 package List the packages and order you want to
317 build in
318 optional arguments:
320 -h, --help show this help message and exit
321 --arches [ARCHES ...]
322 Build for specific arches
323 --md5 Use md5 checksums (for older rpm hosts)
324 --nowait Don't wait on build
325 --target TARGET Define build target to build into
326 --background Run the build at a low priority
327 --fail-fast Fail the build immediately if any arch fails
328 --skip-remote-rules-validation
329 Don't check if there's a valid gating.yaml
330 file in the repo, where you can define
331 additional policies for Greenwave gating.
332 --skip-nvr-check Submit build to buildsystem without check if
333 NVR was already built. NVR is constructed
334 locally and may be different from NVR
335 constructed during build on builder.
336 centpkg ci
339 usage: centpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw]
340 [-t] [-F FILE] [-p] [-s]
341 [files ...]
342 Alias for commit.
344 positional arguments:
346 files Optional list of specific files to commit
347 optional arguments:
349 -h, --help show this help message and exit
350 -m MESSAGE, --message MESSAGE
351 Use the given <msg> as the commit message
352 summary
353 --with-changelog Get the last changelog from SPEC as commit
354 message content. This option must be used
355 with -m together.
356 -c, --clog Generate the commit message from the
357 Changelog section
358 --raw Make the clog raw
359 -t, --tag Create a tag for this commit
360 -F FILE, --file FILE Take the commit message from the given file
361 -p, --push Commit and push as one action
362 -s, --signoff Include a signed-off-by
363 centpkg clean
366 usage: centpkg clean [-h] [--dry-run] [-x]
367 This command can be used to clean up your working directory. By
369 default it will follow .gitignore rules.
370 optional arguments:
372 -h, --help show this help message and exit
373 --dry-run, -n Perform a dry-run
374 -x Do not follow .gitignore rules
375 centpkg clog
378 usage: centpkg clog [-h] [--raw]
379 This will create a file named "clog" that contains the latest rpm
381 changelog entry. The leading "- " text will be stripped.
382 optional arguments:
384 -h, --help show this help message and exit
385 --raw Generate a more "raw" clog without twiddling the
386 contents
387 centpkg clone
390 usage: centpkg clone [-h] [--branches] [--branch BRANCH]
391 [--anonymous] [--depth DEPTH]
392 repo [clone_target] ...
393 This command will clone the named repository from the configured
395 repository base URL. By default it will also checkout the master
396 branch for your working copy.
397 positional arguments:
399 repo Name of the repository to clone
400 clone_target Directory in which to clone the repository
401 extra_args Custom arguments that are passed to the 'git
402 clone'. Use '--' to separate them from other
403 arguments.
404 optional arguments:
406 -h, --help show this help message and exit
407 --branches, -B Do an old style checkout with subdirs for
408 branches
409 --branch BRANCH, -b BRANCH
410 Check out a specific branch
411 --anonymous, -a Check out a module anonymously
412 --depth DEPTH Create a shallow clone with a history
413 truncated to the specified number of commits
414 centpkg co
417 usage: centpkg co [-h] [--branches] [--branch BRANCH] [--anonymous]
418 [--depth DEPTH]
419 repo [clone_target] ...
420 Alias for clone.
422 positional arguments:
424 repo Name of the repository to clone
425 clone_target Directory in which to clone the repository
426 extra_args Custom arguments that are passed to the 'git
427 clone'. Use '--' to separate them from other
428 arguments.
429 optional arguments:
431 -h, --help show this help message and exit
432 --branches, -B Do an old style checkout with subdirs for
433 branches
434 --branch BRANCH, -b BRANCH
435 Check out a specific branch
436 --anonymous, -a Check out a module anonymously
437 --depth DEPTH Create a shallow clone with a history
438 truncated to the specified number of commits
439 centpkg commit
442 usage: centpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c]
443 [--raw] [-t] [-F FILE] [-p] [-s]
444 [files ...]
445 This invokes a git commit. All tracked files with changes will be
447 committed unless a specific file list is provided. $EDITOR will be
448 used to generate a changelog message unless one is given to the
449 command. A push can be done at the same time.
450 positional arguments:
452 files Optional list of specific files to commit
453 optional arguments:
455 -h, --help show this help message and exit
456 -m MESSAGE, --message MESSAGE
457 Use the given <msg> as the commit message
458 summary
459 --with-changelog Get the last changelog from SPEC as commit
460 message content. This option must be used
461 with -m together.
462 -c, --clog Generate the commit message from the
463 Changelog section
464 --raw Make the clog raw
465 -t, --tag Create a tag for this commit
466 -F FILE, --file FILE Take the commit message from the given file
467 -p, --push Commit and push as one action
468 -s, --signoff Include a signed-off-by
469 centpkg compile
472 usage: centpkg compile [-h] [--builddir BUILDDIR]
473 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
474 [--define DEFINE] [--short-circuit]
475 [--nocheck]
476 ...
477 This command calls rpmbuild to compile the source. By default the
479 prep and configure stages will be done as well, unless the short-
480 circuit option is used.
481 positional arguments:
483 extra_args Custom arguments that are passed to the
484 'rpmbuild'. Use '--' to separate them from
485 other arguments.
486 optional arguments:
488 -h, --help show this help message and exit
489 --builddir BUILDDIR Define an alternate builddir
490 --buildrootdir BUILDROOTDIR
491 Define an alternate buildrootdir
492 --arch ARCH Prep for a specific arch
493 --define DEFINE Pass custom macros to rpmbuild, may specify
494 multiple times
495 --short-circuit short-circuit compile
496 --nocheck nocheck compile
497 centpkg container-build
500 usage: centpkg container-build [-h] [--target TARGET] [--nowait]
501 [--build-release BUILD_RELEASE]
502 [--isolated]
503 [--koji-parent-build KOJI_PAR‐
504 ENT_BUILD]
505 [--scratch] [--arches [ARCHES ...]]
506 [--repo-url URL [URL ...]]
507 [--signing-intent SIGNING_INTENT]
508 [--skip-remote-rules-validation]
509 [--skip-build]
510 [--compose-id COMPOSE_ID [COMPOSE_ID
511 ...]]
512 [--replace-dependency PKG_MAN‐
513 AGER:NAME:VERSION[:NEW_NAME]
514 [PKG_MANAGER:NAME:VERSION[:NEW_NAME]
515 ...]]
516 Build a container
518 optional arguments:
520 -h, --help show this help message and exit
521 --target TARGET Override the default target
522 --nowait Don't wait on build
523 --build-release BUILD_RELEASE
524 Specify a release value for this build's NVR
525 --isolated Do not update floating tags in the registry.
526 You must use the --build-release argument
527 --koji-parent-build KOJI_PARENT_BUILD
528 Specify a Koji NVR for the parent container
529 image. This will override the "FROM" value
530 in your Dockerfile.
531 --scratch Scratch build
532 --arches [ARCHES ...]
533 Limit a scratch or a isolated build to an
534 arch. May have multiple arches.
535 --repo-url URL [URL ...]
536 URLs of yum repo files
537 --signing-intent SIGNING_INTENT
538 Signing intent of the ODCS composes.
539 --skip-remote-rules-validation
540 Don't check if there's a valid gating.yaml
541 file in the repo
542 --skip-build Don't create build, but just modify settings
543 for autorebuilds
544 --compose-id COMPOSE_ID [COMPOSE_ID ...]
545 ODCS composes used. Cannot be used with
546 --signing-intent
547 --replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MAN‐
548 AGER:NAME:VERSION[:NEW_NAME] ...]
549 Cachito dependency replacement
550 centpkg container-build-setup
553 usage: centpkg container-build-setup [-h]
554 (--get-autorebuild | --set-au‐
555 torebuild {true,false})
556 set options for container-build.
558 optional arguments:
560 -h, --help show this help message and exit
561 --get-autorebuild Get autorebuild value
562 --set-autorebuild {true,false}
563 Turn autorebuilds on/off
564 centpkg copr-build
567 usage: centpkg copr-build [-h] [--config CONFIG] [--nowait] project
568 Build package in Copr.
570 Note: you need to have set up correct api key. For more information
572 see API KEY section of copr-cli(1) man page.
573 positional arguments:
575 project Name of the project in format USER/PROJECT
576 optional arguments:
578 -h, --help show this help message and exit
579 --config CONFIG Path to an alternative Copr configuration file
580 --nowait Don't wait on build
581 centpkg diff
584 usage: centpkg diff [-h] [--cached] [files ...]
585 Use git diff to show changes that have been made to tracked files.
587 By default cached changes (changes that have been git added) will
588 not be shown.
589 positional arguments:
591 files Optionally diff specific files
592 optional arguments:
594 -h, --help show this help message and exit
595 --cached View staged changes
596 centpkg flatpak-build
599 usage: centpkg flatpak-build [-h] [--target TARGET] [--nowait]
600 [--build-release BUILD_RELEASE]
601 [--isolated]
602 [--koji-parent-build KOJI_PARENT_BUILD]
603 [--scratch] [--arches [ARCHES ...]]
604 [--repo-url URL [URL ...]]
605 [--signing-intent SIGNING_INTENT]
606 [--skip-remote-rules-validation]
607 [--skip-build]
608 Build a Flatpak
610 optional arguments:
612 -h, --help show this help message and exit
613 --target TARGET Override the default target
614 --nowait Don't wait on build
615 --build-release BUILD_RELEASE
616 Specify a release value for this build's NVR
617 --isolated Do not update floating tags in the registry.
618 You must use the --build-release argument
619 --koji-parent-build KOJI_PARENT_BUILD
620 Specify a Koji NVR for the parent container
621 image. This will override the "FROM" value
622 in your Dockerfile.
623 --scratch Scratch build
624 --arches [ARCHES ...]
625 Limit a scratch or a isolated build to an
626 arch. May have multiple arches.
627 --repo-url URL [URL ...]
628 URLs of yum repo files
629 --signing-intent SIGNING_INTENT
630 Signing intent of the ODCS composes.
631 --skip-remote-rules-validation
632 Don't check if there's a valid gating.yaml
633 file in the repo
634 --skip-build Don't create build, but just modify settings
635 for autorebuilds
636 centpkg fork
639 usage: centpkg fork [-h]
640 Create a new fork of the current repository
642 Before the operation, you need to generate an API token at
644 https://gitlab.com/-/profile/personal_access_tokens, select the "api"
645 scope and save it in your local user configuration located
646 at ~/.config/rpkg/centpkg.conf. For example:
647 [centpkg.distgit]
649 token = <api_key_here>
650 Below is a basic example of the command to fork a current repository:
652 centpkg fork
654 optional arguments:
656 -h, --help show this help message and exit
657 centpkg gimmespec
660 usage: centpkg gimmespec [-h]
661 Print the spec file name.
663 optional arguments:
665 -h, --help show this help message and exit
666 centpkg gitbuildhash
669 usage: centpkg gitbuildhash [-h] build
670 This will show you the commit hash string used to build the provided
672 build n-v-r
673 positional arguments:
675 build name-version-release of the build to query.
676 optional arguments:
678 -h, --help show this help message and exit
679 centpkg giturl
682 usage: centpkg giturl [-h]
683 This will show you which git URL would be used in a build command.
685 It uses the git hashsum of the HEAD of the current branch (which may
686 not be pushed).
687 optional arguments:
689 -h, --help show this help message and exit
690 centpkg help
693 usage: centpkg help [-h]
694 Show usage.
696 optional arguments:
698 -h, --help show this help message and exit
699 centpkg import
702 usage: centpkg import [-h] [--skip-diffs] [--offline] srpm
703 This will extract sources, patches, and the spec file from an srpm
705 and update the current module accordingly. It will import to the
706 current branch by default.
707 positional arguments:
709 srpm Source rpm to import
710 optional arguments:
712 -h, --help show this help message and exit
713 --skip-diffs Don't show diffs when import srpms
714 --offline Do not upload files into lookaside cache
715 centpkg install
718 usage: centpkg install [-h] [--builddir BUILDDIR]
719 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
720 [--define DEFINE] [--short-circuit]
721 [--nocheck]
722 ...
723 This will call rpmbuild to run the install section. All leading
725 sections will be processed as well, unless the short-circuit option
726 is used.
727 positional arguments:
729 extra_args Custom arguments that are passed to the
730 'rpmbuild'. Use '--' to separate them from
731 other arguments.
732 optional arguments:
734 -h, --help show this help message and exit
735 --builddir BUILDDIR Define an alternate builddir
736 --buildrootdir BUILDROOTDIR
737 Define an alternate buildrootdir
738 --arch ARCH Prep for a specific arch
739 --define DEFINE Pass custom macros to rpmbuild, may specify
740 multiple times
741 --short-circuit short-circuit install
742 --nocheck nocheck install
743 centpkg lint
746 usage: centpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
747 Rpmlint can be configured using the --rpmlintconf/-r option or by
749 setting a <pkgname>.rpmlintrc file in the working directory
750 optional arguments:
752 -h, --help show this help message and exit
753 --info, -i Display explanations for reported messages
754 --rpmlintconf RPMLINTCONF, -r RPMLINTCONF
755 Use a specific configuration file for
756 rpmlint
757 centpkg list-side-tags
760 usage: centpkg list-side-tags [-h]
761 [--mine | --user TAG_OWNER | --base-tag
762 BASE_TAG]
763 List existing side-tags.
765 optional arguments:
767 -h, --help show this help message and exit
768 --mine List only my side tags
769 --user TAG_OWNER List side tags created by this user
770 --base-tag BASE_TAG List only tags based on this base
771 centpkg local
774 usage: centpkg local [-h] [--builddir BUILDDIR]
775 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
776 [--define DEFINE] [--md5] [--with BCOND_WITH]
777 [--without BCOND_WITHOUT]
778 ...
779 Locally test run of rpmbuild producing binary RPMs. The rpmbuild
781 output will be logged into a file named
782 .build-%{version}-%{release}.log
783 positional arguments:
785 extra_args Custom arguments that are passed to the
786 'rpmbuild'. Use '--' to separate them from
787 other arguments.
788 optional arguments:
790 -h, --help show this help message and exit
791 --builddir BUILDDIR Define an alternate builddir
792 --buildrootdir BUILDROOTDIR
793 Define an alternate buildrootdir
794 --arch ARCH Prep for a specific arch
795 --define DEFINE Pass custom macros to rpmbuild, may specify
796 multiple times
797 --md5 Use md5 checksums (for older rpm hosts)
798 --with BCOND_WITH Enable configure option (bcond) for the
799 build
800 --without BCOND_WITHOUT
801 Disable configure option (bcond) for the
802 build
803 centpkg mock-config
806 usage: centpkg mock-config [-h] [--target TARGET] [--arch ARCH]
807 This will generate a mock config based on the buildsystem target
809 optional arguments:
811 -h, --help show this help message and exit
812 --target TARGET Override target used for config
813 --arch ARCH Override local arch
814 centpkg mockbuild
817 usage: centpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean]
818 [--no-cleanup-after] [--no-clean-all]
819 [--with BCOND_WITH]
820 [--without BCOND_WITHOUT] [--shell]
821 [--enablerepo ENABLEREPO]
822 [--disablerepo DISABLEREPO]
823 [--enable-network]
824 ...
825 This will use the mock utility to build the package for the
827 distribution detected from branch information. This can be
828 overridden using the global --release option. Your user must be in
829 the local "mock" group.
830 positional arguments:
832 extra_args Custom arguments that are passed to the
833 'mock'. Use '--' to separate them from other
834 arguments.
835 optional arguments:
837 -h, --help show this help message and exit
838 --root CONFIG, --mock-config CONFIG
839 Override mock configuration (like mock -r)
840 --md5 Use md5 checksums (for older rpm hosts)
841 --no-clean, -n Do not clean chroot before building package
842 --no-cleanup-after Do not clean chroot after building (if
843 automatic cleanup is enabled
844 --no-clean-all, -N Alias for both --no-clean and --no-cleanup-
845 after
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 --shell Run commands interactively within chroot.
852 Before going into chroot, mockbuild needs to
853 run with --no-cleanup-after in advanced.
854 --enablerepo ENABLEREPO
855 Pass enablerepo option to yum/dnf (may be
856 used more than once)
857 --disablerepo DISABLEREPO
858 Pass disablerepo option to yum/dnf (may be
859 used more than once)
860 --enable-network Enable networking
861 If config file for mock isn't found in the /etc/mock directory, a
863 temporary config directory for mock is created and populated with a
864 config file created with mock-config.
865 centpkg module-build
868 usage: centpkg module-build [-h] [--watch]
869 [--buildrequires name:stream]
870 [--requires name:stream]
871 [--optional key=value]
872 [--file [FILE_PATH]] [--srpm SRPMS]
873 [--scratch]
874 [scm_url] [branch]
875 Build a module using MBS
877 positional arguments:
879 scm_url The module's SCM URL. This defaults to the
880 current repo.
881 branch The module's SCM branch. This defaults to
882 the current checked-out branch.
883 optional arguments:
885 -h, --help show this help message and exit
886 --watch, -w Watch the module build
887 --buildrequires name:stream
888 Buildrequires to override in the form of
889 "name:stream"
890 --requires name:stream
891 Requires to override in the form of
892 "name:stream"
893 --optional key=value MBS optional arguments in the form of
894 "key=value". For example: 'centpkg module-
895 build --optional
896 "reuse_components_from=<NSVC>"'. More
897 description including list of available
898 arguments here: https://pagure.io/fm-
899 orchestrator/
900 --file [FILE_PATH] The modulemd yaml file for module scratch
901 build.
902 --srpm SRPMS Include one or more srpms for module scratch
903 build.
904 --scratch Perform a scratch build
905 centpkg module-build-cancel
908 usage: centpkg module-build-cancel [-h] build_id
909 Cancel an MBS module build
911 positional arguments:
913 build_id The ID of the module build to cancel
914 optional arguments:
916 -h, --help show this help message and exit
917 centpkg module-build-info
920 usage: centpkg module-build-info [-h] build_id
921 Show information of an MBS module build
923 positional arguments:
925 build_id The ID of the module build
926 optional arguments:
928 -h, --help show this help message and exit
929 centpkg module-build-local
932 usage: centpkg module-build-local [-h] [--file [FILE_PATH]]
933 [--srpm SRPMS] [--stream [STREAM]]
934 [--skip-tests]
935 [--add-local-build N:S:V] [-s N:S]
936 [--offline] [-r PATH]
937 Build a module locally using the mbs-manager command
939 optional arguments:
941 -h, --help show this help message and exit
942 --file [FILE_PATH] The module's modulemd yaml file. If not
943 specified, a yaml file with the same
944 basename as the name of the repository will
945 be used.
946 --srpm SRPMS Include one or more srpms for module build.
947 --stream [STREAM] The module's stream/SCM branch. This
948 defaults to the current checked-out branch.
949 --skip-tests Adds a macro for skipping the check section
950 --add-local-build N:S:V
951 Import previously finished local module
952 builds into MBS in the format of name:stream
953 or name:stream:version
954 -s N:S, --set-default-stream N:S
955 Set the default stream for given module
956 dependency in case there are multiple
957 streams to choose from.
958 --offline Builds module offline without any external
959 infrastructure
960 -r PATH, --repository PATH
961 Full path to .repo file defining the base
962 module repository to use when --offline is
963 used.
964 centpkg module-build-watch
967 usage: centpkg module-build-watch [-h] build_id [build_id ...]
968 Watch an MBS build
970 positional arguments:
972 build_id The ID of the module build to watch
973 optional arguments:
975 -h, --help show this help message and exit
976 centpkg module-overview
979 usage: centpkg module-overview [-h] [--unfinished] [--limit LIMIT]
980 [--owner FAS_ID | --mine]
981 Shows an overview of MBS builds
983 optional arguments:
985 -h, --help show this help message and exit
986 --unfinished Show unfinished module builds
987 --limit LIMIT The number of most recent module builds to display
988 --owner FAS_ID List only items of that owner
989 --mine Use current Kerberos name or username
990 centpkg module-scratch-build
993 usage: centpkg module-scratch-build [-h] [--watch]
994 [--buildrequires name:stream]
995 [--requires name:stream]
996 [--optional key=value]
997 [--file [FILE_PATH]]
998 [--srpm SRPMS]
999 [scm_url] [branch]
1000 Build a scratch module using MBS
1002 positional arguments:
1004 scm_url The module's SCM URL. This defaults to the
1005 current repo.
1006 branch The module's SCM branch. This defaults to
1007 the current checked-out branch.
1008 optional arguments:
1010 -h, --help show this help message and exit
1011 --watch, -w Watch the module build
1012 --buildrequires name:stream
1013 Buildrequires to override in the form of
1014 "name:stream"
1015 --requires name:stream
1016 Requires to override in the form of
1017 "name:stream"
1018 --optional key=value MBS optional arguments in the form of
1019 "key=value". For example: 'centpkg module-
1020 build --optional
1021 "reuse_components_from=<NSVC>"'. More
1022 description including list of available
1023 arguments here: https://pagure.io/fm-
1024 orchestrator/
1025 --file [FILE_PATH] The modulemd yaml file for module scratch
1026 build.
1027 --srpm SRPMS Include one or more srpms for module scratch
1028 build.
1029 centpkg new
1032 usage: centpkg new [-h]
1033 This will use git to show a diff of all the changes (even
1035 uncommitted changes) since the last git tag was applied.
1036 optional arguments:
1038 -h, --help show this help message and exit
1039 centpkg new-sources
1042 usage: centpkg new-sources [-h] files [files ...]
1043 This will upload new source file(s) to lookaside cache, and all file
1045 names listed in sources file will be replaced. .gitignore will be
1046 also updated with new uploaded file(s). Please remember to commit
1047 them.
1048 positional arguments:
1050 files
1051 optional arguments:
1053 -h, --help show this help message and exit
1054 centpkg patch
1057 usage: centpkg patch [-h] [--rediff] suffix
1058 Create and add a gendiff patch file.
1060 positional arguments:
1062 suffix Look for files with this suffix to diff
1063 optional arguments:
1065 -h, --help show this help message and exit
1066 --rediff Recreate gendiff file retaining comments Saves old
1067 patch file with a suffix of ~
1068 Patch file will be named: package-version-suffix.patch and the file
1070 will be added to the repo index
1071 centpkg prep
1074 usage: centpkg prep [-h] [--builddir BUILDDIR]
1075 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1076 [--define DEFINE]
1077 ...
1078 Use rpmbuild to "prep" the sources (unpack the source archive(s) and
1080 apply any patches.)
1081 positional arguments:
1083 extra_args Custom arguments that are passed to the
1084 'rpmbuild'. Use '--' to separate them from
1085 other arguments.
1086 optional arguments:
1088 -h, --help show this help message and exit
1089 --builddir BUILDDIR Define an alternate builddir
1090 --buildrootdir BUILDROOTDIR
1091 Define an alternate buildrootdir
1092 --arch ARCH Prep for a specific arch
1093 --define DEFINE Pass custom macros to rpmbuild, may specify
1094 multiple times
1095 centpkg pull
1098 usage: centpkg pull [-h] [--rebase] [--no-rebase]
1099 This command uses git to fetch remote changes and apply them to the
1101 current working copy. A rebase option is available which can be used
1102 to avoid merges.
1103 optional arguments:
1105 -h, --help show this help message and exit
1106 --rebase Rebase the locally committed changes on top of the
1107 remote changes after fetching. This can avoid a merge
1108 commit, but does rewrite local history.
1109 --no-rebase Do not rebase, overriding .git settings to the
1110 contrary
1111 See git pull --help for more details
1113 centpkg push
1116 usage: centpkg push [-h] [--force]
1117 Push changes to remote repository.
1119 optional arguments:
1121 -h, --help show this help message and exit
1122 --force, -f Force push
1123 centpkg remove-side-tag
1126 usage: centpkg remove-side-tag [-h] TAG
1127 Remove a side tag (without merging packages).
1129 positional arguments:
1131 TAG name of tag to be deleted
1132 optional arguments:
1134 -h, --help show this help message and exit
1135 centpkg request-side-tag
1138 usage: centpkg request-side-tag [-h] [--base-tag BASE_TAG]
1139 [--suffix SUFFIX]
1140 Create a new side tag.
1142 optional arguments:
1144 -h, --help show this help message and exit
1145 --base-tag BASE_TAG name of base tag
1146 --suffix SUFFIX A suffix to be appended to the side tag name.
1147 The suffix must be allowed in Koji
1148 configuration.
1149 centpkg retire
1152 usage: centpkg retire [-h] reason
1153 This command will remove all files from the repo, leave a
1155 dead.package file for rpms or dead.module file for modules, and push
1156 the changes.
1157 positional arguments:
1159 reason Reason for retiring the package/module
1160 optional arguments:
1162 -h, --help show this help message and exit
1163 centpkg scratch-build
1166 usage: centpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5]
1167 [--nowait] [--target TARGET]
1168 [--background] [--fail-fast]
1169 [--skip-remote-rules-validation]
1170 [--srpm [SRPM]]
1171 This command will request a scratch build of the package. Without
1173 providing an srpm, it will attempt to build the latest commit, which
1174 must have been pushed. By default all appropriate arches will be
1175 built.
1176 optional arguments:
1178 -h, --help show this help message and exit
1179 --arches [ARCHES ...]
1180 Build for specific arches
1181 --md5 Use md5 checksums (for older rpm hosts)
1182 --nowait Don't wait on build
1183 --target TARGET Define build target to build into
1184 --background Run the build at a low priority
1185 --fail-fast Fail the build immediately if any arch fails
1186 --skip-remote-rules-validation
1187 Don't check if there's a valid gating.yaml
1188 file in the repo, where you can define
1189 additional policies for Greenwave gating.
1190 --srpm [SRPM] Build from an srpm. If no srpm is provided
1191 with this option an srpm will be generated
1192 from the current module content.
1193 centpkg sources
1196 usage: centpkg sources [-h] [--outdir OUTDIR]
1197 Download source files
1199 optional arguments:
1201 -h, --help show this help message and exit
1202 --outdir OUTDIR Directory to download files into (defaults to
1203 pwd)
1204 centpkg srpm
1207 usage: centpkg srpm [-h] [--builddir BUILDDIR]
1208 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1209 [--define DEFINE] [--md5]
1210 ...
1211 Create a source rpm
1213 positional arguments:
1215 extra_args Custom arguments that are passed to the
1216 'rpmbuild'. Use '--' to separate them from
1217 other arguments.
1218 optional arguments:
1220 -h, --help show this help message and exit
1221 --builddir BUILDDIR Define an alternate builddir
1222 --buildrootdir BUILDROOTDIR
1223 Define an alternate buildrootdir
1224 --arch ARCH Prep for a specific arch
1225 --define DEFINE Pass custom macros to rpmbuild, may specify
1226 multiple times
1227 --md5 Use md5 checksums (for older rpm hosts)
1228 centpkg switch-branch
1231 usage: centpkg switch-branch [-h] [-l] [--fetch] [branch]
1232 This command can switch to a local git branch. If provided with a
1234 remote branch name that does not have a local match it will create
1235 one. It can also be used to list the existing local and remote
1236 branches.
1237 positional arguments:
1239 branch Branch name to switch to
1240 optional arguments:
1242 -h, --help show this help message and exit
1243 -l, --list List both remote-tracking branches and local branches
1244 --fetch Fetch new data from remote before switch
1245 centpkg tag
1248 usage: centpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE]
1249 [-l] [-d]
1250 [tag]
1251 This command uses git to create, list, or delete tags.
1253 positional arguments:
1255 tag Name of the tag
1256 optional arguments:
1258 -h, --help show this help message and exit
1259 -f, --force Force the creation of the tag
1260 -m MESSAGE, --message MESSAGE
1261 Use the given <msg> as the tag message
1262 -c, --clog Generate the tag message from the spec
1263 changelog section
1264 --raw Make the clog raw
1265 -F FILE, --file FILE Take the tag message from the given file
1266 -l, --list List all tags with a given pattern, or all
1267 if not pattern is given
1268 -d, --delete Delete a tag
1269 centpkg unused-patches
1272 usage: centpkg unused-patches [-h]
1273 Print list of patches not referenced by name in the specfile.
1275 optional arguments:
1277 -h, --help show this help message and exit
1278 centpkg upload
1281 usage: centpkg upload [-h] files [files ...]
1282 This command will upload new source file(s) to lookaside cache.
1284 Source file names are appended to sources file, and .gitignore will
1285 be also updated with new uploaded file(s). Please remember to commit
1286 them.
1287 positional arguments:
1289 files
1290 optional arguments:
1292 -h, --help show this help message and exit
1293 centpkg verify-files
1296 usage: centpkg verify-files [-h] [--builddir BUILDDIR]
1297 [--buildrootdir BUILDROOTDIR]
1298 [--arch ARCH] [--define DEFINE]
1299 ...
1300 Locally run 'rpmbuild -bl' to verify the spec file's %files
1302 sections. This requires a successful run of 'centpkg install' in
1303 advance.
1304 positional arguments:
1306 extra_args Custom arguments that are passed to the
1307 'rpmbuild'. Use '--' to separate them from
1308 other arguments.
1309 optional arguments:
1311 -h, --help show this help message and exit
1312 --builddir BUILDDIR Define an alternate builddir
1313 --buildrootdir BUILDROOTDIR
1314 Define an alternate buildrootdir
1315 --arch ARCH Prep for a specific arch
1316 --define DEFINE Pass custom macros to rpmbuild, may specify
1317 multiple times
1318 centpkg verrel
1321 usage: centpkg verrel [-h]
1322 Print the name-version-release.
1324 optional arguments:
1326 -h, --help show this help message and exit
1327
1330 https://git.centos.org/centos/centpkg
1331 2021-05-25 centpkg(1)