FSESSION(2) System Calls Manual FSESSION(2)
NAME
fsession, fauth - set up authentication on a file descriptor to a file server
SYNOPSIS
#include <u.h>
#include <libc.h>
#include <auth.h>
int fsession(int fd, char trbuf[TICKREQLEN])
uchar fauth(int fd, char tbuf[2*TICKETLEN])
DESCRIPTION
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 returned by the file server and the id of the user to build a ticket
request message returned in trbuf. If the file server requires no authentication 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. Fses-
sion should be called before any mount (see bind(2)) of fd.
Fauth is used to pass authentication tickets to the kernel for the current user. The tickets are used to authenticate the user in any sub-
sequent mounts of fd by that user.
It is rare to use these functions directly; more commonly amount or authenticate (see auth(2)) is used.
SOURCE
/sys/src/libc/9syscall
SEE ALSO
attach(5), auth(2) (particularly amount), auth(6), auth(8)
DIAGNOSTICS
Sets errstr.
FSESSION(2)