centpkg(1)

📦

version 0.11.0 · 5 versions

0.11.0 · fedora 43, fedora 44 (latest)
0.11.0 · epel 9
0.11.0 · epel 10
0.10.1 · fedora 43
0.10.3 · fedora 44

✨ NAME ✨

okay so bestie, we're reading the centpkg(1) page from the rpm-packager manual 💖 and the star of the show is:

centpkg — the RPM Packaging utility. that's it, that's the whole name. short, sweet, iconic 👑

🌸 SYNOPSIS 🌸

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

💫 DESCRIPTION 💫

centpkg is a script to interact with the RPM Packaging system. literally that's the summary and it's giving main character energy, no cap 💅

🎀 Global Options 🎀

these bad boys work no matter which command you're running, so let's get into it:

--config, -C CONFIG — tells it which config file to use, like handing it a lil note that says "use this one bestie" 📝
--dry-run — do a dry run. rehearsal mode, nothing actually goes down 🎭
--release RELEASE — overrides the release it discovered from the current branch, and that release is what decides the build target and the value of the dist macro. generally speaking, release = the name of a branch made in your package repository. heads up: --release is an alias of --dist, which is why --release is the one you should be using 🫶
--name NAME — override the repository name. use --namespace if you wanna change the namespace instead. if you don't specify it, the name gets discovered in this exact order: from the Git push URL, or from the Git URL (that's the last part of the path with the .git extension removed), or from the Name macro in the spec file 🌈
--namespace NAMESPACE — the package repository namespace. if you skip it, it defaults to rpms when 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, identity crisis but make it useful
--path PATH — define the directory to work in (defaults to cwd)
--verbose, -v — run with verbose debug output, for when you want the tea ☕
--debug, -d — run with debug output
-q — run quietly, only displaying errors 🤫
--user-config USER_CONFIG — specify a user config file to use

🛍️ COMMAND OVERVIEW 🛍️

here's the full lineup bestie, every single one, no skips 🎀

centpkg build — Request build 🔥

centpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait] [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-validation] [--skip-nvr-check] [--custom-user-metadata CUSTOM_USER_METADATA] [--skip-tag] [--scratch | --draft] [--srpm [SRPM]] [--srpm-mock] [--root CONFIG] [--rhel-target {exception,zstream,latest,none}]

centpkg chain-build — Build current package in order with other packages ⛓️

centpkg chain-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait] [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-validation] [--skip-nvr-check] [--custom-user-metadata CUSTOM_USER_METADATA] package [package ...]

centpkg ci — Alias for commit ✨

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

centpkg clean — Remove untracked files 🧹

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

centpkg clog — Make a clog file containing top changelog entry

centpkg clog [-h] [--raw]

centpkg clone — Clone and checkout a repository 🧬

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

centpkg co — Alias for clone ✨

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

centpkg commit — Commit changes 💾

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

centpkg compile — Local test rpmbuild compile 🔨

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

centpkg container-build — Build a container 📦

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

centpkg container-build-setup — set options for container-build ⚙️

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

centpkg copr-build — Build package in Copr 🏗️

centpkg copr-build [-h] [--config CONFIG] [--nowait] project ...

centpkg current-state — Show the phase and state of current dist-git branch - Internal Only 🚧

centpkg current-state [-h]

centpkg diff — Show changes between commits, commit and working tree, etc 👀

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

centpkg flatpak-build — Build a Flatpak 🦋

centpkg flatpak-build [-h] [--target TARGET] [--nowait] [--background] [--build-release BUILD_RELEASE] [--isolated] [--koji-parent-build KOJI_PARENT_BUILD] [--scratch] [--arches [ARCHES ...]] [--repo-url URL [URL ...]] [--signing-intent SIGNING_INTENT] [--skip-remote-rules-validation] [--skip-build]

centpkg fork — Create a new fork of the current repository 🍴

centpkg fork [-h]

centpkg gimmespec — Print the spec file name 📄

centpkg gimmespec [-h]

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

centpkg gitbuildhash [-h] build

centpkg giturl — Print the git url for building 🔗

centpkg giturl [-h]

centpkg help — Show usage 🙋

centpkg help [-h]

centpkg import — Import srpm content into a module 📥

centpkg import [-h] [--skip-diffs] [--offline] [--do-not-check-specfile-name] srpm

centpkg install — Local test rpmbuild install 🔧

centpkg install [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR] [--arch ARCH] [--define DEFINE] [--short-circuit] [--nocheck] [--with BCOND_WITH] [--without BCOND_WITHOUT] ...

centpkg lint — Run rpmlint against local spec and build output if present. 🧼

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

centpkg list-side-tags — List existing side-tags 🏷️

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

centpkg local — Local test rpmbuild binary 🧪

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

centpkg mock-config — Generate a mock config 🛠️

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

