Artifactspublic-v0

curl

master
ply4 git calls621 ms288 KiB2 cachedprotocol v2
99 lines2.7 KiBRaw

NAME

CURLOPT_COOKIEJAR - filename to store cookies to

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COOKIEJAR, char *filename);

DESCRIPTION

Pass a filename as a char *, null-terminated. This makes libcurl write all internally known cookies to the specified file when curl_easy_cleanup(3) is called. If no cookies are kept in memory at that time, no file is created. Specify "-" as filename to instead have the cookies written to stdout. Using this option also enables cookies for this session, so if you for example follow a redirect it makes matching cookies get sent accordingly.

Note that libcurl does not read any cookies from the cookie jar specified with this option. To read cookies from a file, use CURLOPT_COOKIEFILE(3).

If the cookie jar file cannot be created or written to (when the curl_easy_cleanup(3) is called), libcurl does not and cannot report an error for this. Using CURLOPT_VERBOSE(3) or CURLOPT_DEBUGFUNCTION(3) displays a warning, but that is the only visible feedback you get about this possibly lethal situation.

Cookies are imported in the Set-Cookie format without a domain name are not exported by this option.

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

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

SECURITY CONCERNS

libcurl cannot fully protect against attacks where an attacker has write access to the same directory where it is directed to save files. This is particularly sensitive if you save files using elevated privileges.

libcurl creates the file to store cookies using default file permissions, meaning that on *nix systems you may need to restrict your umask to prevent other users on the same system to access the file.

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/foo.bin");

    /* export cookies to this file when closing the handle */
    curl_easy_setopt(curl, CURLOPT_COOKIEJAR, "/tmp/cookies.txt");

    result = curl_easy_perform(curl);

    /* close the handle, write the cookies */
    curl_easy_cleanup(curl);
  }
}

%AVAILABILITY%

RETURN VALUE

curl_easy_setopt(3) returns a CURLcode indicating success or error.

CURLE_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3).

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: CURLOPT_COOKIEJAR
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_COOKIE (3)
9 - CURLOPT_COOKIEFILE (3)
10 - CURLOPT_COOKIELIST (3)
11Protocol:
12 - HTTP
13Added-in: 7.9
14---
16# NAME
18CURLOPT_COOKIEJAR - filename to store cookies to
20# SYNOPSIS
22~~~c
23#include <curl/curl.h>
25CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COOKIEJAR, char *filename);
26~~~
28# DESCRIPTION
30Pass a *filename* as a char *, null-terminated. This makes libcurl write all
31internally known cookies to the specified file when curl_easy_cleanup(3) is
32called. If no cookies are kept in memory at that time, no file is created.
33Specify "-" as filename to instead have the cookies written to stdout. Using
34this option also enables cookies for this session, so if you for example
35follow a redirect it makes matching cookies get sent accordingly.
37Note that libcurl does not read any cookies from the cookie jar specified with
38this option. To read cookies from a file, use CURLOPT_COOKIEFILE(3).
40If the cookie jar file cannot be created or written to (when the
41curl_easy_cleanup(3) is called), libcurl does not and cannot report an error
42for this. Using CURLOPT_VERBOSE(3) or CURLOPT_DEBUGFUNCTION(3) displays a
43warning, but that is the only visible feedback you get about this possibly
44lethal situation.
46Cookies are imported in the Set-Cookie format without a domain name are not
47exported by this option.
49The application does not have to keep the string around after setting this
50option.
52Using this option multiple times makes the last set string override the
53previous ones. Set it to NULL to disable its use again.
55# SECURITY CONCERNS
57libcurl cannot fully protect against attacks where an attacker has write
58access to the same directory where it is directed to save files. This is
59particularly sensitive if you save files using elevated privileges.
61libcurl creates the file to store cookies using default file permissions,
62meaning that on *nix systems you may need to restrict your umask to prevent
63other users on the same system to access the file.
65# DEFAULT
67NULL
69# %PROTOCOLS%
71# EXAMPLE
73~~~c
74int main(void)
76 CURL *curl = curl_easy_init();
77 if(curl) {
78 CURLcode result;
79 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
81 /* export cookies to this file when closing the handle */
82 curl_easy_setopt(curl, CURLOPT_COOKIEJAR, "/tmp/cookies.txt");
84 result = curl_easy_perform(curl);
86 /* close the handle, write the cookies */
87 curl_easy_cleanup(curl);
88 }
90~~~
92# %AVAILABILITY%
94# RETURN VALUE
96curl_easy_setopt(3) returns a CURLcode indicating success or error.
98CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
99libcurl-errors(3).
Diagnostics4 git calls · 621 ms
CallStatusSizeTime0621 ms
discover200152 B5 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=5
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 · hit6 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=6
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=6
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=2
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.4 KiB612 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=612
git.response.bytes=1463
git.response.cache=MISS
git.response.duration_ms=612
git.fetch.wants=ac3a7074d0a27e2b01dc6a21913b6c036c37ac02
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=1463
git.pkt.payload.max=1442
git.sideband.band1.bytes=1441
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
a5e367b429951de6
Request
078a26fa…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format