Artifactspublic-v0

curl

master
ply4 git calls135 ms288 KiB2 cachedprotocol v2
92 lines2.2 KiBRaw

NAME

CURLOPT_FTP_FILEMETHOD - select directory traversing method for FTP

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_FILEMETHOD,
                          long method);

DESCRIPTION

Pass a long telling libcurl which method to use to reach a file on a FTP(S) server.

This option exists because some server implementations are not compliant to what the standards say should work.

The argument should be one of the following alternatives:

CURLFTPMETHOD_MULTICWD

libcurl does a single CWD operation for each path part in the given URL. For deep hierarchies this means many commands. This is how RFC 1738 says it should be done. This is the default but the slowest behavior.

CURLFTPMETHOD_NOCWD

libcurl makes no CWD at all. libcurl does SIZE, RETR, STOR etc and gives a full path to the server for all these commands. This is the fastest behavior since it skips having to change directories.

CURLFTPMETHOD_SINGLECWD

libcurl does one CWD with the full target directory and then operates on the file &"normally" (like in the multicwd case). This is somewhat more standards compliant than 'nocwd' but without the full penalty of 'multicwd'.

DEFAULT

CURLFTPMETHOD_MULTICWD

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/1/2/3/4/new.txt");
    curl_easy_setopt(curl, CURLOPT_FTP_FILEMETHOD, CURLFTPMETHOD_SINGLECWD);

    result = curl_easy_perform(curl);

    curl_easy_cleanup(curl);
  }
}

HISTORY

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

%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_FILEMETHOD
5Section: 3
6Source: libcurl
7Protocol:
8 - FTP
9See-also:
10 - CURLOPT_DIRLISTONLY (3)
11 - CURLOPT_FTP_SKIP_PASV_IP (3)
12Added-in: 7.15.1
13---
15# NAME
17CURLOPT_FTP_FILEMETHOD - select directory traversing method for FTP
19# SYNOPSIS
21~~~c
22#include <curl/curl.h>
24CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_FILEMETHOD,
25 long method);
26~~~
28# DESCRIPTION
30Pass a long telling libcurl which *method* to use to reach a file on a
31FTP(S) server.
33This option exists because some server implementations are not compliant to
34what the standards say should work.
36The argument should be one of the following alternatives:
38## CURLFTPMETHOD_MULTICWD
40libcurl does a single CWD operation for each path part in the given URL. For
41deep hierarchies this means many commands. This is how RFC 1738 says it should
42be done. This is the default but the slowest behavior.
44## CURLFTPMETHOD_NOCWD
46libcurl makes no CWD at all. libcurl does SIZE, RETR, STOR etc and gives a
47full path to the server for all these commands. This is the fastest behavior
48since it skips having to change directories.
50## CURLFTPMETHOD_SINGLECWD
52libcurl does one CWD with the full target directory and then operates on the
53file &"normally" (like in the multicwd case). This is somewhat more standards
54compliant than 'nocwd' but without the full penalty of 'multicwd'.
56# DEFAULT
58CURLFTPMETHOD_MULTICWD
60# %PROTOCOLS%
62# EXAMPLE
64~~~c
65int main(void)
67 CURL *curl = curl_easy_init();
68 if(curl) {
69 CURLcode result;
70 curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/1/2/3/4/new.txt");
71 curl_easy_setopt(curl, CURLOPT_FTP_FILEMETHOD, CURLFTPMETHOD_SINGLECWD);
73 result = curl_easy_perform(curl);
75 curl_easy_cleanup(curl);
76 }
78~~~
80# HISTORY
82**CURLFTPMETHOD_*** enums became `long` types in 8.16.0, prior to this version
83a `long` cast was necessary when passed to curl_easy_setopt(3).
85# %AVAILABILITY%
87# RETURN VALUE
89curl_easy_setopt(3) returns a CURLcode indicating success or error.
91CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
92libcurl-errors(3).
Diagnostics4 git calls · 135 ms
CallStatusSizeTime0135 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 · hit3 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=3
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=2
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
fetch2001.2 KiB130 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=130
git.response.bytes=1235
git.response.cache=MISS
git.response.duration_ms=130
git.fetch.wants=dffec993d43407ab26f5b28c3aaf939034750505
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=1235
git.pkt.payload.max=1214
git.sideband.band1.bytes=1213
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
a5e3136befc43e6e
Request
99decf47…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format