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.