term% cat index.txt 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 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.
SOURCE
/sys/src/libc/9syscall
SEE ALSO
attach(5), auth(2) (particularly amount), auth(6), auth(8)
DIAGNOSTICS
Sets errstr.
FSESSION(2)