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

COMMAND OVERVIEW

19       centpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait] [--target
20       TARGET]  [--background]  [--fail-fast] [--skip-remote-rules-validation]
21       [--skip-nvr-check] [--skip-tag] [--scratch] [--srpm [SRPM]]
22              Request build
23
24       centpkg chain-build [-h] [--arches  [ARCHES  ...]]  [--md5]  [--nowait]
25       [--target  TARGET]  [--background]  [--fail-fast] [--skip-remote-rules-
26       validation] [--skip-nvr-check] package [package ...]
27              Build current package in order with other packages
28
29       centpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw]  [-t]  [-F
30       FILE] [-p] [-s] [files ...]
31              Alias for commit
32
33       centpkg clean [-h] [--dry-run] [-x]
34              Remove untracked files
35
36       centpkg clog [-h] [--raw]
37              Make a clog file containing top changelog entry
38
39       centpkg   clone   [-h]  [--branches]  [--branch  BRANCH]  [--anonymous]
40       [--depth DEPTH] repo [clone_target] ...
41              Clone and checkout a repository
42
43       centpkg co [-h] [--branches] [--branch BRANCH]  [--anonymous]  [--depth
44       DEPTH] repo [clone_target] ...
45              Alias for clone
46
47       centpkg  commit  [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t]
48       [-F FILE] [-p] [-s] [files ...]
49              Commit changes
50
51       centpkg compile [-h] [--builddir BUILDDIR]  [--buildrootdir  BUILDROOT‐
52       DIR] [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
53              Local test rpmbuild compile
54
55       centpkg  container-build [-h] [--target TARGET] [--nowait] [--build-re‐
56       lease  BUILD_RELEASE]   [--isolated]   [--koji-parent-build   KOJI_PAR‐
57       ENT_BUILD]  [--scratch]  [--arches  [ARCHES  ...]] [--repo-url URL [URL
58       ...]]  [--signing-intent  SIGNING_INTENT]  [--skip-remote-rules-valida‐
59       tion]  [--skip-build] [--compose-id COMPOSE_ID [COMPOSE_ID ...]] [--re‐
60       place-dependency     PKG_MANAGER:NAME:VERSION[:NEW_NAME]      [PKG_MAN‐
61       AGER:NAME:VERSION[:NEW_NAME] ...]]
62              Build a container
63
64       centpkg  container-build-setup  [-h] (--get-autorebuild | --set-autore‐
65       build {true,false})
66              set options for container-build
67
68       centpkg copr-build [-h] [--config CONFIG] [--nowait] project
69              Build package in Copr
70
71       centpkg diff [-h] [--cached] [files ...]
72              Show changes between commits, commit and working tree, etc
73
74       centpkg flatpak-build [-h] [--target  TARGET]  [--nowait]  [--build-re‐
75       lease   BUILD_RELEASE]   [--isolated]   [--koji-parent-build  KOJI_PAR‐
76       ENT_BUILD] [--scratch] [--arches [ARCHES  ...]]  [--repo-url  URL  [URL
77       ...]]  [--signing-intent  SIGNING_INTENT]  [--skip-remote-rules-valida‐
78       tion] [--skip-build]
79              Build a Flatpak
80
81       centpkg fork [-h]
82              Create a new fork of the current repository
83
84       centpkg gimmespec [-h]
85              Print the spec file name
86
87       centpkg gitbuildhash [-h] build
88              Print the git hash used to build the provided n-v-r
89
90       centpkg giturl [-h]
91              Print the git url for building
92
93       centpkg help [-h]
94              Show usage
95
96       centpkg import [-h] [--skip-diffs] [--offline] srpm
97              Import srpm content into a module
98
99       centpkg install [-h] [--builddir BUILDDIR]  [--buildrootdir  BUILDROOT‐
100       DIR] [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
101              Local test rpmbuild install
102
103       centpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
104              Run rpmlint against local spec and build output if present.
105
106       centpkg  list-side-tags  [-h]  [--mine  | --user TAG_OWNER | --base-tag
107       BASE_TAG]
108              List existing side-tags
109
110       centpkg local [-h] [--builddir BUILDDIR] [--buildrootdir  BUILDROOTDIR]
111       [--arch  ARCH] [--define DEFINE] [--md5] [--with BCOND_WITH] [--without
112       BCOND_WITHOUT] ...
113              Local test rpmbuild binary
114
115       centpkg mock-config [-h] [--target TARGET] [--arch ARCH]
116              Generate a mock config
117
118       centpkg mockbuild [-h]  [--root  CONFIG]  [--md5]  [--no-clean]  [--no-
119       cleanup-after]    [--no-clean-all]   [--with   BCOND_WITH]   [--without
120       BCOND_WITHOUT] [--shell] [--enablerepo ENABLEREPO] [--disablerepo  DIS‐
121       ABLEREPO] [--enable-network] ...
122              Local test build using mock
123
124       centpkg   module-build  [-h]  [--watch]  [--buildrequires  name:stream]
125       [--requires name:stream] [--optional  key=value]  [--file  [FILE_PATH]]
126       [--srpm SRPMS] [--scratch] [scm_url] [branch]
127              Build a module using MBS
128
129       centpkg module-build-cancel [-h] build_id
130              Cancel an MBS module build
131
132       centpkg module-build-info [-h] build_id
133              Show information of an MBS module build
134
135       centpkg  module-build-local  [-h]  [--file  [FILE_PATH]] [--srpm SRPMS]
136       [--stream [STREAM]] [--skip-tests] [--add-local-build N:S:V]  [-s  N:S]
137       [--offline] [-r PATH]
138              Build a module locally using the mbs-manager command
139
140       centpkg module-build-watch [-h] build_id [build_id ...]
141              Watch an MBS build
142
143       centpkg  module-overview  [-h]  [--unfinished] [--limit LIMIT] [--owner
144       FAS_ID | --mine]
145              Shows an overview of MBS builds
146
147       centpkg   module-scratch-build    [-h]    [--watch]    [--buildrequires
148       name:stream]  [--requires  name:stream]  [--optional key=value] [--file
149       [FILE_PATH]] [--srpm SRPMS] [scm_url] [branch]
150              Build a scratch module using MBS
151
152       centpkg new [-h]
153              Diff against last tag
154
155       centpkg new-sources [-h] files [files ...]
156              Upload source files
157
158       centpkg patch [-h] [--rediff] suffix
159              Create and add a gendiff patch file
160
161       centpkg prep [-h] [--builddir BUILDDIR]  [--buildrootdir  BUILDROOTDIR]
162       [--arch ARCH] [--define DEFINE] ...
163              Local test rpmbuild prep
164
165       centpkg pull [-h] [--rebase] [--no-rebase]
166              Pull  changes  from the remote repository and update the working
167              copy.
168
169       centpkg push [-h] [--force]
170              Push changes to remote repository
171
172       centpkg remove-side-tag [-h] TAG
173              Remove a side tag (without merging packages)
174
175       centpkg request-gated-side-tag [-h] [--base-tag BASE_TAG]
176              Create a new dynamic gated side tag
177
178       centpkg request-side-tag [-h] [--base-tag BASE_TAG] [--suffix SUFFIX]
179              Create a new side tag
180
181       centpkg retire [-h] reason
182              Retire a package/module
183
184       centpkg scratch-build [-h] [--arches [ARCHES ...]]  [--md5]  [--nowait]
185       [--target  TARGET]  [--background]  [--fail-fast] [--skip-remote-rules-
186       validation] [--srpm [SRPM]]
187              Request scratch build
188
189       centpkg sources [-h] [--outdir OUTDIR]
190              Download source files
191
192       centpkg srpm [-h] [--builddir BUILDDIR]  [--buildrootdir  BUILDROOTDIR]
193       [--arch ARCH] [--define DEFINE] [--md5] ...
194              Create a source rpm
195
196       centpkg switch-branch [-h] [-l] [--fetch] [branch]
197              Work with branches
198
199       centpkg  tag  [-h]  [-f]  [-m MESSAGE] [-c] [--raw] [-F FILE] [-l] [-d]
200       [tag]
201              Management of git tags
202
203       centpkg unused-patches [-h]
204              Print list of patches not referenced by name in the specfile
205
206       centpkg upload [-h] files [files ...]
207              Upload source files
208
209       centpkg verify-files [-h] [--builddir BUILDDIR] [--buildrootdir  BUILD‐
210       ROOTDIR] [--arch ARCH] [--define DEFINE] ...
211              Locally verify %%files section
212
213       centpkg verrel [-h]
214              Print the name-version-release
215

COMMAND REFERENCE

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

SEE ALSO

1303       https://git.centos.org/centos/centpkg
1304
1305
1306
1307                                  2021-07-21                        centpkg(1)
Impressum