FSESSION(2) 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 con-
nection. Fsession uses the information returned by the file
server and the id of the user to build a ticket request mes-
sage 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. Fsession 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 subsequent 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.
Page 1 Plan 9 (printed 4/18/24)