aboutsummaryrefslogtreecommitdiff
path: root/bpkg/common.cli
diff options
context:
space:
mode:
authorKaren Arutyunov <karen@codesynthesis.com>2018-10-08 23:01:16 +0300
committerKaren Arutyunov <karen@codesynthesis.com>2018-10-10 23:54:18 +0300
commit61349dcf5fbfeab888ea345ebec3d887777a2782 (patch)
tree958d7f34185d987b21ae24ad137b7a2e0a1593ec /bpkg/common.cli
parenteb58dc7c9ec9877c645585b7fb163d2bcc251b5d (diff)
Add support for openssl qualified options
Diffstat (limited to 'bpkg/common.cli')
-rw-r--r--bpkg/common.cli32
1 files changed, 27 insertions, 5 deletions
diff --git a/bpkg/common.cli b/bpkg/common.cli
index f001608..a8c363e 100644
--- a/bpkg/common.cli
+++ b/bpkg/common.cli
@@ -217,21 +217,43 @@ namespace bpkg
multiple tar options."
}
- path --openssl = "openssl"
+ // NOTE: when adding support for a new openssl command, don't forget to
+ // update the openssl_commands qualifier list.
+ //
+ qualified_option<openssl_commands, path> --openssl = "openssl"
{
"<path>",
"The openssl program to be used for crypto operations. You can also
specify additional options that should be passed to the openssl
program with \cb{--openssl-option}. If the openssl program is not
- explicitly specified, then \cb{bpkg} will use \cb{openssl} by default."
+ explicitly specified, then \cb{bpkg} will use \cb{openssl} by default.
+
+ The \cb{--openssl*} values can be optionally qualified with the openssl
+ command in the \c{\i{command}\b{:}\i{value}} form. This makes the value
+ only applicable to the specific command, for example:
+
+ \
+ bpkg rep-create \
+ --openssl rsautl:/path/to/openssl \
+ --openssl-option rsautl:-engine \
+ --openssl-option rsautl:pkcs11 \
+ ...
+ \
+
+ An unqualified value that contains a colon can be specified as
+ qualified with an empty command, for example, \cb{--openssl
+ :C:\\bin\\openssl}. To see openssl commands executed by \cb{bpkg}, use
+ the verbose mode (\cb{-v} option)."
}
- strings --openssl-option
+ qualified_option<openssl_commands, strings> --openssl-option
{
"<opt>",
"Additional option to be passed to the openssl program. See
- \cb{--openssl} for more information on the openssl program. Repeat this
- option to specify multiple openssl options."
+ \cb{--openssl} for more information on the openssl program.
+ The values can be optionally qualified with the openssl command,
+ as discussed in \cb{--openssl}. Repeat this option to specify
+ multiple openssl options."
}
bpkg::auth --auth = bpkg::auth::remote