NAME

upstream - exit 3 (UpstreamFailed)

SYNOPSIS

upstream

DESCRIPTION

Returns exitcode.New(UpstreamFailed, ...). Process exits 3. Use this when the wrapped tool ran and returned non-zero; the wrapper passes the failure up but tags it as "from upstream" so the operator can tell "the tool said no" apart from "coily said no".

Examples:

exitcode-demo upstream ; echo "exit: $?"
# error:
#     kind: upstream_failed
#     message: wrapped tool exited 7
#     hint: check the tool
# exit: 3

Retry semantics: read the underlying tool's stderr. The wrapper does not retry for you.

Usage:

upstream [GLOBAL OPTIONS] [command [COMMAND OPTIONS]] [ARGUMENTS...]