Artifactspublic-v0

curl

master
ply4 git calls76 ms288 KiB3 cachedprotocol v2
84 lines2.1 KiBRaw

NAME

CURLINFO_ACTIVESOCKET - active socket

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_ACTIVESOCKET,
                           curl_socket_t *socket);

DESCRIPTION

Pass a pointer to a curl_socket_t to receive the most recently active socket used for the transfer connection by this curl session. If the socket is no longer valid, CURL_SOCKET_BAD is returned. When you are finished working with the socket, you must call curl_easy_cleanup(3) as usual on the easy handle and let libcurl close the socket and cleanup other resources associated with the handle. This option returns the active socket only after the transfer is complete, and is typically used in combination with CURLOPT_CONNECT_ONLY(3), which skips the transfer phase.

CURLINFO_ACTIVESOCKET(3) was added as a replacement for CURLINFO_LASTSOCKET(3) since that one is not working on all platforms.

%PROTOCOLS%

EXAMPLE

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

    /* Do not do the transfer - only connect to host */
    curl_easy_setopt(curl, CURLOPT_CONNECT_ONLY, 1L);
    result = curl_easy_perform(curl);
    if(result != CURLE_OK) {
      printf("Error: %s\n", curl_easy_strerror(result));
      curl_easy_cleanup(curl);
      return 1;
    }

    /* Extract the socket from the curl handle */
    result = curl_easy_getinfo(curl, CURLINFO_ACTIVESOCKET, &sockfd);
    if(!result && sockfd != CURL_SOCKET_BAD) {
      /* operate on sockfd */
    }

    curl_easy_cleanup(curl);
  }
}

%AVAILABILITY%

RETURN VALUE

curl_easy_getinfo(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: CURLINFO_ACTIVESOCKET
5Section: 3
6Source: libcurl
7See-also:
8 - CURLINFO_LASTSOCKET (3)
9 - CURLOPT_CONNECT_ONLY (3)
10 - curl_easy_getinfo (3)
11 - curl_easy_setopt (3)
12Protocol:
13 - All
14Added-in: 7.45.0
15---
17# NAME
19CURLINFO_ACTIVESOCKET - active socket
21# SYNOPSIS
23~~~c
24#include <curl/curl.h>
26CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_ACTIVESOCKET,
27 curl_socket_t *socket);
28~~~
30# DESCRIPTION
32Pass a pointer to a curl_socket_t to receive the most recently active socket
33used for the transfer connection by this curl session. If the socket is no
34longer valid, *CURL_SOCKET_BAD* is returned. When you are finished working
35with the socket, you must call curl_easy_cleanup(3) as usual on the easy
36handle and let libcurl close the socket and cleanup other resources associated
37with the handle. This option returns the active socket only after the transfer
38is complete, and is typically used in combination with
39CURLOPT_CONNECT_ONLY(3), which skips the transfer phase.
41CURLINFO_ACTIVESOCKET(3) was added as a replacement for
42CURLINFO_LASTSOCKET(3) since that one is not working on all platforms.
44# %PROTOCOLS%
46# EXAMPLE
48~~~c
49int main(void)
51 CURL *curl = curl_easy_init();
52 if(curl) {
53 CURLcode result;
54 curl_socket_t sockfd;
55 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
57 /* Do not do the transfer - only connect to host */
58 curl_easy_setopt(curl, CURLOPT_CONNECT_ONLY, 1L);
59 result = curl_easy_perform(curl);
60 if(result != CURLE_OK) {
61 printf("Error: %s\n", curl_easy_strerror(result));
62 curl_easy_cleanup(curl);
63 return 1;
64 }
66 /* Extract the socket from the curl handle */
67 result = curl_easy_getinfo(curl, CURLINFO_ACTIVESOCKET, &sockfd);
68 if(!result && sockfd != CURL_SOCKET_BAD) {
69 /* operate on sockfd */
70 }
72 curl_easy_cleanup(curl);
73 }
75~~~
77# %AVAILABILITY%
79# RETURN VALUE
81curl_easy_getinfo(3) returns a CURLcode indicating success or error.
83CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
84libcurl-errors(3).
Diagnostics4 git calls · 76 ms
CallStatusSizeTime076 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 · 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 · hit21 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=21
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 · hit52 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=52
git.response.bytes=1128
git.response.cache=HIT
git.response.duration_ms=52
git.fetch.wants=9dbf4f857339d18add719e958852f4648eb2676f
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=1128
git.pkt.payload.max=1107
git.sideband.band1.bytes=1106
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
a5e31c45fcd98682
Request
18e7c03c…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format