Artifactspublic-v0

curl

master
ply4 git calls23 ms288 KiB3 cachedprotocol v2
79 lines2.0 KiBRaw

NAME

curl_easy_cleanup - free an easy handle

SYNOPSIS

c
#include <curl/curl.h>

void curl_easy_cleanup(CURL *handle);

DESCRIPTION

This function is the opposite of curl_easy_init(3). It closes down and frees all resources previously associated with this easy handle.

This call closes all connections this handle has used and possibly has kept open until now unless the easy handle was attached to a multi handle while doing the transfers. Do not call this function if you intend to transfer more files, reusing handles is a key to good performance with libcurl.

Occasionally you may get your progress callback or header callback called from within curl_easy_cleanup(3) (if previously set for the handle using curl_easy_setopt(3)). Like if libcurl decides to shut down the connection and the protocol is of a kind that requires a command/response sequence before disconnect. Examples of such protocols are FTP, POP3 and IMAP.

Any use of the easy handle after this function has been called and have returned, is illegal.

To close an easy handle that has been used with the multi interface, make sure to first call curl_multi_remove_handle(3) to remove it from the multi handle before it is closed.

Passing in a NULL pointer in handle makes this function return immediately with no action.

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
    result = curl_easy_perform(curl);
    if(result != CURLE_OK)
      printf("error: %s\n", curl_easy_strerror(result));
    curl_easy_cleanup(curl);
  }
}

%AVAILABILITY%

RETURN VALUE

None

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: curl_easy_cleanup
5Section: 3
6Source: libcurl
7See-also:
8 - curl_easy_duphandle (3)
9 - curl_easy_init (3)
10 - curl_easy_reset (3)
11 - curl_multi_cleanup (3)
12 - curl_multi_remove_handle (3)
13Protocol:
14 - All
15Added-in: 7.1
16---
18# NAME
20curl_easy_cleanup - free an easy handle
22# SYNOPSIS
24~~~c
25#include <curl/curl.h>
27void curl_easy_cleanup(CURL *handle);
28~~~
30# DESCRIPTION
32This function is the opposite of curl_easy_init(3). It closes down and frees
33all resources previously associated with this easy handle.
35This call closes all connections this handle has used and possibly has kept
36open until now unless the easy handle was attached to a multi handle while
37doing the transfers. Do not call this function if you intend to transfer more
38files, reusing handles is a key to good performance with libcurl.
40Occasionally you may get your progress callback or header callback called from
41within curl_easy_cleanup(3) (if previously set for the handle using
42curl_easy_setopt(3)). Like if libcurl decides to shut down the connection and
43the protocol is of a kind that requires a command/response sequence before
44disconnect. Examples of such protocols are FTP, POP3 and IMAP.
46Any use of the easy **handle** after this function has been called and have
47returned, is illegal.
49To close an easy handle that has been used with the multi interface, make sure
50to first call curl_multi_remove_handle(3) to remove it from the multi handle
51before it is closed.
53Passing in a NULL pointer in *handle* makes this function return immediately
54with no action.
56# %PROTOCOLS%
58# EXAMPLE
60~~~c
61int main(void)
63 CURL *curl = curl_easy_init();
64 if(curl) {
65 CURLcode result;
66 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
67 result = curl_easy_perform(curl);
68 if(result != CURLE_OK)
69 printf("error: %s\n", curl_easy_strerror(result));
70 curl_easy_cleanup(curl);
71 }
73~~~
75# %AVAILABILITY%
77# RETURN VALUE
79None
Diagnostics4 git calls · 23 ms
CallStatusSizeTime023 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=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=19
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 · hit19 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1100
git.response.cache=HIT
git.response.duration_ms=19
git.fetch.wants=bf9b18b3634d79c9e08ca571273a43f0316c1768
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=1100
git.pkt.payload.max=1079
git.sideband.band1.bytes=1078
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
a5e351bcff93224d
Request
c1fc1600…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format