NAME

LibTmux::ProcessJob - Shared owned process-supervision boundary

METHODS

start

Start a supervised literal command using the same arguments as "run" in LibTmux::Transport. This explicit operation performs I/O.

pid

Return the supervisor PID. It differs from the program PID.

cleanup_complete

True only after a valid supervisor result proves owned program cleanup.

take_result_handle

Transfer the result pipe exactly once. Its reader owns closing that handle.

consume

Accumulate bounded result octets. Malformed or excessive data is a failure.

finish

Decode the complete result after EOF and supervisor exit. Return one LibTmux::CommandResult or throw a typed error.

cancel

Request cleanup without blocking. Cancellation can follow dispatch and does not imply rollback or completed reaping.

wait

The synchronous reader/reaper. A loop-owned job refuses blocking wait. Async adapters supply a spawn/reap callback and retain jobs through EOF plus the matching exit notification. Dropping a job closes its parent guard but does not synchronously wait; owners must complete their cleanup protocol.