glenda.party
term% ls -F
term% pwd
$home/manuals/9front/2/fauth
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)