centpkg mockbuild — Local test build using mock 🧱

centpkg 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] [--srpm-mock] [--use-koji-mock-config | --use-local-mock-config] [--default-mock-resultdir] [--extra-pkgs [EXTRA_PKGS ...]] ...

centpkg module-build — Build a module using MBS 🧩

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

centpkg module-build-cancel — Cancel an MBS module build 🛑

centpkg module-build-cancel [-h] build_id

centpkg module-build-info — Show information of an MBS module build ℹ️

centpkg module-build-info [-h] build_id

centpkg module-build-local — Build a module locally using the mbs-manager command 🏠

centpkg 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]

centpkg module-build-watch — Watch an MBS build 👁️

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

centpkg module-overview — Shows an overview of MBS builds 🗺️

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

centpkg module-scratch-build — Build a scratch module using MBS ✨

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

centpkg new — Diff against last tag 🆕

centpkg new [-h]

centpkg new-sources — Upload source files ⬆️

centpkg new-sources [-h] [--offline] files [files ...]

centpkg patch — Create and add a gendiff patch file 🩹

centpkg patch [-h] [--rediff] suffix

centpkg pre-push-check — Check whether the eventual "git push" command could proceed 🚦

centpkg pre-push-check [-h] [ref]

centpkg prep — Local test rpmbuild prep 📋

centpkg prep [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR] [--arch ARCH] [--define DEFINE] [--check-deps] ...

centpkg pull — Pull changes from the remote repository and update the working copy. ⬇️

centpkg pull [-h] [--rebase] [--no-rebase]

centpkg push — Push changes to remote repository 🚀

centpkg push [-h] [--force] [--no-verify]

centpkg remote — Operations with tracked repositories ('remotes'). This is an experimental interface. 🧪

centpkg remote [-h] {add} ...

centpkg remove-side-tag — Remove a side tag (without merging packages) 🗑️

centpkg remove-side-tag [-h] TAG

centpkg request-gated-side-tag — Create a new dynamic gated side tag 🚪

centpkg request-gated-side-tag [-h] [--base-tag BASE_TAG]

centpkg request-side-tag — Create a new side tag 🏷️

centpkg request-side-tag [-h] [--base-tag BASE_TAG] [--suffix SUFFIX]

centpkg retire — Retire a package/module 🫡

centpkg retire [-h] reason

centpkg scratch-build — Request scratch build ✨

centpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5] [--nowait] [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-validation] [--skip-nvr-check] [--custom-user-metadata CUSTOM_USER_METADATA] [--srpm [SRPM]] [--srpm-mock] [--root CONFIG]

centpkg sources — Download source files 📦

centpkg sources [-h] [--outdir OUTDIR] [--force] [--offline]

centpkg srpm — Create a source rpm 🥚

centpkg srpm [-h] [--builddir BUILDDIR] [--buildrootdir BUILDROOTDIR] [--arch ARCH] [--define DEFINE] [--md5] [--srpm-mock] [--no-clean] [--no-cleanup-after] [--no-clean-all] [--offline] [--root CONFIG] ...

centpkg switch-branch — Work with branches 🌿

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

centpkg tag — Management of git tags 🏷️

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

centpkg unused-patches — Print list of patches not referenced by name in the specfile 🔍

centpkg unused-patches [-h]

centpkg upload — Upload source files ⬆️

centpkg upload [-h] [--offline] files [files ...]

centpkg verify-files — Locally verify %%files section ✅

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

centpkg verrel — Print the name-version-release. 🔢

centpkg verrel [-h]

👑 COMMAND REFERENCE 👑

now we get into the juicy part, one command at a time, and bestie we are only at the beginning 😭

💅 centpkg build

usage: centpkg build [-h] [--arches [ARCHES ...]] [--md5] [--nowait] [--target TARGET] [--background] [--fail-fast] [--skip-remote-rules-validation] [--skip-nvr-check] [--custom-user-metadata CUSTOM_USER_METADATA] [--skip-tag] [--scratch | --draft] [--srpm [SRPM]] [--srpm-mock] [--root CONFIG] [--rhel-target {exception,zstream,latest,none}]

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 it uses the latest commit as the build source. so it's out here doing detective work on your branch and then shipping your newest commit off to get built 🔥

okay so we are nowhere near done, the rest of this command reference is literally still loading — do not touch that dial bestie 🌈

centpkg now sets the rhel metadata with --rhel-target. The choices, bestie, are:

exception — this will build for the current in-development Y-stream release. It's equivalent to passing latest when you're not in the Blocker and Exception Phase.
zstream — if pre-GA of a y-stream release, this will build for 0day. If post-GA of a Y-stream release, this will build for the Z-stream of that release. ✨
latest — this will always build for the next Y-stream release.
none — this will not build in brew. No rhel metadata is set. 💀

