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.