rfpkg - Man Page

RPM Packaging utility

Synopsis

rfpkg [ global_options ] command [ command_options ] [ command_arguments ]
rfpkg help
rfpkg command --help

Description

rfpkg is a script to interact with the RPM Packaging system.

Global Options

 --config CONFIG, -C CONFIG
                       Specify a config file to use
 --dry-run             Perform a dry run.
 --release RELEASE     Override the discovered release from current
                       branch, which is used to determine the build
                       target and value of dist macro. Generally,
                       release is the name of a branch created in
                       your package repository. --release is an
                       alias of --dist, hence --release should be
                       used instead.
 --dist DIST           Deprecated. Use --release instead. You can
                       use --dist for a while for backward-
                       compatibility. It will be disabled in future
                       version.
 --module-name MODULE_NAME
                       Deprecated. Use combination of --name and
                       --namespace. Override the module name.
                       Otherwise it is discovered from: Git push
                       URL or Git URL (last part of path with .git
                       extension removed) or from name macro in
                       spec file. In that order.
 --name NAME           Override repository name. Use --namespace
                       option to change namespace. If not
                       specified, name is discovered from Git push
                       URL or Git URL (last part of path with .git
                       extension removed) or from Name macro in
                       spec file, in that order.
 --namespace NAMESPACE
                       The package repository namespace. If
                       omitted, default to rpms if namespace is
                       enabled.
 --user USER           Override the discovered user name
 --password PASSWORD   Password for Koji login
 --runas RUNAS         Run Koji commands as a different user
 --path PATH           Define the directory to work in (defaults to
                       cwd)
 --verbose, -v         Run with verbose debug output
 --debug, -d           Run with debug output
 -q                    Run quietly only displaying errors

Command Overview

rfpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait] [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-validation] [--skip-nvr-check] [--skip-tag] [--scratch] [--srpm [SRPM]]

Request build

rfpkg chain-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait] [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-validation] package [package ...]

Build current package in order with other packages

rfpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t] [-F FILE] [-p] [-s] [files ...]

Alias for commit

rfpkg clean [-h] [--dry-run] [-x]

Remove untracked files

rfpkg clog [-h] [--raw]

Make a clog file containing top changelog entry

rfpkg clone [-h] [--branches] [--branch BRANCH] [--anonymous] [--depth DEPTH] repo [clone_target] ...

Clone and checkout a repository

rfpkg co [-h] [--branches] [--branch BRANCH] [--anonymous] [--depth DEPTH] repo [clone_target] ...

Alias for clone

rfpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw] [-t] [-F FILE] [-p] [-s] [files ...]

Commit changes

rfpkg compile [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR] [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...

Local test rpmbuild compile

rfpkg container-build [-h] [--target TARGET] [--nowait] [--build-release BUILD_RELEASE] [--isolated] [--koji-parent-build KOJI_PARENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--skip-remote-rules-validation] [--skip-build] [--compose-id COMPOSE_ID [COMPOSE_ID ...]] [--signing-intent SIGNING_INTENT] [--repo-url URL [URL ...]] [--replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MANAGER:NAME:VERSION[:NEW_NAME] ...]]

Build a container

rfpkg container-build-setup [-h] (--get-autorebuild | --set-autorebuild {true,false})

set options for container-build

rfpkg copr-build [-h] [--config CONFIG] [--nowait] project

Build package in Copr

rfpkg diff [-h] [--cached] [files ...]

Show changes between commits, commit and working tree, etc

rfpkg flatpak-build [-h] [--target TARGET] [--nowait] [--build-release BUILD_RELEASE] [--isolated] [--koji-parent-build KOJI_PARENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--skip-remote-rules-validation] [--skip-build]

Build a Flatpak

rfpkg gimmespec [-h]

Print the spec file name

rfpkg gitbuildhash [-h] build

Print the git hash used to build the provided n-v-r

rfpkg giturl [-h]

Print the git url for building

rfpkg help [-h]

Show usage

rfpkg import [-h] [--skip-diffs] [--offline] srpm

Import srpm content into a module

rfpkg install [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR] [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] ...

Local test rpmbuild install

rfpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]

Run rpmlint against local spec and build output if present.

rfpkg list-side-tags [-h] [--mine | --user TAG_OWNER | --base-tag BASE_TAG]

List existing side-tags

rfpkg local [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR] [--arch ARCH] [--define DEFINE] [--md5] [--with BCOND_WITH] [--without BCOND_WITHOUT] ...

Local test rpmbuild binary

rfpkg mock-config [-h] [--target TARGET] [--arch ARCH]

Generate a mock config

rfpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean] [--no-cleanup-after] [--no-clean-all] [--with BCOND_WITH] [--without BCOND_WITHOUT] [--shell] [--enablerepo ENABLEREPO] [--disablerepo DISABLEREPO] [--enable-network] ...

Local test build using mock

