Artifactspublic-v0

curl

master
ply4 git calls483 ms288 KiB2 cachedprotocol v2
77 lines1.8 KiBRaw

NAME

CURLOPT_FTP_USE_EPRT - use EPRT for FTP

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_USE_EPRT, long enabled);

DESCRIPTION

Pass a long. If the value is 1, it tells curl to use the EPRT command when doing active FTP downloads (which is enabled by CURLOPT_FTPPORT(3)). Using EPRT means that libcurl first attempts to use EPRT before using PORT, but if you pass zero to this option, it avoids using EPRT, only plain PORT.

The EPRT command is a slightly newer addition to the FTP protocol than PORT and is the preferred command to use since it enables IPv6 to be used. Old FTP servers might not support it, which is why libcurl has a fallback mechanism. Sometimes that fallback is not enough and then this option might come handy.

If the server is an IPv6 host, this option has no effect as EPRT is necessary then.

DEFAULT

%PROTOCOLS%

EXAMPLE

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

    /* contact us back, aka "active" FTP */
    curl_easy_setopt(curl, CURLOPT_FTPPORT, "-");

    /* FTP the way the neanderthals did it */
    curl_easy_setopt(curl, CURLOPT_FTP_USE_EPRT, 0L);

    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_FTP_USE_EPRT
5Section: 3
6Source: libcurl
7Protocol:
8 - FTP
9See-also:
10 - CURLOPT_FTPPORT (3)
11 - CURLOPT_FTP_USE_EPSV (3)
12Added-in: 7.10.5
13---
15# NAME
17CURLOPT_FTP_USE_EPRT - use EPRT for FTP
19# SYNOPSIS
21~~~c
22#include <curl/curl.h>
24CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_USE_EPRT, long enabled);
25~~~
27# DESCRIPTION
29Pass a long. If the value is 1, it tells curl to use the EPRT command when
30doing active FTP downloads (which is enabled by
31CURLOPT_FTPPORT(3)). Using EPRT means that libcurl first attempts to use
32EPRT before using PORT, but if you pass zero to this option, it avoids using
33EPRT, only plain PORT.
35The EPRT command is a slightly newer addition to the FTP protocol than PORT
36and is the preferred command to use since it enables IPv6 to be used. Old FTP
37servers might not support it, which is why libcurl has a fallback mechanism.
38Sometimes that fallback is not enough and then this option might come handy.
40If the server is an IPv6 host, this option has no effect as EPRT is necessary
41then.
43# DEFAULT
45# %PROTOCOLS%
47# EXAMPLE
49~~~c
50int main(void)
52 CURL *curl = curl_easy_init();
53 if(curl) {
54 CURLcode result;
55 curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/file.txt");
57 /* contact us back, aka "active" FTP */
58 curl_easy_setopt(curl, CURLOPT_FTPPORT, "-");
60 /* FTP the way the neanderthals did it */
61 curl_easy_setopt(curl, CURLOPT_FTP_USE_EPRT, 0L);
63 result = curl_easy_perform(curl);
65 curl_easy_cleanup(curl);
66 }
68~~~
70# %AVAILABILITY%
72# RETURN VALUE
74curl_easy_setopt(3) returns a CURLcode indicating success or error.
76CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
77libcurl-errors(3).
Diagnostics4 git calls · 483 ms
CallStatusSizeTime0483 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=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 · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=479
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=2
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
fetch2001022 B479 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1022
git.response.cache=MISS
git.response.duration_ms=479
git.fetch.wants=781a2c75de2361975caf4a78025ba602598c370a
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=1022
git.pkt.payload.max=1001
git.sideband.band1.bytes=1000
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
a5e37f7c19e39318
Request
35006f39…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format