Command-line interface

kkrunner is the installed command. Its remote subcommand runs the target-side execution protocol:

kkrunner remote --help

Execution clients supply --protocol-version explicitly. The commands are submit, status, follow, cancel, recover, ack-submit, ack and resolve-mpi. Submission and recovery read JSON requests from stdin. Status and acknowledgements return JSON; framed follow multiplexes stdout, stderr and a terminal record. Use the Python executor API for normal submissions instead of constructing these messages manually.

Manual inspection

When inspecting a known handle with KKRunner directly, pass the installed control protocol version (available as CONTROL_PROTOCOL_VERSION in the remote protocol module):

kkrunner remote --protocol-version VERSION status HANDLE
kkrunner remote --protocol-version VERSION follow HANDLE
kkrunner remote --protocol-version VERSION cancel HANDLE

These commands operate on the machine where they execute. For a remote handle, run them on the target, for example through SSH. follow replays output from byte offset zero by default; --live requests only new output. It accepts separate stdout/stderr offsets and --framed for binary multiplexing.