rfpkg module-build [-h] [--watch] [--buildrequires name:stream] [--requires name:stream] [--optional key=value] [--file [FILE_PATH]] [--srpm SRPMS] [--scratch] [scm_url] [branch]

Build a module using MBS

rfpkg module-build-cancel [-h] build_id

Cancel an MBS module build

rfpkg module-build-info [-h] build_id

Show information of an MBS module build

rfpkg module-build-local [-h] [--file [FILE_PATH]] [--srpm SRPMS] [--stream [STREAM]] [--skip-tests] [--add-local-build N:S:V] [-s N:S] [--offline] [-r PATH]

Build a module locally using the mbs-manager command

rfpkg module-build-watch [-h] build_id [build_id ...]

Watch an MBS build

rfpkg module-overview [-h] [--unfinished] [--limit LIMIT] [--owner FAS_ID | --mine]

Shows an overview of MBS builds

rfpkg module-scratch-build [-h] [--watch] [--buildrequires name:stream] [--requires name:stream] [--optional key=value] [--file [FILE_PATH]] [--srpm SRPMS] [scm_url] [branch]

Build a scratch module using MBS

rfpkg new [-h]

Diff against last tag

rfpkg new-sources [-h] files [files ...]

Upload source files

rfpkg patch [-h] [--rediff] suffix

Create and add a gendiff patch file

rfpkg prep [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR] [--arch ARCH] [--define DEFINE] ...

Local test rpmbuild prep

rfpkg pull [-h] [--rebase] [--no-rebase]

Pull changes from the remote repository and update the working copy.

rfpkg push [-h] [--force]

Push changes to remote repository

rfpkg remove-side-tag [-h] TAG

Remove a side tag (without merging packages)

rfpkg request-side-tag [-h] [--base-tag BASE_TAG]

Create a new side tag

rfpkg retire [-h] reason

Retire a package

rfpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait] [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-validation] [--srpm [SRPM]]

Request scratch build

rfpkg sources [-h] [--outdir OUTDIR]

Download source files

rfpkg srpm [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR] [--arch ARCH] [--define DEFINE] [--md5] ...

Create a source rpm

rfpkg switch-branch [-h] [-l] [--fetch] [branch]

Work with branches

rfpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l] [-d] [tag]

Management of git tags

rfpkg unused-patches [-h]

Print list of patches not referenced by name in the specfile

rfpkg upload [-h] files [files ...]

Upload source files

rfpkg verify-files [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR] [--arch ARCH] [--define DEFINE] ...

Locally verify %%files section

rfpkg verrel [-h]

Print the name-version-release

Command Reference

rfpkg build

 usage: rfpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait]
                    [--target TARGET] [--background] [--fail-fast]
                    [--skip-remote-rules-validation]
                    [--skip-nvr-check] [--skip-tag] [--scratch]
                    [--srpm [SRPM]]
 
 This command requests a build of the package in the build system. By
 default it discovers the target to build for based on branch data,
 and uses the latest commit as the build source.
 
 optional arguments:
   -h, --help            show this help message and exit
   --arches [ARCHES ...]
                         Build for specific arches
   --md5                 Use md5 checksums (for older rpm hosts)
   --nowait              Don't wait on build
   --target TARGET       Define build target to build into
   --background          Run the build at a low priority
   --fail-fast           Fail the build immediately if any arch fails
   --skip-remote-rules-validation
                         Don't check if there's a valid gating.yaml
                         file in the repo, where you can define
                         additional policies for Greenwave gating.
   --skip-nvr-check      Submit build to buildsystem without check if
                         NVR was already built. NVR is constructed
                         locally and may be different from NVR
                         constructed during build on builder.
   --skip-tag            Do not attempt to tag package
   --scratch             Perform a scratch build
   --srpm [SRPM]         Build from an srpm. If no srpm is provided
                         with this option an srpm will be generated
                         from current module content.
 

rfpkg chain-build

 usage: rfpkg chain-build [-h] [--arches [ARCHES ...]] [--md5]
                          [--nowait] [--target TARGET] [--background]
                          [--fail-fast]
                          [--skip-remote-rules-validation]
                          package [package ...]
 
 Build current package in order with other packages.
 
 example: rfpkg chain-build libwidget libgizmo
 
 The current package is added to the end of the CHAIN list.
 Colons (:) can be used in the CHAIN parameter to define groups of
 packages.  Packages in any single group will be built in parallel
 and all packages in a group must build successfully and populate
 the repository before the next group will begin building.
 
 For example:
 
 rfpkg chain-build libwidget libaselib : libgizmo :
 
 will cause libwidget and libaselib to be built in parallel, followed
 by libgizmo and then the current directory package. If no groups are
 defined, packages will be built sequentially.
 
 positional arguments:
   package               List the packages and order you want to
                         build in
 
 optional arguments:
   -h, --help            show this help message and exit
   --arches [ARCHES ...]
                         Build for specific arches
   --md5                 Use md5 checksums (for older rpm hosts)
   --nowait              Don't wait on build
   --target TARGET       Define build target to build into
   --background          Run the build at a low priority
   --fail-fast           Fail the build immediately if any arch fails
   --skip-remote-rules-validation
                         Don't check if there's a valid gating.yaml
                         file in the repo, where you can define
                         additional policies for Greenwave gating.
 

