SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from RedHat EL 7 rfpkg-1.26.3-1.el7.noarch.rpm

rfpkg

Section: rpm\-packager (1)
Updated: 2020-03-14
Index 

NAME

rfpkg - RPM Packaging utility 

SYNOPSIS

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

DESCRIPTION

rfpkgis 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 [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 [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 [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 [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 [ARCHES ...]]] [--skip-remote-rules-validation] [--skip-build] [--compose-id COMPOSE_ID [COMPOSE_ID ...]] [--signing-intent SIGNING_INTENT] [--repo-url URL [URL ...]]
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 [files ...]]
Show changes between commits, commit and working tree, etc
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 [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 [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 [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 [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 [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 [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
  
  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
  
  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 [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.
  
  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 [ARCHES ...]]]
                               [--skip-remote-rules-validation]
                               [--skip-build]
                               [--compose-id COMPOSE_ID [COMPOSE_ID ...]]
                               [--signing-intent SIGNING_INTENT]
                               [--repo-url URL [URL ...]]
  
  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 [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 or --repo-url
    --signing-intent SIGNING_INTENT
                          Signing intent of the ODCS composes.
    --repo-url URL [URL ...]
                          URLs of yum repo files
   

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 [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 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.
  
  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
  
  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.
  
  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-
       &nb