And here's the options roster for centpkg build:

-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.
--custom-user-metadata CUSTOM_USER_METADATA — Provide a JSON string of custom metadata to be deserialized and stored under the build's extra.custom_user_metadata field
--skip-tag — Do not attempt to tag package
--scratch — Perform a scratch build
--draft — Perform a draft build
--srpm [SRPM] — Build from an srpm. If no srpm is provided with this option an srpm will be generated from current module content.
--srpm-mock — Build from an srpm. Source rpm will be generated in 'mock' instead of 'rpmbuild'.
--root, --mock-config, -r CONFIG — Override mock configuration (like mock -r)
--rhel-target {exception,zstream,latest,none} — Set the rhel-target metadata

🌈 `centpkg chain-build`

usage: centpkg chain-build [-h] [--arches [ARCHES ...]] [--md5]
                           [--nowait] [--target TARGET]
                           [--background] [--fail-fast]
                           [--skip-remote-rules-validation]
                           [--skip-nvr-check]
                           [--custom-user-metadata
CUSTOM_USER_METADATA]
                           package [package ...]

Build current package in order with other packages. Chain gang energy, honestly. 👑

example: centpkg 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:

centpkg 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. No cap. 💅

positional arguments:

package — List the packages and order you want to build in

options:

-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.
--custom-user-metadata CUSTOM_USER_METADATA — Provide a JSON string of custom metadata to be deserialized and stored under the build's extra.custom_user_metadata field

✨ `centpkg ci`

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

Alias for commit. That's it, that's the whole vibe. 🎀

positional arguments:

files — Optional list of specific files to commit

options:

-h, --help — show this help message and exit
-m, --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 — Take the commit message from the given file
-p, --push — Commit and push as one action
-s, --signoff — Include a signed-off-by

🧹 `centpkg clean`

usage: centpkg clean [-h] [--dry-run] [-x]

This command can be used to clean up your working directory. By default it will follow .gitignore rules. Patterns listed in .git/info/exclude won't be removed either. It's giving spring cleaning but for your repo, fr fr. 🌸

options:

-h, --help — show this help message and exit
--dry-run, -n — Perform a dry-run
-x — Do not follow .gitignore and .git/info/exclude rules

📝 `centpkg clog`

usage: centpkg clog [-h] [--raw]

This will create a file named "clog" that contains the latest rpm changelog entry. The leading "- " text will be stripped.

options:

-h, --help — show this help message and exit
--raw — Generate a more "raw" clog without twiddling the contents

🦋 `centpkg clone`

usage: centpkg 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. It should not be a Git URL. Should be 'namespace/repo-name' in case of namespaced dist-git. Otherwise, just 'repo-name'. Namespace examples are 'rpms', 'container', 'modules', 'flatpaks'. Default namespace 'rpms' can be ignored.
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.

options:

-h, --help — show this help message and exit
--branches, -B — Do an old style checkout with subdirs for branches
--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

💜 `centpkg co`

usage: centpkg co [-h] [--branches] [--branch BRANCH] [--anonymous]
                  [--depth DEPTH]
                  repo [clone_target] ...

Alias for clone. Short king behaviour. 👑

positional arguments:

repo — Name of the repository to clone. It should not be a Git URL. Should be 'namespace/repo-name' in case of namespaced dist-git. Otherwise, just 'repo-name'. Namespace examples are 'rpms', 'container', 'modules', 'flatpaks'. Default namespace 'rpms' can be ignored.
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.

options:

-h, --help — show this help message and exit
--branches, -B — Do an old style checkout with subdirs for branches
--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

💖 `centpkg commit`

usage: centpkg 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. Iconic, honestly. 🫶

positional arguments:

files — Optional list of specific files to commit
-h, --help — bestie classic 💅 pops the help message and dips, that's it.
-m, --message MESSAGE — drop the given <msg> in as your commit message summary. that's the headline, the vibe, the whole point.
--with-changelog — yoinks the last changelog entry out of the SPEC and uses it as the commit message content. ⚠️ this one is not a solo act — it has to be used with -m together, periodt.
-c, --clog — generates the commit message straight from the Changelog section. iconic behavior.
--raw — makes the clog raw. no filter, no styling, just raw.
-t, --tag — creates a tag for this commit. leave a lil souvenir. 🎀
-F, --file FILE — takes the commit message from the given file instead. file girlies rise.
-p, --push — commits and pushes as one action. one move, two jobs, efficiency queen 👑
-s, --signoff — includes a signed-off-by. add your signature, you deserve the credit. ✨

🛠️ `centpkg compile`

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

okay so this one literally calls rpmbuild to compile the source. and by default it's doing the whole prep + configure stages too, unless you hit it with the short-circuit option and skip all that. no cap.

