term% ls -F
term% cat index.txt
FSESSION(2)                   System Calls Manual                  FSESSION(2)

       fsession,  fauth - set up authentication on a file descriptor to a file

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

       int   fsession(int fd, char trbuf[TICKREQLEN])

       uchar fauth(int fd, char tbuf[2*TICKETLEN])

       The first time fsession is called for the connection referred to by fd,
       a  session (see attach(5)) message is exchanged with the file server at
       the other end of the connection.  Fsession  uses  the  information  re‐
       turned  by the file server and the id of the user to build a ticket re‐
       quest message returned in trbuf.  If the file server  requires  no  au‐
       thentication  or  the kernel already has authentication tickets for the
       current user for this connection, trbuf[0] is set to 0.  If not,  trbuf
       can  be used to obtain tickets from an authentication server.  Fsession
       should be called before any mount (see bind(2)) of fd.

       Fauth is used to pass authentication tickets to the kernel for the cur‐
       rent user.  The tickets are used to authenticate the user in any subse‐
       quent mounts of fd by that user.

       It is rare to use these functions directly; more commonly amount or au‐
       thenticate (see auth(2)) is used.


       attach(5), auth(2) (particularly amount), auth(6), auth(8)

       Sets errstr.