Artifactspublic-v0

curl

master
ply4 git calls28 ms288 KiB3 cachedprotocol v2
79 lines1.8 KiBRaw

NAME

curl_slist_append - add a string to an slist

SYNOPSIS

c
#include <curl/curl.h>

struct curl_slist *curl_slist_append(struct curl_slist *list,
                                     const char *string);

DESCRIPTION

curl_slist_append(3) appends a string to a linked list of strings. The existing list should be passed as the first argument and the new list is returned from this function. Pass in NULL in the list argument to create a new list. The specified string has been appended when this function returns. curl_slist_append(3) copies the string. The string argument must be a valid string pointer and cannot be NULL.

The list should be freed (after usage) with curl_slist_free_all(3). Its nodes and pointed content may not be altered outside this function.

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *handle = curl_easy_init();
  struct curl_slist *slist = NULL;
  struct curl_slist *temp = NULL;

  slist = curl_slist_append(slist, "pragma:");

  if(!slist)
    return -1;

  temp = curl_slist_append(slist, "Accept:");

  if(!temp) {
    curl_slist_free_all(slist);
    return -1;
  }

  slist = temp;

  curl_easy_setopt(handle, CURLOPT_HTTPHEADER, slist);

  curl_easy_perform(handle);

  curl_slist_free_all(slist); /* free the list again */
}

%AVAILABILITY%

RETURN VALUE

A null pointer is returned if anything went wrong, otherwise the new list pointer is returned. To avoid overwriting an existing non-empty list on failure, the new list should be returned to a temporary variable which can be tested for NULL before updating the original list pointer.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: curl_slist_append
5Section: 3
6Source: libcurl
7See-also:
8 - curl_slist_free_all (3)
9Protocol:
10 - All
11Added-in: 7.1
12---
14# NAME
16curl_slist_append - add a string to an slist
18# SYNOPSIS
20~~~c
21#include <curl/curl.h>
23struct curl_slist *curl_slist_append(struct curl_slist *list,
24 const char *string);
25~~~
27# DESCRIPTION
29curl_slist_append(3) appends a string to a linked list of strings. The
30existing **list** should be passed as the first argument and the new list is
31returned from this function. Pass in NULL in the **list** argument to create a
32new list. The specified **string** has been appended when this function
33returns. curl_slist_append(3) copies the string. The **string** argument must
34be a valid string pointer and cannot be NULL.
36The list should be freed (after usage) with curl_slist_free_all(3).
37Its nodes and pointed content may not be altered outside this function.
39# %PROTOCOLS%
41# EXAMPLE
43~~~c
44int main(void)
46 CURL *handle = curl_easy_init();
47 struct curl_slist *slist = NULL;
48 struct curl_slist *temp = NULL;
50 slist = curl_slist_append(slist, "pragma:");
52 if(!slist)
53 return -1;
55 temp = curl_slist_append(slist, "Accept:");
57 if(!temp) {
58 curl_slist_free_all(slist);
59 return -1;
60 }
62 slist = temp;
64 curl_easy_setopt(handle, CURLOPT_HTTPHEADER, slist);
66 curl_easy_perform(handle);
68 curl_slist_free_all(slist); /* free the list again */
70~~~
72# %AVAILABILITY%
74# RETURN VALUE
76A null pointer is returned if anything went wrong, otherwise the new list
77pointer is returned. To avoid overwriting an existing non-empty list on
78failure, the new list should be returned to a temporary variable which can
79be tested for NULL before updating the original list pointer.
Diagnostics4 git calls · 28 ms
CallStatusSizeTime028 ms
discover200152 B3 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 · 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=23
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
fetch200971 B · hit23 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=971
git.response.cache=HIT
git.response.duration_ms=23
git.fetch.wants=3ebc19e354189bbfcc9fa7d6dd84892c848cc78f
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=971
git.pkt.payload.max=950
git.sideband.band1.bytes=949
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
a5e32ade6ea45094
Request
4597dfd5…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format