Artifactspublic-v0

curl

master
ply4 git calls121 ms288 KiB2 cachedprotocol v2
61 lines1.3 KiBRaw

MQTT in curl

Usage

A plain "GET" subscribes to the topic and prints all published messages.

Doing a "POST" publishes the post data to the topic and exits.

TLS protection

Use mqtts:// to do MQTT over TLS: MQTTS.

Subscribing

Command usage:

curl mqtt://host/topic

Example subscribe:

curl mqtt://host.home/bedroom/temp

This sends an MQTT SUBSCRIBE packet for the topic bedroom/temp and listen in for incoming PUBLISH packets.

You can set the upkeep interval ms option to make curl send MQTT ping requests to the server at an internal, to prevent the connection to get closed because of idleness. You might then need to use the progress callback to cancel the operation.

Publishing

Command usage:

curl -d payload mqtt://host/topic

Example publish:

curl -d 75 mqtt://host.home/bedroom/dimmer

This sends an MQTT PUBLISH packet to the topic bedroom/dimmer with the payload 75.

What does curl deliver as a response to a subscribe

Whenever a PUBLISH packet is received, curl outputs two bytes topic length (MSB | LSB), the topic followed by the payload.

Caveats

Remaining limitations:

  • Only QoS level 0 is implemented for publish
  • No way to set retain flag for publish
  • Naive EAGAIN handling does not handle split messages
1<!--
2Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
4SPDX-License-Identifier: curl
5-->
7# MQTT in curl
9## Usage
11A plain "GET" subscribes to the topic and prints all published messages.
13Doing a "POST" publishes the post data to the topic and exits.
15## TLS protection
17Use `mqtts://` to do MQTT over TLS: MQTTS.
19### Subscribing
21Command usage:
23 curl mqtt://host/topic
25Example subscribe:
27 curl mqtt://host.home/bedroom/temp
29This sends an MQTT SUBSCRIBE packet for the topic `bedroom/temp` and listen in
30for incoming PUBLISH packets.
32You can set the upkeep interval ms option to make curl send MQTT ping requests
33to the server at an internal, to prevent the connection to get closed because
34of idleness. You might then need to use the progress callback to cancel the
35operation.
37### Publishing
39Command usage:
41 curl -d payload mqtt://host/topic
43Example publish:
45 curl -d 75 mqtt://host.home/bedroom/dimmer
47This sends an MQTT PUBLISH packet to the topic `bedroom/dimmer` with the
48payload `75`.
50## What does curl deliver as a response to a subscribe
52Whenever a PUBLISH packet is received, curl outputs two bytes topic length
53(MSB | LSB), the topic followed by the payload.
55## Caveats
57Remaining limitations:
59- Only QoS level 0 is implemented for publish
60- No way to set retain flag for publish
61- Naive EAGAIN handling does not handle split messages
Diagnostics4 git calls · 121 ms
CallStatusSizeTime0121 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=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 · 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 · hit1 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=117
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=1
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
fetch200784 B117 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=784
git.response.cache=MISS
git.response.duration_ms=117
git.fetch.wants=83791301731c9b140d52105ae4f204ac314665e7
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=784
git.pkt.payload.max=763
git.sideband.band1.bytes=762
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
a5e3229eeea55aae
Request
5746b66c…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format