An action run on a target (commons headless 0005-reach-and-targets): the target (its id, class, address, port, jump chain, the reference of its host key and of its credential, never a value), the invocation that runs <program> run --json <verb> ... there, and what comes back as the typed outcome and the one JSON envelope of a local run. A host that cannot be reached, a host key that does not match and a time out are the environment's (status 3); a forced command that refuses is a usage problem (status 2); a partial failure over many targets is status 1 with a table for each host.
type Target = {
readonly id: string;
readonly class: TargetClass;
/** A host name or an address; never one that be…(555 characters)
typeTarget= {
readonlyid:string;
readonlyclass:TargetClass;
/** A host name or an address; never one that begins with a dash. */readonlyaddress:string;
readonlyuser:string|undefined;
readonlyport:number|undefined;
/** The ids of the targets this one is reached through, in order. */readonlyjump:readonlystring[];
/** The reference of the host's key (a fingerprint's name in the repository's known hosts), not the key. */readonlyhostKeyRef:string|undefined;
readonlycredential:CredentialRef|undefined;
};
A target, or why it is not one: an id of lower-case words, a class there is, an address that cannot be taken for an option, a port in range, a user and jump ids that are names.
typeRemoteOutcome= {
readonlytarget:string;
readonlykind:RemoteKind;
/** The status this target's run counts as: its own where it ran, 3 where it could not be reached, 2 where it refused. */readonlycode:number;
readonlyoutcome:Outcome;
};
A run on one target, as a report: how it went, its status, and what it found as the typed outcome.
What a run on a target came to, from how its program ended: a time out and an exit of 255 (ssh's own failure) are the environment's, status 3, the host key apart from the rest; a 127 or 126 is that the program is not there, status 3; a refusal of the forced command (status 2 with no report) is status 2; a report that is not the one JSON document is malformed; otherwise the remote report, with its own status.
The status of a run over many targets: 0 where every target's run ended with 0; 3 where every one failed for the environment; 2 where every one refused; else 1, a partial failure, with the table of each host to say which.
One report of a run over targets (the nested hand-off for many hosts): the table as its text, the data of each host under its id, and every problem of every host once, each marked with the target it is of; a failure of the run as a whole where some host failed.
type Target = {
readonly id: string;
readonly class: TargetClass;
/** A host name or an address; never one that be…(555 characters)
typeTarget= {
readonlyid:string;
readonlyclass:TargetClass;
/** A host name or an address; never one that begins with a dash. */readonlyaddress:string;
readonlyuser:string|undefined;
readonlyport:number|undefined;
/** The ids of the targets this one is reached through, in order. */readonlyjump:readonlystring[];
/** The reference of the host's key (a fingerprint's name in the repository's known hosts), not the key. */readonlyhostKeyRef:string|undefined;
readonlycredential:CredentialRef|undefined;
};
A target, or why it is not one: an id of lower-case words, a class there is, an address that cannot be taken for an option, a port in range, a user and jump ids that are names.
typeRemoteOutcome= {
readonlytarget:string;
readonlykind:RemoteKind;
/** The status this target's run counts as: its own where it ran, 3 where it could not be reached, 2 where it refused. */readonlycode:number;
readonlyoutcome:Outcome;
};
A run on one target, as a report: how it went, its status, and what it found as the typed outcome.
What a run on a target came to, from how its program ended: a time out and an exit of 255 (ssh's own failure) are the environment's, status 3, the host key apart from the rest; a 127 or 126 is that the program is not there, status 3; a refusal of the forced command (status 2 with no report) is status 2; a report that is not the one JSON document is malformed; otherwise the remote report, with its own status.
The status of a run over many targets: 0 where every target's run ended with 0; 3 where every one failed for the environment; 2 where every one refused; else 1, a partial failure, with the table of each host to say which.
One report of a run over targets (the nested hand-off for many hosts): the table as its text, the data of each host under its id, and every problem of every host once, each marked with the target it is of; a failure of the run as a whole where some host failed.