Added example code that allows to send data streams or files using quicly

.gitignore

@@ -11,3 +11,14 @@ cmake_install.cmake
 xcuserdata
 *.xccheckout
 tmp/
+cli
+embedded-probes.h
+examples-echo
+libquicly.a
+picotls-probes.h
+quicly-probes.h
+quicly-tracer.h
+test.t
+udpfw
+examples-pipeclient
+examples-pipeserver

.vscode/launch.json

@@ -0,0 +1,54 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "example-pipe-server",
+            "type": "cppdbg",
+            "request": "launch",
+            "program": "${workspaceRoot}/build/examples-pipeserver",
+            "args": ["-c", "../tmp/server.cert", "-k", "../tmp/server.key"],
+            "stopAtEntry": false,
+            "cwd": "${fileDirname}",
+            "environment": [],
+            "externalConsole": false,
+            "MIMode": "lldb"
+        },{
+            "name": "example-pipe-client",
+            "type": "cppdbg",
+            "request": "launch",
+            "program": "${workspaceRoot}/build/examples-pipeclient",
+            "args": [""],
+            "stopAtEntry": false,
+            "cwd": "${fileDirname}",
+            "environment": [],
+            "externalConsole": true,
+            "MIMode": "lldb"
+        },{
+            "name": "example-echo-client",
+            "type": "cppdbg",
+            "request": "launch",
+            "program": "${workspaceRoot}/build/examples-echo",
+            "args": [""],
+            "stopAtEntry": false,
+            "cwd": "${fileDirname}",
+            "environment": [],
+            "externalConsole": true,
+            "MIMode": "lldb"
+        },
+        {
+            "name": "cli help",
+            "type": "cppdbg",
+            "request": "launch",
+            "program": "${workspaceRoot}/build/cli",
+            "args": ["-h"],
+            "stopAtEntry": false,
+            "cwd": "${fileDirname}",
+            "environment": [],
+            "externalConsole": false,
+            "MIMode": "lldb"
+        }
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+    "files.associations": {
+        "unistd.h": "c",
+        "sstream": "c"
+    }
+}

CMakeLists.txt

@@ -1,4 +1,4 @@
-CMAKE_MINIMUM_REQUIRED(VERSION 2.8.11)
+CMAKE_MINIMUM_REQUIRED(VERSION 2.8.11...3.20)
 CMAKE_POLICY(SET CMP0003 NEW)
 
 PROJECT(quicly)
@@ -124,6 +124,12 @@ TARGET_LINK_LIBRARIES(test.t quicly ${OPENSSL_LIBRARIES} ${CMAKE_DL_LIBS})
 ADD_EXECUTABLE(examples-echo ${PICOTLS_OPENSSL_FILES} examples/echo.c)
 TARGET_LINK_LIBRARIES(examples-echo quicly ${OPENSSL_LIBRARIES} ${CMAKE_DL_LIBS})
 
+ADD_EXECUTABLE(examples-pipeclient ${PICOTLS_OPENSSL_FILES} examples/pipeclient.c)
+TARGET_LINK_LIBRARIES(examples-pipeclient quicly ${OPENSSL_LIBRARIES} ${CMAKE_DL_LIBS})
+
+ADD_EXECUTABLE(examples-pipeserver ${PICOTLS_OPENSSL_FILES} examples/pipeserver.c)
+TARGET_LINK_LIBRARIES(examples-pipeserver quicly ${OPENSSL_LIBRARIES} ${CMAKE_DL_LIBS})
+
 ADD_EXECUTABLE(udpfw t/udpfw.c)
 
 ADD_CUSTOM_TARGET(check env BINARY_DIR=${CMAKE_CURRENT_BINARY_DIR} WITH_DTRACE=${WITH_DTRACE} prove --exec "sh -c" -v ${CMAKE_CURRENT_BINARY_DIR}/*.t t/*.t

examples/PIPE-README.md

@@ -0,0 +1,50 @@
+Send data streams over QUIC (Quicly)
+===
+
+Using the `pipeclient` and `pipeserver` binaries you can esaly send data streams (ex: live video) over QUIC
+
+How to test it
+---
+
+- Install & compile the code, you can follow the [readme](../README.md) instructions
+
+- Generate the certs in the `/tmp` dir:
+```
+mkdir -p tmp
+openssl req -nodes -new -x509  -keyout tmp/server.key -out tmp/server.crt
+```
+
+- To run the server
+```
+./examples-pipeserver -c ../tmp/server.crt -k ../tmp/server.key -p 4433 > myReceivedFile.bin
+```
+
+- To run the client
+```
+cat myfile.bin | ./examples-pipeclient
+```
+
+- Check files
+```
+diff myfile.bin myReceivedFile.bin
+```
+
+Example with video (Assumes `ffmpeg` and `ffplay` installed)
+---
+
+- To run the server:
+```
+./examples-pipeserver -c ../tmp/server.cert -k ../tmp/server.key -p 4433 | ffplay -
+```
+
+- To run the client:
+```
+ffmpeg -re -f lavfi -i smptebars=duration=30:size=320x200:rate=30 -f lavfi -re -i sine=frequency=1000:duration=30:sample_rate=48000 -pix_fmt yuv420p -c:v libx264 -b:v 180k -g 60 -keyint_min 60 -profile:v baseline -preset veryfast -c:a aac -b:a 96k -vf "drawtext=fontfile=/Library/Fonts/Arial.ttf: text=\'Local time %{localtime\: %Y\/%m\/%d %H.%M.%S} (%{n})\': x=10: y=10: fontsize=16: fontcolor=white: box=1: boxcolor=0x00000099" -f mpegts - | ./examples-pipeclient
+```
+
+Note: The previous command will work on MACos, but if you have problems with `lavfi` filter or with the fonts path you can use the following one:
+```
+ffmpeg -re -i myVideoFile.mp4 -c copy -f mpegts - | ./examples-pipeclient
+```
+
+Now you should see live video!!!