Remove debug log and add a comment

Fix SameSite cookie value

.github/workflows/test.yml

@@ -26,48 +26,39 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v3
-    - name: Install packages
+    - run: sudo apt-get install libmbedtls-dev libpcap-dev
-      run: sudo apt-get install libmbedtls-dev
+    - run: make clean examples
-    - name: examples
+    - run: make clean test IPV6=0 MG_ENABLE_POLL=1
-      run: make clean examples
   macos:
     runs-on: macos-latest
     steps:
     - uses: actions/checkout@v3
-    - name: Install packages
+    - run: HOMEBREW_NO_AUTO_UPDATE=1 brew install jq mbedtls openssl
-      run: HOMEBREW_NO_AUTO_UPDATE=1 brew install jq mbedtls openssl
+    - run: make test++ upload-coverage IPV6=0 ASAN_OPTIONS=
-    - name: make
+    - run: make test SSL=OPENSSL IPV6=0 ASAN_OPTIONS= OPENSSL=`echo /usr/local/Cellar/openssl*/*`
-      run: make test++ upload-coverage IPV6=0 ASAN_OPTIONS=
+    - run: make mg_prefix
-    - name: openssl
-      run: make test SSL=OPENSSL IPV6=0 ASAN_OPTIONS= OPENSSL=`echo /usr/local/Cellar/openssl*/*`
-    - name: exports
-      run: make mg_prefix
   windows:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v3
-    - name: vc98
+    - run: make vc98
-      run: make vc98
+    - run: make vc17
-    - name: vc2017
+    - run: make vc22
-      run: make vc2017
+    - run: make mingw
-    - name: mingw
+    - run: make mingw++
-      run: make mingw
-    - name: mingw++
-      run: make mingw++
   arm:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v3
-    - name: arm
+    - run: make arm
-      run: make arm
   matrix_examples:
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
         example:
-          - name: esp32
+          - name: esp32/device-dashboard
-            path: esp32
+            path: esp32/device-dashboard
           - name: esp8266
             path: esp8266
           - name: stm32-freertos-tcp
@@ -78,6 +69,8 @@ jobs:
             path: stm32/stm32-nucleo-f429z
           - name: stm32-nucleo-h743z
             path: stm32/stm32-nucleo-h743z
+          - name: stm32-nucleo-f746zg-baremetal
+            path: stm32/nucleo-f746zg-baremetal
           - name: nxp-mimxrt1020-azurertos
             path: nxp/nxp-mimxrt1020-azurertos
           - name: nxp-frdmk66f-freertos

Makefile

@@ -1,22 +1,23 @@
 SRCS = mongoose.c test/unit_test.c test/packed_fs.c
