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

NAME

6       fedpkg - RPM Packaging utility
7

SYNOPSIS

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

DESCRIPTION

15       fedpkg 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, e.g. f25,
22                               which has to match the remote branch name
23                               created in package repository. Particularly,
24                               use master to build RPMs for rawhide.
25         --dist DIST           Deprecated. Use --release instead. You can
26                               use --dist for a while for backward-
27                               compatibility. It will be disabled in future
28                               version.
29         --module-name MODULE_NAME
30                               Deprecated. Use combination of --name and
31                               --namespace. Override the module name.
32                               Otherwise it is discovered from: Git push
33                               URL or Git URL (last part of path with .git
34                               extension removed) or from name macro in
35                               spec file. In that order.
36         --name NAME           Override repository name. Use --namespace
37                               option to change namespace. If not
38                               specified, name is discovered from Git push
39                               URL or Git URL (last part of path with .git
40                               extension removed) or from Name macro in
41                               spec file, in that order.
42         --namespace NAMESPACE
43                               The package repository namespace. If
44                               omitted, default to rpms if namespace is
45                               enabled.
46         --user USER           Override the discovered user name
47         --password PASSWORD   Password for Koji login
48         --runas RUNAS         Run Koji commands as a different user
49         --path PATH           Define the directory to work in (defaults to
50                               cwd)
51         --verbose, -v         Run with verbose debug output
52         --debug, -d           Run with debug output
53         -q                    Run quietly only displaying errors
54         --user-config USER_CONFIG
55                               Specify a user config file to use
56

COMMAND OVERVIEW

