fedrq - Man Page

-h,  --help

Show help message and quit.​ Can be used after a command to get more information it.​

These options have the same meaning across multiple subcommands.​

-i,  --stdin

Read package names from stdin.​ Cannot be used when passing positional [PACKAGE.​.​.​].​

-b BRANCH NAME, --branch BRANCH NAME (default: rawhide)

Distribution release.​ This matches distgit branch names by convention.​ See Builtin Releases for the releases available out of the box.​ Extra configurations may be specified by the user.​ The chosen release impacts what the value of $releasever and which repositories will be enabled by default.​

-r REPO CLASS, --repo REPO CLASS (default: @base)

Enable REPO CLASS and disable all others for this operation.​ REPO CLASS can be a standard repoid that'​s configured in /etc/yum.​repos.​d or a custom one specified in a ReleaseConfig'​s defpaths (see fedrq(5)).​ In addition, release-specific repo groups and generic release class macros (e.​g.​, @copr) are accepted.​ When --repo isn'​t specified, the repositories in a Release'​s @base repo group are selected.​ See Repo Classes for more information.​

-e REPO CLASS, --enablerepo REPO CLASS

Enable certain repositories for this operation.​ All repositories in the system configuration and any fedrq repo classes are accepted.​ The option can be specified multiple times.​ Accepts comma separated values.​ See Repo Classes.​

-l <integer|"all">, --latest <integer|"all"> (default: 1)

How many package versions to show for a given name.​arch.​ By default, only the latest is included.​

NOTE: dnf repoquery includes all by default.​

-F,  --formatter <str> (default: plain)

How the output should be formatted.​ This is similar to dnf repoquery --qf but more limited.​ All Package attributes from dnf repoquery --querytags are supported.​ Some custom formatters are also available.​ See Formatters for a list.​

--debug

Enable debug logging.​ Useful for development or bug reporting.​

-P,  --resolve-packages

Resolve the correct Package when given a virtual Provide or file path.​ For instance, /usr/bin/yt-dlp would resolve to yt-dlp.​

-A <str>, --arch <str>

Only include packages that match this arch.​ This does not apply --forcearch.​

NOTE: Unlike other tools, the -source repositories are always enabled.​ You need to filter out src packages if you don'​t want them in the output.​

-s,  --src

Equivalent to --arch=src.​

NOTE: The semantics of this option are different than dnf repoquery'​s version.​ Our --arch does not affect the way the input is handled.​ In dnf repoquery, --arch=src effectively disables querying for source packages that depend on a virtual Provide of the input packages, because arch filtering is applied when resolving the input packages'​ virtual Provides and files.​

-S,  --notsrc

Equivalent to --arch=notsrc.​ This is a pseudo arch that does not exist in rpm.​ It includes noarch and the system architecture.​ It does NOT include multilib.​

--forcearch ARCHITECTURE

Query a foreign architecture'​s repositories

-B <dnf|libdnf5>, --backend <dnf|libdnf5>

Which package manager backend to use.​ By default, fedrq uses dnf and falls back to libdnf5.​ Set -B / --backend to make an explicit choice.​ If you explicitly choose a backend whose dependencies are not met on your system, fedrq will not fallback to another one.​

-L  <always|auto|never>, --filelists <always|auto|never> (default: auto)

Whether to load filelists.​ By default, filelists are only loaded when using the files formatter (i.​e.​ -F files or -F json:files).​ This only applies when using the libdnf5 backend or newer versions of dnf4, which do not load filelists by default to save memory and bandwidth.​ dnf < 4.​19.​0 always loads filelists.​

--refresh

Force refresh repository metadata

-X,  --exclude-subpackages

Filter out reverse dependencies that are built from the same source package as any of the input packages.​ See the whatrequires Examples.​

-M PATTERN, --match PATTERN (can be repeated to match against multiple patterns)

-o PATH, --destdir PATH

Directory in which to download/extract files.​ Defaults to the current directory.​

The formatters subcommand lists available formatters.​ By default, all available formatters are shown, but they can be filtered by passing one or more of the following options.​

--attrs,  --only-attrs

Only list package attributes

--formatters,  --only-formatters