-HDRS = $(wildcard src/*.h)
+HDRS = $(wildcard src/*.h) $(wildcard mip/*.h)
 DEFS ?= -DMG_MAX_HTTP_HEADERS=7 -DMG_ENABLE_LINES -DMG_ENABLE_PACKED_FS=1 -DMG_ENABLE_SSI=1
 C_WARN ?= -Wmissing-prototypes -Wstrict-prototypes
-WARN ?= -W -Wall -Werror -Wshadow -Wdouble-promotion -fno-common -Wconversion -Wundef $(C_WARN)
+WARN ?= -pedantic -W -Wall -Werror -Wshadow -Wdouble-promotion -fno-common -Wconversion -Wundef $(C_WARN)
 OPTS ?= -O3 -g3
 VALGRIND_OPTS ?= -O0 -g3
 INCS ?= -Isrc -I.
 SSL ?= MBEDTLS
 CWD ?= $(realpath $(CURDIR))
-DOCKER ?= docker run --rm -e Tmp=. -e WINEDEBUG=-all -v $(CWD):$(CWD) -w $(CWD)
+ENV ?=  -e Tmp=. -e WINEDEBUG=-all 
-VCFLAGS = /nologo /W3 /O2 /I. $(DEFS) $(TFLAGS)
+DOCKER ?= docker run --platform linux/amd64 --rm $(ENV) -v $(CWD):$(CWD) -w $(CWD)
+VCFLAGS = /nologo /W3 /O2 /MD /I. $(DEFS) $(TFLAGS)
 IPV6 ?= 1
 ASAN ?= -fsanitize=address,undefined -fno-sanitize-recover=all
 ASAN_OPTIONS ?= detect_leaks=1
-EXAMPLES := $(dir $(wildcard examples/*/Makefile))
+EXAMPLES := $(dir $(wildcard examples/*/Makefile)) examples/stm32/nucleo-f746zg-baremetal
 PREFIX ?= /usr/local
 VERSION ?= $(shell cut -d'"' -f2 src/version.h)
-COMMON_CFLAGS ?= $(WARN) $(INCS) $(DEFS) -DMG_ENABLE_IPV6=$(IPV6) $(TFLAGS) $(EXTRA)
+COMMON_CFLAGS ?= $(WARN) $(INCS) $(DEFS) -DMG_ENABLE_IPV6=$(IPV6) $(TFLAGS)
 CFLAGS ?= $(OPTS) $(ASAN) $(COMMON_CFLAGS)
 VALGRIND_CFLAGS ?= $(VALGRIND_OPTS) $(COMMON_CFLAGS)
 VALGRIND_RUN ?= valgrind --tool=memcheck --gen-suppressions=all --leak-check=full --show-leak-kinds=all --leak-resolution=high --track-origins=yes --error-exitcode=1 --exit-on-first-error=yes
@@ -33,20 +34,20 @@ CFLAGS  += -DMG_ENABLE_OPENSSL=1 -I$(OPENSSL)/include
 LDFLAGS ?= -L$(OPENSSL)/lib -lssl -lcrypto
 endif
 
-all: mg_prefix unamalgamated unpacked test test++ valgrind arm examples vc98 vc2017 mingw mingw++ linux linux++ fuzz
+all: mg_prefix unamalgamated unpacked test test++ arm examples vc98 vc17 vc22 mingw mingw++ linux linux++ fuzz
 
 examples:
 	@for X in $(EXAMPLES); do test -f $$X/Makefile || continue; $(MAKE) -C $$X example || exit 1; done
 
 test/packed_fs.c: Makefile src/ssi.h test/fuzz.c test/data/a.txt
 	$(CC) $(CFLAGS) test/pack.c -o pack
-	./pack Makefile src/ssi.h test/fuzz.c test/data/a.txt test/data/range.txt > $@
+	$(RUN) ./pack Makefile src/ssi.h test/fuzz.c test/data/a.txt test/data/range.txt > $@
 
 DIR ?= test/data/
 OUT ?= fs_packed.c
 mkfs:
 	$(CC) $(CFLAGS) test/pack.c -o pack
-	./pack -s $(DIR) `find $(DIR) -type f` > $(OUT)
+	$(RUN) ./pack -s $(DIR) `find $(DIR) -type f` > $(OUT)
 #	find $(DIR) -type f | sed -e s,^$(DIR),,g -e s,^/,,g
 
 # Check that all external (exported) symbols have "mg_" prefix
@@ -54,15 +55,15 @@ mg_prefix: mongoose.c mongoose.h
 	$(CC) mongoose.c $(CFLAGS) -c -o /tmp/x.o && nm /tmp/x.o | grep ' T' | grep -v 'mg_' ; test $$? = 1
 
 # C++ build
-test++: CC = g++
-test++: C_WARN =
-test++: WARN += -Wno-shadow -Wno-missing-field-initializers -Wno-deprecated
 test++: test
+test++: CC = g++
+test++: C_WARN = -std=c++2a -Wno-vla -Wno-shadow -Wno-missing-field-initializers -Wno-deprecated
 
 musl: test
 musl: ASAN =
 musl: WARN += -Wno-sign-conversion
 musl: CC = $(DOCKER) mdashnet/cc1 gcc
+musl: RUN = $(DOCKER) mdashnet/cc1
 
 # Make sure we can build from an unamalgamated sources
 unamalgamated: $(HDRS) Makefile test/packed_fs.c
@@ -72,18 +73,19 @@ unpacked:
 	$(CC) -I. mongoose.c test/unit_test.c -o $@
 
 fuzzer: mongoose.c mongoose.h Makefile test/fuzz.c
-	clang++ mongoose.c test/fuzz.c $(WARN) $(INCS) $(TFLAGS) $(EXTRA) -DMG_ENABLE_LINES -fsanitize=fuzzer,signed-integer-overflow,address -Wno-deprecated -o $@
+	clang++ mongoose.c test/fuzz.c $(WARN) $(INCS) $(TFLAGS) -DMG_ENABLE_LINES -fsanitize=fuzzer,signed-integer-overflow,address -Wno-deprecated -Wno-vla-extension -o $@
 
 fuzz: fuzzer
 	$(RUN) ./fuzzer
 
 unit_test: Makefile mongoose.h $(SRCS)
-	$(CC) $(SRCS) $(CFLAGS) -coverage $(LDFLAGS) -g -o unit_test
+	$(CC) $(SRCS) $(CFLAGS) $(LDFLAGS) -g -o unit_test
 
 # make CC=/usr/local/opt/llvm\@8/bin/clang ASAN_OPTIONS=detect_leaks=1
 test: unit_test
 	ASAN_OPTIONS=$(ASAN_OPTIONS) $(RUN) ./unit_test
 
+coverage: CFLAGS += -coverage
 coverage: test
 	gcov -l -n *.gcno | sed '/^$$/d' | sed 'N;s/\n/ /'
 	gcov -t mongoose.c > mongoose.gcov
@@ -92,7 +94,7 @@ upload-coverage: coverage
 	curl -s https://codecov.io/bash | /bin/bash
 
 valgrind_unit_test: Makefile mongoose.h $(SRCS)
-	$(CC) $(SRCS) $(VALGRIND_CFLAGS) -coverage $(LDFLAGS) -g -o valgrind_unit_test
+	$(CC) $(SRCS) $(VALGRIND_CFLAGS) $(LDFLAGS) -g -o valgrind_unit_test
 
 valgrind: valgrind_unit_test
 	$(VALGRIND_RUN) ./valgrind_unit_test
@@ -100,29 +102,34 @@ valgrind: valgrind_unit_test
 infer:
 	infer run -- cc test/unit_test.c -c -W -Wall -Werror -Isrc -I. -O2 -DMG_ENABLE_MBEDTLS=1 -DMG_ENABLE_LINES -I/usr/local/Cellar/mbedtls/2.23.0/include  -DMG_ENABLE_IPV6=1 -g -o /dev/null
 
+arm: DEFS += -DMG_ENABLE_FILE=0 -DMG_ENABLE_MIP=1 -DMG_ARCH=MG_ARCH_NEWLIB 
 arm: mongoose.h $(SRCS)
-	$(DOCKER) mdashnet/armgcc arm-none-eabi-gcc -mcpu=cortex-m3 -mthumb $(SRCS) test/mongoose_custom.c -Itest -DMG_ARCH=MG_ARCH_NEWLIB $(OPTS) $(WARN) $(INCS) $(DEFS) -o unit_test -nostartfiles --specs nosys.specs -e 0
+	$(DOCKER) mdashnet/armgcc arm-none-eabi-gcc -mcpu=cortex-m3 -mthumb $(SRCS) $(OPTS) $(WARN) $(INCS) $(DEFS) $(TFLAGS) -o unit_test -nostartfiles --specs nosys.specs -e 0
 
+riscv: DEFS += -DMG_ENABLE_FILE=0 -DMG_ENABLE_MIP=1 -DMG_ARCH=MG_ARCH_NEWLIB 
 riscv: mongoose.h $(SRCS)
-	$(DOCKER) mdashnet/riscv riscv-none-elf-gcc -march=rv32imc -mabi=ilp32 $(SRCS) test/mongoose_custom.c -Itest -DMG_ARCH=MG_ARCH_NEWLIB $(OPTS) $(WARN) $(INCS) $(DEFS) -o unit_test
+	$(DOCKER) mdashnet/riscv riscv-none-elf-gcc -march=rv32imc -mabi=ilp32 $(SRCS) $(OPTS) $(WARN) $(INCS) $(DEFS) $(TFLAGS) -o unit_test
 
-#vc98: VCFLAGS += -DMG_ENABLE_IPV6=1
 vc98: Makefile mongoose.h $(SRCS)
 	$(DOCKER) mdashnet/vc98 wine cl $(SRCS) $(VCFLAGS) ws2_32.lib /Fe$@.exe
 	$(DOCKER) mdashnet/vc98 wine $@.exe
 
-#vc2017: VCFLAGS += -DMG_ENABLE_IPV6=1
+# vc17: DEFS += -DMG_ENABLE_IPV6=1
-vc2017: Makefile mongoose.h $(SRCS)
+vc17: Makefile mongoose.h $(SRCS)
-	$(DOCKER) mdashnet/vc2017 wine64 cl $(SRCS) $(VCFLAGS) ws2_32.lib /Fe$@.exe
+	$(DOCKER) mdashnet/vc17 wine64 cl $(SRCS) $(VCFLAGS) ws2_32.lib /Fe$@.exe
-	$(DOCKER) mdashnet/vc2017 wine64 $@.exe
+	$(DOCKER) mdashnet/vc17 wine64 $@.exe
+
+# vc22: DEFS += -DMG_ENABLE_IPV6=$(IPV6)
+vc22: Makefile mongoose.h $(SRCS)
+	$(DOCKER) mdashnet/vc22 wine64 cl $(SRCS) $(VCFLAGS) ws2_32.lib /Fe$@.exe
+	$(DOCKER) mdashnet/vc22 wine64 $@.exe
 
 mingw: Makefile mongoose.h $(SRCS)
-	$(DOCKER) mdashnet/mingw i686-w64-mingw32-gcc $(SRCS) -W -Wall -Werror -I. $(DEFS) -lwsock32 -o test.exe
+	$(DOCKER) mdashnet/mingw x86_64-w64-mingw32-gcc $(SRCS) -W -Wall -Werror -I. $(DEFS) -lwsock32 -o $@.exe
-	$(DOCKER) mdashnet/vc98 wine test.exe
+	$(DOCKER) mdashnet/mingw wine64 $@.exe
 
 mingw++: Makefile mongoose.h $(SRCS)
-	$(DOCKER) mdashnet/mingw i686-w64-mingw32-g++ $(SRCS) -W -Wall -Werror -I. $(DEFS) -lwsock32 -o test.exe
+	$(DOCKER) mdashnet/mingw x86_64-w64-mingw32-g++ $(SRCS) -W -Wall -Werror -I. $(DEFS) -lwsock32 -o $@.exe
-  # Note: for some reason, a binary built with mingw g++, fails to run
 
 linux: IPV6=0
 linux: Makefile mongoose.h $(SRCS)
@@ -146,12 +153,12 @@ install: linux-libs
 uninstall:
 	rm -rf $(DESTDIR)$(PREFIX)/lib/libmongoose.a $(DESTDIR)$(PREFIX)/lib/libmongoose.so.$(VERSION) $(DESTDIR)$(PREFIX)/include/mongoose.h $(DESTDIR)$(PREFIX)/lib/libmongoose.so
 
-mongoose.c: Makefile $(wildcard src/*)
+mongoose.c: Makefile $(wildcard src/*) $(wildcard mip/*.c)
-	(cat src/license.h; echo; echo '#include "mongoose.h"' ; (for F in src/*.c ; do echo; echo '#ifdef MG_ENABLE_LINES'; echo "#line 1 \"$$F\""; echo '#endif'; cat $$F | sed -e 's,#include ".*,,'; done))> $@
+	(cat src/license.h; echo; echo '#include "mongoose.h"' ; (for F in src/*.c mip/*.c ; do echo; echo '#ifdef MG_ENABLE_LINES'; echo "#line 1 \"$$F\""; echo '#endif'; cat $$F | sed -e 's,#include ".*,,'; done))> $@
 
 mongoose.h: $(HDRS) Makefile
-	(cat src/license.h; echo; echo '#ifndef MONGOOSE_H'; echo '#define MONGOOSE_H'; echo; cat src/version.h ; echo; echo '#ifdef __cplusplus'; echo 'extern "C" {'; echo '#endif'; cat src/arch.h src/arch_*.h src/config.h src/str.h src/log.h src/timer.h src/fs.h src/util.h src/url.h src/iobuf.h src/base64.h src/md5.h src/sha1.h src/event.h src/net.h src/http.h src/ssi.h src/tls.h src/tls_mbed.h src/tls_openssl.h src/ws.h src/sntp.h src/mqtt.h src/dns.h src/mip.h | sed -e 's,#include ".*,,' -e 's,^#pragma once,,'; echo; echo '#ifdef __cplusplus'; echo '}'; echo '#endif'; echo '#endif  // MONGOOSE_H')> $@
+	(cat src/license.h; echo; echo '#ifndef MONGOOSE_H'; echo '#define MONGOOSE_H'; echo; cat src/version.h ; echo; echo '#ifdef __cplusplus'; echo 'extern "C" {'; echo '#endif'; cat src/arch.h src/arch_*.h src/config.h src/str.h src/fmt.h src/log.h src/timer.h src/fs.h src/util.h src/url.h src/iobuf.h src/base64.h src/md5.h src/sha1.h src/event.h src/net.h src/http.h src/ssi.h src/tls.h src/tls_mbed.h src/tls_openssl.h src/ws.h src/sntp.h src/mqtt.h src/dns.h src/json.h src/rpc.h mip/mip.h | sed -e 's,#include ".*,,' -e 's,^#pragma once,,'; echo; echo '#ifdef __cplusplus'; echo '}'; echo '#endif'; echo '#endif  // MONGOOSE_H')> $@
 
 clean:
-	rm -rf $(PROG) *.o *.dSYM unit_test* valgrind_unit_test* ut fuzzer *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb slow-unit* _CL_* infer-out data.txt crash-* test/packed_fs.c pack unpacked
+	rm -rf $(PROG) *.exe *.o *.dSYM unit_test* valgrind_unit_test* ut fuzzer *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb slow-unit* _CL_* infer-out data.txt crash-* test/packed_fs.c pack unpacked
 	@for X in $(EXAMPLES); do $(MAKE) -C $$X clean; done

README.md

@@ -64,16 +64,6 @@ We take security seriously:
   have specific security requirements and run independent security audits,
   of which we get notified and in case of any issue, act similar to (3).
 
-# Supplement software
-
-This software is often used together with Mongoose:
-- [mjson](https://github.com/cesanta/mjson) - a JSON parser, emitter and
-  JSON-RPC engine. Used to implement
-  RESTful APIs that use JSON, or implement data exchange (e.g. over MQTT
-  or Websocket) that use JSON for data encapsulation
-- [elk](https://github.com/cesanta/elk) - a tiny JavaScript engine.
-  Used to implement scripting support
-
 
 # Contributions
 

docs/images/mg_commalist.svg

@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 1034 239" style="enable-background:new 0 0 1034 239;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:#576174;}
+	.st1{fill:#FFFFFF;}
+	.st2{font-family:'Courier-Bold';}
+	.st3{font-size:16.7604px;}
+	.st4{fill:#00983A;}
+	.st5{fill:none;stroke:#45CFFF;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
+	.st6{fill:#45CFFF;}
+	.st7{fill:none;stroke:#A000FF;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
+	.st8{fill:#A000FF;}
+	.st9{fill:none;stroke:#FFDE00;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
+	.st10{fill:#FFDE00;}
+	.st11{fill:none;stroke:#EA5B0C;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
+	.st12{fill:#EA5B0C;}
+</style>
+<g>
+	<path class="st0" d="M485.3,224.22H8.5c-4.7,0-8.5-3.8-8.5-8.5V27.22c0-4.7,3.8-8.5,8.5-8.5h476.8c4.7,0,8.5,3.8,8.5,8.5v188.5
+		C493.8,220.32,490,224.22,485.3,224.22z"/>
+	<g>
+		<g>
+			<g>
+				<text transform="matrix(1 0 0 1 21.294 60.1267)" class="st1 st2 st3">struct mg_str k,v,s = mg_str(”a=333, b=777”);</text>
+			</g>
+		</g>
+		<g>
+			<g>
+				<text transform="matrix(1 0 0 1 21.294 136.2499)" class="st1 st2 st3">mg_commalist(&amp;s, &amp;k, &amp;v); </text>
+			</g>
+		</g>
+		<g>
+			<g>
+				<text transform="matrix(1 0 0 1 21.294 197.1485)" class="st1 st2 st3">mg_commalist(&amp;s, &amp;k, &amp;v); </text>
+			</g>
+		</g>
+		<g>
+			<g>
+				<text transform="matrix(1 0 0 1 291.5096 140.18)" class="st4 st2 st3">// 1st call</text>
+				<text transform="matrix(1 0 0 1 291.5096 199.8101)" class="st4 st2 st3">// 2nd call</text>
+			</g>
+		</g>
+	</g>
+	<g>
+		<polyline class="st5" points="336.4,64.52 336.4,68.52 317.8,68.52 317.8,64.52 		"/>
+		<g>
+			<path class="st5" d="M122.3,59.62"/>
+			<g>
+				<polyline class="st5" points="327.5,76.82 327.6,94.02 203.3,94.02 203.3,116.12 				"/>
+				<path class="st6" d="M331,77.62c0,1.8-1.4,3.2-3.2,3.3c-1.8,0.1-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
+					C329.5,74.42,331,75.92,331,77.62z"/>
+			</g>
+		</g>
+		<path class="st6" d="M203.2,114.92c-1.8,0-3.2,1.3-3.3,3s1.4,3,3.2,3s3.2-1.3,3.3-3l0,0C206.5,116.32,205,114.92,203.2,114.92z"/>
+	</g>
+	<g>
+		<polyline class="st7" points="407.4,64.52 407.4,68.52 388.8,68.52 388.8,64.52 		"/>
+		<g>
+			<path class="st5" d="M193.4,59.62"/>
+			<g>
+				<polyline class="st7" points="398.6,76.82 398.6,149.02 203.4,149.02 203.4,177.12 				"/>
+				<path class="st8" d="M402,77.62c0,1.8-1.4,3.2-3.2,3.3c-1.8,0.1-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
+					C400.6,74.42,402,75.92,402,77.62z"/>
+			</g>
+		</g>
+		<path class="st8" d="M203.2,175.42c-1.8,0-3.2,1.3-3.3,3s1.4,3,3.2,3s3.2-1.3,3.3-3l0,0C206.5,176.82,205,175.42,203.2,175.42z"/>
+	</g>
+	<g>
+		<polyline class="st9" points="440.8,64.52 440.8,68.52 414.2,68.52 414.2,64.52 		"/>
+		<g>
+			<path class="st5" d="M218.8,59.62"/>
+			<g>
+				<polyline class="st9" points="428,76.82 428,163.02 245.7,163.02 245.7,176.12 				"/>
+				<path class="st10" d="M431.4,77.62c0,1.8-1.4,3.2-3.2,3.3c-1.8,0.1-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
+					C430,74.42,431.4,75.92,431.4,77.62z"/>
+			</g>
+		</g>
+		<path class="st10" d="M245.4,175.42c-1.8,0-3.2,1.3-3.3,3s1.4,3,3.2,3s3.2-1.3,3.3-3l0,0C248.7,176.82,247.2,175.42,245.4,175.42z
+			"/>
+	</g>
+	<g>
+		<polyline class="st11" points="372.8,64.52 372.8,68.52 343.2,68.52 343.2,64.52 		"/>
+		<g>
+			<path class="st5" d="M164.7,59.62"/>
+			<g>
+				<polyline class="st11" points="358.3,76.62 358.3,104.82 245.7,105.02 245.7,116.12 				"/>
+				<path class="st12" d="M361.4,77.62c0,1.8-1.4,3.2-3.2,3.3c-1.8,0.1-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
+					C359.9,74.42,361.4,75.92,361.4,77.62z"/>
+			</g>
+		</g>
+		<path class="st12" d="M245.7,114.92c-1.8,0-3.2,1.3-3.3,3s1.4,3,3.2,3s3.2-1.3,3.3-3l0,0C248.9,116.32,247.4,114.92,245.7,114.92z
+			"/>
+	</g>
+</g>
+</svg>

docs/images/mg_http_get_request_len.svg

@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 1034 158.07" style="enable-background:new 0 0 1034 158.07;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:#67748A;}
+	.st1{fill:#FFFFFF;}
+	.st2{font-family:'Courier-Bold';}
+	.st3{font-size:16.7604px;}
+	.st4{fill:none;stroke:#45CFFF;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
+	.st5{fill:#45CFFF;}
+	.st6{font-family:'Arial-BoldMT';}
+</style>
+<g>
+	<path class="st0" d="M516.7,39.8v56.33c0,4.17-3.8,7.54-8.5,7.54H14.6H8.5c-4.7,0-8.5-3.37-8.5-7.54V39.8c0-4.17,3.8-7.54,8.5-7.54
+		h499.7C512.9,32.26,516.7,35.63,516.7,39.8z"/>
+	<text transform="matrix(1 0 0 1 51.0379 69.3318)" class="st1 st2 st3">GET /test \n\nGET /test \n\nGET test \n\n</text>
+	<g>
+		<polyline class="st4" points="189.5,76.47 189.5,80.47 51.8,80.47 51.8,76.47 		"/>
+		<polyline class="st4" points="331.3,76.47 331.3,80.47 195.6,80.47 195.6,76.47 		"/>
+		<polyline class="st4" points="462.7,76.47 462.7,80.47 336.9,80.47 336.9,76.47 		"/>
+	</g>
+	<g>
+		<text transform="matrix(1 0 0 1 78.8909 148.8896)" class="st5 st6 st3">1st request</text>
+		<g>
+			<line class="st4" x1="120.2" y1="93.57" x2="120.3" y2="129.57"/>
+			<path class="st5" d="M117.1,92.57c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
+				C118.5,95.77,117.1,94.37,117.1,92.57z"/>
+		</g>
+	</g>
+	<g>
+		<text transform="matrix(1 0 0 1 217.3594 148.8891)" class="st5 st6 st3">2nd request </text>
+		<g>
+			<line class="st4" x1="263.8" y1="93.57" x2="263.9" y2="129.57"/>
+			<path class="st5" d="M260.7,92.57c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
+				C262.1,95.77,260.7,94.37,260.7,92.57z"/>
+		</g>
+	</g>
+	<g>
+		<text transform="matrix(1 0 0 1 354.7297 148.8896)" class="st5 st6 st3">3rd request </text>
+		<g>
+			<line class="st4" x1="399.4" y1="93.57" x2="399.4" y2="129.57"/>
+			<path class="st5" d="M396.2,92.57c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
+				C397.7,95.77,396.2,94.37,396.2,92.57z"/>
+		</g>
+	</g>
+</g>
+</svg>

docs/images/mg_http_message.svg

@@ -0,0 +1,113 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 1035.4 429.9" style="enable-background:new 0 0 1035.4 429.9;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:#576174;}
+	.st1{fill:#67748A;}
+	.st2{fill:none;stroke:#87005B;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
+	.st3{fill:#87005B;}
+	.st4{fill:#FFFFFF;}
+	.st5{font-family:'Courier-Bold';}
+	.st6{font-size:16.7604px;}
+	.st7{fill:none;stroke:#EA5B0C;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
+	.st8{fill:#EA5B0C;}
+	.st9{fill:none;stroke:#CA70FF;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
+	.st10{fill:#CA70FF;}
+	.st11{fill:none;stroke:#FFDE00;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
+	.st12{fill:#FFDE00;}
+	.st13{fill:none;stroke:#00CF4F;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
+	.st14{fill:#00CF4F;}
+	.st15{fill:none;stroke:#45CFFF;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
+	.st16{fill:none;stroke:#EA5B0C;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
+	.st17{font-family:'Arial-BoldMT';}
+	.st18{font-size:24px;}
+	.st19{fill:#45CFFF;}
+</style>
+<g>
+	<path class="st0" d="M755.8,391.8H8.5c-4.7,0-8.5-3.8-8.5-8.5v-153c0-4.7,3.8-8.5,8.5-8.5h747.3c4.7,0,8.5,3.8,8.5,8.5v153
+		C764.3,388,760.5,391.8,755.8,391.8z"/>
+	<path class="st1" d="M996.9,261.5h-427c-4.7,0-8.5-3.8-8.5-8.5V81.2c0-4.7,3.8-8.5,8.5-8.5h427c4.7,0,8.5,3.8,8.5,8.5V253
+		C1005.4,257.7,1001.5,261.5,996.9,261.5z"/>
+	<g>
+		<polyline class="st2" points="598.1,238.2 598.1,242.3 787.7,242.3 787.7,238.2 		"/>
+		<g>
+			<line class="st2" x1="689.3" y1="342.2" x2="276.4" y2="343.3"/>
+			<g>
+				<line class="st2" x1="689.4" y1="253.3" x2="689.4" y2="342.1"/>
+				<path class="st3" d="M689.4,249.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2l0,0
+					C686.1,250.7,687.6,249.3,689.4,249.3z"/>
+			</g>
+		</g>
+		<path class="st3" d="M274.2,340.4c1.8,0,3.2,1.4,3.3,3.2s-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2l0,0
+			C270.9,341.8,272.4,340.4,274.2,340.4z"/>
+	</g>
+	<text transform="matrix(1 0 0 1 26.0923 262.5192)" class="st4 st5 st6">struct mg_http_message {</text>
+	<text transform="matrix(1 0 0 1 45.542 286.2874)" class="st4 st5 st6">struct mg_str method; uri, query, proto; </text>
+	<text transform="matrix(1 0 0 1 45.542 306.3874)" class="st4 st5 st6">struct mg_http_header headers[MG_MAX_HTTP_HEADERS];</text>
+	<text transform="matrix(1 0 0 1 45.542 326.4874)" class="st4 st5 st6">struct mg_str body;</text>
+	<text transform="matrix(1 0 0 1 45.542 346.5874)" class="st4 st5 st6">struct mg_str message; </text>
+	<g>
+		<g>
+			<polyline class="st7" points="621.1,89.6 621.1,78.6 215.4,79.7 215.3,269.4 			"/>
+			<path class="st8" d="M624.3,90.6c0,1.8-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
+				C622.8,87.4,624.3,88.8,624.3,90.6z"/>
+		</g>
+		<path class="st8" d="M212.3,269.4c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
+			C213.7,272.6,212.3,271.2,212.3,269.4z"/>
+	</g>
+	<g>
+		<polyline class="st9" points="597.2,183.6 593.1,183.6 593.1,127.8 597.2,127.8 		"/>
+		<g>
+			<polyline class="st9" points="582.4,156.2 575.2,156.2 575,302.8 563.4,302.8 			"/>
+			<path class="st10" d="M586.1,156.2c0-1.8-1.4-3.2-3.2-3.3c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3l0,0
+				C584.7,159.4,586.1,158,586.1,156.2z"/>
+			<path class="st10" d="M564.2,303c0-1.8-1.4-3.2-3.2-3.3c-1.8,0-3.2,1.4-3.3,3.2s1.4,3.2,3.2,3.3l0,0
+				C562.7,306.2,564.2,304.7,564.2,303z"/>
+		</g>
+	</g>
+	<text transform="matrix(1 0 0 1 601.1215 118.1291)" class="st4 st5 st6">POST /foo/bar/baz?aa=b&amp;cc=ddd HTTP/1.1</text>
+	<text transform="matrix(1 0 0 1 601.1215 138.2291)" class="st4 st5 st6">Content-Type: application/json</text>
+	<text transform="matrix(1 0 0 1 601.1215 158.3291)" class="st4 st5 st6">Content-Length: 19</text>
+	<text transform="matrix(1 0 0 1 601.1215 178.4291)" class="st4 st5 st6">Host: reqbin.com</text>
+	<g>
+		<g>
+			<g>
+				<polyline class="st11" points="712.3,90.6 712.4,67.6 277.8,67.6 279.7,269.3 				"/>
+				<path class="st12" d="M715.6,90.8c0,1.8-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
+					C714.1,87.6,715.6,89.1,715.6,90.8z"/>
+			</g>
+			<path class="st12" d="M276.5,269.4c0-1.8,1.4-3.2,3.2-3.3s3.2,1.4,3.3,3.2s-1.4,3.2-3.2,3.3l0,0
+				C278,272.6,276.5,271.2,276.5,269.4z"/>
+		</g>
+		<polyline class="st11" points="771.5,104.3 771.5,100.3 652.7,100.3 652.7,104.3 		"/>
+	</g>
+	<g>
+		<g>
+			<g>
+				<polyline class="st13" points="836.3,90.6 836.3,56.6 342.8,56.6 344.7,268.3 				"/>
+				<path class="st14" d="M839.5,90.6c0,1.8-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
+					C838,87.4,839.5,88.9,839.5,90.6z"/>
+			</g>
+			<path class="st14" d="M341.4,269.3c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
+				C342.9,272.5,341.4,271.1,341.4,269.3z"/>
+		</g>
+		<polyline class="st15" points="981.4,104.2 981.4,100.2 902.6,100.2 902.6,104.2 		"/>
+	</g>
+	<text transform="matrix(1 0 0 1 596.891 232.3658)" class="st4 st5 st6">{&quot;success&quot;: &quot;true&quot;}</text>
+	<polyline class="st16" points="643.1,104.4 643.1,100.4 599.3,100.4 599.3,104.4 	"/>
+	<text transform="matrix(1 0 0 1 9.5506 207.5157)" class="st17 st18">Source Code</text>
+	<text transform="matrix(1 0 0 1 797.0799 32.3923)" class="st17 st18">HTTP message</text>
+	<text transform="matrix(1 0 0 1 26.0924 359.209)" class="st4 st5 st6">};</text>
+	<polyline class="st13" points="894.2,104.2 894.2,100.2 774.4,100.2 774.4,104.2 	"/>
+	<g>
+		<g>
+			<polyline class="st15" points="941.3,90.6 941.3,45.6 412.8,45.6 414.7,268.3 			"/>
+			<path class="st19" d="M944.5,90.6c0,1.8-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
+				C943,87.4,944.5,88.9,944.5,90.6z"/>
+		</g>
+		<path class="st19" d="M411.4,269.3c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
+			C412.9,272.5,411.4,271.1,411.4,269.3z"/>
+	</g>
+</g>
+</svg>

docs/images/mg_http_next_multipart.svg

@@ -0,0 +1,109 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 1034 663.54" style="enable-background:new 0 0 1034 663.54;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:none;stroke:#45CFFF;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
+	.st1{fill:#45CFFF;}
+	.st2{fill:#576174;}
+	.st3{fill:#FFFFFF;}
+	.st4{font-family:'Courier-Bold';}
+	.st5{font-size:16.7604px;}
+	.st6{font-family:'Arial-BoldMT';}
+	.st7{font-size:24px;}
+	.st8{fill:#67748A;}
+	.st9{fill:#8B9CBA;}
+	.st10{fill:none;stroke:#00CF4F;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
+	.st11{fill:#00CF4F;}
+	.st12{fill:none;stroke:#EA5B0C;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
+	.st13{fill:#EA5B0C;}
+	.st14{fill:#414857;}
+</style>
+<g>
+	<g>
+		<polyline class="st0" points="498.5,624.21 498.5,628.21 447.9,628.21 447.9,624.21 		"/>
+		<g>
+			<path class="st0" d="M491.8,844.81"/>
+			<g>
+				<path class="st1" d="M473.8,636.11c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2l0,0
+					C477.1,637.61,475.6,636.11,473.8,636.11z"/>
+			</g>
+		</g>
+		<path class="st1" d="M296.7,852.71c-1.8,0-3.2,1.3-3.3,3c0,1.7,1.4,3,3.2,3c1.8,0,3.2-1.3,3.3-3l0,0
+			C299.9,854.01,298.5,852.71,296.7,852.71z"/>
+	</g>
+	<g>
+		<path class="st2" d="M584.6,199.01H8.5c-4.7,0-8.5-3.8-8.5-8.5V60.71c0-4.7,3.8-8.5,8.5-8.5h576.1c4.7,0,8.5,3.8,8.5,8.5v129.8
+			C593.1,195.21,589.3,199.01,584.6,199.01z"/>
+		<g>
+			<g>
+				<g>
+					<text transform="matrix(1 0 0 1 28.7 90.8107)" class="st3 st4 st5">struct mg_http_part part;</text>
+					<text transform="matrix(1 0 0 1 28.7 110.9108)" class="st3 st4 st5">size_t pos = 0;</text>
+					<text transform="matrix(1 0 0 1 28.7 151.1107)" class="st3 st4 st5">pos = mg_http_next_multipart(&amp;hm-&gt;body, pos, &amp;part);</text>
+					<text transform="matrix(1 0 0 1 28.7 171.3107)" class="st3 st4 st5">pos = mg_http_next_multipart(&amp;hm-&gt;body, pos, &amp;part);</text>
+				</g>
+			</g>
+		</g>
+		<text transform="matrix(1 0 0 1 1.3738 40.559)" class="st6 st7">Source Code</text>
+	</g>
+	<g>
+		<g>
+			<path class="st8" d="M685.5,646.41H8.5c-4.7,0-8.5-3.8-8.5-8.5v-362.9c0-4.7,3.8-8.5,8.5-8.5h677c4.7,0,8.5,3.8,8.5,8.5v362.9
+				C694,642.61,690.2,646.41,685.5,646.41z"/>
+		</g>
+		<path class="st9" d="M640.2,629.41H26.3c-4.7,0-8.5-3.8-8.5-8.5v-106.5c0-4.7,3.8-8.5,8.5-8.5h613.9c4.7,0,8.5,3.8,8.5,8.5v106.5
+			C648.7,625.61,644.8,629.41,640.2,629.41z"/>
+		<path class="st9" d="M644,490.91H30.1c-4.7,0-8.5-3.8-8.5-8.5v-106.5c0-4.7,3.8-8.5,8.5-8.5H644c4.7,0,8.5,3.8,8.5,8.5v106.5
+			C652.5,487.11,648.7,490.91,644,490.91z"/>
+		<g>
+			<text transform="matrix(1 0 0 1 0.0299 253.0343)" class="st6 st7">HTTP message</text>
+		</g>
+		<g>
+			<text transform="matrix(1 0 0 1 28.7 302.8107)" class="st3 st4 st5">POST /upload HTTP/1.1 </text>
+			<text transform="matrix(1 0 0 1 28.7 322.9107)" class="st3 st4 st5">Content-Type: multipart/form-data; boundary=&quot;--xyz&quot;</text>
+			<text transform="matrix(1 0 0 1 28.7 363.1107)" class="st3 st4 st5">--xyz</text>
+			<text transform="matrix(1 0 0 1 28.7 383.3107)" class="st3 st4 st5">Content-Disposition: form-data; name=&quot;foo&quot;; filename=&quot;a.txt&quot;</text>
+			<text transform="matrix(1 0 0 1 28.7 403.4107)" class="st3 st4 st5">Content-Type: text/plain</text>
+			<text transform="matrix(1 0 0 1 28.7 443.6107)" class="st3 st4 st5">hello world</text>
+			<text transform="matrix(1 0 0 1 28.7 483.8107)" class="st3 st4 st5">--xyz---</text>
+			<text transform="matrix(1 0 0 1 28.7 524.0107)" class="st3 st4 st5">Content-Disposition: form-data; name=&quot;bar&quot;; filename=&quot;b.txt&quot;</text>
+			<text transform="matrix(1 0 0 1 28.7 544.2108)" class="st3 st4 st5">Content-Type: text/plain</text>
+			<text transform="matrix(1 0 0 1 28.7 584.4108)" class="st3 st4 st5">hello world again</text>
+			<text transform="matrix(1 0 0 1 28.7 624.6107)" class="st3 st4 st5">--xyz--</text>
+		</g>
+	</g>
+	<g>
+		<g>
+			<polyline class="st10" points="569.5,162.51 574.5,162.51 574.5,176.11 569.5,176.11 			"/>
+			<g>
+				<path class="st0" d="M726.8,392.91"/>
+				<g>
+					<polyline class="st10" points="587.3,169.71 726.7,169.71 726.6,569.31 684.3,569.31 					"/>
+					<path class="st11" d="M585,166.41c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2l0,0
+						C588.2,167.91,586.8,166.41,585,166.41z"/>
+				</g>
+			</g>
+			<path class="st11" d="M685,566.31c-1.7,0-3,1.3-3,3s1.3,3,3,3s3-1.3,3-3l0,0C688,567.61,686.6,566.31,685,566.31z"/>
+		</g>
+		<polyline class="st10" points="657.9,501.61 673.9,501.61 673.9,634.21 657.9,634.21 		"/>
+	</g>
+	<g>
+		<g>
+			<polyline class="st12" points="569.5,143.21 574.5,143.21 574.5,156.81 569.5,156.81 			"/>
+			<g>
+				<path class="st0" d="M726.8,254.61"/>
+				<g>
+					<polyline class="st12" points="587.3,150.41 710.7,150.41 710.6,431.01 684.3,431.01 					"/>
+					<path class="st13" d="M585,147.11c-1.8,0-3.2,1.4-3.3,3.2s1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2l0,0
+						C588.2,148.61,586.8,147.11,585,147.11z"/>
+				</g>
+			</g>
+			<path class="st13" d="M685,428.01c-1.7,0-3,1.3-3,3s1.3,3,3,3s3-1.3,3-3l0,0C688,429.31,686.6,428.01,685,428.01z"/>
+		</g>
+		<polyline class="st12" points="657.9,363.31 673.9,363.31 673.9,495.91 657.9,495.91 		"/>
+	</g>
+	<text transform="matrix(1 0 0 1 537.9671 462.1467)" class="st14 st6 st7">Part 1</text>
+	<text transform="matrix(1 0 0 1 537.9671 600.4373)" class="st14 st6 st7">Part 2</text>
+</g>
+</svg>

docs/images/mg_http_part.svg

@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 1034 480.6" style="enable-background:new 0 0 1034 480.6;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:#67748A;}
+	.st1{fill:#8B9CBA;}
+	.st2{fill:#FFFFFF;}
+	.st3{font-family:'Courier-Bold';}
+	.st4{font-size:16.7604px;}
+	.st5{fill:#414857;}
+	.st6{font-family:'Arial-BoldMT';}
+	.st7{font-size:30px;}
+	.st8{font-size:24px;}
+	.st9{fill:#576174;}
+	.st10{fill:none;stroke:#45CFFF;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
+	.st11{fill:#45CFFF;}
+	.st12{fill:none;stroke:#EA5B0C;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
+	.st13{fill:#EA5B0C;}
+	.st14{fill:none;stroke:#EA5B0C;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
+	.st15{fill:none;stroke:#FFDE00;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
+	.st16{fill:#FFDE00;}
+</style>
+<g>
+	<g>
+		<path class="st0" d="M908.4,454.9H272c-4.7,0-8.5-3.8-8.5-8.5V216c0-4.7,3.8-8.5,8.5-8.5h636.4c4.7,0,8.5,3.8,8.5,8.5v230.4
+			C916.9,451.1,913.1,454.9,908.4,454.9z"/>
+		<g>
+			<path class="st1" d="M898.6,430.8H284.7c-4.7,0-8.5-3.8-8.5-8.5V315.9c0-4.7,3.8-8.5,8.5-8.5h613.9c4.7,0,8.5,3.8,8.5,8.5v106.5
+				C907.1,427,903.3,430.8,898.6,430.8z"/>
+			<text transform="matrix(1 0 0 1 295.3688 243.086)" class="st2 st3 st4">POST /upload HTTP/1.1 </text>
+			<text transform="matrix(1 0 0 1 295.3688 263.186)" class="st2 st3 st4">Content-Type: multipart/form-data: boundary=&quot;--xyz&quot;</text>
+			<text transform="matrix(1 0 0 1 295.3688 303.386)" class="st2 st3 st4">--xyz</text>
+			<text transform="matrix(1 0 0 1 295.3688 323.586)" class="st2 st3 st4">Content-Disposition: form-data; name=&quot;foo&quot;; filename=&quot;a.txt&quot;</text>
+			<text transform="matrix(1 0 0 1 295.3688 343.686)" class="st2 st3 st4">Content-Type: text/plain</text>
+			<text transform="matrix(1 0 0 1 295.3688 383.886)" class="st2 st3 st4">hello world</text>
+			<text transform="matrix(1 0 0 1 295.3688 424.086)" class="st2 st3 st4">--xyz---</text>
+		</g>
+	</g>
+	<text transform="matrix(1 0 0 1 739.2766 414.2906)" class="st5 st6 st7">HTTP part</text>
+	<text transform="matrix(1 0 0 1 739.2764 193.4305)" class="st6 st8">HTTP message</text>
+	<path class="st9" d="M304.9,198H8.5c-4.7,0-8.5-3.8-8.5-8.5V64.8c0-4.7,3.8-8.5,8.5-8.5H305c4.7,0,8.5,3.8,8.5,8.5v124.7
+		C313.4,194.2,309.6,198,304.9,198z"/>
+	<g>
+		<g>
+			<text transform="matrix(1 0 0 1 25.2409 91.1617)" class="st2 st3 st4">struct mg_http_part {</text>
+			<text transform="matrix(1 0 0 1 47.0734 113.7079)" class="st2 st3 st4">struct mg_str name;</text>
+			<text transform="matrix(1 0 0 1 47.0734 133.8079)" class="st2 st3 st4">strucy mg_str filename;</text>
+			<text transform="matrix(1 0 0 1 47.0734 153.9079)" class="st2 st3 st4">struct mg_str body;</text>
+		</g>
+	</g>
+	<g>
+		<polyline class="st10" points="237.4,159 237.4,163 185.8,163 185.8,159 		"/>
+		<g>
+			<polyline class="st10" points="211.7,348.3 349.5,348.4 349.5,355.6 			"/>
+			<g>
+				<line class="st10" x1="211.6" y1="174.4" x2="211.6" y2="348.1"/>
+				<path class="st11" d="M211.6,170.3c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2l0,0
+					C214.8,171.8,213.4,170.3,211.6,170.3z"/>
+			</g>
+		</g>
+		<path class="st11" d="M349.6,353.6c-1.8,0-3.2,1.4-3.3,3.2s1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2l0,0
+			C352.8,355.1,351.4,353.6,349.6,353.6z"/>
+		<polyline class="st10" points="237.4,159 237.4,163 185.8,163 185.8,159 		"/>
+		<polyline class="st10" points="407.3,371.1 407.3,367.1 293.3,367.1 293.3,371.1 		"/>
+	</g>
+	<g>
+		<g>
+			<g>
+				<polyline class="st12" points="693.7,291.6 693.7,277.7 280.7,278.8 280.5,109.4 248.3,109.4 				"/>
+				<path class="st13" d="M696.9,293.6c0,1.8-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
+					C695.4,290.4,696.9,291.9,696.9,293.6z"/>
+			</g>
+			<path class="st13" d="M243.9,109.5c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
+				C245.3,112.7,243.9,111.3,243.9,109.5z"/>
+		</g>
+		<polyline class="st14" points="707.6,309.2 707.6,305.2 679.9,305.2 679.9,309.2 		"/>
+	</g>
+	<text transform="matrix(1 0 0 1 0.8627 37.8099)" class="st6 st8">Source Code</text>
+	<text transform="matrix(1 0 0 1 25.2408 177.7241)" class="st2 st3 st4">};</text>
+	<g>
+		<g>
+			<g>
+				<polyline class="st15" points="863.8,291.5 863.7,218.6 329.7,218.7 329.6,130.3 298.4,130.3 				"/>
+				<path class="st16" d="M867.1,293.6c0,1.8-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
+					C865.6,290.3,867.1,291.8,867.1,293.6z"/>
+			</g>
+			<path class="st16" d="M293,130.1c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
+				C294.4,133.3,293,131.9,293,130.1z"/>
+		</g>
+		<polyline class="st15" points="888.7,309.1 888.7,305.1 838.9,305.1 838.9,309.1 		"/>
+	</g>
+</g>
+</svg>

docs/images/mg_http_reply.svg

@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 1034 331.2" style="enable-background:new 0 0 1034 331.2;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:#576174;}
+	.st1{fill:#67748A;}
+	.st2{fill:#FFFFFF;}
+	.st3{font-family:'Courier-Bold';}
+	.st4{font-size:16.7604px;}
+	.st5{font-family:'Arial-BoldMT';}
+	.st6{font-size:24px;}
+	.st7{fill:none;stroke:#45CFFF;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
+	.st8{fill:#45CFFF;}
+	.st9{fill:none;stroke:#EA5B0C;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
+	.st10{fill:#EA5B0C;}
+	.st11{fill:none;stroke:#EA5B0C;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
+	.st12{fill:none;stroke:#00CF4F;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
+	.st13{fill:#00CF4F;}
+</style>
+<g>
+	<path class="st0" d="M541.43,184.2H8.53c-4.7,0-8.5-3.8-8.5-8.5V54.8c0-4.7,3.8-8.5,8.5-8.5h532.9c4.7,0,8.5,3.8,8.5,8.5v120.9
+		C549.93,180.4,546.13,184.2,541.43,184.2z"/>
+	<g>
+		<path class="st1" d="M829.23,315.5h-370c-4.7,0-8.5-3.8-8.5-8.5V157c0-4.7,3.8-8.5,8.5-8.5h370c4.7,0,8.5,3.8,8.5,8.5v150
+			C837.83,311.7,833.93,315.5,829.23,315.5z"/>
+		<g>
+			<text transform="matrix(1 0 0 1 490.6096 184.0905)" class="st2 st3 st4">HTTP/1.1 200 OK</text>
+			<text transform="matrix(1 0 0 1 490.6096 204.1905)" class="st2 st3 st4">Content-Length; 13</text>
+			<text transform="matrix(1 0 0 1 490.6096 224.2905)" class="st2 st3 st4">X-Header-1: additional value 1</text>
+			<text transform="matrix(1 0 0 1 490.6096 244.3905)" class="st2 st3 st4">X-Header-2: additional value 2</text>
+			<text transform="matrix(1 0 0 1 490.8657 293.1559)" class="st2 st3 st4">Hello, world!</text>
+		</g>
+	</g>
+	<text transform="matrix(1 0 0 1 660.5036 137.3383)" class="st5 st6">HTTP message</text>
+	<g>
+		<g>
+			<text transform="matrix(1 0 0 1 20.7331 85.1617)" class="st2 st3 st4">mg_http_reply(c, 200</text>
+			<text transform="matrix(1 0 0 1 159.5657 113.7079)" class="st2 st3 st4">&quot;X-Header-1: additional value 1\r\n&quot;</text>
+			<text transform="matrix(1 0 0 1 159.5657 133.8079)" class="st2 st3 st4">&quot;X-Header-2: additional value 2\r\n&quot;,</text>
+			<text transform="matrix(1 0 0 1 159.5657 153.9079)" class="st2 st3 st4">&quot;Hello, %s!&quot;, &quot;world&quot;);</text>
+		</g>
+	</g>
+	<g>
+		<polyline class="st7" points="362.93,159 362.93,163 167.33,163 167.33,159 		"/>
+		<g>
+			<polyline class="st7" points="265.93,256.6 552.13,256.7 552.13,264.4 			"/>
+			<g>
+				<line class="st7" x1="265.83" y1="174.4" x2="265.83" y2="256.6"/>
+				<path class="st8" d="M265.83,170.3c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2l0,0
+					C269.03,171.8,267.53,170.3,265.83,170.3z"/>
+			</g>
+		</g>
+		<path class="st8" d="M552.23,261.6c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2l0,0
+			C555.43,263.1,554.03,261.6,552.23,261.6z"/>
+	</g>
+	<g>
+		<g>
+			<g>
+				<polyline class="st9" points="206.33,53.6 206.43,37.6 596.43,38.7 596.53,161.3 				"/>
+				<path class="st10" d="M203.23,54.6c0,1.8,1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2c0-1.8-1.4-3.2-3.2-3.3l0,0
+					C204.63,51.4,203.23,52.8,203.23,54.6z"/>
+			</g>
+			<path class="st10" d="M599.83,164c0-1.8-1.4-3.2-3.2-3.3c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3l0,0
+				C598.33,167.2,599.83,165.8,599.83,164z"/>
+		</g>
+		<polyline class="st11" points="192.43,69.2 192.43,65.2 220.23,65.2 220.23,69.2 		"/>
+	</g>
+	<text transform="matrix(1 0 0 1 -1.917133e-04 35.0037)" class="st5 st6">Source Code</text>
+	<g>
+		<polyline class="st12" points="160.13,135.9 156.03,135.9 156.03,100.1 160.13,100.1 		"/>
+		<g>
+			<line class="st12" x1="123.93" y1="231" x2="469.73" y2="231"/>
+			<polyline class="st12" points="144.73,117.2 123.83,117.2 123.73,230.8 			"/>
+			<path class="st13" d="M147.83,117.2c0-1.8-1.4-3.2-3.2-3.3c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3l0,0
+				C146.33,120.4,147.83,119,147.83,117.2z"/>
+			<path class="st13" d="M474.83,230.8c0-1.8-1.4-3.2-3.2-3.3c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3l0,0
+				C473.43,234,474.83,232.5,474.83,230.8z"/>
+		</g>
+	</g>
+	<polyline class="st7" points="489.03,279.6 489.03,275.6 620.63,275.6 620.63,279.6 	"/>
+	<polyline class="st12" points="487.63,248.3 483.63,248.3 483.63,211.5 487.63,211.5 	"/>
+</g>
+</svg>

docs/images/mg_iobuf.svg

@@ -0,0 +1,124 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 869.6 185.67" style="enable-background:new 0 0 869.6 185.67;" xml:space="preserve">
+<style type="text/css">
+	.st0{font-family:'Arial-BoldMT';}
+	.st1{font-size:24px;}
+	.st2{opacity:0.2;fill:#00983A;enable-background:new    ;}
+	.st3{fill:none;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
+	.st4{fill:#00983A;}
+	.st5{fill:none;stroke:#576174;stroke-miterlimit:10;}
+	.st6{fill:#F2F3F3;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
+	.st7{fill:none;stroke:#576174;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
+	.st8{font-family:'Courier-Bold';}
+	.st9{font-size:16.7604px;}
+	.st10{fill:none;stroke:#00983A;stroke-linecap:round;stroke-linejoin:round;}
+	.st11{fill:#576174;}
+	.st12{font-family:'Courier';}
+	.st13{fill:none;}
+	.st14{fill:#7A8387;}
+</style>
+<g>
+	<text transform="matrix(1 0 0 1 1.0956 32.4549)" class="st0 st1">Memory</text>
+	<polyline class="st2" points="424.58,115.4 219.88,115.4 219.88,90.7 424.58,90.7 	"/>
+	<g>
+		<g>
+			<g>
+				<polyline class="st3" points="458.98,115.4 218.98,115.4 218.98,90.7 458.98,90.7 				"/>
+				<polyline class="st4" points="219.18,115.1 2.98,115.1 2.98,91.3 219.18,91.3 				"/>
+				<line class="st3" x1="2.98" y1="69.2" x2="2.98" y2="130.4"/>
+				<line class="st5" x1="219.78" y1="69.2" x2="219.78" y2="130.4"/>
+				<line class="st5" x1="425.28" y1="69.2" x2="425.28" y2="130.4"/>
+				<path class="st6" d="M458.98,115.4"/>
+				<path class="st7" d="M33.98,114.6"/>
+				<path class="st7" d="M33.98,90.9"/>
+				<path class="st7" d="M2.98,90.7h216.8v24.9l-216.8-0.2C2.98,115.4,3.18,90.7,2.98,90.7z"/>
+				<line class="st3" x1="425.18" y1="90.8" x2="425.18" y2="115.3"/>
+				<path class="st6" d="M251.98,115.6"/>
+				<path class="st6" d="M251.98,91.9"/>
+			</g>
+			<g>
+				<text transform="matrix(1 0 0 1 -2.290726e-04 175.3858)" class="st4 st8 st9">buf</text>
+			</g>
+			<g>
+				<g>
+					<line class="st10" x1="2.68" y1="158.2" x2="2.68" y2="137.2"/>
+					<g>
+						<polygon class="st4" points="0.28,137.6 5.08,137.6 2.68,135.1 						"/>
+					</g>
+				</g>
+			</g>
+			<g>
+				<g>
+					<text transform="matrix(1 0 0 1 214.6515 175.3858)" class="st4 st8 st9">len</text>
+				</g>
+			</g>
+			<g>
+				<g>
+					<line class="st10" x1="219.78" y1="158.2" x2="219.78" y2="137.2"/>
+					<g>
+						<polygon class="st4" points="217.38,137.6 222.18,137.6 219.78,135.1 						"/>
+					</g>
+				</g>
+			</g>
+			<g>
+				<g>
+					<text transform="matrix(1 0 0 1 421.6186 175.3858)" class="st4 st8 st9">size</text>
+				</g>
+			</g>
+			<g>
+				<g>
+					<line class="st10" x1="425.38" y1="158.2" x2="425.38" y2="137.2"/>
+					<g>
+						<polygon class="st4" points="422.98,137.6 427.78,137.6 425.38,135.1 						"/>
+					</g>
+				</g>
+			</g>
+			<g>
+				<g>
+					<text transform="matrix(1 0 0 1 93.1143 69.4458)" class="st11 st12 st9">data</text>
+				</g>
+				<g>
+					<g>
+						<text transform="matrix(1 0 0 1 273.8231 69.4458)" class="st11 st12 st9">free space</text>
+					</g>
+				</g>
+				<g>
+					<g>
+						<line class="st5" x1="132.98" y1="76.3" x2="13.98" y2="76.3"/>
+						<g>
+							<polygon class="st11" points="14.28,78.7 14.28,73.8 11.88,76.3 							"/>
+						</g>
+					</g>
+				</g>
+				<g>
+					<line class="st13" x1="123.88" y1="76.3" x2="210.88" y2="76.3"/>
+					<g>
+						<line class="st5" x1="123.88" y1="76.3" x2="208.78" y2="76.3"/>
+						<g>
+							<polygon class="st11" points="208.48,73.8 208.48,78.7 210.88,76.3 							"/>
+						</g>
+					</g>
+				</g>
+				<g>
+					<g>
+						<line class="st5" x1="320.38" y1="76.3" x2="414.28" y2="76.3"/>
+						<g>
+							<polygon class="st14" points="413.98,73.8 413.98,78.7 416.38,76.3 							"/>
+						</g>
+					</g>
+				</g>
+				<g>
+					<g>
+						<line class="st5" x1="322.28" y1="76.3" x2="233.28" y2="76.3"/>
+						<g>
+							<polygon class="st14" points="233.68,78.7 233.68,73.8 231.18,76.3 							"/>
+						</g>
+					</g>
+				</g>
+			</g>
+		</g>
+	</g>
+</g>
+</svg>

docs/images/mg_iobuf_add1.svg

@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 869 124.66" style="enable-background:new 0 0 869 124.66;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:#F2F3F3;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
+	.st1{fill:none;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
+	.st2{fill:#00983A;}
+	.st3{font-family:'Courier-Bold';}
+	.st4{font-size:16.7604px;}
+	.st5{fill:none;stroke:#00983A;stroke-linecap:round;stroke-linejoin:round;}
+	.st6{fill:#7A8387;}
+</style>
+<g>
+	<g>
+		<g>
+			<polyline class="st0" points="830.92,78.4 5.52,78.4 5.52,53.7 830.92,53.6 			"/>
+			<line class="st1" x1="5.52" y1="32.2" x2="5.52" y2="93.4"/>
+			<path class="st0" d="M830.92,78.4"/>
+			<line class="st1" x1="36.52" y1="53.9" x2="36.52" y2="77.6"/>
+			<line class="st1" x1="68.92" y1="53.9" x2="68.92" y2="77.6"/>
+			<line class="st1" x1="101.42" y1="53.9" x2="101.42" y2="77.6"/>
+			<line class="st1" x1="133.72" y1="53.9" x2="133.72" y2="77.6"/>
+			<line class="st1" x1="166.22" y1="53.9" x2="166.22" y2="77.6"/>
+			<line class="st1" x1="198.52" y1="54.6" x2="198.52" y2="78.3"/>
+			<line class="st1" x1="230.92" y1="54.6" x2="230.92" y2="78.3"/>
+		</g>
+		<g>
+			<text transform="matrix(1 0 0 1 59.1908 40.8585)" class="st2 st3 st4">buf=NULL, len=0, size=0 </text>
+		</g>
+		<g>
+			<text transform="matrix(1 0 0 1 -1.811981e-04 109.9024)" class="st2 st3 st4">0</text>
+		</g>
+		<g>
+			<g>
+				<g>
+					<line class="st5" x1="46.72" y1="37.7" x2="17.72" y2="37.7"/>
+					<g>
+						<polygon class="st2" points="18.12,40.1 18.12,35.2 15.62,37.7 						"/>
+					</g>
+				</g>
+			</g>
+		</g>
+		<g>
+			<path class="st6" d="M511.52,66.4c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6s0.7-1.6,1.6-1.6S511.52,65.5,511.52,66.4z"/>
+			<path class="st6" d="M525.32,66.4c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6s0.7-1.6,1.6-1.6S525.32,65.5,525.32,66.4z"/>
+			<path class="st6" d="M539.02,66.4c0,0.9-0.7,1.6-1.6,1.6c-0.9,0-1.6-0.7-1.6-1.6s0.7-1.6,1.6-1.6S539.02,65.5,539.02,66.4z"/>
+			<path class="st6" d="M552.82,66.4c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6s0.7-1.6,1.6-1.6S552.82,65.5,552.82,66.4z"/>
+		</g>
+	</g>
+</g>
+</svg>

docs/images/mg_iobuf_add2.svg

@@ -0,0 +1,185 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 869.6 127.5" style="enable-background:new 0 0 869.6 127.5;" xml:space="preserve">
+<style type="text/css">
+	.st0{opacity:0.2;fill:#00983A;enable-background:new    ;}
+	.st1{fill:#F2F3F3;}
+	.st2{fill:none;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
+	.st3{fill:#00983A;}
+	.st4{fill:#F2F3F3;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
+	.st5{fill:none;stroke:#576174;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
+	.st6{fill:none;stroke:#576174;stroke-width:1.2;stroke-linecap:square;stroke-linejoin:round;}
+	.st7{font-family:'Courier-Bold';}
+	.st8{font-size:16.7604px;}
+	.st9{fill:none;stroke:#00983A;stroke-linecap:round;stroke-linejoin:round;}
+	.st10{fill:#7A8387;}
+	.st11{fill:#576174;}
+	.st12{fill:none;stroke:#576174;stroke-linecap:round;stroke-linejoin:round;}
+	.st13{fill:none;stroke:#7A8387;stroke-linecap:round;stroke-linejoin:round;}
+	.st14{fill:#333A45;}
+</style>
+<g>
+	<g>
+		<polyline class="st0" points="577.2,72.8 282.4,72.8 282.4,48 577.2,48 		"/>
+		<g>
+			<g>
+				<g>
+					<polyline class="st1" points="122.6,72.8 5.9,72.8 5.9,48 122.6,48 					"/>
+					<polyline class="st2" points="831.51,72.8 5.5,72.8 5.5,48 831.51,48 					"/>
+					<polyline class="st3" points="282.7,72.5 122.5,72.5 122.5,47.7 282.7,47.7 					"/>
+					<line class="st2" x1="122.5" y1="26.6" x2="122.5" y2="87.8"/>
+					<line class="st2" x1="283.3" y1="26.6" x2="283.3" y2="87.8"/>
+					<line class="st2" x1="576.8" y1="26.6" x2="576.8" y2="87.8"/>
+					<path class="st4" d="M831.51,72.8"/>
+					<line class="st5" x1="153.5" y1="48.3" x2="153.5" y2="72"/>
+					<line class="st2" x1="36.5" y1="48.3" x2="36.5" y2="72"/>
+					<line class="st2" x1="67.6" y1="48.3" x2="67.6" y2="72"/>
+					<line class="st5" x1="186" y1="48.3" x2="186" y2="72"/>
+					<line class="st5" x1="218.4" y1="48.3" x2="218.4" y2="72"/>
+					<line class="st5" x1="250.9" y1="48.3" x2="250.9" y2="72"/>
+					<line class="st2" x1="315.9" y1="48.3" x2="315.9" y2="72"/>
+					<line class="st2" x1="348.4" y1="48.3" x2="348.4" y2="72"/>
+					<line class="st2" x1="381.2" y1="48.3" x2="381.2" y2="72"/>
+					<line class="st2" x1="413.8" y1="48.3" x2="413.8" y2="72"/>
+					<line class="st2" x1="446.3" y1="48.3" x2="446.3" y2="72"/>
+					<line class="st2" x1="478.9" y1="48.3" x2="478.9" y2="72"/>
+					<line class="st5" x1="511.51" y1="48.3" x2="511.51" y2="72"/>
+					<line class="st2" x1="511.51" y1="48.3" x2="511.51" y2="72"/>
+					<line class="st5" x1="544.01" y1="48.3" x2="544.01" y2="72"/>
+					<line class="st2" x1="544.1" y1="48.3" x2="544.1" y2="72"/>
+					<line class="st6" x1="283.3" y1="73" x2="122.5" y2="72.8"/>
+					<line class="st6" x1="122.5" y1="48" x2="283.3" y2="48.1"/>
+					<path class="st4" d="M385.5,73"/>
+					<path class="st4" d="M385.5,49.3"/>
+				</g>
+				<g>
+					<text transform="matrix(1 0 0 1 127.5176 105.8013)" class="st3 st7 st8">buf</text>
+				</g>
+				<g>
+					<g>
+						<line class="st9" x1="122.2" y1="105.6" x2="122.2" y2="94.6"/>
+						<g>
+							<polygon class="st3" points="119.8,94.9 124.6,94.9 122.2,92.5 							"/>
+						</g>
+					</g>
+				</g>
+				<g>
+					<text transform="matrix(1 0 0 1 286.6495 105.8008)" class="st3 st7 st8">len=5</text>
+				</g>
+				<g>
+					<g>
+						<line class="st9" x1="283.3" y1="105.6" x2="283.3" y2="94.6"/>
+						<g>
+							<polygon class="st3" points="280.9,94.9 285.8,94.9 283.3,92.5 							"/>
+						</g>
+					</g>
+				</g>
+				<g>
+					<text transform="matrix(1 0 0 1 581.4624 105.8013)" class="st3 st7 st8">size=16</text>
+				</g>
+				<g>
+					<g>
+						<line class="st9" x1="576.9" y1="105.6" x2="576.9" y2="94.6"/>
+						<g>
+							<polygon class="st3" points="574.51,94.9 579.4,94.9 576.9,92.5 							"/>
+						</g>
+					</g>
+				</g>
+				<g>
+					<path class="st10" d="M687.51,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S687.51,59.9,687.51,60.7z"/>
+					<path class="st10" d="M701.2,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S701.2,59.9,701.2,60.7z"/>
+					<path class="st10" d="M714.9,60.7c0,0.9-0.7,1.6-1.6,1.6c-0.9,0-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
+						C714.2,59.1,714.9,59.9,714.9,60.7z"/>
+					<path class="st10" d="M728.7,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
+						C728.01,59.1,728.7,59.9,728.7,60.7z"/>
+				</g>
+				<g>
+					<path class="st10" d="M82.8,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S82.8,59.9,82.8,60.7z"/>
+					<path class="st10" d="M96.5,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6C95.8,59.1,96.5,59.9,96.5,60.7
+						z"/>
+					<path class="st10" d="M110.2,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S110.2,59.9,110.2,60.7z"/>
+				</g>
+				<g>
+					<g>
+						<text transform="matrix(1 0 0 1 180.6541 26.8123)" class="st11 st7 st8">data</text>
+					</g>
+					<g>
+						<text transform="matrix(1 0 0 1 387.363 26.8123)" class="st10 st7 st8">free space</text>
+					</g>
+					<g>
+						<g>
+							<line class="st12" x1="272.2" y1="33.6" x2="133.5" y2="33.6"/>
+							<g>
+								<polygon class="st11" points="271.9,36.2 273.5,33.6 271.9,31.1 271.8,31.1 271.8,36.2 								"/>
+							</g>
+							<g>
+								<polygon class="st11" points="133.8,36.1 133.8,31.2 131.4,33.6 								"/>
+							</g>
+						</g>
+					</g>
+					<g>
+						<g>
+							<line class="st13" x1="563.7" y1="33.6" x2="295.9" y2="33.6"/>
+							<g>
+								<polygon class="st10" points="563.4,36.1 563.4,31.2 565.8,33.6 								"/>
+							</g>
+							<g>
+								<polygon class="st10" points="296.2,36.1 296.2,31.2 293.7,33.6 								"/>
+							</g>
+						</g>
+					</g>
+					<g>
+						<text transform="matrix(1 0 0 1 615.4679 25.1898)" class="st10 st7 st8">non-allocated space</text>
+					</g>
+					<g>
+						<g>
+							<line class="st13" x1="593.7" y1="33.6" x2="829.7" y2="33.6"/>
+							<g>
+								<polygon class="st10" points="829.4,31.2 829.4,36.1 831.8,33.6 								"/>
+							</g>
+						</g>
+					</g>
+					<g>
+						<g>
+							<line class="st13" x1="678.7" y1="33.6" x2="589.7" y2="33.6"/>
+							<g>
+								<polygon class="st10" points="590.01,36.1 590.01,31.2 587.6,33.6 								"/>
+							</g>
+						</g>
+					</g>
+				</g>
+				<g>
+					<g>
+						<text transform="matrix(1 0 0 1 133.1212 64.9593)" class="st14 st7 st8">h</text>
+					</g>
+				</g>
+				<g>
+					<g>
+						<text transform="matrix(1 0 0 1 165.1564 64.9593)" class="st14 st7 st8">e</text>
+					</g>
+				</g>
+				<g>
+					<g>
+						<text transform="matrix(1 0 0 1 196.8744 64.9593)" class="st14 st7 st8">l</text>
+					</g>
+				</g>
+				<g>
+					<g>
+						<text transform="matrix(1 0 0 1 229.8611 64.9593)" class="st14 st7 st8">l</text>
+					</g>
+				</g>
+				<g>
+					<g>
+						<text transform="matrix(1 0 0 1 262.2135 64.9593)" class="st14 st7 st8">o</text>
+					</g>
+				</g>
+			</g>
+		</g>
+	</g>
+	<g>
+		<text transform="matrix(1 0 0 1 1.811981e-04 105.8011)" class="st3 st7 st8">0</text>
+	</g>
+	<line class="st2" x1="5.5" y1="26.4" x2="5.5" y2="87.6"/>
+</g>
+</svg>

docs/images/mg_iobuf_del.svg

@@ -0,0 +1,347 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 869.6 247.73" style="enable-background:new 0 0 869.6 247.73;" xml:space="preserve">
+<style type="text/css">
+	.st0{opacity:0.2;fill:#00983A;enable-background:new    ;}
+	.st1{fill:#00983A;}
+	.st2{fill:#FF80A4;}
+	.st3{fill:#F2F3F3;}
+	.st4{fill:none;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
+	.st5{fill:#F2F3F3;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
+	.st6{fill:none;stroke:#576174;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
+	.st7{fill:none;stroke:#576174;stroke-width:1.2;stroke-linejoin:round;}
+	.st8{fill:none;stroke:#576174;stroke-width:1.2;stroke-linecap:square;stroke-linejoin:round;}
+	.st9{font-family:'Courier-Bold';}
+	.st10{font-size:16.7604px;}
+	.st11{fill:none;stroke:#00983A;stroke-linecap:round;stroke-linejoin:round;}
+	.st12{fill:#7A8387;}
+	.st13{fill:#576174;}
+	.st14{fill:none;stroke:#576174;stroke-linecap:round;stroke-linejoin:round;}
+	.st15{fill:none;stroke:#7A8387;stroke-linecap:round;stroke-linejoin:round;}
+	.st16{fill:#333A45;}
+</style>
+<g>
+	<g>
+		<polyline class="st0" points="577.2,72.8 282.4,72.8 282.4,48 577.2,48 		"/>
+		<g>
+			<g>
+				<g>
+					<rect x="250.9" y="47.7" class="st1" width="32.4" height="24.8"/>
+					<rect x="153.5" y="47.7" class="st2" width="97.3" height="24.8"/>
+					<polyline class="st3" points="122.6,72.8 5.9,72.8 5.9,48 122.6,48 					"/>
+					<polyline class="st4" points="831.51,72.8 5.5,72.8 5.5,48 831.51,48 					"/>
+					<rect x="122.5" y="47.7" class="st1" width="31" height="24.8"/>
+					<line class="st4" x1="122.5" y1="26.6" x2="122.5" y2="87.8"/>
+					<line class="st4" x1="576.8" y1="26.6" x2="576.8" y2="87.8"/>
+					<path class="st5" d="M831.51,72.8"/>
+					<line class="st6" x1="153.5" y1="48.3" x2="153.5" y2="72"/>
+					<line class="st4" x1="36.5" y1="48.3" x2="36.5" y2="72"/>
+					<line class="st4" x1="67.6" y1="48.3" x2="67.6" y2="72"/>
+					<line class="st6" x1="186" y1="48.3" x2="186" y2="72"/>
+					<line class="st6" x1="218.4" y1="48.3" x2="218.4" y2="72"/>
+					<line class="st7" x1="250.9" y1="73" x2="250.81" y2="47.7"/>
+					<line class="st4" x1="315.9" y1="48.3" x2="315.9" y2="72"/>
+					<line class="st4" x1="348.4" y1="48.3" x2="348.4" y2="72"/>
+					<line class="st4" x1="381.2" y1="48.3" x2="381.2" y2="72"/>
+					<line class="st4" x1="413.8" y1="48.3" x2="413.8" y2="72"/>
+					<line class="st4" x1="446.3" y1="48.3" x2="446.3" y2="72"/>
+					<line class="st4" x1="478.9" y1="48.3" x2="478.9" y2="72"/>
+					<line class="st6" x1="511.51" y1="48.3" x2="511.51" y2="72"/>
+					<line class="st4" x1="511.51" y1="48.3" x2="511.51" y2="72"/>
+					<line class="st6" x1="544.01" y1="48.3" x2="544.01" y2="72"/>
+					<line class="st4" x1="544.1" y1="48.3" x2="544.1" y2="72"/>
+					<line class="st8" x1="283.3" y1="73" x2="122.5" y2="72.8"/>
+					<line class="st8" x1="122.5" y1="48" x2="283.3" y2="48.1"/>
+					<path class="st5" d="M385.5,73"/>
+					<path class="st5" d="M385.5,49.3"/>
+					<line class="st4" x1="283.3" y1="26.6" x2="283.3" y2="87.8"/>
+				</g>
+				<g>
+					<text transform="matrix(1 0 0 1 127.5176 105.8013)" class="st1 st9 st10">buf</text>
+				</g>
+				<g>
+					<g>
+						<line class="st11" x1="122.2" y1="105.6" x2="122.2" y2="94.6"/>
+						<g>
+							<polygon class="st1" points="119.8,94.9 124.6,94.9 122.2,92.5 							"/>
+						</g>
+					</g>
+				</g>
+				<g>
+					<text transform="matrix(1 0 0 1 286.6495 105.8008)" class="st1 st9 st10">len=5</text>
+				</g>
+				<g>
+					<g>
+						<line class="st11" x1="283.3" y1="105.6" x2="283.3" y2="94.6"/>
+						<g>
+							<polygon class="st1" points="280.9,94.9 285.8,94.9 283.3,92.5 							"/>
+						</g>
+					</g>
+				</g>
+				<g>
+					<text transform="matrix(1 0 0 1 581.4624 105.8013)" class="st1 st9 st10">size=16</text>
+				</g>
+				<g>
+					<g>
+						<line class="st11" x1="576.9" y1="105.6" x2="576.9" y2="94.6"/>
+						<g>
+							<polygon class="st1" points="574.51,94.9 579.4,94.9 576.9,92.5 							"/>
+						</g>
+					</g>
+				</g>
+				<g>
+					<path class="st12" d="M687.51,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S687.51,59.9,687.51,60.7z"/>
+					<path class="st12" d="M701.2,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S701.2,59.9,701.2,60.7z"/>
+					<path class="st12" d="M714.9,60.7c0,0.9-0.7,1.6-1.6,1.6c-0.9,0-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
+						C714.2,59.1,714.9,59.9,714.9,60.7z"/>
+					<path class="st12" d="M728.7,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
+						C728.01,59.1,728.7,59.9,728.7,60.7z"/>
+				</g>
+				<g>
+					<path class="st12" d="M82.8,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S82.8,59.9,82.8,60.7z"/>
+					<path class="st12" d="M96.5,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6C95.8,59.1,96.5,59.9,96.5,60.7
+						z"/>
+					<path class="st12" d="M110.2,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S110.2,59.9,110.2,60.7z"/>
+				</g>
+				<g>
+					<g>
+						<text transform="matrix(1 0 0 1 180.6541 26.8123)" class="st13 st9 st10">data</text>
+					</g>
+					<g>
+						<text transform="matrix(1 0 0 1 387.363 26.8123)" class="st12 st9 st10">free space</text>
+					</g>
+					<g>
+						<g>
+							<line class="st14" x1="272.2" y1="33.6" x2="133.5" y2="33.6"/>
+							<g>
+								<polygon class="st13" points="271.9,36.2 273.5,33.6 271.9,31.1 271.8,31.1 271.8,36.2 								"/>
+							</g>
+							<g>
+								<polygon class="st13" points="133.8,36.1 133.8,31.2 131.4,33.6 								"/>
+							</g>
+						</g>
+					</g>
+					<g>
+						<g>
+							<line class="st15" x1="563.7" y1="33.6" x2="295.9" y2="33.6"/>
+							<g>
+								<polygon class="st12" points="563.4,36.1 563.4,31.2 565.8,33.6 								"/>
+							</g>
+							<g>
+								<polygon class="st12" points="296.2,36.1 296.2,31.2 293.7,33.6 								"/>
+							</g>
+						</g>
+					</g>
+					<g>
+						<text transform="matrix(1 0 0 1 615.4679 25.1898)" class="st12 st9 st10">non-allocated space</text>
+					</g>
+					<g>
+						<g>
+							<line class="st15" x1="593.7" y1="33.6" x2="829.7" y2="33.6"/>
+							<g>
+								<polygon class="st12" points="829.4,31.2 829.4,36.1 831.8,33.6 								"/>
+							</g>
+						</g>
+					</g>
+					<g>
+						<g>
+							<line class="st15" x1="678.7" y1="33.6" x2="589.7" y2="33.6"/>
+							<g>
+								<polygon class="st12" points="590.01,36.1 590.01,31.2 587.6,33.6 								"/>
+							</g>
+						</g>
+					</g>
+				</g>
+				<g>
+					<g>
+						<text transform="matrix(1 0 0 1 133.1212 64.9593)" class="st16 st9 st10">h</text>
+					</g>
+				</g>
+				<g>
+					<g>
+						<g>
+							<text transform="matrix(1 0 0 1 165.1564 64.9593)" class="st16 st9 st10">e</text>
+						</g>
+					</g>
+				</g>
+				<g>
+					<g>
+						<g>
+							<text transform="matrix(1 0 0 1 196.8744 64.9593)" class="st16 st9 st10">l</text>
+						</g>
+					</g>
+				</g>
+				<g>
+					<g>
+						<g>
+							<text transform="matrix(1 0 0 1 229.8611 64.9593)" class="st16 st9 st10">l</text>
+						</g>
+					</g>
+				</g>
+				<g>
+					<g>
+						<text transform="matrix(1 0 0 1 262.2135 64.9593)" class="st16 st9 st10">o</text>
+					</g>
+				</g>
+			</g>
+		</g>
+	</g>
+	<g>
+		<text transform="matrix(1 0 0 1 1.811981e-04 105.8011)" class="st1 st9 st10">0</text>
+	</g>
+	<line class="st4" x1="5.5" y1="26.4" x2="5.5" y2="87.6"/>
+</g>
+<g>
+	<g>
+		<polyline class="st0" points="577.2,207.99 186.3,207.99 186.3,183.19 577.2,183.19 		"/>
+		<g>
+			<g>
+				<g>
+					<polyline class="st3" points="122.6,207.99 5.9,207.99 5.9,183.19 122.6,183.19 					"/>
+					<polyline class="st4" points="831.51,207.99 5.5,207.99 5.5,183.19 831.51,183.19 					"/>
+					<polyline class="st1" points="186.3,207.69 122.5,207.69 122.5,182.89 186.3,182.89 					"/>
+					<line class="st4" x1="122.5" y1="161.79" x2="122.5" y2="222.99"/>
+					<line class="st4" x1="186" y1="161.79" x2="186" y2="222.99"/>
+					<line class="st4" x1="576.8" y1="161.79" x2="576.8" y2="222.99"/>
+					<path class="st5" d="M831.51,207.99"/>
+					<line class="st6" x1="153.5" y1="183.49" x2="153.5" y2="207.19"/>
+					<line class="st4" x1="36.5" y1="183.49" x2="36.5" y2="207.19"/>
+					<line class="st4" x1="67.6" y1="183.49" x2="67.6" y2="207.19"/>
+					<line class="st6" x1="186" y1="183.49" x2="186" y2="207.99"/>
+					<line class="st4" x1="218.4" y1="183.49" x2="218.4" y2="207.19"/>
+					<line class="st4" x1="250.9" y1="183.49" x2="250.9" y2="207.19"/>
+					<line class="st4" x1="283.3" y1="183.49" x2="283.3" y2="207.19"/>
+					<line class="st4" x1="315.9" y1="183.49" x2="315.9" y2="207.19"/>
+					<line class="st4" x1="348.4" y1="183.49" x2="348.4" y2="207.19"/>
+					<line class="st4" x1="381.2" y1="183.49" x2="381.2" y2="207.19"/>
+					<line class="st4" x1="413.8" y1="183.49" x2="413.8" y2="207.19"/>
+					<line class="st4" x1="446.3" y1="183.49" x2="446.3" y2="207.19"/>
+					<line class="st4" x1="478.9" y1="183.49" x2="478.9" y2="207.19"/>
+					<line class="st6" x1="511.51" y1="183.49" x2="511.51" y2="207.19"/>
+					<line class="st4" x1="511.51" y1="183.49" x2="511.51" y2="207.19"/>
+					<line class="st6" x1="544.01" y1="183.49" x2="544.01" y2="207.19"/>
+					<line class="st4" x1="544.1" y1="183.49" x2="544.1" y2="207.19"/>
+					<line class="st8" x1="186" y1="208.19" x2="122.5" y2="207.99"/>
+					<line class="st8" x1="122.5" y1="183.19" x2="186" y2="183.29"/>
+					<path class="st5" d="M385.5,208.19"/>
+					<path class="st5" d="M385.5,184.49"/>
+				</g>
+				<g>
+					<text transform="matrix(1 0 0 1 127.5176 240.9952)" class="st1 st9 st10">buf</text>
+				</g>
+				<g>
+					<g>
+						<line class="st11" x1="122.2" y1="240.79" x2="122.2" y2="229.79"/>
+						<g>
+							<polygon class="st1" points="119.8,230.09 124.6,230.09 122.2,227.69 							"/>
+						</g>
+					</g>
+				</g>
+				<g>
+					<text transform="matrix(1 0 0 1 189.2273 240.9947)" class="st1 st9 st10">len=2</text>
+				</g>
+				<g>
+					<g>
+						<line class="st11" x1="185.88" y1="240.79" x2="185.88" y2="229.79"/>
+						<g>
+							<polygon class="st1" points="183.48,230.09 188.38,230.09 185.88,227.69 							"/>
+						</g>
+					</g>
+				</g>
+				<g>
+					<text transform="matrix(1 0 0 1 581.4624 240.9952)" class="st1 st9 st10">size=16</text>
+				</g>
+				<g>
+					<g>
+						<line class="st11" x1="576.9" y1="240.79" x2="576.9" y2="229.79"/>
+						<g>
+							<polygon class="st1" points="574.51,230.09 579.4,230.09 576.9,227.69 							"/>
+						</g>
+					</g>
+				</g>
+				<g>
+					<path class="st12" d="M687.51,195.89c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
+						S687.51,195.09,687.51,195.89z"/>
+					<path class="st12" d="M701.2,195.89c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S701.2,195.09,701.2,195.89z
+						"/>
+					<path class="st12" d="M714.9,195.89c0,0.9-0.7,1.6-1.6,1.6c-0.9,0-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
+						S714.9,195.09,714.9,195.89z"/>
+					<path class="st12" d="M728.7,195.89c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
+						C728.01,194.29,728.7,195.09,728.7,195.89z"/>
+				</g>
+				<g>
+					<path class="st12" d="M82.8,195.89c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S82.8,195.09,82.8,195.89z"/>
+					<path class="st12" d="M96.5,195.89c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
+						C95.8,194.29,96.5,195.09,96.5,195.89z"/>
+					<path class="st12" d="M110.2,195.89c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S110.2,195.09,110.2,195.89z
+						"/>
+				</g>
+				<g>
+					<g>
+						<text transform="matrix(1 0 0 1 133.6541 162.0062)" class="st13 st9 st10">data</text>
+					</g>
+					<g>
+						<text transform="matrix(1 0 0 1 327.363 162.0062)" class="st12 st9 st10">free space</text>
+					</g>
+					<g>
+						<g>
+							<line class="st14" x1="175.2" y1="168.79" x2="133.5" y2="168.79"/>
+							<g>
+								<polygon class="st13" points="174.9,171.39 176.5,168.79 174.9,166.29 174.8,166.29 174.8,171.39 								"/>
+							</g>
+							<g>
+								<polygon class="st13" points="133.8,171.29 133.8,166.39 131.4,168.79 								"/>
+							</g>
+						</g>
+					</g>
+					<g>
+						<g>
+							<line class="st15" x1="563.7" y1="168.79" x2="197.49" y2="168.79"/>
+							<g>
+								<polygon class="st12" points="563.4,171.29 563.4,166.39 565.8,168.79 								"/>
+							</g>
+							<g>
+								<polygon class="st12" points="197.79,171.29 197.79,166.39 195.29,168.79 								"/>
+							</g>
+						</g>
+					</g>
+					<g>
+						<text transform="matrix(1 0 0 1 615.4679 160.3837)" class="st12 st9 st10">non-allocated space</text>
+					</g>
+					<g>
+						<g>
+							<line class="st15" x1="593.7" y1="168.79" x2="829.7" y2="168.79"/>
+							<g>
+								<polygon class="st12" points="829.4,166.39 829.4,171.29 831.8,168.79 								"/>
+							</g>
+						</g>
+					</g>
+					<g>
+						<g>
+							<line class="st15" x1="678.7" y1="168.79" x2="589.7" y2="168.79"/>
+							<g>
+								<polygon class="st12" points="590.01,171.29 590.01,166.39 587.6,168.79 								"/>
+							</g>
+						</g>
+					</g>
+				</g>
+				<g>
+					<g>
+						<text transform="matrix(1 0 0 1 133.1212 200.1532)" class="st16 st9 st10">h</text>
+					</g>
+				</g>
+				<g>
+					<g>
+						<text transform="matrix(1 0 0 1 165.1565 200.1532)" class="st16 st9 st10">o</text>
+					</g>
+				</g>
+			</g>
+		</g>
+	</g>
+	<g>
+		<text transform="matrix(1 0 0 1 1.811981e-04 240.995)" class="st1 st9 st10">0</text>
+	</g>
+	<line class="st4" x1="5.5" y1="161.59" x2="5.5" y2="222.79"/>
+</g>
+</svg>

docs/images/packed.svg

@@ -0,0 +1,384 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 25.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 858.5 424.3" style="enable-background:new 0 0 858.5 424.3;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:#9E9B83;}
+	.st1{fill:#9E8900;}
+	.st2{font-family:Arial;font-weight:bold;}
+	.st3{font-size:11px;}
+	.st4{display:none;fill:#576174;}
+	.st5{fill:#1F5F75;}
+	.st6{clip-path:url(#SVGID_3_);fill:#FFFFFF;fill-opacity:0.1;}
+	.st7{fill:#277691;}
+	.st8{fill:#FFFFFF;}
+	.st9{font-family:Arial;font-weight:bold;}
+	.st10{fill:#004219;}
+	.st11{clip-path:url(#SVGID_6_);fill:#FFFFFF;fill-opacity:0.1;}
+	.st12{fill:#005721;}
+	.st13{fill:url(#SVGID_7_);}
+	.st14{clip-path:url(#XMLID_13_);fill:#FFFFFF;fill-opacity:0.1;}
+	.st15{fill:#752E06;}
+	.st16{fill:#963B08;}
+	.st17{fill:#59008F;}
+	.st18{clip-path:url(#XMLID_15_);fill:#FFFFFF;fill-opacity:0.1;}
+	.st19{fill:#7300B8;}
+	.st20{fill:#FFDE00;}
+	.st21{fill:#576174;}
+	.st22{font-size:13px;}
+	.st23{fill:#8A8C8E;}
+	.st24{font-size:12px;}
+	.st25{opacity:0.69;}
+	.st26{fill:#B3B1B3;}
+	.st27{clip-path:url(#XMLID_17_);fill:#FFFFFF;fill-opacity:0.1;}
+	.st28{fill:#919091;}
+	.st29{fill:#BFBEBF;}
+	.st30{fill:#454445;}
+	.st31{font-size:9px;}
+	.st32{clip-path:url(#XMLID_19_);fill:#FFFFFF;fill-opacity:0.1;}
+	.st33{fill:#8695B3;}
+	.st34{fill:url(#SVGID_8_);}
+	.st35{font-size:18px;}
+	.st36{clip-path:url(#XMLID_20_);fill:#610041;fill-opacity:0.1;}
+	.st37{fill:#610041;}
+	.st38{clip-path:url(#XMLID_22_);fill:url(#SVGID_9_);fill-opacity:0.1;}
+	.st39{fill:none;stroke:#86005B;stroke-width:0.5;stroke-linecap:round;stroke-miterlimit:10;}
+	.st40{fill:none;stroke:#86005B;stroke-width:0.75;stroke-linecap:round;stroke-miterlimit:10;}
+	.st41{fill:url(#SVGID_10_);}
+	.st42{fill:url(#SVGID_11_);}
+	.st43{fill:#610042;}
+	.st44{fill:url(#SVGID_12_);}
+</style>
+<g>
+	<g>
+		<path class="st0" d="M457.9,111.2l0.1,87.3c0,1.4-1.1,2.6-2.5,2.6h-76.3c-4.4-0.2-7.3-3.9-7.3-5.3l4.7-101.8
+			c0-1.4,0.8-7.4,2.2-7.4l54-0.1L457.9,111.2z"/>
+	</g>
+	<g>
+		<text transform="matrix(1 0 0 1 383.2604 149.9447)" class="st1 st2 st3">packed_fs.c</text>
+	</g>
+</g>
+<rect x="84" y="25" class="st4" width="727.7" height="429.8"/>
+<g>
+	<g>
+		<path class="st5" d="M207.5,104.6v87.4c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6V84.5c0-1.4,1.1-2.5,2.5-2.5h58
+			L207.5,104.6z"/>
+		<g>
+			<defs>
+				<path id="SVGID_1_" d="M205.5,102.6v87.4c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6v-57.5V82.5c0-1.4,1.1-2.5,2.5-2.5
+					h58L205.5,102.6z"/>
+			</defs>
+			<linearGradient id="SVGID_2_" gradientUnits="userSpaceOnUse" x1="122.1091" y1="136.2824" x2="205.5191" y2="136.2824">
+				<stop  offset="0" style="stop-color:#45CFFF"/>
+				<stop  offset="1" style="stop-color:#85DDFA"/>
+			</linearGradient>
+			<use xlink:href="#SVGID_1_"  style="overflow:visible;fill:url(#SVGID_2_);"/>
+			<clipPath id="SVGID_3_">
+				<use xlink:href="#SVGID_1_"  style="overflow:visible;"/>
+			</clipPath>
+			<path class="st6" d="M121.4,101.4c9.4,0.7,36.6,1.5,53.2,14.7c25,20,31.2,47.1,31.2,47.1l0.4,35.3l-84.8,0.2V101.4z"/>
+		</g>
+		<path class="st5" d="M205.9,104.4l-20.6,0c-1.4,0-2.6-1.2-2.6-2.6l0-21.8l22.9,22.7L205.9,104.4z"/>
+		<path class="st7" d="M205.7,102.8h-20.5c-1.4,0-2.5-1.1-2.5-2.5V79.9l0,0l22.9,22.7L205.7,102.8z"/>
+		<g>
+			<text transform="matrix(1 0 0 1 129.0689 92.8531)" class="st8 st9 st3">filex.y</text>
+		</g>
+	</g>
+	<g>
+		<path class="st10" d="M191.4,121.6V209c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6V101.4c0-1.4,1.1-2.5,2.5-2.5h58
+			L191.4,121.6z"/>
+		<g>
+			<defs>
+				<path id="SVGID_4_" d="M189.4,119.6V207c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6v-57.5V99.4c0-1.4,1.1-2.5,2.5-2.5
+					h58L189.4,119.6z"/>
+			</defs>
+			<linearGradient id="SVGID_5_" gradientUnits="userSpaceOnUse" x1="106.0386" y1="153.2384" x2="189.4486" y2="153.2384">
+				<stop  offset="0" style="stop-color:#00983A"/>
+				<stop  offset="1" style="stop-color:#3A985D"/>
+			</linearGradient>
+			<use xlink:href="#SVGID_4_"  style="overflow:visible;fill:url(#SVGID_5_);"/>
+			<clipPath id="SVGID_6_">
+				<use xlink:href="#SVGID_4_"  style="overflow:visible;"/>
+			</clipPath>
+			<path class="st11" d="M105.3,118.3c9.4,0.7,36.6,1.5,53.2,14.7c25,20,31.2,47.1,31.2,47.1l0.4,35.3l-84.8,0.2V118.3z"/>
+		</g>
+		<path class="st10" d="M189.8,121.3l-20.6,0c-1.4,0-2.6-1.2-2.6-2.6l0-21.8l22.9,22.7L189.8,121.3z"/>
+		<path class="st12" d="M189.6,119.7h-20.5c-1.4,0-2.5-1.1-2.5-2.5V96.9l0,0l22.9,22.7L189.6,119.7z"/>
+		<g>
+			<text transform="matrix(1 0 0 1 113.9984 109.809)" class="st8 st9 st3">main.js</text>
+		</g>
+	</g>
+	<g>
+		<linearGradient id="SVGID_7_" gradientUnits="userSpaceOnUse" x1="93.2369" y1="173.2516" x2="176.6469" y2="173.2516">
+			<stop  offset="0" style="stop-color:#EA5B0C"/>
+			<stop  offset="1" style="stop-color:#EA671E"/>
+		</linearGradient>
+		<path class="st13" d="M176.6,139.6V227c0,1.4-1.1,2.6-2.5,2.6H95.8c-1.4,0-2.5-1.1-2.5-2.6V119.5c0-1.4,1.1-2.5,2.5-2.5h58
+			L176.6,139.6z"/>
+		<g>
+			<defs>
+				<path id="XMLID_2_" d="M174.6,137.6V225c0,1.4-1.1,2.6-2.5,2.6H93.8c-1.4,0-2.5-1.1-2.5-2.6v-57.5v-50.1c0-1.4,1.1-2.5,2.5-2.5
+					h58L174.6,137.6z"/>
+			</defs>
+			<linearGradient id="XMLID_12_" gradientUnits="userSpaceOnUse" x1="91.2369" y1="171.2516" x2="174.6469" y2="171.2516">
+				<stop  offset="0" style="stop-color:#EA5B0C"/>
+				<stop  offset="1" style="stop-color:#EA7B3D"/>
+			</linearGradient>
+			<use xlink:href="#XMLID_2_"  style="overflow:visible;fill:url(#XMLID_12_);"/>
+			<clipPath id="XMLID_13_">
+				<use xlink:href="#XMLID_2_"  style="overflow:visible;"/>
+			</clipPath>
+			<path class="st14" d="M90.5,136.3c9.4,0.7,36.6,1.5,53.2,14.7c25,20,31.2,47.1,31.2,47.1l0.4,35.3l-84.8,0.2V136.3z"/>
+		</g>
+		<path class="st15" d="M175,139.3l-20.6,0c-1.4,0-2.6-1.2-2.6-2.6l0-21.8l22.9,22.7L175,139.3z"/>
+		<path class="st16" d="M174.8,137.7h-20.5c-1.4,0-2.5-1.1-2.5-2.5v-20.3l0,0l22.9,22.7L174.8,137.7z"/>
+		<g>
+			<text transform="matrix(1 0 0 1 97.1967 127.8222)" class="st8 st9 st3">style.css</text>
+		</g>
+	</g>
+	<g>
+		<path class="st17" d="M164.6,157.7v87.4c0,1.4-1.1,2.6-2.5,2.6H83.8c-1.4,0-2.5-1.1-2.5-2.6V137.5c0-1.4,1.1-2.5,2.5-2.5h58
+			L164.6,157.7z"/>
+		<g>
+			<defs>
+				<path id="XMLID_1_" d="M162.6,155.7v87.4c0,1.4-1.1,2.6-2.5,2.6H81.8c-1.4,0-2.5-1.1-2.5-2.6v-57.5v-50.1c0-1.4,1.1-2.5,2.5-2.5
+					h58L162.6,155.7z"/>
+			</defs>
+			<linearGradient id="XMLID_14_" gradientUnits="userSpaceOnUse" x1="79.2009" y1="189.3131" x2="162.6108" y2="189.3131">
+				<stop  offset="0" style="stop-color:#A000FF"/>
+				<stop  offset="1" style="stop-color:#C96EFF"/>
+			</linearGradient>
+			<use xlink:href="#XMLID_1_"  style="overflow:visible;fill:url(#XMLID_14_);"/>
+			<clipPath id="XMLID_15_">
+				<use xlink:href="#XMLID_1_"  style="overflow:visible;"/>
+			</clipPath>
+			<path class="st18" d="M78.5,154.4c9.4,0.7,36.6,1.5,53.2,14.7c25,20,31.2,47.1,31.2,47.1l0.4,35.3l-84.8,0.2V154.4z"/>
+		</g>
+		<path class="st17" d="M163,157.4l-20.6,0c-1.4,0-2.6-1.2-2.6-2.6l0-21.8l22.9,22.7L163,157.4z"/>
+		<path class="st19" d="M162.8,155.8h-20.5c-1.4,0-2.5-1.1-2.5-2.5V133l0,0l22.9,22.7L162.8,155.8z"/>
+		<g>
+			<text transform="matrix(1 0 0 1 83.1607 145.8838)" class="st8 st9 st3">index.html</text>
+		</g>
+	</g>
+</g>
+<g>
+	<g>
+		<path class="st20" d="M455.2,108.2v87.4c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6V88.1c0-1.4,1.1-2.5,2.5-2.5h58
+			L455.2,108.2z"/>
+		<path class="st0" d="M455.3,110.3l-18.4,0c-1.4,0-2.5-1.1-2.5-2.5V87.5l0,0l20.9,20.7L455.3,110.3z"/>
+		<polygon class="st0" points="435.2,109.7 432.9,107.3 436.3,106.9 		"/>
+		<path class="st1" d="M455.4,108.3h-20.5c-1.4,0-2.5-1.1-2.5-2.5V85.5l0,0l22.9,22.7L455.4,108.3z"/>
+	</g>
+	<g>
+		<text transform="matrix(1 0 0 1 379.2604 144.9447)" class="st21 st9 st22">packed_fs.c</text>
+	</g>
+</g>
+<g>
+	<polygon class="st23" points="483.6,195.4 397.3,195.4 394.3,193.4 397.3,162.8 481.5,159.7 483.6,162.8 	"/>
+	<rect x="394.3" y="159.8" class="st21" width="87.3" height="33.7"/>
+	<g>
+		<g>
+			<text transform="matrix(1 0 0 1 400.0845 171.7588)" class="st8 st9 st24">mg_unpack()</text>
+		</g>
+		<g>
+			<text transform="matrix(1 0 0 1 400.0845 186.935)" class="st8 st9 st24">mg_unlist()</text>
+		</g>
+	</g>
+</g>
+<g class="st25">
+	<g>
+		<path class="st26" d="M467.7,256.6V344c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6V236.4c0-1.4,1.1-2.5,2.5-2.5h58
+			L467.7,256.6z"/>
+		<g>
+			<defs>
+				<path id="XMLID_9_" d="M465.7,254.6V342c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6v-57.5v-50.1c0-1.4,1.1-2.5,2.5-2.5
+					h58L465.7,254.6z"/>
+			</defs>
+			<linearGradient id="XMLID_16_" gradientUnits="userSpaceOnUse" x1="382.3115" y1="288.2073" x2="465.7215" y2="288.2073">
+				<stop  offset="0" style="stop-color:#D6D4D6"/>
+				<stop  offset="1" style="stop-color:#FFFDFE"/>
+			</linearGradient>
+			<use xlink:href="#XMLID_9_"  style="overflow:visible;fill:url(#XMLID_16_);"/>
+			<clipPath id="XMLID_17_">
+				<use xlink:href="#XMLID_9_"  style="overflow:visible;"/>
+			</clipPath>
+			<path class="st27" d="M381.6,253.3c9.4,0.7,36.6,1.5,53.2,14.7c25,20,31.2,47.1,31.2,47.1l0.4,35.3l-84.8,0.2V253.3z"/>
+		</g>
+		<path class="st28" d="M466.1,256.3l-20.6,0c-1.4,0-2.6-1.2-2.6-2.6l0-21.8l22.9,22.7L466.1,256.3z"/>
+		<path class="st29" d="M465.9,254.7h-20.5c-1.4,0-2.5-1.1-2.5-2.5v-20.3l0,0l22.9,22.7L465.9,254.7z"/>
+		<text transform="matrix(1 0 0 1 386.2713 244.7779)" class="st30 st9 st31">mongoose.c</text>
+	</g>
+	<g>
+		<path class="st26" d="M455.7,276.6v87.4c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6V256.5c0-1.4,1.1-2.5,2.5-2.5h58
+			L455.7,276.6z"/>
+		<g>
+			<defs>
+				<path id="XMLID_8_" d="M453.7,274.6v87.4c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6v-57.5v-50.1
+					c0-1.4,1.1-2.5,2.5-2.5h58L453.7,274.6z"/>
+			</defs>
+			<linearGradient id="XMLID_18_" gradientUnits="userSpaceOnUse" x1="370.2755" y1="308.2689" x2="453.6855" y2="308.2689">
+				<stop  offset="0" style="stop-color:#D6D4D6"/>
+				<stop  offset="1" style="stop-color:#FFFDFE"/>
+			</linearGradient>
+			<use xlink:href="#XMLID_8_"  style="overflow:visible;fill:url(#XMLID_18_);"/>
+			<clipPath id="XMLID_19_">
+				<use xlink:href="#XMLID_8_"  style="overflow:visible;"/>
+			</clipPath>
+			<path class="st32" d="M369.6,273.3c9.4,0.7,36.6,1.5,53.2,14.7c25,20,31.2,47.1,31.2,47.1l0.4,35.3l-84.8,0.2V273.3z"/>
+			<use xlink:href="#XMLID_8_"  style="overflow:visible;fill:none;stroke:#FFFDFE;stroke-width:0.25;stroke-miterlimit:10;"/>
+		</g>
+		<path class="st28" d="M454,276.4l-20.6,0c-1.4,0-2.6-1.2-2.6-2.6l0-21.8l22.9,22.7L454,276.4z"/>
+		<path class="st29" d="M453.8,274.8h-20.5c-1.4,0-2.5-1.1-2.5-2.5v-20.3l0,0l22.9,22.7L453.8,274.8z"/>
+		<text transform="matrix(1 0 0 1 379.2353 264.8395)" class="st30 st9 st31">app.c</text>
+	</g>
+</g>
+<g>
+	<polygon class="st33" points="342.3,123.3 351.1,141.7 342.3,160.7 234.8,160.9 234.8,122.6 	"/>
+	<path class="st23" d="M347.4,145.4"/>
+	<linearGradient id="SVGID_8_" gradientUnits="userSpaceOnUse" x1="233.6667" y1="139.4088" x2="350.0318" y2="139.4088">
+		<stop  offset="0" style="stop-color:#C1D5FF"/>
+		<stop  offset="0.1995" style="stop-color:#BACDF6"/>
+		<stop  offset="0.6001" style="stop-color:#B0C3EA"/>
+		<stop  offset="1" style="stop-color:#ADC0E6"/>
+	</linearGradient>
+	<polygon class="st34" points="341.2,120.9 350,139.3 341.2,158.3 233.7,158.5 233.7,120.3 	"/>
+	<text transform="matrix(1 0 0 1 262.9869 146.2633)" class="st8 st9 st35">PACK</text>
+	<polygon class="st33" points="234.8,160.9 233.7,158.5 238,158.7 	"/>
+</g>
+<g>
+	<path class="st23" d="M634.9,144.6L634.9,144.6z"/>
+</g>
+<g>
+	<polygon class="st33" points="619.6,139.3 619.6,139.3 618.7,137.4 618.7,137.4 	"/>
+	<path class="st23" d="M623.1,168.2L623.1,168.2z"/>
+</g>
+<g>
+	<polygon class="st33" points="619.6,288.1 618.7,290 618.7,290 619.6,288.1 	"/>
+	<path class="st23" d="M623.1,259.2L623.1,259.2z"/>
+</g>
+<g>
+	<path class="st23" d="M617,282L617,282z"/>
+</g>
+<g>
+	<g>
+		<g>
+			<defs>
+				<path id="XMLID_10_" d="M722.7,276.5h-71.2c-11.6,0-21.1-9.4-21.1-21.1v-71.2c0-11.6,9.4-21.1,21.1-21.1h71.2
+					c11.6,0,21.1,9.4,21.1,21.1v71.2C743.8,267,734.4,276.5,722.7,276.5z"/>
+			</defs>
+			<use xlink:href="#XMLID_10_"  style="overflow:visible;fill:#610041;"/>
+			<clipPath id="XMLID_20_">
+				<use xlink:href="#XMLID_10_"  style="overflow:visible;"/>
+			</clipPath>
+			<path class="st36" d="M754.3,172.5c-2.7,8-17.3,30.9-65.8,30.8c-24.5,0-48.4-7.4-65.7-24.7l-12.1-12l69.3-64.6L754.3,172.5z"/>
+		</g>
+		<polygon class="st37" points="637.6,271.2 632.5,266.1 640.3,269.4 		"/>
+		<polygon class="st37" points="738.3,169.9 734.6,166.2 736.4,171 		"/>
+		<g>
+			<defs>
+				<path id="XMLID_5_" d="M719.7,273.5h-71.2c-11.6,0-21.1-9.4-21.1-21.1v-71.2c0-11.6,9.4-21.1,21.1-21.1h71.2
+					c11.6,0,21.1,9.4,21.1,21.1v71.2C740.8,264,731.4,273.5,719.7,273.5z"/>
+			</defs>
+			<radialGradient id="XMLID_21_" cx="684.119" cy="216.7761" r="56.6929" gradientUnits="userSpaceOnUse">
+				<stop  offset="0" style="stop-color:#8B005D;stop-opacity:0.7"/>
+				<stop  offset="1" style="stop-color:#8B005D"/>
+			</radialGradient>
+			<use xlink:href="#XMLID_5_"  style="overflow:visible;fill:url(#XMLID_21_);"/>
+			<clipPath id="XMLID_22_">
+				<use xlink:href="#XMLID_5_"  style="overflow:visible;"/>
+			</clipPath>
+			<radialGradient id="SVGID_9_" cx="678.486" cy="148.5836" r="90.2195" gradientUnits="userSpaceOnUse">
+				<stop  offset="0" style="stop-color:#8B005D"/>
+				<stop  offset="1" style="stop-color:#FFFFFF"/>
+			</radialGradient>
+			<path class="st38" d="M750.3,168.5c-2.7,8-17.3,30.9-65.8,30.8c-24.5,0-48.4-7.4-65.7-24.7l-12.1-12L676,97.9L750.3,168.5z"/>
+		</g>
+		<g>
+			<g>
+				<g>
+					<g>
+						<text transform="matrix(1 0 0 1 646.3768 216.49)" class="st8 st9 st35">APP.EXE</text>
+					</g>
+				</g>
+			</g>
+		</g>
+	</g>
+	<g>
+		<g>
+			<g>
+				<path class="st8" d="M732,240.1c-0.3-1.4-0.8-2.7-1.4-3.9l1.7-2.3c-0.3-0.5-0.6-0.9-1-1.4c-0.3-0.5-0.7-0.9-1.1-1.3l-2.7,1
+					c-1-1-2.2-1.8-3.4-2.4l0-2.9c-1-0.4-2.1-0.8-3.2-1l-1.5,2.4c-1.4-0.2-2.8-0.2-4.1,0l-1.7-2.4c-1.1,0.2-2.1,0.6-3.1,1.1l0.2,2.9
+					c-0.6,0.3-1.2,0.7-1.7,1.1c-0.6,0.4-1.1,0.9-1.5,1.4l-2.7-0.9l-1.9,2.7l1.8,2.3c-0.6,1.3-1,2.6-1.1,4l-2.7,0.9
+					c-0.1,1.1,0,2.2,0.1,3.3l2.8,0.8c0.3,1.3,0.8,2.7,1.4,3.9l-1.7,2.3c0.3,0.5,0.6,0.9,1,1.4c0.3,0.4,0.7,0.9,1.1,1.3l2.7-1
+					c1,1,2.2,1.8,3.4,2.4l0,2.9c1,0.4,2.1,0.8,3.2,1l1.5-2.4c1.4,0.2,2.8,0.2,4.1,0l1.7,2.4c1.1-0.3,2.1-0.6,3.1-1.1l-0.2-2.9
+					c0.6-0.3,1.2-0.7,1.7-1.1c0.6-0.4,1.1-0.9,1.5-1.4l2.8,0.9c0.7-0.8,1.3-1.8,1.9-2.7L731,249c0.6-1.3,1-2.6,1.1-4l2.7-0.9
+					c0.1-1.1,0-2.2-0.1-3.3L732,240.1z M724,251c-4.6,3.5-11.1,2.6-14.6-2c-3.5-4.6-2.6-11.1,2-14.6s11.1-2.6,14.6,2
+					C729.5,241,728.6,247.5,724,251z"/>
+			</g>
+		</g>
+		<g>
+			<g>
+				<path class="st8" d="M700.5,249.3c-0.2-0.8-0.5-1.6-0.8-2.4l1-1.4c-0.2-0.3-0.4-0.6-0.6-0.8c-0.2-0.3-0.4-0.5-0.7-0.8l-1.6,0.6
+					c-0.6-0.6-1.3-1.1-2.1-1.4l0-1.7c-0.6-0.3-1.3-0.5-1.9-0.6l-0.9,1.4c-0.8-0.1-1.7-0.1-2.5,0l-1-1.4c-0.6,0.1-1.3,0.4-1.9,0.6
+					l0.1,1.7c-0.4,0.2-0.7,0.4-1,0.7c-0.3,0.3-0.6,0.5-0.9,0.8l-1.6-0.6l-1.1,1.6l1.1,1.4c-0.3,0.8-0.6,1.6-0.7,2.4l-1.6,0.5
+					c0,0.7,0,1.3,0.1,2l1.7,0.5c0.2,0.8,0.4,1.6,0.9,2.4l-1,1.4c0.2,0.3,0.4,0.6,0.6,0.8c0.2,0.3,0.4,0.5,0.7,0.8l1.6-0.6
+					c0.6,0.6,1.3,1.1,2.1,1.4l0,1.7c0.6,0.3,1.3,0.5,1.9,0.6l0.9-1.4c0.8,0.1,1.7,0.1,2.5,0l1,1.4c0.6-0.2,1.3-0.4,1.9-0.6l-0.1-1.7
+					c0.4-0.2,0.7-0.4,1-0.7c0.3-0.3,0.6-0.5,0.9-0.8l1.6,0.6c0.4-0.5,0.8-1.1,1.1-1.6l-1.1-1.4c0.3-0.8,0.6-1.6,0.7-2.4l1.6-0.5
+					c0-0.7,0-1.3-0.1-2L700.5,249.3z M694.5,254.2c-1.8,1.4-4.5,1-5.9-0.8c-1.4-1.8-1-4.5,0.8-5.9c1.8-1.4,4.5-1,5.9,0.8
+					C696.8,250.2,696.4,252.8,694.5,254.2z"/>
+			</g>
+		</g>
+		<path class="st39" d="M708.9,234.5"/>
+		<path class="st39" d="M706.7,237.9"/>
+		<path class="st40" d="M705.7,242.7c0-1.7,0.4-3.4,1-4.9"/>
+		<path class="st40" d="M708.9,234.5c2.2-2.4,5.3-3.8,8.8-3.8"/>
+		<path class="st40" d="M687.4,247.3c1.1-1.4,2.7-2.2,4.6-2.2"/>
+		<path class="st39" d="M686.4,249.5"/>
+		<path class="st40" d="M686.2,250.9c0-0.5,0.1-1,0.2-1.4"/>
+		<path class="st39" d="M686.7,253.2"/>
+	</g>
+</g>
+<g>
+	<path class="st33" d="M611.7,174.2l-23,3.3l-13.1-9.6c-6.3-4.6-13.9-7.1-21.7-7l-55.5,0.1l-1.1-2.4h1.1l64.2-0.2h0.1l3.9,0h0.1
+		l3.2,2.4l19.2,14l0.2,0.2l23.4-3.3L611.7,174.2z"/>
+	<path class="st23" d="M595.9,145.5L595.9,145.5z"/>
+	<linearGradient id="SVGID_10_" gradientUnits="userSpaceOnUse" x1="497.2089" y1="147.636" x2="612.739" y2="147.636">
+		<stop  offset="0" style="stop-color:#C1D5FF"/>
+		<stop  offset="0.1995" style="stop-color:#BACDF6"/>
+		<stop  offset="0.6001" style="stop-color:#B0C3EA"/>
+		<stop  offset="1" style="stop-color:#ADC0E6"/>
+	</linearGradient>
+	<path class="st41" d="M612.7,171.7l-3,0.4l-20.3,2.8l-0.2-0.1l-13.6-9.9l0,0c-3.7-2.7-8.7-4.4-12.9-5.4c-2.9-0.7-6-1-9-1l-35.5,0.1
+		l-19.8,0.1h-1.1v-38.3l13.5,0.2l4,0l42.6,0.2l7.9,0c7,0,14,1.6,20.2,4.9c0,0,0,0,0,0c0.8,0.5,1.6,0.9,2.4,1.5l7.5,5.6l0.1,0.1l0,0
+		l15.4,11.3v0l0.1,3.2L612.7,171.7z"/>
+	<linearGradient id="SVGID_11_" gradientUnits="userSpaceOnUse" x1="597.6228" y1="138.4046" x2="598.5728" y2="138.4046">
+		<stop  offset="0" style="stop-color:#C1D5FF"/>
+		<stop  offset="0.1995" style="stop-color:#BACDF6"/>
+		<stop  offset="0.6001" style="stop-color:#B0C3EA"/>
+		<stop  offset="1" style="stop-color:#ADC0E6"/>
+	</linearGradient>
+	<polygon class="st42" points="598.6,139.3 598.6,139.4 597.6,137.4 597.7,137.5 	"/>
+	<text transform="matrix(1 0 0 1 513.7678 146.3103)" class="st8 st9 st35">BUILD</text>
+</g>
+<g>
+	<path class="st33" d="M612.7,258.8l-0.1,2.2l-1.8-0.2l-20.3-2.8l-0.2,0.1l-13.6,9.9l0-0.1c-3.7,2.7-8.7,4.4-12.9,5.4
+		c-2.9,0.7-6,1-9,1l-35.5-0.1l-19.8-0.1h-1.1v35.4l-1.1,0.4l1.1,2.4l13.5-0.2l4,0l42.6-0.2l7.9-0.1c7,0,14-1.6,20.2-4.9c0,0,0,0,0,0
+		c0.8-0.5,1.6-0.9,2.4-1.5l7.5-5.6l0.1-0.1l0,0l15.4-11.3l1-0.9l1.9-26.7L612.7,258.8z"/>
+	<path class="st43" d="M593.5,272.5"/>
+	<g>
+		<path class="st23" d="M598.5,285L598.5,285z"/>
+		
+			<linearGradient id="SVGID_12_" gradientUnits="userSpaceOnUse" x1="497.2089" y1="451.0054" x2="612.739" y2="451.0054" gradientTransform="matrix(1 0 0 -1 0 733.8616)">
+			<stop  offset="0" style="stop-color:#C1D5FF"/>
+			<stop  offset="0.1995" style="stop-color:#BACDF6"/>
+			<stop  offset="0.6001" style="stop-color:#B0C3EA"/>
+			<stop  offset="1" style="stop-color:#ADC0E6"/>
+		</linearGradient>
+		<path class="st44" d="M612.7,258.8l-3-0.4l-20.3-2.8l-0.2,0.1l-13.6,9.9l0,0c-3.7,2.7-8.7,4.4-12.9,5.4c-2.9,0.7-6,1-9,1
+			l-35.5-0.1l-19.8-0.1h-1.1v38.3l13.5-0.2l4,0l42.6-0.2l7.9,0c7,0,14-1.6,20.2-4.9c0,0,0,0,0,0c0.8-0.5,1.6-0.9,2.4-1.5l7.5-5.6
+			l0.1-0.1l0,0l15.4-11.3v0l0.1-3.2L612.7,258.8z"/>
+		<text transform="matrix(1 0 0 1 513.7682 298.0848)" class="st8 st9 st35">BUILD</text>
+	</g>
+</g>
+<path class="st33" d="M619.9,149.1"/>
+</svg>

drivers/README.md

@@ -1,2 +0,0 @@
-# This is a collection of low-level drivers for the experimental
-# built-in TCP/IP stack

drivers/mip_driver_stm32.h

@@ -1,12 +0,0 @@
-// Copyright (c) 2022 Cesanta Software Limited
-// All rights reserved
-
-#pragma once
-
-#include <stdbool.h>
-#include <stddef.h>
-
-void mip_driver_stm32_init(void *userdata);
-bool mip_driver_stm32_status(void *);
-void mip_driver_stm32_setrx(void (*rx)(void *, size_t, void *), void *);
-size_t mip_driver_stm32_tx(const void *buf, size_t len, void *);

examples/captive-dns-server/main.c

@@ -48,7 +48,7 @@ static void fn(struct mg_connection *c, int ev, void *ev_data, void *fn_data) {
 int main(void) {
   struct mg_mgr mgr;
 
-  mg_log_set("3");                          // Set log level
+  mg_log_set(MG_LL_DEBUG);                  // Set log level
   mg_mgr_init(&mgr);                        // Initialise event manager
   mg_listen(&mgr, s_listen_url, fn, NULL);  // Start DNS server
   for (;;) mg_mgr_poll(&mgr, 1000);         // Event loop

examples/device-dashboard/Makefile

@@ -1,12 +1,20 @@
 PROG ?= example
-SOURCES ?= ../../mongoose.c main.c web.c packed_fs.c
+SOURCES ?= ../../mongoose.c main.c net.c packed_fs.c
-CFLAGS ?= -I../.. -DMG_ENABLE_PACKED_FS=1 $(EXTRA)
+CFLAGS ?= -I../.. -DMG_ENABLE_PACKED_FS=1 -DMG_ENABLE_LINES=1 $(EXTRA)
 FILES_TO_EMBED ?= $(wildcard web_root/*)
 ROOT ?= $(realpath $(CURDIR)/../../..)
 DOCKER ?= docker run --rm -e Tmp=. -e WINEDEBUG=-all -v $(ROOT):$(ROOT) -w $(CURDIR)
 VC98 ?= $(DOCKER) mdashnet/vc98 wine
 MINGW ?= $(DOCKER) mdashnet/mingw
 
+ifeq "$(SSL)" "MBEDTLS"
+CFLAGS  += -DMG_ENABLE_MBEDTLS=1 -I$(MBEDTLS)/include -L$(MBEDTLS)/lib -lmbedtls -lmbedcrypto -lmbedx509
+endif
+
+ifeq "$(SSL)" "OPENSSL"
+CFLAGS  += -DMG_ENABLE_OPENSSL=1 -I$(OPENSSL)/include -L$(OPENSSL)/lib -lssl -lcrypto
+endif
+
 all: $(PROG)
 	$(RUN) ./$(PROG)
 

examples/device-dashboard/README.md

@@ -8,9 +8,11 @@ following features:
 - Multiple logins with different permissions (admin and user)
 - Web UI is fully embedded into the server/firmware binary, and does not
   need a filesystem to serve it. UI is resilient to FS problems
-- View and change server settings
+- Administrators can change server settings
 - All changes are propagates to all connected clients
-- Live interactive chat that demonstrates bi-directional data exchange
+- A device is connected to the external MQTT server
+- Logged in clients can send/receive messages to a device which get
+  forwarded to MQTT
 
 # Screenshots
 
@@ -20,6 +22,6 @@ This is a login screen that prompts for user/password
 
 # Main dashboard
 
-A main dashboard page shows device settings form, and live chat
+A main dashboard page shows and interactive MQTT console
 
 ![](screenshots/dashboard.png)

examples/device-dashboard/ca.pem

@@ -0,0 +1 @@
+../../test/data/ca.pem

examples/device-dashboard/main.c

@@ -2,14 +2,17 @@
 // All rights reserved
 
 #include "mongoose.h"
+const char *s_listening_url = "http://0.0.0.0:8000";
 
 void device_dashboard_fn(struct mg_connection *, int, void *, void *);
 
 int main(void) {
   struct mg_mgr mgr;
+  mg_log_set(MG_LL_DEBUG);  // Set debug log level
   mg_mgr_init(&mgr);
-  mg_http_listen(&mgr, "http://0.0.0.0:8000", device_dashboard_fn, &mgr);
+  mg_http_listen(&mgr, s_listening_url, device_dashboard_fn, &mgr);
-  for (;;) mg_mgr_poll(&mgr, 1000);
+  MG_INFO(("Listening on %s", s_listening_url));
+  while (mgr.conns != NULL) mg_mgr_poll(&mgr, 500);
   mg_mgr_free(&mgr);
   return 0;
 }

examples/device-dashboard/net.c

@@ -0,0 +1,217 @@
+// Copyright (c) 2020-2022 Cesanta Software Limited
+// All rights reserved
+
+#include "mongoose.h"
+
+#define MQTT_SERVER "mqtt://broker.hivemq.com:1883"
+#define MQTT_PUBLISH_TOPIC "mg/my_device"
+#define MQTT_SUBSCRIBE_TOPIC "mg/#"
+
+static time_t s_boot_timestamp = 0;               // Updated by SNTP
+static struct mg_connection *s_sntp_conn = NULL;  // SNTP connection
+
+// Define system time()
+time_t time(time_t *tp) {
+  time_t t = s_boot_timestamp + (time_t) (mg_millis() / 1000);
+  if (tp != NULL) *tp = t;
+  return t;
+}
+
+// Authenticated user.
+// A user can be authenticated by:
+//   - a name:pass pair
+//   - a token
+// When a user is shown a login screen, she enters a user:pass. If successful,
+// a server returns user info which includes token. From that point on,
+// client can use token for authentication. Tokens could be refreshed/changed
+// on a server side, forcing clients to re-login.
+struct user {
+  const char *name, *pass, *token;
+};
+
+// This is a configuration structure we're going to show on a dashboard
+static struct config {
+  char *url, *pub, *sub;  // MQTT settings
+} s_config;
+
+static struct mg_connection *s_mqtt = NULL;  // MQTT connection
+static bool s_connected = false;             // MQTT connection established
+
+// Try to update a single configuration value
+static void update_config(struct mg_str *body, const char *name, char **value) {
+  char buf[256];
+  if (mg_http_get_var(body, name, buf, sizeof(buf)) > 0) {
+    free(*value);
+    *value = strdup(buf);
+  }
+}
+
+// Parse HTTP requests, return authenticated user or NULL
+static struct user *getuser(struct mg_http_message *hm) {
+  // In production, make passwords strong and tokens randomly generated
+  // In this example, user list is kept in RAM. In production, it can
+  // be backed by file, database, or some other method.
+  static struct user users[] = {
+      {"admin", "pass0", "admin_token"},
+      {"user1", "pass1", "user1_token"},
+      {"user2", "pass2", "user2_token"},
+      {NULL, NULL, NULL},
+  };
+  char user[256], pass[256];
+  struct user *u;
+  mg_http_creds(hm, user, sizeof(user), pass, sizeof(pass));
+  if (user[0] != '\0' && pass[0] != '\0') {
+    // Both user and password is set, search by user/password
+    for (u = users; u->name != NULL; u++)
+      if (strcmp(user, u->name) == 0 && strcmp(pass, u->pass) == 0) return u;
+  } else if (user[0] == '\0') {
+    // Only password is set, search by token
+    for (u = users; u->name != NULL; u++)
+      if (strcmp(pass, u->token) == 0) return u;
+  }
+  return NULL;
+}
+
+// Notify all config watchers about the config change
+static void send_notification(struct mg_mgr *mgr, const char *fmt, ...) {
+  struct mg_connection *c;
+  for (c = mgr->conns; c != NULL; c = c->next) {
+    if (c->label[0] == 'W') {
+      va_list ap;
+      va_start(ap, fmt);
+      mg_ws_vprintf(c, WEBSOCKET_OP_TEXT, fmt, &ap);
+      va_end(ap);
+    }
+  }
+}
+
+// Send simulated metrics data to the dashboard, for chart rendering
+static void timer_metrics_fn(void *param) {
+  send_notification(param, "{%Q:%Q,%Q:[%lu, %d]}", "name", "metrics", "data",
+                    (unsigned long) time(NULL),
+                    10 + (int) ((double) rand() * 10 / RAND_MAX));
+}
+
+// MQTT event handler function
+static void mqtt_fn(struct mg_connection *c, int ev, void *ev_data, void *fnd) {
+  if (ev == MG_EV_CONNECT && mg_url_is_ssl(s_config.url)) {
+    struct mg_tls_opts opts = {.ca = "ca.pem",
+                               .srvname = mg_url_host(s_config.url)};
+    mg_tls_init(c, &opts);
+  } else if (ev == MG_EV_MQTT_OPEN) {
+    s_connected = true;
+    c->is_hexdumping = 1;
+    mg_mqtt_sub(s_mqtt, mg_str(s_config.sub), 2);
+    send_notification(c->mgr, "{%Q:%Q,%Q:null}", "name", "config", "data");
+  } else if (ev == MG_EV_MQTT_MSG) {
+    struct mg_mqtt_message *mm = ev_data;
+    send_notification(c->mgr, "{%Q:%Q,%Q:{%Q: %.*Q, %Q: %.*Q, %Q: %d}}", "name",
+                      "message", "data", "topic", (int) mm->topic.len,
+                      mm->topic.ptr, "data", (int) mm->data.len, mm->data.ptr,
+                      "qos", (int) mm->qos);
+  } else if (ev == MG_EV_MQTT_CMD) {
+    struct mg_mqtt_message *mm = (struct mg_mqtt_message *) ev_data;
+    MG_DEBUG(("cmd %d qos %d", mm->cmd, mm->qos));
+  } else if (ev == MG_EV_CLOSE) {
+    s_mqtt = NULL;
+    if (s_connected) {
+      s_connected = false;
+      send_notification(c->mgr, "{%Q:%Q,%Q:null}", "name", "config", "data");
+    }
+  }
+  (void) fnd;
+}
+
+// Keep MQTT connection open - reconnect if closed
+static void timer_mqtt_fn(void *param) {
+  struct mg_mgr *mgr = (struct mg_mgr *) param;
+  if (s_mqtt == NULL) {
+    struct mg_mqtt_opts opts = {0};
+    s_mqtt = mg_mqtt_connect(mgr, s_config.url, &opts, mqtt_fn, NULL);
+  }
+}
+
+// SNTP connection event handler. When we get a response from an SNTP server,
+// adjust s_boot_timestamp. We'll get a valid time from that point on
+static void sfn(struct mg_connection *c, int ev, void *ev_data, void *fn_data) {
+  if (ev == MG_EV_SNTP_TIME) {
+    uint64_t t = *(uint64_t *) ev_data;
+    MG_INFO(("%lu SNTP: %lld ms from epoch", c->id, t));
+    s_boot_timestamp = (time_t) ((t - mg_millis()) / 1000);
+    c->is_closing = 1;
+  } else if (ev == MG_EV_CLOSE) {
+    s_sntp_conn = NULL;
+  }
+  (void) fn_data;
+}
+
+static void timer_sntp_fn(void *param) {  // SNTP timer function. Sync up time
+  struct mg_mgr *mgr = (struct mg_mgr *) param;
+  if (s_sntp_conn == NULL && s_boot_timestamp == 0) {
+    s_sntp_conn = mg_sntp_connect(mgr, NULL, sfn, NULL);
+  }
+}
+
+// HTTP request handler function
+void device_dashboard_fn(struct mg_connection *c, int ev, void *ev_data,
+                         void *fn_data) {
+  if (ev == MG_EV_OPEN && c->is_listening) {
+    mg_timer_add(c->mgr, 1000, MG_TIMER_REPEAT, timer_metrics_fn, c->mgr);
+    mg_timer_add(c->mgr, 1000, MG_TIMER_REPEAT, timer_mqtt_fn, c->mgr);
+    mg_timer_add(c->mgr, 1000, MG_TIMER_REPEAT, timer_sntp_fn, c->mgr);
+    s_config.url = strdup(MQTT_SERVER);
+    s_config.pub = strdup(MQTT_PUBLISH_TOPIC);
+    s_config.sub = strdup(MQTT_SUBSCRIBE_TOPIC);
+  } else if (ev == MG_EV_HTTP_MSG) {
+    struct mg_http_message *hm = (struct mg_http_message *) ev_data;
+    struct user *u = getuser(hm);
+    // MG_INFO(("%p [%.*s] auth %s", c->fd, (int) hm->uri.len, hm->uri.ptr,
+    // u ? u->name : "NULL"));
+    if (mg_http_match_uri(hm, "/api/hi")) {
+      mg_http_reply(c, 200, "", "hi\n");  // Testing endpoint
+    } else if (u == NULL && mg_http_match_uri(hm, "/api/#")) {
+      // All URIs starting with /api/ must be authenticated
+      mg_http_reply(c, 403, "", "Denied\n");
+    } else if (mg_http_match_uri(hm, "/api/config/get")) {
+      mg_http_reply(c, 200, NULL, "{%Q:%Q,%Q:%Q,%Q:%Q,%Q:%s}\n", "url",
+                    s_config.url, "pub", s_config.pub, "sub", s_config.sub,
+                    "connected", s_connected ? "true" : "false");
+    } else if (mg_http_match_uri(hm, "/api/config/set")) {
+      // Admins only
+      if (strcmp(u->name, "admin") == 0) {
+        update_config(&hm->body, "url", &s_config.url);
+        update_config(&hm->body, "pub", &s_config.pub);
+        update_config(&hm->body, "sub", &s_config.sub);
+        if (s_mqtt) s_mqtt->is_closing = 1;  // Ask to disconnect from MQTT
+        send_notification(fn_data, "{%Q:%Q,%Q:null}", "name", "config", "data");
+        mg_http_reply(c, 200, "", "ok\n");
+      } else {
+        mg_http_reply(c, 403, "", "Denied\n");
+      }
+    } else if (mg_http_match_uri(hm, "/api/message/send")) {
+      char buf[256];
+      if (s_connected &&
+          mg_http_get_var(&hm->body, "message", buf, sizeof(buf)) > 0) {
+        mg_mqtt_pub(s_mqtt, mg_str(s_config.pub), mg_str(buf), 1, false);
+      }
+      mg_http_reply(c, 200, "", "ok\n");
+    } else if (mg_http_match_uri(hm, "/api/watch")) {
+      c->label[0] = 'W';  // Mark ourselves as a event listener
+      mg_ws_upgrade(c, hm, NULL);
+    } else if (mg_http_match_uri(hm, "/api/login")) {
+      mg_http_reply(c, 200, NULL, "{%Q:%Q,%Q:%Q}\n", "user", u->name, "token",
+                    u->token);
+    } else {
+      struct mg_http_serve_opts opts = {0};
+#if 1
+      opts.root_dir = "/web_root";
+      opts.fs = &mg_fs_packed;
+#else
+      opts.root_dir = "web_root";
+#endif
+      mg_http_serve_dir(c, ev_data, &opts);
+    }
+    MG_DEBUG(("%.*s %.*s -> %.*s", (int) hm->method.len, hm->method.ptr,
+              (int) hm->uri.len, hm->uri.ptr, (int) 3, &c->send.buf[9]));
+  }
+}

examples/device-dashboard/web.c

@@ -1,130 +0,0 @@
-// Copyright (c) 2020-2022 Cesanta Software Limited
-// All rights reserved
-
-#include "mongoose.h"
-
-// Authenticated user.
-// A user can be authenticated by:
-//   - a name:pass pair
-//   - a token
-// When a user is shown a login screen, she enters a user:pass. If successful,
-// a server returns user info which includes token. From that point on,
-// client can use token for authentication. Tokens could be refreshed/changed
-// on a server side, forcing clients to re-login.
-struct user {
-  const char *name, *pass, *token;
-};
-
-// This is a configuration structure we're going to show on a dashboard
-static struct config {
-  int value1;
-  char *value2;
-} s_config = {123, NULL};
-
-// Update config structure. Return true if changed, false otherwise
-static bool update_config(struct mg_http_message *hm, struct config *cfg) {
-  bool changed = false;
-  char buf[256];
-  if (mg_http_get_var(&hm->body, "value1", buf, sizeof(buf)) > 0) {
-    cfg->value1 = atoi(buf);
-    changed = true;
-  }
-  if (mg_http_get_var(&hm->body, "value2", buf, sizeof(buf)) > 0) {
-    free(cfg->value2);
-    cfg->value2 = malloc(strlen(buf) + 1);
-    strcpy(cfg->value2, buf);
-    changed = true;
-  }
-  return changed;
-}
-
-// Parse HTTP requests, return authenticated user or NULL
-static struct user *getuser(struct mg_http_message *hm) {
-  // In production, make passwords strong and tokens randomly generated
-  // In this example, user list is kept in RAM. In production, it can
-  // be backed by file, database, or some other method.
-  static struct user users[] = {
-      {"admin", "pass0", "admin_token"},
-      {"user1", "pass1", "user1_token"},
-      {"user2", "pass2", "user2_token"},
-      {NULL, NULL, NULL},
-  };
-  char user[256], pass[256];
-  struct user *u;
-  mg_http_creds(hm, user, sizeof(user), pass, sizeof(pass));
-  if (user[0] != '\0' && pass[0] != '\0') {
-    // Both user and password is set, search by user/password
-    for (u = users; u->name != NULL; u++)
-      if (strcmp(user, u->name) == 0 && strcmp(pass, u->pass) == 0) return u;
-  } else if (user[0] == '\0') {
-    // Only password is set, search by token
-    for (u = users; u->name != NULL; u++)
-      if (strcmp(pass, u->token) == 0) return u;
-  }
-  return NULL;
-}
-
-// Notify all config watchers about the config change
-static void send_notification(struct mg_mgr *mgr, const char *name,
-                              const char *data) {
-  struct mg_connection *c;
-  for (c = mgr->conns; c != NULL; c = c->next) {
-    if (c->label[0] == 'W')
-      mg_http_printf_chunk(c, "{\"name\": \"%s\", \"data\": \"%s\"}", name,
-                           data == NULL ? "" : data);
-  }
-}
-
-// HTTP request handler function
-void device_dashboard_fn(struct mg_connection *c, int ev, void *ev_data,
-                         void *fn_data) {
-  if (ev == MG_EV_HTTP_MSG) {
-    struct mg_http_message *hm = (struct mg_http_message *) ev_data;
-    struct user *u = getuser(hm);
-    // MG_INFO(("%p [%.*s] auth %s", c->fd, (int) hm->uri.len, hm->uri.ptr,
-    // u ? u->name : "NULL"));
-    if (mg_http_match_uri(hm, "/api/hi")) {
-      mg_http_reply(c, 200, "", "hi\n");  // Testing endpoint
-    } else if (u == NULL && mg_http_match_uri(hm, "/api/#")) {
-      // All URIs starting with /api/ must be authenticated
-      mg_printf(c, "%s", "HTTP/1.1 403 Denied\r\nContent-Length: 0\r\n\r\n");
-    } else if (mg_http_match_uri(hm, "/api/config/get")) {
-      mg_printf(c, "HTTP/1.1 200 OK\r\nTransfer-Encoding: chunked\r\n\r\n");
-      mg_http_printf_chunk(c, "{\"%s\":%d,\"%s\":\"%s\"}", "value1",
-                           s_config.value1, "value2", s_config.value2);
-      mg_http_printf_chunk(c, "");
-    } else if (mg_http_match_uri(hm, "/api/config/set")) {
-      // Admins only
-      if (strcmp(u->name, "admin") == 0) {
-        if (update_config(hm, &s_config))
-          send_notification(fn_data, "config", NULL);
-        mg_printf(c, "HTTP/1.1 200 OK\r\nContent-Length: 0\r\n\r\n");
-      } else {
-        mg_printf(c, "%s", "HTTP/1.1 403 Denied\r\nContent-Length: 0\r\n\r\n");
-      }
-    } else if (mg_http_match_uri(hm, "/api/message/send")) {
-      char buf[256];
-      if (mg_http_get_var(&hm->body, "message", buf, sizeof(buf)) > 0) {
-        send_notification(fn_data, "message", buf);
-      }
-      mg_printf(c, "HTTP/1.1 200 OK\r\nContent-Length: 0\r\n\r\n");
-    } else if (mg_http_match_uri(hm, "/api/watch")) {
-      c->label[0] = 'W';  // Mark ourselves as a event listener
-      mg_printf(c, "HTTP/1.1 200 OK\r\nTransfer-Encoding: chunked\r\n\r\n");
-    } else if (mg_http_match_uri(hm, "/api/login")) {
-      mg_printf(c, "HTTP/1.1 200 OK\r\nTransfer-Encoding: chunked\r\n\r\n");
-      mg_http_printf_chunk(c, "{\"user\":\"%s\",\"token\":\"%s\"}\n", u->name,
-                           u->token);
-      mg_http_printf_chunk(c, "");
-    } else {
-      struct mg_http_serve_opts opts = {0};
-#if 1
-      opts.root_dir = "/web_root";
-      opts.fs = &mg_fs_packed;
-#else
-      opts.root_dir = "web_root";
-#endif
-      mg_http_serve_dir(c, ev_data, &opts);
-    }
-  }
-}

examples/device-dashboard/web_root/main.js

@@ -1,5 +1,24 @@
 'use strict';
-import {Component, h, html, render, useEffect, useState} from './preact.min.js';
+import {Component, h, html, render, useEffect, useState, useRef} from './preact.min.js';
+
+const MaxMetricsDataPoints = 50;
+
+// This simple publish/subscribe is used to pass notifications that were
+// received from the server, to all child components of the app.
+var PubSub = (function() {
+  var handlers = {}, id = 0;
+  return {
+    subscribe: function(fn) {
+      handlers[id++] = fn;
+    },
+    unsubscribe: function(id) {
+      delete handlers[id];
+    },
+    publish: function(data) {
+      for (var k in handlers) handlers[k](data);
+    }
+  };
+})();
 
 const Nav = props => html`
 <div style="background: #333; padding: 0.5em; color: #fff;">
@@ -17,108 +36,35 @@ const Nav = props => html`
   </div>
 </div>`;
 
-const Footer = props => html`
-<div style="color: silver; margin-top: 2em; padding-top: 0.5em; border-top: 1px solid #ccc; ">
-  Copyright (c) Your Company
-</div>
-`;
-
 
 const Hero = props => html`
+<div class="section">
 <div style="margin-top: 1em; background: #eee; padding: 1em; border-radius: 0.5em; color: #777; ">
   <h1 style="margin: 0.2em 0;">Interactive Device Dashboard</h1>
 
-  This device dashboard is developed with modern and compact Preact framework,
+  <p>
-  in order to fit on a very small devices. This is
+  This device dashboard is developed using the modern and compact Preact framework,
+  in order to fit on very small devices. This is
   a <a href="https://mongoose.ws/tutorials/http-server/">hybrid server</a> which
   provides both static and dynamic content.  Static files, like CSS/JS/HTML
-  or images, are compiled into the server binary. Dynamic content is
+  or images, are compiled into the server binary.
-  served via the REST API. 
 
-  This dashboard shows values kept in server memory. Many clients can open
+  This UI uses the REST API implemented by the device, which you can examine
-  this page.  The JS code that watches state changes, reconnects on network
-  failures.  That means if server restarts, dashboard on all connected clients
-  refresh automatically.
-
-  NOTE: administrators can change settings values, whilst users cannot.
-
-  <p>
-  This UI uses the REST API implemented by the server, which you can examine
   using  <code>curl</code> command-line utility:
   </p>
 
-  <div><code>curl localhost:8000/api/config/get</code> - get current device configuration</div>
+  <div><code>curl -u admin:pass0 localhost:8000/api/config/get</code> </div>
-  <div><code>curl localhost:8000/api/config/set -d 'value1=7&value2=hello'</code> - set device configuration</div>
+  <div><code>curl -u admin:pass0 localhost:8000/api/config/set -d 'pub=mg/topic'</code> </div>
-  <div><code>curl localhost:8000/api/message/send -d 'msg=hello'</code> - send chat message</div>
+  <div><code>curl -u admin:pass0 localhost:8000/api/message/send -d 'message=hello'</code> </div>
-  <div><code>curl localhost:8000/api/watch</code> - get notifications on config changes or chat messages</div>
 
+  <p>
+  The device can send notifications to this dashboard at anytime. Notifications
+  are sent over WebSocket at URI <code>/api/watch</code> as JSON strings: <code>{"name": "..", "data": ...}</code>
+  <div>Try <code>wscat --auth user1:pass1 --connect ws://localhost:8000/api/watch</code></div>
+  </p>
+</div>
 </div>`;
 
-const ShowSettings = function(props) {
-  return html`
-<div style="margin: 0 0.3em;">
-  <h3 style="background: #59d; color: #fff;padding: 0.4em;">Device configuration</h3>
-  <div style="margin: 0.5em 0;">
-    <span class="addon">value1:</span>
-    <input disabled type="text" class="smooth"
-      value=${(props.config || {}).value1 || ''} />
-  </div>
-  <div style="margin: 0.5em 0;">
-    <span class="addon">value2:</span>
-    <input disabled type="text" class="smooth" 
-      value=${(props.config || {}).value2 || ''} />
-  </div>
-  <div class="msg">
-    Server's corresponding runtime configuration structure:
-    <pre>
-struct config {
-  int value1;
-  char *value2;
-} s_config;
-    </pre>
-  </div>
-</div>`;
-};
-
-const ChangeSettings = function(props) {
-  const [value1, setValue1] = useState('');
-  const [value2, setValue2] = useState('');
-  useEffect(() => {
-    setValue1(props.config.value1);
-    setValue2(props.config.value2);
-  }, [props.config.value1, props.config.value2])
-  const update = (name, val) => fetch('/api/config/set', {
-                                  method: 'post',
-                                  body: `${name}=${encodeURIComponent(val)}`
-                                }).catch(err => err);
-  const updatevalue1 = ev => update('value1', value1);
-  const updatevalue2 = ev => update('value2', value2);
-  return html`
-<div style="margin: 0 0.3em;">
-  <h3 style="background: #c03434; color: #fff; padding: 0.4em;">
-    Change configuration</h3>
-  <div style="margin: 0.5em 0;">
-    <span class="addon">value1:</span>
-    <input type="text" value=${value1} onchange=${updatevalue1}
-          oninput=${ev => setValue1(ev.target.value)} />
-    <button class="btn" disabled=${!value1} onclick=${updatevalue1}
-      style="margin-left: 1em; background: #8aa;">Update</button>
-  </div>
-  <div style="margin: 0.5em 0;">
-    <span class="addon">value2:</span>
-    <input type="text" value=${value2} onchange=${updatevalue2}
-          oninput=${ev => setValue2(ev.target.value)} />
-    <button class="btn" disabled=${!value2} onclick=${updatevalue2}
-      style="margin-left: 1em; background: #8aa;">Update</button>
-  </div>
-  <div class="msg">
-    As soon as administrator updates configuration, 
-    server iterates over all connected clients and sends update
-    notifications to all of them - so they update automatically.
-  </div>
-</div>`;
-};
-
 const Login = function(props) {
   const [user, setUser] = useState('');
   const [pass, setPass] = useState('');
@@ -153,97 +99,279 @@ const Login = function(props) {
 </div>`;
 };
 
-const Message = text => html`<div style="margin: 0.5em 0;">${text}</div>`;
 
-const Chat = function(props) {
+const Configuration = function(props) {
-  const [message, setMessage] = useState('');
+  const [url, setUrl] = useState(props.config.url || '');
-  const sendmessage = ev => fetch('/api/message/send', {
+  const [pub, setPub] = useState(props.config.pub || '');
-                              method: 'post',
+  const [sub, setSub] = useState(props.config.sub || '');
-                              body: `message=${encodeURIComponent(message)}`
-                            }).then(r => setMessage(''));
 
-  const messages = props.messages.map(
+  useEffect(() => {
-      text => html`<div style="margin: 0.5em 0;">${text}</div>`);
+    setUrl(props.config.url);
+    setPub(props.config.pub);
+    setSub(props.config.sub);
+  }, [props.config]);
+
+  const update = (name, val) => fetch('/api/config/set', {
+                                  method: 'post',
+                                  body: `${name}=${encodeURIComponent(val)}`
+                                }).catch(err => err);
+  const updateurl = ev => update('url', url);
+  const updatepub = ev => update('pub', pub);
+  const updatesub = ev => update('sub', sub);
+
+  // console.log(props, [url, pub, sub]);
   return html`
-<div style="margin: 0 0.3em;">
+<div class="section">
-  <h3 style="background: #30c040; color: #fff; padding: 0.4em;">User chat</h3>
+  <h3 style="background: #c03434; color: #fff; padding: 0.4em;">
-  <div style="height: 10em; overflow: auto; padding: 0.5em; " class="border">
+    Device Configuration</h3>
-    ${messages}
+  <div style="margin: 0.5em 0; display: flex;">
+    <span class="addon nowrap">MQTT server:</span>
+    <input type="text" style="flex: 1 100%;"
+          value=${url} onchange=${updateurl}
+          oninput=${ev => setUrl(ev.target.value)} />
+    <button class="btn" disabled=${!url} onclick=${updateurl}
+      style="margin-left: 1em; background: #8aa;">Update</button>
   </div>
-  <div style="margin: 0.5em 0;">
+  <div style="margin: 0.5em 0; display: flex; ">
-    <input placeholder="type message..." style="width: 100%" value=${message}
+    <span class="addon nowrap">Subscribe topic:</span>
-      onchange=${sendmessage}
+    <input type="text" style="flex: 1 100%;"
-      oninput=${ev => setMessage(ev.target.value)} />
+        value=${sub} onchange=${updatesub}
+        oninput=${ev => setSub(ev.target.value)} />
+    <button class="btn" disabled=${!sub} onclick=${updatesub}
+      style="margin-left: 1em; background: #8aa;">Update</button>
+  </div>
+  <div style="margin: 0.5em 0; display: flex;">
+    <span class="addon nowrap">Publish topic:</span>
+    <input type="text" style="flex: 1 100%;"
+          value=${pub} onchange=${updatepub}
+          oninput=${ev => setPub(ev.target.value)} />
+    <button class="btn" disabled=${!pub} onclick=${updatepub}
+      style="margin-left: 1em; background: #8aa;">Update</button>
+  </div>
+  <div>
+    You can use <a href="http://www.hivemq.com/demos/websocket-client/">
+    HiveMQ Websocket web client</a> to send messages to this console.
   </div>
   <div class="msg">
-    Chat demonsrates
+    The device keeps a persistent connection to the configured MQTT server.
-    real-time bidirectional data exchange between many clients and a server.
+    Changes to this configuration are propagated to all dashboards: try
+    changing them in this dashboard and observe changes in other opened
+    dashboards.
+  </div><div class="msg">
+    Note: administrators can see this section and can change device
+    configuration, whilst users cannot.
+  </div>
+</div>`;
+};
+
+
+const Message = m => html`<div style="margin: 0.5em 0;">
+  <span class="qos">qos: ${m.message.qos} </span>
+  <span class="topic">topic: ${m.message.topic} </span>
+  <span class="data">data: ${m.message.data}</span>
+</div>`;
+
+const Messages = function(props) {
+  const [messages, setMessages] = useState([]);
+  const [txt, setTxt] = useState('');
+
+  useEffect(() => {
+    const id = PubSub.subscribe(function(msg) {
+      if (msg.name == 'message') setMessages(x => x.concat([msg.data]));
+    });
+    return PubSub.unsubscribe(id);
+  }, []);
+
+  const sendmessage = ev => fetch('/api/message/send', {
+                              method: 'post',
+                              body: `message=${encodeURIComponent(txt)}`
+                            }).then(r => setTxt(''));
+  const connstatus = props.config.connected ? 'connected' : 'disconnected';
+  return html`
+<div class="section">
+  <h3 style="background: #30c040; color: #fff; padding: 0.4em;">MQTT messages</h3>
+  <div>
+    MQTT server status: <b>${connstatus}</b>
+  </div>
+  <div style="height: 10em; overflow: auto; padding: 0.5em; " class="border">
+    ${messages.map(message => h(Message, {message}))}
+  </div>
+  <div style="margin: 0.5em 0; display: flex">
+    <span class="addon nowrap">Publish message:</span>
+    <input placeholder="type and press enter..." style="flex: 1 100%;"
+      value=${txt} onchange=${sendmessage}
+      oninput=${ev => setTxt(ev.target.value)} />
+  </div>
+  <div class="msg">
+    The message gets passed to the device via REST. Then the device sends it to
+    the MQTT server over MQTT. All MQTT messages on a subscribed topic
+    received by the device, are propagated to this dashboard via /api/watch.
+  </div>
+</div>`;
+};
+
+// Expected arguments:
+// data: timeseries, e.g. [ [1654361352, 19], [1654361353, 18], ... ]
+// width, height, yticks, xticks, ymin, ymax, xmin, xmax
+const SVG = function(props) {
+  //            w
+  //   +---------------------+
+  //   |        h1           |
+  //   |    +-----------+    |
+  //   |    |           |    |  h
+  //   | w1 |           | w2 |
+  //   |    +-----------+    |
+  //   |         h2          |
+  //   +---------------------+
+  //
+  let w = props.width, h = props.height, w1 = 30, w2 = 0, h1 = 8, h2 = 18;
+  let yticks = props.yticks || 4, xticks = props.xticks || 5;
+  let data = props.data || [];
+  let ymin = props.ymin || 0;
+  let ymax = props.ymax || Math.max.apply(null, data.map(p => p[1]));
+  let xmin = props.xmin || Math.min.apply(null, data.map(p => p[0]));
+  let xmax = props.xmax || Math.max.apply(null, data.map(p => p[0]));
+
+  // Y-axis tick lines and labels
+  let yta = (new Array(yticks + 1)).fill(0).map((_, i) => i);  // indices
+  let yti = i => h - h2 - (h - h1 - h2) * i / yticks;          // index's Y
+  let ytv = i => (ymax - ymin) * i / yticks;
+  let ytl = y => html`<line x1=${w1} y1=${y} x2=${w} y2=${y} class="tick"/>`;
+  let ytt = (y, v) => html`<text x=0 y=${y + 5} class="label">${v}</text>`;
+
+  // X-axis tick lines and labels
+  let datefmt = unix => (new Date(unix * 1000)).toISOString().substr(14, 5);
+  let xta = (new Array(xticks + 1)).fill(0).map((_, i) => i);  // indices
+  let xti = i => w1 + (w - w1 - w2) * i / xticks;              // index's X
+  let xtv = i => datefmt(xmin + (xmax - xmin) * i / xticks);
+  let xtl = x => html`<path d="M ${x},${h1} L ${x},${h - h2}" class="tick"/>`;
+  let xtt = (x, v) =>
+      html`<text x=${x - 15} y=${h - 2} class="label">${v}</text>`;
+
+  // Transform data points array into coordinate
+  let dx = v => w1 + (v - xmin) / ((xmax - xmin) || 1) * (w - w1 - w2);
+  let dy = v => h - h2 - (v - ymin) / ((ymax - ymin) || 1) * (h - h1 - h2);
+  let dd = data.map(p => [Math.round(dx(p[0])), Math.round(dy(p[1]))]);
+  let ddl = dd.length;
+  // And plot the data as <path> element
+  let begin0 = ddl ? `M ${dd[0][0]},${dd[0][1]}` : `M 0,0`;
+  let begin = `M ${w1},${h - h2}`;  // Initial point
+  let end = ddl ? `L ${dd[ddl - 1][0]},${h - h2}` : `L ${w1},${h - h2}`;
+  let series = ddl ? dd.map(p => `L ${p[0]} ${p[1]}`) : [];
+
+  return html`
+<svg viewBox="0 0 ${w} ${h}">
+  <style>
+    .axis { stroke: #aaa; fill: none; }
+    .label { stroke: #aaa; font-size: 13px; }
+    .tick { stroke: #ccc; fill: none; stroke-dasharray: 5; }
+    .seriesbg { stroke: none; fill: rgba(200,225,255, 0.25)}
+    .series { stroke: #25a; fill: none; }
+  </style>
+  ${yta.map(i => ytl(yti(i)))}
+  ${yta.map(i => ytt(yti(i), ytv(i)))}
+  ${xta.map(i => xtl(xti(i)))}
+  ${data.length ? xta.map(i => xtt(xti(i), xtv(i))) : ''}
+  <path d="${begin} ${series.join(' ')} ${end}" class="seriesbg" />
+  <path d="${begin0} ${series.join(' ')}" class="series" />
+</svg>`;
+};
+
+
+const Chart = function(props) {
+  const [data, setData] = useState([]);
+  useEffect(() => {
+    const id = PubSub.subscribe(function(msg) {
+      if (msg.name != 'metrics') return;
+      setData(x => x.concat([msg.data]).splice(-MaxMetricsDataPoints));
+    });
+    return PubSub.unsubscribe(id);
+  }, []);
+
+  let xmax = 0, missing = MaxMetricsDataPoints - data.length;
+  if (missing > 0) xmax = Math.round(Date.now() / 1000) + missing;
+  return html`
+<div class="section">
+  <h3 style="background: #ec3; color: #fff; padding: 0.4em;">Data Chart</h3>
+  <div style="overflow: auto; padding: 0.5em;" class="">
+    <${SVG} height=240 width=600 ymin=0 ymax=20 xmax=${xmax} data=${data} />
+  </div>
+  <div class="msg">
+    This chart plots live sensor data, sent by the device via /api/watch.
   </div>
 </div>`;
 };
 
 const App = function(props) {
-  const [messages, setMessages] = useState([]);
   const [user, setUser] = useState('');
   const [config, setConfig] = useState({});
 
-  const refresh = () => fetch('/api/config/get', {headers: {Authorization: ''}})
+  const getconfig = () =>
-                            .then(r => r.json())
+      fetch('/api/config/get', {headers: {Authorization: ''}})
-                            .then(r => setConfig(r));
+          .then(r => r.json())
+          .then(r => setConfig(r))
+          .catch(err => console.log(err));
+
+  // Watch for notifications. As soon as a notification arrives, pass it on
+  // to all subscribed components
+  const watch = function() {
+    var l = window.location, proto = l.protocol.replace('http', 'ws');
+    var tid, wsURI = proto + '//' + l.host + '/api/watch'
+    var reconnect = function() {
+      var ws = new WebSocket(wsURI);
+      // ws.onopen = () => console.log('ws connected');
+      ws.onmessage = function(ev) {
+        try {
+          var msg = JSON.parse(ev.data);
+          PubSub.publish(msg);
+          // if (msg.name != 'metrics') console.log('ws->', msg);
+        } catch (e) {
+          console.log('Invalid ws frame:', ev.data);  // eslint-disable-line
+        }
+      };
+      ws.onclose = function() {
+        clearTimeout(tid);
+        tid = setTimeout(reconnect, 1000);
+        console.log('ws disconnected');
+      };
+    };
+    reconnect();
+  };
 
   const login = function(u) {
-    document.cookie = `access_token=${u.token};path=/;max-age=3600`;
+    document.cookie = `access_token=${u.token}; Secure, HttpOnly; SameSite=Lax; path=/; max-age=3600`;
     setUser(u.user);
-    refresh();
+    watch();
+    return getconfig();
   };
 
   const logout = ev => {
-    document.cookie = `access_token=;path=/;max-age=0`;
+    document.cookie = `access_token=; Secure, HttpOnly; SameSite=Lax; path=/; max-age=0`;
     setUser('');
   };
 
-  const watch = function() {
-    var f = function(reader) {
-      return reader.read().then(function(result) {
-        var data = String.fromCharCode.apply(null, result.value);
-        var notification = JSON.parse(data);
-        if (notification.name == 'config') refresh();
-        if (notification.name == 'message') {
-          setMessages(m => m.concat([notification.data]))
-        }
-        // console.log(notification);
-        if (!result.done) return f(reader);
-      });
-    };
-    fetch('/api/watch', {headers: {Authorization: ''}})
-        .then(r => r.body.getReader())
-        .then(f)
-        .catch(e => setTimeout(watch, 1000));
-  };
-
   useEffect(() => {
+    // Called once at init time
+    PubSub.subscribe(msg => msg.name == 'config' && getconfig());
     fetch('/api/login', {headers: {Authorization: ''}})
         .then(r => r.json())
         .then(r => login(r))
         .catch(err => setUser(''));
-    refresh();
-    watch();
   }, []);
 
   if (!user) return html`<${Login} login=${login} />`;
-  const admin = user == 'admin';
+
-  const colsize = admin ? 'c4' : 'c6';
-  const cs = admin ? html`<${ChangeSettings} config=${config} />` : '';
   return html`
 <${Nav} user=${user} logout=${logout} />
 <div class="container">
-  <${Hero} />
   <div class="row">
-    <div class="col ${colsize}"><${ShowSettings} config=${config} /></div>
+    <div class="col col-6"><${Hero} /></div>
-    <div class="col ${colsize}">${cs}</div>
+    <div class="col col-6"><${Chart} /></div>
-    <div class="col ${colsize}"><${Chat} messages=${messages} /></div>
+    <div class="col col-6">
+      ${user == 'admin' && h(Configuration, {config})}
+    </div>
+    <div class="col col-6"><${Messages} config=${config} /></div>
   </div>
-  <${Footer} />
 </div>`;
 };
 

examples/device-dashboard/web_root/style.css

@@ -4,7 +4,7 @@ select, input, label::before, textarea { outline: none; box-shadow:none !importa
 code, pre { color: #373; font-family: monospace; font-weight: bolder; font-size: smaller; background: #ddd; padding: 0.1em 0.3em; border-radius: 0.2em; }
 textarea, input, .addon { font-size: 15px; border: 1px solid #ccc; padding: 0.5em; }
 a, a:visited, a:active { color: #55f; }
-.addon { background: #eee; }
+.addon { background: #eee;  min-width: 9em;}
 .btn {
   background: #ccc; border-radius: 0.3em; border: 0; color: #fff; cursor: pointer;
   display: inline-block; padding: 0.6em 2em; font-weight: bolder;
@@ -16,21 +16,28 @@ a, a:visited, a:active { color: #55f; }
 .d-none { display: none; }
 .border { border: 1px solid #ddd; }
 .rounded { border-radius: 0.5em; }
-.msg { background: #def; border-left: 5px solid #59d; padding: 1em; margin: 1em 0; }
+.nowrap { white-space: nowrap; }
-.row { margin: 1% 0; overflow: auto; }
+.msg { background: #def; border-left: 5px solid #59d; padding: 0.5em; font-size: 90%; margin: 1em 0; }
-.col { float: left; }
+.section { margin: 0 1em; }
-.table, .c12 { width: 100%; }
+.topic, .data, .qos {  padding: 0.2em 0.5em; border-radius: 0.4em; margin-right: 0.5em;  }
-.c11 { width: 91.66%; }
+.qos { background: #efa; }
-.c10 { width: 83.33%; }
+.topic { background: #fea; }
-.c9 { width: 75%; }
+.data { background: #aef; }
-.c8 { width: 66.66%; }
-.c7 { width: 58.33%; }
-.c6 { width: 50%; }
-.c5 { width: 41.66%; }
-.c4 { width: 33.33%; }
-.c3 { width: 25%; }
-.c2 { width: 16.66%; }
-.c1 { width: 8.33%; }
 
+/* Grid */
+.row { display: flex; flex-wrap: wrap; }
+.col { margin: 0; padding: 0; overflow: auto; }
+.col-12 { width: 100%; }
+.col-11 { width: 91.66%; }
+.col-10 { width: 83.33%; }
+.col-9 { width: 75%; }
+.col-8 { width: 66.66%; }
+.col-7 { width: 58.33%; }
+.col-6 { width: 50%; }
+.col-5 { width: 41.66%; }
+.col-4 { width: 33.33%; }
+.col-3 { width: 25%; }
+.col-2 { width: 16.66%; }
+.col-1 { width: 8.33%; }
 @media (min-width: 1310px) { .container { margin: auto; width: 1270px; } }
-@media (max-width: 870px) { .row .col { width: 100%; } }
+@media (max-width: 920px) { .row .col { width: 100%; } }

examples/embedded-filesystem/Makefile

@@ -0,0 +1,51 @@
+PROG ?= example
+SOURCES ?= ../../mongoose.c main.c packed_fs.c
+CFLAGS ?= -I../.. -DMG_ENABLE_PACKED_FS=1 -DMG_ENABLE_LINES=1 $(EXTRA)
+FILES_TO_EMBED ?= $(wildcard web_root/*)
+ROOT ?= $(realpath $(CURDIR)/../../..)
+DOCKER ?= docker run --rm -e Tmp=. -e WINEDEBUG=-all -v $(ROOT):$(ROOT) -w $(CURDIR)
+VC98 ?= $(DOCKER) mdashnet/vc98 wine
+MINGW ?= $(DOCKER) mdashnet/mingw
+
+all: $(PROG)
+	$(RUN) ./$(PROG)
+
+$(PROG): $(SOURCES) $(FILES_TO_EMBED)
+	$(CC) ../../test/pack.c -o pack
+	./pack $(FILES_TO_EMBED) > packed_fs.c
+	$(CC) -W -Wall -Wextra -O0 -g3 $(CFLAGS) -o $(PROG) $(SOURCES)
+
+
+mingw: $(SOURCES) $(FILES_TO_EMBED)
+	$(MINGW) i686-w64-mingw32-gcc $(CFLAGS) ../../test/pack.c -o pack.exe
+	$(MINGW) wine cmd /c 'pack.exe $(FILES_TO_EMBED) > packed_fs.c'
+	$(MINGW) i686-w64-mingw32-gcc $(CFLAGS) $(SOURCES) -lws2_32 -o $(PROG).exe
+	$(MINGW) wine $(PROG).exe
+
+vc98: $(SOURCES) $(FILES_TO_EMBED)
+	$(VC98) cl.exe /nologo $(CFLAGS) ../../test/pack.c /Fepack.exe
+	$(VC98) cmd /c 'pack.exe $(FILES_TO_EMBED) > packed_fs.c'
+	$(VC98) cl.exe /nologo /O2 $(CFLAGS) $(SOURCES) /Fe$(PROG).exe
+	$(VC98) $(PROG).exe
+
+clean:
+	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb log.txt pack
+
+.PHONY: compress expand gzipped plain all
+
+gzipped: compress
+	$(MAKE) all
+
+plain: expand
+	$(MAKE) all
+
+compress:
+	for file in $(FILES_TO_EMBED) ; do \
+		gzip -q $$file ; \
+	done
+
+expand:
+	for file in $(FILES_TO_EMBED) ; do \
+		gunzip -q $$file ; \
+	done
+

examples/embedded-filesystem/main.c

@@ -0,0 +1,28 @@
+// Copyright (c) 2022 Cesanta Software Limited
+// All rights reserved
+
+#include "mongoose.h"
+
+const char *s_listening_url = "http://0.0.0.0:8000";
+
+// HTTP request handler function
+void fn(struct mg_connection *c, int ev, void *ev_data, void *fn_data) {
+  if (ev == MG_EV_HTTP_MSG) {
+    struct mg_http_serve_opts opts = {
+        .root_dir = "/web_root",
+        .fs = &mg_fs_packed
+      };
+    mg_http_serve_dir(c, ev_data, &opts);
+  }
+  (void) fn_data;
+}
+
+int main(void) {
+  struct mg_mgr mgr;
+  mg_log_set(MG_LL_INFO);
+  mg_mgr_init(&mgr);
+  mg_http_listen(&mgr, s_listening_url, fn, NULL);
+  while (true) mg_mgr_poll(&mgr, 500);
+  mg_mgr_free(&mgr);
+  return 0;
+}

examples/embedded-filesystem/web_root/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta name="description" content="Mongoose Embedded Filesytem example" />
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+        <title>Mongoose Embedded Filesytem example</title>
+    <link rel="stylesheet" href="style.css" />
+  </head>
+  <body></body>
+  <script type="module" src="main.js"></script>
+</html>

examples/embedded-filesystem/web_root/main.js

@@ -0,0 +1,88 @@
+'use strict';
+import { h, html, render } from './preact.min.js';
+
+
+const X = function () {
+
+  return html`
+  <div class="container">
+    <h2 class="section">ABOUT US</h2>
+    <div class="row">
+      <div class="col-7">
+        <p>      
+          Cesanta Software Ltd. is headquartered in Dublin, Republic of Ireland.
+        </p>
+        <p></p>
+        Our story roots back to 2004, when Mongoose Web Server Library development started. <br>
+
+        As Mongoose Web Server grew in popularity and matured over the following years, in 2013 Cesanta was established to continue its development and 
+        provide support to our valued customers.
+        </p>
+        <p>We are proud to have among our customers many <i>Fortune 500</i> companies as well as medium and small size businesses.
+          Security and quality of our solutions is a paramount for us and the fact that Mongoose Web Server is used by NASA aboard the International Space Station is 
+          the best confirmation to it.</p>
+          <p>Since 2013, Cesanta has expanded its product portfolio. We develop and distribute embedded software and hardware with focus on connected products and the Internet of Things.</p>
+
+      </div>
+    </div>
+  </div>
+`;
+};
+
+const Y = function () {
+
+  return html`
+  <div class="container">
+    <h3 class="section">Among our products are:</h3>
+    <div class="row">
+      <div class="col-7">
+       <ul>
+         <li>
+           <a href="https://mongoose.ws/">Mongoose Web Server</a>
+           - an embedded web server and networking library
+         </li>
+         <li>
+           <a href="https://vcon.io/">VCON.io</a>
+           - Arduino-compatible boards with built-in firmware OTA updates
+           and management dashboard
+         </li>
+         <li>
+           <a href="https://mdash.net/">mDash.net</a>
+           - an all-in-one IoT Platform
+         </li>
+         <li>
+           <a href="https://mongoose-os.com">Mongoose OS</a>
+           - an operating system for low-power microcontrollers
+         </li>
+
+         <li>
+           <a href="https://github.com/cesanta/mjs">mJS</a>
+           - an embedded JavaScript engine for C/C++
+         </li>
+       </ul>
+      </div>
+      <div class="col-6">
+        <p><b>Our solutions are:</b></p>
+        <ul>
+          <li>integrated into thousands of commercial products</li>
+          <li>deployed to hundreds of millions devices in production environments</li>
+        </ul>
+      </div>
+    </div>
+  </div>
+`;
+};
+
+const App = function (props) {
+
+  return html`
+<h1>Basic Embedded Filesystem demo</h1>
+<div>
+  ${h(X)}
+</div>
+<div>
+  ${h(Y)}
+</div>`;
+};
+
+window.onload = () => render(h(App), document.body);

examples/embedded-filesystem/web_root/preact.min.js

@@ -0,0 +1 @@
+var e,n,_,t,o,r,u,l={},i=[],c=/acit|ex(?:s|g|n|p|$)|rph|grid|ows|mnc|ntw|ine[ch]|zoo|^ord|itera/i;function s(e,n){for(var _ in n)e[_]=n[_];return e}function f(e){var n=e.parentNode;n&&n.removeChild(e)}function a(n,_,t){var o,r,u,l={};for(u in _)"key"==u?o=_[u]:"ref"==u?r=_[u]:l[u]=_[u];if(arguments.length>2&&(l.children=arguments.length>3?e.call(arguments,2):t),"function"==typeof n&&null!=n.defaultProps)for(u in n.defaultProps)void 0===l[u]&&(l[u]=n.defaultProps[u]);return p(n,l,o,r,null)}function p(e,t,o,r,u){var l={type:e,props:t,key:o,ref:r,__k:null,__:null,__b:0,__e:null,__d:void 0,__c:null,__h:null,constructor:void 0,__v:null==u?++_:u};return null!=n.vnode&&n.vnode(l),l}function h(e){return e.children}function d(e,n){this.props=e,this.context=n}function v(e,n){if(null==n)return e.__?v(e.__,e.__.__k.indexOf(e)+1):null;for(var _;n<e.__k.length;n++)if(null!=(_=e.__k[n])&&null!=_.__e)return _.__e;return"function"==typeof e.type?v(e):null}function y(e){var n,_;if(null!=(e=e.__)&&null!=e.__c){for(e.__e=e.__c.base=null,n=0;n<e.__k.length;n++)if(null!=(_=e.__k[n])&&null!=_.__e){e.__e=e.__c.base=_.__e;break}return y(e)}}function m(e){(!e.__d&&(e.__d=!0)&&t.push(e)&&!g.__r++||r!==n.debounceRendering)&&((r=n.debounceRendering)||o)(g)}function g(){for(var e;g.__r=t.length;)e=t.sort(function(e,n){return e.__v.__b-n.__v.__b}),t=[],e.some(function(e){var n,_,t,o,r,u;e.__d&&(r=(o=(n=e).__v).__e,(u=n.__P)&&(_=[],(t=s({},o)).__v=o.__v+1,P(u,o,t,n.__n,void 0!==u.ownerSVGElement,null!=o.__h?[r]:null,_,null==r?v(o):r,o.__h),D(_,o),o.__e!=r&&y(o)))})}function k(e,n,_,t,o,r,u,c,s,f){var a,d,y,m,g,k,x,H=t&&t.__k||i,E=H.length;for(_.__k=[],a=0;a<n.length;a++)if(null!=(m=_.__k[a]=null==(m=n[a])||"boolean"==typeof m?null:"string"==typeof m||"number"==typeof m||"bigint"==typeof m?p(null,m,null,null,m):Array.isArray(m)?p(h,{children:m},null,null,null):m.__b>0?p(m.type,m.props,m.key,null,m.__v):m)){if(m.__=_,m.__b=_.__b+1,null===(y=H[a])||y&&m.key==y.key&&m.type===y.type)H[a]=void 0;else for(d=0;d<E;d++){if((y=H[d])&&m.key==y.key&&m.type===y.type){H[d]=void 0;break}y=null}P(e,m,y=y||l,o,r,u,c,s,f),g=m.__e,(d=m.ref)&&y.ref!=d&&(x||(x=[]),y.ref&&x.push(y.ref,null,m),x.push(d,m.__c||g,m)),null!=g?(null==k&&(k=g),"function"==typeof m.type&&null!=m.__k&&m.__k===y.__k?m.__d=s=b(m,s,e):s=C(e,m,y,H,g,s),f||"option"!==_.type?"function"==typeof _.type&&(_.__d=s):e.value=""):s&&y.__e==s&&s.parentNode!=e&&(s=v(y))}for(_.__e=k,a=E;a--;)null!=H[a]&&("function"==typeof _.type&&null!=H[a].__e&&H[a].__e==_.__d&&(_.__d=v(t,a+1)),U(H[a],H[a]));if(x)for(a=0;a<x.length;a++)T(x[a],x[++a],x[++a])}function b(e,n,_){var t,o;for(t=0;t<e.__k.length;t++)(o=e.__k[t])&&(o.__=e,n="function"==typeof o.type?b(o,n,_):C(_,o,o,e.__k,o.__e,n));return n}function C(e,n,_,t,o,r){var u,l,i;if(void 0!==n.__d)u=n.__d,n.__d=void 0;else if(null==_||o!=r||null==o.parentNode)e:if(null==r||r.parentNode!==e)e.appendChild(o),u=null;else{for(l=r,i=0;(l=l.nextSibling)&&i<t.length;i+=2)if(l==o)break e;e.insertBefore(o,r),u=r}return void 0!==u?u:o.nextSibling}function x(e,n,_){"-"===n[0]?e.setProperty(n,_):e[n]=null==_?"":"number"!=typeof _||c.test(n)?_:_+"px"}function H(e,n,_,t,o){var r;e:if("style"===n)if("string"==typeof _)e.style.cssText=_;else{if("string"==typeof t&&(e.style.cssText=t=""),t)for(n in t)_&&n in _||x(e.style,n,"");if(_)for(n in _)t&&_[n]===t[n]||x(e.style,n,_[n])}else if("o"===n[0]&&"n"===n[1])r=n!==(n=n.replace(/Capture$/,"")),n=n.toLowerCase()in e?n.toLowerCase().slice(2):n.slice(2),e.l||(e.l={}),e.l[n+r]=_,_?t||e.addEventListener(n,r?S:E,r):e.removeEventListener(n,r?S:E,r);else if("dangerouslySetInnerHTML"!==n){if(o)n=n.replace(/xlink[H:h]/,"h").replace(/sName$/,"s");else if("href"!==n&&"list"!==n&&"form"!==n&&"tabIndex"!==n&&"download"!==n&&n in e)try{e[n]=null==_?"":_;break e}catch(e){}"function"==typeof _||(null!=_&&(!1!==_||"a"===n[0]&&"r"===n[1])?e.setAttribute(n,_):e.removeAttribute(n))}}function E(e){this.l[e.type+!1](n.event?n.event(e):e)}function S(e){this.l[e.type+!0](n.event?n.event(e):e)}function P(e,_,t,o,r,u,l,i,c){var f,a,p,v,y,m,g,b,C,x,H,E=_.type;if(void 0!==_.constructor)return null;null!=t.__h&&(c=t.__h,i=_.__e=t.__e,_.__h=null,u=[i]),(f=n.__b)&&f(_);try{e:if("function"==typeof E){if(b=_.props,C=(f=E.contextType)&&o[f.__c],x=f?C?C.props.value:f.__:o,t.__c?g=(a=_.__c=t.__c).__=a.__E:("prototype"in E&&E.prototype.render?_.__c=a=new E(b,x):(_.__c=a=new d(b,x),a.constructor=E,a.render=A),C&&C.sub(a),a.props=b,a.state||(a.state={}),a.context=x,a.__n=o,p=a.__d=!0,a.__h=[]),null==a.__s&&(a.__s=a.state),null!=E.getDerivedStateFromProps&&(a.__s==a.state&&(a.__s=s({},a.__s)),s(a.__s,E.getDerivedStateFromProps(b,a.__s))),v=a.props,y=a.state,p)null==E.getDerivedStateFromProps&&null!=a.componentWillMount&&a.componentWillMount(),null!=a.componentDidMount&&a.__h.push(a.componentDidMount);else{if(null==E.getDerivedStateFromProps&&b!==v&&null!=a.componentWillReceiveProps&&a.componentWillReceiveProps(b,x),!a.__e&&null!=a.shouldComponentUpdate&&!1===a.shouldCompLine truncated

examples/embedded-filesystem/web_root/style.css

@@ -0,0 +1,43 @@
+* { box-sizing: border-box; }
+html, body { margin: 0; padding: 0; height: 100%; font: 16px sans-serif; }
+select, input, label::before, textarea { outline: none; box-shadow:none !important; border: 1px solid #ccc !important; }
+code, pre { color: #373; font-family: monospace; font-weight: bolder; font-size: smaller; background: #ddd; padding: 0.1em 0.3em; border-radius: 0.2em; }
+textarea, input, .addon { font-size: 15px; border: 1px solid #ccc; padding: 0.5em; }
+a, a:visited, a:active { color: #55f; }
+.addon { background: #eee;  min-width: 9em;}
+.btn {
+  background: #ccc; border-radius: 0.3em; border: 0; color: #fff; cursor: pointer;
+  display: inline-block; padding: 0.6em 2em; font-weight: bolder;
+}
+.btn[disabled] { opacity: 0.5; cursor: auto;}
+.smooth { transition: all .2s; }
+.container { margin: 0 20px; width: auto; }
+.d-flex { display: flex; }
+.d-none { display: none; }
+.border { border: 1px solid #ddd; }
+.rounded { border-radius: 0.5em; }
+.nowrap { white-space: nowrap; }
+.msg { background: #def; border-left: 5px solid #59d; padding: 0.5em; font-size: 90%; margin: 1em 0; }
+.section { margin: 0 1em; }
+.topic, .data, .qos {  padding: 0.2em 0.5em; border-radius: 0.4em; margin-right: 0.5em;  }
+.qos { background: #efa; }
+.topic { background: #fea; }
+.data { background: #aef; }
+
+/* Grid */
+.row { display: flex; flex-wrap: wrap; }
+.col { margin: 0; padding: 0; overflow: auto; }
+.col-12 { width: 100%; }
+.col-11 { width: 91.66%; }
+.col-10 { width: 83.33%; }
+.col-9 { width: 75%; }
+.col-8 { width: 66.66%; }
+.col-7 { width: 58.33%; }
+.col-6 { width: 50%; }
+.col-5 { width: 41.66%; }
+.col-4 { width: 33.33%; }
+.col-3 { width: 25%; }
+.col-2 { width: 16.66%; }
+.col-1 { width: 8.33%; }
+@media (min-width: 1310px) { .container { margin: auto; width: 1270px; } }
+@media (max-width: 920px) { .row .col { width: 100%; } }

examples/esp32/Makefile

@@ -1,18 +0,0 @@
-THISDIR = $(realpath $(CURDIR))
-ROOTDIR = $(realpath $(CURDIR)/../..)
-
-all: example
-
-example:
-	true
-
-build: main/main.c Makefile
-	docker run --rm -v $(ROOTDIR):$(ROOTDIR) -w $(THISDIR) espressif/idf idf.py build
-
-COMPORT ?= /dev/cu.SLAB_USBtoUART
-ESPTOOL ?= esptool.py
-flash:
-	cd build && $(ESPTOOL) --chip esp32 -p $(COMPORT) -b 460800 --before=default_reset --after=hard_reset write_flash --flash_mode dio --flash_freq 40m --flash_size 2MB 0x8000 partition_table/partition-table.bin 0x1000 bootloader/bootloader.bin 0x100000 mongoose-esp32-example.bin
-
-clean:
-	rm -rf build

examples/esp32/README.md

@@ -1 +0,0 @@
-See detailed tutorial at https://mongoose.ws/tutorials/esp32/

examples/esp32/device-dashboard/Makefile

@@ -0,0 +1,38 @@
+THISDIR = $(realpath $(CURDIR))
+ROOTDIR = $(realpath $(CURDIR)/../../..)
+DOCKER ?= docker run --rm $(DA) -v $(ROOTDIR):$(ROOTDIR) -w $(THISDIR) espressif/idf
+CMD ?= idf.py build
+PORT ?= /dev/ttyUSB0
+
+all: example
+
+example:
+	true
+
+build: Makefile $(wildcard main/*)
+	$(DOCKER) $(CMD)
+
+flash:
+flash: CMD = idf.py flash
+flash: DA = --device $(PORT)
+flash: build
+
+.PHONY: build
+
+dashboard.hex: build
+	esputil mkhex \
+		0x8000 build/partition_table/partition-table.bin \
+		0x1000 build/bootloader/bootloader.bin \
+		0x100000 build/mongoose-esp32-example.bin > $@
+
+flash2: dashboard.hex
+	esputil -p $(PORT) -b 921600 -fp 0x220 flash dashboard.hex
+	esputil -p $(PORT) monitor
+
+ESPTOOL ?= esptool.py
+
+flash3:
+	cd build && $(ESPTOOL) --chip esp32 -p $(PORT) -b 460800 --before=default_reset --after=hard_reset write_flash --flash_mode dio --flash_freq 40m --flash_size 2MB 0x8000 partition_table/partition-table.bin 0x1000 bootloader/bootloader.bin 0x100000 mongoose-esp32-example.bin
+
+clean:
+	$(DOCKER) rm -rf build sdkconfig

examples/esp32/device-dashboard/README.md

@@ -0,0 +1 @@
+See detailed tutorial at https://mongoose.ws/tutorials/esp32/device-dashboard

examples/esp32/device-dashboard/main/CMakeLists.txt

@@ -1,4 +1,7 @@
 idf_component_register(SRCS "main.c"
                             "wifi.c"
+                            "net.c"
+                            "packed_fs.c"
                             "mongoose.c")
 component_compile_options(-DMG_ENABLE_LINES)
+component_compile_options(-DMG_ENABLE_PACKED_FS)

examples/esp32/device-dashboard/main/main.c

@@ -0,0 +1,35 @@
+// Copyright (c) 2020 Cesanta Software Limited
+// All rights reserved
+
+#include "esp_spiffs.h"
+//#include "freertos/FreeRTOS.h"
+#include "mongoose.h"
+
+const char *s_listening_url = "http://0.0.0.0:80";
+void device_dashboard_fn(struct mg_connection *, int, void *, void *);
+
+#define WIFI_SSID "YOUR_WIFI_NETWORK_NAME"  // SET THIS!
+#define WIFI_PASS "YOUR_WIFI_PASSWORD"      // SET THIS!
+#define FS_ROOT "/spiffs"
+
+void app_main(void) {
+  // Mount filesystem
+  esp_vfs_spiffs_conf_t conf = {
+      .base_path = FS_ROOT, .max_files = 20, .format_if_mount_failed = true};
+  int res = esp_vfs_spiffs_register(&conf);
+  MG_INFO(("FS %s, %d", conf.base_path, res));
+  mg_file_printf(&mg_fs_posix, FS_ROOT "/hello.txt", "%s", "hello from ESP");
+
+  // Setup wifi. This function is implemented in wifi.c
+  // It blocks until connected to the configured WiFi network
+  void wifi_init(const char *ssid, const char *pass);
+  wifi_init(WIFI_SSID, WIFI_PASS);
+
+  // Connected to WiFi, now start HTTP server
+  struct mg_mgr mgr;
+  mg_log_set(MG_LL_DEBUG);  // Set log level
+  mg_mgr_init(&mgr);
+  MG_INFO(("Mongoose v%s on %s", MG_VERSION, s_listening_url));
+  mg_http_listen(&mgr, s_listening_url, device_dashboard_fn, &mgr);
+  for (;;) mg_mgr_poll(&mgr, 1000);  // Infinite event loop
+}

examples/esp32/device-dashboard/main/mongoose.c

@@ -0,0 +1 @@
+../../../../mongoose.c

examples/esp32/device-dashboard/main/mongoose.h

@@ -0,0 +1 @@
+../../../../mongoose.h

examples/esp32/device-dashboard/main/net.c

@@ -0,0 +1 @@
+../../../device-dashboard/net.c

examples/esp32/device-dashboard/main/packed_fs.c

@@ -0,0 +1 @@
+../../../device-dashboard/packed_fs.c

examples/esp32/device-dashboard/main/wifi.c

@@ -42,7 +42,7 @@ static void event_handler(void *arg, esp_event_base_t event_base,
     MG_ERROR(("connect to the AP fail"));
   } else if (event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP) {
     ip_event_got_ip_t *event = (ip_event_got_ip_t *) event_data;
-    MG_INFO(("got ip:" IPSTR, IP2STR(&event->ip_info.ip)));
+    MG_INFO(("IP ADDRESS:" IPSTR, IP2STR(&event->ip_info.ip)));
     s_retry_num = 0;
     xEventGroupSetBits(s_wifi_event_group, WIFI_CONNECTED_BIT);
   }