Artifactspublic-v0

curl

master
ply4 git calls24 ms288 KiB3 cachedprotocol v2
92 lines2.3 KiBRaw

NAME

curl_easy_option_next - iterate over easy setopt options

SYNOPSIS

c
#include <curl/curl.h>

const struct curl_easyoption *
curl_easy_option_next(const struct curl_easyoption *prev);

DESCRIPTION

This function returns a pointer to the first or the next curl_easyoption struct, providing an ability to iterate over all known options for curl_easy_setopt(3) in this instance of libcurl.

Pass a NULL argument as prev to get the first option returned, or pass in the current option to get the next one returned. If there is no more option to return, curl_easy_option_next(3) returns NULL.

The options returned by this functions are the ones known to this libcurl and information about what argument type they want.

If the CURLOT_FLAG_ALIAS bit is set in the flags field, it means the name is provided for backwards compatibility as an alias.

struct

c
typedef enum {
  CURLOT_LONG,    /* long (a range of values) */
  CURLOT_VALUES,  /*      (a defined set or bitmask) */
  CURLOT_OFF_T,   /* curl_off_t (a range of values) */
  CURLOT_OBJECT,  /* pointer (void *) */
  CURLOT_STRING,  /*         (char * to null-terminated buffer) */
  CURLOT_SLIST,   /*         (struct curl_slist *) */
  CURLOT_CBPTR,   /*         (void * passed as-is to a callback) */
  CURLOT_BLOB,    /* blob (struct curl_blob *) */
  CURLOT_FUNCTION /* function pointer */
} curl_easytype;

/* The CURLOPTTYPE_* id ranges can still be used to figure out what type/size
   to use for curl_easy_setopt() for the given id */
struct curl_easyoption {
  const char *name;
  CURLoption id;
  curl_easytype type;
  unsigned int flags;
};

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  /* iterate over all available options */
  const struct curl_easyoption *opt;
  opt = curl_easy_option_next(NULL);
  while(opt) {
    printf("Name: %s\n", opt->name);
    opt = curl_easy_option_next(opt);
  }
}

%AVAILABILITY%

RETURN VALUE

A pointer to the curl_easyoption struct for the next option or NULL if no more options.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: curl_easy_option_next
5Section: 3
6Source: libcurl
7See-also:
8 - curl_easy_option_by_id (3)
9 - curl_easy_option_by_name (3)
10 - curl_easy_setopt (3)
11Protocol:
12 - All
13Added-in: 7.73.0
14---
16# NAME
18curl_easy_option_next - iterate over easy setopt options
20# SYNOPSIS
22~~~c
23#include <curl/curl.h>
25const struct curl_easyoption *
26curl_easy_option_next(const struct curl_easyoption *prev);
27~~~
29# DESCRIPTION
31This function returns a pointer to the first or the next *curl_easyoption*
32struct, providing an ability to iterate over all known options for
33curl_easy_setopt(3) in this instance of libcurl.
35Pass a **NULL** argument as **prev** to get the first option returned, or
36pass in the current option to get the next one returned. If there is no more
37option to return, curl_easy_option_next(3) returns NULL.
39The options returned by this functions are the ones known to this libcurl and
40information about what argument type they want.
42If the **CURLOT_FLAG_ALIAS** bit is set in the flags field, it means the
43name is provided for backwards compatibility as an alias.
45# struct
47~~~c
48typedef enum {
49 CURLOT_LONG, /* long (a range of values) */
50 CURLOT_VALUES, /* (a defined set or bitmask) */
51 CURLOT_OFF_T, /* curl_off_t (a range of values) */
52 CURLOT_OBJECT, /* pointer (void *) */
53 CURLOT_STRING, /* (char * to null-terminated buffer) */
54 CURLOT_SLIST, /* (struct curl_slist *) */
55 CURLOT_CBPTR, /* (void * passed as-is to a callback) */
56 CURLOT_BLOB, /* blob (struct curl_blob *) */
57 CURLOT_FUNCTION /* function pointer */
58} curl_easytype;
60/* The CURLOPTTYPE_* id ranges can still be used to figure out what type/size
61 to use for curl_easy_setopt() for the given id */
62struct curl_easyoption {
63 const char *name;
64 CURLoption id;
65 curl_easytype type;
66 unsigned int flags;
67};
68~~~
70# %PROTOCOLS%
72# EXAMPLE
74~~~c
75int main(void)
77 /* iterate over all available options */
78 const struct curl_easyoption *opt;
79 opt = curl_easy_option_next(NULL);
80 while(opt) {
81 printf("Name: %s\n", opt->name);
82 opt = curl_easy_option_next(opt);
83 }
85~~~
87# %AVAILABILITY%
89# RETURN VALUE
91A pointer to the *curl_easyoption* struct for the next option or NULL if
92no more options.
Diagnostics4 git calls · 24 ms
CallStatusSizeTime024 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 KiB · hit19 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=1165
git.response.cache=HIT
git.response.duration_ms=19
git.fetch.wants=836dee2d7ed6eabc111f9b021d61c93039c31efa
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=1165
git.pkt.payload.max=1144
git.sideband.band1.bytes=1143
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
a5e358d3ef2c2c38
Request
af1d64a2…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format