Artifactspublic-v0

curl

master
ply4 git calls163 ms288 KiB2 cachedprotocol v2
93 lines3.2 KiBRaw

NAME

libcurl-env - environment variables libcurl understands

DESCRIPTION

libcurl reads and understands a set of environment variables that if set controls and changes behaviors. This is the full list of variables to set and description of what they do. Also note that curl, the command line tool, supports a set of additional environment variables independently of this.

[scheme]_proxy

When libcurl is given a URL to use in a transfer, it first extracts the scheme part from the URL and checks if there is a given proxy set for that in its corresponding environment variable. A URL like https://example.com makes libcurl use the http_proxy variable, while a URL like ftp://example.com uses the ftp_proxy variable.

These proxy variables are also checked for in their uppercase versions, except the http_proxy one which is only used lowercase. Note also that some systems (like Windows) have a case insensitive handling of environment variables and then of course HTTP_PROXY still works.

An exception exists for the WebSocket ws and wss URL schemes, where libcurl first checks ws_proxy or wss_proxy but if they are not set, it falls back and tries the http and https versions instead if set.

ALL_PROXY

This is a setting to set proxy for all URLs, independently of what scheme is being used. Note that the scheme specific variables overrides this one if set.

CURL_SSL_BACKEND

When libcurl is built to support multiple SSL backends, it selects a specific backend at first use. If no selection is done by the program using libcurl, this variable's selection is used. Setting a name that is not a built-in alternative makes libcurl stay with the default.

SSL backend names (case-insensitive): GnuTLS, mbedTLS, OpenSSL, Rustls, Schannel, wolfSSL

HOME

When the netrc feature is used (CURLOPT_NETRC(3)), this variable is checked as the primary way to find the "current" home directory in which the .netrc file is likely to exist.

USERPROFILE

When the netrc feature is used (CURLOPT_NETRC(3)), this variable is checked as the secondary way to find the "current" home directory (on Windows only) in which the .netrc file is likely to exist.

NETRC

The filename used as netrc file when CURLOPT_NETRC(3) is used without CURLOPT_NETRC_FILE(3). (Added in 8.16.0)

NO_PROXY

This has the same functionality as the CURLOPT_NOPROXY(3) option: it gives libcurl a comma-separated list of hostname patterns for which libcurl should not use a proxy.

SSLKEYLOGFILE

When set and libcurl runs with an SSL backend that supports this feature, libcurl saves SSL secrets into the given filename. Using those SSL secrets, other tools (such as Wireshark) can decrypt the SSL communication and analyze/view the traffic.

These secrets and this file might be sensitive. Users are advised to take precautions so that they are not stolen or otherwise inadvertently revealed.

Debug Variables

Debug variables are intended for internal use and are documented in libcurl-env-dbg(3).

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: libcurl-env
5Section: 3
6Source: libcurl
7See-also:
8 - libcurl-env-dbg (3)
9Protocol:
10 - All
11Added-in: n/a
12---
14# NAME
16libcurl-env - environment variables libcurl understands
18# DESCRIPTION
20libcurl reads and understands a set of environment variables that if set
21controls and changes behaviors. This is the full list of variables to set and
22description of what they do. Also note that curl, the command line tool,
23supports a set of additional environment variables independently of this.
25## `[scheme]_proxy`
27When libcurl is given a URL to use in a transfer, it first extracts the scheme
28part from the URL and checks if there is a given proxy set for that in its
29corresponding environment variable. A URL like https://example.com makes
30libcurl use the **http_proxy** variable, while a URL like ftp://example.com
31uses the **ftp_proxy** variable.
33These proxy variables are also checked for in their uppercase versions, except
34the **http_proxy** one which is only used lowercase. Note also that some
35systems (like Windows) have a case insensitive handling of environment
36variables and then of course **HTTP_PROXY** still works.
38An exception exists for the WebSocket **ws** and **wss** URL schemes, where
39libcurl first checks **ws_proxy** or **wss_proxy** but if they are not set, it
40falls back and tries the http and https versions instead if set.
42## `ALL_PROXY`
44This is a setting to set proxy for all URLs, independently of what scheme is
45being used. Note that the scheme specific variables overrides this one if set.
47## `CURL_SSL_BACKEND`
49When libcurl is built to support multiple SSL backends, it selects a specific
50backend at first use. If no selection is done by the program using libcurl,
51this variable's selection is used. Setting a name that is not a built-in
52alternative makes libcurl stay with the default.
54SSL backend names (case-insensitive): GnuTLS, mbedTLS, OpenSSL, Rustls,
55Schannel, wolfSSL
57## `HOME`
59When the netrc feature is used (CURLOPT_NETRC(3)), this variable is
60checked as the primary way to find the "current" home directory in which
61the .netrc file is likely to exist.
63## `USERPROFILE`
65When the netrc feature is used (CURLOPT_NETRC(3)), this variable is
66checked as the secondary way to find the "current" home directory (on Windows
67only) in which the .netrc file is likely to exist.
69## `NETRC`
71The filename used as netrc file when CURLOPT_NETRC(3) is used without
72CURLOPT_NETRC_FILE(3). (Added in 8.16.0)
74## `NO_PROXY`
76This has the same functionality as the CURLOPT_NOPROXY(3) option: it
77gives libcurl a comma-separated list of hostname patterns for which libcurl
78should not use a proxy.
80## `SSLKEYLOGFILE`
82When set and libcurl runs with an SSL backend that supports this feature,
83libcurl saves SSL secrets into the given filename. Using those SSL secrets,
84other tools (such as Wireshark) can decrypt the SSL communication and
85analyze/view the traffic.
87These secrets and this file might be sensitive. Users are advised to take
88precautions so that they are not stolen or otherwise inadvertently revealed.
90# Debug Variables
92Debug variables are intended for internal use and are documented in
93libcurl-env-dbg(3).
Diagnostics4 git calls · 163 ms
CallStatusSizeTime0163 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 · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=157
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.6 KiB157 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1592
git.response.cache=MISS
git.response.duration_ms=157
git.fetch.wants=5ce846df8aa62e92ac9697e46ab9ad2c2ce81af5
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=1592
git.pkt.payload.max=1571
git.sideband.band1.bytes=1570
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
a5e342df9f5b6e2a
Request
67dcd38d…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format