rfpkg ci

 usage: rfpkg ci [-h] [-m MESSAGE] [--with-changelog] [-c] [--raw]
                 [-t] [-F FILE] [-p] [-s]
                 [files ...]
 
 Alias for commit.
 
 positional arguments:
   files                 Optional list of specific files to commit
 
 optional arguments:
   -h, --help            show this help message and exit
   -m MESSAGE, --message MESSAGE
                         Use the given <msg> as the commit message
                         summary
   --with-changelog      Get the last changelog from SPEC as commit
                         message content. This option must be used
                         with -m together.
   -c, --clog            Generate the commit message from the
                         Changelog section
   --raw                 Make the clog raw
   -t, --tag             Create a tag for this commit
   -F FILE, --file FILE  Take the commit message from the given file
   -p, --push            Commit and push as one action
   -s, --signoff         Include a signed-off-by
 

rfpkg clean

 usage: rfpkg clean [-h] [--dry-run] [-x]
 
 This command can be used to clean up your working directory. By
 default it will follow .gitignore rules.
 
 optional arguments:
   -h, --help     show this help message and exit
   --dry-run, -n  Perform a dry-run
   -x             Do not follow .gitignore rules
 

rfpkg clog

 usage: rfpkg clog [-h] [--raw]
 
 This will create a file named "clog" that contains the latest rpm
 changelog entry. The leading "- " text will be stripped.
 
 optional arguments:
   -h, --help  show this help message and exit
   --raw       Generate a more "raw" clog without twiddling the
               contents
 

rfpkg clone

 usage: rfpkg clone [-h] [--branches] [--branch BRANCH] [--anonymous]
                    [--depth DEPTH]
                    repo [clone_target] ...
 
 This command will clone the named repository from the configured
 repository base URL. By default it will also checkout the master
 branch for your working copy.
 
 positional arguments:
   repo                  Name of the repository to clone
   clone_target          Directory in which to clone the repository
   extra_args            Custom arguments that are passed to the 'git
                         clone'. Use '--' to separate them from other
                         arguments.
 
 optional arguments:
   -h, --help            show this help message and exit
   --branches, -B        Do an old style checkout with subdirs for
                         branches
   --branch BRANCH, -b BRANCH
                         Check out a specific branch
   --anonymous, -a       Check out a module anonymously
   --depth DEPTH         Create a shallow clone with a history
                         truncated to the specified number of commits
 

rfpkg co

 usage: rfpkg co [-h] [--branches] [--branch BRANCH] [--anonymous]
                 [--depth DEPTH]
                 repo [clone_target] ...
 
 Alias for clone.
 
 positional arguments:
   repo                  Name of the repository to clone
   clone_target          Directory in which to clone the repository
   extra_args            Custom arguments that are passed to the 'git
                         clone'. Use '--' to separate them from other
                         arguments.
 
 optional arguments:
   -h, --help            show this help message and exit
   --branches, -B        Do an old style checkout with subdirs for
                         branches
   --branch BRANCH, -b BRANCH
                         Check out a specific branch
   --anonymous, -a       Check out a module anonymously
   --depth DEPTH         Create a shallow clone with a history
                         truncated to the specified number of commits
 

rfpkg commit

 usage: rfpkg commit [-h] [-m MESSAGE] [--with-changelog] [-c]
                     [--raw] [-t] [-F FILE] [-p] [-s]
                     [files ...]
 
 This invokes a git commit. All tracked files with changes will be
 committed unless a specific file list is provided. $EDITOR will be
 used to generate a changelog message unless one is given to the
 command. A push can be done at the same time.
 
 positional arguments:
   files                 Optional list of specific files to commit
 
 optional arguments:
   -h, --help            show this help message and exit
   -m MESSAGE, --message MESSAGE
                         Use the given <msg> as the commit message
                         summary
   --with-changelog      Get the last changelog from SPEC as commit
                         message content. This option must be used
                         with -m together.
   -c, --clog            Generate the commit message from the
                         Changelog section
   --raw                 Make the clog raw
   -t, --tag             Create a tag for this commit
   -F FILE, --file FILE  Take the commit message from the given file
   -p, --push            Commit and push as one action
   -s, --signoff         Include a signed-off-by
 