positional arguments:

extra_args — custom arguments that get passed straight to rpmbuild. use -- to separate them from other arguments. (iykyk, that -- is doing a LOT of heavy lifting)

options:

-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, and yes you can specify this multiple times 🫶
--short-circuit — short-circuit compile. skipping straight to it.
--nocheck — nocheck compile

🐳 `centpkg container-build`

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

build a container. that's the whole pitch, bestie.

options:

-h, --help — show this help message and exit
--target TARGET — override the default target
--nowait — don't wait on build. set it and ghost it 👻
--background — run the build at a lower priority
--build-release BUILD_RELEASE — specify a release value for this build's NVR
--isolated — do not update floating tags in the registry. ⚠️ you must use the --build-release argument with this one, no exceptions.
--koji-parent-build KOJI_PARENT_BUILD — specify a Koji NVR for the parent container image. this overrides 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.
--repo-url URL [URL ...] — URLs of yum repo files
--signing-intent SIGNING_INTENT — the signing intent of the ODCS composes. if you specify it, it must be one of the signing intent names configured on the OSBS server. if you don't, the server will use the signing intent of the compose_ids you specify, or the server's default_signing_intent. to view the full list of possible names, see atomic_reactor.config in osbs-build.log.
--skip-remote-rules-validation — don't check if there's a valid gating.yaml file in the repo. rules? skipped. validation? gone. 🙈
--skip-build — don't create build, but just modify settings for autorebuilds
--compose-id COMPOSE_ID [COMPOSE_ID ...] — existing ODCS composes to use (specify integers). OSBS will not generate new ODCS composes. ⚠️ cannot be used with --signing-intent.
--replace-dependency PKG_MANAGER:NAME:VERSION[:NEW_NAME] [PKG_MANAGER:NAME:VERSION[:NEW_NAME] ...] — Cachito dependency replacement

⚙️ `centpkg container-build-setup`

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

set options for container-build. it's the settings panel, basically.

options:

-h, --help — show this help message and exit
--get-autorebuild — get autorebuild value
--set-autorebuild {true,false} — turn autorebuilds on/off. literally a light switch. 🦋

🏗️ `centpkg copr-build`

centpkg 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
extra_args — custom arguments that are passed to the copr-cli. use -- to separate them from other arguments.

options:

-h, --help — show this help message and exit
--config CONFIG — path to an alternative Copr configuration file
--nowait — don't wait on build

🔍 `centpkg current-state`

centpkg current-state [-h]

show the phase and state of current dist-git branch — Internal Only. that's the whole thing, she's mysterious like that. 💜

options:

-h, --help — show this help message and exit

🔀 `centpkg diff`

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

uses git diff to show you the changes that have been made to tracked files. and heads up: by default, cached changes (aka the ones you've already git add-ed) will not be shown. sneaky of them fr.

positional arguments:

files — optionally diff specific files

options:

-h, --help — show this help message and exit
--cached — view staged changes. there they are 👀

📦 `centpkg flatpak-build`

centpkg flatpak-build [-h] [--target TARGET] [--nowait]
                                      [--background]
                                      [--build-release BUILD_RELEASE]
                                      [--isolated]
                                      [--koji-parent-build KOJI_PARENT_BUILD]
                                      [--scratch] [--arches [ARCHES ...]]
                                      [--repo-url URL [URL ...]]
                                      [--signing-intent SIGNING_INTENT]
                                      [--skip-remote-rules-validation]
                                      [--skip-build]

build a Flatpak. 💅

options:

-h, --help — show this help message and exit
--target TARGET — override the default target
--nowait — don't wait on build
--background — run the build at a lower priority
--build-release BUILD_RELEASE — specify a release value for this build's NVR
--isolated — do not update floating tags in the registry. ⚠️ you must use the --build-release argument here too, same deal.
--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.
--repo-url URL [URL ...] — URLs of yum repo files
--signing-intent SIGNING_INTENT — signing intent of the ODCS composes. if specified, this must be one of the signing intent names configured on the OSBS server. if unspecified, the server will use the signing intent of the compose_ids you specify, or the server's default_signing_intent. to view the full list of possible names, see atomic_reactor.config in osbs-build.log.
--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

🍴 `centpkg fork`

centpkg fork [-h]

create a new fork of the current repository. 🫶

before the operation, you need to generate an API token at https://gitlab.com/-/user_settings/personal_access_tokens, select the "api" scope and save it in your local user configuration located at ~/.config/rpkg/centpkg.conf. for example:

[centpkg.distgit]
token = <api_key_here>

below is a basic example of the command to fork a current repository:

centpkg fork

options:

-h, --help — show this help message and exit

🎀 `centpkg gimmespec`

centpkg gimmespec [-h]

print the spec file name. she said gimme and she meant it. ✨

options:

-h, --help — show this help message and exit

🧚 `centpkg gitbuildhash`

centpkg gitbuildhash [-h] build

this will show you the commit hash string used to build the provided build n-v-r. receipts, basically.

positional arguments:

build — name-version-release of the build to query.

options:

-h, --help — show this help message and exit

🔗 `centpkg giturl`

centpkg 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). ⚠️ yes bestie, that's the unpushed one — it's still counting it.

