NAME

zoryn-task-test-rebuild - Test rebuild dependent packages without adding to task.

SYNOPSIS

zoryn task test-rebuild [OPTION]… TASK_ID

DESCRIPTION

Test rebuild of dependent packages to verify compatibility before submitting a task. Does not add packages to the task - only tests builds.

The workflow is:

1.

Download RPMs from task (by architecture); with --without-task, clear hasher instead for a baseline rebuild

2.

Get dependent packages list from RDB

3.

Build each dependent package with the new RPMs

4.

Report results

ARGUMENTS

TASK_ID (required)

Task ID. Used to query RDB for dependent packages (required even with --without-task).

OPTIONS

-a ARCH, --arch=ARCH

Filter by architecture. Comma-separated for multiple.

-B BRANCH, --build-branch=BRANCH

Filter by builder branch.

-b PATTERN, --builder=PATTERN

Use builder PATTERN for build. Supports patterns: @all (all builders), @host:HOST (by host), @host:HOST[N-M] (host range), NAME[N-M] (name range), ^NAME (exclude). Comma-separated.

-C DIR

Change to directory DIR before running.

--continue

Smart continue: check for changes and rebuild affected.

--continue-no-refresh

Simple continue: only rebuild pending/failed.

-d, --debug

Enable debug output.

--deps-by-pkg=PKG

Filter dependencies by package name instead of task dependencies.

--depth=N (absent=1)

Dependency depth for RDB query (1-4).

--dptype=TYPE (absent=source)

Dependency type for RDB query. One of: source, binary, both.

--local-rpms=DIR

Use local RPMs from directory instead of downloading from task.

--log-dir=DIR

Directory for logs and stats.

-p, --parallel

Run builds in parallel (default).

--package=PKG

Add a package to the custom rebuild list (repeatable). Accepts any format: name, name-version, name-version-release, name-epoch:version-release, with or without .rpm suffix.

--packages-file=FILE

Read package list from file (one per line, # = comment lines). Accepts same formats as --package.

-s, --sequential

Run builds sequentially.

--skip-ftbfs

Skip rebuild tasks for packages that are already FTBFS on beehive. Filtering is per-architecture: a package FTBFS on x86_64 is only skipped for x86_64, not for other architectures.

--top

Interactive TUI mode.

--verify-failures

After main rebuild, rebuild all failed and stalled packages without task RPMs to distinguish regressions (caused by task) from pre-existing failures. A task RPM can make a build hang, so stalled builds are re-verified alongside failed ones.

--without-task

Skip downloading task RPMs and rebuild dependents against the branch state. Useful for establishing a pre-task baseline. Mutually exclusive with --verify-failures and --local-rpms. Hasher RPMs are cleared on each builder before the rebuild begins; if clearing fails on any builder the command exits to avoid mixed-state results. Not safe to run concurrently with another test-rebuild session using the same builder.

COMMON OPTIONS

--help[=FMT] (default=auto)

Show this help in format FMT. The value FMT must be one of auto, pager, groff or plain. With auto, the format is pager or plain whenever the TERM env var is dumb or undefined.

--version

Show version information.

EXIT STATUS

zoryn task test-rebuild exits with:

0

on success.

123

on indiscriminate errors reported on standard error.

124

on command line parsing errors.

125

on unexpected internal errors (bugs).

EXAMPLES

Basic test on local builder:

  zoryn task test-rebuild 404809

Test on all architectures in parallel:

  zoryn task test-rebuild 404809 -b @all --arch=x86_64,aarch64

With additional local RPMs:

  zoryn task test-rebuild 404809 --local-rpms=~/hasher/repo

Continue interrupted build:

  zoryn task test-rebuild 404809 --continue

Interactive TUI mode:

  zoryn task test-rebuild 404809 -b @all --top

Skip packages already broken on beehive:

  zoryn task test-rebuild 404809 --skip-ftbfs

Verify failures to find regressions:

  zoryn task test-rebuild 404809 --verify-failures

Baseline rebuild without task RPMs:

  zoryn task test-rebuild 404809 --without-task

Continue interrupted verification:

  zoryn task test-rebuild 404809 --verify-failures --continue

Custom package list:

  zoryn task test-rebuild 404809 --package foo --package bar-1.2.3-alt1

Packages from file:

  zoryn task test-rebuild 404809 --packages-file ~/rebuild-list.txt

SEE ALSO

zoryn(1)