Artifactspublic-v0

curl

master
ply4 git calls26 ms288 KiB3 cachedprotocol v2
54 lines2.0 KiBRaw

NAME

libcurl-easy - easy interface overview

DESCRIPTION

When using libcurl's "easy" interface you init your session and get a handle (often referred to as an "easy handle"), which you use as input to the easy interface functions you use. Use curl_easy_init(3) to get the handle.

You continue by setting all the options you want in the upcoming transfer, the most important among them is the URL itself (you cannot transfer anything without a specified URL). You might want to set some callbacks as well that are called from the library when data is available etc. For example CURLOPT_WRITEFUNCTION(3). curl_easy_setopt(3) is used for all this.

CURLOPT_URL(3) is the only option you really must set, as otherwise there can be no transfer. Another commonly used option is CURLOPT_VERBOSE(3) that helps you see what libcurl is doing under the hood, which is useful when debugging for example. The curl_easy_setopt(3) man page has a full index of the over 300 available options.

If you at any point would like to factory-reset all previously set options for a single easy handle, you can call curl_easy_reset(3). You can also make a clone of an easy handle (with all its set options) using curl_easy_duphandle(3).

When all necessary options have been set on the handle, you tell libcurl to perform the transfer with curl_easy_perform(3). It performs the entire transfer operation and does not return until it is done (successfully or not).

After the transfer has been made, you can set new options and make another transfer, or if you are done, cleanup the session by calling curl_easy_cleanup(3). If you want persistent connections, you do not cleanup immediately, but instead run ahead and perform other transfers using the same easy handle.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: libcurl-easy
5Section: 3
6Source: libcurl
7See-also:
8 - curl_easy_cleanup (3)
9 - curl_easy_init (3)
10 - curl_easy_setopt (3)
11 - libcurl (3)
12 - libcurl-errors (3)
13 - libcurl-multi (3)
14Protocol:
15 - All
16Added-in: 7.1
17---
19# NAME
21libcurl-easy - easy interface overview
23# DESCRIPTION
25When using libcurl's "easy" interface you init your session and get a handle
26(often referred to as an "easy handle"), which you use as input to the easy
27interface functions you use. Use curl_easy_init(3) to get the handle.
29You continue by setting all the options you want in the upcoming transfer, the
30most important among them is the URL itself (you cannot transfer anything
31without a specified URL). You might want to set some callbacks as well that
32are called from the library when data is available etc. For example
33CURLOPT_WRITEFUNCTION(3). curl_easy_setopt(3) is used for all this.
35CURLOPT_URL(3) is the only option you really must set, as otherwise there can
36be no transfer. Another commonly used option is CURLOPT_VERBOSE(3) that helps
37you see what libcurl is doing under the hood, which is useful when debugging
38for example. The curl_easy_setopt(3) man page has a full index of the over 300
39available options.
41If you at any point would like to factory-reset all previously set options for
42a single easy handle, you can call curl_easy_reset(3). You can also make a
43clone of an easy handle (with all its set options) using
44curl_easy_duphandle(3).
46When all necessary options have been set on the handle, you tell libcurl to
47perform the transfer with curl_easy_perform(3). It performs the entire
48transfer operation and does not return until it is done (successfully or not).
50After the transfer has been made, you can set new options and make another
51transfer, or if you are done, cleanup the session by calling
52curl_easy_cleanup(3). If you want persistent connections, you do not cleanup
53immediately, but instead run ahead and perform other transfers using the same
54easy handle.
Diagnostics4 git calls · 26 ms
CallStatusSizeTime026 ms
discover200152 B4 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=1
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=20
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.1 KiB · hit20 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1090
git.response.cache=HIT
git.response.duration_ms=20
git.fetch.wants=fdbc75582371901ec8d6cff75e7bb6d68676f446
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=1090
git.pkt.payload.max=1069
git.sideband.band1.bytes=1068
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
a5e35481ac04994c
Request
ecc7f1cd…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format