options:

-h, --help — show this help message and exit

💖 `centpkg help`

centpkg help [-h]

show usage. short, sweet, helpful. that's the whole vibe. 🌸

-h, --help — show this help message and exit

…and that's a wrap on the previous command's flags, bestie 💅 now let's keep the tour going.

centpkg import 💖

centpkg import [-h] [--skip-diffs] [--offline]
               [--do-not-check-specfile-name]
               srpm

okay so this is the "unbox an srpm and move its whole life into my repo" command ✨ It pulls the sources, the patches, and the spec file out of an srpm and updates your current module to match. By default it imports into whatever branch you're standing on right now. No drama, no extra steps 🌸

Positional arguments:

srpm — the source rpm you want to import 🎀

Options:

-h, --help — show this help message and exit
--skip-diffs — don't show diffs when import srpms (yes, if you're the kind of person who doesn't want the receipts, this is your flag 🙈)
--offline — do not upload files into the lookaside cache 🚫
--do-not-check-specfile-name — skip the check for whether the specfile inside the SRPM matches the repository name 👑

centpkg install 🛠️

centpkg install [-h] [--builddir BUILDDIR]
                [--buildrootdir BUILDROOTDIR] [--arch ARCH]
                [--define DEFINE] [--short-circuit]
                [--nocheck] [--with BCOND_WITH]
                [--without BCOND_WITHOUT]
                ...

This one calls rpmbuild to run the install section, and it's giving "I want the middle of the build, not the whole thing" energy 🔥 All the leading sections get processed too, unless you use the short-circuit option — then it's straight to the good part, no cap.

Positional arguments:

extra_args — custom arguments that are passed to the rpmbuild. Use -- to separate them from other arguments 🫶

Options:

-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 (stack 'em up 💅)
--short-circuit — short-circuit install
--nocheck — nocheck install
--with BCOND_WITH — enable configure option (bcond) for the build
--without BCOND_WITHOUT — disable configure option (bcond) for the build

centpkg lint 🔍

centpkg 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 🎀 Both routes are valid, pick your fighter.

Options:

-h, --help — show this help message and exit
--info, -i — display explanations for reported messages (so you actually understand the yelling 🫶)
--rpmlintconf, -r RPMLINTCONF — use a specific configuration file for rpmlint

centpkg list-side-tags 🏷️

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

List existing side-tags. That's it, that's the whole vibe — a little inventory check of what's out there ✨

Options:

-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

Heads up: those three options are mutually exclusive — it's a | situation, so you pick one and commit to it, main character energy only 👑

centpkg local 🌈

centpkg 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 gets logged into a file named .build-%{version}-%{release}.log — so if something goes feral, the receipts are right there in that file, iykyk.

Positional arguments:

extra_args — custom arguments that are passed to the rpmbuild. Use -- to separate them from other arguments 🫶

Options:

-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

centpkg mock-config 🧪

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

This will generate a mock config based on the buildsystem target ✨ Basically it manifests the config file you need.

Options:

-h, --help — show this help message and exit
--target TARGET — override target used for config
--arch ARCH — override local arch

centpkg mockbuild 📦

centpkg 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] [--srpm-mock]
                  [--use-koji-mock-config |
                  --use-local-mock-config]
                  [--default-mock-resultdir]
                  [--extra-pkgs [EXTRA_PKGS ...]]
                  ...

This will use the mock utility to build the package for the distribution detected from branch information 🌸 You can override that with the global --release option if you want to be extra. Your user must be in the local "mock" group — no group, no build, periodt 💀

Positional arguments:

extra_args — custom arguments that are passed to the mock. Use -- to separate them from other arguments 🫶

Options:

-h, --help — show this help message and exit
--root, --mock-config, -r 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 🌐
--srpm-mock — generate source rpm with mock and then run mockbuild using this source rpm
--use-koji-mock-config — download Mock configuration from Kojihub, instead of using the local Mock configuration in mock-core-configs.rpm 👑
--use-local-mock-config — enforce use of local Mock configuration
--default-mock-resultdir — don't modify Mock resultdir
--extra-pkgs [EXTRA_PKGS ...] — install additional packages into chroot

Also, lowkey important: if a 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 🫶 so it's not just gonna give up on you.

centpkg module-build 🧩

centpkg 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 💖 the big one, the group project, the moment.

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

Options:

