aboutsummaryrefslogtreecommitdiff
path: root/docs/cmdline-opts/capath.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/cmdline-opts/capath.md')
-rw-r--r--docs/cmdline-opts/capath.md28
1 files changed, 28 insertions, 0 deletions
diff --git a/docs/cmdline-opts/capath.md b/docs/cmdline-opts/capath.md
new file mode 100644
index 000000000..ecd28df24
--- /dev/null
+++ b/docs/cmdline-opts/capath.md
@@ -0,0 +1,28 @@
+---
+c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
+SPDX-License-Identifier: curl
+Long: capath
+Arg: <dir>
+Help: CA directory to verify peer against
+Protocols: TLS
+Category: tls
+Added: 7.9.8
+Multi: single
+See-also:
+ - cacert
+ - insecure
+Example:
+ - --capath /local/directory $URL
+---
+
+# `--capath`
+
+Tells curl to use the specified certificate directory to verify the
+peer. Multiple paths can be provided by separating them with ":" (e.g.
+"path1:path2:path3"). The certificates must be in PEM format, and if curl is
+built against OpenSSL, the directory must have been processed using the
+c_rehash utility supplied with OpenSSL. Using --capath can allow
+OpenSSL-powered curl to make SSL-connections much more efficiently than using
+--cacert if the --cacert file contains many CA certificates.
+
+If this option is set, the default capath value is ignored.