rfpkg compile

 usage: rfpkg compile [-h] [--builddir BUILDDIR]
                      [--buildrootdir BUILDROOTDIR] [--arch ARCH]
                      [--define DEFINE] [--short-circuit] [--nocheck]
                      ...
 
 This command calls rpmbuild to compile the source. By default the
 prep and configure stages will be done as well, unless the short-
 circuit option is used.
 
 positional arguments:
   extra_args            Custom arguments that are passed to the
                         'rpmbuild'. Use '--' to separate them from
                         other arguments.
 
 optional arguments:
   -h, --help            show this help message and exit
   --builddir BUILDDIR   Define an alternate builddir
   --buildrootdir BUILDROOTDIR
                         Define an alternate buildrootdir
   --arch ARCH           Prep for a specific arch
   --define DEFINE       Pass custom macros to rpmbuild, may specify
                         multiple times
   --short-circuit       short-circuit compile
   --nocheck             nocheck compile
 

rfpkg container-build

 usage: rfpkg container-build [-h] [--target TARGET] [--nowait]
                              [--build-release BUILD_RELEASE]
                              [--isolated]
                              [--koji-parent-build KOJI_PARENT_BUILD]
                              [--scratch] [--arches [ARCHES ...]]
                              [--skip-remote-rules-validation]
                              [--skip-build]
                              [--compose-id COMPOSE_ID [COMPOSE_ID ...]]
                              [--signing-intent SIGNING_INTENT]
                              [--repo-url URL [URL ...]]
                              [--replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME]
                              [PKG_MANAGER:NAME:VERSION[:NEW_NAME]
                              ...]]
 
 Build a container
 
 optional arguments:
   -h, --help            show this help message and exit
   --target TARGET       Override the default target
   --nowait              Don't wait on build
   --build-release BUILD_RELEASE
                         Specify a release value for this build's NVR
   --isolated            Do not auto-increment the release value or
                         update additional tags in the registry. You
                         must use the --build-release argument
   --koji-parent-build KOJI_PARENT_BUILD
                         Specify a Koji NVR for the parent container
                         image. This will override the "FROM" value
                         in your Dockerfile.
   --scratch             Scratch build
   --arches [ARCHES ...]
                         Limit a scratch or a isolated build to an
                         arch. May have multiple arches.
   --skip-remote-rules-validation
                         Don't check if there's a valid gating.yaml
                         file in the repo
   --skip-build          Don't create build, but just modify settings
                         for autorebuilds
   --compose-id COMPOSE_ID [COMPOSE_ID ...]
                         ODCS composes used. Cannot be used with
                         --signing-intent
   --signing-intent SIGNING_INTENT
                         Signing intent of the ODCS composes.
   --repo-url URL [URL ...]
                         URLs of yum repo files
   --replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MANAGER:NAME:VERSION[:NEW_NAME] ...]
                         Cachito dependency replacement
 

rfpkg container-build-setup

 usage: rfpkg container-build-setup [-h]
                                    (--get-autorebuild | --set-autorebuild {true,false})
 
 set options for container-build.
 
 optional arguments:
   -h, --help            show this help message and exit
   --get-autorebuild     Get autorebuild value
   --set-autorebuild {true,false}
                         Turn autorebuilds on/off
 

rfpkg copr-build

 usage: rfpkg copr-build [-h] [--config CONFIG] [--nowait] project
 
 Build package in Copr.
 
 Note: you need to have set up correct api key. For more information
 see API KEY section of copr-cli(1) man page.
 
 positional arguments:
   project          Name of the project in format USER/PROJECT
 
 optional arguments:
   -h, --help       show this help message and exit
   --config CONFIG  Path to an alternative Copr configuration file
   --nowait         Don't wait on build
 

rfpkg diff

 usage: rfpkg diff [-h] [--cached] [files ...]
 
 Use git diff to show changes that have been made to tracked files.
 By default cached changes (changes that have been git added) will
 not be shown.
 
 positional arguments:
   files       Optionally diff specific files
 
 optional arguments:
   -h, --help  show this help message and exit
   --cached    View staged changes
 

rfpkg flatpak-build

 usage: rfpkg flatpak-build [-h] [--target TARGET] [--nowait]
                            [--build-release BUILD_RELEASE]
                            [--isolated]
                            [--koji-parent-build KOJI_PARENT_BUILD]
                            [--scratch] [--arches [ARCHES ...]]
                            [--skip-remote-rules-validation]
                            [--skip-build]
 
 Build a Flatpak
 
 optional arguments:
   -h, --help            show this help message and exit
   --target TARGET       Override the default target
   --nowait              Don't wait on build
   --build-release BUILD_RELEASE
                         Specify a release value for this build's NVR
   --isolated            Do not auto-increment the release value or
                         update additional tags in the registry. You
                         must use the --build-release argument
   --koji-parent-build KOJI_PARENT_BUILD
                         Specify a Koji NVR for the parent container
                         image. This will override the "FROM" value
                         in your Dockerfile.
   --scratch             Scratch build
   --arches [ARCHES ...]
                         Limit a scratch or a isolated build to an
                         arch. May have multiple arches.
   --skip-remote-rules-validation
                         Don't check if there's a valid gating.yaml
                         file in the repo
   --skip-build          Don't create build, but just modify settings
                         for autorebuilds
 

