1fedpkg(1) rpm-packager fedpkg(1)
2
6 fedpkg - RPM Packaging utility
7
9 fedpkg [ global_options ] command [ command_options ] [ command_argu‐
10 ments ]
11 fedpkg help
12 fedpkg command --help
13
15 fedpkg is a script to interact with the RPM Packaging system.
16 Global Options
18 --config CONFIG, -C CONFIG
19 Specify a config file to use
20 --dry-run Perform a dry run.
21 --release RELEASE Override the discovered release, e.g. f25,
22 which has to match the remote branch name
23 created in package repository. Particularly,
24 use rawhide/main branch to build RPMs for
25 rawhide.
26 --name NAME Override repository name. Use --namespace
27 option to change namespace. If not
28 specified, name is discovered from Git push
29 URL or Git URL (last part of path with .git
30 extension removed) or from Name macro in
31 spec file, in that order.
32 --namespace NAMESPACE
33 The package repository namespace. If
34 omitted, default to rpms if namespace is
35 enabled.
36 --user USER Override the discovered user name
37 --password PASSWORD Password for Koji login
38 --runas RUNAS Run Koji commands as a different user
39 --path PATH Define the directory to work in (defaults to
40 cwd)
41 --verbose, -v Run with verbose debug output
42 --debug, -d Run with debug output
43 -q Run quietly only displaying errors
44 --user-config USER_CONFIG
45 Specify a user config file to use
46
48 fedpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait] [--target
49 TARGET] [--background] [--fail-fast] [--skip-remote-rules-validation]
50 [--skip-nvr-check] [--custom-user-metadata CUSTOM_USER_METADATA]
51 [--skip-tag] [--scratch] [--srpm [SRPM]] [--srpm-mock]
52 Request build
53 fedpkg chain-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
55 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
56 validation] [--skip-nvr-check] [--custom-user-metadata CUS‐
57 TOM_USER_METADATA] package [package ...]
58 Build current package in order with other packages
59 fedpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t] [-F
61 FILE] [-p] [-s] [files ...]
62 Alias for commit
63 fedpkg clean [-h] [--dry-run] [-x]
65 Remove untracked files
66 fedpkg clog [-h] [--raw]
68 Make a clog file containing top changelog entry
69 fedpkg clone [-h] [--branches] [--branch BRANCH] [--anonymous] [--depth
71 DEPTH] repo [clone_target] ...
72 Clone and checkout a repository
73 fedpkg co [-h] [--branches] [--branch BRANCH] [--anonymous] [--depth
75 DEPTH] repo [clone_target] ...
76 Alias for clone
77 fedpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t]
79 [-F FILE] [-p] [-s] [files ...]
80 Commit changes
81 fedpkg compile [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
83 [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
84 Local test rpmbuild compile
85 fedpkg container-build [-h] [--target TARGET] [--nowait] [--background]
87 [--build-release BUILD_RELEASE] [--isolated] [--koji-parent-build
88 KOJI_PARENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--repo-url URL
89 [URL ...]] [--signing-intent SIGNING_INTENT] [--skip-remote-rules-vali‐
90 dation] [--skip-build] [--compose-id COMPOSE_ID [COMPOSE_ID ...]]
91 [--replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MAN‐
92 AGER:NAME:VERSION[:NEW_NAME] ...]]
93 Build a container
94 fedpkg container-build-setup [-h] (--get-autorebuild | --set-autore‐
96 build {true,false})
97 set options for container-build
98 fedpkg copr-build [-h] [--config CONFIG] [--nowait] project
100 Build package in Copr
101 fedpkg diff [-h] [--cached] [files ...]
103 Show changes between commits, commit and working tree, etc
104 fedpkg flatpak-build [-h] [--target TARGET] [--nowait] [--background]
106 [--build-release BUILD_RELEASE] [--isolated] [--koji-parent-build
107 KOJI_PARENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--repo-url URL
108 [URL ...]] [--signing-intent SIGNING_INTENT] [--skip-remote-rules-vali‐
109 dation] [--skip-build]
110 Build a Flatpak
111 fedpkg fork [-h]
113 Create a new fork of the current repository
114 fedpkg gimmespec [-h]
116 Print the spec file name
117 fedpkg gitbuildhash [-h] build
119 Print the git hash used to build the provided n-v-r
120 fedpkg giturl [-h]
122 Print the git url for building
123 fedpkg help [-h]
125 Show usage
126 fedpkg import [-h] [--skip-diffs] [--offline] srpm
128 Import srpm content into a module
129 fedpkg install [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
131 [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...
132 Local test rpmbuild install
133 fedpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
135 Run rpmlint against local spec and build output if present.
136 fedpkg list-side-tags [-h] [--mine | --user TAG_OWNER | --base-tag
138 BASE_TAG]
139 List existing side-tags
140 fedpkg local [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
142 [--arch ARCH] [--define DEFINE] [--md5] [--with BCOND_WITH] [--without
143 BCOND_WITHOUT] ...
144 Local test rpmbuild binary
145 fedpkg mock-config [-h] [--target TARGET] [--arch ARCH]
147 Generate a mock config
148 fedpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean] [--no-
150 cleanup-after] [--no-clean-all] [--with BCOND_WITH] [--without
151 BCOND_WITHOUT] [--shell] [--enablerepo ENABLEREPO] [--disablerepo DIS‐
152 ABLEREPO] [--enable-network] [--srpm-mock] [--use-koji-mock-config |
153 --use-local-mock-config] ...
154 Local test build using mock
155 fedpkg module-build [-h] [--watch] [--buildrequires name:stream] [--re‐
157 quires name:stream] [--optional key=value] [--file [FILE_PATH]] [--srpm
158 SRPMS] [--scratch] [scm_url] [branch]
159 Build a module using MBS
160 fedpkg module-build-cancel [-h] build_id
162 Cancel an MBS module build
163 fedpkg module-build-info [-h] build_id
165 Show information of an MBS module build
166 fedpkg module-build-local [-h] [--file [FILE_PATH]] [--srpm SRPMS]
168 [--stream [STREAM]] [--skip-tests] [--add-local-build N:S:V] [-s N:S]
169 [--offline] [-r PATH]
170 Build a module locally using the mbs-manager command
171 fedpkg module-build-watch [-h] build_id [build_id ...]
173 Watch an MBS build
174 fedpkg module-overview [-h] [--unfinished] [--limit LIMIT] [--owner
176 FAS_ID | --mine]
177 Shows an overview of MBS builds
178 fedpkg module-scratch-build [-h] [--watch] [--buildrequires
180 name:stream] [--requires name:stream] [--optional key=value] [--file
181 [FILE_PATH]] [--srpm SRPMS] [scm_url] [branch]
182 Build a scratch module using MBS
183 fedpkg new [-h]
185 Diff against last tag
186 fedpkg new-sources [-h] [--offline] files [files ...]
188 Upload source files
189 fedpkg override [-h] {create,extend} ...
191 Manage buildroot overrides
192 fedpkg patch [-h] [--rediff] suffix
194 Create and add a gendiff patch file
195 fedpkg prep [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR]
197 [--arch ARCH] [--define DEFINE] ...
198 Local test rpmbuild prep
199 fedpkg pull [-h] [--rebase] [--no-rebase]
201 Pull changes from the remote repository and update the working
202 copy.
203 fedpkg push [-h] [--force]
205 Push changes to remote repository
206 fedpkg releases-info [-h] [-e | -f | -j]
208 Print Fedora or EPEL current active releases
209 fedpkg remote [-h] {add} ...
211 Operations with tracked repositories ('remotes'). This is an ex‐
212 perimental interface.
213 fedpkg remove-side-tag [-h] TAG
215 Remove a side tag (without merging packages)
216 fedpkg request-branch [-h] [--repo NAME] [--namespace {rpms,con‐
218 tainer,modules,flatpaks}] [--sl [SL ...]] [--no-git-branch] [--no-auto-
219 module] [--all-releases] [branch]
220 Request a new dist-git branch
221 fedpkg request-repo [-h] [--namespace {rpms,container,modules,flat‐
223 paks}] [--description DESCRIPTION] [--monitor {no-monitoring,monitor‐
224 ing,monitoring-with-scratch}] [--upstreamurl UPSTREAMURL] [--summary
225 SUMMARY] [--exception] [--no-initial-commit] name [bug]
226 Request a new dist-git repository
227 fedpkg request-side-tag [-h] [--base-tag BASE_TAG] [--suffix SUFFIX]
229 Create a new side tag
230 fedpkg request-tests-repo [-h] [--bug BUG] name description
232 Request a new tests dist-git repository
233 fedpkg retire [-h] reason
235 Retire a package/module
236 fedpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
238 [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-
239 validation] [--skip-nvr-check] [--custom-user-metadata CUS‐
240 TOM_USER_METADATA] [--srpm [SRPM]] [--srpm-mock]
241 Request scratch build
242 fedpkg set-distgit-token [-h] token
244 Updates the fedpkg.distgit API token in ~/.con‐
245 fig/rpkg/fedpkg.conf file.
246 Tokens are of length 64 and contain only uppercase
248 and numerical values.
249 fedpkg set-pagure-token [-h] token
251 Updates the fedpkg.pagure API token in ~/.con‐
252 fig/rpkg/fedpkg.conf file.
253 Tokens are of length 64 and contain only uppercase
255 and numerical values.
256 fedpkg sources [-h] [--outdir OUTDIR]
258 Download source files
259 Create a source rpm
261 Create a source rpm
262 fedpkg switch-branch [-h] [-l] [--fetch] [branch]
264 Work with branches
265 fedpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l] [-d]
267 [tag]
268 Management of git tags
269 fedpkg unused-patches [-h]
271 Print list of patches not referenced by name in the specfile
272 fedpkg update [-h] [--type {bugfix,security,enhancement,newpackage}]
274 [--request {testing,stable}] [--bugs BUGS [BUGS ...]] [--notes NOTES]
275 [--disable-autokarma] [--stable-karma KARMA] [--unstable-karma KARMA]
276 [--not-close-bugs] [--no-require-bugs] [--no-require-testcases] [--sug‐
277 gest-reboot | --suggest-logout]
278 Submit last build as update
279 fedpkg upload [-h] [--offline] files [files ...]
281 Upload source files
282 fedpkg verify-files [-h] [--builddir BUILDDIR] [--buildrootdir BUILD‐
284 ROOTDIR] [--arch ARCH] [--define DEFINE] ...
285 Locally verify %%files section
286 fedpkg verrel [-h]
288 Print the name-version-release.
289
291 fedpkg build
292 usage: fedpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
293 [--target TARGET] [--background] [--fail-fast]
294 [--skip-remote-rules-validation]
295 [--skip-nvr-check]
296 [--custom-user-metadata CUSTOM_USER_METADATA]
297 [--skip-tag] [--scratch] [--srpm [SRPM]]
298 [--srpm-mock]
299 This command requests a build of the package in the build
301 system. By
302 default it discovers the target to build for based on branch data,
303 and
304 uses the latest commit as the build source.
305 fedpkg is also able to submit multiple builds to Koji at
307 once from stream
308 branch based on a local config, which is inside the
309 repository. The config file
310 is named package.cfg in INI format. For example,
311 [koji]
313 targets = rawhide fedora epel7
314 You only need to put Fedora releases and EPEL in option
316 targets and fedpkg will
317 convert it to proper Koji build target for submitting
318 builds. Beside regular
319 release names, option targets accepts two shortcut names
320 as well, fedora and
321 epel, as you can see in the above example. Name fedora
322 stands for current
323 active Fedora releases, and epel stands for the active
324 EPEL releases, which are
325 el6 and epel7 currently.
326 Note that the config file is a branch specific file. That
328 means you could
329 create package.cfg for each stream branch separately to
330 indicate on which
331 targets to build the package for a particular stream.
332 options:
334 -h, --help show this help message and exit
335 --arches [ARCHES ...]
336 Build for specific arches
337 --md5 Use md5 checksums (for older rpm hosts)
338 --nowait Don't wait on build
339 --target TARGET Define build target to build into
340 --background Run the build at a low priority
341 --fail-fast Fail the build immediately if any arch fails
342 --skip-remote-rules-validation
343 Don't check if there's a valid gating.yaml
344 file in the repo, where you can define
345 additional policies for Greenwave gating.
346 --skip-nvr-check Submit build to buildsystem without check if
347 NVR was already built. NVR is constructed
348 locally and may be different from NVR
349 constructed during build on builder.
350 --custom-user-metadata CUSTOM_USER_METADATA
351 Provide a JSON string of custom metadata to
352 be deserialized and stored under the build's
353 extra.custom_user_metadata field
354 --skip-tag Do not attempt to tag package
355 --scratch Perform a scratch build
356 --srpm [SRPM] Build from an srpm. If no srpm is provided
357 with this option an srpm will be generated
358 from current module content.
359 --srpm-mock Build from an srpm. Source rpm will be
360 generated in 'mock' instead of 'rpmbuild'.
361 fedpkg chain-build
364 usage: fedpkg chain-build [-h] [--arches [ARCHES ...]] [--md5]
365 [--nowait] [--target TARGET]
366 [--background] [--fail-fast]
367 [--skip-remote-rules-validation]
368 [--skip-nvr-check]
369 [--custom-user-metadata CUSTOM_USER_META‐
370 DATA]
371 package [package ...]
372 Build current package in order with other packages.
374 example: fedpkg chain-build libwidget libgizmo
376 The current package is added to the end of the CHAIN list.
378 Colons (:) can be used in the CHAIN parameter to define groups of
379 packages. Packages in any single group will be built in parallel
380 and all packages in a group must build successfully and populate
381 the repository before the next group will begin building.
382 For example:
384 fedpkg chain-build libwidget libaselib : libgizmo :
386 will cause libwidget and libaselib to be built in parallel, followed
388 by libgizmo and then the current directory package. If no groups are
389 defined, packages will be built sequentially.
390 positional arguments:
392 package List the packages and order you want to
393 build in
394 options:
396 -h, --help show this help message and exit
397 --arches [ARCHES ...]
398 Build for specific arches
399 --md5 Use md5 checksums (for older rpm hosts)
400 --nowait Don't wait on build
401 --target TARGET Define build target to build into
402 --background Run the build at a low priority
403 --fail-fast Fail the build immediately if any arch fails
404 --skip-remote-rules-validation
405 Don't check if there's a valid gating.yaml
406 file in the repo, where you can define
407 additional policies for Greenwave gating.
408 --skip-nvr-check Submit build to buildsystem without check if
409 NVR was already built. NVR is constructed
410 locally and may be different from NVR
411 constructed during build on builder.
412 --custom-user-metadata CUSTOM_USER_METADATA
413 Provide a JSON string of custom metadata to
414 be deserialized and stored under the build's
415 extra.custom_user_metadata field
416 fedpkg ci
419 usage: fedpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw]
420 [-t] [-F FILE] [-p] [-s]
421 [files ...]
422 Alias for commit.
424 positional arguments:
426 files Optional list of specific files to commit
427 options:
429 -h, --help show this help message and exit
430 -m MESSAGE, --message MESSAGE
431 Use the given <msg> as the commit message
432 summary
433 --with-changelog Get the last changelog from SPEC as commit
434 message content. This option must be used
435 with -m together.
436 -c, --clog Generate the commit message from the
437 Changelog section
438 --raw Make the clog raw
439 -t, --tag Create a tag for this commit
440 -F FILE, --file FILE Take the commit message from the given file
441 -p, --push Commit and push as one action
442 -s, --signoff Include a signed-off-by
443 fedpkg clean
446 usage: fedpkg clean [-h] [--dry-run] [-x]
447 This command can be used to clean up your working directory. By
449 default it will follow .gitignore rules. Patterns listed in
450 .git/info/exclude won'tbe removed either.
451 options:
453 -h, --help show this help message and exit
454 --dry-run, -n Perform a dry-run
455 -x Do not follow .gitignore and .git/info/exclude
456 rules
457 fedpkg clog
460 usage: fedpkg clog [-h] [--raw]
461 This will create a file named "clog" that contains the latest rpm
463 changelog entry. The leading "- " text will be stripped.
464 options:
466 -h, --help show this help message and exit
467 --raw Generate a more "raw" clog without twiddling the
468 contents
469 fedpkg clone
472 usage: fedpkg clone [-h] [--branches] [--branch BRANCH]
473 [--anonymous] [--depth DEPTH]
474 repo [clone_target] ...
475 This command will clone the named repository from the configured
477 repository base URL. By default it will also checkout the master
478 branch for your working copy.
479 positional arguments:
481 repo Name of the repository to clone. It should
482 not be a Git URL. Should be 'namespace/repo-
483 name' in case of namespaced dist-git.
484 Otherwise, just 'repo-name'. Namespace
485 examples are 'rpms', 'container', 'modules',
486 'flatpaks'. Default namespace 'rpms' can be
487 ignored.
488 clone_target Directory in which to clone the repository
489 extra_args Custom arguments that are passed to the 'git
490 clone'. Use '--' to separate them from other
491 arguments.
492 options:
494 -h, --help show this help message and exit
495 --branches, -B Do an old style checkout with subdirs for
496 branches
497 --branch BRANCH, -b BRANCH
498 Check out a specific branch
499 --anonymous, -a Check out a module anonymously
500 --depth DEPTH Create a shallow clone with a history
501 truncated to the specified number of commits
502 fedpkg co
505 usage: fedpkg co [-h] [--branches] [--branch BRANCH] [--anonymous]
506 [--depth DEPTH]
507 repo [clone_target] ...
508 Alias for clone.
510 positional arguments:
512 repo Name of the repository to clone. It should
513 not be a Git URL. Should be 'namespace/repo-
514 name' in case of namespaced dist-git.
515 Otherwise, just 'repo-name'. Namespace
516 examples are 'rpms', 'container', 'modules',
517 'flatpaks'. Default namespace 'rpms' can be
518 ignored.
519 clone_target Directory in which to clone the repository
520 extra_args Custom arguments that are passed to the 'git
521 clone'. Use '--' to separate them from other
522 arguments.
523 options:
525 -h, --help show this help message and exit
526 --branches, -B Do an old style checkout with subdirs for
527 branches
528 --branch BRANCH, -b BRANCH
529 Check out a specific branch
530 --anonymous, -a Check out a module anonymously
531 --depth DEPTH Create a shallow clone with a history
532 truncated to the specified number of commits
533 fedpkg commit
536 usage: fedpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c]
537 [--raw] [-t] [-F FILE] [-p] [-s]
538 [files ...]
539 This invokes a git commit. All tracked files with changes will be
541 committed unless a specific file list is provided. $EDITOR will be
542 used to generate a changelog message unless one is given to the
543 command. A push can be done at the same time.
544 positional arguments:
546 files Optional list of specific files to commit
547 options:
549 -h, --help show this help message and exit
550 -m MESSAGE, --message MESSAGE
551 Use the given <msg> as the commit message
552 summary
553 --with-changelog Get the last changelog from SPEC as commit
554 message content. This option must be used
555 with -m together.
556 -c, --clog Generate the commit message from the
557 Changelog section
558 --raw Make the clog raw
559 -t, --tag Create a tag for this commit
560 -F FILE, --file FILE Take the commit message from the given file
561 -p, --push Commit and push as one action
562 -s, --signoff Include a signed-off-by
563 fedpkg compile
566 usage: fedpkg compile [-h] [--builddir BUILDDIR]
567 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
568 [--define DEFINE] [--short-circuit]
569 [--nocheck]
570 ...
571 This command calls rpmbuild to compile the source. By default the
573 prep and configure stages will be done as well, unless the short-
574 circuit option is used.
575 positional arguments:
577 extra_args Custom arguments that are passed to the
578 'rpmbuild'. Use '--' to separate them from
579 other arguments.
580 options:
582 -h, --help show this help message and exit
583 --builddir BUILDDIR Define an alternate builddir
584 --buildrootdir BUILDROOTDIR
585 Define an alternate buildrootdir
586 --arch ARCH Prep for a specific arch
587 --define DEFINE Pass custom macros to rpmbuild, may specify
588 multiple times
589 --short-circuit short-circuit compile
590 --nocheck nocheck compile
591 fedpkg container-build
594 usage: fedpkg container-build [-h] [--target TARGET] [--nowait]
595 [--background]
596 [--build-release BUILD_RELEASE]
597 [--isolated]
598 [--koji-parent-build KOJI_PARENT_BUILD]
599 [--scratch] [--arches [ARCHES ...]]
600 [--repo-url URL [URL ...]]
601 [--signing-intent SIGNING_INTENT]
602 [--skip-remote-rules-validation]
603 [--skip-build]
604 [--compose-id COMPOSE_ID [COMPOSE_ID
605 ...]]
606 [--replace-dependency PKG_MAN‐
607 AGER:NAME:VERSION[:NEW_NAME]
608 [PKG_MANAGER:NAME:VERSION[:NEW_NAME]
609 ...]]
610 Build a container
612 options:
614 -h, --help show this help message and exit
615 --target TARGET Override the default target
616 --nowait Don't wait on build
617 --background Run the build at a lower priority
618 --build-release BUILD_RELEASE
619 Specify a release value for this build's NVR
620 --isolated Do not update floating tags in the registry.
621 You must use the --build-release argument
622 --koji-parent-build KOJI_PARENT_BUILD
623 Specify a Koji NVR for the parent container
624 image. This will override the "FROM" value
625 in your Dockerfile.
626 --scratch Scratch build
627 --arches [ARCHES ...]
628 Limit a scratch or a isolated build to an
629 arch. May have multiple arches.
630 --repo-url URL [URL ...]
631 URLs of yum repo files
632 --signing-intent SIGNING_INTENT
633 Signing intent of the ODCS composes. If
634 specified, this must be one of the signing
635 intent names configured on the OSBS server.
636 If unspecified, the server will use the
637 signing intent of the compose_ids you
638 specify, or the server's
639 default_signing_intent. To view the full
640 list of possible names, see REACTOR_CONFIG
641 in orchestrator.log.
642 --skip-remote-rules-validation
643 Don't check if there's a valid gating.yaml
644 file in the repo
645 --skip-build Don't create build, but just modify settings
646 for autorebuilds
647 --compose-id COMPOSE_ID [COMPOSE_ID ...]
648 Use existing ODCS composes (specify
649 integers). Cannot be used with --signing-
650 intent.
651 --replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MAN‐
652 AGER:NAME:VERSION[:NEW_NAME] ...]
653 Cachito dependency replacement
654 fedpkg container-build-setup
657 usage: fedpkg container-build-setup [-h]
658 (--get-autorebuild | --set-au‐
659 torebuild {true,false})
660 set options for container-build.
662 options:
664 -h, --help show this help message and exit
665 --get-autorebuild Get autorebuild value
666 --set-autorebuild {true,false}
667 Turn autorebuilds on/off
668 fedpkg copr-build
671 usage: fedpkg copr-build [-h] [--config CONFIG] [--nowait] project
672 Build package in Copr.
674 Note: you need to have set up correct api key. For more information
676 see API KEY section of copr-cli(1) man page.
677 positional arguments:
679 project Name of the project in format USER/PROJECT
680 options:
682 -h, --help show this help message and exit
683 --config CONFIG Path to an alternative Copr configuration file
684 --nowait Don't wait on build
685 fedpkg diff
688 usage: fedpkg diff [-h] [--cached] [files ...]
689 Use git diff to show changes that have been made to tracked files.
691 By default cached changes (changes that have been git added) will
692 not be shown.
693 positional arguments:
695 files Optionally diff specific files
696 options:
698 -h, --help show this help message and exit
699 --cached View staged changes
700 fedpkg flatpak-build
703 usage: fedpkg flatpak-build [-h] [--target TARGET] [--nowait]
704 [--background]
705 [--build-release BUILD_RELEASE]
706 [--isolated]
707 [--koji-parent-build KOJI_PARENT_BUILD]
708 [--scratch] [--arches [ARCHES ...]]
709 [--repo-url URL [URL ...]]
710 [--signing-intent SIGNING_INTENT]
711 [--skip-remote-rules-validation]
712 [--skip-build]
713 Build a Flatpak
715 options:
717 -h, --help show this help message and exit
718 --target TARGET Override the default target
719 --nowait Don't wait on build
720 --background Run the build at a lower priority
721 --build-release BUILD_RELEASE
722 Specify a release value for this build's NVR
723 --isolated Do not update floating tags in the registry.
724 You must use the --build-release argument
725 --koji-parent-build KOJI_PARENT_BUILD
726 Specify a Koji NVR for the parent container
727 image. This will override the "FROM" value
728 in your Dockerfile.
729 --scratch Scratch build
730 --arches [ARCHES ...]
731 Limit a scratch or a isolated build to an
732 arch. May have multiple arches.
733 --repo-url URL [URL ...]
734 URLs of yum repo files
735 --signing-intent SIGNING_INTENT
736 Signing intent of the ODCS composes. If
737 specified, this must be one of the signing
738 intent names configured on the OSBS server.
739 If unspecified, the server will use the
740 signing intent of the compose_ids you
741 specify, or the server's
742 default_signing_intent. To view the full
743 list of possible names, see REACTOR_CONFIG
744 in orchestrator.log.
745 --skip-remote-rules-validation
746 Don't check if there's a valid gating.yaml
747 file in the repo
748 --skip-build Don't create build, but just modify settings
749 for autorebuilds
750 fedpkg fork
753 usage: fedpkg fork [-h]
754 Create a new fork of the current repository
756 Before the operation, you need to generate a pagure.io API token at:
758 https://src.fedoraproject.org/settings/token/new
759 ACL required:
761 "Fork a project"
762 Update your token with the following command:
764 fedpkg set-distgit-token <api_key_here>
765 Command saves token to fedpkg config file:
767 ~/.config/rpkg/fedpkg.conf
768 For example:
770 [fedpkg.distgit]
771 token = <api_key_here>
772 Below is a basic example of the command to fork a current repository:
774 fedpkg fork
776 Operation requires username (FAS_ID). by default, current logged
778 username is taken. It could be overridden by reusing an argument:
779 fedpkg --user FAS_ID fork
781 options:
783 -h, --help show this help message and exit
784 fedpkg gimmespec
787 usage: fedpkg gimmespec [-h]
788 Print the spec file name.
790 options:
792 -h, --help show this help message and exit
793 fedpkg gitbuildhash
796 usage: fedpkg gitbuildhash [-h] build
797 This will show you the commit hash string used to build the provided
799 build n-v-r
800 positional arguments:
802 build name-version-release of the build to query.
803 options:
805 -h, --help show this help message and exit
806 fedpkg giturl
809 usage: fedpkg giturl [-h]
810 This will show you which git URL would be used in a build command.
812 It uses the git hashsum of the HEAD of the current branch (which may
813 not be pushed).
814 options:
816 -h, --help show this help message and exit
817 fedpkg help
820 usage: fedpkg help [-h]
821 Show usage.
823 options:
825 -h, --help show this help message and exit
826 fedpkg import
829 usage: fedpkg import [-h] [--skip-diffs] [--offline] srpm
830 This will extract sources, patches, and the spec file from an srpm
832 and update the current module accordingly. It will import to the
833 current branch by default.
834 positional arguments:
836 srpm Source rpm to import
837 options:
839 -h, --help show this help message and exit
840 --skip-diffs Don't show diffs when import srpms
841 --offline Do not upload files into lookaside cache
842 fedpkg install
845 usage: fedpkg install [-h] [--builddir BUILDDIR]
846 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
847 [--define DEFINE] [--short-circuit]
848 [--nocheck]
849 ...
850 This will call rpmbuild to run the install section. All leading
852 sections will be processed as well, unless the short-circuit option
853 is used.
854 positional arguments:
856 extra_args Custom arguments that are passed to the
857 'rpmbuild'. Use '--' to separate them from
858 other arguments.
859 options:
861 -h, --help show this help message and exit
862 --builddir BUILDDIR Define an alternate builddir
863 --buildrootdir BUILDROOTDIR
864 Define an alternate buildrootdir
865 --arch ARCH Prep for a specific arch
866 --define DEFINE Pass custom macros to rpmbuild, may specify
867 multiple times
868 --short-circuit short-circuit install
869 --nocheck nocheck install
870 fedpkg lint
873 usage: fedpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
874 Rpmlint can be configured using the --rpmlintconf/-r option or by
876 setting a <pkgname>.rpmlintrc file in the working directory
877 options:
879 -h, --help show this help message and exit
880 --info, -i Display explanations for reported messages
881 --rpmlintconf RPMLINTCONF, -r RPMLINTCONF
882 Use a specific configuration file for
883 rpmlint
884 fedpkg list-side-tags
887 usage: fedpkg list-side-tags [-h]
888 [--mine | --user TAG_OWNER | --base-tag
889 BASE_TAG]
890 List existing side-tags.
892 options:
894 -h, --help show this help message and exit
895 --mine List only my side tags
896 --user TAG_OWNER List side tags created by this user
897 --base-tag BASE_TAG List only tags based on this base
898 fedpkg local
901 usage: fedpkg local [-h] [--builddir BUILDDIR]
902 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
903 [--define DEFINE] [--md5] [--with BCOND_WITH]
904 [--without BCOND_WITHOUT]
905 ...
906 Locally test run of rpmbuild producing binary RPMs. The rpmbuild
908 output will be logged into a file named
909 .build-%{version}-%{release}.log
910 positional arguments:
912 extra_args Custom arguments that are passed to the
913 'rpmbuild'. Use '--' to separate them from
914 other arguments.
915 options:
917 -h, --help show this help message and exit
918 --builddir BUILDDIR Define an alternate builddir
919 --buildrootdir BUILDROOTDIR
920 Define an alternate buildrootdir
921 --arch ARCH Prep for a specific arch
922 --define DEFINE Pass custom macros to rpmbuild, may specify
923 multiple times
924 --md5 Use md5 checksums (for older rpm hosts)
925 --with BCOND_WITH Enable configure option (bcond) for the
926 build
927 --without BCOND_WITHOUT
928 Disable configure option (bcond) for the
929 build
930 fedpkg mock-config
933 usage: fedpkg mock-config [-h] [--target TARGET] [--arch ARCH]
934 This will generate a mock config based on the buildsystem target
936 options:
938 -h, --help show this help message and exit
939 --target TARGET Override target used for config
940 --arch ARCH Override local arch
941 fedpkg mockbuild
944 usage: fedpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean]
945 [--no-cleanup-after] [--no-clean-all]
946 [--with BCOND_WITH]
947 [--without BCOND_WITHOUT] [--shell]
948 [--enablerepo ENABLEREPO]
949 [--disablerepo DISABLEREPO]
950 [--enable-network] [--srpm-mock]
951 [--use-koji-mock-config | --use-local-mock-
952 config]
953 ...
954 This will use the mock utility to build the package for the
956 distribution detected from branch information. This can be
957 overridden using the global --release option. Your user must be in
958 the local "mock" group.
959 positional arguments:
961 extra_args Custom arguments that are passed to the
962 'mock'. Use '--' to separate them from other
963 arguments.
964 options:
966 -h, --help show this help message and exit
967 --root CONFIG, --mock-config CONFIG
968 Override mock configuration (like mock -r)
969 --md5 Use md5 checksums (for older rpm hosts)
970 --no-clean, -n Do not clean chroot before building package
971 --no-cleanup-after Do not clean chroot after building (if
972 automatic cleanup is enabled
973 --no-clean-all, -N Alias for both --no-clean and --no-cleanup-
974 after
975 --with BCOND_WITH Enable configure option (bcond) for the
976 build
977 --without BCOND_WITHOUT
978 Disable configure option (bcond) for the
979 build
980 --shell Run commands interactively within chroot.
981 Before going into chroot, mockbuild needs to
982 run with --no-cleanup-after in advanced.
983 --enablerepo ENABLEREPO
984 Pass enablerepo option to yum/dnf (may be
985 used more than once)
986 --disablerepo DISABLEREPO
987 Pass disablerepo option to yum/dnf (may be
988 used more than once)
989 --enable-network Enable networking
990 --srpm-mock Generate source rpm with 'mock' and then run
991 'mockbuild' using this source rpm
992 --use-koji-mock-config
993 Download Mock configuration from Kojihub,
994 instead of using the local Mock
995 configuration in mock-core-configs.rpm.
996 --use-local-mock-config
997 Enforce use of local Mock configuration.
998 If config file for mock isn't found in the /etc/mock directory, a
1000 temporary config directory for mock is created and populated with a
1001 config file created with mock-config.
1002 fedpkg module-build
1005 usage: fedpkg module-build [-h] [--watch]
1006 [--buildrequires name:stream]
1007 [--requires name:stream]
1008 [--optional key=value]
1009 [--file [FILE_PATH]] [--srpm SRPMS]
1010 [--scratch]
1011 [scm_url] [branch]
1012 Build a module using MBS
1014 positional arguments:
1016 scm_url The module's SCM URL. This defaults to the
1017 current repo.
1018 branch The module's SCM branch. This defaults to
1019 the current checked-out branch.
1020 options:
1022 -h, --help show this help message and exit
1023 --watch, -w Watch the module build
1024 --buildrequires name:stream
1025 Buildrequires to override in the form of
1026 "name:stream"
1027 --requires name:stream
1028 Requires to override in the form of
1029 "name:stream"
1030 --optional key=value MBS optional arguments in the form of
1031 "key=value". For example: 'fedpkg module-
1032 build --optional
1033 "reuse_components_from=<NSVC>"'. More
1034 description including list of available
1035 arguments here: https://pagure.io/fm-
1036 orchestrator/
1037 --file [FILE_PATH] The modulemd yaml file for module scratch
1038 build.
1039 --srpm SRPMS Include one or more srpms for module scratch
1040 build.
1041 --scratch Perform a scratch build
1042 fedpkg module-build-cancel
1045 usage: fedpkg module-build-cancel [-h] build_id
1046 Cancel an MBS module build
1048 positional arguments:
1050 build_id The ID of the module build to cancel
1051 options:
1053 -h, --help show this help message and exit
1054 fedpkg module-build-info
1057 usage: fedpkg module-build-info [-h] build_id
1058 Show information of an MBS module build
1060 positional arguments:
1062 build_id The ID of the module build
1063 options:
1065 -h, --help show this help message and exit
1066 fedpkg module-build-local
1069 usage: fedpkg module-build-local [-h] [--file [FILE_PATH]]
1070 [--srpm SRPMS] [--stream [STREAM]]
1071 [--skip-tests]
1072 [--add-local-build N:S:V] [-s N:S]
1073 [--offline] [-r PATH]
1074 Build a module locally using the mbs-manager command
1076 options:
1078 -h, --help show this help message and exit
1079 --file [FILE_PATH] The module's modulemd yaml file. If not
1080 specified, a yaml file with the same
1081 basename as the name of the repository will
1082 be used.
1083 --srpm SRPMS Include one or more srpms for module build.
1084 --stream [STREAM] The module's stream/SCM branch. This
1085 defaults to the current checked-out branch.
1086 --skip-tests Adds a macro for skipping the check section
1087 --add-local-build N:S:V
1088 Import previously finished local module
1089 builds into MBS in the format of name:stream
1090 or name:stream:version
1091 -s N:S, --set-default-stream N:S
1092 Set the default stream for given module
1093 dependency in case there are multiple
1094 streams to choose from.
1095 --offline Builds module offline without any external
1096 infrastructure
1097 -r PATH, --repository PATH
1098 Full path to .repo file defining the base
1099 module repository to use when --offline is
1100 used.
1101 fedpkg module-build-watch
1104 usage: fedpkg module-build-watch [-h] build_id [build_id ...]
1105 Watch an MBS build
1107 positional arguments:
1109 build_id The ID of the module build to watch
1110 options:
1112 -h, --help show this help message and exit
1113 fedpkg module-overview
1116 usage: fedpkg module-overview [-h] [--unfinished] [--limit LIMIT]
1117 [--owner FAS_ID | --mine]
1118 Shows an overview of MBS builds
1120 options:
1122 -h, --help show this help message and exit
1123 --unfinished Show unfinished module builds
1124 --limit LIMIT The number of most recent module builds to display
1125 --owner FAS_ID List only items of that owner
1126 --mine Use current Kerberos name or username
1127 fedpkg module-scratch-build
1130 usage: fedpkg module-scratch-build [-h] [--watch]
1131 [--buildrequires name:stream]
1132 [--requires name:stream]
1133 [--optional key=value]
1134 [--file [FILE_PATH]]
1135 [--srpm SRPMS]
1136 [scm_url] [branch]
1137 Build a scratch module using MBS
1139 positional arguments:
1141 scm_url The module's SCM URL. This defaults to the
1142 current repo.
1143 branch The module's SCM branch. This defaults to
1144 the current checked-out branch.
1145 options:
1147 -h, --help show this help message and exit
1148 --watch, -w Watch the module build
1149 --buildrequires name:stream
1150 Buildrequires to override in the form of
1151 "name:stream"
1152 --requires name:stream
1153 Requires to override in the form of
1154 "name:stream"
1155 --optional key=value MBS optional arguments in the form of
1156 "key=value". For example: 'fedpkg module-
1157 build --optional
1158 "reuse_components_from=<NSVC>"'. More
1159 description including list of available
1160 arguments here: https://pagure.io/fm-
1161 orchestrator/
1162 --file [FILE_PATH] The modulemd yaml file for module scratch
1163 build.
1164 --srpm SRPMS Include one or more srpms for module scratch
1165 build.
1166 fedpkg new
1169 usage: fedpkg new [-h]
1170 This will use git to show a diff of all the changes (even
1172 uncommitted changes) since the last git tag was applied.
1173 options:
1175 -h, --help show this help message and exit
1176 fedpkg new-sources
1179 usage: fedpkg new-sources [-h] [--offline] files [files ...]
1180 This will upload new source file(s) to lookaside cache, and all file
1182 names listed in sources file will be replaced. .gitignore will be
1183 also updated with new uploaded file(s). Please remember to commit
1184 them.
1185 positional arguments:
1187 files
1188 options:
1190 -h, --help show this help message and exit
1191 --offline Do all the steps except uploading into lookaside cache
1192 fedpkg override
1195 usage: fedpkg override [-h] {create,extend} ...
1196 Manage buildroot overrides.
1198 options:
1200 -h, --help show this help message and exit
1201 subcommands:
1203 Commands on override
1204 {create,extend}
1206 create Create buildroot override from build
1207 extend Extend buildroot override expiration
1208 fedpkg patch
1211 usage: fedpkg patch [-h] [--rediff] suffix
1212 Create and add a gendiff patch file.
1214 positional arguments:
1216 suffix Look for files with this suffix to diff
1217 options:
1219 -h, --help show this help message and exit
1220 --rediff Recreate gendiff file retaining comments Saves old
1221 patch file with a suffix of ~
1222 Patch file will be named: package-version-suffix.patch and the file
1224 will be added to the repo index
1225 fedpkg prep
1228 usage: fedpkg prep [-h] [--builddir BUILDDIR]
1229 [--buildrootdir BUILDROOTDIR] [--arch ARCH]
1230 [--define DEFINE]
1231 ...
1232 Use rpmbuild to "prep" the sources (unpack the source archive(s) and
1234 apply any patches.)
1235 positional arguments:
1237 extra_args Custom arguments that are passed to the
1238 'rpmbuild'. Use '--' to separate them from
1239 other arguments.
1240 options:
1242 -h, --help show this help message and exit
1243 --builddir BUILDDIR Define an alternate builddir
1244 --buildrootdir BUILDROOTDIR
1245 Define an alternate buildrootdir
1246 --arch ARCH Prep for a specific arch
1247 --define DEFINE Pass custom macros to rpmbuild, may specify
1248 multiple times
1249 fedpkg pull
1252 usage: fedpkg pull [-h] [--rebase] [--no-rebase]
1253 This command uses git to fetch remote changes and apply them to the
1255 current working copy. A rebase option is available which can be used
1256 to avoid merges.
1257 options:
1259 -h, --help show this help message and exit
1260 --rebase Rebase the locally committed changes on top of the
1261 remote changes after fetching. This can avoid a merge
1262 commit, but does rewrite local history.
1263 --no-rebase Do not rebase, overriding .git settings to the
1264 contrary
1265 See git pull --help for more details
1267 fedpkg push
1270 usage: fedpkg push [-h] [--force]
1271 Push changes to remote repository.
1273 options:
1275 -h, --help show this help message and exit
1276 --force, -f Force push
1277 fedpkg releases-info
1280 usage: fedpkg releases-info [-h] [-e | -f | -j]
1281 Print Fedora or EPEL current active releases
1283 options:
1285 -h, --help show this help message and exit
1286 -e, --epel Only show EPEL releases.
1287 -f, --fedora Only show Fedora active releases.
1288 -j, --join Show all releases in one line separated by a space.
1289 fedpkg remote
1292 usage: fedpkg remote [-h] {add} ...
1293 Operations with tracked repositories ('remotes'). This is an
1295 experimental interface.
1296 options:
1298 -h, --help show this help message and exit
1299 subcommands:
1301 Operations with tracked repositories ('remotes'). This is an
1302 experimental interface. Please note that some or all current
1303 functionality is subject to change. Without parameters list of
1304 remotes will be shown.
1305 {add}
1307 fedpkg remove-side-tag
1310 usage: fedpkg remove-side-tag [-h] TAG
1311 Remove a side tag (without merging packages).
1313 positional arguments:
1315 TAG name of tag to be deleted
1316 options:
1318 -h, --help show this help message and exit
1319 fedpkg request-branch
1322 usage: fedpkg request-branch [-h] [--repo NAME]
1323 [--namespace {rpms,container,mod‐
1324 ules,flatpaks}]
1325 [--sl [SL ...]] [--no-git-branch]
1326 [--no-auto-module] [--all-releases]
1327 [branch]
1328 Request a new dist-git branch
1330 Please refer to the help of the request-repo command to see what has
1332 to be done before requesting a dist-git branch.
1333 Branch name could be one of current active Fedora and EPEL releases.
1335 Use
1336 command ``fedpkg releases-info`` to get release names that can be
1337 used to request
1338 a branch.
1339 Below are various examples of requesting a dist-git branch.
1341 Request a branch inside a cloned package repository:
1343 fedpkg request-branch f27
1345 Request a branch outside package repository, which could apply to
1347 cases of
1348 requested repository has not been approved and created, or just not
1349 change
1350 directory to package repository:
1351 fedpkg request-branch --repo foo f27
1353 Request a branch with service level tied to the branch. In this case
1355 branch
1356 argument has to be before --sl argument, because --sl allows multiple
1357 values.
1358 fedpkg request-branch branch_name --sl bug_fixes:2020-06-01
1360 rawhide:2019-12-01
1361 positional arguments:
1363 branch The branch to request.
1364 options:
1366 -h, --help show this help message and exit
1367 --repo NAME Repository name the new branch is requested
1368 for.
1369 --namespace {rpms,container,modules,flatpaks}
1370 Repository name the new branch is requested
1371 for.
1372 --sl [SL ...] The service levels (SLs) tied to the branch.
1373 This must be in the format of
1374 "sl_name:2020-12-01". This is only for non-
1375 release branches. You may provide more than
1376 one by separating each SL with a space. When
1377 the argument is used, branch argument has to
1378 be placed before --sl.
1379 --no-git-branch Don't create the branch in git but still
1380 create it in PDC
1381 --no-auto-module If requesting an rpm arbitrary branch, do
1382 not also request a new matching module. See
1383 https://pagure.io/fedrepo_req/issue/129
1384 --all-releases Make a new branch request for every active
1385 Fedora release
1386 fedpkg request-repo
1389 usage: fedpkg request-repo [-h]
1390 [--namespace {rpms,container,modules,flat‐
1391 paks}]
1392 [--description DESCRIPTION]
1393 [--monitor {no-monitoring,monitoring,moni‐
1394 toring-with-scratch}]
1395 [--upstreamurl UPSTREAMURL]
1396 [--summary SUMMARY] [--exception]
1397 [--no-initial-commit]
1398 name [bug]
1399 Request a new dist-git repository
1401 Before the operation, you need to generate a pagure.io API token at:
1403 https://pagure.io/settings/token/new
1404 ACL required:
1406 "Create a new ticket"
1407 Update your token with the following command:
1409 fedpkg set-pagure-token <api_key_here>
1410 Command saves token to fedpkg config file:
1412 ~/.config/rpkg/fedpkg.conf
1413 For example:
1415 [fedpkg.pagure]
1416 token = <api_key_here>
1417 Below is a basic example of the command to request a dist-git reposi‐
1419 tory for
1420 the package foo:
1421 fedpkg request-repo foo 1234
1423 Another example to request a module foo:
1425 fedpkg request-repo --namespace modules foo
1427 positional arguments:
1429 name Repository name to request.
1430 bug Bugzilla bug ID of the package review
1431 request. Not required for requesting a
1432 module repository
1433 options:
1435 -h, --help show this help message and exit
1436 --namespace {rpms,container,modules,flatpaks}
1437 Namespace of repository. If omitted, default
1438 to rpms.
1439 --description DESCRIPTION, -d DESCRIPTION
1440 The repo's description in dist-git
1441 --monitor {no-monitoring,monitoring,monitoring-with-scratch}, -m
1442 {no-monitoring,monitoring,monitoring-with-scratch}
1443 The Anitya monitoring type for the repo
1444 --upstreamurl UPSTREAMURL, -u UPSTREAMURL
1445 The upstream URL of the project
1446 --summary SUMMARY, -s SUMMARY
1447 Override the package's summary from the
1448 Bugzilla bug
1449 --exception The package is an exception to the regular
1450 package review process (specifically, it
1451 does not require a Bugzilla bug)
1452 --no-initial-commit Do not include an initial commit in the
1453 repository.
1454 fedpkg request-side-tag
1457 usage: fedpkg request-side-tag [-h] [--base-tag BASE_TAG]
1458 [--suffix SUFFIX]
1459 Create a new side tag.
1461 options:
1463 -h, --help show this help message and exit
1464 --base-tag BASE_TAG name of base tag
1465 --suffix SUFFIX A suffix to be appended to the side tag name.
1466 The suffix must be allowed in Koji
1467 configuration.
1468 fedpkg request-tests-repo
1471 usage: fedpkg request-tests-repo [-h] [--bug BUG] name description
1472 Request a new dist-git repository in tests shared namespace
1474 https://src.fedoraproject.org/projects/tests/*
1476 For more information about tests shared namespace see
1478 https://fedoraproject.org/wiki/CI/Share_Test_Code
1480 Please refer to the request-repo command to see what has to be done
1482 before
1483 requesting a repository in the tests namespace.
1484 Below is a basic example of the command to request a dist-git reposi‐
1486 tory for
1487 the space tests/foo:
1488 fedpkg request-tests-repo foo "Description of the repository"
1490 Note that the space name needs to reflect the intent of the tests and
1492 will
1493 undergo a manual review.
1494 positional arguments:
1496 name Repository name to request.
1497 description Description of the tests repository
1498 options:
1500 -h, --help show this help message and exit
1501 --bug BUG Bugzilla bug ID of the package review request.
1502 fedpkg retire
1505 usage: fedpkg retire [-h] reason
1506 This command will remove all files from the repo, leave a
1508 dead.package file for rpms or dead.module file for modules, and push
1509 the changes.
1510 positional arguments:
1512 reason Reason for retiring the package/module
1513 options:
1515 -h, --help show this help message and exit
1516 fedpkg scratch-build
1519 usage: fedpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5]
1520 [--nowait] [--target TARGET]
1521 [--background] [--fail-fast]
1522 [--skip-remote-rules-validation]
1523 [--skip-nvr-check]
1524 [--custom-user-metadata CUSTOM_USER_META‐
1525 DATA]
1526 [--srpm [SRPM]] [--srpm-mock]
1527 This command will request a scratch build of the package. Without
1529 providing an srpm, it will attempt to build the latest commit, which
1530 must have been pushed. By default all appropriate arches will be
1531 built.
1532 options:
1534 -h, --help show this help message and exit
1535 --arches [ARCHES ...]
1536 Build for specific arches
1537 --md5 Use md5 checksums (for older rpm hosts)
1538 --nowait Don't wait on build
1539 --target TARGET Define build target to build into
1540 --background Run the build at a low priority
1541 --fail-fast Fail the build immediately if any arch fails
1542 --skip-remote-rules-validation
1543 Don't check if there's a valid gating.yaml
1544 file in the repo, where you can define
1545 additional policies for Greenwave gating.
1546 --skip-nvr-check Submit build to buildsystem without check if
1547 NVR was already built. NVR is constructed
1548 locally and may be different from NVR
1549 constructed during build on builder.
1550 --custom-user-metadata CUSTOM_USER_METADATA
1551 Provide a JSON string of custom metadata to
1552 be deserialized and stored under the build's
1553 extra.custom_user_metadata field
1554 --srpm [SRPM] Build from an srpm. If no srpm is provided
1555 with this option an srpm will be generated
1556 from the current module content.
1557 --srpm-mock Build from an srpm. Source rpm will be
1558 generated in 'mock' instead of 'rpmbuild'.
1559 fedpkg set-distgit-token
1562 usage: fedpkg set-distgit-token [-h] token
1563 Updates the fedpkg.distgit API token in ~/.config/rpkg/fedpkg.conf
1565 file. Tokens are of length 64 and contain only uppercase and
1566 numerical values.
1567 positional arguments:
1569 token The new API token. Can be generated at:
1570 https://src.fedoraproject.org/settings/token/new
1571 options:
1573 -h, --help show this help message and exit
1574 fedpkg set-pagure-token
1577 usage: fedpkg set-pagure-token [-h] token
1578 Updates the fedpkg.pagure API token in ~/.config/rpkg/fedpkg.conf
1580 file. Tokens are of length 64 and contain only uppercase and
1581 numerical values.
1582 positional arguments:
1584 token The new API token. Can be generated at:
1585 https://pagure.io/settings/token/new
1586 options:
1588 -h, --help show this help message and exit
1589 fedpkg sources
1592 usage: fedpkg sources [-h] [--outdir OUTDIR]
1593 Download source files
1595 options:
1597 -h, --help show this help message and exit
1598 --outdir OUTDIR Directory to download files into (defaults to
1599 pwd)
1600 fedpkg srpm
1603 usage: Create a source rpm
1604 This command wraps "rpmbuild -bs", roughly equivalent to:
1606 rpmbuild -bs mypackage.spec --define "_topdir ." --de‐
1608 fine "_sourcedir ." --define "_srcrpmdir ." --define "dist
1609 .el8"
1610 To include files in the SRPM, the files must be in the current
1612 working directory (this depends on the package layout used),
1613 and you must reference each file with SourceXXXX: or PatchXXXX:
1614 directives in your .spec file.
1615 positional arguments:
1617 extra_args Custom arguments that are passed to the
1618 'rpmbuild'. Use '--' to separate them from
1619 other arguments.
1620 options:
1622 -h, --help show this help message and exit
1623 --builddir BUILDDIR Define an alternate builddir
1624 --buildrootdir BUILDROOTDIR
1625 Define an alternate buildrootdir
1626 --arch ARCH Prep for a specific arch
1627 --define DEFINE Pass custom macros to rpmbuild, may specify
1628 multiple times
1629 --md5 Use md5 checksums (for older rpm hosts)
1630 --srpm-mock Create source rpm in 'mock' instead of
1631 'rpmbuild'
1632 --no-clean, -n Only for --srpm-mock: Do not clean chroot
1633 before building package
1634 --no-cleanup-after Only for --srpm-mock: Do not clean chroot
1635 after building if automatic cleanup is
1636 enabled
1637 --no-clean-all, -N Only for --srpm-mock: Alias for both --no-
1638 clean and --no-cleanup-after
1639 fedpkg switch-branch
1642 usage: fedpkg switch-branch [-h] [-l] [--fetch] [branch]
1643 This command can switch to a local git branch. If provided with a
1645 remote branch name that does not have a local match it will create
1646 one. It can also be used to list the existing local and remote
1647 branches.
1648 positional arguments:
1650 branch Branch name to switch to
1651 options:
1653 -h, --help show this help message and exit
1654 -l, --list List both remote-tracking branches and local branches
1655 --fetch Fetch new data from remote before switch
1656 fedpkg tag
1659 usage: fedpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l]
1660 [-d]
1661 [tag]
1662 This command uses git to create, list, or delete tags.
1664 positional arguments:
1666 tag Name of the tag
1667 options:
1669 -h, --help show this help message and exit
1670 -f, --force Force the creation of the tag
1671 -m MESSAGE, --message MESSAGE
1672 Use the given <msg> as the tag message
1673 -c, --clog Generate the tag message from the spec
1674 changelog section
1675 --raw Make the clog raw
1676 -F FILE, --file FILE Take the tag message from the given file
1677 -l, --list List all tags with a given pattern, or all
1678 if not pattern is given
1679 -d, --delete Delete a tag
1680 fedpkg unused-patches
1683 usage: fedpkg unused-patches [-h]
1684 Print list of patches not referenced by name in the specfile.
1686 options:
1688 -h, --help show this help message and exit
1689 fedpkg update
1692 usage: fedpkg update [-h]
1693 [--type {bugfix,security,enhancement,newpack‐
1694 age}]
1695 [--request {testing,stable}]
1696 [--bugs BUGS [BUGS ...]] [--notes NOTES]
1697 [--disable-autokarma] [--stable-karma KARMA]
1698 [--unstable-karma KARMA] [--not-close-bugs]
1699 [--no-require-bugs] [--no-require-testcases]
1700 [--suggest-reboot | --suggest-logout]
1701 This will create a bodhi update request for the current package n-v-
1703 r.
1704 There are two ways to specify update details. Without any argument
1706 from command
1707 line, either update type or notes is omitted, a template editor will
1708 be shown
1709 and let you edit the detail information interactively.
1710 Alternatively, you could specify argument from command line to create
1712 an update
1713 directly, for example:
1714 fedpkg update --type bugfix --notes 'Rebuilt' --bugs 1000 1002
1716 When all lines in template editor are commented out or deleted, the
1718 creation
1719 process is aborted. If the template keeps unchanged, fedpkg continues
1720 on creating
1721 update. That gives user a chance to confirm the auto-generated notes
1722 from
1723 change log if option --notes is omitted.
1724 options:
1726 -h, --help show this help message and exit
1727 --type {bugfix,security,enhancement,newpackage}
1728 Update type. Template editor will be shown
1729 if type is omitted.
1730 --request {testing,stable}
1731 Requested repository.
1732 --bugs BUGS [BUGS ...]
1733 Bug numbers. If omitted, bug numbers will be
1734 extracted from change logs.
1735 --notes NOTES Update description. Multiple lines of notes
1736 could be specified. If omitted, template
1737 editor will be shown.
1738 --disable-autokarma Karma automatism is enabled by default. Use
1739 this option to disable that.
1740 --stable-karma KARMA Stable karma. Default is 3.
1741 --unstable-karma KARMA
1742 Unstable karma. Default is -3.
1743 --not-close-bugs By default, update will be created by
1744 enabling to close bugs automatically. If
1745 this is what you do not want, use this
1746 option to disable the default behavior.
1747 --no-require-bugs Disables the requirement that all of the
1748 bugs in your update have been confirmed by
1749 testers. Default is True.
1750 --no-require-testcases
1751 Disables the requirement that this update
1752 passes all test cases before reaching
1753 stable. Default is True.
1754 --suggest-reboot Suggest user to reboot after update. Default
1755 is False.
1756 --suggest-logout Suggest user to logout after update. Default
1757 is False.
1758 fedpkg upload
1761 usage: fedpkg upload [-h] [--offline] files [files ...]
1762 This command will upload new source file(s) to lookaside cache.
1764 Source file names are appended to sources file, and .gitignore will
1765 be also updated with new uploaded file(s). Please remember to commit
1766 them.
1767 positional arguments:
1769 files
1770 options:
1772 -h, --help show this help message and exit
1773 --offline Do all the steps except uploading into lookaside cache
1774 fedpkg verify-files
1777 usage: fedpkg verify-files [-h] [--builddir BUILDDIR]
1778 [--buildrootdir BUILDROOTDIR]
1779 [--arch ARCH] [--define DEFINE]
1780 ...
1781 Locally run 'rpmbuild -bl' to verify the spec file's %files
1783 sections. This requires a successful run of 'fedpkg install' in
1784 advance.
1785 positional arguments:
1787 extra_args Custom arguments that are passed to the
1788 'rpmbuild'. Use '--' to separate them from
1789 other arguments.
1790 options:
1792 -h, --help show this help message and exit
1793 --builddir BUILDDIR Define an alternate builddir
1794 --buildrootdir BUILDROOTDIR
1795 Define an alternate buildrootdir
1796 --arch ARCH Prep for a specific arch
1797 --define DEFINE Pass custom macros to rpmbuild, may specify
1798 multiple times
1799 fedpkg verrel
1802 usage: fedpkg verrel [-h]
1803 Print the name-version-release.
1805 options:
1807 -h, --help show this help message and exit
1808
1811 https://pagure.io/fedpkg/
1812 2022-09-08 fedpkg(1)