Only list regular formatters

--special-formatters,  --only-special-formatters

Only list special formatters (i.​e.​, formatters that accept their own arguments)

This list is non-exhaustive.​ See fedrq formatters --attrs.​

-F name

Show package names
(example line: yt-dlp)

-F arch

Show package arches only
(example line : noarch)

-F repoid

Show package'​s repo.​
(example line: updates-testing)

-F na

Show package name.​arch
(example line: yt-dlp.​noarch)

-F nv

Show package name-version
(example line: yt-dlp-2022.​11.​11)

-F nev

Show package name-epoch:version
(example line: bind-32:9.​18.​8)

-F source

Package queries can include source and binary RPMs.​ The source formatter combines and deduplicates all of the source names.​ For example, if python3-setuptools.​noarch is in the result, it'​ll become python-setuptools.​ If python-setuptools.​src is also in the result, it'​ll become python-setuptools, but python-setuptools won'​t be duplicated in the output.​

-F breakdown

Only supported by fedrq --whatrequires.​ Shows a breakdown of runtime and buildtime dependencies.​

"Special formatters" accept arguments.​

-F json:[comma separated list of Package attrs]

Return an array of objects containing the specified Package attributes.​ The JSON output is formatted with indent=2.​ The output can be piped to jq.​

-F line:[comma separated list of Package attrs]

Return the specified package attributes on a single line.​
NOTE: The attributes provided must fit on one line.​ Attributes such as files or requires that contain a list of items are not supported by the line formatter.​ See -F multiline for that usecase.​

-F multiline:[single line attribute],[multiline attribute]

Display two package attributes together.​
(example call: -F multiline:name,files)
(example line: yt-dlp : /usr/bin/yt-dlp)

-F queryformat:[format string]

Formatter that accepts queryformat string like dnf repoquery --qf

-F qf:[format string]

Alias to queryformat formatter

-F plainwithrepo

Show default format and repoid separated by space:
(example line: yt-dlp-2023.​01.​06-2.​fc38.​noarch rawhide)

-F nevrr

Alias to plainwithrepo formatter.​

-F requiresmatch:[comma- or semicolon-separated list of packages]

List the Requires of [package .​.​.​] that resolve to the list of packages provided to requiresmatch.​ For example, python3dist(ansible-core) resolves to requiresmatch:ansible-core.​

-F rm:[comma- or semicolon-separated list of packages]

Alias for -F requiresmatch

-F na-requiresmatch:[comma- or semicolon-separated list of packages]

Combine the -F na and -F requiresmatch on a single line.​ See the whatrequires Examples for usage.​

-F narm:[comma- or semicolon-separated list of packages]

Shortcut for -F na-requiresmatch

-F source+requiresmatch:[comma- or semicolon-separated list of packages]

Combine the -F source and -F requiresmatch on a single line.​

-F source+rm:[comma- or semicolon-separated list of packages]

Shortcut for -F na-requiresmatch

There are also requiresmatch-src / rmsrc and na-requiresmatch / narmsrc formatters that work similarly to their non-src conterparts, expect they take a list of source packages.​ The list of source packages is converted into a list of binary packages (like the subpkgs subcommand) and then processed in the same way.​ If, say, a source package named foo has foo, foo-devel, and foo-static subpackages, -F rmsrc:foo is equivalent to -F rm:foo,foo-devel,foo-static

@base

Release repositories enabled by default in the distribution
(e.​g.​ fedora, fedora-source, updates, updates-source for Fedora stable)

@testing

Superset of base with -testing repos enabled.​
(e.​g.​ fedora, fedora-source, updates, updates-source, updates-testing-source for Fedora stable)

@testing-only

Includes -testing repositories without base
(e.​g.​ updates-testing, updates-testing-source for Fedora stable)

@buildroot (rawhide only)

Koji buildroot repositories Buildroot repositories are available for stable Fedora releases, but they don'​t have corresponding source repos.​ This causes problems for fedrq, so those definitions are not available.​

