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