Artifactspublic-v0

curl

master
ply4 git calls136 ms288 KiB2 cachedprotocol v2
82 lines1.8 KiBRaw

NAME

CURLOPT_SSLENGINE - Set SSL engine or provider

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLENGINE, char *id);

DESCRIPTION

Pass a pointer to a null-terminated string as parameter. It is used as the identifier for the engine or provider you want to use for your private key. OpenSSL 1 had engines, OpenSSL 3 has providers.

The application does not have to keep the string around after setting this option.

When asking libcurl to use a provider, the application can also optionally provide a property, a set of name value pairs. Such a property can be specified separated from the name with a colon (:).

Using this option multiple times makes the last set string override the previous ones. Set it to NULL to disable its use again.

Since curl 8.24.0, the engine and provider initialization is done during transfer setup, making many errors only detected then, not when set using curl_easy_setopt(3).

DEFAULT

NULL

%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_SSLENGINE, "dynamic");
    result = curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }
}

%AVAILABILITY%

RETURN VALUE

CURLE_OK - Engine found.

CURLE_NOT_BUILT_IN - Option not built in, OpenSSL is not the SSL backend.

CURLE_UNKNOWN_OPTION - Option not recognized.

CURLE_OUT_OF_MEMORY - Insufficient heap space.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: CURLOPT_SSLENGINE
5Section: 3
6Source: libcurl
7See-also:
8 - CURLINFO_SSL_ENGINES (3)
9 - CURLOPT_SSLENGINE_DEFAULT (3)
10 - CURLOPT_SSLKEY (3)
11Protocol:
12 - TLS
13TLS-backend:
14 - OpenSSL
15Added-in: 7.9.3
16---
18# NAME
20CURLOPT_SSLENGINE - Set SSL engine or provider
22# SYNOPSIS
24~~~c
25#include <curl/curl.h>
27CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLENGINE, char *id);
28~~~
30# DESCRIPTION
32Pass a pointer to a null-terminated string as parameter. It is used as the
33identifier for the *engine* or *provider* you want to use for your private
34key. OpenSSL 1 had engines, OpenSSL 3 has providers.
36The application does not have to keep the string around after setting this
37option.
39When asking libcurl to use a provider, the application can also optionally
40provide a *property*, a set of name value pairs. Such a property can be
41specified separated from the name with a colon (`:`).
43Using this option multiple times makes the last set string override the
44previous ones. Set it to NULL to disable its use again.
46Since curl 8.24.0, the engine and provider initialization is done during
47transfer setup, making many errors only detected then, not when set using
48curl_easy_setopt(3).
50# DEFAULT
52NULL
54# %PROTOCOLS%
56# EXAMPLE
58~~~c
59int main(void)
61 CURL *curl = curl_easy_init();
62 if(curl) {
63 CURLcode result;
64 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
65 curl_easy_setopt(curl, CURLOPT_SSLENGINE, "dynamic");
66 result = curl_easy_perform(curl);
67 curl_easy_cleanup(curl);
68 }
70~~~
72# %AVAILABILITY%
74# RETURN VALUE
76CURLE_OK - Engine found.
78CURLE_NOT_BUILT_IN - Option not built in, OpenSSL is not the SSL backend.
80CURLE_UNKNOWN_OPTION - Option not recognized.
82CURLE_OUT_OF_MEMORY - Insufficient heap space.
Diagnostics4 git calls · 136 ms
CallStatusSizeTime0136 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 · 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 · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=3
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.0 KiB131 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=131
git.response.bytes=1074
git.response.cache=MISS
git.response.duration_ms=131
git.fetch.wants=a0c2fc1f4e9edaf4868a443e4ab89dacf8b023b1
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=1074
git.pkt.payload.max=1053
git.sideband.band1.bytes=1052
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
a5e3135d7d923e6e
Request
a239c123…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format