docs: improve description of the --capath option

Document the possibility of providing multiple values using the ":"
separator, and the fact that the default value will be ignored if the
option is used.
This commit is contained in:
Alessandro Ghedini 2011-12-17 15:04:57 +01:00 committed by Daniel Stenberg
parent ee3d3adc6f
commit b235d5ade8

View File

@ -434,13 +434,15 @@ may be loaded.
If this option is used several times, the last one will be used. If this option is used several times, the last one will be used.
.IP "--capath <CA certificate directory>" .IP "--capath <CA certificate directory>"
(SSL) Tells curl to use the specified certificate directory to verify the (SSL) Tells curl to use the specified certificate directory to verify the
peer. The certificates must be in PEM format, and if curl is built against peer. Multiple paths can be provided by separating them with ":" (e.g.
OpenSSL, the directory must have been processed using the c_rehash utility "path1:path2:path3"). The certificates must be in PEM format, and if curl
supplied with OpenSSL. Using \fI--capath\fP can allow OpenSSL-powered curl to is built against OpenSSL, the directory must have been processed using the
make SSL-connections much more efficiently than using \fI--cacert\fP if the c_rehash utility supplied with OpenSSL. Using \fI--capath\fP can allow
\fI--cacert\fP file contains many CA certificates. OpenSSL-powered curl to make SSL-connections much more efficiently than
using \fI--cacert\fP if the \fI--cacert\fP file contains many CA certificates.
If this option is used several times, the last one will be used. If this option is set, the default capath value will be ignored, and if it
is used several times, the last one will be used.
.IP "-f, --fail" .IP "-f, --fail"
(HTTP) Fail silently (no output at all) on server errors. This is mostly done (HTTP) Fail silently (no output at all) on server errors. This is mostly done
to better enable scripts etc to better deal with failed attempts. In to better enable scripts etc to better deal with failed attempts. In