1centpkg(1)                       rpm-packager                       centpkg(1)
2
3
4

NAME

6       centpkg - RPM Packaging utility
7

SYNOPSIS

9       centpkg  [ global_options ] command [ command_options ] [ command_argu‐
10       ments ]
11       centpkg help
12       centpkg command --help
13

DESCRIPTION

15       centpkg is a script to interact with the RPM Packaging system.
16
17   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

COMMAND OVERVIEW

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
64       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
69       centpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw]  [-t]  [-F
70       FILE] [-p] [-s] [files ...]
71              Alias for commit
72
73       centpkg clean [-h] [--dry-run] [-x]
74              Remove untracked files
75
76       centpkg clog [-h] [--raw]
77              Make a clog file containing top changelog entry
78
79       centpkg   clone   [-h]  [--branches]  [--branch  BRANCH]  [--anonymous]
80       [--depth DEPTH] repo [clone_target] ...
81              Clone and checkout a repository
82
83       centpkg co [-h] [--branches] [--branch BRANCH]  [--anonymous]  [--depth
84       DEPTH] repo [clone_target] ...
85              Alias for clone
86
87       centpkg  commit  [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t]
88       [-F FILE] [-p] [-s] [files ...]
89              Commit changes
90
91       centpkg compile [-h] [--builddir BUILDDIR]  [--buildrootdir  BUILDROOT‐
92       DIR] [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
93              Local test rpmbuild compile
94
95       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
104       centpkg  container-build-setup  [-h] (--get-autorebuild | --set-autore‐
105       build {true,false})
106              set options for container-build
107
108       centpkg copr-build [-h] [--config CONFIG] [--nowait] project
109              Build package in Copr
110
111       centpkg diff [-h] [--cached] [files ...]
112              Show changes between commits, commit and working tree, etc
113
114       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
121       centpkg fork [-h]
122              Create a new fork of the current repository
123
124       centpkg gimmespec [-h]
125              Print the spec file name
126
127       centpkg gitbuildhash [-h] build
128              Print the git hash used to build the provided n-v-r
129
130       centpkg giturl [-h]
131              Print the git url for building
132
133       centpkg help [-h]
134              Show usage
135
136       centpkg import [-h] [--skip-diffs] [--offline] srpm
137              Import srpm content into a module
138
139       centpkg install [-h] [--builddir BUILDDIR]  [--buildrootdir  BUILDROOT‐
140       DIR] [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
141              Local test rpmbuild install
142
143       centpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
144              Run rpmlint against local spec and build output if present.
145
146       centpkg  list-side-tags  [-h]  [--mine  | --user TAG_OWNER | --base-tag
147       BASE_TAG]
148              List existing side-tags
149
150       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
155       centpkg mock-config [-h] [--target TARGET] [--arch ARCH]
156              Generate a mock config
157
158       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
164       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
169       centpkg module-build-cancel [-h] build_id
170              Cancel an MBS module build
171
172       centpkg module-build-info [-h] build_id
173              Show information of an MBS module build
174
175       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
180       centpkg module-build-watch [-h] build_id [build_id ...]
181              Watch an MBS build
182
183       centpkg  module-overview  [-h]  [--unfinished] [--limit LIMIT] [--owner
184       FAS_ID | --mine]
185              Shows an overview of MBS builds
186
187       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
192       centpkg new [-h]
193              Diff against last tag
194
195       centpkg new-sources [-h] files [files ...]
196              Upload source files
197
198       centpkg patch [-h] [--rediff] suffix
199              Create and add a gendiff patch file
200
201       centpkg prep [-h] [--builddir BUILDDIR]  [--buildrootdir  BUILDROOTDIR]
202       [--arch ARCH] [--define DEFINE] ...
203              Local test rpmbuild prep
204
205       centpkg pull [-h] [--rebase] [--no-rebase]
206              Pull  changes  from the remote repository and update the working
207              copy.
208
209       centpkg push [-h] [--force]
210              Push changes to remote repository
211
212       centpkg remove-side-tag [-h] TAG
213              Remove a side tag (without merging packages)
214
215       centpkg request-side-tag [-h] [--base-tag BASE_TAG] [--suffix SUFFIX]
216              Create a new side tag
217
218       centpkg retire [-h] reason
219              Retire a package/module
220
221       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
226       centpkg sources [-h] [--outdir OUTDIR]
227              Download source files
228
229       centpkg srpm [-h] [--builddir BUILDDIR]  [--buildrootdir  BUILDROOTDIR]
230       [--arch ARCH] [--define DEFINE] [--md5] ...
231              Create a source rpm
232
233       centpkg switch-branch [-h] [-l] [--fetch] [branch]
234              Work with branches
235
236       centpkg  tag  [-h]  [-f]  [-m MESSAGE] [-c] [--raw] [-F FILE] [-l] [-d]
237       [tag]
238              Management of git tags
239
240       centpkg unused-patches [-h]
241              Print list of patches not referenced by name in the specfile
242
243       centpkg upload [-h] files [files ...]
244              Upload source files
245
246       centpkg verify-files [-h] [--builddir BUILDDIR] [--buildrootdir  BUILD‐
247       ROOTDIR] [--arch ARCH] [--define DEFINE] ...
248              Locally verify %%files section
249
250       centpkg verrel [-h]
251              Print the name-version-release
252

COMMAND REFERENCE

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
261         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
265         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
288
289   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
297         Build current package in order with other packages.
298
299         example: centpkg chain-build libwidget libgizmo
300
301         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
307         For example:
308
309         centpkg chain-build libwidget libaselib : libgizmo :
310
311         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
315         positional arguments:
316           package               List the packages and order you want to
317                                 build in
318
319         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
337
338   centpkg ci
339         usage: centpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw]
340                           [-t] [-F FILE] [-p] [-s]
341                           [files ...]
342
343         Alias for commit.
344
345         positional arguments:
346           files                 Optional list of specific files to commit
347
348         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
364
365   centpkg clean
366         usage: centpkg clean [-h] [--dry-run] [-x]
367
368         This command can be used to clean up your working directory. By
369         default it will follow .gitignore rules.
370
371         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
376
377   centpkg clog
378         usage: centpkg clog [-h] [--raw]
379
380         This will create a file named "clog" that contains the latest rpm
381         changelog entry. The leading "- " text will be stripped.
382
383         optional arguments:
384           -h, --help  show this help message and exit
385           --raw       Generate a more "raw" clog without twiddling the
386                       contents
387
388
389   centpkg clone
390         usage: centpkg clone [-h] [--branches] [--branch BRANCH]
391                              [--anonymous] [--depth DEPTH]
392                              repo [clone_target] ...
393
394         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
398         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
405         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
415
416   centpkg co
417         usage: centpkg co [-h] [--branches] [--branch BRANCH] [--anonymous]
418                           [--depth DEPTH]
419                           repo [clone_target] ...
420
421         Alias for clone.
422
423         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
430         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
440
441   centpkg commit
442         usage: centpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c]
443                               [--raw] [-t] [-F FILE] [-p] [-s]
444                               [files ...]
445
446         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
451         positional arguments:
452           files                 Optional list of specific files to commit
453
454         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
470
471   centpkg compile
472         usage: centpkg compile [-h] [--builddir BUILDDIR]
473                                [--buildrootdir BUILDROOTDIR] [--arch ARCH]
474                                [--define DEFINE] [--short-circuit]
475                                [--nocheck]
476                                ...
477
478         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
482         positional arguments:
483           extra_args            Custom arguments that are passed to the
484                                 'rpmbuild'. Use '--' to separate them from
485                                 other arguments.
486
487         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
498
499   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
517         Build a container
518
519         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
551
552   centpkg container-build-setup
553         usage: centpkg container-build-setup [-h]
554                                              (--get-autorebuild  |  --set-au‐
555       torebuild {true,false})
556
557         set options for container-build.
558
559         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
565
566   centpkg copr-build
567         usage: centpkg copr-build [-h] [--config CONFIG] [--nowait] project
568
569         Build package in Copr.
570
571         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
574         positional arguments:
575           project          Name of the project in format USER/PROJECT
576
577         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
582
583   centpkg diff
584         usage: centpkg diff [-h] [--cached] [files ...]
585
586         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
590         positional arguments:
591           files       Optionally diff specific files
592
593         optional arguments:
594           -h, --help  show this help message and exit
595           --cached    View staged changes
596
597
598   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
609         Build a Flatpak
610
611         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
637
638   centpkg fork
639         usage: centpkg fork [-h]
640
641         Create a new fork of the current repository
642
643         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
648             [centpkg.distgit]
649             token = <api_key_here>
650
651         Below is a basic example of the command to fork a current repository:
652
653             centpkg fork
654
655         optional arguments:
656           -h, --help  show this help message and exit
657
658
659   centpkg gimmespec
660         usage: centpkg gimmespec [-h]
661
662         Print the spec file name.
663
664         optional arguments:
665           -h, --help  show this help message and exit
666
667
668   centpkg gitbuildhash
669         usage: centpkg gitbuildhash [-h] build
670
671         This will show you the commit hash string used to build the provided
672         build n-v-r
673
674         positional arguments:
675           build       name-version-release of the build to query.
676
677         optional arguments:
678           -h, --help  show this help message and exit
679
680
681   centpkg giturl
682         usage: centpkg giturl [-h]
683
684         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
688         optional arguments:
689           -h, --help  show this help message and exit
690
691
692   centpkg help
693         usage: centpkg help [-h]
694
695         Show usage.
696
697         optional arguments:
698           -h, --help  show this help message and exit
699
700
701   centpkg import
702         usage: centpkg import [-h] [--skip-diffs] [--offline] srpm
703
704         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
708         positional arguments:
709           srpm          Source rpm to import
710
711         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
716
717   centpkg install
718         usage: centpkg install [-h] [--builddir BUILDDIR]
719                                [--buildrootdir BUILDROOTDIR] [--arch ARCH]
720                                [--define DEFINE] [--short-circuit]
721                                [--nocheck]
722                                ...
723
724         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
728         positional arguments:
729           extra_args            Custom arguments that are passed to the
730                                 'rpmbuild'. Use '--' to separate them from
731                                 other arguments.
732
733         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
744
745   centpkg lint
746         usage: centpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
747
748         Rpmlint can be configured using the --rpmlintconf/-r option or by
749         setting a <pkgname>.rpmlintrc file in the working directory
750
751         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
758
759   centpkg list-side-tags
760         usage: centpkg list-side-tags [-h]
761                                       [--mine | --user TAG_OWNER | --base-tag
762       BASE_TAG]
763
764         List existing side-tags.
765
766         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
772
773   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
780         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
784         positional arguments:
785           extra_args            Custom arguments that are passed to the
786                                 'rpmbuild'. Use '--' to separate them from
787                                 other arguments.
788
789         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
804
805   centpkg mock-config
806         usage: centpkg mock-config [-h] [--target TARGET] [--arch ARCH]
807
808         This will generate a mock config based on the buildsystem target
809
810         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
815
816   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
826         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
831         positional arguments:
832           extra_args            Custom arguments that are passed to the
833                                 'mock'. Use '--' to separate them from other
834                                 arguments.
835
836         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
862         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
866
867   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
876         Build a module using MBS
877
878         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
884         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
906
907   centpkg module-build-cancel
908         usage: centpkg module-build-cancel [-h] build_id
909
910         Cancel an MBS module build
911
912         positional arguments:
913           build_id    The ID of the module build to cancel
914
915         optional arguments:
916           -h, --help  show this help message and exit
917
918
919   centpkg module-build-info
920         usage: centpkg module-build-info [-h] build_id
921
922         Show information of an MBS module build
923
924         positional arguments:
925           build_id    The ID of the module build
926
927         optional arguments:
928           -h, --help  show this help message and exit
929
930
931   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
938         Build a module locally using the mbs-manager command
939
940         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
965
966   centpkg module-build-watch
967         usage: centpkg module-build-watch [-h] build_id [build_id ...]
968
969         Watch an MBS build
970
971         positional arguments:
972           build_id    The ID of the module build to watch
973
974         optional arguments:
975           -h, --help  show this help message and exit
976
977
978   centpkg module-overview
979         usage: centpkg module-overview [-h] [--unfinished] [--limit LIMIT]
980                                        [--owner FAS_ID | --mine]
981
982         Shows an overview of MBS builds
983
984         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
991
992   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
1001         Build a scratch module using MBS
1002
1003         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
1009         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
1030
1031   centpkg new
1032         usage: centpkg new [-h]
1033
1034         This will use git to show a diff of all the changes (even
1035         uncommitted changes) since the last git tag was applied.
1036
1037         optional arguments:
1038           -h, --help  show this help message and exit
1039
1040
1041   centpkg new-sources
1042         usage: centpkg new-sources [-h] files [files ...]
1043
1044         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
1049         positional arguments:
1050           files
1051
1052         optional arguments:
1053           -h, --help  show this help message and exit
1054
1055
1056   centpkg patch
1057         usage: centpkg patch [-h] [--rediff] suffix
1058
1059         Create and add a gendiff patch file.
1060
1061         positional arguments:
1062           suffix      Look for files with this suffix to diff
1063
1064         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
1069         Patch file will be named: package-version-suffix.patch and the file
1070         will be added to the repo index
1071
1072
1073   centpkg prep
1074         usage: centpkg prep [-h] [--builddir BUILDDIR]
1075                             [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1076                             [--define DEFINE]
1077                             ...
1078
1079         Use rpmbuild to "prep" the sources (unpack the source archive(s) and
1080         apply any patches.)
1081
1082         positional arguments:
1083           extra_args            Custom arguments that are passed to the
1084                                 'rpmbuild'. Use '--' to separate them from
1085                                 other arguments.
1086
1087         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
1096
1097   centpkg pull
1098         usage: centpkg pull [-h] [--rebase] [--no-rebase]
1099
1100         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
1104         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
1112         See git pull --help for more details
1113
1114
1115   centpkg push
1116         usage: centpkg push [-h] [--force]
1117
1118         Push changes to remote repository.
1119
1120         optional arguments:
1121           -h, --help   show this help message and exit
1122           --force, -f  Force push
1123
1124
1125   centpkg remove-side-tag
1126         usage: centpkg remove-side-tag [-h] TAG
1127
1128         Remove a side tag (without merging packages).
1129
1130         positional arguments:
1131           TAG         name of tag to be deleted
1132
1133         optional arguments:
1134           -h, --help  show this help message and exit
1135
1136
1137   centpkg request-side-tag
1138         usage: centpkg request-side-tag [-h] [--base-tag BASE_TAG]
1139                                         [--suffix SUFFIX]
1140
1141         Create a new side tag.
1142
1143         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
1150
1151   centpkg retire
1152         usage: centpkg retire [-h] reason
1153
1154         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
1158         positional arguments:
1159           reason      Reason for retiring the package/module
1160
1161         optional arguments:
1162           -h, --help  show this help message and exit
1163
1164
1165   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
1172         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
1177         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
1194
1195   centpkg sources
1196         usage: centpkg sources [-h] [--outdir OUTDIR]
1197
1198         Download source files
1199
1200         optional arguments:
1201           -h, --help       show this help message and exit
1202           --outdir OUTDIR  Directory to download files into (defaults to
1203                            pwd)
1204
1205
1206   centpkg srpm
1207         usage: centpkg srpm [-h] [--builddir BUILDDIR]
1208                             [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1209                             [--define DEFINE] [--md5]
1210                             ...
1211
1212         Create a source rpm
1213
1214         positional arguments:
1215           extra_args            Custom arguments that are passed to the
1216                                 'rpmbuild'. Use '--' to separate them from
1217                                 other arguments.
1218
1219         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
1229
1230   centpkg switch-branch
1231         usage: centpkg switch-branch [-h] [-l] [--fetch] [branch]
1232
1233         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
1238         positional arguments:
1239           branch      Branch name to switch to
1240
1241         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
1246
1247   centpkg tag
1248         usage: centpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE]
1249                            [-l] [-d]
1250                            [tag]
1251
1252         This command uses git to create, list, or delete tags.
1253
1254         positional arguments:
1255           tag                   Name of the tag
1256
1257         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
1270
1271   centpkg unused-patches
1272         usage: centpkg unused-patches [-h]
1273
1274         Print list of patches not referenced by name in the specfile.
1275
1276         optional arguments:
1277           -h, --help  show this help message and exit
1278
1279
1280   centpkg upload
1281         usage: centpkg upload [-h] files [files ...]
1282
1283         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
1288         positional arguments:
1289           files
1290
1291         optional arguments:
1292           -h, --help  show this help message and exit
1293
1294
1295   centpkg verify-files
1296         usage: centpkg verify-files [-h] [--builddir BUILDDIR]
1297                                     [--buildrootdir BUILDROOTDIR]
1298                                     [--arch ARCH] [--define DEFINE]
1299                                     ...
1300
1301         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
1305         positional arguments:
1306           extra_args            Custom arguments that are passed to the
1307                                 'rpmbuild'. Use '--' to separate them from
1308                                 other arguments.
1309
1310         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
1319
1320   centpkg verrel
1321         usage: centpkg verrel [-h]
1322
1323         Print the name-version-release.
1324
1325         optional arguments:
1326           -h, --help  show this help message and exit
1327
1328

SEE ALSO

1330       https://git.centos.org/centos/centpkg
1331
1332
1333
1334                                  2021-05-25                        centpkg(1)
Impressum