Artifactspublic-v0

curl

master
ply4 git calls59 ms288 KiB3 cachedprotocol v2
47 lines1.5 KiBRaw

porting libcurl

The basic approach I use when porting libcurl to another OS when the existing configure or cmake build setups are not suitable.

Build

Write a build script/Makefile that builds all C files under lib/. If possible, use the lib/Makefile.inc that lists all files in Makefile variables.

In the Makefile, make sure you define what OS you build for: -D[OPERATING SYSTEM], or similar. Perhaps the compiler in use already define a standard one? Then you might not need to define your own.

Add the new OS

In the lib/curl_config.h header file, in the section for when HAVE_CONFIG_H is not defined (starting at around line 150), add a new conditional include in this style:

c
#ifdef [OPERATING SYSTEM]
#  include "config-operatingsystem.h"
#endif

Create lib/config-operatingsystem.h. You might want to start with copying a another config-* file and then start trimming according to what your environment supports.

Build it

When you run into compiler warnings or errors, the lib/config-operatingsystem.h file should be where you should focus your work and edits.

A recommended approach is to define a lot of the CURL_DISABLE_* defines (see the CURL-DISABLE document) initially to help narrow down the initial work as that can save you from having to give attention to areas of the code that you do not care for in your port.

1<!--
2Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
4SPDX-License-Identifier: curl
5-->
7# porting libcurl
9The basic approach I use when porting libcurl to another OS when the existing
10configure or cmake build setups are not suitable.
12## Build
14Write a build script/Makefile that builds *all* C files under lib/. If
15possible, use the `lib/Makefile.inc` that lists all files in Makefile
16variables.
18In the Makefile, make sure you define what OS you build for: `-D[OPERATING
19SYSTEM]`, or similar. Perhaps the compiler in use already define a standard
20one? Then you might not need to define your own.
22## Add the new OS
24In the `lib/curl_config.h` header file, in the section for when `HAVE_CONFIG_H`
25is *not* defined (starting at around line 150), add a new conditional include
26in this style:
28~~~c
29#ifdef [OPERATING SYSTEM]
30# include "config-operatingsystem.h"
31#endif
32~~~
34Create `lib/config-operatingsystem.h`. You might want to start with copying a
35another config-* file and then start trimming according to what your
36environment supports.
38## Build it
40When you run into compiler warnings or errors, the
41`lib/config-operatingsystem.h` file should be where you should focus your work
42and edits.
44A recommended approach is to define a lot of the `CURL_DISABLE_*` defines (see
45the [CURL-DISABLE](../CURL-DISABLE.md) document) initially to help narrow down
46the initial work as that can save you from having to give attention to areas of
47the code that you do not care for in your port.
Diagnostics4 git calls · 59 ms
CallStatusSizeTime059 ms
discover200152 B4 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=1
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 · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=53
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
fetch200882 B · hit53 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=882
git.response.cache=HIT
git.response.duration_ms=53
git.fetch.wants=aa1aa7873af1a067b3f3bdcf6222fe0ddbfadce7
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=882
git.pkt.payload.max=861
git.sideband.band1.bytes=860
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
a5e2d5b76db8689d
Request
8488fd1d…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format