summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorRussell King <rmk@armlinux.org.uk>2021-04-16 14:01:05 +0100
committerRussell King <rmk@armlinux.org.uk>2021-04-16 14:01:05 +0100
commit9d7b0311d5948fca09b19dbe27e5f506e2e303e0 (patch)
tree1accaf615f2f744232fceed6a9a8ceca6cde7c53 /README
event-httpd: add event httpd support
Add event httpd, which is a small and basic http server designed to provide server sent events to clients. The server accepts updates through a simple "UPDATE" method which are then broadcast to clients listening using the "GET" method. Signed-off-by: Russell King <rmk@armlinux.org.uk>
Diffstat (limited to 'README')
-rw-r--r--README21
1 files changed, 21 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..57d9ac6
--- /dev/null
+++ b/README
@@ -0,0 +1,21 @@
+This is a very basic HTTP server, designed for real-time server sent
+event streams. BEWARE: the server offers little to no security
+features.
+
+The server supports:
+- the standard HTTP "GET" method for retrieval of events.
+- a custom "UPDATE" method to send events.
+- HTTP 1.0 and 1.1 connections. HTTP 1.1 uses chunked mode.
+
+The server is hard-coded to listen on TCP *:1180.
+
+Design
+------
+The design concept is:
+
+public ------ apache reverse ----- event ------ data gathering
+internet proxy httpd server application
+
+The reverse proxy is responsible for controlling public access to the
+event streams served by the mini-httpd event server; the event server
+itself should not be publically accessible.