rfpkg gimmespec

 usage: rfpkg gimmespec [-h]
 
 Print the spec file name.
 
 optional arguments:
   -h, --help  show this help message and exit
 

rfpkg gitbuildhash

 usage: rfpkg gitbuildhash [-h] build
 
 This will show you the commit hash string used to build the provided
 build n-v-r
 
 positional arguments:
   build       name-version-release of the build to query.
 
 optional arguments:
   -h, --help  show this help message and exit
 

rfpkg giturl

 usage: rfpkg giturl [-h]
 
 This will show you which git URL would be used in a build command.
 It uses the git hashsum of the HEAD of the current branch (which may
 not be pushed).
 
 optional arguments:
   -h, --help  show this help message and exit
 

rfpkg help

 usage: rfpkg help [-h]
 
 Show usage.
 
 optional arguments:
   -h, --help  show this help message and exit
 

rfpkg import

 usage: rfpkg import [-h] [--skip-diffs] [--offline] srpm
 
 This will extract sources, patches, and the spec file from an srpm
 and update the current module accordingly. It will import to the
 current branch by default.
 
 positional arguments:
   srpm          Source rpm to import
 
 optional arguments:
   -h, --help    show this help message and exit
   --skip-diffs  Don't show diffs when import srpms
   --offline     Do not upload files into lookaside cache
 

rfpkg install

 usage: rfpkg install [-h] [--builddir BUILDDIR]
                      [--buildrootdir BUILDROOTDIR] [--arch ARCH]
                      [--define DEFINE] [--short-circuit] [--nocheck]
                      ...
 
 This will call rpmbuild to run the install section. All leading
 sections will be processed as well, unless the short-circuit option
 is used.
 
 positional arguments:
   extra_args            Custom arguments that are passed to the
                         'rpmbuild'. Use '--' to separate them from
                         other arguments.
 
 optional arguments:
   -h, --help            show this help message and exit
   --builddir BUILDDIR   Define an alternate builddir
   --buildrootdir BUILDROOTDIR
                         Define an alternate buildrootdir
   --arch ARCH           Prep for a specific arch
   --define DEFINE       Pass custom macros to rpmbuild, may specify
                         multiple times
   --short-circuit       short-circuit install
   --nocheck             nocheck install
 

rfpkg lint

 usage: rfpkg lint [-h] [--info] [--rpmlintconf RPMLINTCONF]
 
 Rpmlint can be configured using the --rpmlintconf/-r option or by
 setting a <pkgname>.rpmlintrc file in the working directory
 
 optional arguments:
   -h, --help            show this help message and exit
   --info, -i            Display explanations for reported messages
   --rpmlintconf RPMLINTCONF, -r RPMLINTCONF
                         Use a specific configuration file for
                         rpmlint
 

rfpkg list-side-tags

 usage: rfpkg list-side-tags [-h]
                             [--mine | --user TAG_OWNER | --base-tag BASE_TAG]
 
 List existing side-tags.
 
 optional arguments:
   -h, --help           show this help message and exit
   --mine               List only my side tags
   --user TAG_OWNER     List side tags created by this user
   --base-tag BASE_TAG  List only tags based on this base
 

rfpkg local

 usage: rfpkg local [-h] [--builddir BUILDDIR]
                    [--buildrootdir BUILDROOTDIR] [--arch ARCH]
                    [--define DEFINE] [--md5] [--with BCOND_WITH]
                    [--without BCOND_WITHOUT]
                    ...
 
 Locally test run of rpmbuild producing binary RPMs. The rpmbuild
 output will be logged into a file named
 .build-%{version}-%{release}.log
 
 positional arguments:
   extra_args            Custom arguments that are passed to the
                         'rpmbuild'. Use '--' to separate them from
                         other arguments.
 
 optional arguments:
   -h, --help            show this help message and exit
   --builddir BUILDDIR   Define an alternate builddir
   --buildrootdir BUILDROOTDIR
                         Define an alternate buildrootdir
   --arch ARCH           Prep for a specific arch
   --define DEFINE       Pass custom macros to rpmbuild, may specify
                         multiple times
   --md5                 Use md5 checksums (for older rpm hosts)
   --with BCOND_WITH     Enable configure option (bcond) for the
                         build
   --without BCOND_WITHOUT
                         Disable configure option (bcond) for the
                         build
 

rfpkg mock-config

 usage: rfpkg mock-config [-h] [--target TARGET] [--arch ARCH]
 
 This will generate a mock config based on the buildsystem target
 
 optional arguments:
   -h, --help       show this help message and exit
   --target TARGET  Override target used for config
   --arch ARCH      Override local arch
 

