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] [--custom-user-metadata CUSTOM_USER_METADATA]
22 [--skip-tag] [--scratch] [--srpm [SRPM]] [--srpm-mock]
23 Request build
24 fedpkg chain-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
26 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
27 validation] [--skip-nvr-check] [--custom-user-metadata CUS‐
28 TOM_USER_METADATA] package [package ...]
29 Build current package in order with other packages
30 fedpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t] [-F
32 FILE] [-p] [-s] [files ...]
33 Alias for commit
34 fedpkg clean [-h] [--dry-run] [-x]
36 Remove untracked files
37 fedpkg clog [-h] [--raw]
39 Make a clog file containing top changelog entry
40 fedpkg clone [-h] [--branches] [--branch BRANCH] [--anonymous] [--depth
42 DEPTH] repo [clone_target] ...
43 Clone and checkout a repository
44 fedpkg co [-h] [--branches] [--branch BRANCH] [--anonymous] [--depth
46 DEPTH] repo [clone_target] ...
47 Alias for clone
48 fedpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t]
50 [-F FILE] [-p] [-s] [files ...]
51 Commit changes
52 fedpkg compile [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
54 [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
55 Local test rpmbuild compile
56 fedpkg container-build [-h] [--target TARGET] [--nowait] [--build-re‐
58 lease BUILD_RELEASE] [--isolated] [--koji-parent-build KOJI_PAR‐
59 ENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--repo-url URL [URL
60 ...]] [--signing-intent SIGNING_INTENT] [--skip-remote-rules-valida‐
61 tion] [--skip-build] [--compose-id COMPOSE_ID [COMPOSE_ID ...]] [--re‐
62 place-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MAN‐
63 AGER:NAME:VERSION[:NEW_NAME] ...]]
64 Build a container
65 fedpkg container-build-setup [-h] (--get-autorebuild | --set-autore‐
67 build {true,false})
68 set options for container-build
69 fedpkg copr-build [-h] [--config CONFIG] [--nowait] project
71 Build package in Copr
72 fedpkg diff [-h] [--cached] [files ...]
74 Show changes between commits, commit and working tree, etc
75 fedpkg flatpak-build [-h] [--target TARGET] [--nowait] [--build-release
77 BUILD_RELEASE] [--isolated] [--koji-parent-build KOJI_PARENT_BUILD]
78 [--scratch] [--arches [ARCHES ...]] [--repo-url URL [URL ...]] [--sign‐
79 ing-intent SIGNING_INTENT] [--skip-remote-rules-validation] [--skip-
80 build]
81 Build a Flatpak
82 fedpkg fork [-h]
84 Create a new fork of the current repository
85 fedpkg gimmespec [-h]
87 Print the spec file name
88 fedpkg gitbuildhash [-h] build
90 Print the git hash used to build the provided n-v-r
91 fedpkg giturl [-h]
93 Print the git url for building
94 fedpkg help [-h]
96 Show usage
97 fedpkg import [-h] [--skip-diffs] [--offline] srpm
99 Import srpm content into a module
100 fedpkg install [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
102 [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
103 Local test rpmbuild install
104 fedpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
106 Run rpmlint against local spec and build output if present.
107 fedpkg list-side-tags [-h] [--mine | --user TAG_OWNER | --base-tag
109 BASE_TAG]
110 List existing side-tags
111 fedpkg local [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
113 [--arch ARCH] [--define DEFINE] [--md5] [--with BCOND_WITH] [--without
114 BCOND_WITHOUT] ...
115 Local test rpmbuild binary
116 fedpkg mock-config [-h] [--target TARGET] [--arch ARCH]
118 Generate a mock config
119 fedpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean] [--no-
121 cleanup-after] [--no-clean-all] [--with BCOND_WITH] [--without
122 BCOND_WITHOUT] [--shell] [--enablerepo ENABLEREPO] [--disablerepo DIS‐
123 ABLEREPO] [--enable-network] [--srpm-mock] [--use-koji-mock-config |
124 --use-local-mock-config] ...
125 Local test build using mock
126 fedpkg module-build [-h] [--watch] [--buildrequires name:stream] [--re‐
128 quires name:stream] [--optional key=value] [--file [FILE_PATH]] [--srpm
129 SRPMS] [--scratch] [scm_url] [branch]
130 Build a module using MBS
131 fedpkg module-build-cancel [-h] build_id
133 Cancel an MBS module build
134 fedpkg module-build-info [-h] build_id
136 Show information of an MBS module build
137 fedpkg module-build-local [-h] [--file [FILE_PATH]] [--srpm SRPMS]
139 [--stream [STREAM]] [--skip-tests] [--add-local-build N:S:V] [-s N:S]
140 [--offline] [-r PATH]
141 Build a module locally using the mbs-manager command
142 fedpkg module-build-watch [-h] build_id [build_id ...]
144 Watch an MBS build
145 fedpkg module-overview [-h] [--unfinished] [--limit LIMIT] [--owner
147 FAS_ID | --mine]
148 Shows an overview of MBS builds
149 fedpkg module-scratch-build [-h] [--watch] [--buildrequires
151 name:stream] [--requires name:stream] [--optional key=value] [--file
152 [FILE_PATH]] [--srpm SRPMS] [scm_url] [branch]
153 Build a scratch module using MBS
154 fedpkg new [-h]
156 Diff against last tag
157 fedpkg new-sources [-h] [--offline] files [files ...]
159 Upload source files
160 fedpkg override [-h] {create,extend} ...
162 Manage buildroot overrides
163 fedpkg patch [-h] [--rediff] suffix
165 Create and add a gendiff patch file
166 fedpkg prep [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
168 [--arch ARCH] [--define DEFINE] ...
169 Local test rpmbuild prep
170 fedpkg pull [-h] [--rebase] [--no-rebase]
172 Pull changes from the remote repository and update the working
173 copy.
174 fedpkg push [-h] [--force]
176 Push changes to remote repository
177 fedpkg releases-info [-h] [-e | -f | -j]
179 Print Fedora or EPEL current active releases
180 fedpkg remote [-h] {add} ...
182 Operations with tracked repositories ('remotes'). This is an ex‐
183 perimental interface.
184 fedpkg remove-side-tag [-h] TAG
186 Remove a side tag (without merging packages)
187 fedpkg request-branch [-h] [--repo NAME] [--namespace {rpms,con‐
189 tainer,modules,flatpaks}] [--sl [SL ...]] [--no-git-branch] [--no-auto-
190 module] [--all-releases] [branch]
191 Request a new dist-git branch
192 fedpkg request-repo [-h] [--namespace {rpms,container,modules,flat‐
194 paks}] [--description DESCRIPTION] [--monitor {no-monitoring,monitor‐
195 ing,monitoring-with-scratch}] [--upstreamurl UPSTREAMURL] [--summary
196 SUMMARY] [--exception] [--no-initial-commit] name [bug]
197 Request a new dist-git repository
198 fedpkg request-side-tag [-h] [--base-tag BASE_TAG] [--suffix SUFFIX]
200 Create a new side tag
201 fedpkg request-tests-repo [-h] [--bug BUG] name description
203 Request a new tests dist-git repository
204 fedpkg retire [-h] reason
206 Retire a package/module
207 fedpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
209 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
210 validation] [--skip-nvr-check] [--custom-user-metadata CUS‐
211 TOM_USER_METADATA] [--srpm [SRPM]] [--srpm-mock]
212 Request scratch build
213 fedpkg set-distgit-token [-h] token
215 Updates the fedpkg.distgit API token in ~/.con‐
216 fig/rpkg/fedpkg.conf file.
217 Tokens are of length 64 and contain only uppercase
219 and numerical values.
220 fedpkg set-pagure-token [-h] token
222 Updates the fedpkg.pagure API token in ~/.con‐
223 fig/rpkg/fedpkg.conf file.
224 Tokens are of length 64 and contain only uppercase
226 and numerical values.
227 fedpkg sources [-h] [--outdir OUTDIR]
229 Download source files
230 Create a source rpm
232 Create a source rpm
233 fedpkg switch-branch [-h] [-l] [--fetch] [branch]
235 Work with branches
236 fedpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l] [-d]
238 [tag]
239 Management of git tags
240 fedpkg unused-patches [-h]
242 Print list of patches not referenced by name in the specfile
243 fedpkg update [-h] [--type {bugfix,security,enhancement,newpackage}]
245 [--request {testing,stable}] [--bugs BUGS [BUGS ...]] [--notes NOTES]
246 [--disable-autokarma] [--stable-karma KARMA] [--unstable-karma KARMA]
247 [--not-close-bugs] [--no-require-bugs] [--no-require-testcases] [--sug‐
248 gest-reboot | --suggest-logout]
249 Submit last build as update
250 fedpkg upload [-h] [--offline] files [files ...]
252 Upload source files
253 fedpkg verify-files [-h] [--builddir BUILDDIR] [--buildrootdir BUILD‐
255 ROOTDIR] [--arch ARCH] [--define DEFINE] ...
256 Locally verify %%files section
257 fedpkg verrel [-h]
259 Print the name-version-release.
260
262 fedpkg build
263 usage: fedpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
264 [--target TARGET] [--background] [--fail-fast]
265 [--skip-remote-rules-validation]
266 [--skip-nvr-check]
267 [--custom-user-metadata CUSTOM_USER_METADATA]
268 [--skip-tag] [--scratch] [--srpm [SRPM]]
269 [--srpm-mock]
270 This command requests a build of the package in the build
272 system. By
273 default it discovers the target to build for based on branch data,
274 and
275 uses the latest commit as the build source.
276 fedpkg is also able to submit multiple builds to Koji at
278 once from stream
279 branch based on a local config, which is inside the
280 repository. The config file
281 is named package.cfg in INI format. For example,
282 [koji]
284 targets = rawhide fedora epel7
285 You only need to put Fedora releases and EPEL in option
287 targets and fedpkg will
288 convert it to proper Koji build target for submitting
289 builds. Beside regular
290 release names, option targets accepts two shortcut names
291 as well, fedora and
292 epel, as you can see in the above example. Name fedora
293 stands for current
294 active Fedora releases, and epel stands for the active
295 EPEL releases, which are
296 el6 and epel7 currently.
297 Note that the config file is a branch specific file. That
299 means you could
300 create package.cfg for each stream branch separately to
301 indicate on which
302 targets to build the package for a particular stream.
303 options:
305 -h, --help show this help message and exit
306 --arches [ARCHES ...]
307 Build for specific arches
308 --md5 Use md5 checksums (for older rpm hosts)
309 --nowait Don't wait on build
310 --target TARGET Define build target to build into
311 --background Run the build at a low priority
312 --fail-fast Fail the build immediately if any arch fails
313 --skip-remote-rules-validation
314 Don't check if there's a valid gating.yaml
315 file in the repo, where you can define
316 additional policies for Greenwave gating.
317 --skip-nvr-check Submit build to buildsystem without check if
318 NVR was already built. NVR is constructed
319 locally and may be different from NVR
320 constructed during build on builder.
321 --custom-user-metadata CUSTOM_USER_METADATA
322 Provide a JSON string of custom metadata to
323 be deserialized and stored under the build's
324 extra.custom_user_metadata field
325 --skip-tag Do not attempt to tag package
326 --scratch Perform a scratch build
327 --srpm [SRPM] Build from an srpm. If no srpm is provided
328 with this option an srpm will be generated
329 from current module content.
330 --srpm-mock Build from an srpm. Source rpm will be
331 generated in 'mock' instead of 'rpmbuild'.
332 fedpkg chain-build
335 usage: fedpkg chain-build [-h] [--arches [ARCHES ...]] [--md5]
336 [--nowait] [--target TARGET]
337 [--background] [--fail-fast]
338 [--skip-remote-rules-validation]
339 [--skip-nvr-check]
340 [--custom-user-metadata CUSTOM_USER_META‐
341 DATA]
342 package [package ...]
343 Build current package in order with other packages.
345 example: fedpkg chain-build libwidget libgizmo
347 The current package is added to the end of the CHAIN list.
349 Colons (:) can be used in the CHAIN parameter to define groups of
350 packages. Packages in any single group will be built in parallel
351 and all packages in a group must build successfully and populate
352 the repository before the next group will begin building.
353 For example:
355 fedpkg chain-build libwidget libaselib : libgizmo :
357 will cause libwidget and libaselib to be built in parallel, followed
359 by libgizmo and then the current directory package. If no groups are
360 defined, packages will be built sequentially.
361 positional arguments:
363 package List the packages and order you want to
364 build in
365 options:
367 -h, --help show this help message and exit
368 --arches [ARCHES ...]
369 Build for specific arches
370 --md5 Use md5 checksums (for older rpm hosts)
371 --nowait Don't wait on build
372 --target TARGET Define build target to build into
373 --background Run the build at a low priority
374 --fail-fast Fail the build immediately if any arch fails
375 --skip-remote-rules-validation
376 Don't check if there's a valid gating.yaml
377 file in the repo, where you can define
378 additional policies for Greenwave gating.
379 --skip-nvr-check Submit build to buildsystem without check if
380 NVR was already built. NVR is constructed
381 locally and may be different from NVR
382 constructed during build on builder.
383 --custom-user-metadata CUSTOM_USER_METADATA
384 Provide a JSON string of custom metadata to
385 be deserialized and stored under the build's
386 extra.custom_user_metadata field
387 fedpkg ci
390 usage: fedpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw]
391 [-t] [-F FILE] [-p] [-s]
392 [files ...]
393 Alias for commit.
395 positional arguments:
397 files Optional list of specific files to commit
398 options:
400 -h, --help show this help message and exit
401 -m MESSAGE, --message MESSAGE
402 Use the given <msg> as the commit message
403 summary
404 --with-changelog Get the last changelog from SPEC as commit
405 message content. This option must be used
406 with -m together.
407 -c, --clog Generate the commit message from the
408 Changelog section
409 --raw Make the clog raw
410 -t, --tag Create a tag for this commit
411 -F FILE, --file FILE Take the commit message from the given file
412 -p, --push Commit and push as one action
413 -s, --signoff Include a signed-off-by
414 fedpkg clean
417 usage: fedpkg clean [-h] [--dry-run] [-x]
418 This command can be used to clean up your working directory. By
420 default it will follow .gitignore rules. Patterns listed in
421 .git/info/exclude won'tbe removed either.
422 options:
424 -h, --help show this help message and exit
425 --dry-run, -n Perform a dry-run
426 -x Do not follow .gitignore and .git/info/exclude
427 rules
428 fedpkg clog
431 usage: fedpkg clog [-h] [--raw]
432 This will create a file named "clog" that contains the latest rpm
434 changelog entry. The leading "- " text will be stripped.
435 options:
437 -h, --help show this help message and exit
438 --raw Generate a more "raw" clog without twiddling the
439 contents
440 fedpkg clone
443 usage: fedpkg clone [-h] [--branches] [--branch BRANCH]
444 [--anonymous] [--depth DEPTH]
445 repo [clone_target] ...
446 This command will clone the named repository from the configured
448 repository base URL. By default it will also checkout the master
449 branch for your working copy.
450 positional arguments:
452 repo Name of the repository to clone. It should
453 not be a Git URL. Should be 'namespace/repo-
454 name' in case of namespaced dist-git.
455 Otherwise, just 'repo-name'. Namespace
456 examples are 'rpms', 'container', 'modules',
457 'flatpaks'. Default namespace 'rpms' can be
458 ignored.
459 clone_target Directory in which to clone the repository
460 extra_args Custom arguments that are passed to the 'git
461 clone'. Use '--' to separate them from other
462 arguments.
463 options:
465 -h, --help show this help message and exit
466 --branches, -B Do an old style checkout with subdirs for
467 branches
468 --branch BRANCH, -b BRANCH
469 Check out a specific branch
470 --anonymous, -a Check out a module anonymously
471 --depth DEPTH Create a shallow clone with a history
472 truncated to the specified number of commits
473 fedpkg co
476 usage: fedpkg co [-h] [--branches] [--branch BRANCH] [--anonymous]
477 [--depth DEPTH]
478 repo [clone_target] ...
479 Alias for clone.
481 positional arguments:
483 repo Name of the repository to clone. It should
484 not be a Git URL. Should be 'namespace/repo-
485 name' in case of namespaced dist-git.
486 Otherwise, just 'repo-name'. Namespace
487 examples are 'rpms', 'container', 'modules',
488 'flatpaks'. Default namespace 'rpms' can be
489 ignored.
490 clone_target Directory in which to clone the repository
491 extra_args Custom arguments that are passed to the 'git
492 clone'. Use '--' to separate them from other
493 arguments.
494 options:
496 -h, --help show this help message and exit
497 --branches, -B Do an old style checkout with subdirs for
498 branches
499 --branch BRANCH, -b BRANCH
500 Check out a specific branch
501 --anonymous, -a Check out a module anonymously
502 --depth DEPTH Create a shallow clone with a history
503 truncated to the specified number of commits
504 fedpkg commit
507 usage: fedpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c]
508 [--raw] [-t] [-F FILE] [-p] [-s]
509 [files ...]
510 This invokes a git commit. All tracked files with changes will be
512 committed unless a specific file list is provided. $EDITOR will be
513 used to generate a changelog message unless one is given to the
514 command. A push can be done at the same time.
515 positional arguments:
517 files Optional list of specific files to commit
518 options:
520 -h, --help show this help message and exit
521 -m MESSAGE, --message MESSAGE
522 Use the given <msg> as the commit message
523 summary
524 --with-changelog Get the last changelog from SPEC as commit
525 message content. This option must be used
526 with -m together.
527 -c, --clog Generate the commit message from the
528 Changelog section
529 --raw Make the clog raw
530 -t, --tag Create a tag for this commit
531 -F FILE, --file FILE Take the commit message from the given file
532 -p, --push Commit and push as one action
533 -s, --signoff Include a signed-off-by
534 fedpkg compile
537 usage: fedpkg compile [-h] [--builddir BUILDDIR]
538 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
539 [--define DEFINE] [--short-circuit]
540 [--nocheck]
541 ...
542 This command calls rpmbuild to compile the source. By default the
544 prep and configure stages will be done as well, unless the short-
545 circuit option is used.
546 positional arguments:
548 extra_args Custom arguments that are passed to the
549 'rpmbuild'. Use '--' to separate them from
550 other arguments.
551 options:
553 -h, --help show this help message and exit
554 --builddir BUILDDIR Define an alternate builddir
555 --buildrootdir BUILDROOTDIR
556 Define an alternate buildrootdir
557 --arch ARCH Prep for a specific arch
558 --define DEFINE Pass custom macros to rpmbuild, may specify
559 multiple times
560 --short-circuit short-circuit compile
561 --nocheck nocheck compile
562 fedpkg container-build
565 usage: fedpkg container-build [-h] [--target TARGET] [--nowait]
566 [--build-release BUILD_RELEASE]
567 [--isolated]
568 [--koji-parent-build KOJI_PARENT_BUILD]
569 [--scratch] [--arches [ARCHES ...]]
570 [--repo-url URL [URL ...]]
571 [--signing-intent SIGNING_INTENT]
572 [--skip-remote-rules-validation]
573 [--skip-build]
574 [--compose-id COMPOSE_ID [COMPOSE_ID
575 ...]]
576 [--replace-dependency PKG_MAN‐
577 AGER:NAME:VERSION[:NEW_NAME]
578 [PKG_MANAGER:NAME:VERSION[:NEW_NAME]
579 ...]]
580 Build a container
582 options:
584 -h, --help show this help message and exit
585 --target TARGET Override the default target
586 --nowait Don't wait on build
587 --build-release BUILD_RELEASE
588 Specify a release value for this build's NVR
589 --isolated Do not update floating tags in the registry.
590 You must use the --build-release argument
591 --koji-parent-build KOJI_PARENT_BUILD
592 Specify a Koji NVR for the parent container
593 image. This will override the "FROM" value
594 in your Dockerfile.
595 --scratch Scratch build
596 --arches [ARCHES ...]
597 Limit a scratch or a isolated build to an
598 arch. May have multiple arches.
599 --repo-url URL [URL ...]
600 URLs of yum repo files
601 --signing-intent SIGNING_INTENT
602 Signing intent of the ODCS composes. If
603 specified, this must be one of the signing
604 intent names configured on the OSBS server.
605 If unspecified, the server will use the
606 signing intent of the compose_ids you
607 specify, or the server's
608 default_signing_intent. To view the full
609 list of possible names, see REACTOR_CONFIG
610 in orchestrator.log.
611 --skip-remote-rules-validation
612 Don't check if there's a valid gating.yaml
613 file in the repo
614 --skip-build Don't create build, but just modify settings
615 for autorebuilds
616 --compose-id COMPOSE_ID [COMPOSE_ID ...]
617 ODCS composes used. Cannot be used with
618 --signing-intent
619 --replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MAN‐
620 AGER:NAME:VERSION[:NEW_NAME] ...]
621 Cachito dependency replacement
622 fedpkg container-build-setup
625 usage: fedpkg container-build-setup [-h]
626 (--get-autorebuild | --set-au‐
627 torebuild {true,false})
628 set options for container-build.
630 options:
632 -h, --help show this help message and exit
633 --get-autorebuild Get autorebuild value
634 --set-autorebuild {true,false}
635 Turn autorebuilds on/off
636 fedpkg copr-build
639 usage: fedpkg copr-build [-h] [--config CONFIG] [--nowait] project
640 Build package in Copr.
642 Note: you need to have set up correct api key. For more information
644 see API KEY section of copr-cli(1) man page.
645 positional arguments:
647 project Name of the project in format USER/PROJECT
648 options:
650 -h, --help show this help message and exit
651 --config CONFIG Path to an alternative Copr configuration file
652 --nowait Don't wait on build
653 fedpkg diff
656 usage: fedpkg diff [-h] [--cached] [files ...]
657 Use git diff to show changes that have been made to tracked files.
659 By default cached changes (changes that have been git added) will
660 not be shown.
661 positional arguments:
663 files Optionally diff specific files
664 options:
666 -h, --help show this help message and exit
667 --cached View staged changes
668 fedpkg flatpak-build
671 usage: fedpkg flatpak-build [-h] [--target TARGET] [--nowait]
672 [--build-release BUILD_RELEASE]
673 [--isolated]
674 [--koji-parent-build KOJI_PARENT_BUILD]
675 [--scratch] [--arches [ARCHES ...]]
676 [--repo-url URL [URL ...]]
677 [--signing-intent SIGNING_INTENT]
678 [--skip-remote-rules-validation]
679 [--skip-build]
680 Build a Flatpak
682 options:
684 -h, --help show this help message and exit
685 --target TARGET Override the default target
686 --nowait Don't wait on build
687 --build-release BUILD_RELEASE
688 Specify a release value for this build's NVR
689 --isolated Do not update floating tags in the registry.
690 You must use the --build-release argument
691 --koji-parent-build KOJI_PARENT_BUILD
692 Specify a Koji NVR for the parent container
693 image. This will override the "FROM" value
694 in your Dockerfile.
695 --scratch Scratch build
696 --arches [ARCHES ...]
697 Limit a scratch or a isolated build to an
698 arch. May have multiple arches.
699 --repo-url URL [URL ...]
700 URLs of yum repo files
701 --signing-intent SIGNING_INTENT
702 Signing intent of the ODCS composes. If
703 specified, this must be one of the signing
704 intent names configured on the OSBS server.
705 If unspecified, the server will use the
706 signing intent of the compose_ids you
707 specify, or the server's
708 default_signing_intent. To view the full
709 list of possible names, see REACTOR_CONFIG
710 in orchestrator.log.
711 --skip-remote-rules-validation
712 Don't check if there's a valid gating.yaml
713 file in the repo
714 --skip-build Don't create build, but just modify settings
715 for autorebuilds
716 fedpkg fork
719 usage: fedpkg fork [-h]
720 Create a new fork of the current repository
722 Before the operation, you need to generate a pagure.io API token at:
724 https://src.fedoraproject.org/settings/token/new
725 ACL required:
727 "Fork a project"
728 Update your token with the following command:
730 fedpkg set-distgit-token <api_key_here>
731 Command saves token to fedpkg config file:
733 ~/.config/rpkg/fedpkg.conf
734 For example:
736 [fedpkg.distgit]
737 token = <api_key_here>
738 Below is a basic example of the command to fork a current repository:
740 fedpkg fork
742 Operation requires username (FAS_ID). by default, current logged
744 username is taken. It could be overridden by reusing an argument:
745 fedpkg --user FAS_ID fork
747 options:
749 -h, --help show this help message and exit
750 fedpkg gimmespec
753 usage: fedpkg gimmespec [-h]
754 Print the spec file name.
756 options:
758 -h, --help show this help message and exit
759 fedpkg gitbuildhash
762 usage: fedpkg gitbuildhash [-h] build
763 This will show you the commit hash string used to build the provided
765 build n-v-r
766 positional arguments:
768 build name-version-release of the build to query.
769 options:
771 -h, --help show this help message and exit
772 fedpkg giturl
775 usage: fedpkg giturl [-h]
776 This will show you which git URL would be used in a build command.
778 It uses the git hashsum of the HEAD of the current branch (which may
779 not be pushed).
780 options:
782 -h, --help show this help message and exit
783 fedpkg help
786 usage: fedpkg help [-h]
787 Show usage.
789 options:
791 -h, --help show this help message and exit
792 fedpkg import
795 usage: fedpkg import [-h] [--skip-diffs] [--offline] srpm
796 This will extract sources, patches, and the spec file from an srpm
798 and update the current module accordingly. It will import to the
799 current branch by default.
800 positional arguments:
802 srpm Source rpm to import
803 options:
805 -h, --help show this help message and exit
806 --skip-diffs Don't show diffs when import srpms
807 --offline Do not upload files into lookaside cache
808 fedpkg install
811 usage: fedpkg install [-h] [--builddir BUILDDIR]
812 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
813 [--define DEFINE] [--short-circuit]
814 [--nocheck]
815 ...
816 This will call rpmbuild to run the install section. All leading
818 sections will be processed as well, unless the short-circuit option
819 is used.
820 positional arguments:
822 extra_args Custom arguments that are passed to the
823 'rpmbuild'. Use '--' to separate them from
824 other arguments.
825 options:
827 -h, --help show this help message and exit
828 --builddir BUILDDIR Define an alternate builddir
829 --buildrootdir BUILDROOTDIR
830 Define an alternate buildrootdir
831 --arch ARCH Prep for a specific arch
832 --define DEFINE Pass custom macros to rpmbuild, may specify
833 multiple times
834 --short-circuit short-circuit install
835 --nocheck nocheck install
836 fedpkg lint
839 usage: fedpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
840 Rpmlint can be configured using the --rpmlintconf/-r option or by
842 setting a <pkgname>.rpmlintrc file in the working directory
843 options:
845 -h, --help show this help message and exit
846 --info, -i Display explanations for reported messages
847 --rpmlintconf RPMLINTCONF, -r RPMLINTCONF
848 Use a specific configuration file for
849 rpmlint
850 fedpkg list-side-tags
853 usage: fedpkg list-side-tags [-h]
854 [--mine | --user TAG_OWNER | --base-tag
855 BASE_TAG]
856 List existing side-tags.
858 options:
860 -h, --help show this help message and exit
861 --mine List only my side tags
862 --user TAG_OWNER List side tags created by this user
863 --base-tag BASE_TAG List only tags based on this base
864 fedpkg local
867 usage: fedpkg local [-h] [--builddir BUILDDIR]
868 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
869 [--define DEFINE] [--md5] [--with BCOND_WITH]
870 [--without BCOND_WITHOUT]
871 ...
872 Locally test run of rpmbuild producing binary RPMs. The rpmbuild
874 output will be logged into a file named
875 .build-%{version}-%{release}.log
876 positional arguments:
878 extra_args Custom arguments that are passed to the
879 'rpmbuild'. Use '--' to separate them from
880 other arguments.
881 options:
883 -h, --help show this help message and exit
884 --builddir BUILDDIR Define an alternate builddir
885 --buildrootdir BUILDROOTDIR
886 Define an alternate buildrootdir
887 --arch ARCH Prep for a specific arch
888 --define DEFINE Pass custom macros to rpmbuild, may specify
889 multiple times
890 --md5 Use md5 checksums (for older rpm hosts)
891 --with BCOND_WITH Enable configure option (bcond) for the
892 build
893 --without BCOND_WITHOUT
894 Disable configure option (bcond) for the
895 build
896 fedpkg mock-config
899 usage: fedpkg mock-config [-h] [--target TARGET] [--arch ARCH]
900 This will generate a mock config based on the buildsystem target
902 options:
904 -h, --help show this help message and exit
905 --target TARGET Override target used for config
906 --arch ARCH Override local arch
907 fedpkg mockbuild
910 usage: fedpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean]
911 [--no-cleanup-after] [--no-clean-all]
912 [--with BCOND_WITH]
913 [--without BCOND_WITHOUT] [--shell]
914 [--enablerepo ENABLEREPO]
915 [--disablerepo DISABLEREPO]
916 [--enable-network] [--srpm-mock]
917 [--use-koji-mock-config | --use-local-mock-
918 config]
919 ...
920 This will use the mock utility to build the package for the
922 distribution detected from branch information. This can be
923 overridden using the global --release option. Your user must be in
924 the local "mock" group.
925 positional arguments:
927 extra_args Custom arguments that are passed to the
928 'mock'. Use '--' to separate them from other
929 arguments.
930 options:
932 -h, --help show this help message and exit
933 --root CONFIG, --mock-config CONFIG
934 Override mock configuration (like mock -r)
935 --md5 Use md5 checksums (for older rpm hosts)
936 --no-clean, -n Do not clean chroot before building package
937 --no-cleanup-after Do not clean chroot after building (if
938 automatic cleanup is enabled
939 --no-clean-all, -N Alias for both --no-clean and --no-cleanup-
940 after
941 --with BCOND_WITH Enable configure option (bcond) for the
942 build
943 --without BCOND_WITHOUT
944 Disable configure option (bcond) for the
945 build
946 --shell Run commands interactively within chroot.
947 Before going into chroot, mockbuild needs to
948 run with --no-cleanup-after in advanced.
949 --enablerepo ENABLEREPO
950 Pass enablerepo option to yum/dnf (may be
951 used more than once)
952 --disablerepo DISABLEREPO
953 Pass disablerepo option to yum/dnf (may be
954 used more than once)
955 --enable-network Enable networking
956 --srpm-mock Generate source rpm with 'mock' and then run
957 'mockbuild' using this source rpm
958 --use-koji-mock-config
959 Download Mock configuration from Kojihub,
960 instead of using the local Mock
961 configuration in mock-core-configs.rpm.
962 --use-local-mock-config
963 Enforce use of local Mock configuration.
964 If config file for mock isn't found in the /etc/mock directory, a
966 temporary config directory for mock is created and populated with a
967 config file created with mock-config.
968 fedpkg module-build
971 usage: fedpkg module-build [-h] [--watch]
972 [--buildrequires name:stream]
973 [--requires name:stream]
974 [--optional key=value]
975 [--file [FILE_PATH]] [--srpm SRPMS]
976 [--scratch]
977 [scm_url] [branch]
978 Build a module using MBS
980 positional arguments:
982 scm_url The module's SCM URL. This defaults to the
983 current repo.
984 branch The module's SCM branch. This defaults to
985 the current checked-out branch.
986 options:
988 -h, --help show this help message and exit
989 --watch, -w Watch the module build
990 --buildrequires name:stream
991 Buildrequires to override in the form of
992 "name:stream"
993 --requires name:stream
994 Requires to override in the form of
995 "name:stream"
996 --optional key=value MBS optional arguments in the form of
997 "key=value". For example: 'fedpkg module-
998 build --optional
999 "reuse_components_from=<NSVC>"'. More
1000 description including list of available
1001 arguments here: https://pagure.io/fm-
1002 orchestrator/
1003 --file [FILE_PATH] The modulemd yaml file for module scratch
1004 build.
1005 --srpm SRPMS Include one or more srpms for module scratch
1006 build.
1007 --scratch Perform a scratch build
1008 fedpkg module-build-cancel
1011 usage: fedpkg module-build-cancel [-h] build_id
1012 Cancel an MBS module build
1014 positional arguments:
1016 build_id The ID of the module build to cancel
1017 options:
1019 -h, --help show this help message and exit
1020 fedpkg module-build-info
1023 usage: fedpkg module-build-info [-h] build_id
1024 Show information of an MBS module build
1026 positional arguments:
1028 build_id The ID of the module build
1029 options:
1031 -h, --help show this help message and exit
1032 fedpkg module-build-local
1035 usage: fedpkg module-build-local [-h] [--file [FILE_PATH]]
1036 [--srpm SRPMS] [--stream [STREAM]]
1037 [--skip-tests]
1038 [--add-local-build N:S:V] [-s N:S]
1039 [--offline] [-r PATH]
1040 Build a module locally using the mbs-manager command
1042 options:
1044 -h, --help show this help message and exit
1045 --file [FILE_PATH] The module's modulemd yaml file. If not
1046 specified, a yaml file with the same
1047 basename as the name of the repository will
1048 be used.
1049 --srpm SRPMS Include one or more srpms for module build.
1050 --stream [STREAM] The module's stream/SCM branch. This
1051 defaults to the current checked-out branch.
1052 --skip-tests Adds a macro for skipping the check section
1053 --add-local-build N:S:V
1054 Import previously finished local module
1055 builds into MBS in the format of name:stream
1056 or name:stream:version
1057 -s N:S, --set-default-stream N:S
1058 Set the default stream for given module
1059 dependency in case there are multiple
1060 streams to choose from.
1061 --offline Builds module offline without any external
1062 infrastructure
1063 -r PATH, --repository PATH
1064 Full path to .repo file defining the base
1065 module repository to use when --offline is
1066 used.
1067 fedpkg module-build-watch
1070 usage: fedpkg module-build-watch [-h] build_id [build_id ...]
1071 Watch an MBS build
1073 positional arguments:
1075 build_id The ID of the module build to watch
1076 options:
1078 -h, --help show this help message and exit
1079 fedpkg module-overview
1082 usage: fedpkg module-overview [-h] [--unfinished] [--limit LIMIT]
1083 [--owner FAS_ID | --mine]
1084 Shows an overview of MBS builds
1086 options:
1088 -h, --help show this help message and exit
1089 --unfinished Show unfinished module builds
1090 --limit LIMIT The number of most recent module builds to display
1091 --owner FAS_ID List only items of that owner
1092 --mine Use current Kerberos name or username
1093 fedpkg module-scratch-build
1096 usage: fedpkg module-scratch-build [-h] [--watch]
1097 [--buildrequires name:stream]
1098 [--requires name:stream]
1099 [--optional key=value]
1100 [--file [FILE_PATH]]
1101 [--srpm SRPMS]
1102 [scm_url] [branch]
1103 Build a scratch module using MBS
1105 positional arguments:
1107 scm_url The module's SCM URL. This defaults to the
1108 current repo.
1109 branch The module's SCM branch. This defaults to
1110 the current checked-out branch.
1111 options:
1113 -h, --help show this help message and exit
1114 --watch, -w Watch the module build
1115 --buildrequires name:stream
1116 Buildrequires to override in the form of
1117 "name:stream"
1118 --requires name:stream
1119 Requires to override in the form of
1120 "name:stream"
1121 --optional key=value MBS optional arguments in the form of
1122 "key=value". For example: 'fedpkg module-
1123 build --optional
1124 "reuse_components_from=<NSVC>"'. More
1125 description including list of available
1126 arguments here: https://pagure.io/fm-
1127 orchestrator/
1128 --file [FILE_PATH] The modulemd yaml file for module scratch
1129 build.
1130 --srpm SRPMS Include one or more srpms for module scratch
1131 build.
1132 fedpkg new
1135 usage: fedpkg new [-h]
1136 This will use git to show a diff of all the changes (even
1138 uncommitted changes) since the last git tag was applied.
1139 options:
1141 -h, --help show this help message and exit
1142 fedpkg new-sources
1145 usage: fedpkg new-sources [-h] [--offline] files [files ...]
1146 This will upload new source file(s) to lookaside cache, and all file
1148 names listed in sources file will be replaced. .gitignore will be
1149 also updated with new uploaded file(s). Please remember to commit
1150 them.
1151 positional arguments:
1153 files
1154 options:
1156 -h, --help show this help message and exit
1157 --offline Do all the steps except uploading into lookaside cache
1158 fedpkg override
1161 usage: fedpkg override [-h] {create,extend} ...
1162 Manage buildroot overrides.
1164 options:
1166 -h, --help show this help message and exit
1167 subcommands:
1169 Commands on override
1170 {create,extend}
1172 create Create buildroot override from build
1173 extend Extend buildroot override expiration
1174 fedpkg patch
1177 usage: fedpkg patch [-h] [--rediff] suffix
1178 Create and add a gendiff patch file.
1180 positional arguments:
1182 suffix Look for files with this suffix to diff
1183 options:
1185 -h, --help show this help message and exit
1186 --rediff Recreate gendiff file retaining comments Saves old
1187 patch file with a suffix of ~
1188 Patch file will be named: package-version-suffix.patch and the file
1190 will be added to the repo index
1191 fedpkg prep
1194 usage: fedpkg prep [-h] [--builddir BUILDDIR]
1195 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1196 [--define DEFINE]
1197 ...
1198 Use rpmbuild to "prep" the sources (unpack the source archive(s) and
1200 apply any patches.)
1201 positional arguments:
1203 extra_args Custom arguments that are passed to the
1204 'rpmbuild'. Use '--' to separate them from
1205 other arguments.
1206 options:
1208 -h, --help show this help message and exit
1209 --builddir BUILDDIR Define an alternate builddir
1210 --buildrootdir BUILDROOTDIR
1211 Define an alternate buildrootdir
1212 --arch ARCH Prep for a specific arch
1213 --define DEFINE Pass custom macros to rpmbuild, may specify
1214 multiple times
1215 fedpkg pull
1218 usage: fedpkg pull [-h] [--rebase] [--no-rebase]
1219 This command uses git to fetch remote changes and apply them to the
1221 current working copy. A rebase option is available which can be used
1222 to avoid merges.
1223 options:
1225 -h, --help show this help message and exit
1226 --rebase Rebase the locally committed changes on top of the
1227 remote changes after fetching. This can avoid a merge
1228 commit, but does rewrite local history.
1229 --no-rebase Do not rebase, overriding .git settings to the
1230 contrary
1231 See git pull --help for more details
1233 fedpkg push
1236 usage: fedpkg push [-h] [--force]
1237 Push changes to remote repository.
1239 options:
1241 -h, --help show this help message and exit
1242 --force, -f Force push
1243 fedpkg releases-info
1246 usage: fedpkg releases-info [-h] [-e | -f | -j]
1247 Print Fedora or EPEL current active releases
1249 options:
1251 -h, --help show this help message and exit
1252 -e, --epel Only show EPEL releases.
1253 -f, --fedora Only show Fedora active releases.
1254 -j, --join Show all releases in one line separated by a space.
1255 fedpkg remote
1258 usage: fedpkg remote [-h] {add} ...
1259 Operations with tracked repositories ('remotes'). This is an
1261 experimental interface.
1262 options:
1264 -h, --help show this help message and exit
1265 subcommands:
1267 Operations with tracked repositories ('remotes'). This is an
1268 experimental interface. Please note that some or all current
1269 functionality is subject to change. Without parameters list of
1270 remotes will be shown.
1271 {add}
1273 fedpkg remove-side-tag
1276 usage: fedpkg remove-side-tag [-h] TAG
1277 Remove a side tag (without merging packages).
1279 positional arguments:
1281 TAG name of tag to be deleted
1282 options:
1284 -h, --help show this help message and exit
1285 fedpkg request-branch
1288 usage: fedpkg request-branch [-h] [--repo NAME]
1289 [--namespace {rpms,container,mod‐
1290 ules,flatpaks}]
1291 [--sl [SL ...]] [--no-git-branch]
1292 [--no-auto-module] [--all-releases]
1293 [branch]
1294 Request a new dist-git branch
1296 Please refer to the help of the request-repo command to see what has
1298 to be done before requesting a dist-git branch.
1299 Branch name could be one of current active Fedora and EPEL releases.
1301 Use
1302 command ``fedpkg releases-info`` to get release names that can be
1303 used to request
1304 a branch.
1305 Below are various examples of requesting a dist-git branch.
1307 Request a branch inside a cloned package repository:
1309 fedpkg request-branch f27
1311 Request a branch outside package repository, which could apply to
1313 cases of
1314 requested repository has not been approved and created, or just not
1315 change
1316 directory to package repository:
1317 fedpkg request-branch --repo foo f27
1319 Request a branch with service level tied to the branch. In this case
1321 branch
1322 argument has to be before --sl argument, because --sl allows multiple
1323 values.
1324 fedpkg request-branch branch_name --sl bug_fixes:2020-06-01
1326 rawhide:2019-12-01
1327 positional arguments:
1329 branch The branch to request.
1330 options:
1332 -h, --help show this help message and exit
1333 --repo NAME Repository name the new branch is requested
1334 for.
1335 --namespace {rpms,container,modules,flatpaks}
1336 Repository name the new branch is requested
1337 for.
1338 --sl [SL ...] The service levels (SLs) tied to the branch.
1339 This must be in the format of
1340 "sl_name:2020-12-01". This is only for non-
1341 release branches. You may provide more than
1342 one by separating each SL with a space. When
1343 the argument is used, branch argument has to
1344 be placed before --sl.
1345 --no-git-branch Don't create the branch in git but still
1346 create it in PDC
1347 --no-auto-module If requesting an rpm arbitrary branch, do
1348 not also request a new matching module. See
1349 https://pagure.io/fedrepo_req/issue/129
1350 --all-releases Make a new branch request for every active
1351 Fedora release
1352 fedpkg request-repo
1355 usage: fedpkg request-repo [-h]
1356 [--namespace {rpms,container,modules,flat‐
1357 paks}]
1358 [--description DESCRIPTION]
1359 [--monitor {no-monitoring,monitoring,moni‐
1360 toring-with-scratch}]
1361 [--upstreamurl UPSTREAMURL]
1362 [--summary SUMMARY] [--exception]
1363 [--no-initial-commit]
1364 name [bug]
1365 Request a new dist-git repository
1367 Before the operation, you need to generate a pagure.io API token at:
1369 https://pagure.io/settings/token/new
1370 ACL required:
1372 "Create a new ticket"
1373 Update your token with the following command:
1375 fedpkg set-pagure-token <api_key_here>
1376 Command saves token to fedpkg config file:
1378 ~/.config/rpkg/fedpkg.conf
1379 For example:
1381 [fedpkg.pagure]
1382 token = <api_key_here>
1383 Below is a basic example of the command to request a dist-git reposi‐
1385 tory for
1386 the package foo:
1387 fedpkg request-repo foo 1234
1389 Another example to request a module foo:
1391 fedpkg request-repo --namespace modules foo
1393 positional arguments:
1395 name Repository name to request.
1396 bug Bugzilla bug ID of the package review
1397 request. Not required for requesting a
1398 module repository
1399 options:
1401 -h, --help show this help message and exit
1402 --namespace {rpms,container,modules,flatpaks}
1403 Namespace of repository. If omitted, default
1404 to rpms.
1405 --description DESCRIPTION, -d DESCRIPTION
1406 The repo's description in dist-git
1407 --monitor {no-monitoring,monitoring,monitoring-with-scratch}, -m
1408 {no-monitoring,monitoring,monitoring-with-scratch}
1409 The Anitya monitoring type for the repo
1410 --upstreamurl UPSTREAMURL, -u UPSTREAMURL
1411 The upstream URL of the project
1412 --summary SUMMARY, -s SUMMARY
1413 Override the package's summary from the
1414 Bugzilla bug
1415 --exception The package is an exception to the regular
1416 package review process (specifically, it
1417 does not require a Bugzilla bug)
1418 --no-initial-commit Do not include an initial commit in the
1419 repository.
1420 fedpkg request-side-tag
1423 usage: fedpkg request-side-tag [-h] [--base-tag BASE_TAG]
1424 [--suffix SUFFIX]
1425 Create a new side tag.
1427 options:
1429 -h, --help show this help message and exit
1430 --base-tag BASE_TAG name of base tag
1431 --suffix SUFFIX A suffix to be appended to the side tag name.
1432 The suffix must be allowed in Koji
1433 configuration.
1434 fedpkg request-tests-repo
1437 usage: fedpkg request-tests-repo [-h] [--bug BUG] name description
1438 Request a new dist-git repository in tests shared namespace
1440 https://src.fedoraproject.org/projects/tests/*
1442 For more information about tests shared namespace see
1444 https://fedoraproject.org/wiki/CI/Share_Test_Code
1446 Please refer to the request-repo command to see what has to be done
1448 before
1449 requesting a repository in the tests namespace.
1450 Below is a basic example of the command to request a dist-git reposi‐
1452 tory for
1453 the space tests/foo:
1454 fedpkg request-tests-repo foo "Description of the repository"
1456 Note that the space name needs to reflect the intent of the tests and
1458 will
1459 undergo a manual review.
1460 positional arguments:
1462 name Repository name to request.
1463 description Description of the tests repository
1464 options:
1466 -h, --help show this help message and exit
1467 --bug BUG Bugzilla bug ID of the package review request.
1468 fedpkg retire
1471 usage: fedpkg retire [-h] reason
1472 This command will remove all files from the repo, leave a
1474 dead.package file for rpms or dead.module file for modules, and push
1475 the changes.
1476 positional arguments:
1478 reason Reason for retiring the package/module
1479 options:
1481 -h, --help show this help message and exit
1482 fedpkg scratch-build
1485 usage: fedpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5]
1486 [--nowait] [--target TARGET]
1487 [--background] [--fail-fast]
1488 [--skip-remote-rules-validation]
1489 [--skip-nvr-check]
1490 [--custom-user-metadata CUSTOM_USER_META‐
1491 DATA]
1492 [--srpm [SRPM]] [--srpm-mock]
1493 This command will request a scratch build of the package. Without
1495 providing an srpm, it will attempt to build the latest commit, which
1496 must have been pushed. By default all appropriate arches will be
1497 built.
1498 options:
1500 -h, --help show this help message and exit
1501 --arches [ARCHES ...]
1502 Build for specific arches
1503 --md5 Use md5 checksums (for older rpm hosts)
1504 --nowait Don't wait on build
1505 --target TARGET Define build target to build into
1506 --background Run the build at a low priority
1507 --fail-fast Fail the build immediately if any arch fails
1508 --skip-remote-rules-validation
1509 Don't check if there's a valid gating.yaml
1510 file in the repo, where you can define
1511 additional policies for Greenwave gating.
1512 --skip-nvr-check Submit build to buildsystem without check if
1513 NVR was already built. NVR is constructed
1514 locally and may be different from NVR
1515 constructed during build on builder.
1516 --custom-user-metadata CUSTOM_USER_METADATA
1517 Provide a JSON string of custom metadata to
1518 be deserialized and stored under the build's
1519 extra.custom_user_metadata field
1520 --srpm [SRPM] Build from an srpm. If no srpm is provided
1521 with this option an srpm will be generated
1522 from the current module content.
1523 --srpm-mock Build from an srpm. Source rpm will be
1524 generated in 'mock' instead of 'rpmbuild'.
1525 fedpkg set-distgit-token
1528 usage: fedpkg set-distgit-token [-h] token
1529 Updates the fedpkg.distgit API token in ~/.config/rpkg/fedpkg.conf
1531 file. Tokens are of length 64 and contain only uppercase and
1532 numerical values.
1533 positional arguments:
1535 token The new API token. Can be generated at:
1536 https://src.fedoraproject.org/settings/token/new
1537 options:
1539 -h, --help show this help message and exit
1540 fedpkg set-pagure-token
1543 usage: fedpkg set-pagure-token [-h] token
1544 Updates the fedpkg.pagure API token in ~/.config/rpkg/fedpkg.conf
1546 file. Tokens are of length 64 and contain only uppercase and
1547 numerical values.
1548 positional arguments:
1550 token The new API token. Can be generated at:
1551 https://pagure.io/settings/token/new
1552 options:
1554 -h, --help show this help message and exit
1555 fedpkg sources
1558 usage: fedpkg sources [-h] [--outdir OUTDIR]
1559 Download source files
1561 options:
1563 -h, --help show this help message and exit
1564 --outdir OUTDIR Directory to download files into (defaults to
1565 pwd)
1566 fedpkg srpm
1569 usage: Create a source rpm
1570 This command wraps "rpmbuild -bs", roughly equivalent to:
1572 rpmbuild -bs mypackage.spec --define "_topdir ." --de‐
1574 fine "_sourcedir ." --define "_srcrpmdir ." --define "dist
1575 .el8"
1576 To include files in the SRPM, the files must be in the current
1578 working directory (this depends on the package layout used),
1579 and you must reference each file with SourceXXXX: or PatchXXXX:
1580 directives in your .spec file.
1581 positional arguments:
1583 extra_args Custom arguments that are passed to the
1584 'rpmbuild'. Use '--' to separate them from
1585 other arguments.
1586 options:
1588 -h, --help show this help message and exit
1589 --builddir BUILDDIR Define an alternate builddir
1590 --buildrootdir BUILDROOTDIR
1591 Define an alternate buildrootdir
1592 --arch ARCH Prep for a specific arch
1593 --define DEFINE Pass custom macros to rpmbuild, may specify
1594 multiple times
1595 --md5 Use md5 checksums (for older rpm hosts)
1596 --srpm-mock Create source rpm in 'mock' instead of
1597 'rpmbuild'
1598 --no-clean, -n Only for --srpm-mock: Do not clean chroot
1599 before building package
1600 --no-cleanup-after Only for --srpm-mock: Do not clean chroot
1601 after building if automatic cleanup is
1602 enabled
1603 --no-clean-all, -N Only for --srpm-mock: Alias for both --no-
1604 clean and --no-cleanup-after
1605 fedpkg switch-branch
1608 usage: fedpkg switch-branch [-h] [-l] [--fetch] [branch]
1609 This command can switch to a local git branch. If provided with a
1611 remote branch name that does not have a local match it will create
1612 one. It can also be used to list the existing local and remote
1613 branches.
1614 positional arguments:
1616 branch Branch name to switch to
1617 options:
1619 -h, --help show this help message and exit
1620 -l, --list List both remote-tracking branches and local branches
1621 --fetch Fetch new data from remote before switch
1622 fedpkg tag
1625 usage: fedpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l]
1626 [-d]
1627 [tag]
1628 This command uses git to create, list, or delete tags.
1630 positional arguments:
1632 tag Name of the tag
1633 options:
1635 -h, --help show this help message and exit
1636 -f, --force Force the creation of the tag
1637 -m MESSAGE, --message MESSAGE
1638 Use the given <msg> as the tag message
1639 -c, --clog Generate the tag message from the spec
1640 changelog section
1641 --raw Make the clog raw
1642 -F FILE, --file FILE Take the tag message from the given file
1643 -l, --list List all tags with a given pattern, or all
1644 if not pattern is given
1645 -d, --delete Delete a tag
1646 fedpkg unused-patches
1649 usage: fedpkg unused-patches [-h]
1650 Print list of patches not referenced by name in the specfile.
1652 options:
1654 -h, --help show this help message and exit
1655 fedpkg update
1658 usage: fedpkg update [-h]
1659 [--type {bugfix,security,enhancement,newpack‐
1660 age}]
1661 [--request {testing,stable}]
1662 [--bugs BUGS [BUGS ...]] [--notes NOTES]
1663 [--disable-autokarma] [--stable-karma KARMA]
1664 [--unstable-karma KARMA] [--not-close-bugs]
1665 [--no-require-bugs] [--no-require-testcases]
1666 [--suggest-reboot | --suggest-logout]
1667 This will create a bodhi update request for the current package n-v-
1669 r.
1670 There are two ways to specify update details. Without any argument
1672 from command
1673 line, either update type or notes is omitted, a template editor will
1674 be shown
1675 and let you edit the detail information interactively.
1676 Alternatively, you could specify argument from command line to create
1678 an update
1679 directly, for example:
1680 fedpkg update --type bugfix --notes 'Rebuilt' --bugs 1000 1002
1682 When all lines in template editor are commented out or deleted, the
1684 creation
1685 process is aborted. If the template keeps unchanged, fedpkg continues
1686 on creating
1687 update. That gives user a chance to confirm the auto-generated notes
1688 from
1689 change log if option --notes is omitted.
1690 options:
1692 -h, --help show this help message and exit
1693 --type {bugfix,security,enhancement,newpackage}
1694 Update type. Template editor will be shown
1695 if type is omitted.
1696 --request {testing,stable}
1697 Requested repository.
1698 --bugs BUGS [BUGS ...]
1699 Bug numbers. If omitted, bug numbers will be
1700 extracted from change logs.
1701 --notes NOTES Update description. Multiple lines of notes
1702 could be specified. If omitted, template
1703 editor will be shown.
1704 --disable-autokarma Karma automatism is enabled by default. Use
1705 this option to disable that.
1706 --stable-karma KARMA Stable karma. Default is 3.
1707 --unstable-karma KARMA
1708 Unstable karma. Default is -3.
1709 --not-close-bugs By default, update will be created by
1710 enabling to close bugs automatically. If
1711 this is what you do not want, use this
1712 option to disable the default behavior.
1713 --no-require-bugs Disables the requirement that all of the
1714 bugs in your update have been confirmed by
1715 testers. Default is True.
1716 --no-require-testcases
1717 Disables the requirement that this update
1718 passes all test cases before reaching
1719 stable. Default is True.
1720 --suggest-reboot Suggest user to reboot after update. Default
1721 is False.
1722 --suggest-logout Suggest user to logout after update. Default
1723 is False.
1724 fedpkg upload
1727 usage: fedpkg upload [-h] [--offline] files [files ...]
1728 This command will upload new source file(s) to lookaside cache.
1730 Source file names are appended to sources file, and .gitignore will
1731 be also updated with new uploaded file(s). Please remember to commit
1732 them.
1733 positional arguments:
1735 files
1736 options:
1738 -h, --help show this help message and exit
1739 --offline Do all the steps except uploading into lookaside cache
1740 fedpkg verify-files
1743 usage: fedpkg verify-files [-h] [--builddir BUILDDIR]
1744 [--buildrootdir BUILDROOTDIR]
1745 [--arch ARCH] [--define DEFINE]
1746 ...
1747 Locally run 'rpmbuild -bl' to verify the spec file's %files
1749 sections. This requires a successful run of 'fedpkg install' in
1750 advance.
1751 positional arguments:
1753 extra_args Custom arguments that are passed to the
1754 'rpmbuild'. Use '--' to separate them from
1755 other arguments.
1756 options:
1758 -h, --help show this help message and exit
1759 --builddir BUILDDIR Define an alternate builddir
1760 --buildrootdir BUILDROOTDIR
1761 Define an alternate buildrootdir
1762 --arch ARCH Prep for a specific arch
1763 --define DEFINE Pass custom macros to rpmbuild, may specify
1764 multiple times
1765 fedpkg verrel
1768 usage: fedpkg verrel [-h]
1769 Print the name-version-release.
1771 options:
1773 -h, --help show this help message and exit
1774
1777 https://pagure.io/fedpkg/
1778 2022-05-23 fedpkg(1)