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 postional [packages...].

-b,  --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 releasever will be set to and which repositories will be enabled by default.

-r,  --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 in a ReleaseConfig's defpaths (see fedrq(5)). In addition, release specifc 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,  --enablerepo <repo class>

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

-l,  --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,  --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 <str>

Query a foreign architecture's repositories

-B,  --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,  --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, which doesn't load filelists by default to save memory and bandwidth. dnf4 always loads filelists.

-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, --match <pattern> (can be repeated to match against multiple patterns)

@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

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

  $ fedrq whatrequires yt-dlp
  audiotube-22.11-1.fc38.src
  audiotube-22.11-1.fc38.x86_64
  celluloid-0.24-4.fc38.x86_64
  gpodder-3.11.0-1.fc37.noarch
  media-downloader-2.7.0-2.fc38.x86_64
  persepolis-3.2.0-11.fc37.noarch
  video-downloader-0.10.12-1.fc38.noarch
  yt-dlp-bash-completion-2022.11.11-1.fc38.noarch
  yt-dlp-fish-completion-2022.11.11-1.fc38.noarch
  yt-dlp-zsh-completion-2022.11.11-1.fc38.noarch

Find a package's reverse dependencies, excluding subpackages:

  $ fedrq whatrequires -X yt-dlp
  audiotube-22.11-1.fc38.src
  audiotube-22.11-1.fc38.x86_64
  celluloid-0.24-4.fc38.x86_64
  gpodder-3.11.0-1.fc37.noarch
  media-downloader-2.7.0-2.fc38.x86_64
  persepolis-3.2.0-11.fc37.noarch
  video-downloader-0.10.12-1.fc38.noarch

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
  stellarium