-h, --help — show this help message and exit
--watch, -w — watch the module build 👀 (yes, staring at it is a supported workflow)
--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: 'centpkg 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

centpkg module-build-cancel 🚫

centpkg module-build-cancel [-h] build_id

Cancel an MBS module build 💀 sometimes you just gotta call it.

Positional arguments:

build_id — the ID of the module build to cancel

Options:

-h, --help — show this help message and exit

centpkg module-build-info 🔎

centpkg module-build-info [-h] build_id

Show information of an MBS module build ✨ the "so what happened with that build" command.

Positional arguments:

build_id — the ID of the module build

Options:

-h, --help — show this help message and exit

centpkg module-build-local 🏠

centpkg 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 💅

options 💅

-h, --help — shows this help message and exits, king behavior ✨
--file [FILE_PATH] — the module's modulemd yaml file. If you don't give one, it just uses a yaml file with the same basename as the name of the repository 🗂️
--srpm SRPMS — include one or more srpms for the module build 💖
--stream [STREAM] — the module's stream/SCM branch. Defaults to the current checked-out branch, no cap 🌿
--skip-tests — adds a macro for skipping the check section 🙈
--add-local-build N:S:V — import previously finished local module builds into MBS, formatted as name:stream or name:stream:version 📦
-s, --set-default-stream N:S — set the default stream for a given module dependency, for when there are multiple streams to choose from 👑
--offline — builds the module offline, without any external infrastructure ✈️
-r, --repository PATH — full path to the .repo file defining the base module repository to use when --offline is used 🔌

centpkg module-build-watch 👀

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

Watch an MBS build. Literally just sit there and stare at it, bestie 🍿

positional arguments:

build_id — the ID of the module build to watch

options:

-h, --help — show this help message and exit

centpkg module-overview 🌈

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

Shows an overview of MBS builds. The receipts, basically 💅

options:

-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 🙋‍♀️

centpkg module-scratch-build 🧪

centpkg 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 🌿

options:

-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: 'centpkg module-build --optional "reuse_components_from=<NSVC>"'. More description, including a list of available arguments, lives 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 📦

centpkg new 🆕

centpkg new [-h]

This will use git to show a diff of all the changes (even uncommitted changes) since the last git tag was applied 🔍

options:

-h, --help — show this help message and exit

centpkg new-sources 🌸

centpkg new-sources [-h] [--offline] files [files ...]

This will upload new source file(s) to the lookaside cache, and all file names listed in the sources file will be replaced. .gitignore will be also updated with the new uploaded file(s). Please remember to commit them, fr fr 🙏

positional arguments:

files

options:

-h, --help — show this help message and exit
--offline — do all the steps except uploading into the lookaside cache ✈️

centpkg patch 🩹

centpkg patch [-h] [--rediff] suffix

Create and add a gendiff patch file ✨

positional arguments:

suffix — look for files with this suffix to diff

options:

-h, --help — show this help message and exit
--rediff — recreate gendiff file retaining comments. Saves old patch file with a suffix of ~ ♻️

The patch file will be named: package-version-suffix.patch, and the file will be added to the repo index 💾

centpkg pre-push-check 🚦

centpkg pre-push-check [-h] [ref]

Performs a few checks of the repository before pushing changes. The "git push" command itself is not part of this check 🙅‍♀️

Checks include:

parse specfile for source files and verifies it is noted also in the 'sources' file 📝
verifies, that all source files from the 'sources' file were uploaded to the lookaside cache ☁️

Checks can be performed manually by executing the 'pre-push-check' command. But originally, it is designed to be executed automatically right before the 'git push' command is started. Every time the 'git push' command is executed, the 'pre-push' hook script runs first 🏃‍♀️

Path: <repository_directory>/.git/hooks/pre-push 📁

This hook script is created after a new repository is cloned. Previously created repositories don't contain this hook script 💀

To disable these checks, remove the hook script ✂️

positional arguments:

ref — reference to the commit that will be checked. Accepts a hash or reference, for example 'refs/heads/f37'

options:

-h, --help — show this help message and exit

centpkg prep 🔧

centpkg prep [-h] [--builddir BUILDDIR]
             [--buildrootdir BUILDROOTDIR] [--arch ARCH]
             [--define DEFINE] [--check-deps]
             ...

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 🧷

options:

-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 🔁
--check-deps — check dependencies. Not checked by default 👀

centpkg pull ⬇️

centpkg 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 🫶

options:

-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 it does rewrite local history ⚠️
--no-rebase — do not rebase, overriding .git settings to the contrary 🙅‍♀️

See git pull --help for more details 📖

centpkg push ⬆️

centpkg push [-h] [--force] [--no-verify]

Push changes to the remote repository 🚀

options:

-h, --help — show this help message and exit
--force, -f — force push 💥
--no-verify — bypass the pre-push hook script. No check of the branch will prevent the push 🙈

