Artifactspublic-v0

curl

master
ply4 git calls122 ms288 KiB2 cachedprotocol v2
117 lines2.5 KiBRaw

NAME

CURLOPT_REDIR_PROTOCOLS - protocols allowed to redirect to

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_REDIR_PROTOCOLS, long bitmask);

DESCRIPTION

This option is deprecated. We strongly recommend using CURLOPT_REDIR_PROTOCOLS_STR(3) instead because this option cannot control all available protocols.

Pass a long that holds a bitmask of protocol bits. If used, this bitmask limits what protocols libcurl may use in a transfer that it follows to in a redirect when CURLOPT_FOLLOWLOCATION(3) is enabled. This allows you to limit specific transfers to only be allowed to use a subset of protocols in redirections.

Protocols denied by CURLOPT_PROTOCOLS(3) are not overridden by this option.

By default libcurl allows HTTP, HTTPS, FTP and FTPS on redirect (7.65.2). CURLPROTO_ALL enables all protocols on redirect, including those otherwise disabled for security.

These are the available protocol defines:

c
CURLPROTO_DICT
CURLPROTO_FILE
CURLPROTO_FTP
CURLPROTO_FTPS
CURLPROTO_GOPHER
CURLPROTO_HTTP
CURLPROTO_HTTPS
CURLPROTO_IMAP
CURLPROTO_IMAPS
CURLPROTO_LDAP
CURLPROTO_LDAPS
CURLPROTO_MQTT
CURLPROTO_POP3
CURLPROTO_POP3S
CURLPROTO_RTSP
CURLPROTO_SCP
CURLPROTO_SFTP
CURLPROTO_SMTP
CURLPROTO_SMTPS
CURLPROTO_TELNET
CURLPROTO_TFTP

DEFAULT

HTTP, HTTPS, FTP and FTPS

%PROTOCOLS%

EXAMPLE

c
int main(int argc, char *argv[])
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    /* pass in the URL from an external source */
    curl_easy_setopt(curl, CURLOPT_URL, argv[1]);

    /* only allow redirects to HTTP and HTTPS URLs */
    curl_easy_setopt(curl, CURLOPT_REDIR_PROTOCOLS,
                     CURLPROTO_HTTP | CURLPROTO_HTTPS);

    /* Perform the request */
    result = curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }
}

HISTORY

CURLPROTO_* macros became long types in 8.16.0, prior to this version a long cast was necessary when passed to curl_easy_setopt(3).

DEPRECATED

Deprecated since 7.85.0.

%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_REDIR_PROTOCOLS
5Section: 3
6Source: libcurl
7See-also:
8 - CURLINFO_SCHEME (3)
9 - CURLOPT_DEFAULT_PROTOCOL (3)
10 - CURLOPT_PROTOCOLS (3)
11 - CURLOPT_REDIR_PROTOCOLS_STR (3)
12Protocol:
13 - HTTP
14Added-in: 7.19.4
15---
17# NAME
19CURLOPT_REDIR_PROTOCOLS - protocols allowed to redirect to
21# SYNOPSIS
23~~~c
24#include <curl/curl.h>
26CURLcode curl_easy_setopt(CURL *handle, CURLOPT_REDIR_PROTOCOLS, long bitmask);
27~~~
29# DESCRIPTION
31This option is deprecated. We strongly recommend using
32CURLOPT_REDIR_PROTOCOLS_STR(3) instead because this option cannot
33control all available protocols.
35Pass a long that holds a bitmask of protocol bits. If used, this bitmask
36limits what protocols libcurl may use in a transfer that it follows to in a
37redirect when CURLOPT_FOLLOWLOCATION(3) is enabled. This allows you to limit
38specific transfers to only be allowed to use a subset of protocols in
39redirections.
41Protocols denied by CURLOPT_PROTOCOLS(3) are not overridden by this
42option.
44By default libcurl allows HTTP, HTTPS, FTP and FTPS on redirect (7.65.2).
45*CURLPROTO_ALL* enables all protocols on redirect, including those
46otherwise disabled for security.
48These are the available protocol defines:
49~~~c
50CURLPROTO_DICT
51CURLPROTO_FILE
52CURLPROTO_FTP
53CURLPROTO_FTPS
54CURLPROTO_GOPHER
55CURLPROTO_HTTP
56CURLPROTO_HTTPS
57CURLPROTO_IMAP
58CURLPROTO_IMAPS
59CURLPROTO_LDAP
60CURLPROTO_LDAPS
61CURLPROTO_MQTT
62CURLPROTO_POP3
63CURLPROTO_POP3S
64CURLPROTO_RTSP
65CURLPROTO_SCP
66CURLPROTO_SFTP
67CURLPROTO_SMTP
68CURLPROTO_SMTPS
69CURLPROTO_TELNET
70CURLPROTO_TFTP
71~~~
73# DEFAULT
75HTTP, HTTPS, FTP and FTPS
77# %PROTOCOLS%
79# EXAMPLE
81~~~c
82int main(int argc, char *argv[])
84 CURL *curl = curl_easy_init();
85 if(curl) {
86 CURLcode result;
87 /* pass in the URL from an external source */
88 curl_easy_setopt(curl, CURLOPT_URL, argv[1]);
90 /* only allow redirects to HTTP and HTTPS URLs */
91 curl_easy_setopt(curl, CURLOPT_REDIR_PROTOCOLS,
92 CURLPROTO_HTTP | CURLPROTO_HTTPS);
94 /* Perform the request */
95 result = curl_easy_perform(curl);
96 curl_easy_cleanup(curl);
97 }
99~~~
101# HISTORY
103**CURLPROTO_*** macros became `long` types in 8.16.0, prior to this version
104a `long` cast was necessary when passed to curl_easy_setopt(3).
106# DEPRECATED
108Deprecated since 7.85.0.
110# %AVAILABILITY%
112# RETURN VALUE
114curl_easy_setopt(3) returns a CURLcode indicating success or error.
116CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
117libcurl-errors(3).
Diagnostics4 git calls · 122 ms
CallStatusSizeTime0122 ms
discover200152 B2 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
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=2
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 KiB117 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=117
git.response.bytes=1280
git.response.cache=MISS
git.response.duration_ms=117
git.fetch.wants=0e9098d76303b24154aca40dd8812efc53056c50
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=1280
git.pkt.payload.max=1259
git.sideband.band1.bytes=1258
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
a5e34caebd208a31
Request
ca34c2c0…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format