Provided by:
debathena-liblocker-dev_10.0.1-0debathena2~ubuntu9.10_i386 
NAME
locker_auth, locker_auth_to_host, locker_auth_to_cell - Authenticate to
filesystems
SYNOPSIS
#include <locker.h>
int locker_auth(locker_context context,
char *filesystem, int op);
int locker_auth_to_host(locker_context context,
char *name, char *host, int op);
int locker_auth_to_cell(locker_context context,
char *name, char *cell, int op);
cc file.c -llocker ...
DESCRIPTION
These functions are used to authenticate to filesystems. For all of
these functions, the op argument is one of the following values defined
in locker.h:
LOCKER_AUTH_AUTHENTICATE
Authenticate to the filesystem.
LOCKER_AUTH_UNAUTHENTICATE
Suggest that liblocker dispose of authentication to the
filesystem. (The filesystem-specific code may ignore
this suggestion.)
LOCKER_AUTH_PURGEUSER
Ask the remote server to purge all mappings for the
user from all hosts. (Only meaningful for Kerberized
NFS.) This option can only be used by trusted users, as
specified in attach.conf(5)
LOCKER_AUTH_PURGE
Ask the remote server to purge all mappings for this
host. (Only meaningful for Kerberized NFS.)
locker_auth attempts to perform the given operation to the named
locker, which must be attached. locker_auth_to_host attempts a
Kerberized NFS authentication operation to the given host.
locker_auth_to_cell authenticates to the named AFS cell.
For locker_auth_to_host and locker_auth_to_cell, name is the name of a
locker or program which will be used in any error messages it prints.
RETURN VALUES
The auth functions can return the following values:
LOCKER_SUCCESS The operation was succesfully performed (or ignored).
LOCKER_EAUTH Authentication failed.
LOCKER_EUNKNOWN
No such filesystem.
LOCKER_EHESIOD Error looking up locker in Hesiod.
LOCKER_EPARSE Unable to parse filesystem description.
LOCKER_EPERM Untrusted user attempted privileged operation.
LOCKER_EATTACHTAB
Error creating or reading the attachtab entry
corresponding to this locker.
LOCKER_ENOMEM Memory was exhausted.
SEE ALSO
locker_init(3), locker_attach(3)
AUTHOR
Dan Winship, MIT Information Systems
Copyright 1998 by the Massachusetts Institute of Technology.
LOCKER_AUTH(3)