add README

README.md

@@ -0,0 +1,35 @@
+# luad
+
+A server that provides pre-warmed Lua VMs to clients connecting over
+unix sockets
+
+* no waiting for the interpeter to load
+* share read-only pages between Lua processes
+
+Lua is small enough that this is probably meaningless on any
+reasonably powerful computer, but conversely: Lua is useful on
+computers that are unreasonably feeble. This utility was written for
+Liminix, but it may be useful elsewhere too.
+
+## what it does
+
+* start Lua
+* accept unix datagram socket commands
+* fork a child for each peer socket and run the requested lua script
+
+
+## small print
+
+* WIP. Not finished. Use at own risk, etc
+
+* it only works on Linux (or if there are other OSes with SCM_RIGHTS
+to send unix file descriptors across processes, then maybe it works
+on them as well)
+
+
+## TO DO
+
+[.] run a script in the Lua vm before forking (e.g. to preload
+libraries that you want available in every process)
+
+[.] packaging