term% cat index.txt FAUTH(2) System Calls Manual FAUTH(2)
NAME
fauth - set up authentication on a file descriptor to a file server
SYNOPSIS
#include <u.h>
#include <libc.h>
int fauth(int fd, char *aname)
DESCRIPTION
Fauth is used to establish authentication for the current user to ac‐
cess 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
used.
SOURCE
/sys/src/libc/9syscall
SEE ALSO
attach(5), auth(2) (particularly amount), authsrv(6), auth(8)
DIAGNOSTICS
Sets errstr.
FAUTH(2)