Artifactspublic-v0

curl

master
ply4 git calls182 ms288 KiB2 cachedprotocol v2
90 lines2.5 KiBRaw

NAME

CURLOPT_PRE_PROXY - pre-proxy host to use

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PRE_PROXY, char *preproxy);

DESCRIPTION

Set the preproxy to use for the upcoming request. The parameter should be a char * to a null-terminated string holding the hostname or dotted numerical IP address. A numerical IPv6 address must be written within [brackets].

To specify port number in this string, append :[port] to the end of the host name. The proxy's port number may optionally be specified with the separate option CURLOPT_PROXYPORT(3). If not specified, libcurl defaults to using port 1080 for proxies.

A pre proxy is a SOCKS proxy that curl connects to before it connects to the HTTP(S) proxy specified in the CURLOPT_PROXY(3) option. The pre proxy can only be a SOCKS proxy.

The pre proxy string should be prefixed with [scheme]:// to specify which kind of socks is used. Use socks4://, socks4a://, socks5:// or socks5h:// (the last one to enable socks5 and asking the proxy to do the resolving, also known as CURLPROXY_SOCKS5_HOSTNAME type) to request the specific SOCKS version to be used. Otherwise SOCKS4 is used as default.

Setting the pre proxy string to "" (an empty string) explicitly disables the use of a pre proxy.

When you set a hostname to use, do not assume that there is any particular single port number used widely for proxies. Specify it.

The application does not have to keep the string around after setting this option.

Using this option multiple times makes the last set string override the previous ones. Set it to NULL to disable its use again.

DEFAULT

NULL

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/file.txt");
    curl_easy_setopt(curl, CURLOPT_PRE_PROXY, "socks4://socks-proxy:1080");
    curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:80");
    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_PRE_PROXY
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_HTTPPROXYTUNNEL (3)
9 - CURLOPT_PROXY (3)
10Protocol:
11 - All
12Added-in: 7.52.0
13---
15# NAME
17CURLOPT_PRE_PROXY - pre-proxy host to use
19# SYNOPSIS
21~~~c
22#include <curl/curl.h>
24CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PRE_PROXY, char *preproxy);
25~~~
27# DESCRIPTION
29Set the *preproxy* to use for the upcoming request. The parameter should be a
30char * to a null-terminated string holding the hostname or dotted numerical IP
31address. A numerical IPv6 address must be written within [brackets].
33To specify port number in this string, append :[port] to the end of the host
34name. The proxy's port number may optionally be specified with the separate
35option CURLOPT_PROXYPORT(3). If not specified, libcurl defaults to using
36port 1080 for proxies.
38A pre proxy is a SOCKS proxy that curl connects to before it connects to the
39HTTP(S) proxy specified in the CURLOPT_PROXY(3) option. The pre proxy
40can only be a SOCKS proxy.
42The pre proxy string should be prefixed with `[scheme]://` to specify which
43kind of socks is used. Use `socks4://`, `socks4a://`, `socks5://` or
44`socks5h://` (the last one to enable socks5 and asking the proxy to do the
45resolving, also known as *CURLPROXY_SOCKS5_HOSTNAME* type) to request the
46specific SOCKS version to be used. Otherwise SOCKS4 is used as default.
48Setting the pre proxy string to "" (an empty string) explicitly disables the
49use of a pre proxy.
51When you set a hostname to use, do not assume that there is any particular
52single port number used widely for proxies. Specify it.
54The application does not have to keep the string around after setting this
55option.
57Using this option multiple times makes the last set string override the
58previous ones. Set it to NULL to disable its use again.
60# DEFAULT
62NULL
64# %PROTOCOLS%
66# EXAMPLE
68~~~c
69int main(void)
71 CURL *curl = curl_easy_init();
72 if(curl) {
73 CURLcode result;
74 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/file.txt");
75 curl_easy_setopt(curl, CURLOPT_PRE_PROXY, "socks4://socks-proxy:1080");
76 curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:80");
77 result = curl_easy_perform(curl);
78 curl_easy_cleanup(curl);
79 }
81~~~
83# %AVAILABILITY%
85# RETURN VALUE
87curl_easy_setopt(3) returns a CURLcode indicating success or error.
89CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
90libcurl-errors(3).
Diagnostics4 git calls · 182 ms
CallStatusSizeTime0182 ms
discover200152 B2 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 · hit2 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=2
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=177
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.3 KiB177 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1358
git.response.cache=MISS
git.response.duration_ms=177
git.fetch.wants=06d0f320f48dee4b212cff9914231423abd74953
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=1358
git.pkt.payload.max=1337
git.sideband.band1.bytes=1336
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
a5e368f7480b724e
Request
127a8089…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format