term% cat index.txt
FAUTH(2) System Calls Manual FAUTH(2)
fauth - set up authentication on a file descriptor to a file server
int fauth(int fd, char *aname)
Fauth is used to establish authentication for the current user to
access the resources available through the 9P connection represented by
fd. The return value is a file descriptor, conventionally called afd,
that is subsequently used to negotiate the authentication protocol for
the server, typically using auth_proxy or fauth_proxy (see auth(2)).
After successful authentication, afd may be passed as the second argu‐
ment to a subsequent mount call (see bind(2)), with the same aname, as
a ticket-of-entry for the user.
If fauth returns -1, the error case, that means the file server does
not require authentication for the connection, and afd should be set to
-1 in the call to mount.
It is rare to use fauth directly; more commonly amount (see auth(2)) is
attach(5), auth(2) (particularly amount), authsrv(6), auth(8)