1 # kamid -- 9p file server daemon
3 kamid is a FREE, easy-to-use and portable implementation of a 9p file
4 server daemon for UNIX-like systems.
9 kamid depends on libtls, libevent and yacc/GNU bison. To build from a
14 sudo make install # eventually
16 to build from a git checkout:
25 In order to run, a `_kamid` user must exists. The home directory of
26 `_kamid` should be `/var/empty` or similar. A configuration file is
27 also needed. kamid must be started with root privileges.
29 A sample configuration file:
32 pki localhost cert "/path/to/localhost.crt"
33 pki localhost key "/path/to/localhost.key"
35 table users { "SHA256:..." => "op" }
37 listen on localhost port 1337 tls pki localhost auth <users>
43 The regression suite needs to be run with root privileges, since it
44 has to spawn a subprocess that needs to `chroot(2)` itself. To run
49 The regression uses a custom DSL, `ninepscript`, to run the tests.
50 See `regress/sample.9ps` for an example of the grammar.
51 `contrib/9ps-mode.el` is the major mode for Emacs.
56 kamid is released under a BSD-like license. The bulk of the code is
57 under the ISC license, but some file are BSD2 or BSD3.