commit 4c8aba72674fb58e33258d14b008b3bd333c8a30 from: Omar Polo date: Sun Jan 23 19:30:11 2022 UTC improve and add pages commit - 8572765d6b9ea9c65cf519bded4928cf7b6e2920 commit + 4c8aba72674fb58e33258d14b008b3bd333c8a30 blob - 0b91cfaf53b533670b8c39e8ae77adcf6a0c6020 blob + 5b886be260ba198a414c7ba15666f0e6dc75b434 --- site/header.html +++ site/header.html @@ -1,7 +1,7 @@ - kamid + TITLE | kamid blob - f6e544b1666f432f7b3d04c571c73a2de208f75d blob + fdde85c49e7f5fbab4cc0a1c0844850e33529d1b --- site/index.gmi +++ site/index.gmi @@ -1,10 +1,22 @@ # kamid -kamid is a FREE, easy-to-use and portable implementation of a 9p file server daemon for UNIX-like systems. +kamid is a FREE, easy-to-use and portable implementation of a 9p file server daemon for UNIX-like systems. It has a strong focus on security and correctness but also tries to be an harbinger of novelty, like for 9p-over-TLS. -### Documentation +=> https://git.omarpolo.com/kamid git repository +=> https://github.com/omar-polo/kamid GitHub mirror +=> install.EXT Install guide +=> tutorial.EXT Tutorial + +## Kamid documentation + => 9p.7.MANEXT 9p.7: protocol documentation -=> kamictl.8.MANEXT kamictl.8: command line utility to manage the daemon -=> kamid.8.MANEXT kamid.8: daemon documentation -=> kamiftp.1.MANEXT kamiftp.1: ftp(1)-like command line utility +=> kamictl.8.MANEXT kamictl.8: command line utility to manage kamid +=> kamid.8.MANEXT kamid.8: 9p daemon documentation +=> kamiftp.1.MANEXT kamiftp.1: ftp(1)-like command line utility for 9p + +## Other useful links + +=> https://man.cat-v.org/plan_9/5/intro plan9 intro(5) +=> https://9p.cat-v.org/ 9p page on cat-v.org +=> https://9p.cat-v.org/documentation/rfc/ 9p "RFC" (not exactly but) blob - /dev/null blob + 3d24cae64d8ea2d4b7896bb107bad2b091db5c82 (mode 644) --- /dev/null +++ site/install.gmi @@ -0,0 +1,25 @@ +# kamid installation guide + +kamid has a short number of dependency, namely: + +* libtls +* libevent + +kamid uses the GNU autotools as build tool; assuming you have fetched either the release tarball or cloned locally the git repository, to build execute: + +``` +$ ./autogen.sh # not needed when using the tarball +$ ./configure +$ make +# make install # eventually +``` + +This should install a few programs: + +* kamid - the daemon itself +* kamictl - a comman-line utility to manage the daemon +* kamiftp - an ftp(1)-like 9p client + +and the relative manpages. + +=> tutorial.EXT To set it up, proceed to the tutorial. blob - /dev/null blob + d74d931af67933ed40d71e0ab568d5554fe00ece (mode 644) --- /dev/null +++ site/tutorial.gmi @@ -0,0 +1,3 @@ +# kamid setup guide + +TODO