FAUTH(2)                                                 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 access the resources available through the 9P con-
          nection 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.