diff options
| -rw-r--r-- | share/man/just-mr.1.md | 38 | ||||
| -rw-r--r-- | share/man/just-mrrc.5.md | 20 |
2 files changed, 57 insertions, 1 deletions
diff --git a/share/man/just-mr.1.md b/share/man/just-mr.1.md index 655ccdd4..f67f4df8 100644 --- a/share/man/just-mr.1.md +++ b/share/man/just-mr.1.md @@ -117,6 +117,15 @@ archives (for which we verify the hash anyway) from remote. Path to the CA certificate bundle containing one or more certificates to be used to peer verify archive fetches from remote. +**`-r`**, **`--remote-execution-address`** *`NAME`*:*`PORT`* +Address of a remote execution service. This is used as an intermediary fetch +location for archives, between local CAS (or distdirs) and the network. + +**`--compatible`** +At increased computational effort, be compatible with the original remote build +execution protocol. If a remote execution service address is provided, this +option can be used to match the artifacts expected by the remote endpoint. + **`--just`** *`PATH`* Name of the just binary in *`PATH`* or path to the just binary. Default: *`"just"`*. @@ -134,6 +143,24 @@ Default: *`"git"`*. **`--norc`** Option to prevent reading any **`just-mrrc`**(5) file. +Authentication options +---------------------- + +Only TLS and mutual TLS (mTLS) are supported. +They mirror the **`just`**(1) options. + +**`--tls-ca-cert`** *`PATH`* +Path to a TLS CA certificate that is trusted to sign the server +certificate. + +**`--tls-client-cert`** *`PATH`* +Path to a TLS client certificate to enable mTLS. It must be passed in +conjunction with **`--tls-client-key`** and **`--tls-ca-cert`**. + +**`--tls-client-key`** *`PATH`* +Path to a TLS client key to enable mTLS. It must be passed in +conjunction with **`--tls-client-cert`** and **`--tls-ca-cert`**. + SUBCOMMANDS =========== @@ -214,7 +241,8 @@ do This subcommand is used as the canonical way of specifying just arguments and calling **`just`** via **`execvp`**(2). Any subsequent argument is unconditionally forwarded to **`just`**. For *known* subcommands -(**`version`**, **`describe`**, **`analyse`**, **`build`**, **`install`**, **`install-cas`**, **`rebuild`**), the +(**`version`**, **`describe`**, **`analyse`**, **`build`**, **`install`**, +**`install-cas`**, **`rebuild`**, **`gc`**), the **`just-mr setup`** step is performed first for those commands accepting a configuration and the produced configuration is prefixed to the provided arguments. The main repository for the **`setup`** step can be provided in @@ -231,6 +259,14 @@ The **`--local-launcher`** argument is passed to **`just`** as early argument for those *known* subcommands that accept it (build, install, rebuild). +The **`--remote-execution-address`** and **`--compatible`** arguments are passed +to **`just`** as early arguments for those *known* subcommands that accept them +(analyse, build, install-cas, install, rebuild, traverse). + +The *authentication options* given to **`just-mr`** are passed to **`just`** as +early arguments for those *known* subcommands that accept them, according to +**`just`**(1). + **`version`**|**`describe`**|**`analyse`**|**`build`**|**`install`**|**`install-cas`**|**`rebuild`**|**`gc`** ------------------------------------------------------------------------------------------------------------- diff --git a/share/man/just-mrrc.5.md b/share/man/just-mrrc.5.md index 6e5cab7a..b6afe990 100644 --- a/share/man/just-mrrc.5.md +++ b/share/man/just-mrrc.5.md @@ -87,6 +87,26 @@ The just-mrrc is given by a JSON object. objects, specifying additional log files, on top of those specified on the command line. + - The value for the key *`remote execution`* is a JSON object specifying the + remote execution options for **`just-mr`**. + For subkey *`"address"`* the value is a string specifying the remote + execution address in a NAME:PORT format. + For subkey *`compatible`* the value is a flag which specifies whether the + remote endpoint uses the original remote execution protocol. + Each subkey value can be overwritten by its corresponding command-line + argument. + + - The value for the key *`authentication`* is a JSON object specifying + client-side authentication options for **`just-mr`**. + For subkey *`ca cert`* the value is a string specifying the path to a TLS CA + certificate. + For subkey *`client cert`* the value is a string specifying the path to a + TLS client certificate. + For subkey *`client key`* the value is a string specifying the path to a TLS + client key. + Each subkey value can be overwritten by its corresponding command-line + argument. + - The value for the key *`"just args"`* is a JSON object. Its keys are **`just`** subcommands and its value is a JSON list of strings. For the corresponding subcommand, these strings are prefixed to the **`just`** |