Artifactspublic-v0

curl

master
ply4 git calls185 ms288 KiB2 cachedprotocol v2
100 lines2.7 KiBRaw

NAME

CURLOPT_FTPPORT - make FTP transfer active

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTPPORT, char *spec);

DESCRIPTION

Pass a pointer to a null-terminated string as parameter. It specifies that the FTP transfer should be made actively and the given string is used to get the IP address to use for the FTP PORT instruction.

The PORT instruction tells the remote server to do a TCP connect to our specified IP address. The string may be a plain IP address, a hostname, a network interface name (under Unix) or a '-' symbol to let the library use your system's default IP address. Default FTP operations are passive, and does not use the PORT command.

The address can be followed by a ':' to specify a port, optionally followed by a '-' to specify a port range. If the port specified is 0, the operating system picks a free port. If a range is provided and all ports in the range are not available, libcurl reports CURLE_FTP_PORT_FAILED for the handle. Invalid port/range settings are ignored. IPv6 addresses followed by a port or port range have to be in brackets. IPv6 addresses without port/range specifier can be in brackets.

Examples with specified ports:

eth0:0
192.168.1.2:32000-33000
curl.se:32123
[::1]:1234-4567

We strongly advise against specifying the address with a name, as it causes libcurl to do a blocking name resolve call to retrieve the IP address. That name resolve operation does not use DNS-over-HTTPS even if CURLOPT_DOH_URL(3) is set.

Using anything else than "-" for this option should typically only be done if you have special knowledge and confirmation that it works.

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. You disable PORT again and go back to using the passive version by setting this option to NULL.

DEFAULT

NULL

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL,
                     "ftp://example.com/old-server/file.txt");
    curl_easy_setopt(curl, CURLOPT_FTPPORT, "-");
    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_FTPPORT
5Section: 3
6Source: libcurl
7Protocol:
8 - FTP
9See-also:
10 - CURLOPT_FTP_USE_EPRT (3)
11 - CURLOPT_FTP_USE_EPSV (3)
12 - CURLOPT_ACCEPTTIMEOUT_MS (3)
13Added-in: 7.1
14---
16# NAME
18CURLOPT_FTPPORT - make FTP transfer active
20# SYNOPSIS
22~~~c
23#include <curl/curl.h>
25CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTPPORT, char *spec);
26~~~
28# DESCRIPTION
30Pass a pointer to a null-terminated string as parameter. It specifies that the
31FTP transfer should be made actively and the given string is used to get the
32IP address to use for the FTP PORT instruction.
34The PORT instruction tells the remote server to do a TCP connect to our
35specified IP address. The string may be a plain IP address, a hostname, a
36network interface name (under Unix) or a '-' symbol to let the library use
37your system's default IP address. Default FTP operations are passive, and does
38not use the PORT command.
40The address can be followed by a ':' to specify a port, optionally followed by
41a '-' to specify a port range. If the port specified is 0, the operating
42system picks a free port. If a range is provided and all ports in the range
43are not available, libcurl reports CURLE_FTP_PORT_FAILED for the
44handle. Invalid port/range settings are ignored. IPv6 addresses followed by a
45port or port range have to be in brackets. IPv6 addresses without port/range
46specifier can be in brackets.
48Examples with specified ports:
50 eth0:0
51 192.168.1.2:32000-33000
52 curl.se:32123
53 [::1]:1234-4567
55We strongly advise against specifying the address with a name, as it causes
56libcurl to do a blocking name resolve call to retrieve the IP address. That
57name resolve operation does **not** use DNS-over-HTTPS even if
58CURLOPT_DOH_URL(3) is set.
60Using anything else than "-" for this option should typically only be done if
61you have special knowledge and confirmation that it works.
63The application does not have to keep the string around after setting this
64option.
66Using this option multiple times makes the last set string override the
67previous ones. You disable PORT again and go back to using the passive version
68by setting this option to NULL.
70# DEFAULT
72NULL
74# %PROTOCOLS%
76# EXAMPLE
78~~~c
79int main(void)
81 CURL *curl = curl_easy_init();
82 if(curl) {
83 CURLcode result;
84 curl_easy_setopt(curl, CURLOPT_URL,
85 "ftp://example.com/old-server/file.txt");
86 curl_easy_setopt(curl, CURLOPT_FTPPORT, "-");
87 result = curl_easy_perform(curl);
88 curl_easy_cleanup(curl);
89 }
91~~~
93# %AVAILABILITY%
95# RETURN VALUE
97curl_easy_setopt(3) returns a CURLcode indicating success or error.
99CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
100libcurl-errors(3).
Diagnostics4 git calls · 185 ms
CallStatusSizeTime0185 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=3
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.5 KiB180 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=180
git.response.bytes=1514
git.response.cache=MISS
git.response.duration_ms=180
git.fetch.wants=fe60393633e302731cb1e12366a58593c3eb812e
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=1514
git.pkt.payload.max=1493
git.sideband.band1.bytes=1492
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
a5e34142e97ebe76
Request
f6adb618…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format