Artifactspublic-v0

curl

master
ply4 git calls128 ms288 KiB2 cachedprotocol v2
78 lines1.9 KiBRaw

NAME

CURLOPT_NOSIGNAL - skip all signal handling

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NOSIGNAL, long onoff);

DESCRIPTION

If onoff is 1, libcurl uses no functions that install signal handlers or any functions that cause signals to be sent to the process. This option is here to allow multi-threaded Unix applications to still set/use all timeout options etc, without risking getting signals.

If this option is set and libcurl has been built with the standard name resolver, timeouts cannot occur while the name resolve takes place. Consider building libcurl with the c-ares or threaded resolver backends to enable asynchronous DNS lookups, to enable timeouts for name resolves without the use of signals.

Setting CURLOPT_NOSIGNAL(3) to 1 makes libcurl NOT ask the system to ignore SIGPIPE signals, which otherwise are sent by the system when trying to send data to a socket which is closed in the other end. libcurl makes an effort to never cause such SIGPIPE signals to trigger, but some operating systems have no way to avoid them and even on those that have there are some corner cases when they may still happen, contrary to our desire.

DEFAULT

0

%PROTOCOLS%

EXAMPLE

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

    curl_easy_setopt(curl, CURLOPT_NOSIGNAL, 1L);

    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_NOSIGNAL
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_TIMEOUT (3)
9Protocol:
10 - All
11Added-in: 7.10
12---
14# NAME
16CURLOPT_NOSIGNAL - skip all signal handling
18# SYNOPSIS
20~~~c
21#include <curl/curl.h>
23CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NOSIGNAL, long onoff);
24~~~
26# DESCRIPTION
28If *onoff* is 1, libcurl uses no functions that install signal handlers or
29any functions that cause signals to be sent to the process. This option is
30here to allow multi-threaded Unix applications to still set/use all timeout
31options etc, without risking getting signals.
33If this option is set and libcurl has been built with the standard name
34resolver, timeouts cannot occur while the name resolve takes place. Consider
35building libcurl with the c-ares or threaded resolver backends to enable
36asynchronous DNS lookups, to enable timeouts for name resolves without the use
37of signals.
39Setting CURLOPT_NOSIGNAL(3) to 1 makes libcurl NOT ask the system to
40ignore SIGPIPE signals, which otherwise are sent by the system when trying to
41send data to a socket which is closed in the other end. libcurl makes an
42effort to never cause such SIGPIPE signals to trigger, but some operating
43systems have no way to avoid them and even on those that have there are some
44corner cases when they may still happen, contrary to our desire.
46# DEFAULT
50# %PROTOCOLS%
52# EXAMPLE
54~~~c
55int main(void)
57 CURL *curl = curl_easy_init();
58 if(curl) {
59 CURLcode result;
60 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
62 curl_easy_setopt(curl, CURLOPT_NOSIGNAL, 1L);
64 result = curl_easy_perform(curl);
66 curl_easy_cleanup(curl);
67 }
69~~~
71# %AVAILABILITY%
73# RETURN VALUE
75curl_easy_setopt(3) returns a CURLcode indicating success or error.
77CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
78libcurl-errors(3).
Diagnostics4 git calls · 128 ms
CallStatusSizeTime0128 ms
discover200152 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
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 · 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=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
fetch2001.1 KiB123 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=123
git.response.bytes=1099
git.response.cache=MISS
git.response.duration_ms=123
git.fetch.wants=c89b01465bac0278eb97e2433e657fe47f93783b
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=1099
git.pkt.payload.max=1078
git.sideband.band1.bytes=1077
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
a5e3138fee923e6e
Request
75979640…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format