xref: /aosp_15_r20/external/curl/docs/cmdline-opts/capath.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker---
2*6236dae4SAndroid Build Coastguard Workerc: Copyright (C) Daniel Stenberg, <[email protected]>, et al.
3*6236dae4SAndroid Build Coastguard WorkerSPDX-License-Identifier: curl
4*6236dae4SAndroid Build Coastguard WorkerLong: capath
5*6236dae4SAndroid Build Coastguard WorkerArg: <dir>
6*6236dae4SAndroid Build Coastguard WorkerHelp: CA directory to verify peer against
7*6236dae4SAndroid Build Coastguard WorkerProtocols: TLS
8*6236dae4SAndroid Build Coastguard WorkerCategory: tls
9*6236dae4SAndroid Build Coastguard WorkerAdded: 7.9.8
10*6236dae4SAndroid Build Coastguard WorkerMulti: single
11*6236dae4SAndroid Build Coastguard WorkerSee-also:
12*6236dae4SAndroid Build Coastguard Worker  - cacert
13*6236dae4SAndroid Build Coastguard Worker  - dump-ca-embed
14*6236dae4SAndroid Build Coastguard Worker  - insecure
15*6236dae4SAndroid Build Coastguard WorkerExample:
16*6236dae4SAndroid Build Coastguard Worker  - --capath /local/directory $URL
17*6236dae4SAndroid Build Coastguard Worker---
18*6236dae4SAndroid Build Coastguard Worker
19*6236dae4SAndroid Build Coastguard Worker# `--capath`
20*6236dae4SAndroid Build Coastguard Worker
21*6236dae4SAndroid Build Coastguard WorkerUse the specified certificate directory to verify the peer. Multiple paths can
22*6236dae4SAndroid Build Coastguard Workerbe provided by separated with colon (`:`) (e.g. `path1:path2:path3`). The
23*6236dae4SAndroid Build Coastguard Workercertificates must be in PEM format, and if curl is built against OpenSSL, the
24*6236dae4SAndroid Build Coastguard Workerdirectory must have been processed using the c_rehash utility supplied with
25*6236dae4SAndroid Build Coastguard WorkerOpenSSL. Using --capath can allow OpenSSL-powered curl to make SSL-connections
26*6236dae4SAndroid Build Coastguard Workermuch more efficiently than using --cacert if the --cacert file contains many
27*6236dae4SAndroid Build Coastguard WorkerCA certificates.
28*6236dae4SAndroid Build Coastguard Worker
29*6236dae4SAndroid Build Coastguard WorkerIf this option is set, the default capath value is ignored.
30