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
19 fedpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait] [--target
20 TARGET] [--background] [--fail-fast] [--skip-remote-rules-validation]
21 [--skip-nvr-check] [--skip-tag] [--scratch] [--srpm [SRPM]]
22 Request build
23 fedpkg chain-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
25 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
26 validation] [--skip-nvr-check] package [package ...]
27 Build current package in order with other packages
28 fedpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t] [-F
30 FILE] [-p] [-s] [files ...]
31 Alias for commit
32 fedpkg clean [-h] [--dry-run] [-x]
34 Remove untracked files
35 fedpkg clog [-h] [--raw]
37 Make a clog file containing top changelog entry
38 fedpkg clone [-h] [--branches] [--branch BRANCH] [--anonymous] [--depth
40 DEPTH] repo [clone_target] ...
41 Clone and checkout a repository
42 fedpkg co [-h] [--branches] [--branch BRANCH] [--anonymous] [--depth
44 DEPTH] repo [clone_target] ...
45 Alias for clone
46 fedpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t]
48 [-F FILE] [-p] [-s] [files ...]
49 Commit changes
50 fedpkg compile [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
52 [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
53 Local test rpmbuild compile
54 fedpkg container-build [-h] [--target TARGET] [--nowait] [--build-re‐
56 lease BUILD_RELEASE] [--isolated] [--koji-parent-build KOJI_PAR‐
57 ENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--repo-url URL [URL
58 ...]] [--signing-intent SIGNING_INTENT] [--skip-remote-rules-valida‐
59 tion] [--skip-build] [--compose-id COMPOSE_ID [COMPOSE_ID ...]] [--re‐
60 place-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MAN‐
61 AGER:NAME:VERSION[:NEW_NAME] ...]]
62 Build a container
63 fedpkg container-build-setup [-h] (--get-autorebuild | --set-autore‐
65 build {true,false})
66 set options for container-build
67 fedpkg copr-build [-h] [--config CONFIG] [--nowait] project
69 Build package in Copr
70 fedpkg diff [-h] [--cached] [files ...]
72 Show changes between commits, commit and working tree, etc
73 fedpkg flatpak-build [-h] [--target TARGET] [--nowait] [--build-release
75 BUILD_RELEASE] [--isolated] [--koji-parent-build KOJI_PARENT_BUILD]
76 [--scratch] [--arches [ARCHES ...]] [--repo-url URL [URL ...]] [--sign‐
77 ing-intent SIGNING_INTENT] [--skip-remote-rules-validation] [--skip-
78 build]
79 Build a Flatpak
80 fedpkg fork [-h]
82 Create a new fork of the current repository
83 fedpkg gimmespec [-h]
85 Print the spec file name
86 fedpkg gitbuildhash [-h] build
88 Print the git hash used to build the provided n-v-r
89 fedpkg giturl [-h]
91 Print the git url for building
92 fedpkg help [-h]
94 Show usage
95 fedpkg import [-h] [--skip-diffs] [--offline] srpm
97 Import srpm content into a module
98 fedpkg install [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
100 [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
101 Local test rpmbuild install
102 fedpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
104 Run rpmlint against local spec and build output if present.
105 fedpkg list-side-tags [-h] [--mine | --user TAG_OWNER | --base-tag
107 BASE_TAG]
108 List existing side-tags
109 fedpkg local [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
111 [--arch ARCH] [--define DEFINE] [--md5] [--with BCOND_WITH] [--without
112 BCOND_WITHOUT] ...
113 Local test rpmbuild binary
114 fedpkg mock-config [-h] [--target TARGET] [--arch ARCH]
116 Generate a mock config
117 fedpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean] [--no-
119 cleanup-after] [--no-clean-all] [--with BCOND_WITH] [--without
120 BCOND_WITHOUT] [--shell] [--enablerepo ENABLEREPO] [--disablerepo DIS‐
121 ABLEREPO] [--enable-network] ...
122 Local test build using mock
123 fedpkg module-build [-h] [--watch] [--buildrequires name:stream] [--re‐
125 quires name:stream] [--optional key=value] [--file [FILE_PATH]] [--srpm
126 SRPMS] [--scratch] [scm_url] [branch]
127 Build a module using MBS
128 fedpkg module-build-cancel [-h] build_id
130 Cancel an MBS module build
131 fedpkg module-build-info [-h] build_id
133 Show information of an MBS module build
134 fedpkg module-build-local [-h] [--file [FILE_PATH]] [--srpm SRPMS]
136 [--stream [STREAM]] [--skip-tests] [--add-local-build N:S:V] [-s N:S]
137 [--offline] [-r PATH]
138 Build a module locally using the mbs-manager command
139 fedpkg module-build-watch [-h] build_id [build_id ...]
141 Watch an MBS build
142 fedpkg module-overview [-h] [--unfinished] [--limit LIMIT] [--owner
144 FAS_ID | --mine]
145 Shows an overview of MBS builds
146 fedpkg module-scratch-build [-h] [--watch] [--buildrequires
148 name:stream] [--requires name:stream] [--optional key=value] [--file
149 [FILE_PATH]] [--srpm SRPMS] [scm_url] [branch]
150 Build a scratch module using MBS
151 fedpkg new [-h]
153 Diff against last tag
154 fedpkg new-sources [-h] [--offline] files [files ...]
156 Upload source files
157 fedpkg override [-h] {create,extend} ...
159 Manage buildroot overrides
160 fedpkg patch [-h] [--rediff] suffix
162 Create and add a gendiff patch file
163 fedpkg prep [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
165 [--arch ARCH] [--define DEFINE] ...
166 Local test rpmbuild prep
167 fedpkg pull [-h] [--rebase] [--no-rebase]
169 Pull changes from the remote repository and update the working
170 copy.
171 fedpkg push [-h] [--force]
173 Push changes to remote repository
174 fedpkg releases-info [-h] [-e | -f | -j]
176 Print Fedora or EPEL current active releases
177 fedpkg remote [-h] {add} ...
179 Operations with tracked repositories ('remotes'). This is an ex‐
180 perimental interface.
181 fedpkg remove-side-tag [-h] TAG
183 Remove a side tag (without merging packages)
184 fedpkg request-branch [-h] [--repo NAME] [--namespace {rpms,con‐
186 tainer,modules,flatpaks}] [--sl [SL ...]] [--no-git-branch] [--no-auto-
187 module] [--all-releases] [branch]
188 Request a new dist-git branch
189 fedpkg request-repo [-h] [--namespace {rpms,container,modules,flat‐
191 paks}] [--description DESCRIPTION] [--monitor {no-monitoring,monitor‐
192 ing,monitoring-with-scratch}] [--upstreamurl UPSTREAMURL] [--summary
193 SUMMARY] [--exception] [--no-initial-commit] name [bug]
194 Request a new dist-git repository
195 fedpkg request-side-tag [-h] [--base-tag BASE_TAG] [--suffix SUFFIX]
197 Create a new side tag
198 fedpkg request-tests-repo [-h] [--bug BUG] name description
200 Request a new tests dist-git repository
201 fedpkg retire [-h] reason
203 Retire a package/module
204 fedpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
206 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
207 validation] [--skip-nvr-check] [--srpm [SRPM]]
208 Request scratch build
209 fedpkg set-distgit-token [-h] token
211 Updates the fedpkg.distgit API token in ~/.con‐
212 fig/rpkg/fedpkg.conf file.
213 Tokens are of length 64 and contain only uppercase
215 and numerical values.
216 fedpkg set-pagure-token [-h] token
218 Updates the fedpkg.pagure API token in ~/.con‐
219 fig/rpkg/fedpkg.conf file.
220 Tokens are of length 64 and contain only uppercase
222 and numerical values.
223 fedpkg sources [-h] [--outdir OUTDIR]
225 Download source files
226 fedpkg srpm [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
228 [--arch ARCH] [--define DEFINE] [--md5] ...
229 Create a source rpm
230 fedpkg switch-branch [-h] [-l] [--fetch] [branch]
232 Work with branches
233 fedpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l] [-d]
235 [tag]
236 Management of git tags
237 fedpkg unused-patches [-h]
239 Print list of patches not referenced by name in the specfile
240 fedpkg update [-h] [--type {bugfix,security,enhancement,newpackage}]
242 [--request {testing,stable}] [--bugs BUGS [BUGS ...]] [--notes NOTES]
243 [--disable-autokarma] [--stable-karma KARMA] [--unstable-karma KARMA]
244 [--not-close-bugs] [--suggest-reboot] [--no-require-bugs] [--no-re‐
245 quire-testcases]
246 Submit last build as update
247 fedpkg upload [-h] [--offline] files [files ...]
249 Upload source files
250 fedpkg verify-files [-h] [--builddir BUILDDIR] [--buildrootdir BUILD‐
252 ROOTDIR] [--arch ARCH] [--define DEFINE] ...
253 Locally verify %%files section
254 fedpkg verrel [-h]
256 Print the name-version-release.
257
259 fedpkg build
260 usage: fedpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
261 [--target TARGET] [--background] [--fail-fast]
262 [--skip-remote-rules-validation]
263 [--skip-nvr-check] [--skip-tag] [--scratch]
264 [--srpm [SRPM]]
265 This command requests a build of the package in the build
267 system. By
268 default it discovers the target to build for based on branch data,
269 and
270 uses the latest commit as the build source.
271 fedpkg is also able to submit multiple builds to Koji at
273 once from stream
274 branch based on a local config, which is inside the
275 repository. The config file
276 is named package.cfg in INI format. For example,
277 [koji]
279 targets = rawhide fedora epel7
280 You only need to put Fedora releases and EPEL in option
282 targets and fedpkg will
283 convert it to proper Koji build target for submitting
284 builds. Beside regular
285 release names, option targets accepts two shortcut names
286 as well, fedora and
287 epel, as you can see in the above example. Name fedora
288 stands for current
289 active Fedora releases, and epel stands for the active
290 EPEL releases, which are
291 el6 and epel7 currently.
292 Note that the config file is a branch specific file. That
294 means you could
295 create package.cfg for each stream branch separately to
296 indicate on which
297 targets to build the package for a particular stream.
298 options:
300 -h, --help show this help message and exit
301 --arches [ARCHES ...]
302 Build for specific arches
303 --md5 Use md5 checksums (for older rpm hosts)
304 --nowait Don't wait on build
305 --target TARGET Define build target to build into
306 --background Run the build at a low priority
307 --fail-fast Fail the build immediately if any arch fails
308 --skip-remote-rules-validation
309 Don't check if there's a valid gating.yaml
310 file in the repo, where you can define
311 additional policies for Greenwave gating.
312 --skip-nvr-check Submit build to buildsystem without check if
313 NVR was already built. NVR is constructed
314 locally and may be different from NVR
315 constructed during build on builder.
316 --skip-tag Do not attempt to tag package
317 --scratch Perform a scratch build
318 --srpm [SRPM] Build from an srpm. If no srpm is provided
319 with this option an srpm will be generated
320 from current module content.
321 fedpkg chain-build
324 usage: fedpkg chain-build [-h] [--arches [ARCHES ...]] [--md5]
325 [--nowait] [--target TARGET]
326 [--background] [--fail-fast]
327 [--skip-remote-rules-validation]
328 [--skip-nvr-check]
329 package [package ...]
330 Build current package in order with other packages.
332 example: fedpkg chain-build libwidget libgizmo
334 The current package is added to the end of the CHAIN list.
336 Colons (:) can be used in the CHAIN parameter to define groups of
337 packages. Packages in any single group will be built in parallel
338 and all packages in a group must build successfully and populate
339 the repository before the next group will begin building.
340 For example:
342 fedpkg chain-build libwidget libaselib : libgizmo :
344 will cause libwidget and libaselib to be built in parallel, followed
346 by libgizmo and then the current directory package. If no groups are
347 defined, packages will be built sequentially.
348 positional arguments:
350 package List the packages and order you want to
351 build in
352 options:
354 -h, --help show this help message and exit
355 --arches [ARCHES ...]
356 Build for specific arches
357 --md5 Use md5 checksums (for older rpm hosts)
358 --nowait Don't wait on build
359 --target TARGET Define build target to build into
360 --background Run the build at a low priority
361 --fail-fast Fail the build immediately if any arch fails
362 --skip-remote-rules-validation
363 Don't check if there's a valid gating.yaml
364 file in the repo, where you can define
365 additional policies for Greenwave gating.
366 --skip-nvr-check Submit build to buildsystem without check if
367 NVR was already built. NVR is constructed
368 locally and may be different from NVR
369 constructed during build on builder.
370 fedpkg ci
373 usage: fedpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw]
374 [-t] [-F FILE] [-p] [-s]
375 [files ...]
376 Alias for commit.
378 positional arguments:
380 files Optional list of specific files to commit
381 options:
383 -h, --help show this help message and exit
384 -m MESSAGE, --message MESSAGE
385 Use the given <msg> as the commit message
386 summary
387 --with-changelog Get the last changelog from SPEC as commit
388 message content. This option must be used
389 with -m together.
390 -c, --clog Generate the commit message from the
391 Changelog section
392 --raw Make the clog raw
393 -t, --tag Create a tag for this commit
394 -F FILE, --file FILE Take the commit message from the given file
395 -p, --push Commit and push as one action
396 -s, --signoff Include a signed-off-by
397 fedpkg clean
400 usage: fedpkg clean [-h] [--dry-run] [-x]
401 This command can be used to clean up your working directory. By
403 default it will follow .gitignore rules. Patterns listed in
404 .git/info/exclude won'tbe removed either.
405 options:
407 -h, --help show this help message and exit
408 --dry-run, -n Perform a dry-run
409 -x Do not follow .gitignore and .git/info/exclude
410 rules
411 fedpkg clog
414 usage: fedpkg clog [-h] [--raw]
415 This will create a file named "clog" that contains the latest rpm
417 changelog entry. The leading "- " text will be stripped.
418 options:
420 -h, --help show this help message and exit
421 --raw Generate a more "raw" clog without twiddling the
422 contents
423 fedpkg clone
426 usage: fedpkg clone [-h] [--branches] [--branch BRANCH]
427 [--anonymous] [--depth DEPTH]
428 repo [clone_target] ...
429 This command will clone the named repository from the configured
431 repository base URL. By default it will also checkout the master
432 branch for your working copy.
433 positional arguments:
435 repo Name of the repository to clone. It should
436 not be a Git URL. Should be 'namespace/repo-
437 name' in case of namespaced dist-git.
438 Otherwise, just 'repo-name'. Namespace
439 examples are 'rpms', 'container', 'modules',
440 'flatpaks'. Default namespace 'rpms' can be
441 ignored.
442 clone_target Directory in which to clone the repository
443 extra_args Custom arguments that are passed to the 'git
444 clone'. Use '--' to separate them from other
445 arguments.
446 options:
448 -h, --help show this help message and exit
449 --branches, -B Do an old style checkout with subdirs for
450 branches
451 --branch BRANCH, -b BRANCH
452 Check out a specific branch
453 --anonymous, -a Check out a module anonymously
454 --depth DEPTH Create a shallow clone with a history
455 truncated to the specified number of commits
456 fedpkg co
459 usage: fedpkg co [-h] [--branches] [--branch BRANCH] [--anonymous]
460 [--depth DEPTH]
461 repo [clone_target] ...
462 Alias for clone.
464 positional arguments:
466 repo Name of the repository to clone. It should
467 not be a Git URL. Should be 'namespace/repo-
468 name' in case of namespaced dist-git.
469 Otherwise, just 'repo-name'. Namespace
470 examples are 'rpms', 'container', 'modules',
471 'flatpaks'. Default namespace 'rpms' can be
472 ignored.
473 clone_target Directory in which to clone the repository
474 extra_args Custom arguments that are passed to the 'git
475 clone'. Use '--' to separate them from other
476 arguments.
477 options:
479 -h, --help show this help message and exit
480 --branches, -B Do an old style checkout with subdirs for
481 branches
482 --branch BRANCH, -b BRANCH
483 Check out a specific branch
484 --anonymous, -a Check out a module anonymously
485 --depth DEPTH Create a shallow clone with a history
486 truncated to the specified number of commits
487 fedpkg commit
490 usage: fedpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c]
491 [--raw] [-t] [-F FILE] [-p] [-s]
492 [files ...]
493 This invokes a git commit. All tracked files with changes will be
495 committed unless a specific file list is provided. $EDITOR will be
496 used to generate a changelog message unless one is given to the
497 command. A push can be done at the same time.
498 positional arguments:
500 files Optional list of specific files to commit
501 options:
503 -h, --help show this help message and exit
504 -m MESSAGE, --message MESSAGE
505 Use the given <msg> as the commit message
506 summary
507 --with-changelog Get the last changelog from SPEC as commit
508 message content. This option must be used
509 with -m together.
510 -c, --clog Generate the commit message from the
511 Changelog section
512 --raw Make the clog raw
513 -t, --tag Create a tag for this commit
514 -F FILE, --file FILE Take the commit message from the given file
515 -p, --push Commit and push as one action
516 -s, --signoff Include a signed-off-by
517 fedpkg compile
520 usage: fedpkg compile [-h] [--builddir BUILDDIR]
521 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
522 [--define DEFINE] [--short-circuit]
523 [--nocheck]
524 ...
525 This command calls rpmbuild to compile the source. By default the
527 prep and configure stages will be done as well, unless the short-
528 circuit option is used.
529 positional arguments:
531 extra_args Custom arguments that are passed to the
532 'rpmbuild'. Use '--' to separate them from
533 other arguments.
534 options:
536 -h, --help show this help message and exit
537 --builddir BUILDDIR Define an alternate builddir
538 --buildrootdir BUILDROOTDIR
539 Define an alternate buildrootdir
540 --arch ARCH Prep for a specific arch
541 --define DEFINE Pass custom macros to rpmbuild, may specify
542 multiple times
543 --short-circuit short-circuit compile
544 --nocheck nocheck compile
545 fedpkg container-build
548 usage: fedpkg container-build [-h] [--target TARGET] [--nowait]
549 [--build-release BUILD_RELEASE]
550 [--isolated]
551 [--koji-parent-build KOJI_PARENT_BUILD]
552 [--scratch] [--arches [ARCHES ...]]
553 [--repo-url URL [URL ...]]
554 [--signing-intent SIGNING_INTENT]
555 [--skip-remote-rules-validation]
556 [--skip-build]
557 [--compose-id COMPOSE_ID [COMPOSE_ID
558 ...]]
559 [--replace-dependency PKG_MAN‐
560 AGER:NAME:VERSION[:NEW_NAME]
561 [PKG_MANAGER:NAME:VERSION[:NEW_NAME]
562 ...]]
563 Build a container
565 options:
567 -h, --help show this help message and exit
568 --target TARGET Override the default target
569 --nowait Don't wait on build
570 --build-release BUILD_RELEASE
571 Specify a release value for this build's NVR
572 --isolated Do not update floating tags in the registry.
573 You must use the --build-release argument
574 --koji-parent-build KOJI_PARENT_BUILD
575 Specify a Koji NVR for the parent container
576 image. This will override the "FROM" value
577 in your Dockerfile.
578 --scratch Scratch build
579 --arches [ARCHES ...]
580 Limit a scratch or a isolated build to an
581 arch. May have multiple arches.
582 --repo-url URL [URL ...]
583 URLs of yum repo files
584 --signing-intent SIGNING_INTENT
585 Signing intent of the ODCS composes. If
586 specified, this must be one of the signing
587 intent names configured on the OSBS server.
588 If unspecified, the server will use the
589 signing intent of the compose_ids you
590 specify, or the server's
591 default_signing_intent. To view the full
592 list of possible names, see REACTOR_CONFIG
593 in orchestrator.log.
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 options:
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 options:
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 options:
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 options:
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. If
686 specified, this must be one of the signing
687 intent names configured on the OSBS server.
688 If unspecified, the server will use the
689 signing intent of the compose_ids you
690 specify, or the server's
691 default_signing_intent. To view the full
692 list of possible names, see REACTOR_CONFIG
693 in orchestrator.log.
694 --skip-remote-rules-validation
695 Don't check if there's a valid gating.yaml
696 file in the repo
697 --skip-build Don't create build, but just modify settings
698 for autorebuilds
699 fedpkg fork
702 usage: fedpkg fork [-h]
703 Create a new fork of the current repository
705 Before the operation, you need to generate a pagure.io API token at:
707 https://src.fedoraproject.org/settings/token/new
708 ACL required:
710 "Fork a project"
711 Update your token with the following command:
713 fedpkg set-distgit-token <api_key_here>
714 Command saves token to fedpkg config file:
716 ~/.config/rpkg/fedpkg.conf
717 For example:
719 [fedpkg.distgit]
720 token = <api_key_here>
721 Below is a basic example of the command to fork a current repository:
723 fedpkg fork
725 Operation requires username (FAS_ID). by default, current logged
727 username is taken. It could be overridden by reusing an argument:
728 fedpkg --user FAS_ID fork
730 options:
732 -h, --help show this help message and exit
733 fedpkg gimmespec
736 usage: fedpkg gimmespec [-h]
737 Print the spec file name.
739 options:
741 -h, --help show this help message and exit
742 fedpkg gitbuildhash
745 usage: fedpkg gitbuildhash [-h] build
746 This will show you the commit hash string used to build the provided
748 build n-v-r
749 positional arguments:
751 build name-version-release of the build to query.
752 options:
754 -h, --help show this help message and exit
755 fedpkg giturl
758 usage: fedpkg giturl [-h]
759 This will show you which git URL would be used in a build command.
761 It uses the git hashsum of the HEAD of the current branch (which may
762 not be pushed).
763 options:
765 -h, --help show this help message and exit
766 fedpkg help
769 usage: fedpkg help [-h]
770 Show usage.
772 options:
774 -h, --help show this help message and exit
775 fedpkg import
778 usage: fedpkg import [-h] [--skip-diffs] [--offline] srpm
779 This will extract sources, patches, and the spec file from an srpm
781 and update the current module accordingly. It will import to the
782 current branch by default.
783 positional arguments:
785 srpm Source rpm to import
786 options:
788 -h, --help show this help message and exit
789 --skip-diffs Don't show diffs when import srpms
790 --offline Do not upload files into lookaside cache
791 fedpkg install
794 usage: fedpkg install [-h] [--builddir BUILDDIR]
795 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
796 [--define DEFINE] [--short-circuit]
797 [--nocheck]
798 ...
799 This will call rpmbuild to run the install section. All leading
801 sections will be processed as well, unless the short-circuit option
802 is used.
803 positional arguments:
805 extra_args Custom arguments that are passed to the
806 'rpmbuild'. Use '--' to separate them from
807 other arguments.
808 options:
810 -h, --help show this help message and exit
811 --builddir BUILDDIR Define an alternate builddir
812 --buildrootdir BUILDROOTDIR
813 Define an alternate buildrootdir
814 --arch ARCH Prep for a specific arch
815 --define DEFINE Pass custom macros to rpmbuild, may specify
816 multiple times
817 --short-circuit short-circuit install
818 --nocheck nocheck install
819 fedpkg lint
822 usage: fedpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
823 Rpmlint can be configured using the --rpmlintconf/-r option or by
825 setting a <pkgname>.rpmlintrc file in the working directory
826 options:
828 -h, --help show this help message and exit
829 --info, -i Display explanations for reported messages
830 --rpmlintconf RPMLINTCONF, -r RPMLINTCONF
831 Use a specific configuration file for
832 rpmlint
833 fedpkg list-side-tags
836 usage: fedpkg list-side-tags [-h]
837 [--mine | --user TAG_OWNER | --base-tag
838 BASE_TAG]
839 List existing side-tags.
841 options:
843 -h, --help show this help message and exit
844 --mine List only my side tags
845 --user TAG_OWNER List side tags created by this user
846 --base-tag BASE_TAG List only tags based on this base
847 fedpkg local
850 usage: fedpkg local [-h] [--builddir BUILDDIR]
851 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
852 [--define DEFINE] [--md5] [--with BCOND_WITH]
853 [--without BCOND_WITHOUT]
854 ...
855 Locally test run of rpmbuild producing binary RPMs. The rpmbuild
857 output will be logged into a file named
858 .build-%{version}-%{release}.log
859 positional arguments:
861 extra_args Custom arguments that are passed to the
862 'rpmbuild'. Use '--' to separate them from
863 other arguments.
864 options:
866 -h, --help show this help message and exit
867 --builddir BUILDDIR Define an alternate builddir
868 --buildrootdir BUILDROOTDIR
869 Define an alternate buildrootdir
870 --arch ARCH Prep for a specific arch
871 --define DEFINE Pass custom macros to rpmbuild, may specify
872 multiple times
873 --md5 Use md5 checksums (for older rpm hosts)
874 --with BCOND_WITH Enable configure option (bcond) for the
875 build
876 --without BCOND_WITHOUT
877 Disable configure option (bcond) for the
878 build
879 fedpkg mock-config
882 usage: fedpkg mock-config [-h] [--target TARGET] [--arch ARCH]
883 This will generate a mock config based on the buildsystem target
885 options:
887 -h, --help show this help message and exit
888 --target TARGET Override target used for config
889 --arch ARCH Override local arch
890 fedpkg mockbuild
893 usage: fedpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean]
894 [--no-cleanup-after] [--no-clean-all]
895 [--with BCOND_WITH]
896 [--without BCOND_WITHOUT] [--shell]
897 [--enablerepo ENABLEREPO]
898 [--disablerepo DISABLEREPO]
899 [--enable-network]
900 ...
901 This will use the mock utility to build the package for the
903 distribution detected from branch information. This can be
904 overridden using the global --release option. Your user must be in
905 the local "mock" group.
906 positional arguments:
908 extra_args Custom arguments that are passed to the
909 'mock'. Use '--' to separate them from other
910 arguments.
911 options:
913 -h, --help show this help message and exit
914 --root CONFIG, --mock-config CONFIG
915 Override mock configuration (like mock -r)
916 --md5 Use md5 checksums (for older rpm hosts)
917 --no-clean, -n Do not clean chroot before building package
918 --no-cleanup-after Do not clean chroot after building (if
919 automatic cleanup is enabled
920 --no-clean-all, -N Alias for both --no-clean and --no-cleanup-
921 after
922 --with BCOND_WITH Enable configure option (bcond) for the
923 build
924 --without BCOND_WITHOUT
925 Disable configure option (bcond) for the
926 build
927 --shell Run commands interactively within chroot.
928 Before going into chroot, mockbuild needs to
929 run with --no-cleanup-after in advanced.
930 --enablerepo ENABLEREPO
931 Pass enablerepo option to yum/dnf (may be
932 used more than once)
933 --disablerepo DISABLEREPO
934 Pass disablerepo option to yum/dnf (may be
935 used more than once)
936 --enable-network Enable networking
937 If config file for mock isn't found in the /etc/mock directory, a
939 temporary config directory for mock is created and populated with a
940 config file created with mock-config.
941 fedpkg module-build
944 usage: fedpkg module-build [-h] [--watch]
945 [--buildrequires name:stream]
946 [--requires name:stream]
947 [--optional key=value]
948 [--file [FILE_PATH]] [--srpm SRPMS]
949 [--scratch]
950 [scm_url] [branch]
951 Build a module using MBS
953 positional arguments:
955 scm_url The module's SCM URL. This defaults to the
956 current repo.
957 branch The module's SCM branch. This defaults to
958 the current checked-out branch.
959 options:
961 -h, --help show this help message and exit
962 --watch, -w Watch the module build
963 --buildrequires name:stream
964 Buildrequires to override in the form of
965 "name:stream"
966 --requires name:stream
967 Requires to override in the form of
968 "name:stream"
969 --optional key=value MBS optional arguments in the form of
970 "key=value". For example: 'fedpkg module-
971 build --optional
972 "reuse_components_from=<NSVC>"'. More
973 description including list of available
974 arguments here: https://pagure.io/fm-
975 orchestrator/
976 --file [FILE_PATH] The modulemd yaml file for module scratch
977 build.
978 --srpm SRPMS Include one or more srpms for module scratch
979 build.
980 --scratch Perform a scratch build
981 fedpkg module-build-cancel
984 usage: fedpkg module-build-cancel [-h] build_id
985 Cancel an MBS module build
987 positional arguments:
989 build_id The ID of the module build to cancel
990 options:
992 -h, --help show this help message and exit
993 fedpkg module-build-info
996 usage: fedpkg module-build-info [-h] build_id
997 Show information of an MBS module build
999 positional arguments:
1001 build_id The ID of the module build
1002 options:
1004 -h, --help show this help message and exit
1005 fedpkg module-build-local
1008 usage: fedpkg module-build-local [-h] [--file [FILE_PATH]]
1009 [--srpm SRPMS] [--stream [STREAM]]
1010 [--skip-tests]
1011 [--add-local-build N:S:V] [-s N:S]
1012 [--offline] [-r PATH]
1013 Build a module locally using the mbs-manager command
1015 options:
1017 -h, --help show this help message and exit
1018 --file [FILE_PATH] The module's modulemd yaml file. If not
1019 specified, a yaml file with the same
1020 basename as the name of the repository will
1021 be used.
1022 --srpm SRPMS Include one or more srpms for module build.
1023 --stream [STREAM] The module's stream/SCM branch. This
1024 defaults to the current checked-out branch.
1025 --skip-tests Adds a macro for skipping the check section
1026 --add-local-build N:S:V
1027 Import previously finished local module
1028 builds into MBS in the format of name:stream
1029 or name:stream:version
1030 -s N:S, --set-default-stream N:S
1031 Set the default stream for given module
1032 dependency in case there are multiple
1033 streams to choose from.
1034 --offline Builds module offline without any external
1035 infrastructure
1036 -r PATH, --repository PATH
1037 Full path to .repo file defining the base
1038 module repository to use when --offline is
1039 used.
1040 fedpkg module-build-watch
1043 usage: fedpkg module-build-watch [-h] build_id [build_id ...]
1044 Watch an MBS build
1046 positional arguments:
1048 build_id The ID of the module build to watch
1049 options:
1051 -h, --help show this help message and exit
1052 fedpkg module-overview
1055 usage: fedpkg module-overview [-h] [--unfinished] [--limit LIMIT]
1056 [--owner FAS_ID | --mine]
1057 Shows an overview of MBS builds
1059 options:
1061 -h, --help show this help message and exit
1062 --unfinished Show unfinished module builds
1063 --limit LIMIT The number of most recent module builds to display
1064 --owner FAS_ID List only items of that owner
1065 --mine Use current Kerberos name or username
1066 fedpkg module-scratch-build
1069 usage: fedpkg module-scratch-build [-h] [--watch]
1070 [--buildrequires name:stream]
1071 [--requires name:stream]
1072 [--optional key=value]
1073 [--file [FILE_PATH]]
1074 [--srpm SRPMS]
1075 [scm_url] [branch]
1076 Build a scratch module using MBS
1078 positional arguments:
1080 scm_url The module's SCM URL. This defaults to the
1081 current repo.
1082 branch The module's SCM branch. This defaults to
1083 the current checked-out branch.
1084 options:
1086 -h, --help show this help message and exit
1087 --watch, -w Watch the module build
1088 --buildrequires name:stream
1089 Buildrequires to override in the form of
1090 "name:stream"
1091 --requires name:stream
1092 Requires to override in the form of
1093 "name:stream"
1094 --optional key=value MBS optional arguments in the form of
1095 "key=value". For example: 'fedpkg module-
1096 build --optional
1097 "reuse_components_from=<NSVC>"'. More
1098 description including list of available
1099 arguments here: https://pagure.io/fm-
1100 orchestrator/
1101 --file [FILE_PATH] The modulemd yaml file for module scratch
1102 build.
1103 --srpm SRPMS Include one or more srpms for module scratch
1104 build.
1105 fedpkg new
1108 usage: fedpkg new [-h]
1109 This will use git to show a diff of all the changes (even
1111 uncommitted changes) since the last git tag was applied.
1112 options:
1114 -h, --help show this help message and exit
1115 fedpkg new-sources
1118 usage: fedpkg new-sources [-h] [--offline] files [files ...]
1119 This will upload new source file(s) to lookaside cache, and all file
1121 names listed in sources file will be replaced. .gitignore will be
1122 also updated with new uploaded file(s). Please remember to commit
1123 them.
1124 positional arguments:
1126 files
1127 options:
1129 -h, --help show this help message and exit
1130 --offline Do all the steps except uploading into lookaside cache
1131 fedpkg override
1134 usage: fedpkg override [-h] {create,extend} ...
1135 Manage buildroot overrides.
1137 options:
1139 -h, --help show this help message and exit
1140 subcommands:
1142 Commands on override
1143 {create,extend}
1145 create Create buildroot override from build
1146 extend Extend buildroot override expiration
1147 fedpkg patch
1150 usage: fedpkg patch [-h] [--rediff] suffix
1151 Create and add a gendiff patch file.
1153 positional arguments:
1155 suffix Look for files with this suffix to diff
1156 options:
1158 -h, --help show this help message and exit
1159 --rediff Recreate gendiff file retaining comments Saves old
1160 patch file with a suffix of ~
1161 Patch file will be named: package-version-suffix.patch and the file
1163 will be added to the repo index
1164 fedpkg prep
1167 usage: fedpkg prep [-h] [--builddir BUILDDIR]
1168 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1169 [--define DEFINE]
1170 ...
1171 Use rpmbuild to "prep" the sources (unpack the source archive(s) and
1173 apply any patches.)
1174 positional arguments:
1176 extra_args Custom arguments that are passed to the
1177 'rpmbuild'. Use '--' to separate them from
1178 other arguments.
1179 options:
1181 -h, --help show this help message and exit
1182 --builddir BUILDDIR Define an alternate builddir
1183 --buildrootdir BUILDROOTDIR
1184 Define an alternate buildrootdir
1185 --arch ARCH Prep for a specific arch
1186 --define DEFINE Pass custom macros to rpmbuild, may specify
1187 multiple times
1188 fedpkg pull
1191 usage: fedpkg pull [-h] [--rebase] [--no-rebase]
1192 This command uses git to fetch remote changes and apply them to the
1194 current working copy. A rebase option is available which can be used
1195 to avoid merges.
1196 options:
1198 -h, --help show this help message and exit
1199 --rebase Rebase the locally committed changes on top of the
1200 remote changes after fetching. This can avoid a merge
1201 commit, but does rewrite local history.
1202 --no-rebase Do not rebase, overriding .git settings to the
1203 contrary
1204 See git pull --help for more details
1206 fedpkg push
1209 usage: fedpkg push [-h] [--force]
1210 Push changes to remote repository.
1212 options:
1214 -h, --help show this help message and exit
1215 --force, -f Force push
1216 fedpkg releases-info
1219 usage: fedpkg releases-info [-h] [-e | -f | -j]
1220 Print Fedora or EPEL current active releases
1222 options:
1224 -h, --help show this help message and exit
1225 -e, --epel Only show EPEL releases.
1226 -f, --fedora Only show Fedora active releases.
1227 -j, --join Show all releases in one line separated by a space.
1228 fedpkg remote
1231 usage: fedpkg remote [-h] {add} ...
1232 Operations with tracked repositories ('remotes'). This is an
1234 experimental interface.
1235 options:
1237 -h, --help show this help message and exit
1238 subcommands:
1240 Operations with tracked repositories ('remotes'). This is an
1241 experimental interface. Please note that some or all current
1242 functionality is subject to change. Without parameters list of
1243 remotes will be shown.
1244 {add}
1246 fedpkg remove-side-tag
1249 usage: fedpkg remove-side-tag [-h] TAG
1250 Remove a side tag (without merging packages).
1252 positional arguments:
1254 TAG name of tag to be deleted
1255 options:
1257 -h, --help show this help message and exit
1258 fedpkg request-branch
1261 usage: fedpkg request-branch [-h] [--repo NAME]
1262 [--namespace {rpms,container,mod‐
1263 ules,flatpaks}]
1264 [--sl [SL ...]] [--no-git-branch]
1265 [--no-auto-module] [--all-releases]
1266 [branch]
1267 Request a new dist-git branch
1269 Please refer to the help of the request-repo command to see what has
1271 to be done before requesting a dist-git branch.
1272 Branch name could be one of current active Fedora and EPEL releases.
1274 Use
1275 command ``fedpkg releases-info`` to get release names that can be
1276 used to request
1277 a branch.
1278 Below are various examples of requesting a dist-git branch.
1280 Request a branch inside a cloned package repository:
1282 fedpkg request-branch f27
1284 Request a branch outside package repository, which could apply to
1286 cases of
1287 requested repository has not been approved and created, or just not
1288 change
1289 directory to package repository:
1290 fedpkg request-branch --repo foo f27
1292 Request a branch with service level tied to the branch. In this case
1294 branch
1295 argument has to be before --sl argument, because --sl allows multiple
1296 values.
1297 fedpkg request-branch branch_name --sl bug_fixes:2020-06-01
1299 rawhide:2019-12-01
1300 positional arguments:
1302 branch The branch to request.
1303 options:
1305 -h, --help show this help message and exit
1306 --repo NAME Repository name the new branch is requested
1307 for.
1308 --namespace {rpms,container,modules,flatpaks}
1309 Repository name the new branch is requested
1310 for.
1311 --sl [SL ...] The service levels (SLs) tied to the branch.
1312 This must be in the format of
1313 "sl_name:2020-12-01". This is only for non-
1314 release branches. You may provide more than
1315 one by separating each SL with a space. When
1316 the argument is used, branch argument has to
1317 be placed before --sl.
1318 --no-git-branch Don't create the branch in git but still
1319 create it in PDC
1320 --no-auto-module If requesting an rpm arbitrary branch, do
1321 not also request a new matching module. See
1322 https://pagure.io/fedrepo_req/issue/129
1323 --all-releases Make a new branch request for every active
1324 Fedora release
1325 fedpkg request-repo
1328 usage: fedpkg request-repo [-h]
1329 [--namespace {rpms,container,modules,flat‐
1330 paks}]
1331 [--description DESCRIPTION]
1332 [--monitor {no-monitoring,monitoring,moni‐
1333 toring-with-scratch}]
1334 [--upstreamurl UPSTREAMURL]
1335 [--summary SUMMARY] [--exception]
1336 [--no-initial-commit]
1337 name [bug]
1338 Request a new dist-git repository
1340 Before the operation, you need to generate a pagure.io API token at:
1342 https://pagure.io/settings/token/new
1343 ACL required:
1345 "Create a new ticket"
1346 Update your token with the following command:
1348 fedpkg set-pagure-token <api_key_here>
1349 Command saves token to fedpkg config file:
1351 ~/.config/rpkg/fedpkg.conf
1352 For example:
1354 [fedpkg.pagure]
1355 token = <api_key_here>
1356 Below is a basic example of the command to request a dist-git reposi‐
1358 tory for
1359 the package foo:
1360 fedpkg request-repo foo 1234
1362 Another example to request a module foo:
1364 fedpkg request-repo --namespace modules foo
1366 positional arguments:
1368 name Repository name to request.
1369 bug Bugzilla bug ID of the package review
1370 request. Not required for requesting a
1371 module repository
1372 options:
1374 -h, --help show this help message and exit
1375 --namespace {rpms,container,modules,flatpaks}
1376 Namespace of repository. If omitted, default
1377 to rpms.
1378 --description DESCRIPTION, -d DESCRIPTION
1379 The repo's description in dist-git
1380 --monitor {no-monitoring,monitoring,monitoring-with-scratch}, -m
1381 {no-monitoring,monitoring,monitoring-with-scratch}
1382 The Anitya monitoring type for the repo
1383 --upstreamurl UPSTREAMURL, -u UPSTREAMURL
1384 The upstream URL of the project
1385 --summary SUMMARY, -s SUMMARY
1386 Override the package's summary from the
1387 Bugzilla bug
1388 --exception The package is an exception to the regular
1389 package review process (specifically, it
1390 does not require a Bugzilla bug)
1391 --no-initial-commit Do not include an initial commit in the
1392 repository.
1393 fedpkg request-side-tag
1396 usage: fedpkg request-side-tag [-h] [--base-tag BASE_TAG]
1397 [--suffix SUFFIX]
1398 Create a new side tag.
1400 options:
1402 -h, --help show this help message and exit
1403 --base-tag BASE_TAG name of base tag
1404 --suffix SUFFIX A suffix to be appended to the side tag name.
1405 The suffix must be allowed in Koji
1406 configuration.
1407 fedpkg request-tests-repo
1410 usage: fedpkg request-tests-repo [-h] [--bug BUG] name description
1411 Request a new dist-git repository in tests shared namespace
1413 https://src.fedoraproject.org/projects/tests/*
1415 For more information about tests shared namespace see
1417 https://fedoraproject.org/wiki/CI/Share_Test_Code
1419 Please refer to the request-repo command to see what has to be done
1421 before
1422 requesting a repository in the tests namespace.
1423 Below is a basic example of the command to request a dist-git reposi‐
1425 tory for
1426 the space tests/foo:
1427 fedpkg request-tests-repo foo "Description of the repository"
1429 Note that the space name needs to reflect the intent of the tests and
1431 will
1432 undergo a manual review.
1433 positional arguments:
1435 name Repository name to request.
1436 description Description of the tests repository
1437 options:
1439 -h, --help show this help message and exit
1440 --bug BUG Bugzilla bug ID of the package review request.
1441 fedpkg retire
1444 usage: fedpkg retire [-h] reason
1445 This command will remove all files from the repo, leave a
1447 dead.package file for rpms or dead.module file for modules, and push
1448 the changes.
1449 positional arguments:
1451 reason Reason for retiring the package/module
1452 options:
1454 -h, --help show this help message and exit
1455 fedpkg scratch-build
1458 usage: fedpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5]
1459 [--nowait] [--target TARGET]
1460 [--background] [--fail-fast]
1461 [--skip-remote-rules-validation]
1462 [--skip-nvr-check] [--srpm [SRPM]]
1463 This command will request a scratch build of the package. Without
1465 providing an srpm, it will attempt to build the latest commit, which
1466 must have been pushed. By default all appropriate arches will be
1467 built.
1468 options:
1470 -h, --help show this help message and exit
1471 --arches [ARCHES ...]
1472 Build for specific arches
1473 --md5 Use md5 checksums (for older rpm hosts)
1474 --nowait Don't wait on build
1475 --target TARGET Define build target to build into
1476 --background Run the build at a low priority
1477 --fail-fast Fail the build immediately if any arch fails
1478 --skip-remote-rules-validation
1479 Don't check if there's a valid gating.yaml
1480 file in the repo, where you can define
1481 additional policies for Greenwave gating.
1482 --skip-nvr-check Submit build to buildsystem without check if
1483 NVR was already built. NVR is constructed
1484 locally and may be different from NVR
1485 constructed during build on builder.
1486 --srpm [SRPM] Build from an srpm. If no srpm is provided
1487 with this option an srpm will be generated
1488 from the current module content.
1489 fedpkg set-distgit-token
1492 usage: fedpkg set-distgit-token [-h] token
1493 Updates the fedpkg.distgit API token in ~/.config/rpkg/fedpkg.conf
1495 file. Tokens are of length 64 and contain only uppercase and
1496 numerical values.
1497 positional arguments:
1499 token The new API token. Can be generated at:
1500 https://src.fedoraproject.org/settings/token/new
1501 options:
1503 -h, --help show this help message and exit
1504 fedpkg set-pagure-token
1507 usage: fedpkg set-pagure-token [-h] token
1508 Updates the fedpkg.pagure API token in ~/.config/rpkg/fedpkg.conf
1510 file. Tokens are of length 64 and contain only uppercase and
1511 numerical values.
1512 positional arguments:
1514 token The new API token. Can be generated at:
1515 https://pagure.io/settings/token/new
1516 options:
1518 -h, --help show this help message and exit
1519 fedpkg sources
1522 usage: fedpkg sources [-h] [--outdir OUTDIR]
1523 Download source files
1525 options:
1527 -h, --help show this help message and exit
1528 --outdir OUTDIR Directory to download files into (defaults to
1529 pwd)
1530 fedpkg srpm
1533 usage: fedpkg srpm [-h] [--builddir BUILDDIR]
1534 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1535 [--define DEFINE] [--md5]
1536 ...
1537 Create a source rpm
1539 positional arguments:
1541 extra_args Custom arguments that are passed to the
1542 'rpmbuild'. Use '--' to separate them from
1543 other arguments.
1544 options:
1546 -h, --help show this help message and exit
1547 --builddir BUILDDIR Define an alternate builddir
1548 --buildrootdir BUILDROOTDIR
1549 Define an alternate buildrootdir
1550 --arch ARCH Prep for a specific arch
1551 --define DEFINE Pass custom macros to rpmbuild, may specify
1552 multiple times
1553 --md5 Use md5 checksums (for older rpm hosts)
1554 fedpkg switch-branch
1557 usage: fedpkg switch-branch [-h] [-l] [--fetch] [branch]
1558 This command can switch to a local git branch. If provided with a
1560 remote branch name that does not have a local match it will create
1561 one. It can also be used to list the existing local and remote
1562 branches.
1563 positional arguments:
1565 branch Branch name to switch to
1566 options:
1568 -h, --help show this help message and exit
1569 -l, --list List both remote-tracking branches and local branches
1570 --fetch Fetch new data from remote before switch
1571 fedpkg tag
1574 usage: fedpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l]
1575 [-d]
1576 [tag]
1577 This command uses git to create, list, or delete tags.
1579 positional arguments:
1581 tag Name of the tag
1582 options:
1584 -h, --help show this help message and exit
1585 -f, --force Force the creation of the tag
1586 -m MESSAGE, --message MESSAGE
1587 Use the given <msg> as the tag message
1588 -c, --clog Generate the tag message from the spec
1589 changelog section
1590 --raw Make the clog raw
1591 -F FILE, --file FILE Take the tag message from the given file
1592 -l, --list List all tags with a given pattern, or all
1593 if not pattern is given
1594 -d, --delete Delete a tag
1595 fedpkg unused-patches
1598 usage: fedpkg unused-patches [-h]
1599 Print list of patches not referenced by name in the specfile.
1601 options:
1603 -h, --help show this help message and exit
1604 fedpkg update
1607 usage: fedpkg update [-h]
1608 [--type {bugfix,security,enhancement,newpack‐
1609 age}]
1610 [--request {testing,stable}]
1611 [--bugs BUGS [BUGS ...]] [--notes NOTES]
1612 [--disable-autokarma] [--stable-karma KARMA]
1613 [--unstable-karma KARMA] [--not-close-bugs]
1614 [--suggest-reboot] [--no-require-bugs]
1615 [--no-require-testcases]
1616 This will create a bodhi update request for the current package n-v-
1618 r.
1619 There are two ways to specify update details. Without any argument
1621 from command
1622 line, either update type or notes is omitted, a template editor will
1623 be shown
1624 and let you edit the detail information interactively.
1625 Alternatively, you could specify argument from command line to create
1627 an update
1628 directly, for example:
1629 fedpkg update --type bugfix --notes 'Rebuilt' --bugs 1000 1002
1631 When all lines in template editor are commented out or deleted, the
1633 creation
1634 process is aborted. If the template keeps unchanged, fedpkg continues
1635 on creating
1636 update. That gives user a chance to confirm the auto-generated notes
1637 from
1638 change log if option --notes is omitted.
1639 options:
1641 -h, --help show this help message and exit
1642 --type {bugfix,security,enhancement,newpackage}
1643 Update type. Template editor will be shown
1644 if type is omitted.
1645 --request {testing,stable}
1646 Requested repository.
1647 --bugs BUGS [BUGS ...]
1648 Bug numbers. If omitted, bug numbers will be
1649 extracted from change logs.
1650 --notes NOTES Update description. Multiple lines of notes
1651 could be specified. If omitted, template
1652 editor will be shown.
1653 --disable-autokarma Karma automatism is enabled by default. Use
1654 this option to disable that.
1655 --stable-karma KARMA Stable karma. Default is 3.
1656 --unstable-karma KARMA
1657 Unstable karma. Default is -3.
1658 --not-close-bugs By default, update will be created by
1659 enabling to close bugs automatically. If
1660 this is what you do not want, use this
1661 option to disable the default behavior.
1662 --suggest-reboot Suggest user to reboot after update. Default
1663 is False.
1664 --no-require-bugs Disables the requirement that all of the
1665 bugs in your update have been confirmed by
1666 testers. Default is True.
1667 --no-require-testcases
1668 Disables the requirement that this update
1669 passes all test cases before reaching
1670 stable. Default is True.
1671 fedpkg upload
1674 usage: fedpkg upload [-h] [--offline] files [files ...]
1675 This command will upload new source file(s) to lookaside cache.
1677 Source file names are appended to sources file, and .gitignore will
1678 be also updated with new uploaded file(s). Please remember to commit
1679 them.
1680 positional arguments:
1682 files
1683 options:
1685 -h, --help show this help message and exit
1686 --offline Do all the steps except uploading into lookaside cache
1687 fedpkg verify-files
1690 usage: fedpkg verify-files [-h] [--builddir BUILDDIR]
1691 [--buildrootdir BUILDROOTDIR]
1692 [--arch ARCH] [--define DEFINE]
1693 ...
1694 Locally run 'rpmbuild -bl' to verify the spec file's %files
1696 sections. This requires a successful run of 'fedpkg install' in
1697 advance.
1698 positional arguments:
1700 extra_args Custom arguments that are passed to the
1701 'rpmbuild'. Use '--' to separate them from
1702 other arguments.
1703 options:
1705 -h, --help show this help message and exit
1706 --builddir BUILDDIR Define an alternate builddir
1707 --buildrootdir BUILDROOTDIR
1708 Define an alternate buildrootdir
1709 --arch ARCH Prep for a specific arch
1710 --define DEFINE Pass custom macros to rpmbuild, may specify
1711 multiple times
1712 fedpkg verrel
1715 usage: fedpkg verrel [-h]
1716 Print the name-version-release.
1718 options:
1720 -h, --help show this help message and exit
1721
1724 https://pagure.io/fedpkg/
1725 2021-11-10 fedpkg(1)