PYTHON_SITELIB/fedrq/data/*.​toml

Builtin configuration files.​ These should not be modified directly but may be overridden or used as examples.​

/etc/fedrq/*.​toml

System wide configuration files.​ Has precedence over builtin configuration files.​

~/.​config/fedrq/*.​toml

User configuration files.​ Highest precedence.​

See fedrq(5) for configuration file syntax.​

Find a package'​s runtime dependencies:

  $ fedrq pkgs -S -F requires ansible
  /usr/bin/python3
  /usr/bin/bash
  python(abi) = 3​.11
  (python3​.11dist(ansible-core) >= 2​.14​.1 with python3​.11dist(ansible-core) < 2​.15)

Resolve a package'​s runtime dependencies:

  $ fedrq pkgs -S -F requires ansible | fedrq pkgs -iSP
  ansible-core-2​.14​.1-1​.fc38​.noarch
  bash-5​.2​.9-3​.fc38​.x86_64
  python3-3​.11​.1-1​.fc38​.x86_64

Find the package(s) that contain(s) a file on f35

  $ fedrq pkgs -b f35 -P /usr/bin/ansible
  ansible-2​.9​.27-4​.fc35​.noarch
  ansible-core-2​.12​.10-1​.fc35​.noarch

Return a JSON object containing certain package attributes:

  $ fedrq pkgs scdoc -F json:name,evr,arch,files,requires
  [
    {
      "name": "scdoc",
      "evr": "1​.11​.2-3​.fc37",
      "arch": "x86_64",
      "requires": [
        "rtld(GNU_HASH)",
        "libc​.so​.6(GLIBC_2​.34)(64bit)",
        "/usr/bin/pkg-config"
      ],
      "files": [
        "/usr/bin/scdoc",
        "/usr/lib/​.build-id",
        "/usr/lib/​.build-id/c1",
        "/usr/lib/​.build-id/c1/62fcbc2f7d9b41ce409071b05905bdbfa6ffe7",
        "/usr/share/doc/scdoc",
        "/usr/share/doc/scdoc/README​.md",
        "/usr/share/licenses/scdoc",
        "/usr/share/licenses/scdoc/COPYING",
        "/usr/share/man/man1/scdoc​.1​.gz",
        "/usr/share/man/man5/scdoc​.5​.gz",
        "/usr/share/pkgconfig/scdoc​.pc"
      ]
    },
    {
      "name": "scdoc",
      "evr": "1​.11​.2-3​.fc37",
      "arch": "src",
      "requires": [
        "make",
        "gcc",
        "sed"
      ],
      "files": [
        "/scdoc-1​.11​.2​.tar​.gz",
        "/scdoc​.spec"
      ]
    }
  ]

Show packages'​ name, evr, arch, and reponame with each package on a single line:

  $ fedrq pkgs ansible ansible-core -F line:name,evr,arch,reponame
  ansible : 7​.2​.0-1​.fc38 : noarch : rawhide
  ansible : 7​.2​.0-1​.fc38 : src : rawhide-source
  ansible-core : 2​.14​.2-1​.fc38 : noarch : rawhide
  ansible-core : 2​.14​.2-1​.fc38 : src : rawhide-source

Incorrect usage of the line filter:

  $ fedrq pkgs ansible ansible-core -F line:name,evr,files
  ERROR: ​'line​' FormatterError: invalid argument ​'files​'
  See fedrq(1) for more information about formatters​.

(files cannot fit on a single line)

Find the latest version of `fedrq` available in the gotmax23/fedrq-dev copr:

  $ fedrq pkgs -F nevrr -b f36 -r @copr:gotmax23/fedrq-dev fedrq
  fedrq-0​.4​.1^25​.20230318​.76d7910-1​.fc36​.noarch copr:copr​.fedorainfracloud​.org:gotmax23:fedrq-dev
  fedrq-0​.4​.1^25​.20230318​.76d7910-1​.fc36​.src copr:copr​.fedorainfracloud​.org:gotmax23:fedrq-dev

In a single query, print the Requires of more than one package:

  $ fedrq pkgs -F requires ansible-core​.src yt-dlp​.noarch
  make
  python3-devel
  python3dist(packaging)
  [​.​.​.]
  /usr/bin/python3
  python3​.12dist(requests)
  python3​.12dist(urllib3)
  [​.​.​.]

In a single query, print the Requires of more than one package, qualified by package name:

  $ fedrq pkgs -F multiline:name,requires ansible-core​.src yt-dlp​.noarch
  ansible-core : make
  ansible-core : python3-devel
  ansible-core : python3dist(packaging)
  [​.​.​.]
  yt-dlp : /usr/bin/python3
  yt-dlp : python3​.12dist(requests)
  yt-dlp : python3​.12dist(urllib3)
  [​.​.​.]

Find the packages that require another package, at buildtime or runtime:

  $ fedrq whatrequires yt-dlp
  audiotube-24​.01​.95-1​.fc40​.src
  audiotube-24​.01​.95-1​.fc40​.x86_64
  celluloid-0​.26-1​.fc40​.x86_64
  gpodder-3​.11​.4-4​.fc40​.noarch
  lollypop-1​.4​.37-7​.fc40​.noarch
  media-downloader-4​.2​.0-4​.fc40​.x86_64
  persepolis-3​.2​.0-16​.fc40​.noarch
  video-downloader-0​.12​.10-3​.fc40​.noarch
  yt-dlp-bash-completion-2023​.12​.30-2​.fc40​.noarch
  yt-dlp-fish-completion-2023​.12​.30-2​.fc40​.noarch
  yt-dlp-zsh-completion-2023​.12​.30-2​.fc40​.noarch

Find a package'​s reverse dependencies, excluding subpackages:

  $ fedrq whatrequires -X yt-dlp
  audiotube-24​.01​.95-1​.fc40​.src
  audiotube-24​.01​.95-1​.fc40​.x86_64
  celluloid-0​.26-1​.fc40​.x86_64
  gpodder-3​.11​.4-4​.fc40​.noarch
  lollypop-1​.4​.37-7​.fc40​.noarch
  media-downloader-4​.2​.0-4​.fc40​.x86_64
  persepolis-3​.2​.0-16​.fc40​.noarch
  video-downloader-0​.12​.10-3​.fc40​.noarch

Find the packages that require another package, at buildtime or runtime and show which package spec it depends on.​

  $ fedrq whatrequires -F multiline:plain,rm:ansible-core: ansible-core
  ansible-9​.2​.0-1​.fc40​.noarch : (python3​.12dist(ansible-core) >= 2​.16​.3 with python3​.12dist(ansible-core) < 2​.17)
  ansible-9​.2​.0-1​.fc40​.src : (python3dist(ansible-core) >= 2​.16​.3 with python3dist(ansible-core) < 2​.17)
  ansible-bender-0​.10​.1-5​.fc40​.noarch : (ansible-core or ansible)
  ansible-collection-ansible-netcommon-6​.0​.0-3​.fc40​.noarch : (ansible-core or (ansible < 2​.10​.0 with ansible >= 2​.9​.10))
  [​.​.​.]

Shortcut for the above:

  $ fedrq whatrequires -F narm:ansible-core ansible-core
  ansible​.noarch : (python3​.12dist(ansible-core) >= 2​.16​.3 with python3​.12dist(ansible-core) < 2​.17)
  ansible​.src : (python3dist(ansible-core) >= 2​.16​.3 with python3dist(ansible-core) < 2​.17)
  ansible-bender​.noarch : (ansible-core or ansible)
  ansible-collection-ansible-netcommon​.noarch : (ansible-core or (ansible < 2​.10​.0 with ansible >= 2​.9​.10))
  [​.​.​.]

Find an epel9 SRPM'​s subpackages

  $ fedrq subpkgs -b epel9 -F na epel-release
  epel-next-release​.noarch
  epel-release​.noarch

Find the components that would be directly affected by the removal of pcre:

  $ fedrq whatrequires-src -X -F source pcre
  ClanLib
  Thunar
  adanaxisgpl
  aide
  [​.​.​.]
  xgrep
  xmlcopyeditor
  yara
  zsh

Find the packages the need to be rebuilt when libindi'​s .​so name is bumped:

  $ fedrq whatrequires-src -X -F source libindi
  indi-3rdparty-drivers
  indi-3rdparty-libraries
  kstars
  phd2