rfpkg mockbuild

 usage: rfpkg mockbuild [-h] [--root CONFIG] [--md5] [--no-clean]
                        [--no-cleanup-after] [--no-clean-all]
                        [--with BCOND_WITH] [--without BCOND_WITHOUT]
                        [--shell] [--enablerepo ENABLEREPO]
                        [--disablerepo DISABLEREPO]
                        [--enable-network]
                        ...
 
 This will use the mock utility to build the package for the
 distribution detected from branch information. This can be
 overridden using the global --release option. Your user must be in
 the local "mock" group.
 
 positional arguments:
   extra_args            Custom arguments that are passed to the
                         'mock'. Use '--' to separate them from other
                         arguments.
 
 optional arguments:
   -h, --help            show this help message and exit
   --root CONFIG, --mock-config CONFIG
                         Override mock configuration (like mock -r)
   --md5                 Use md5 checksums (for older rpm hosts)
   --no-clean, -n        Do not clean chroot before building package
   --no-cleanup-after    Do not clean chroot after building (if
                         automatic cleanup is enabled
   --no-clean-all, -N    Alias for both --no-clean and --no-cleanup-
                         after
   --with BCOND_WITH     Enable configure option (bcond) for the
                         build
   --without BCOND_WITHOUT
                         Disable configure option (bcond) for the
                         build
   --shell               Run commands interactively within chroot.
                         Before going into chroot, mockbuild needs to
                         run with --no-cleanup-after in advanced.
   --enablerepo ENABLEREPO
                         Pass enablerepo option to yum/dnf (may be
                         used more than once)
   --disablerepo DISABLEREPO
                         Pass disablerepo option to yum/dnf (may be
                         used more than once)
   --enable-network      Enable networking
 
 If config file for mock isn't found in the /etc/mock directory, a
 temporary config directory for mock is created and populated with a
 config file created with mock-config.
 

rfpkg module-build

 usage: rfpkg module-build [-h] [--watch]
                           [--buildrequires name:stream]
                           [--requires name:stream]
                           [--optional key=value]
                           [--file [FILE_PATH]] [--srpm SRPMS]
                           [--scratch]
                           [scm_url] [branch]
 
 Build a module using MBS
 
 positional arguments:
   scm_url               The module's SCM URL. This defaults to the
                         current repo.
   branch                The module's SCM branch. This defaults to
                         the current checked-out branch.
 
 optional arguments:
   -h, --help            show this help message and exit
   --watch, -w           Watch the module build
   --buildrequires name:stream
                         Buildrequires to override in the form of
                         "name:stream"
   --requires name:stream
                         Requires to override in the form of
                         "name:stream"
   --optional key=value  MBS optional arguments in the form of
                         "key=value". For example: 'rfpkg module-
                         build --optional
                         "reuse_components_from=<NSVC>"'. More
                         description including list of available
                         arguments here: https://pagure.io/fm-
                         orchestrator/
   --file [FILE_PATH]    The modulemd yaml file for module scratch
                         build.
   --srpm SRPMS          Include one or more srpms for module scratch
                         build.
   --scratch             Perform a scratch build
 

rfpkg module-build-cancel

 usage: rfpkg module-build-cancel [-h] build_id
 
 Cancel an MBS module build
 
 positional arguments:
   build_id    The ID of the module build to cancel
 
 optional arguments:
   -h, --help  show this help message and exit
 

rfpkg module-build-info

 usage: rfpkg module-build-info [-h] build_id
 
 Show information of an MBS module build
 
 positional arguments:
   build_id    The ID of the module build
 
 optional arguments:
   -h, --help  show this help message and exit
 

rfpkg module-build-local

 usage: rfpkg module-build-local [-h] [--file [FILE_PATH]]
                                 [--srpm SRPMS] [--stream [STREAM]]
                                 [--skip-tests]
                                 [--add-local-build N:S:V] [-s N:S]
                                 [--offline] [-r PATH]
 
 Build a module locally using the mbs-manager command
 
 optional arguments:
   -h, --help            show this help message and exit
   --file [FILE_PATH]    The module's modulemd yaml file. If not
                         specified, a yaml file with the same
                         basename as the name of the repository will
                         be used.
   --srpm SRPMS          Include one or more srpms for module build.
   --stream [STREAM]     The module's stream/SCM branch. This
                         defaults to the current checked-out branch.
   --skip-tests          Adds a macro for skipping the check section
   --add-local-build N:S:V
                         Import previously finished local module
                         builds into MBS in the format of name:stream
                         or name:stream:version
   -s N:S, --set-default-stream N:S
                         Set the default stream for given module
                         dependency in case there are multiple
                         streams to choose from.
   --offline             Builds module offline without any external
                         infrastructure
   -r PATH, --repository PATH
                         Full path to .repo file defining the base
                         module repository to use when --offline is
                         used.
 

rfpkg module-build-watch

 usage: rfpkg module-build-watch [-h] build_id [build_id ...]
 
 Watch an MBS build
 
 positional arguments:
   build_id    The ID of the module build to watch
 
 optional arguments:
   -h, --help  show this help message and exit
 

rfpkg module-overview

 usage: rfpkg module-overview [-h] [--unfinished] [--limit LIMIT]
                              [--owner FAS_ID | --mine]
 
 Shows an overview of MBS builds
 
 optional arguments:
   -h, --help      show this help message and exit
   --unfinished    Show unfinished module builds
   --limit LIMIT   The number of most recent module builds to display
   --owner FAS_ID  List only items of that owner
   --mine          Use current Kerberos name or username
 

rfpkg module-scratch-build

 usage: rfpkg module-scratch-build [-h] [--watch]
                                   [--buildrequires name:stream]
                                   [--requires name:stream]
                                   [--optional key=value]
                                   [--file [FILE_PATH]]
                                   [--srpm SRPMS]
                                   [scm_url] [branch]
 
 Build a scratch module using MBS
 
 positional arguments:
   scm_url               The module's SCM URL. This defaults to the
                         current repo.
   branch                The module's SCM branch. This defaults to
                         the current checked-out branch.
 
 optional arguments:
   -h, --help            show this help message and exit
   --watch, -w           Watch the module build
   --buildrequires name:stream
                         Buildrequires to override in the form of
                         "name:stream"
   --requires name:stream
                         Requires to override in the form of
                         "name:stream"
   --optional key=value  MBS optional arguments in the form of
                         "key=value". For example: 'rfpkg module-
                         build --optional
                         "reuse_components_from=<NSVC>"'. More
                         description including list of available
                         arguments here: https://pagure.io/fm-
                         orchestrator/
   --file [FILE_PATH]    The modulemd yaml file for module scratch
                         build.
   --srpm SRPMS          Include one or more srpms for module scratch
                         build.
 

rfpkg new

 usage: rfpkg new [-h]
 
 This will use git to show a diff of all the changes (even
 uncommitted changes) since the last git tag was applied.
 
 optional arguments:
   -h, --help  show this help message and exit
 

rfpkg new-sources

 usage: rfpkg new-sources [-h] files [files ...]
 
 This will upload new source file(s) to lookaside cache, and all file
 names listed in sources file will be replaced. .gitignore will be
 also updated with new uploaded file(s). Please remember to commit
 them.
 
 positional arguments:
   files
 
 optional arguments:
   -h, --help  show this help message and exit
 

rfpkg patch

 usage: rfpkg patch [-h] [--rediff] suffix
 
 Create and add a gendiff patch file.
 
 positional arguments:
   suffix      Look for files with this suffix to diff
 
 optional arguments:
   -h, --help  show this help message and exit
   --rediff    Recreate gendiff file retaining comments Saves old
               patch file with a suffix of ~
 
 Patch file will be named: package-version-suffix.patch and the file
 will be added to the repo index
 

rfpkg prep

 usage: rfpkg prep [-h] [--builddir BUILDDIR]
                   [--buildrootdir BUILDROOTDIR] [--arch ARCH]
                   [--define DEFINE]
                   ...
 
 Use rpmbuild to "prep" the sources (unpack the source archive(s) and
 apply any patches.)
 
 positional arguments:
   extra_args            Custom arguments that are passed to the
                         'rpmbuild'. Use '--' to separate them from
                         other arguments.
 
 optional arguments:
   -h, --help            show this help message and exit
   --builddir BUILDDIR   Define an alternate builddir
   --buildrootdir BUILDROOTDIR
                         Define an alternate buildrootdir
   --arch ARCH           Prep for a specific arch
   --define DEFINE       Pass custom macros to rpmbuild, may specify
                         multiple times
 

rfpkg pull

 usage: rfpkg pull [-h] [--rebase] [--no-rebase]
 
 This command uses git to fetch remote changes and apply them to the
 current working copy. A rebase option is available which can be used
 to avoid merges.
 
 optional arguments:
   -h, --help   show this help message and exit
   --rebase     Rebase the locally committed changes on top of the
                remote changes after fetching. This can avoid a merge
                commit, but does rewrite local history.
   --no-rebase  Do not rebase, overriding .git settings to the
                contrary
 
 See git pull --help for more details
 

rfpkg push

 usage: rfpkg push [-h] [--force]
 
 Push changes to remote repository.
 
 optional arguments:
   -h, --help   show this help message and exit
   --force, -f  Force push
 

rfpkg remove-side-tag

 usage: rfpkg remove-side-tag [-h] TAG
 
 Remove a side tag (without merging packages).
 
 positional arguments:
   TAG         name of tag to be deleted
 
 optional arguments:
   -h, --help  show this help message and exit
 

rfpkg request-side-tag

 usage: rfpkg request-side-tag [-h] [--base-tag BASE_TAG]
 
 Create a new side tag.
 
 optional arguments:
   -h, --help           show this help message and exit
   --base-tag BASE_TAG  name of base tag
 

rfpkg retire

 usage: rfpkg retire [-h] reason
 
 This command will remove all files from the repo, leave a
 dead.package file, push the changes and retire the package in pkgdb.
 
 positional arguments:
   reason      Reason for retiring the package
 
 optional arguments:
   -h, --help  show this help message and exit
 

rfpkg scratch-build

 usage: rfpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5]
                            [--nowait] [--target TARGET]
                            [--background] [--fail-fast]
                            [--skip-remote-rules-validation]
                            [--srpm [SRPM]]
 
 This command will request a scratch build of the package. Without
 providing an srpm, it will attempt to build the latest commit, which
 must have been pushed. By default all appropriate arches will be
 built.
 
 optional arguments:
   -h, --help            show this help message and exit
   --arches [ARCHES ...]
                         Build for specific arches
   --md5                 Use md5 checksums (for older rpm hosts)
   --nowait              Don't wait on build
   --target TARGET       Define build target to build into
   --background          Run the build at a low priority
   --fail-fast           Fail the build immediately if any arch fails
   --skip-remote-rules-validation
                         Don't check if there's a valid gating.yaml
                         file in the repo, where you can define
                         additional policies for Greenwave gating.
   --srpm [SRPM]         Build from an srpm. If no srpm is provided
                         with this option an srpm will be generated
                         from the current module content.
 

