sow where

Locate one Package Object across Repositories and Dists in a Workspace.

Command

cli
managed

sow where answers which Dists in the Workspace still carry one Package Object. It is read-only, searches every Repository by default, and takes no write lock.

Synopsis

sow where PACKAGE [-C|--workdir DIR] [-r|--repo NAME] [-d|--dist NAME]... [--json]

Flag	Meaning	Default
`-C, --workdir DIR`	Workspace discovery start directory	current directory
`-r, --repo NAME`	Restrict the search to one Repository	all Repositories
`-d, --dist NAME`	Restrict the search to named Dists; repeatable	all Dists
`--json`	Emit the `sow.cli/v1` envelope	false

Reference resolution

PACKAGE uses the same grammar as sow show: SHA-256 identity, canonical RPM/DEB coordinate, full filename, or bare name.

Resolution happens across the complete selected scope. A bare name must identify one Package Object; different objects with the same binary name are ambiguous even when they live in different Repositories. Use -r/-d, or supply an exact coordinate or SHA-256.

Output

Without --json, where prints a summary followed by one line per location:

sow where 'rpm:centos-release-0:6-0.el6.centos.5.x86_64'
reference="rpm:centos-release-0:6-0.el6.centos.5.x86_64" locations=1
repository=demo coordinate="rpm:centos-release-0:6-0.el6.centos.5.x86_64" sha256:ffd9e7bdaa4884831a6c055ada01dac96b84c50a8d518dac409b445af5dadc16 dists=el9 built_dists=el9

Each location reports both Desired dists and current built_dists. This makes the command useful for answering whether a removed or superseded build is still client-visible anywhere.

With --json, the same object appears under result. A missing reference is an expected rejection, not an empty success:

sow where nosuchpkg
operation rejected: managed: operation rejected: package reference "nosuchpkg" was not found in the selected Workspace scope

Example

List every location still serving an exact build:

sow where 'rpm:patroni-0:3.0.4-1.noarch' --json |
  jq -r '.result.locations[] | "\(.repository)/\(.dists | join(","))"'

Exit codes

Code	Trigger
`0`	One resolved Package Object and its locations printed
`1`	Runtime I/O failure
`2`	Usage error or Workspace not found
`5`	A Repository state database is unreadable or inconsistent
`6`	Explicit Repository/Dist is not configured, or the reference matched nothing/was ambiguous