[9fans] authsrv(6)

[Lucio De Re]

I'm convinced that the released authsrv(6) man page is out of date:
it refers to /dev/authenticator in the "remote execution" section
whereas factotum(4) suggests it ought to be referring to "p9sk2".

I'm battling to get an auth server to accept drawterm connections
(I get "i/o count too small" errors from writing to /dev/capuse
for reasons I cannot quite understand) and I was hoping authsrv(6)
would provide at least part of the explanation.

Perhaps the HTML version of that man page can be installed on the
web server?

Alternatively, what is the most likely reason for the capability
being written by cpu to capuse being too short?

I don't quite understand the interaction of factotum and authsrv,
am I right in assuming that drawterm interacts with authsrv which
in turn interacts with factotum, which then somehow interacts with
the keyfs?

A short explanation would be most welcome, sorry if I'm being dense.
I also find guard.srv's role quite obscure, but I think it would
be less confusing if I could understand how authsrv works.

And should the keyfs files be mode 777 with owner and group "auth"?
No such user exists in /adm/users.

++L