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 access 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 argument 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. |