centpkg remote 🌐

centpkg remote [-h] {add} ...

Operations with tracked repositories ('remotes'). This is an experimental interface 🧪

options:

-h, --help — show this help message and exit

subcommands:

Operations with tracked repositories ('remotes'). This is an experimental interface. Please note that some or all current functionality is subject to change 👀. Without parameters, a list of remotes will be shown.

{add}

centpkg remove-side-tag 🗑️

centpkg remove-side-tag [-h] TAG

Remove a side tag (without merging packages) ✂️

positional arguments:

TAG — name of tag to be deleted

options:

-h, --help — show this help message and exit

centpkg request-gated-side-tag 🚪

centpkg request-gated-side-tag [-h] [--base-tag BASE_TAG]

Create a new dynamic gated side tag ✨

options:

-h, --help — show this help message and exit
--base-tag BASE_TAG — name of base tag

centpkg request-side-tag 🏷️

centpkg request-side-tag [-h] [--base-tag BASE_TAG]
                         [--suffix SUFFIX]

Create a new side tag 🎀

options:

-h, --help — show this help message and exit
--base-tag BASE_TAG — name of base tag
--suffix SUFFIX — a suffix to be appended to the side tag name. The suffix must be allowed in Koji configuration ✅

centpkg retire 🪦

centpkg retire [-h] reason

This command will remove all files from the repo, leave a dead.package file for rpms or a dead.module file for modules, and push the changes 💀

positional arguments:

reason — reason for retiring the package/module

options:

-h, --help — show this help message and exit

centpkg scratch-build 🔥

centpkg scratch-build [-h] [--arches [ARCHES ...]] [--md5]
                      [--nowait] [--target TARGET]
                      [--background] [--fail-fast]
                      [--skip-remote-rules-validation]
                      [--skip-nvr-check]
                      [--custom-user-metadata CUSTOM_USER_METADATA]
                      [--srpm [SRPM]] [--srpm-mock]
                      [--root CONFIG]

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 🛠️

…and the rest of the options for that one, bestie, no skips no gaps 💖

-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.
--custom-user-metadata CUSTOM_USER_METADATA — Provide a JSON string of custom metadata to be deserialized and stored under the build's extra.custom_user_metadata field
--srpm [SRPM] — Build from an srpm. If no srpm is provided with this option an srpm will be generated from the current module content.
--srpm-mock — Build from an srpm. Source rpm will be generated in 'mock' instead of 'rpmbuild'.
--root, --mock-config, -r CONFIG — Override mock configuration (like mock -r)

🌸 centpkg sources 🌸

the little source-grabber, she's so real for this 💅

centpkg sources [-h] [--outdir OUTDIR] [--force] [--offline]

Download source files

✨ options ✨

-h, --help — show this help message and exit
--outdir OUTDIR — Directory to download files into (defaults to pwd)
--force — Download all sources, even if unused or otherwise excluded by default.
--offline — Don't connect to the Koji and try to work offline

🎀 centpkg srpm 🎀

Create a source rpm

This command wraps "rpmbuild -bs", roughly equivalent to:

rpmbuild -bs mypackage.spec       --define "_topdir ."
   --define "_sourcedir ."       --define "_srcrpmdir ."       --define
   "dist .el8"

ok so, listen: to include files in the SRPM, the files must be in the current working directory (this depends on the package layout used), and you must reference each file with SourceXXXX: or PatchXXXX: directives in your .spec file. no shortcuts, bestie 😭

centpkg srpm [-h] [--builddir BUILDDIR]
             [--buildrootdir BUILDROOTDIR] [--arch ARCH]
             [--define DEFINE] [--md5] [--srpm-mock]
             [--no-clean] [--no-cleanup-after]
             [--no-clean-all] [--offline] [--root CONFIG]
             ...

🌟 positional arguments 🌟

extra_args — Custom arguments that are passed to the 'rpmbuild'. Use '--' to separate them from other arguments.

✨ options ✨

-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)
--srpm-mock — Create source rpm in 'mock' instead of 'rpmbuild'
--no-clean, -n — Only for --srpm-mock: Do not clean chroot before building package
--no-cleanup-after — Only for --srpm-mock: Do not clean chroot after building if automatic cleanup is enabled
--no-clean-all, -N — Only for --srpm-mock: Alias for both --no-clean and --no-cleanup-after
--offline — Don't connect to the Koji and try to work offline
--root, --mock-config, -r CONFIG — Override mock configuration (like mock -r)

🦋 centpkg switch-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.

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

🌟 positional arguments 🌟

branch — Branch name to switch to

✨ options ✨

-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

💜 centpkg tag 💜

This command uses git to create, list, or delete tags.

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

🌟 positional arguments 🌟

