about summary refs log tree commit diff
path: root/README.md
diff options
context:
space:
mode:
authorgennyble <gen@nyble.dev>2025-05-18 14:50:36 -0500
committergennyble <gen@nyble.dev>2025-05-18 14:50:36 -0500
commitcc95fb8a0fb3b7bc2b35d05180ef1870497213b2 (patch)
tree58f787ef4180029306466ae444894e622021c763 /README.md
parent983066f43ff256c8fba58fe7f9dd2f609b59c2ca (diff)
downloadskim-main.tar.gz
skim-main.zip
fix adding udp stats to tcp vec HEAD main
Diffstat (limited to 'README.md')
-rw-r--r--README.md23
1 files changed, 23 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ac2cafa
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+[![free of syn](https://img.shields.io/badge/free%20of-syn-hotpink)](https://github.com/fasterthanlime/free-of-syn)
+
+**skim**  
+skim records the sizes of packets passing through an interface so you
+can monitor network usage. it sorts this information by transport type,
+tcp/udp, and port number.
+
+skim exposes an interface for retrieving statistics on tcp port 6666.
+first send a u32, big endian, and then json data with the ports you
+want. the json should look like this:  
+`{ "tcp": [80, 443], "udp": [53] }`
+
+you'll get a response back in a similar format. the first four bytes
+will be the length of the response, big endian, and then the json data.
+the data'll look like this:  
+```json
+{
+	"tcp":[{"port":80,"tx":0,"rx":0},{"port":443,"tx":56260,"rx":4195}],
+	"udp":[{"port":53,"tx":210,"rx":173}]
+}
+```
+
+skim records network traffic assuming the host system is acting as a server.
\ No newline at end of file