rfpkg sources

 usage: rfpkg sources [-h] [--outdir OUTDIR]
 
 Download source files
 
 optional arguments:
   -h, --help       show this help message and exit
   --outdir OUTDIR  Directory to download files into (defaults to
                    pwd)
 

rfpkg srpm

 usage: rfpkg srpm [-h] [--builddir BUILDDIR]
                   [--buildrootdir BUILDROOTDIR] [--arch ARCH]
                   [--define DEFINE] [--md5]
                   ...
 
 Create a source rpm
 
 positional arguments:
   extra_args            Custom arguments that are passed to the
                         'rpmbuild'. Use '--' to separate them from
                         other arguments.
 
 optional arguments:
   -h, --help            show this help message and exit
   --builddir BUILDDIR   Define an alternate builddir
   --buildrootdir BUILDROOTDIR
                         Define an alternate buildrootdir
   --arch ARCH           Prep for a specific arch
   --define DEFINE       Pass custom macros to rpmbuild, may specify
                         multiple times
   --md5                 Use md5 checksums (for older rpm hosts)
 

rfpkg switch-branch

 usage: rfpkg switch-branch [-h] [-l] [--fetch] [branch]
 
 This command can switch to a local git branch. If provided with a
 remote branch name that does not have a local match it will create
 one. It can also be used to list the existing local and remote
 branches.
 
 positional arguments:
   branch      Branch name to switch to
 
 optional arguments:
   -h, --help  show this help message and exit
   -l, --list  List both remote-tracking branches and local branches
   --fetch     Fetch new data from remote before switch
 