tag — Name of the tag

✨ options ✨

-h, --help — show this help message and exit
-f, --force — Force the creation of the tag
-m, --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 — 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

🍓 centpkg unused-patches 🍓

Print list of patches not referenced by name in the specfile.

centpkg unused-patches [-h]

✨ options ✨

-h, --help — show this help message and exit

🧚 centpkg upload 🧚

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.

centpkg upload [-h] [--offline] files [files ...]

🌟 positional arguments 🌟

files

✨ options ✨

-h, --help — show this help message and exit
--offline — Do all the steps except uploading into lookaside cache

🌈 centpkg verify-files 🌈

Locally run 'rpmbuild -bl' to verify the spec file's %files sections. This requires a successful run of 'centpkg install' in advance.

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

🌟 positional arguments 🌟

extra_args — Custom arguments that are passed to the 'rpmbuild'. Use '--' to separate them from other arguments.

✨ options ✨

-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

⭐ centpkg verrel ⭐

Print the name-version-release.

centpkg verrel [-h]

✨ options ✨

-h, --help — show this help message and exit

👀 SEE ALSO 👀

Nothing else linked up here bestie, that's the whole page 🫶

and that's a wrap on centpkg 💖 this page comes from the centpkg source, with its own version tag and date stamp down at the bottom — go check the footer for the exact version and date, they're right there iykyk slay, you read the whole thing, main character energy fr fr 💅✨

📦 where this page comes from

fedora 43: centpkg 0.11.0-1.fc43 · GPL-2.0-or-later
fedora 44: centpkg 0.11.0-1.fc44 · GPL-2.0-or-later
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-13: a language model's rewrite of the original, under its terms

centpkg(1)

✨ NAME ✨

🌸 SYNOPSIS 🌸

💫 DESCRIPTION 💫

🎀 Global Options 🎀

🛍️ COMMAND OVERVIEW 🛍️

👑 COMMAND REFERENCE 👑

💅 centpkg build

🌈 centpkg chain-build

✨ centpkg ci

🧹 centpkg clean

📝 centpkg clog

🦋 centpkg clone

💜 centpkg co

💖 centpkg commit

🛠️ centpkg compile

🐳 centpkg container-build

⚙️ centpkg container-build-setup

🏗️ centpkg copr-build

🔍 centpkg current-state

🔀 centpkg diff

📦 centpkg flatpak-build

🍴 centpkg fork

🎀 centpkg gimmespec

🧚 centpkg gitbuildhash

🔗 centpkg giturl

💖 centpkg help

centpkg import 💖

centpkg install 🛠️

centpkg lint 🔍

centpkg list-side-tags 🏷️

centpkg local 🌈

centpkg mock-config 🧪

centpkg mockbuild 📦

centpkg module-build 🧩

centpkg module-build-cancel 🚫

centpkg module-build-info 🔎

centpkg module-build-local 🏠

options 💅

centpkg module-build-watch 👀

centpkg module-overview 🌈

centpkg module-scratch-build 🧪

centpkg new 🆕

centpkg new-sources 🌸

centpkg patch 🩹

centpkg pre-push-check 🚦

centpkg prep 🔧

centpkg pull ⬇️

centpkg push ⬆️

centpkg remote 🌐

centpkg remove-side-tag 🗑️

centpkg request-gated-side-tag 🚪

centpkg request-side-tag 🏷️

centpkg retire 🪦

centpkg scratch-build 🔥

🌸 centpkg sources 🌸

✨ options ✨

🎀 centpkg srpm 🎀

🌟 positional arguments 🌟

✨ options ✨

🦋 centpkg switch-branch 🦋

🌟 positional arguments 🌟

✨ options ✨

💜 centpkg tag 💜

🌟 positional arguments 🌟

✨ options ✨

🍓 centpkg unused-patches 🍓

✨ options ✨

🧚 centpkg upload 🧚

🌟 positional arguments 🌟

✨ options ✨

🌈 centpkg verify-files 🌈

🌟 positional arguments 🌟

✨ options ✨

⭐ centpkg verrel ⭐

✨ options ✨

👀 SEE ALSO 👀

🌈 `centpkg chain-build`

✨ `centpkg ci`

🧹 `centpkg clean`

📝 `centpkg clog`

🦋 `centpkg clone`

💜 `centpkg co`

💖 `centpkg commit`

🛠️ `centpkg compile`

🐳 `centpkg container-build`

⚙️ `centpkg container-build-setup`

🏗️ `centpkg copr-build`

🔍 `centpkg current-state`

🔀 `centpkg diff`

📦 `centpkg flatpak-build`

🍴 `centpkg fork`

🎀 `centpkg gimmespec`

🧚 `centpkg gitbuildhash`

🔗 `centpkg giturl`

💖 `centpkg help`