1 # kamid -- 9p file server daemon
2 
3 kamid is a FREE, easy-to-use and portable implementation of a 9p file
4 server daemon for UNIX-like systems.
5 
6 
7 ## Building
8 
9 kamid depends on libtls, libevent and yacc/GNU bison.  To build from a
10 release tarball:
11 
12 	./configure
13 	make
14 	sudo make install # eventually
15 
16 to build from a git checkout:
17 
18 	./bootstrap
19 	./configure
20 	make
21 
22 
23 ## Usage
24 
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.
28 
29 A sample configuration file:
30 
31 ```
32 pki localhost cert "/path/to/localhost.crt"
33 pki localhost key  "/path/to/localhost.key"
34 
35 table users { "SHA256:..." => "op" }
36 
37 # should be <users> but there's currently a bug in the parser so...
38 listen on localhost port 1337 tls pki localhost auth < users >
39 ```
40 
41 
42 ## Testing
43 
44 `ninepscript` is a custom DSL used to tests kamid.  It's a fairly
45 simple scripting language built to simulate various scenarios.
46 
47 
48 ## License
49 
50 kamid is released under a BSD-like license.  The bulk of the code is
51 under the ISC license, but some file are BSD2 or BSD3.