#include <u.h>
#include <libc.h>

 int fauth(int fd, char *aname)
 DESCRIPTION

 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 argument 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 .