FAUTH(2)FAUTH(2)
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
attach(5),
auth(2)
(particularly
amount),
authsrv(6),
auth(8)
DIAGNOSTICS
Sets
errstr.