Artifactspublic-v0

curl

master
ply4 git calls217 ms288 KiB2 cachedprotocol v2
96 lines2.3 KiBRaw

NAME

CURLOPT_PROXY_SSL_VERIFYHOST - verify the proxy certificate's name against host

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSL_VERIFYHOST,
                          long verify);

DESCRIPTION

Pass a long set to 2L as asking curl to verify in the HTTPS proxy's certificate name fields against the proxy name.

This option determines whether libcurl verifies that the proxy cert contains the correct name for the name it is known as.

When CURLOPT_PROXY_SSL_VERIFYHOST(3) is 2, the proxy certificate must indicate that the server is the proxy to which you meant to connect to, or the connection fails.

curl considers the proxy the intended one when the Common Name field or a Subject Alternate Name field in the certificate matches the hostname in the proxy string which you told curl to use.

If verify value is set to 1:

In 7.28.0 and earlier: treated as a debug option of some sorts, not supported anymore due to frequently leading to programmer mistakes.

From 7.28.1 to 7.65.3: setting it to 1 made curl_easy_setopt(3) return an error and leaving the flag untouched.

From 7.66.0: treats 1 and 2 the same.

When the verify value is 0L, the connection succeeds regardless of the names used in the certificate. Use that ability with caution.

See also CURLOPT_PROXY_SSL_VERIFYPEER(3) to verify the digital signature of the proxy certificate.

DEFAULT

2

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");

    /* Set the default value: strict name check please */
    curl_easy_setopt(curl, CURLOPT_PROXY_SSL_VERIFYHOST, 2L);

    result = curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }
}

%AVAILABILITY%

RETURN VALUE

curl_easy_setopt(3) returns a CURLcode indicating success or error.

CURLE_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3).

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: CURLOPT_PROXY_SSL_VERIFYHOST
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_CAINFO (3)
9 - CURLOPT_PROXY_CAINFO (3)
10 - CURLOPT_PROXY_SSL_VERIFYPEER (3)
11 - CURLOPT_SSL_VERIFYPEER (3)
12Protocol:
13 - TLS
14TLS-backend:
15 - All
16Added-in: 7.52.0
17---
19# NAME
21CURLOPT_PROXY_SSL_VERIFYHOST - verify the proxy certificate's name against host
23# SYNOPSIS
25~~~c
26#include <curl/curl.h>
28CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSL_VERIFYHOST,
29 long verify);
30~~~
32# DESCRIPTION
34Pass a long set to 2L as asking curl to *verify* in the HTTPS proxy's
35certificate name fields against the proxy name.
37This option determines whether libcurl verifies that the proxy cert contains
38the correct name for the name it is known as.
40When CURLOPT_PROXY_SSL_VERIFYHOST(3) is 2, the proxy certificate must
41indicate that the server is the proxy to which you meant to connect to, or the
42connection fails.
44curl considers the proxy the intended one when the Common Name field or a
45Subject Alternate Name field in the certificate matches the hostname in the
46proxy string which you told curl to use.
48If *verify* value is set to 1:
50In 7.28.0 and earlier: treated as a debug option of some sorts, not supported
51anymore due to frequently leading to programmer mistakes.
53From 7.28.1 to 7.65.3: setting it to 1 made curl_easy_setopt(3) return
54an error and leaving the flag untouched.
56From 7.66.0: treats 1 and 2 the same.
58When the *verify* value is 0L, the connection succeeds regardless of the
59names used in the certificate. Use that ability with caution.
61See also CURLOPT_PROXY_SSL_VERIFYPEER(3) to verify the digital signature
62of the proxy certificate.
64# DEFAULT
68# %PROTOCOLS%
70# EXAMPLE
72~~~c
73int main(void)
75 CURL *curl = curl_easy_init();
76 if(curl) {
77 CURLcode result;
78 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
80 /* Set the default value: strict name check please */
81 curl_easy_setopt(curl, CURLOPT_PROXY_SSL_VERIFYHOST, 2L);
83 result = curl_easy_perform(curl);
84 curl_easy_cleanup(curl);
85 }
87~~~
89# %AVAILABILITY%
91# RETURN VALUE
93curl_easy_setopt(3) returns a CURLcode indicating success or error.
95CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
96libcurl-errors(3).
Diagnostics4 git calls · 217 ms
CallStatusSizeTime0217 ms
discover200152 B9 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=152
git.server.agent=gitty/1.0
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch object-format
git.server.fetch=shallow filter sideband-all
git.protocol.version=2
git.pkt.frames=8
git.pkt.data=6
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=152
git.pkt.payload.max=34
ls-refs200149 B · hit9 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=9
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=9
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=149
git.pkt.payload.max=78
git.ls_refs.count=2
git.ls_refs.head=refs/heads/master
fetchblob:none · deepen 10200287 KiB · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=205
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=blob:none
git.fetch.filter.requested=tree:0
git.fetch.filter.fallback=blob:none
git.fetch.filter.learned=false
git.fetch.wants=31c911efe5652725e930f4d2e60c9060e5f6646d
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=10
git.pkt.data=8
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=293470
git.pkt.payload.max=65516
git.sideband.band1.bytes=293354
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=87
git.pack.bytes=293354
git.pack.ofs_delta=0
git.pack.ref_delta=1
git.pack.chain.max=1
git.pack.trailer=6a646bcda6740bab42e321b51998b52ea15146c0
git.pack.full=86
Open pack map
fetch2001.2 KiB205 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1227
git.response.cache=MISS
git.response.duration_ms=205
git.fetch.wants=bc86ed1c3f18b6719068892d3c4f243204f402c4
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1227
git.pkt.payload.max=1206
git.sideband.band1.bytes=1205
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/curl.git
Ref
refs/heads/master
Commit
31c911efe5652725e930f4d2e60c9060e5f6646d
cf-ray
a5e369c1bd5c724e
Request
d47e2a4f…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format