Artifactspublic-v0

curl

master
ply4 git calls32 ms288 KiB3 cachedprotocol v2
76 lines1.8 KiBRaw

NAME

curl_formget - serialize a multipart form POST chain

SYNOPSIS

c
#include <curl/curl.h>

int curl_formget(struct curl_httppost * form, void *userp,
                 curl_formget_callback append);

DESCRIPTION

The form API (including this function) is deprecated since libcurl 7.56.0.

curl_formget() serializes data previously built with curl_formadd(3). It accepts a void pointer as second argument named userp which is passed as the first argument to the curl_formget_callback function.

c
typedef size_t (*curl_formget_callback)(void *userp, const char *buf,
                                        size_t len);

The curl_formget_callback is invoked for each part of the HTTP POST chain. The character buffer passed to the callback must not be freed. The callback should return the buffer length passed to it on success.

If the CURLFORM_STREAM option is used in the formpost, it prevents curl_formget(3) from working until you have performed the actual HTTP request. This, because first then does libcurl known which actual read callback to use.

%PROTOCOLS%

EXAMPLE

c
static size_t print_httppost_callback(void *arg, const char *buf, size_t len)
{
  fwrite(buf, len, 1, stdout);
  *((size_t *)arg) += len;
  return len;
}

size_t print_httppost(struct curl_httppost *post);
size_t print_httppost(struct curl_httppost *post)
{
  size_t total_size = 0;
  if(curl_formget(post, &total_size, print_httppost_callback)) {
    return (size_t)-1;
  }
  return total_size;
}

%AVAILABILITY%

RETURN VALUE

0 means everything was OK, non-zero means an error occurred

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: curl_formget
5Section: 3
6Source: libcurl
7See-also:
8 - curl_formadd (3)
9 - curl_mime_init (3)
10Protocol:
11 - HTTP
12Added-in: 7.15.5
13---
15# NAME
17curl_formget - serialize a multipart form POST chain
19# SYNOPSIS
21~~~c
22#include <curl/curl.h>
24int curl_formget(struct curl_httppost * form, void *userp,
25 curl_formget_callback append);
26~~~
28# DESCRIPTION
30The form API (including this function) is deprecated since libcurl 7.56.0.
32curl_formget() serializes data previously built with curl_formadd(3). It
33accepts a void pointer as second argument named *userp* which is passed as the
34first argument to the curl_formget_callback function.
36~~~c
37typedef size_t (*curl_formget_callback)(void *userp, const char *buf,
38 size_t len);
39~~~
41The *curl_formget_callback* is invoked for each part of the HTTP POST chain.
42The character buffer passed to the callback must not be freed. The callback
43should return the buffer length passed to it on success.
45If the **CURLFORM_STREAM** option is used in the formpost, it prevents
46curl_formget(3) from working until you have performed the actual HTTP request.
47This, because first then does libcurl known which actual read callback to use.
49# %PROTOCOLS%
51# EXAMPLE
53~~~c
54static size_t print_httppost_callback(void *arg, const char *buf, size_t len)
56 fwrite(buf, len, 1, stdout);
57 *((size_t *)arg) += len;
58 return len;
61size_t print_httppost(struct curl_httppost *post);
62size_t print_httppost(struct curl_httppost *post)
64 size_t total_size = 0;
65 if(curl_formget(post, &total_size, print_httppost_callback)) {
66 return (size_t)-1;
67 }
68 return total_size;
70~~~
72# %AVAILABILITY%
74# RETURN VALUE
760 means everything was OK, non-zero means an error occurred
Diagnostics4 git calls · 32 ms
CallStatusSizeTime032 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 · hit4 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=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
fetch200999 B · hit26 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=26
git.response.bytes=999
git.response.cache=HIT
git.response.duration_ms=26
git.fetch.wants=a6afea5a8208ddca2cc0c06d50978c40e2e25461
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=999
git.pkt.payload.max=978
git.sideband.band1.bytes=977
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
a5e31e40ff1e9de8
Request
51f99878…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format