1fedpkg(1) rpm-packager fedpkg(1)
2
6 fedpkg - RPM Packaging utility
7
9 fedpkg [ global_options ] command [ command_options ] [ command_argu‐
10 ments ]
11 fedpkg help
12 fedpkg command --help
13
15 fedpkg is a script to interact with the RPM Packaging system.
16 Global Options
18 --config CONFIG, -C CONFIG
19 Specify a config file to use
20 --dry-run Perform a dry run.
21 --release RELEASE Override the discovered release, e.g. f25,
22 which has to match the remote branch name
23 created in package repository. Particularly,
24 use rawhide/main branch to build RPMs for
25 rawhide.
26 --dist DIST Deprecated. Use --release instead. You can
27 use --dist for a while for backward-
28 compatibility. It will be disabled in future
29 version.
30 --module-name MODULE_NAME
31 Deprecated. Use combination of --name and
32 --namespace. Override the module name.
33 Otherwise it is discovered from: Git push
34 URL or Git URL (last part of path with .git
35 extension removed) or from name macro in
36 spec file. In that order.
37 --name NAME Override repository name. Use --namespace
38 option to change namespace. If not
39 specified, name is discovered from Git push
40 URL or Git URL (last part of path with .git
41 extension removed) or from Name macro in
42 spec file, in that order.
43 --namespace NAMESPACE
44 The package repository namespace. If
45 omitted, default to rpms if namespace is
46 enabled.
47 --user USER Override the discovered user name
48 --password PASSWORD Password for Koji login
49 --runas RUNAS Run Koji commands as a different user
50 --path PATH Define the directory to work in (defaults to
51 cwd)
52 --verbose, -v Run with verbose debug output
53 --debug, -d Run with debug output
54 -q Run quietly only displaying errors
55 --user-config USER_CONFIG
56 Specify a user config file to use
57
59 fedpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait] [--target
60 TARGET] [--background] [--fail-fast] [--skip-remote-rules-validation]
61 [--skip-nvr-check] [--skip-tag] [--scratch] [--srpm [SRPM]]
62 Request build
63 fedpkg chain-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
65 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
66 validation] [--skip-nvr-check] package [package ...]
67 Build current package in order with other packages
68 fedpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t] [-F
70 FILE] [-p] [-s] [files ...]
71 Alias for commit
72 fedpkg clean [-h] [--dry-run] [-x]
74 Remove untracked files
75 fedpkg clog [-h] [--raw]
77 Make a clog file containing top changelog entry
78 fedpkg clone [-h] [--branches] [--branch BRANCH] [--anonymous] [--depth
80 DEPTH] repo [clone_target] ...
81 Clone and checkout a repository
82 fedpkg co [-h] [--branches] [--branch BRANCH] [--anonymous] [--depth
84 DEPTH] repo [clone_target] ...
85 Alias for clone
86 fedpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t]
88 [-F FILE] [-p] [-s] [files ...]
89 Commit changes
90 fedpkg compile [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
92 [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
93 Local test rpmbuild compile
94 fedpkg container-build [-h] [--target TARGET] [--nowait] [--build-re‐
96 lease BUILD_RELEASE] [--isolated] [--koji-parent-build KOJI_PAR‐
97 ENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--repo-url URL [URL
98 ...]] [--signing-intent SIGNING_INTENT] [--skip-remote-rules-valida‐
99 tion] [--skip-build] [--compose-id COMPOSE_ID [COMPOSE_ID ...]] [--re‐
100 place-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MAN‐
101 AGER:NAME:VERSION[:NEW_NAME] ...]]
102 Build a container
103 fedpkg container-build-setup [-h] (--get-autorebuild | --set-autore‐
105 build {true,false})
106 set options for container-build
107 fedpkg copr-build [-h] [--config CONFIG] [--nowait] project
109 Build package in Copr
110 fedpkg diff [-h] [--cached] [files ...]
112 Show changes between commits, commit and working tree, etc
113 fedpkg flatpak-build [-h] [--target TARGET] [--nowait] [--build-release
115 BUILD_RELEASE] [--isolated] [--koji-parent-build KOJI_PARENT_BUILD]
116 [--scratch] [--arches [ARCHES ...]] [--repo-url URL [URL ...]] [--sign‐
117 ing-intent SIGNING_INTENT] [--skip-remote-rules-validation] [--skip-
118 build]
119 Build a Flatpak
120 fedpkg fork [-h]
122 Create a new fork of the current repository
123 fedpkg gimmespec [-h]
125 Print the spec file name
126 fedpkg gitbuildhash [-h] build
128 Print the git hash used to build the provided n-v-r
129 fedpkg giturl [-h]
131 Print the git url for building
132 fedpkg help [-h]
134 Show usage
135 fedpkg import [-h] [--skip-diffs] [--offline] srpm
137 Import srpm content into a module
138 fedpkg install [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
140 [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
141 Local test rpmbuild install
142 fedpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
144 Run rpmlint against local spec and build output if present.
145 fedpkg list-side-tags [-h] [--mine | --user TAG_OWNER | --base-tag
147 BASE_TAG]
148 List existing side-tags
149 fedpkg local [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
151 [--arch ARCH] [--define DEFINE] [--md5] [--with BCOND_WITH] [--without
152 BCOND_WITHOUT] ...
153 Local test rpmbuild binary
154 fedpkg mock-config [-h] [--target TARGET] [--arch ARCH]
156 Generate a mock config
157 fedpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean] [--no-
159 cleanup-after] [--no-clean-all] [--with BCOND_WITH] [--without
160 BCOND_WITHOUT] [--shell] [--enablerepo ENABLEREPO] [--disablerepo DIS‐
161 ABLEREPO] [--enable-network] ...
162 Local test build using mock
163 fedpkg module-build [-h] [--watch] [--buildrequires name:stream] [--re‐
165 quires name:stream] [--optional key=value] [--file [FILE_PATH]] [--srpm
166 SRPMS] [--scratch] [scm_url] [branch]
167 Build a module using MBS
168 fedpkg module-build-cancel [-h] build_id
170 Cancel an MBS module build
171 fedpkg module-build-info [-h] build_id
173 Show information of an MBS module build
174 fedpkg module-build-local [-h] [--file [FILE_PATH]] [--srpm SRPMS]
176 [--stream [STREAM]] [--skip-tests] [--add-local-build N:S:V] [-s N:S]
177 [--offline] [-r PATH]
178 Build a module locally using the mbs-manager command
179 fedpkg module-build-watch [-h] build_id [build_id ...]
181 Watch an MBS build
182 fedpkg module-overview [-h] [--unfinished] [--limit LIMIT] [--owner
184 FAS_ID | --mine]
185 Shows an overview of MBS builds
186 fedpkg module-scratch-build [-h] [--watch] [--buildrequires
188 name:stream] [--requires name:stream] [--optional key=value] [--file
189 [FILE_PATH]] [--srpm SRPMS] [scm_url] [branch]
190 Build a scratch module using MBS
191 fedpkg new [-h]
193 Diff against last tag
194 fedpkg new-sources [-h] files [files ...]
196 Upload source files
197 fedpkg override [-h] {create,extend} ...
199 Manage buildroot overrides
200 fedpkg patch [-h] [--rediff] suffix
202 Create and add a gendiff patch file
203 fedpkg prep [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
205 [--arch ARCH] [--define DEFINE] ...
206 Local test rpmbuild prep
207 fedpkg pull [-h] [--rebase] [--no-rebase]
209 Pull changes from the remote repository and update the working
210 copy.
211 fedpkg push [-h] [--force]
213 Push changes to remote repository
214 fedpkg releases-info [-h] [-e | -f | -j]
216 Print Fedora or EPEL current active releases
217 fedpkg remove-side-tag [-h] TAG
219 Remove a side tag (without merging packages)
220 fedpkg request-branch [-h] [--repo NAME] [--namespace {rpms,con‐
222 tainer,modules,flatpaks}] [--sl [SL ...]] [--no-git-branch] [--no-auto-
223 module] [--all-releases] [branch]
224 Request a new dist-git branch
225 fedpkg request-repo [-h] [--namespace {rpms,container,modules,flat‐
227 paks}] [--description DESCRIPTION] [--monitor {no-monitoring,monitor‐
228 ing,monitoring-with-scratch}] [--upstreamurl UPSTREAMURL] [--summary
229 SUMMARY] [--exception] [--no-initial-commit] name [bug]
230 Request a new dist-git repository
231 fedpkg request-side-tag [-h] [--base-tag BASE_TAG]
233 Create a new side tag
234 fedpkg request-tests-repo [-h] [--bug BUG] name description
236 Request a new tests dist-git repository
237 fedpkg retire [-h] reason
239 Retire a package/module
240 fedpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
242 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
243 validation] [--srpm [SRPM]]
244 Request scratch build
245 fedpkg sources [-h] [--outdir OUTDIR]
247 Download source files
248 fedpkg srpm [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
250 [--arch ARCH] [--define DEFINE] [--md5] ...
251 Create a source rpm
252 fedpkg switch-branch [-h] [-l] [--fetch] [branch]
254 Work with branches
255 fedpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l] [-d]
257 [tag]
258 Management of git tags
259 fedpkg unused-patches [-h]
261 Print list of patches not referenced by name in the specfile
262 fedpkg update [-h] [--type {bugfix,security,enhancement,newpackage}]
264 [--request {testing,stable}] [--bugs BUGS [BUGS ...]] [--notes NOTES]
265 [--disable-autokarma] [--stable-karma KARMA] [--unstable-karma KARMA]
266 [--not-close-bugs] [--suggest-reboot] [--no-require-bugs] [--no-re‐
267 quire-testcases]
268 Submit last build as update
269 fedpkg upload [-h] files [files ...]
271 Upload source files
272 fedpkg verify-files [-h] [--builddir BUILDDIR] [--buildrootdir BUILD‐
274 ROOTDIR] [--arch ARCH] [--define DEFINE] ...
275 Locally verify %%files section
276 fedpkg verrel [-h]
278 Print the name-version-release
279
281 fedpkg build
282 usage: fedpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
283 [--target TARGET] [--background] [--fail-fast]
284 [--skip-remote-rules-validation]
285 [--skip-nvr-check] [--skip-tag] [--scratch]
286 [--srpm [SRPM]]
287 This command requests a build of the package in the build
289 system. By
290 default it discovers the target to build for based on branch data,
291 and
292 uses the latest commit as the build source.
293 fedpkg is also able to submit multiple builds to Koji at
295 once from stream
296 branch based on a local config, which is inside the
297 repository. The config file
298 is named package.cfg in INI format. For example,
299 [koji]
301 targets = rawhide fedora epel7
302 You only need to put Fedora releases and EPEL in option
304 targets and fedpkg will
305 convert it to proper Koji build target for submitting
306 builds. Beside regular
307 release names, option targets accepts two shortcut names
308 as well, fedora and
309 epel, as you can see in the above example. Name fedora
310 stands for current
311 active Fedora releases, and epel stands for the active
312 EPEL releases, which are
313 el6 and epel7 currently.
314 Note that the config file is a branch specific file. That
316 means you could
317 create package.cfg for each stream branch separately to
318 indicate on which
319 targets to build the package for a particular stream.
320 optional arguments:
322 -h, --help show this help message and exit
323 --arches [ARCHES ...]
324 Build for specific arches
325 --md5 Use md5 checksums (for older rpm hosts)
326 --nowait Don't wait on build
327 --target TARGET Define build target to build into
328 --background Run the build at a low priority
329 --fail-fast Fail the build immediately if any arch fails
330 --skip-remote-rules-validation
331 Don't check if there's a valid gating.yaml
332 file in the repo, where you can define
333 additional policies for Greenwave gating.
334 --skip-nvr-check Submit build to buildsystem without check if
335 NVR was already built. NVR is constructed
336 locally and may be different from NVR
337 constructed during build on builder.
338 --skip-tag Do not attempt to tag package
339 --scratch Perform a scratch build
340 --srpm [SRPM] Build from an srpm. If no srpm is provided
341 with this option an srpm will be generated
342 from current module content.
343 fedpkg chain-build
346 usage: fedpkg chain-build [-h] [--arches [ARCHES ...]] [--md5]
347 [--nowait] [--target TARGET]
348 [--background] [--fail-fast]
349 [--skip-remote-rules-validation]
350 [--skip-nvr-check]
351 package [package ...]
352 Build current package in order with other packages.
354 example: fedpkg chain-build libwidget libgizmo
356 The current package is added to the end of the CHAIN list.
358 Colons (:) can be used in the CHAIN parameter to define groups of
359 packages. Packages in any single group will be built in parallel
360 and all packages in a group must build successfully and populate
361 the repository before the next group will begin building.
362 For example:
364 fedpkg chain-build libwidget libaselib : libgizmo :
366 will cause libwidget and libaselib to be built in parallel, followed
368 by libgizmo and then the current directory package. If no groups are
369 defined, packages will be built sequentially.
370 positional arguments:
372 package List the packages and order you want to
373 build in
374 optional arguments:
376 -h, --help show this help message and exit
377 --arches [ARCHES ...]
378 Build for specific arches
379 --md5 Use md5 checksums (for older rpm hosts)
380 --nowait Don't wait on build
381 --target TARGET Define build target to build into
382 --background Run the build at a low priority
383 --fail-fast Fail the build immediately if any arch fails
384 --skip-remote-rules-validation
385 Don't check if there's a valid gating.yaml
386 file in the repo, where you can define
387 additional policies for Greenwave gating.
388 --skip-nvr-check Submit build to buildsystem without check if
389 NVR was already built. NVR is constructed
390 locally and may be different from NVR
391 constructed during build on builder.
392 fedpkg ci
395 usage: fedpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw]
396 [-t] [-F FILE] [-p] [-s]
397 [files ...]
398 Alias for commit.
400 positional arguments:
402 files Optional list of specific files to commit
403 optional arguments:
405 -h, --help show this help message and exit
406 -m MESSAGE, --message MESSAGE
407 Use the given <msg> as the commit message
408 summary
409 --with-changelog Get the last changelog from SPEC as commit
410 message content. This option must be used
411 with -m together.
412 -c, --clog Generate the commit message from the
413 Changelog section
414 --raw Make the clog raw
415 -t, --tag Create a tag for this commit
416 -F FILE, --file FILE Take the commit message from the given file
417 -p, --push Commit and push as one action
418 -s, --signoff Include a signed-off-by
419 fedpkg clean
422 usage: fedpkg clean [-h] [--dry-run] [-x]
423 This command can be used to clean up your working directory. By
425 default it will follow .gitignore rules.
426 optional arguments:
428 -h, --help show this help message and exit
429 --dry-run, -n Perform a dry-run
430 -x Do not follow .gitignore rules
431 fedpkg clog
434 usage: fedpkg clog [-h] [--raw]
435 This will create a file named "clog" that contains the latest rpm
437 changelog entry. The leading "- " text will be stripped.
438 optional arguments:
440 -h, --help show this help message and exit
441 --raw Generate a more "raw" clog without twiddling the
442 contents
443 fedpkg clone
446 usage: fedpkg clone [-h] [--branches] [--branch BRANCH]
447 [--anonymous] [--depth DEPTH]
448 repo [clone_target] ...
449 This command will clone the named repository from the configured
451 repository base URL. By default it will also checkout the master
452 branch for your working copy.
453 positional arguments:
455 repo Name of the repository to clone
456 clone_target Directory in which to clone the repository
457 extra_args Custom arguments that are passed to the 'git
458 clone'. Use '--' to separate them from other
459 arguments.
460 optional arguments:
462 -h, --help show this help message and exit
463 --branches, -B Do an old style checkout with subdirs for
464 branches
465 --branch BRANCH, -b BRANCH
466 Check out a specific branch
467 --anonymous, -a Check out a module anonymously
468 --depth DEPTH Create a shallow clone with a history
469 truncated to the specified number of commits
470 fedpkg co
473 usage: fedpkg co [-h] [--branches] [--branch BRANCH] [--anonymous]
474 [--depth DEPTH]
475 repo [clone_target] ...
476 Alias for clone.
478 positional arguments:
480 repo Name of the repository to clone
481 clone_target Directory in which to clone the repository
482 extra_args Custom arguments that are passed to the 'git
483 clone'. Use '--' to separate them from other
484 arguments.
485 optional arguments:
487 -h, --help show this help message and exit
488 --branches, -B Do an old style checkout with subdirs for
489 branches
490 --branch BRANCH, -b BRANCH
491 Check out a specific branch
492 --anonymous, -a Check out a module anonymously
493 --depth DEPTH Create a shallow clone with a history
494 truncated to the specified number of commits
495 fedpkg commit
498 usage: fedpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c]
499 [--raw] [-t] [-F FILE] [-p] [-s]
500 [files ...]
501 This invokes a git commit. All tracked files with changes will be
503 committed unless a specific file list is provided. $EDITOR will be
504 used to generate a changelog message unless one is given to the
505 command. A push can be done at the same time.
506 positional arguments:
508 files Optional list of specific files to commit
509 optional arguments:
511 -h, --help show this help message and exit
512 -m MESSAGE, --message MESSAGE
513 Use the given <msg> as the commit message
514 summary
515 --with-changelog Get the last changelog from SPEC as commit
516 message content. This option must be used
517 with -m together.
518 -c, --clog Generate the commit message from the
519 Changelog section
520 --raw Make the clog raw
521 -t, --tag Create a tag for this commit
522 -F FILE, --file FILE Take the commit message from the given file
523 -p, --push Commit and push as one action
524 -s, --signoff Include a signed-off-by
525 fedpkg compile
528 usage: fedpkg compile [-h] [--builddir BUILDDIR]
529 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
530 [--define DEFINE] [--short-circuit]
531 [--nocheck]
532 ...
533 This command calls rpmbuild to compile the source. By default the
535 prep and configure stages will be done as well, unless the short-
536 circuit option is used.
537 positional arguments:
539 extra_args Custom arguments that are passed to the
540 'rpmbuild'. Use '--' to separate them from
541 other arguments.
542 optional arguments:
544 -h, --help show this help message and exit
545 --builddir BUILDDIR Define an alternate builddir
546 --buildrootdir BUILDROOTDIR
547 Define an alternate buildrootdir
548 --arch ARCH Prep for a specific arch
549 --define DEFINE Pass custom macros to rpmbuild, may specify
550 multiple times
551 --short-circuit short-circuit compile
552 --nocheck nocheck compile
553 fedpkg container-build
556 usage: fedpkg container-build [-h] [--target TARGET] [--nowait]
557 [--build-release BUILD_RELEASE]
558 [--isolated]
559 [--koji-parent-build KOJI_PARENT_BUILD]
560 [--scratch] [--arches [ARCHES ...]]
561 [--repo-url URL [URL ...]]
562 [--signing-intent SIGNING_INTENT]
563 [--skip-remote-rules-validation]
564 [--skip-build]
565 [--compose-id COMPOSE_ID [COMPOSE_ID
566 ...]]
567 [--replace-dependency PKG_MAN‐
568 AGER:NAME:VERSION[:NEW_NAME]
569 [PKG_MANAGER:NAME:VERSION[:NEW_NAME]
570 ...]]
571 Build a container
573 optional arguments:
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 --compose-id COMPOSE_ID [COMPOSE_ID ...]
600 ODCS composes used. Cannot be used with
601 --signing-intent
602 --replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MAN‐
603 AGER:NAME:VERSION[:NEW_NAME] ...]
604 Cachito dependency replacement
605 fedpkg container-build-setup
608 usage: fedpkg container-build-setup [-h]
609 (--get-autorebuild | --set-au‐
610 torebuild {true,false})
611 set options for container-build.
613 optional arguments:
615 -h, --help show this help message and exit
616 --get-autorebuild Get autorebuild value
617 --set-autorebuild {true,false}
618 Turn autorebuilds on/off
619 fedpkg copr-build
622 usage: fedpkg copr-build [-h] [--config CONFIG] [--nowait] project
623 Build package in Copr.
625 Note: you need to have set up correct api key. For more information
627 see API KEY section of copr-cli(1) man page.
628 positional arguments:
630 project Name of the project in format USER/PROJECT
631 optional arguments:
633 -h, --help show this help message and exit
634 --config CONFIG Path to an alternative Copr configuration file
635 --nowait Don't wait on build
636 fedpkg diff
639 usage: fedpkg diff [-h] [--cached] [files ...]
640 Use git diff to show changes that have been made to tracked files.
642 By default cached changes (changes that have been git added) will
643 not be shown.
644 positional arguments:
646 files Optionally diff specific files
647 optional arguments:
649 -h, --help show this help message and exit
650 --cached View staged changes
651 fedpkg flatpak-build
654 usage: fedpkg flatpak-build [-h] [--target TARGET] [--nowait]
655 [--build-release BUILD_RELEASE]
656 [--isolated]
657 [--koji-parent-build KOJI_PARENT_BUILD]
658 [--scratch] [--arches [ARCHES ...]]
659 [--repo-url URL [URL ...]]
660 [--signing-intent SIGNING_INTENT]
661 [--skip-remote-rules-validation]
662 [--skip-build]
663 Build a Flatpak
665 optional arguments:
667 -h, --help show this help message and exit
668 --target TARGET Override the default target
669 --nowait Don't wait on build
670 --build-release BUILD_RELEASE
671 Specify a release value for this build's NVR
672 --isolated Do not update floating tags in the registry.
673 You must use the --build-release argument
674 --koji-parent-build KOJI_PARENT_BUILD
675 Specify a Koji NVR for the parent container
676 image. This will override the "FROM" value
677 in your Dockerfile.
678 --scratch Scratch build
679 --arches [ARCHES ...]
680 Limit a scratch or a isolated build to an
681 arch. May have multiple arches.
682 --repo-url URL [URL ...]
683 URLs of yum repo files
684 --signing-intent SIGNING_INTENT
685 Signing intent of the ODCS composes.
686 --skip-remote-rules-validation
687 Don't check if there's a valid gating.yaml
688 file in the repo
689 --skip-build Don't create build, but just modify settings
690 for autorebuilds
691 fedpkg fork
694 usage: fedpkg fork [-h]
695 Create a new fork of the current repository
697 Before the operation, you need to generate an API token at
699 https://src.fedoraproject.org/settings/token/new, select the relevant
700 ACL(s)
701 and save it in your local user configuration located
702 at ~/.config/rpkg/fedpkg.conf. For example:
703 [fedpkg.distgit]
705 token = <api_key_here>
706 Below is a basic example of the command to fork a current repository:
708 fedpkg fork
710 Operation requires username (FAS_ID). by default, current logged
712 username is taken. It could be overridden by reusing an argument:
713 fedpkg --user FAS_ID fork
715 optional arguments:
717 -h, --help show this help message and exit
718 fedpkg gimmespec
721 usage: fedpkg gimmespec [-h]
722 Print the spec file name.
724 optional arguments:
726 -h, --help show this help message and exit
727 fedpkg gitbuildhash
730 usage: fedpkg gitbuildhash [-h] build
731 This will show you the commit hash string used to build the provided
733 build n-v-r
734 positional arguments:
736 build name-version-release of the build to query.
737 optional arguments:
739 -h, --help show this help message and exit
740 fedpkg giturl
743 usage: fedpkg giturl [-h]
744 This will show you which git URL would be used in a build command.
746 It uses the git hashsum of the HEAD of the current branch (which may
747 not be pushed).
748 optional arguments:
750 -h, --help show this help message and exit
751 fedpkg help
754 usage: fedpkg help [-h]
755 Show usage.
757 optional arguments:
759 -h, --help show this help message and exit
760 fedpkg import
763 usage: fedpkg import [-h] [--skip-diffs] [--offline] srpm
764 This will extract sources, patches, and the spec file from an srpm
766 and update the current module accordingly. It will import to the
767 current branch by default.
768 positional arguments:
770 srpm Source rpm to import
771 optional arguments:
773 -h, --help show this help message and exit
774 --skip-diffs Don't show diffs when import srpms
775 --offline Do not upload files into lookaside cache
776 fedpkg install
779 usage: fedpkg install [-h] [--builddir BUILDDIR]
780 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
781 [--define DEFINE] [--short-circuit]
782 [--nocheck]
783 ...
784 This will call rpmbuild to run the install section. All leading
786 sections will be processed as well, unless the short-circuit option
787 is used.
788 positional arguments:
790 extra_args Custom arguments that are passed to the
791 'rpmbuild'. Use '--' to separate them from
792 other arguments.
793 optional arguments:
795 -h, --help show this help message and exit
796 --builddir BUILDDIR Define an alternate builddir
797 --buildrootdir BUILDROOTDIR
798 Define an alternate buildrootdir
799 --arch ARCH Prep for a specific arch
800 --define DEFINE Pass custom macros to rpmbuild, may specify
801 multiple times
802 --short-circuit short-circuit install
803 --nocheck nocheck install
804 fedpkg lint
807 usage: fedpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
808 Rpmlint can be configured using the --rpmlintconf/-r option or by
810 setting a <pkgname>.rpmlintrc file in the working directory
811 optional arguments:
813 -h, --help show this help message and exit
814 --info, -i Display explanations for reported messages
815 --rpmlintconf RPMLINTCONF, -r RPMLINTCONF
816 Use a specific configuration file for
817 rpmlint
818 fedpkg list-side-tags
821 usage: fedpkg list-side-tags [-h]
822 [--mine | --user TAG_OWNER | --base-tag
823 BASE_TAG]
824 List existing side-tags.
826 optional arguments:
828 -h, --help show this help message and exit
829 --mine List only my side tags
830 --user TAG_OWNER List side tags created by this user
831 --base-tag BASE_TAG List only tags based on this base
832 fedpkg local
835 usage: fedpkg local [-h] [--builddir BUILDDIR]
836 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
837 [--define DEFINE] [--md5] [--with BCOND_WITH]
838 [--without BCOND_WITHOUT]
839 ...
840 Locally test run of rpmbuild producing binary RPMs. The rpmbuild
842 output will be logged into a file named
843 .build-%{version}-%{release}.log
844 positional arguments:
846 extra_args Custom arguments that are passed to the
847 'rpmbuild'. Use '--' to separate them from
848 other arguments.
849 optional arguments:
851 -h, --help show this help message and exit
852 --builddir BUILDDIR Define an alternate builddir
853 --buildrootdir BUILDROOTDIR
854 Define an alternate buildrootdir
855 --arch ARCH Prep for a specific arch
856 --define DEFINE Pass custom macros to rpmbuild, may specify
857 multiple times
858 --md5 Use md5 checksums (for older rpm hosts)
859 --with BCOND_WITH Enable configure option (bcond) for the
860 build
861 --without BCOND_WITHOUT
862 Disable configure option (bcond) for the
863 build
864 fedpkg mock-config
867 usage: fedpkg mock-config [-h] [--target TARGET] [--arch ARCH]
868 This will generate a mock config based on the buildsystem target
870 optional arguments:
872 -h, --help show this help message and exit
873 --target TARGET Override target used for config
874 --arch ARCH Override local arch
875 fedpkg mockbuild
878 usage: fedpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean]
879 [--no-cleanup-after] [--no-clean-all]
880 [--with BCOND_WITH]
881 [--without BCOND_WITHOUT] [--shell]
882 [--enablerepo ENABLEREPO]
883 [--disablerepo DISABLEREPO]
884 [--enable-network]
885 ...
886 This will use the mock utility to build the package for the
888 distribution detected from branch information. This can be
889 overridden using the global --release option. Your user must be in
890 the local "mock" group.
891 positional arguments:
893 extra_args Custom arguments that are passed to the
894 'mock'. Use '--' to separate them from other
895 arguments.
896 optional arguments:
898 -h, --help show this help message and exit
899 --root CONFIG, --mock-config CONFIG
900 Override mock configuration (like mock -r)
901 --md5 Use md5 checksums (for older rpm hosts)
902 --no-clean, -n Do not clean chroot before building package
903 --no-cleanup-after Do not clean chroot after building (if
904 automatic cleanup is enabled
905 --no-clean-all, -N Alias for both --no-clean and --no-cleanup-
906 after
907 --with BCOND_WITH Enable configure option (bcond) for the
908 build
909 --without BCOND_WITHOUT
910 Disable configure option (bcond) for the
911 build
912 --shell Run commands interactively within chroot.
913 Before going into chroot, mockbuild needs to
914 run with --no-cleanup-after in advanced.
915 --enablerepo ENABLEREPO
916 Pass enablerepo option to yum/dnf (may be
917 used more than once)
918 --disablerepo DISABLEREPO
919 Pass disablerepo option to yum/dnf (may be
920 used more than once)
921 --enable-network Enable networking
922 If config file for mock isn't found in the /etc/mock directory, a
924 temporary config directory for mock is created and populated with a
925 config file created with mock-config.
926 fedpkg module-build
929 usage: fedpkg module-build [-h] [--watch]
930 [--buildrequires name:stream]
931 [--requires name:stream]
932 [--optional key=value]
933 [--file [FILE_PATH]] [--srpm SRPMS]
934 [--scratch]
935 [scm_url] [branch]
936 Build a module using MBS
938 positional arguments:
940 scm_url The module's SCM URL. This defaults to the
941 current repo.
942 branch The module's SCM branch. This defaults to
943 the current checked-out branch.
944 optional arguments:
946 -h, --help show this help message and exit
947 --watch, -w Watch the module build
948 --buildrequires name:stream
949 Buildrequires to override in the form of
950 "name:stream"
951 --requires name:stream
952 Requires to override in the form of
953 "name:stream"
954 --optional key=value MBS optional arguments in the form of
955 "key=value". For example: 'fedpkg module-
956 build --optional
957 "reuse_components_from=<NSVC>"'. More
958 description including list of available
959 arguments here: https://pagure.io/fm-
960 orchestrator/
961 --file [FILE_PATH] The modulemd yaml file for module scratch
962 build.
963 --srpm SRPMS Include one or more srpms for module scratch
964 build.
965 --scratch Perform a scratch build
966 fedpkg module-build-cancel
969 usage: fedpkg module-build-cancel [-h] build_id
970 Cancel an MBS module build
972 positional arguments:
974 build_id The ID of the module build to cancel
975 optional arguments:
977 -h, --help show this help message and exit
978 fedpkg module-build-info
981 usage: fedpkg module-build-info [-h] build_id
982 Show information of an MBS module build
984 positional arguments:
986 build_id The ID of the module build
987 optional arguments:
989 -h, --help show this help message and exit
990 fedpkg module-build-local
993 usage: fedpkg module-build-local [-h] [--file [FILE_PATH]]
994 [--srpm SRPMS] [--stream [STREAM]]
995 [--skip-tests]
996 [--add-local-build N:S:V] [-s N:S]
997 [--offline] [-r PATH]
998 Build a module locally using the mbs-manager command
1000 optional arguments:
1002 -h, --help show this help message and exit
1003 --file [FILE_PATH] The module's modulemd yaml file. If not
1004 specified, a yaml file with the same
1005 basename as the name of the repository will
1006 be used.
1007 --srpm SRPMS Include one or more srpms for module build.
1008 --stream [STREAM] The module's stream/SCM branch. This
1009 defaults to the current checked-out branch.
1010 --skip-tests Adds a macro for skipping the check section
1011 --add-local-build N:S:V
1012 Import previously finished local module
1013 builds into MBS in the format of name:stream
1014 or name:stream:version
1015 -s N:S, --set-default-stream N:S
1016 Set the default stream for given module
1017 dependency in case there are multiple
1018 streams to choose from.
1019 --offline Builds module offline without any external
1020 infrastructure
1021 -r PATH, --repository PATH
1022 Full path to .repo file defining the base
1023 module repository to use when --offline is
1024 used.
1025 fedpkg module-build-watch
1028 usage: fedpkg module-build-watch [-h] build_id [build_id ...]
1029 Watch an MBS build
1031 positional arguments:
1033 build_id The ID of the module build to watch
1034 optional arguments:
1036 -h, --help show this help message and exit
1037 fedpkg module-overview
1040 usage: fedpkg module-overview [-h] [--unfinished] [--limit LIMIT]
1041 [--owner FAS_ID | --mine]
1042 Shows an overview of MBS builds
1044 optional arguments:
1046 -h, --help show this help message and exit
1047 --unfinished Show unfinished module builds
1048 --limit LIMIT The number of most recent module builds to display
1049 --owner FAS_ID List only items of that owner
1050 --mine Use current Kerberos name or username
1051 fedpkg module-scratch-build
1054 usage: fedpkg module-scratch-build [-h] [--watch]
1055 [--buildrequires name:stream]
1056 [--requires name:stream]
1057 [--optional key=value]
1058 [--file [FILE_PATH]]
1059 [--srpm SRPMS]
1060 [scm_url] [branch]
1061 Build a scratch module using MBS
1063 positional arguments:
1065 scm_url The module's SCM URL. This defaults to the
1066 current repo.
1067 branch The module's SCM branch. This defaults to
1068 the current checked-out branch.
1069 optional arguments:
1071 -h, --help show this help message and exit
1072 --watch, -w Watch the module build
1073 --buildrequires name:stream
1074 Buildrequires to override in the form of
1075 "name:stream"
1076 --requires name:stream
1077 Requires to override in the form of
1078 "name:stream"
1079 --optional key=value MBS optional arguments in the form of
1080 "key=value". For example: 'fedpkg module-
1081 build --optional
1082 "reuse_components_from=<NSVC>"'. More
1083 description including list of available
1084 arguments here: https://pagure.io/fm-
1085 orchestrator/
1086 --file [FILE_PATH] The modulemd yaml file for module scratch
1087 build.
1088 --srpm SRPMS Include one or more srpms for module scratch
1089 build.
1090 fedpkg new
1093 usage: fedpkg new [-h]
1094 This will use git to show a diff of all the changes (even
1096 uncommitted changes) since the last git tag was applied.
1097 optional arguments:
1099 -h, --help show this help message and exit
1100 fedpkg new-sources
1103 usage: fedpkg new-sources [-h] files [files ...]
1104 This will upload new source file(s) to lookaside cache, and all file
1106 names listed in sources file will be replaced. .gitignore will be
1107 also updated with new uploaded file(s). Please remember to commit
1108 them.
1109 positional arguments:
1111 files
1112 optional arguments:
1114 -h, --help show this help message and exit
1115 fedpkg override
1118 usage: fedpkg override [-h] {create,extend} ...
1119 Manage buildroot overrides.
1121 optional arguments:
1123 -h, --help show this help message and exit
1124 subcommands:
1126 Commands on override
1127 {create,extend}
1129 create Create buildroot override from build
1130 extend Extend buildroot override expiration
1131 fedpkg patch
1134 usage: fedpkg patch [-h] [--rediff] suffix
1135 Create and add a gendiff patch file.
1137 positional arguments:
1139 suffix Look for files with this suffix to diff
1140 optional arguments:
1142 -h, --help show this help message and exit
1143 --rediff Recreate gendiff file retaining comments Saves old
1144 patch file with a suffix of ~
1145 Patch file will be named: package-version-suffix.patch and the file
1147 will be added to the repo index
1148 fedpkg prep
1151 usage: fedpkg prep [-h] [--builddir BUILDDIR]
1152 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1153 [--define DEFINE]
1154 ...
1155 Use rpmbuild to "prep" the sources (unpack the source archive(s) and
1157 apply any patches.)
1158 positional arguments:
1160 extra_args Custom arguments that are passed to the
1161 'rpmbuild'. Use '--' to separate them from
1162 other arguments.
1163 optional arguments:
1165 -h, --help show this help message and exit
1166 --builddir BUILDDIR Define an alternate builddir
1167 --buildrootdir BUILDROOTDIR
1168 Define an alternate buildrootdir
1169 --arch ARCH Prep for a specific arch
1170 --define DEFINE Pass custom macros to rpmbuild, may specify
1171 multiple times
1172 fedpkg pull
1175 usage: fedpkg pull [-h] [--rebase] [--no-rebase]
1176 This command uses git to fetch remote changes and apply them to the
1178 current working copy. A rebase option is available which can be used
1179 to avoid merges.
1180 optional arguments:
1182 -h, --help show this help message and exit
1183 --rebase Rebase the locally committed changes on top of the
1184 remote changes after fetching. This can avoid a merge
1185 commit, but does rewrite local history.
1186 --no-rebase Do not rebase, overriding .git settings to the
1187 contrary
1188 See git pull --help for more details
1190 fedpkg push
1193 usage: fedpkg push [-h] [--force]
1194 Push changes to remote repository.
1196 optional arguments:
1198 -h, --help show this help message and exit
1199 --force, -f Force push
1200 fedpkg releases-info
1203 usage: fedpkg releases-info [-h] [-e | -f | -j]
1204 Print Fedora or EPEL current active releases
1206 optional arguments:
1208 -h, --help show this help message and exit
1209 -e, --epel Only show EPEL releases.
1210 -f, --fedora Only show Fedora active releases.
1211 -j, --join Show all releases in one line separated by a space.
1212 fedpkg remove-side-tag
1215 usage: fedpkg remove-side-tag [-h] TAG
1216 Remove a side tag (without merging packages).
1218 positional arguments:
1220 TAG name of tag to be deleted
1221 optional arguments:
1223 -h, --help show this help message and exit
1224 fedpkg request-branch
1227 usage: fedpkg request-branch [-h] [--repo NAME]
1228 [--namespace {rpms,container,mod‐
1229 ules,flatpaks}]
1230 [--sl [SL ...]] [--no-git-branch]
1231 [--no-auto-module] [--all-releases]
1232 [branch]
1233 Request a new dist-git branch
1235 Please refer to the help of the request-repo command to see what has
1237 to be done before requesting a dist-git branch.
1238 Branch name could be one of current active Fedora and EPEL releases.
1240 Use
1241 command ``fedpkg releases-info`` to get release names that can be
1242 used to request
1243 a branch.
1244 Below are various examples of requesting a dist-git branch.
1246 Request a branch inside a cloned package repository:
1248 fedpkg request-branch f27
1250 Request a branch outside package repository, which could apply to
1252 cases of
1253 requested repository has not been approved and created, or just not
1254 change
1255 directory to package repository:
1256 fedpkg request-branch --repo foo f27
1258 Request a branch with service level tied to the branch. In this case
1260 branch
1261 argument has to be before --sl argument, because --sl allows multiple
1262 values.
1263 fedpkg request-branch branch_name --sl bug_fixes:2020-06-01
1265 rawhide:2019-12-01
1266 positional arguments:
1268 branch The branch to request.
1269 optional arguments:
1271 -h, --help show this help message and exit
1272 --repo NAME Repository name the new branch is requested
1273 for.
1274 --namespace {rpms,container,modules,flatpaks}
1275 Repository name the new branch is requested
1276 for.
1277 --sl [SL ...] The service levels (SLs) tied to the branch.
1278 This must be in the format of
1279 "sl_name:2020-12-01". This is only for non-
1280 release branches. You may provide more than
1281 one by separating each SL with a space. When
1282 the argument is used, branch argument has to
1283 be placed before --sl.
1284 --no-git-branch Don't create the branch in git but still
1285 create it in PDC
1286 --no-auto-module If requesting an rpm arbitrary branch, do
1287 not also request a new matching module. See
1288 https://pagure.io/fedrepo_req/issue/129
1289 --all-releases Make a new branch request for every active
1290 Fedora release
1291 fedpkg request-repo
1294 usage: fedpkg request-repo [-h]
1295 [--namespace {rpms,container,modules,flat‐
1296 paks}]
1297 [--description DESCRIPTION]
1298 [--monitor {no-monitoring,monitoring,moni‐
1299 toring-with-scratch}]
1300 [--upstreamurl UPSTREAMURL]
1301 [--summary SUMMARY] [--exception]
1302 [--no-initial-commit]
1303 name [bug]
1304 Request a new dist-git repository
1306 Before the operation, you need to generate a pagure.io API token at
1308 https://pagure.io/settings/token/new, select the relevant ACL(s)
1309 and save it in your local user configuration located
1310 at ~/.config/rpkg/fedpkg.conf. For example:
1311 [fedpkg.pagure]
1313 token = <api_key_here>
1314 Below is a basic example of the command to request a dist-git reposi‐
1316 tory for
1317 the package foo:
1318 fedpkg request-repo foo 1234
1320 Another example to request a module foo:
1322 fedpkg request-repo --namespace modules foo
1324 positional arguments:
1326 name Repository name to request.
1327 bug Bugzilla bug ID of the package review
1328 request. Not required for requesting a
1329 module repository
1330 optional arguments:
1332 -h, --help show this help message and exit
1333 --namespace {rpms,container,modules,flatpaks}
1334 Namespace of repository. If omitted, default
1335 to rpms.
1336 --description DESCRIPTION, -d DESCRIPTION
1337 The repo's description in dist-git
1338 --monitor {no-monitoring,monitoring,monitoring-with-scratch}, -m
1339 {no-monitoring,monitoring,monitoring-with-scratch}
1340 The Anitya monitoring type for the repo
1341 --upstreamurl UPSTREAMURL, -u UPSTREAMURL
1342 The upstream URL of the project
1343 --summary SUMMARY, -s SUMMARY
1344 Override the package's summary from the
1345 Bugzilla bug
1346 --exception The package is an exception to the regular
1347 package review process (specifically, it
1348 does not require a Bugzilla bug)
1349 --no-initial-commit Do not include an initial commit in the
1350 repository.
1351 fedpkg request-side-tag
1354 usage: fedpkg request-side-tag [-h] [--base-tag BASE_TAG]
1355 Create a new side tag.
1357 optional arguments:
1359 -h, --help show this help message and exit
1360 --base-tag BASE_TAG name of base tag
1361 fedpkg request-tests-repo
1364 usage: fedpkg request-tests-repo [-h] [--bug BUG] name description
1365 Request a new dist-git repository in tests shared namespace
1367 https://src.fedoraproject.org/projects/tests/*
1369 For more information about tests shared namespace see
1371 https://fedoraproject.org/wiki/CI/Share_Test_Code
1373 Please refer to the request-repo command to see what has to be done
1375 before
1376 requesting a repository in the tests namespace.
1377 Below is a basic example of the command to request a dist-git reposi‐
1379 tory for
1380 the space tests/foo:
1381 fedpkg request-tests-repo foo "Description of the repository"
1383 Note that the space name needs to reflect the intent of the tests and
1385 will
1386 undergo a manual review.
1387 positional arguments:
1389 name Repository name to request.
1390 description Description of the tests repository
1391 optional arguments:
1393 -h, --help show this help message and exit
1394 --bug BUG Bugzilla bug ID of the package review request.
1395 fedpkg retire
1398 usage: fedpkg retire [-h] reason
1399 This command will remove all files from the repo, leave a
1401 dead.package file for rpms or dead.module file for modules, and push
1402 the changes.
1403 positional arguments:
1405 reason Reason for retiring the package/module
1406 optional arguments:
1408 -h, --help show this help message and exit
1409 fedpkg scratch-build
1412 usage: fedpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5]
1413 [--nowait] [--target TARGET]
1414 [--background] [--fail-fast]
1415 [--skip-remote-rules-validation]
1416 [--srpm [SRPM]]
1417 This command will request a scratch build of the package. Without
1419 providing an srpm, it will attempt to build the latest commit, which
1420 must have been pushed. By default all appropriate arches will be
1421 built.
1422 optional arguments:
1424 -h, --help show this help message and exit
1425 --arches [ARCHES ...]
1426 Build for specific arches
1427 --md5 Use md5 checksums (for older rpm hosts)
1428 --nowait Don't wait on build
1429 --target TARGET Define build target to build into
1430 --background Run the build at a low priority
1431 --fail-fast Fail the build immediately if any arch fails
1432 --skip-remote-rules-validation
1433 Don't check if there's a valid gating.yaml
1434 file in the repo, where you can define
1435 additional policies for Greenwave gating.
1436 --srpm [SRPM] Build from an srpm. If no srpm is provided
1437 with this option an srpm will be generated
1438 from the current module content.
1439 fedpkg sources
1442 usage: fedpkg sources [-h] [--outdir OUTDIR]
1443 Download source files
1445 optional arguments:
1447 -h, --help show this help message and exit
1448 --outdir OUTDIR Directory to download files into (defaults to
1449 pwd)
1450 fedpkg srpm
1453 usage: fedpkg srpm [-h] [--builddir BUILDDIR]
1454 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1455 [--define DEFINE] [--md5]
1456 ...
1457 Create a source rpm
1459 positional arguments:
1461 extra_args Custom arguments that are passed to the
1462 'rpmbuild'. Use '--' to separate them from
1463 other arguments.
1464 optional arguments:
1466 -h, --help show this help message and exit
1467 --builddir BUILDDIR Define an alternate builddir
1468 --buildrootdir BUILDROOTDIR
1469 Define an alternate buildrootdir
1470 --arch ARCH Prep for a specific arch
1471 --define DEFINE Pass custom macros to rpmbuild, may specify
1472 multiple times
1473 --md5 Use md5 checksums (for older rpm hosts)
1474 fedpkg switch-branch
1477 usage: fedpkg switch-branch [-h] [-l] [--fetch] [branch]
1478 This command can switch to a local git branch. If provided with a
1480 remote branch name that does not have a local match it will create
1481 one. It can also be used to list the existing local and remote
1482 branches.
1483 positional arguments:
1485 branch Branch name to switch to
1486 optional arguments:
1488 -h, --help show this help message and exit
1489 -l, --list List both remote-tracking branches and local branches
1490 --fetch Fetch new data from remote before switch
1491 fedpkg tag
1494 usage: fedpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l]
1495 [-d]
1496 [tag]
1497 This command uses git to create, list, or delete tags.
1499 positional arguments:
1501 tag Name of the tag
1502 optional arguments:
1504 -h, --help show this help message and exit
1505 -f, --force Force the creation of the tag
1506 -m MESSAGE, --message MESSAGE
1507 Use the given <msg> as the tag message
1508 -c, --clog Generate the tag message from the spec
1509 changelog section
1510 --raw Make the clog raw
1511 -F FILE, --file FILE Take the tag message from the given file
1512 -l, --list List all tags with a given pattern, or all
1513 if not pattern is given
1514 -d, --delete Delete a tag
1515 fedpkg unused-patches
1518 usage: fedpkg unused-patches [-h]
1519 Print list of patches not referenced by name in the specfile.
1521 optional arguments:
1523 -h, --help show this help message and exit
1524 fedpkg update
1527 usage: fedpkg update [-h]
1528 [--type {bugfix,security,enhancement,newpack‐
1529 age}]
1530 [--request {testing,stable}]
1531 [--bugs BUGS [BUGS ...]] [--notes NOTES]
1532 [--disable-autokarma] [--stable-karma KARMA]
1533 [--unstable-karma KARMA] [--not-close-bugs]
1534 [--suggest-reboot] [--no-require-bugs]
1535 [--no-require-testcases]
1536 This will create a bodhi update request for the current package n-v-
1538 r.
1539 There are two ways to specify update details. Without any argument
1541 from command
1542 line, either update type or notes is omitted, a template editor will
1543 be shown
1544 and let you edit the detail information interactively.
1545 Alternatively, you could specify argument from command line to create
1547 an update
1548 directly, for example:
1549 fedpkg update --type bugfix --notes 'Rebuilt' --bugs 1000 1002
1551 When all lines in template editor are commented out or deleted, the
1553 creation
1554 process is aborted. If the template keeps unchanged, fedpkg continues
1555 on creating
1556 update. That gives user a chance to confirm the auto-generated notes
1557 from
1558 change log if option --notes is omitted.
1559 optional arguments:
1561 -h, --help show this help message and exit
1562 --type {bugfix,security,enhancement,newpackage}
1563 Update type. Template editor will be shown
1564 if type is omitted.
1565 --request {testing,stable}
1566 Requested repository.
1567 --bugs BUGS [BUGS ...]
1568 Bug numbers. If omitted, bug numbers will be
1569 extracted from change logs.
1570 --notes NOTES Update description. Multiple lines of notes
1571 could be specified. If omitted, template
1572 editor will be shown.
1573 --disable-autokarma Karma automatism is enabled by default. Use
1574 this option to disable that.
1575 --stable-karma KARMA Stable karma. Default is 3.
1576 --unstable-karma KARMA
1577 Unstable karma. Default is -3.
1578 --not-close-bugs By default, update will be created by
1579 enabling to close bugs automatically. If
1580 this is what you do not want, use this
1581 option to disable the default behavior.
1582 --suggest-reboot Suggest user to reboot after update. Default
1583 is False.
1584 --no-require-bugs Disables the requirement that all of the
1585 bugs in your update have been confirmed by
1586 testers. Default is True.
1587 --no-require-testcases
1588 Disables the requirement that this update
1589 passes all test cases before reaching
1590 stable. Default is True.
1591 fedpkg upload
1594 usage: fedpkg upload [-h] files [files ...]
1595 This command will upload new source file(s) to lookaside cache.
1597 Source file names are appended to sources file, and .gitignore will
1598 be also updated with new uploaded file(s). Please remember to commit
1599 them.
1600 positional arguments:
1602 files
1603 optional arguments:
1605 -h, --help show this help message and exit
1606 fedpkg verify-files
1609 usage: fedpkg verify-files [-h] [--builddir BUILDDIR]
1610 [--buildrootdir BUILDROOTDIR]
1611 [--arch ARCH] [--define DEFINE]
1612 ...
1613 Locally run 'rpmbuild -bl' to verify the spec file's %files
1615 sections. This requires a successful run of 'fedpkg install' in
1616 advance.
1617 positional arguments:
1619 extra_args Custom arguments that are passed to the
1620 'rpmbuild'. Use '--' to separate them from
1621 other arguments.
1622 optional arguments:
1624 -h, --help show this help message and exit
1625 --builddir BUILDDIR Define an alternate builddir
1626 --buildrootdir BUILDROOTDIR
1627 Define an alternate buildrootdir
1628 --arch ARCH Prep for a specific arch
1629 --define DEFINE Pass custom macros to rpmbuild, may specify
1630 multiple times
1631 fedpkg verrel
1634 usage: fedpkg verrel [-h]
1635 Print the name-version-release.
1637 optional arguments:
1639 -h, --help show this help message and exit
1640
1643 https://pagure.io/fedpkg/
1644 2021-04-03 fedpkg(1)