Artifactspublic-v0

curl

master
ply4 git calls345 ms288 KiB2 cachedprotocol v2
61 lines1.2 KiBRaw

NAME

curl_getenv - return value for environment name

SYNOPSIS

c
#include <curl/curl.h>

char *curl_getenv(const char *name);

DESCRIPTION

curl_getenv() is a portable wrapper for the getenv() function, meant to emulate its behavior and provide an identical interface for all operating systems libcurl builds on (including Windows).

You must curl_free(3) the returned string when you are done with it and, although not constrained by its type, it may not be altered.

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  char *width = curl_getenv("COLUMNS");
  if(width) {
    /* it was set */
    curl_free(width);
  }
}

%AVAILABILITY%

RETURN VALUE

A pointer to a null-terminated string or NULL if it failed to find the specified name.

NOTE

Under Unix operating systems, there is no point in returning an allocated memory, although other systems does not work properly if this is not done. The Unix implementation thus suffers slightly from the drawbacks of other systems.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: curl_getenv
5Section: 3
6Source: libcurl
7See-also:
8 - getenv (3C)
9Protocol:
10 - All
11Added-in: 7.1
12---
14# NAME
16curl_getenv - return value for environment name
18# SYNOPSIS
20~~~c
21#include <curl/curl.h>
23char *curl_getenv(const char *name);
24~~~
26# DESCRIPTION
28curl_getenv() is a portable wrapper for the getenv() function, meant to
29emulate its behavior and provide an identical interface for all operating
30systems libcurl builds on (including Windows).
32You must curl_free(3) the returned string when you are done with it and,
33although not constrained by its type, it may not be altered.
35# %PROTOCOLS%
37# EXAMPLE
39~~~c
40int main(void)
42 char *width = curl_getenv("COLUMNS");
43 if(width) {
44 /* it was set */
45 curl_free(width);
46 }
48~~~
50# %AVAILABILITY%
52# RETURN VALUE
54A pointer to a null-terminated string or NULL if it failed to find the
55specified name.
57# NOTE
59Under Unix operating systems, there is no point in returning an allocated
60memory, although other systems does not work properly if this is not done. The
61Unix implementation thus suffers slightly from the drawbacks of other systems.
Diagnostics4 git calls · 345 ms
CallStatusSizeTime0345 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 · 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
fetch200793 B341 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=341
git.response.bytes=793
git.response.cache=MISS
git.response.duration_ms=341
git.fetch.wants=047c913f2530ef1d9401f21004121c1c007ae5af
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=793
git.pkt.payload.max=772
git.sideband.band1.bytes=771
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
a5e3150e5b583e6e
Request
1e2534dd…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format