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.

Plan 9  —  March 27, 2002