Artifactspublic-v0

curl

master
ply4 git calls297 ms288 KiB2 cachedprotocol v2
82 lines1.9 KiBRaw

NAME

CURLOPT_UPLOAD_BUFFERSIZE - upload buffer size

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_UPLOAD_BUFFERSIZE, long size);

DESCRIPTION

Pass a long specifying your preferred size (in bytes) for the upload buffer in libcurl. It makes libcurl uses a larger buffer that gets passed to the next layer in the stack to get sent off. In some setups and for some protocols, there is a huge performance benefit of having a larger upload buffer.

This is treated as a request, not an order. You cannot be guaranteed to actually get the given size.

The upload buffer size is by default 64 kilobytes. The maximum buffer size allowed to be set is 2 megabytes. The minimum buffer size allowed to be set is 16 kilobytes.

The upload buffer is allocated on-demand - so if the handle is not used for upload, this buffer is not allocated at all.

DO NOT set this option on a handle that is currently used for an active transfer as that may lead to unintended consequences.

DEFAULT

65536 bytes

%PROTOCOLS%

EXAMPLE

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

    /* ask libcurl to allocate a larger upload buffer */
    curl_easy_setopt(curl, CURLOPT_UPLOAD_BUFFERSIZE, 120000L);

    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_UPLOAD_BUFFERSIZE
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_BUFFERSIZE (3)
9 - CURLOPT_READFUNCTION (3)
10 - CURLOPT_TCP_NODELAY (3)
11Protocol:
12 - All
13Added-in: 7.62.0
14---
16# NAME
18CURLOPT_UPLOAD_BUFFERSIZE - upload buffer size
20# SYNOPSIS
22~~~c
23#include <curl/curl.h>
25CURLcode curl_easy_setopt(CURL *handle, CURLOPT_UPLOAD_BUFFERSIZE, long size);
26~~~
28# DESCRIPTION
30Pass a long specifying your preferred *size* (in bytes) for the upload
31buffer in libcurl. It makes libcurl uses a larger buffer that gets passed to
32the next layer in the stack to get sent off. In some setups and for some
33protocols, there is a huge performance benefit of having a larger upload
34buffer.
36This is treated as a request, not an order. You cannot be guaranteed to
37actually get the given size.
39The upload buffer size is by default 64 kilobytes. The maximum buffer size
40allowed to be set is 2 megabytes. The minimum buffer size allowed to be set is
4116 kilobytes.
43The upload buffer is allocated on-demand - so if the handle is not used for
44upload, this buffer is not allocated at all.
46DO NOT set this option on a handle that is currently used for an active
47transfer as that may lead to unintended consequences.
49# DEFAULT
5165536 bytes
53# %PROTOCOLS%
55# EXAMPLE
57~~~c
58int main(void)
60 CURL *curl = curl_easy_init();
61 if(curl) {
62 CURLcode result;
63 curl_easy_setopt(curl, CURLOPT_URL, "sftp://example.com/foo.bin");
65 /* ask libcurl to allocate a larger upload buffer */
66 curl_easy_setopt(curl, CURLOPT_UPLOAD_BUFFERSIZE, 120000L);
68 result = curl_easy_perform(curl);
70 curl_easy_cleanup(curl);
71 }
73~~~
75# %AVAILABILITY%
77# RETURN VALUE
79curl_easy_setopt(3) returns a CURLcode indicating success or error.
81CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
82libcurl-errors(3).
Diagnostics4 git calls · 297 ms
CallStatusSizeTime0297 ms
discover200152 B3 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=292
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.0 KiB292 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1070
git.response.cache=MISS
git.response.duration_ms=292
git.fetch.wants=425fe23debd24bfd2b6b54f0636161a96be0296b
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=1070
git.pkt.payload.max=1049
git.sideband.band1.bytes=1048
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
a5e39806fded1e9f
Request
7662dcef…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format