Artifactspublic-v0

curl

master
ply4 git calls435 ms288 KiB2 cachedprotocol v2
74 lines1.6 KiBRaw

NAME

CURLOPT_PORT - remote port number to connect to

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PORT, long number);

DESCRIPTION

We strongly discourage using this unreliable option since its scope is not obvious and hard to predict. Set the preferred port number in the URL instead.

This option sets number to be the remote port number to connect to, instead of the one specified in the URL or the default port for the used protocol.

Usually, you let the URL decide which port to use but this allows the application to override that.

While this option accepts a 'long', a port number is an unsigned 16-bit number and therefore using a port number lower than zero or over 65535 causes a CURLE_BAD_FUNCTION_ARGUMENT error.

DEFAULT

0 which makes it not used. This also makes port number zero impossible to set with this API.

%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");
    curl_easy_setopt(curl, CURLOPT_PORT, 8080L);
    result = curl_easy_perform(curl);
    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_PORT
5Section: 3
6Source: libcurl
7See-also:
8 - CURLINFO_PRIMARY_PORT (3)
9 - CURLOPT_STDERR (3)
10 - CURLOPT_URL (3)
11Protocol:
12 - All
13Added-in: 7.1
14---
16# NAME
18CURLOPT_PORT - remote port number to connect to
20# SYNOPSIS
22~~~c
23#include <curl/curl.h>
25CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PORT, long number);
26~~~
28# DESCRIPTION
30We strongly discourage using this unreliable option since its scope is not
31obvious and hard to predict. Set the preferred port number in the URL instead.
33This option sets *number* to be the remote port number to connect to,
34instead of the one specified in the URL or the default port for the used
35protocol.
37Usually, you let the URL decide which port to use but this allows the
38application to override that.
40While this option accepts a 'long', a port number is an unsigned 16-bit number
41and therefore using a port number lower than zero or over 65535 causes a
42**CURLE_BAD_FUNCTION_ARGUMENT** error.
44# DEFAULT
460 which makes it not used. This also makes port number zero impossible to set
47with this API.
49# %PROTOCOLS%
51# EXAMPLE
53~~~c
54int main(void)
56 CURL *curl = curl_easy_init();
57 if(curl) {
58 CURLcode result;
59 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
60 curl_easy_setopt(curl, CURLOPT_PORT, 8080L);
61 result = curl_easy_perform(curl);
62 curl_easy_cleanup(curl);
63 }
65~~~
67# %AVAILABILITY%
69# RETURN VALUE
71curl_easy_setopt(3) returns a CURLcode indicating success or error.
73CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
74libcurl-errors(3).
Diagnostics4 git calls · 435 ms
CallStatusSizeTime0435 ms
discover200152 B2 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 · 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=431
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
fetch200984 B431 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=984
git.response.cache=MISS
git.response.duration_ms=431
git.fetch.wants=567d6a975a792c067370c514fe0a5e043d3a1dd3
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=984
git.pkt.payload.max=963
git.sideband.band1.bytes=962
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
a5e345139ed3f4d4
Request
6652ec13…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format