rfpkg tag

 usage: rfpkg tag [-h] [-f] [-m MESSAGE] [-c] [--raw] [-F FILE] [-l]
                  [-d]
                  [tag]
 
 This command uses git to create, list, or delete tags.
 
 positional arguments:
   tag                   Name of the tag
 
 optional arguments:
   -h, --help            show this help message and exit
   -f, --force           Force the creation of the tag
   -m MESSAGE, --message MESSAGE
                         Use the given <msg> as the tag message
   -c, --clog            Generate the tag message from the spec
                         changelog section
   --raw                 Make the clog raw
   -F FILE, --file FILE  Take the tag message from the given file
   -l, --list            List all tags with a given pattern, or all
                         if not pattern is given
   -d, --delete          Delete a tag
 

rfpkg unused-patches

 usage: rfpkg unused-patches [-h]
 
 Print list of patches not referenced by name in the specfile.
 
 optional arguments:
   -h, --help  show this help message and exit
 

rfpkg upload

 usage: rfpkg upload [-h] files [files ...]
 
 This command will upload new source file(s) to lookaside cache.
 Source file names are appended to sources file, and .gitignore will
 be also updated with new uploaded file(s). Please remember to commit
 them.
 
 positional arguments:
   files
 
 optional arguments:
   -h, --help  show this help message and exit
 

rfpkg verify-files

 usage: rfpkg verify-files [-h] [--builddir BUILDDIR]
                           [--buildrootdir BUILDROOTDIR]
                           [--arch ARCH] [--define DEFINE]
                           ...
 
 Locally run 'rpmbuild -bl' to verify the spec file's %files
 sections. This requires a successful run of 'rfpkg install' in
 advance.
 
 positional arguments:
   extra_args            Custom arguments that are passed to the
                         'rpmbuild'. Use '--' to separate them from
                         other arguments.
 
 optional arguments:
   -h, --help            show this help message and exit
   --builddir BUILDDIR   Define an alternate builddir
   --buildrootdir BUILDROOTDIR
                         Define an alternate buildrootdir
   --arch ARCH           Prep for a specific arch
   --define DEFINE       Pass custom macros to rpmbuild, may specify
                         multiple times
 

rfpkg verrel

 usage: rfpkg verrel [-h]
 
 Print the name-version-release.
 
 optional arguments:
   -h, --help  show this help message and exit
 

See Also

https://github.com/rpmfusion-infra/rfpkg

Info

2020-11-29 rpm-packager