58       fedpkg build [-h] [--arches [ARCHES [ARCHES ...]]]  [--md5]  [--nowait]
59       [--target  TARGET]  [--background]  [--fail-fast] [--skip-remote-rules-
60       validation] [--skip-nvr-check] [--skip-tag] [--scratch] [--srpm [SRPM]]
61              Request build
62
63       fedpkg  chain-build  [-h]  [--arches  [ARCHES  [ARCHES  ...]]]  [--md5]
64       [--nowait]  [--target  TARGET]  [--background]  [--fail-fast]  [--skip-
65       remote-rules-validation] package [package ...]
66              Build current package in order with other packages
67
68       fedpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c]  [--raw]  [-t]  [-F
69       FILE] [-p] [-s] [files [files ...]]
70              Alias for commit
71
72       fedpkg clean [-h] [--dry-run] [-x]
73              Remove untracked files
74
75       fedpkg clog [-h] [--raw]
76              Make a clog file containing top changelog entry
77
78       fedpkg clone [-h] [--branches] [--branch BRANCH] [--anonymous] [--depth
79       DEPTH] repo [clone_target]
80              Clone and checkout a repository
81
82       fedpkg co [-h] [--branches] [--branch  BRANCH]  [--anonymous]  [--depth
83       DEPTH] repo [clone_target]
84              Alias for clone
85
86       fedpkg  commit  [-h]  [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t]
87       [-F FILE] [-p] [-s] [files [files ...]]
88              Commit changes
89
90       fedpkg compile [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
91       [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck]
92              Local test rpmbuild compile
93
94       fedpkg  container-build  [-h]  [--target  TARGET]  [--nowait] [--build-
95       release  BUILD_RELEASE]  [--isolated]  [--koji-parent-build   KOJI_PAR‐
96       ENT_BUILD] [--scratch] [--arches [ARCHES [ARCHES ...]]] [--skip-remote-
97       rules-validation] [--skip-build] [--compose-id  COMPOSE_ID  [COMPOSE_ID
98       ...]]  [--signing-intent  SIGNING_INTENT]  [--repo-url  URL  [URL ...]]
99       [--replace-dependency   PKG_MANAGER:NAME:VERSION[:NEW_NAME]   [PKG_MAN‐
100       AGER:NAME:VERSION[:NEW_NAME] ...]]
101              Build a container
102
103       fedpkg  container-build-setup  [-h]  (--get-autorebuild | --set-autore‐
104       build {true,false})
105              set options for container-build
106
107       fedpkg copr-build [-h] [--config CONFIG] [--nowait] project
108              Build package in Copr
109
110       fedpkg diff [-h] [--cached] [files [files ...]]
111              Show changes between commits, commit and working tree, etc
112
113       fedpkg flatpak-build [-h] [--target TARGET] [--nowait] [--build-release
114       BUILD_RELEASE]   [--isolated]  [--koji-parent-build  KOJI_PARENT_BUILD]
115       [--scratch] [--arches [ARCHES [ARCHES ...]]] [--skip-remote-rules-vali‐
116       dation] [--skip-build]
117              Build a Flatpak
118
119       fedpkg fork [-h] [--namespace {rpms,container,modules,flatpaks}]
120              Create a new fork of the current repository
121
122       fedpkg gimmespec [-h]
123              Print the spec file name
124
125       fedpkg gitbuildhash [-h] build
126              Print the git hash used to build the provided n-v-r
127
128       fedpkg giturl [-h]
129              Print the git url for building
130
131       fedpkg help [-h]
132              Show usage
133
134       fedpkg import [-h] [--skip-diffs] [--offline] srpm
135              Import srpm content into a module
136
137       fedpkg install [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
138       [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck]
139              Local test rpmbuild install
140
141       fedpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
142              Run rpmlint against local spec and build output if present.
143
144       fedpkg list-side-tags [-h] [--mine  |  --user  TAG_OWNER  |  --base-tag
145       BASE_TAG]
146              List existing side-tags
147
148       fedpkg  local  [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
149       [--arch ARCH] [--define DEFINE] [--md5] [--with BCOND_WITH]  [--without
150       BCOND_WITHOUT]
151              Local test rpmbuild binary
152
153       fedpkg mock-config [-h] [--target TARGET] [--arch ARCH]
154              Generate a mock config
155
156       fedpkg  mockbuild  [-h]  [--root  CONFIG]  [--md5]  [--no-clean] [--no-
157       cleanup-after]   [--no-clean-all]   [--with   BCOND_WITH]    [--without
158       BCOND_WITHOUT]  [--shell] [--enablerepo ENABLEREPO] [--disablerepo DIS‐
159       ABLEREPO] [--enable-network]
160              Local test build using mock
161
162       fedpkg  module-build  [-h]  [--watch]   [--buildrequires   name:stream]
163       [--requires  name:stream]  [--optional  key=value] [--file [FILE_PATH]]
164       [--srpm SRPMS] [--scratch] [scm_url] [branch]
165              Build a module using MBS
166
167       fedpkg module-build-cancel [-h] build_id
168              Cancel an MBS module build
169
170       fedpkg module-build-info [-h] build_id
171              Show information of an MBS module build
172
173       fedpkg module-build-local  [-h]  [--file  [FILE_PATH]]  [--srpm  SRPMS]
174       [--stream  [STREAM]]  [--skip-tests] [--add-local-build N:S:V] [-s N:S]
175       [--offline] [-r PATH]
176              Build a module locally using the mbs-manager command
177
178       fedpkg module-build-watch [-h] build_id [build_id ...]
179              Watch an MBS build
180
181       fedpkg module-overview [-h]  [--unfinished]  [--limit  LIMIT]  [--owner
182       FAS_ID | --mine]
183              Shows an overview of MBS builds
184
185       fedpkg    module-scratch-build    [-h]    [--watch]    [--buildrequires
186       name:stream] [--requires name:stream]  [--optional  key=value]  [--file
187       [FILE_PATH]] [--srpm SRPMS] [scm_url] [branch]
188              Build a scratch module using MBS
189
190       fedpkg new [-h]
191              Diff against last tag
192
193       fedpkg new-sources [-h] files [files ...]
194              Upload source files
195
196       fedpkg override [-h] {create,extend} ...
197              Manage buildroot overrides
198
199       fedpkg patch [-h] [--rediff] suffix
200              Create and add a gendiff patch file
201
202       fedpkg  prep  [-h]  [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
203       [--arch ARCH] [--define DEFINE]
204              Local test rpmbuild prep
205
206       fedpkg pull [-h] [--rebase] [--no-rebase]
207              Pull changes from the remote repository and update  the  working
208              copy.
209
210       fedpkg push [-h] [--force]
211              Push changes to remote repository
212
213       fedpkg releases-info [-h] [-e | -f | -j]
214              Print Fedora or EPEL current active releases
215
216       fedpkg remove-side-tag [-h] TAG
217              Remove a side tag (without merging packages)
218
219       fedpkg   request-branch  [-h]  [--repo  NAME]  [--namespace  {rpms,con‐
220       tainer,modules,flatpaks}] [--sl [SL [SL ...]]] [--no-git-branch] [--no-
221       auto-module] [--all-releases] [branch]
222              Request a new dist-git branch
223
224       fedpkg  request-repo  [-h]  [--namespace  {rpms,container,modules,flat‐
225       paks}] [--description DESCRIPTION]  [--monitor  {no-monitoring,monitor‐
226       ing,monitoring-with-scratch}]  [--upstreamurl  UPSTREAMURL]  [--summary
227       SUMMARY] [--exception] [--no-initial-commit] name [bug]
228              Request a new dist-git repository
229
230       fedpkg request-side-tag [-h] [--base-tag BASE_TAG]
231              Create a new side tag
232
233       fedpkg request-tests-repo [-h] [--bug BUG] name description
234              Request a new tests dist-git repository
235
236       fedpkg retire [-h] reason
237              Retire a package/module
238
239       fedpkg scratch-build [-h]  [--arches  [ARCHES  [ARCHES  ...]]]  [--md5]
240       [--nowait]  [--target  TARGET]  [--background]  [--fail-fast]  [--skip-
241       remote-rules-validation] [--srpm [SRPM]]
242              Request scratch build
243
244       fedpkg sources [-h] [--outdir OUTDIR]
245              Download source files
246
247       fedpkg srpm [-h] [--builddir  BUILDDIR]  [--buildrootdir  BUILDROOTDIR]
248       [--arch ARCH] [--define DEFINE] [--md5]
249              Create a source rpm
250
251       fedpkg switch-branch [-h] [-l] [--fetch] [branch]
252              Work with branches
253
254       fedpkg  tag  [-h]  [-f]  [-m  MESSAGE] [-c] [--raw] [-F FILE] [-l] [-d]
255       [tag]
256              Management of git tags
257
258       fedpkg unused-patches [-h]
259              Print list of patches not referenced by name in the specfile
260
261       fedpkg update  [-h]  [--type  {bugfix,security,enhancement,newpackage}]
262       [--request  {testing,stable}]  [--bugs BUGS [BUGS ...]] [--notes NOTES]
263       [--disable-autokarma] [--stable-karma KARMA]  [--unstable-karma  KARMA]
264       [--not-close-bugs]    [--suggest-reboot]   [--no-require-bugs]   [--no-
265       require-testcases]
266              Submit last build as update
267
268       fedpkg upload [-h] files [files ...]
269              Upload source files
270
271       fedpkg verify-files [-h] [--builddir BUILDDIR]  [--buildrootdir  BUILD‐
272       ROOTDIR] [--arch ARCH] [--define DEFINE]
273              Locally verify %%files section
274
275       fedpkg verrel [-h]
276              Print the name-version-release
277

COMMAND REFERENCE

279   fedpkg build
280         usage: fedpkg build [-h] [--arches [ARCHES [ARCHES ...]]] [--md5]
281                             [--nowait] [--target TARGET] [--background]
282                             [--fail-fast] [--skip-remote-rules-validation]
283                             [--skip-nvr-check] [--skip-tag] [--scratch]
284                             [--srpm [SRPM]]
285
286                     This command requests a build of the package in the build
287       system. By
288         default it discovers the target to build for based  on  branch  data,
289       and
290         uses the latest commit as the build source.
291
292                     fedpkg  is also able to submit multiple builds to Koji at
293       once from stream
294                     branch based on a  local  config,  which  is  inside  the
295       repository. The config file
296                     is named package.cfg in INI format. For example,
297
298                         [koji]
299                         targets = master fedora epel7
300
301                     You  only  need to put Fedora releases and EPEL in option
302       targets and fedpkg will
303                     convert it to proper Koji  build  target  for  submitting
304       builds. Beside regular
305                     release  names, option targets accepts two shortcut names
306       as well, fedora and
307                     epel, as you can see in the above  example.  Name  fedora
308       stands for current
309                     active  Fedora  releases,  and epel stands for the active
310       EPEL releases, which are
311                     el6 and epel7 currently.
312
313                     Note that the config file is a branch specific file. That
314       means you could
315                     create  package.cfg  for each stream branch separately to
316       indicate on which
317                     targets to build the package for a particular stream.
318
319         optional arguments:
320           -h, --help            show this help message and exit
321           --arches [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           --skip-tag            Do not attempt to tag package
337           --scratch             Perform a scratch build
338           --srpm [SRPM]         Build from an srpm. If no srpm is provided
339                                 with this option an srpm will be generated
340                                 from current module content.
341
342
343   fedpkg chain-build
344         usage: fedpkg chain-build [-h] [--arches [ARCHES [ARCHES ...]]]
345                                   [--md5] [--nowait] [--target TARGET]
346                                   [--background] [--fail-fast]
347                                   [--skip-remote-rules-validation]
348                                   package [package ...]
349
350         Build current package in order with other packages.
351
352         example: fedpkg chain-build libwidget libgizmo
353
354         The current package is added to the end of the CHAIN list.
355         Colons (:) can be used in the CHAIN parameter to define groups of
356         packages.  Packages in any single group will be built in parallel
357         and all packages in a group must build successfully and populate
358         the repository before the next group will begin building.
359
360         For example:
361
362         fedpkg chain-build libwidget libaselib : libgizmo :
363
364         will cause libwidget and libaselib to be built in parallel, followed
365         by libgizmo and then the current directory package. If no groups are
366         defined, packages will be built sequentially.
367
368         positional arguments:
369           package               List the packages and order you want to
370                                 build in
371
372         optional arguments:
373           -h, --help            show this help message and exit
374           --arches [ARCHES [ARCHES ...]]
375                                 Build for specific arches
376           --md5                 Use md5 checksums (for older rpm hosts)
377           --nowait              Don't wait on build
378           --target TARGET       Define build target to build into
379           --background          Run the build at a low priority
380           --fail-fast           Fail the build immediately if any arch fails
381           --skip-remote-rules-validation
382                                 Don't check if there's a valid gating.yaml
383                                 file in the repo, where you can define
384                                 additional policies for Greenwave gating.
385
386
387   fedpkg ci
388         usage: fedpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw]
389                          [-t] [-F FILE] [-p] [-s]
390                          [files [files ...]]
391
392         Alias for commit.
393
394         positional arguments:
395           files                 Optional list of specific files to commit
396
397         optional arguments:
398           -h, --help            show this help message and exit
399           -m MESSAGE, --message MESSAGE
400                                 Use the given <msg> as the commit message
401                                 summary
402           --with-changelog      Get the last changelog from SPEC as commit
403                                 message content. This option must be used
404                                 with -m together.
405           -c, --clog            Generate the commit message from the
406                                 Changelog section
407           --raw                 Make the clog raw
408           -t, --tag             Create a tag for this commit
409           -F FILE, --file FILE  Take the commit message from the given file
410           -p, --push            Commit and push as one action
411           -s, --signoff         Include a signed-off-by
412
413
414   fedpkg clean
415         usage: fedpkg clean [-h] [--dry-run] [-x]
416
417         This command can be used to clean up your working directory. By
418         default it will follow .gitignore rules.
419
420         optional arguments:
421           -h, --help     show this help message and exit
422           --dry-run, -n  Perform a dry-run
423           -x             Do not follow .gitignore rules
424
425
426   fedpkg clog
427         usage: fedpkg clog [-h] [--raw]
428
429         This will create a file named "clog" that contains the latest rpm
430         changelog entry. The leading "- " text will be stripped.
431
432         optional arguments:
433           -h, --help  show this help message and exit
434           --raw       Generate a more "raw" clog without twiddling the
435                       contents
436
437
438   fedpkg clone
439         usage: fedpkg clone [-h] [--branches] [--branch BRANCH]
440                             [--anonymous] [--depth DEPTH]
441                             repo [clone_target]
442
443         This command will clone the named repository from the configured
444         repository base URL. By default it will also checkout the master
445         branch for your working copy.
446
447         positional arguments:
448           repo                  Name of the repository to clone
449           clone_target          Directory in which to clone the repository
450
451         optional arguments:
452           -h, --help            show this help message and exit
453           --branches, -B        Do an old style checkout with subdirs for
454                                 branches
455           --branch BRANCH, -b BRANCH
456                                 Check out a specific branch
457           --anonymous, -a       Check out a module anonymously
458           --depth DEPTH         Create a shallow clone with a history
459                                 truncated to the specified number of commits
460
461
462   fedpkg co
463         usage: fedpkg co [-h] [--branches] [--branch BRANCH] [--anonymous]
464                          [--depth DEPTH]
465                          repo [clone_target]
466
467         Alias for clone.
468
469         positional arguments:
470           repo                  Name of the repository to clone
471           clone_target          Directory in which to clone the repository
472
473         optional arguments:
474           -h, --help            show this help message and exit
475           --branches, -B        Do an old style checkout with subdirs for
476                                 branches
477           --branch BRANCH, -b BRANCH
478                                 Check out a specific branch
479           --anonymous, -a       Check out a module anonymously
480           --depth DEPTH         Create a shallow clone with a history
481                                 truncated to the specified number of commits
482
483
484   fedpkg commit
485         usage: fedpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c]
486                              [--raw] [-t] [-F FILE] [-p] [-s]
487                              [files [files ...]]
488
489         This invokes a git commit. All tracked files with changes will be
490         committed unless a specific file list is provided. $EDITOR will be
491         used to generate a changelog message unless one is given to the
492         command. A push can be done at the same time.
493
494         positional arguments:
495           files                 Optional list of specific files to commit
496
497         optional arguments:
498           -h, --help            show this help message and exit
499           -m MESSAGE, --message MESSAGE
500                                 Use the given <msg> as the commit message
501                                 summary
502           --with-changelog      Get the last changelog from SPEC as commit
503                                 message content. This option must be used
504                                 with -m together.
505           -c, --clog            Generate the commit message from the
506                                 Changelog section
507           --raw                 Make the clog raw
508           -t, --tag             Create a tag for this commit
509           -F FILE, --file FILE  Take the commit message from the given file
510           -p, --push            Commit and push as one action
511           -s, --signoff         Include a signed-off-by
512
513
514   fedpkg compile
515         usage: fedpkg compile [-h] [--builddir BUILDDIR]
516                               [--buildrootdir BUILDROOTDIR] [--arch ARCH]
517                               [--define DEFINE] [--short-circuit]
518                               [--nocheck]
519
520         This command calls rpmbuild to compile the source. By default the
521         prep and configure stages will be done as well, unless the short-
522         circuit option is used.
523
524         optional arguments:
525           -h, --help            show this help message and exit
526           --builddir BUILDDIR   Define an alternate builddir
527           --buildrootdir BUILDROOTDIR
528                                 Define an alternate buildrootdir
529           --arch ARCH           Prep for a specific arch
530           --define DEFINE       Pass custom macros to rpmbuild, may specify
531                                 multiple times
532           --short-circuit       short-circuit compile
533           --nocheck             nocheck compile
534
535
536   fedpkg container-build
537         usage: fedpkg container-build [-h] [--target TARGET] [--nowait]
538                                       [--build-release BUILD_RELEASE]
539                                       [--isolated]
540                                       [--koji-parent-build KOJI_PARENT_BUILD]
541                                       [--scratch]
542                                       [--arches [ARCHES [ARCHES ...]]]
543                                       [--skip-remote-rules-validation]
544                                       [--skip-build]
545                                       [--compose-id  COMPOSE_ID   [COMPOSE_ID
546       ...]]
547                                       [--signing-intent SIGNING_INTENT]
548                                       [--repo-url URL [URL ...]]
549                                       [--replace-dependency          PKG_MAN‐
550       AGER:NAME:VERSION[:NEW_NAME]
551                                       [PKG_MANAGER:NAME:VERSION[:NEW_NAME]
552                                       ...]]
553
554         Build a container
555
556         optional arguments:
557           -h, --help            show this help message and exit
558           --target TARGET       Override the default target
559           --nowait              Don't wait on build
560           --build-release BUILD_RELEASE
561                                 Specify a release value for this build's NVR
562           --isolated            Do not auto-increment the release value or
563                                 update additional tags in the registry. You
564                                 must use the --build-release argument
565           --koji-parent-build KOJI_PARENT_BUILD
566                                 Specify a Koji NVR for the parent container
567                                 image. This will override the "FROM" value
568                                 in your Dockerfile.
569           --scratch             Scratch build
570           --arches [ARCHES [ARCHES ...]]
571                                 Limit a scratch or a isolated build to an
572                                 arch. May have multiple arches.
573           --skip-remote-rules-validation
574                                 Don't check if there's a valid gating.yaml
575                                 file in the repo
576           --skip-build          Don't create build, but just modify settings
577                                 for autorebuilds
578           --compose-id COMPOSE_ID [COMPOSE_ID ...]
579                                 ODCS composes used. Cannot be used with
580                                 --signing-intent
581           --signing-intent SIGNING_INTENT
582                                 Signing intent of the ODCS composes.
583           --repo-url URL [URL ...]
584                                 URLs of yum repo files
585           --replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME]  [PKG_MAN‐
586       AGER:NAME:VERSION[:NEW_NAME] ...]
587                                 Cachito dependency replacement
588
589
590   fedpkg container-build-setup
591         usage: fedpkg container-build-setup [-h]
592                                             (--get-autorebuild    |    --set-
593       autorebuild {true,false})
594
595         set options for container-build.
596
597         optional arguments:
598           -h, --help            show this help message and exit
599           --get-autorebuild     Get autorebuild value
600           --set-autorebuild {true,false}
601                                 Turn autorebuilds on/off
602
603
604   fedpkg copr-build
605         usage: fedpkg copr-build [-h] [--config CONFIG] [--nowait] project
606
607         Build package in Copr.
608
609         Note: you need to have set up correct api key. For more information
610         see API KEY section of copr-cli(1) man page.
611
612         positional arguments:
613           project          Name of the project in format USER/PROJECT
614
615         optional arguments:
616           -h, --help       show this help message and exit
617           --config CONFIG  Path to an alternative Copr configuration file
618           --nowait         Don't wait on build
619
620
621   fedpkg diff
622         usage: fedpkg diff [-h] [--cached] [files [files ...]]
623
624         Use git diff to show changes that have been made to tracked files.
625         By default cached changes (changes that have been git added) will
626         not be shown.
627
628         positional arguments:
629           files       Optionally diff specific files
630
631         optional arguments:
632           -h, --help  show this help message and exit
633           --cached    View staged changes
634
635
636   fedpkg flatpak-build
637         usage: fedpkg flatpak-build [-h] [--target TARGET] [--nowait]
638                                     [--build-release BUILD_RELEASE]
639                                     [--isolated]
640                                     [--koji-parent-build KOJI_PARENT_BUILD]
641                                     [--scratch]
642                                     [--arches [ARCHES [ARCHES ...]]]
643                                     [--skip-remote-rules-validation]
644                                     [--skip-build]
645
646         Build a Flatpak
647
648         optional arguments:
649           -h, --help            show this help message and exit
650           --target TARGET       Override the default target
651           --nowait              Don't wait on build
652           --build-release BUILD_RELEASE
653                                 Specify a release value for this build's NVR
654           --isolated            Do not auto-increment the release value or
655                                 update additional tags in the registry. You
656                                 must use the --build-release argument
657           --koji-parent-build KOJI_PARENT_BUILD
658                                 Specify a Koji NVR for the parent container
659                                 image. This will override the "FROM" value
660                                 in your Dockerfile.
661           --scratch             Scratch build
662           --arches [ARCHES [ARCHES ...]]
663                                 Limit a scratch or a isolated build to an
664                                 arch. May have multiple arches.
665           --skip-remote-rules-validation
666                                 Don't check if there's a valid gating.yaml
667                                 file in the repo
668           --skip-build          Don't create build, but just modify settings
669                                 for autorebuilds
670
671
672   fedpkg fork
673         usage: fedpkg fork [-h]
674                            [--namespace {rpms,container,modules,flatpaks}]
675
676         Create a new fork of the current repository
677
678         Before the operation, you need to generate an API token at
679         https://src.fedoraproject.org/settings/token/new, select the relevant
680       ACL(s)
681         and save it in your local user configuration located
682         at ~/.config/rpkg/fedpkg.conf. For example:
683
684             [fedpkg.distgit]
685             token = <api_key_here>
686
687         Below is a basic example of the command to fork a current repository:
688
689             fedpkg fork
690
691         Operation requires username (FAS_ID). by default, current logged
692         username is taken. It could be overridden by reusing an argument:
693
694             fedpkg --user FAS_ID fork
695
696         optional arguments:
697           -h, --help            show this help message and exit
698           --namespace {rpms,container,modules,flatpaks}
699                                 Namespace of the fork. If omitted, default
700                                 to rpms.
701
702
703   fedpkg gimmespec
704         usage: fedpkg gimmespec [-h]
705
706         Print the spec file name.
707
708         optional arguments:
709           -h, --help  show this help message and exit
710
711
712   fedpkg gitbuildhash
713         usage: fedpkg gitbuildhash [-h] build
714
715         This will show you the commit hash string used to build the provided
716         build n-v-r
717
718         positional arguments:
719           build       name-version-release of the build to query.
720
721         optional arguments:
722           -h, --help  show this help message and exit
723
724
725   fedpkg giturl
726         usage: fedpkg giturl [-h]
727
728         This will show you which git URL would be used in a build command.
729         It uses the git hashsum of the HEAD of the current branch (which may
730         not be pushed).
731
732         optional arguments:
733           -h, --help  show this help message and exit
734
735
736   fedpkg help
737         usage: fedpkg help [-h]
738
739         Show usage.
740
741         optional arguments:
742           -h, --help  show this help message and exit
743
744
745   fedpkg import
746         usage: fedpkg import [-h] [--skip-diffs] [--offline] srpm
747
748         This will extract sources, patches, and the spec file from an srpm
749         and update the current module accordingly. It will import to the
750         current branch by default.
751
752         positional arguments:
753           srpm          Source rpm to import
754
755         optional arguments:
756           -h, --help    show this help message and exit
757           --skip-diffs  Don't show diffs when import srpms
758           --offline     Do not upload files into lookaside cache
759
760
761   fedpkg install
762         usage: fedpkg install [-h] [--builddir BUILDDIR]
763                               [--buildrootdir BUILDROOTDIR] [--arch ARCH]
764                               [--define DEFINE] [--short-circuit]
765                               [--nocheck]
766
767         This will call rpmbuild to run the install section. All leading
768         sections will be processed as well, unless the short-circuit option
769         is used.
770
771         optional arguments:
772           -h, --help            show this help message and exit
773           --builddir BUILDDIR   Define an alternate builddir
774           --buildrootdir BUILDROOTDIR
775                                 Define an alternate buildrootdir
776           --arch ARCH           Prep for a specific arch
777           --define DEFINE       Pass custom macros to rpmbuild, may specify
778                                 multiple times
779           --short-circuit       short-circuit install
780           --nocheck             nocheck install
781
782
783   fedpkg lint
784         usage: fedpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
785
786         Rpmlint can be configured using the --rpmlintconf/-r option or by
787         setting a <pkgname>.rpmlintrc file in the working directory
788
789         optional arguments:
790           -h, --help            show this help message and exit
791           --info, -i            Display explanations for reported messages
792           --rpmlintconf RPMLINTCONF, -r RPMLINTCONF
793                                 Use a specific configuration file for
794                                 rpmlint
795
796
797   fedpkg list-side-tags
798         usage: fedpkg list-side-tags [-h]
799                                      [--mine  | --user TAG_OWNER | --base-tag
800       BASE_TAG]
801
802         List existing side-tags.
803
804         optional arguments:
805           -h, --help           show this help message and exit
806           --mine               List only my side tags
807           --user TAG_OWNER     List side tags created by this user
808           --base-tag BASE_TAG  List only tags based on this base
809
810
811   fedpkg local
812         usage: fedpkg local [-h] [--builddir BUILDDIR]
813                             [--buildrootdir BUILDROOTDIR] [--arch ARCH]
814                             [--define DEFINE] [--md5] [--with BCOND_WITH]
815                             [--without BCOND_WITHOUT]
816
817         Locally test run of rpmbuild producing binary RPMs. The rpmbuild
818         output will be logged into a file named
819         .build-%{version}-%{release}.log
820
821         optional arguments:
822           -h, --help            show this help message and exit
823           --builddir BUILDDIR   Define an alternate builddir
824           --buildrootdir BUILDROOTDIR
825                                 Define an alternate buildrootdir
826           --arch ARCH           Prep for a specific arch
827           --define DEFINE       Pass custom macros to rpmbuild, may specify
828                                 multiple times
829           --md5                 Use md5 checksums (for older rpm hosts)
830           --with BCOND_WITH     Enable configure option (bcond) for the
831                                 build
832           --without BCOND_WITHOUT
833                                 Disable configure option (bcond) for the
834                                 build
835
836
837   fedpkg mock-config
838         usage: fedpkg mock-config [-h] [--target TARGET] [--arch ARCH]
839
840         This will generate a mock config based on the buildsystem target
841
842         optional arguments:
843           -h, --help       show this help message and exit
844           --target TARGET  Override target used for config
845           --arch ARCH      Override local arch
846
847
848   fedpkg mockbuild
849         usage: fedpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean]
850                                 [--no-cleanup-after] [--no-clean-all]
851                                 [--with BCOND_WITH]
852                                 [--without BCOND_WITHOUT] [--shell]
853                                 [--enablerepo ENABLEREPO]
854                                 [--disablerepo DISABLEREPO]
855                                 [--enable-network]
856
857         This will use the mock utility to build the package for the
858         distribution detected from branch information. This can be
859         overridden using the global --release option. Your user must be in
860         the local "mock" group.
861
862         optional arguments:
863           -h, --help            show this help message and exit
864           --root CONFIG, --mock-config CONFIG
865                                 Override mock configuration (like mock -r)
866           --md5                 Use md5 checksums (for older rpm hosts)
867           --no-clean, -n        Do not clean chroot before building package
868           --no-cleanup-after    Do not clean chroot after building (if
869                                 automatic cleanup is enabled
870           --no-clean-all, -N    Alias for both --no-clean and --no-cleanup-
871                                 after
872           --with BCOND_WITH     Enable configure option (bcond) for the
873                                 build
874           --without BCOND_WITHOUT
875                                 Disable configure option (bcond) for the
876                                 build
877           --shell               Run commands interactively within chroot.
878                                 Before going into chroot, mockbuild needs to
879                                 run with --no-cleanup-after in advanced.
880           --enablerepo ENABLEREPO
881                                 Pass enablerepo option to yum/dnf (may be
882                                 used more than once)
883           --disablerepo DISABLEREPO
884                                 Pass disablerepo option to yum/dnf (may be
885                                 used more than once)
886           --enable-network      Enable networking
887
888         If config file for mock isn't found in the /etc/mock directory, a
889         temporary config directory for mock is created and populated with a
890         config file created with mock-config.
891
892
893   fedpkg module-build
894         usage: fedpkg module-build [-h] [--watch]
895                                    [--buildrequires name:stream]
896                                    [--requires name:stream]
897                                    [--optional key=value]
898                                    [--file [FILE_PATH]] [--srpm SRPMS]
899                                    [--scratch]
900                                    [scm_url] [branch]
901
902         Build a module using MBS
903
904         positional arguments:
905           scm_url               The module's SCM URL. This defaults to the
906                                 current repo.
907           branch                The module's SCM branch. This defaults to
908                                 the current checked-out branch.
909
910         optional arguments:
911           -h, --help            show this help message and exit
912           --watch, -w           Watch the module build
913           --buildrequires name:stream
914                                 Buildrequires to override in the form of
915                                 "name:stream"
916           --requires name:stream
917                                 Requires to override in the form of
918                                 "name:stream"
919           --optional key=value  MBS optional arguments in the form of
920                                 "key=value". For example: 'fedpkg module-
921                                 build --optional
922                                 "reuse_components_from=<NSVC>"'. More
923                                 description including list of available
924                                 arguments here: https://pagure.io/fm-
925                                 orchestrator/
926           --file [FILE_PATH]    The modulemd yaml file for module scratch
927                                 build.
928           --srpm SRPMS          Include one or more srpms for module scratch
929                                 build.
930           --scratch             Perform a scratch build
931
932
933   fedpkg module-build-cancel
934         usage: fedpkg module-build-cancel [-h] build_id
935
936         Cancel an MBS module build
937
938         positional arguments:
939           build_id    The ID of the module build to cancel
940
941         optional arguments:
942           -h, --help  show this help message and exit
943
944
945   fedpkg module-build-info
946         usage: fedpkg module-build-info [-h] build_id
947
948         Show information of an MBS module build
949
950         positional arguments:
951           build_id    The ID of the module build
952
953         optional arguments:
954           -h, --help  show this help message and exit
955
956
957   fedpkg module-build-local
958         usage: fedpkg module-build-local [-h] [--file [FILE_PATH]]
959                                          [--srpm SRPMS] [--stream [STREAM]]
960                                          [--skip-tests]
961                                          [--add-local-build N:S:V] [-s N:S]
962                                          [--offline] [-r PATH]
963
964         Build a module locally using the mbs-manager command
965
966         optional arguments:
967           -h, --help            show this help message and exit
968           --file [FILE_PATH]    The module's modulemd yaml file. If not
969                                 specified, a yaml file with the same
970                                 basename as the name of the repository will
971                                 be used.
972           --srpm SRPMS          Include one or more srpms for module build.
973           --stream [STREAM]     The module's stream/SCM branch. This
974                                 defaults to the current checked-out branch.
975           --skip-tests          Adds a macro for skipping the check section
976           --add-local-build N:S:V
977                                 Import previously finished local module
978                                 builds into MBS in the format of name:stream
979                                 or name:stream:version
980           -s N:S, --set-default-stream N:S
981                                 Set the default stream for given module
982                                 dependency in case there are multiple
983                                 streams to choose from.
984           --offline             Builds module offline without any external
985                                 infrastructure
986           -r PATH, --repository PATH
987                                 Full path to .repo file defining the base
988                                 module repository to use when --offline is
989                                 used.
990
991
992   fedpkg module-build-watch
993         usage: fedpkg module-build-watch [-h] build_id [build_id ...]
994
995         Watch an MBS build
996
997         positional arguments:
998           build_id    The ID of the module build to watch
999
1000         optional arguments:
1001           -h, --help  show this help message and exit
1002
1003
1004   fedpkg module-overview
1005         usage: fedpkg module-overview [-h] [--unfinished] [--limit LIMIT]
1006                                       [--owner FAS_ID | --mine]
1007
1008         Shows an overview of MBS builds
1009
1010         optional arguments:
1011           -h, --help      show this help message and exit
1012           --unfinished    Show unfinished module builds
1013           --limit LIMIT   The number of most recent module builds to display
1014           --owner FAS_ID  List only items of that owner
1015           --mine          Use current Kerberos name or username
1016
1017
1018   fedpkg module-scratch-build
1019         usage: fedpkg module-scratch-build [-h] [--watch]
1020                                            [--buildrequires name:stream]
1021                                            [--requires name:stream]
1022                                            [--optional key=value]
1023                                            [--file [FILE_PATH]]
1024                                            [--srpm SRPMS]
1025                                            [scm_url] [branch]
1026
1027         Build a scratch module using MBS
1028
1029         positional arguments:
1030           scm_url               The module's SCM URL. This defaults to the
1031                                 current repo.
1032           branch                The module's SCM branch. This defaults to
1033                                 the current checked-out branch.
1034
1035         optional arguments:
1036           -h, --help            show this help message and exit
1037           --watch, -w           Watch the module build
1038           --buildrequires name:stream
1039                                 Buildrequires to override in the form of
1040                                 "name:stream"
1041           --requires name:stream
1042                                 Requires to override in the form of
1043                                 "name:stream"
1044           --optional key=value  MBS optional arguments in the form of
1045                                 "key=value". For example: 'fedpkg module-
1046                                 build --optional
1047                                 "reuse_components_from=<NSVC>"'. More
1048                                 description including list of available
1049                                 arguments here: https://pagure.io/fm-
1050                                 orchestrator/
1051           --file [FILE_PATH]    The modulemd yaml file for module scratch
1052                                 build.
1053           --srpm SRPMS          Include one or more srpms for module scratch
1054                                 build.
1055
1056
1057   fedpkg new
1058         usage: fedpkg new [-h]
1059
1060         This will use git to show a diff of all the changes (even
1061         uncommitted changes) since the last git tag was applied.
1062
1063         optional arguments:
1064           -h, --help  show this help message and exit
1065
1066
1067   fedpkg new-sources
1068         usage: fedpkg new-sources [-h] files [files ...]
1069
1070         This will upload new source file(s) to lookaside cache, and all file
1071         names listed in sources file will be replaced. .gitignore will be
1072         also updated with new uploaded file(s). Please remember to commit
1073         them.
1074
1075         positional arguments:
1076           files
1077
1078         optional arguments:
1079           -h, --help  show this help message and exit
1080
1081
1082   fedpkg override
1083         usage: fedpkg override [-h] {create,extend} ...
1084
1085         Manage buildroot overrides.
1086
1087         optional arguments:
1088           -h, --help       show this help message and exit
1089
1090         subcommands:
1091           Commands on override
1092
1093           {create,extend}
1094             create         Create buildroot override from build
1095             extend         Extend buildroot override expiration
1096
1097
1098   fedpkg patch
1099         usage: fedpkg patch [-h] [--rediff] suffix
1100
1101         Create and add a gendiff patch file.
1102
1103         positional arguments:
1104           suffix      Look for files with this suffix to diff
1105
1106         optional arguments:
1107           -h, --help  show this help message and exit
1108           --rediff    Recreate gendiff file retaining comments Saves old
1109                       patch file with a suffix of ~
1110
1111         Patch file will be named: package-version-suffix.patch and the file
1112         will be added to the repo index
1113
1114
1115   fedpkg prep
1116         usage: fedpkg prep [-h] [--builddir BUILDDIR]
1117                            [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1118                            [--define DEFINE]
1119
1120         Use rpmbuild to "prep" the sources (unpack the source archive(s) and
1121         apply any patches.)
1122
1123         optional arguments:
1124           -h, --help            show this help message and exit
1125           --builddir BUILDDIR   Define an alternate builddir
1126           --buildrootdir BUILDROOTDIR
1127                                 Define an alternate buildrootdir
1128           --arch ARCH           Prep for a specific arch
1129           --define DEFINE       Pass custom macros to rpmbuild, may specify
1130                                 multiple times
1131
1132
1133   fedpkg pull
1134         usage: fedpkg pull [-h] [--rebase] [--no-rebase]
1135
1136         This command uses git to fetch remote changes and apply them to the
1137         current working copy. A rebase option is available which can be used
1138         to avoid merges.
1139
1140         optional arguments:
1141           -h, --help   show this help message and exit
1142           --rebase     Rebase the locally committed changes on top of the
1143                        remote changes after fetching. This can avoid a merge
1144                        commit, but does rewrite local history.
1145           --no-rebase  Do not rebase, overriding .git settings to the
1146                        contrary
1147
1148         See git pull --help for more details
1149
1150
1151   fedpkg push
1152         usage: fedpkg push [-h] [--force]
1153
1154         Push changes to remote repository.
1155
1156         optional arguments:
1157           -h, --help   show this help message and exit
1158           --force, -f  Force push
1159
1160
1161   fedpkg releases-info
1162         usage: fedpkg releases-info [-h] [-e | -f | -j]
1163
1164         Print Fedora or EPEL current active releases
1165
1166         optional arguments:
1167           -h, --help    show this help message and exit
1168           -e, --epel    Only show EPEL releases.
1169           -f, --fedora  Only show Fedora active releases.
1170           -j, --join    Show all releases in one line separated by a space.
1171
1172
1173   fedpkg remove-side-tag
1174         usage: fedpkg remove-side-tag [-h] TAG
1175
1176         Remove a side tag (without merging packages).
1177
1178         positional arguments:
1179           TAG         name of tag to be deleted
1180
1181         optional arguments:
1182           -h, --help  show this help message and exit
1183
1184
1185   fedpkg request-branch
1186         usage: fedpkg request-branch [-h] [--repo NAME]
1187                                      [--namespace        {rpms,container,mod‐
1188       ules,flatpaks}]
1189                                      [--sl [SL [SL ...]]] [--no-git-branch]
1190                                      [--no-auto-module] [--all-releases]
1191                                      [branch]
1192
1193         Request a new dist-git branch
1194
1195         Please refer to the help of the request-repo command to see what has
1196         to be done before requesting a dist-git branch.
1197
1198         Branch  name could be one of current active Fedora and EPEL releases.
1199       Use
1200         command ``fedpkg releases-info`` to get release  names  that  can  be
1201       used to request
1202         a branch.
1203
1204         Below are various examples of requesting a dist-git branch.
1205
1206         Request a branch inside a cloned package repository:
1207
1208             fedpkg request-branch f27
1209
1210         Request  a  branch  outside  package repository, which could apply to
1211       cases of
1212         requested repository has not been approved and created, or  just  not
1213       change
1214         directory to package repository:
1215
1216             fedpkg request-branch --repo foo f27
1217
1218         Request  a branch with service level tied to the branch. In this case
1219       branch
1220         argument has to be before --sl argument, because --sl allows multiple
1221       values.
1222
1223             fedpkg   request-branch   branch_name  --sl  bug_fixes:2020-06-01
1224       rawhide:2019-12-01
1225
1226         positional arguments:
1227           branch                The branch to request.
1228
1229         optional arguments:
1230           -h, --help            show this help message and exit
1231           --repo NAME           Repository name the new branch is requested
1232                                 for.
1233           --namespace {rpms,container,modules,flatpaks}
1234                                 Repository name the new branch is requested
1235                                 for.
1236           --sl [SL [SL ...]]    The service levels (SLs) tied to the branch.
1237                                 This must be in the format of
1238                                 "sl_name:2020-12-01". This is only for non-
1239                                 release branches. You may provide more than
1240                                 one by separating each SL with a space. When
1241                                 the argument is used, branch argument has to
1242                                 be placed before --sl.
1243           --no-git-branch       Don't create the branch in git but still
1244                                 create it in PDC
1245           --no-auto-module      If requesting an rpm arbitrary branch, do
1246                                 not also request a new matching module. See
1247                                 https://pagure.io/fedrepo_req/issue/129
1248           --all-releases        Make a new branch request for every active
1249                                 Fedora release
1250
1251
1252   fedpkg request-repo
1253         usage: fedpkg request-repo [-h]
1254                                    [--namespace {rpms,container,modules,flat‐
1255       paks}]
1256                                    [--description DESCRIPTION]
1257                                    [--monitor {no-monitoring,monitoring,moni‐
1258       toring-with-scratch}]
1259                                    [--upstreamurl UPSTREAMURL]
1260                                    [--summary SUMMARY] [--exception]
1261                                    [--no-initial-commit]
1262                                    name [bug]
1263
1264         Request a new dist-git repository
1265
1266         Before the operation, you need to generate a pagure.io API token at
1267         https://pagure.io/settings/token/new, select the relevant ACL(s)
1268         and save it in your local user configuration located
1269         at ~/.config/rpkg/fedpkg.conf. For example:
1270
1271             [fedpkg.pagure]
1272             token = <api_key_here>
1273
1274         Below is a basic example of the command to request a dist-git reposi‐
1275       tory for
1276         the package foo:
1277
1278             fedpkg request-repo foo 1234
1279
1280         Another example to request a module foo:
1281
1282             fedpkg request-repo --namespace modules foo
1283
1284         positional arguments:
1285           name                  Repository name to request.
1286           bug                   Bugzilla bug ID of the package review
1287                                 request. Not required for requesting a
1288                                 module repository
1289
1290         optional arguments:
1291           -h, --help            show this help message and exit
1292           --namespace {rpms,container,modules,flatpaks}
1293                                 Namespace of repository. If omitted, default
1294                                 to rpms.
1295           --description DESCRIPTION, -d DESCRIPTION
1296                                 The repo's description in dist-git
1297           --monitor   {no-monitoring,monitoring,monitoring-with-scratch},  -m
1298       {no-monitoring,monitoring,monitoring-with-scratch}
1299                                 The Anitya monitoring type for the repo
1300           --upstreamurl UPSTREAMURL, -u UPSTREAMURL
1301                                 The upstream URL of the project
1302           --summary SUMMARY, -s SUMMARY
1303                                 Override the package's summary from the
1304                                 Bugzilla bug
1305           --exception           The package is an exception to the regular
1306                                 package review process (specifically, it
1307                                 does not require a Bugzilla bug)
1308           --no-initial-commit   Do not include an initial commit in the
1309                                 repository.
1310
1311
1312   fedpkg request-side-tag
1313         usage: fedpkg request-side-tag [-h] [--base-tag BASE_TAG]
1314
1315         Create a new side tag.
1316
1317         optional arguments:
1318           -h, --help           show this help message and exit
1319           --base-tag BASE_TAG  name of base tag
1320
1321
1322   fedpkg request-tests-repo
1323         usage: fedpkg request-tests-repo [-h] [--bug BUG] name description
1324
1325         Request a new dist-git repository in tests shared namespace
1326
1327             https://src.fedoraproject.org/projects/tests/*
1328
1329         For more information about tests shared namespace see
1330
1331             https://fedoraproject.org/wiki/CI/Share_Test_Code
1332
1333         Please refer to the request-repo command to see what has to  be  done
1334       before
1335         requesting a repository in the tests namespace.
1336
1337         Below is a basic example of the command to request a dist-git reposi‐
1338       tory for
1339         the space tests/foo:
1340
1341             fedpkg request-tests-repo foo "Description of the repository"
1342
1343         Note that the space name needs to reflect the intent of the tests and
1344       will
1345         undergo a manual review.
1346
1347         positional arguments:
1348           name         Repository name to request.
1349           description  Description of the tests repository
1350
1351         optional arguments:
1352           -h, --help   show this help message and exit
1353           --bug BUG    Bugzilla bug ID of the package review request.
1354
1355
1356   fedpkg retire
1357         usage: fedpkg retire [-h] reason
1358
1359         This command will remove all files from the repo, leave a
1360         dead.package file for rpms or dead.module file for modules, and push
1361         the changes.
1362
1363         positional arguments:
1364           reason      Reason for retiring the package/module
1365
1366         optional arguments:
1367           -h, --help  show this help message and exit
1368
1369
1370   fedpkg scratch-build
1371         usage: fedpkg scratch-build [-h] [--arches [ARCHES [ARCHES ...]]]
1372                                     [--md5] [--nowait] [--target TARGET]
1373                                     [--background] [--fail-fast]
1374                                     [--skip-remote-rules-validation]
1375                                     [--srpm [SRPM]]
1376
1377         This command will request a scratch build of the package. Without
1378         providing an srpm, it will attempt to build the latest commit, which
1379         must have been pushed. By default all appropriate arches will be
1380         built.
1381
1382         optional arguments:
1383           -h, --help            show this help message and exit
1384           --arches [ARCHES [ARCHES ...]]
1385                                 Build for specific arches
1386           --md5                 Use md5 checksums (for older rpm hosts)
1387           --nowait              Don't wait on build
1388           --target TARGET       Define build target to build into
1389           --background          Run the build at a low priority
1390           --fail-fast           Fail the build immediately if any arch fails
1391           --skip-remote-rules-validation
1392                                 Don't check if there's a valid gating.yaml
1393                                 file in the repo, where you can define
1394                                 additional policies for Greenwave gating.
1395           --srpm [SRPM]         Build from an srpm. If no srpm is provided
1396                                 with this option an srpm will be generated
1397                                 from the current module content.
1398
1399
1400   fedpkg sources
1401         usage: fedpkg sources [-h] [--outdir OUTDIR]
1402
1403         Download source files
1404
1405         optional arguments:
1406           -h, --help       show this help message and exit
1407           --outdir OUTDIR  Directory to download files into (defaults to
1408                            pwd)
1409
1410
1411   fedpkg srpm
1412         usage: fedpkg srpm [-h] [--builddir BUILDDIR]
1413                            [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1414                            [--define DEFINE] [--md5]
1415
1416         Create a source rpm
1417
1418         optional arguments:
1419           -h, --help            show this help message and exit
1420           --builddir BUILDDIR   Define an alternate builddir
1421           --buildrootdir BUILDROOTDIR
1422                                 Define an alternate buildrootdir
1423           --arch ARCH           Prep for a specific arch
1424           --define DEFINE       Pass custom macros to rpmbuild, may specify
1425                                 multiple times
1426           --md5                 Use md5 checksums (for older rpm hosts)
1427
1428
1429   fedpkg switch-branch
1430         usage: fedpkg switch-branch [-h] [-l] [--fetch] [branch]
1431
1432         This command can switch to a local git branch. If provided with a
1433         remote branch name that does not have a local match it will create
1434         one. It can also be used to list the existing local and remote
1435         branches.
1436
1437         positional arguments:
1438           branch      Branch name to switch to
1439
1440         optional arguments:
1441           -h, --help  show this help message and exit
1442           -l, --list  List both remote-tracking branches and local branches
1443           --fetch     Fetch new data from remote before switch
1444
1445
1446   fedpkg tag
1447         usage: fedpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l]
1448                           [-d]
1449                           [tag]
1450
1451         This command uses git to create, list, or delete tags.
1452
1453         positional arguments:
1454           tag                   Name of the tag
1455
1456         optional arguments:
1457           -h, --help            show this help message and exit
1458           -f, --force           Force the creation of the tag
1459           -m MESSAGE, --message MESSAGE
1460                                 Use the given <msg> as the tag message
1461           -c, --clog            Generate the tag message from the spec
1462                                 changelog section
1463           --raw                 Make the clog raw
1464           -F FILE, --file FILE  Take the tag message from the given file
1465           -l, --list            List all tags with a given pattern, or all
1466                                 if not pattern is given
1467           -d, --delete          Delete a tag
1468
1469
1470   fedpkg unused-patches
1471         usage: fedpkg unused-patches [-h]
1472
1473         Print list of patches not referenced by name in the specfile.
1474
1475         optional arguments:
1476           -h, --help  show this help message and exit
1477
1478
1479   fedpkg update
1480         usage: fedpkg update [-h]
1481                              [--type    {bugfix,security,enhancement,newpack‐
1482       age}]
1483                              [--request {testing,stable}]
1484                              [--bugs BUGS [BUGS ...]] [--notes NOTES]
1485                              [--disable-autokarma] [--stable-karma KARMA]
1486                              [--unstable-karma KARMA] [--not-close-bugs]
1487                              [--suggest-reboot] [--no-require-bugs]
1488                              [--no-require-testcases]
1489
1490         This will create a bodhi update request for the current package  n-v-
1491       r.
1492
1493         There  are  two  ways to specify update details. Without any argument
1494       from command
1495         line, either update type or notes is omitted, a template editor  will
1496       be shown
1497         and let you edit the detail information interactively.
1498
1499         Alternatively, you could specify argument from command line to create
1500       an update
1501         directly, for example:
1502
1503             fedpkg update --type bugfix --notes 'Rebuilt' --bugs 1000 1002
1504
1505         When all lines in template editor are commented out or  deleted,  the
1506       creation
1507         process is aborted. If the template keeps unchanged, fedpkg continues
1508       on creating
1509         update. That gives user a chance to confirm the auto-generated  notes
1510       from
1511         change log if option --notes is omitted.
1512
1513         optional arguments:
1514           -h, --help            show this help message and exit
1515           --type {bugfix,security,enhancement,newpackage}
1516                                 Update type. Template editor will be shown
1517                                 if type is omitted.
1518           --request {testing,stable}
1519                                 Requested repository.
1520           --bugs BUGS [BUGS ...]
1521                                 Bug numbers. If omitted, bug numbers will be
1522                                 extracted from change logs.
1523           --notes NOTES         Update description. Multiple lines of notes
1524                                 could be specified. If omitted, template
1525                                 editor will be shown.
1526           --disable-autokarma   Karma automatism is enabled by default. Use
1527                                 this option to disable that.
1528           --stable-karma KARMA  Stable karma. Default is 3.
1529           --unstable-karma KARMA
1530                                 Unstable karma. Default is -3.
1531           --not-close-bugs      By default, update will be created by
1532                                 enabling to close bugs automatically. If
1533                                 this is what you do not want, use this
1534                                 option to disable the default behavior.
1535           --suggest-reboot      Suggest user to reboot after update. Default
1536                                 is False.
1537           --no-require-bugs     Disables the requirement that all of the
1538                                 bugs in your update have been confirmed by
1539                                 testers. Default is True.
1540           --no-require-testcases
1541                                 Disables the requirement that this update
1542                                 passes all test cases before reaching
1543                                 stable. Default is True.
1544
1545
1546   fedpkg upload
1547         usage: fedpkg upload [-h] files [files ...]
1548
1549         This command will upload new source file(s) to lookaside cache.
1550         Source file names are appended to sources file, and .gitignore will
1551         be also updated with new uploaded file(s). Please remember to commit
1552         them.
1553
1554         positional arguments:
1555           files
1556
1557         optional arguments:
1558           -h, --help  show this help message and exit
1559
1560
1561   fedpkg verify-files
1562         usage: fedpkg verify-files [-h] [--builddir BUILDDIR]
1563                                    [--buildrootdir BUILDROOTDIR]
1564                                    [--arch ARCH] [--define DEFINE]
1565
1566         Locally run 'rpmbuild -bl' to verify the spec file's %files
1567         sections. This requires a successful run of 'fedpkg install' in
1568         advance.
1569
1570         optional arguments:
1571           -h, --help            show this help message and exit
1572           --builddir BUILDDIR   Define an alternate builddir
1573           --buildrootdir BUILDROOTDIR
1574                                 Define an alternate buildrootdir
1575           --arch ARCH           Prep for a specific arch
1576           --define DEFINE       Pass custom macros to rpmbuild, may specify
1577                                 multiple times
1578
1579
1580   fedpkg verrel
1581         usage: fedpkg verrel [-h]
1582
1583         Print the name-version-release.
1584
1585         optional arguments:
1586           -h, --help  show this help message and exit
1587
1588

SEE ALSO

1590       https://pagure.io/fedpkg/
1591
1592
1593
1594                                  2020-03-30                         fedpkg(1)
Impressum