Artifactspublic-v0

curl

master
ply4 git calls156 ms288 KiB2 cachedprotocol v2
86 lines2.1 KiBRaw

NAME

CURLOPT_BUFFERSIZE - receive buffer size

SYNOPSIS

c
#include <curl/curl.h>

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

DESCRIPTION

Pass a long specifying your preferred size (in bytes) for the receive buffer in libcurl. The main point of this would be that the write callback gets called more often and with smaller chunks. Secondly, for some protocols, there is a benefit of having a larger buffer for performance.

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

This buffer size is by default CURL_MAX_WRITE_SIZE (16kB). The maximum buffer size allowed to be set is CURL_MAX_READ_SIZE (10MB). The minimum buffer size allowed to be set is 1024.

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

The maximum size was 512kB until 7.88.0.

Starting in libcurl 8.7.0, there is a single transfer buffer allocated per multi handle. This buffer is used by all easy handles added to a multi handle no matter how many parallel transfers there are. The buffer remains allocated as long as there are active transfers.

DEFAULT

CURL_MAX_WRITE_SIZE (16kB)

%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 receive buffer */
    curl_easy_setopt(curl, CURLOPT_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_BUFFERSIZE
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_MAXFILESIZE (3)
9 - CURLOPT_MAX_RECV_SPEED_LARGE (3)
10 - CURLOPT_UPLOAD_BUFFERSIZE (3)
11 - CURLOPT_WRITEFUNCTION (3)
12Protocol:
13 - All
14Added-in: 7.10
15---
17# NAME
19CURLOPT_BUFFERSIZE - receive buffer size
21# SYNOPSIS
23~~~c
24#include <curl/curl.h>
26CURLcode curl_easy_setopt(CURL *handle, CURLOPT_BUFFERSIZE, long size);
27~~~
29# DESCRIPTION
31Pass a long specifying your preferred *size* (in bytes) for the receive buffer
32in libcurl. The main point of this would be that the write callback gets
33called more often and with smaller chunks. Secondly, for some protocols, there
34is a benefit of having a larger buffer for performance.
36This is treated as a request, not an order. You cannot be guaranteed to
37actually get the given size.
39This buffer size is by default *CURL_MAX_WRITE_SIZE* (16kB). The maximum
40buffer size allowed to be set is *CURL_MAX_READ_SIZE* (10MB). The minimum
41buffer size allowed to be set is 1024.
43DO NOT set this option on a handle that is currently used for an active
44transfer as that may lead to unintended consequences.
46The maximum size was 512kB until 7.88.0.
48Starting in libcurl 8.7.0, there is a single transfer buffer allocated per
49multi handle. This buffer is used by all easy handles added to a multi handle
50no matter how many parallel transfers there are. The buffer remains allocated
51as long as there are active transfers.
53# DEFAULT
55CURL_MAX_WRITE_SIZE (16kB)
57# %PROTOCOLS%
59# EXAMPLE
61~~~c
62int main(void)
64 CURL *curl = curl_easy_init();
65 if(curl) {
66 CURLcode result;
67 curl_easy_setopt(curl, CURLOPT_URL, "sftp://example.com/foo.bin");
69 /* ask libcurl to allocate a larger receive buffer */
70 curl_easy_setopt(curl, CURLOPT_BUFFERSIZE, 120000L);
72 result = curl_easy_perform(curl);
74 curl_easy_cleanup(curl);
75 }
77~~~
79# %AVAILABILITY%
81# RETURN VALUE
83curl_easy_setopt(3) returns a CURLcode indicating success or error.
85CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
86libcurl-errors(3).
Diagnostics4 git calls · 156 ms
CallStatusSizeTime0156 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=3
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 · hit5 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=148
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=5
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 KiB149 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1196
git.response.cache=MISS
git.response.duration_ms=149
git.fetch.wants=e517a30bc4c49b38d5ce29bf14449d21ee684148
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=1196
git.pkt.payload.max=1175
git.sideband.band1.bytes=1174
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
a5e37cd5fd3d9318
Request
1c4e4fc0…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format