invoke(3I)                                                invoke(3I)


       NAME
             invoke - IAF function for invoking authentication schemes

       SYNOPSIS
             cc [options] files -liaf
             #include <iaf.h>
             int invoke (int fd, char *command);

       DESCRIPTION
             invoke is a library function that invokes authentication
             schemes within the framework of the Identification and
             Authentication Facility (IAF).

             fd indicates the file descriptor of the connection to be
             authenticated.  command is the command string used to invoke
             the scheme.  command can contain either a scheme tag or a full
             path name.  If it is a tag, a full path name to the default
             IAF directory is generated.  In either case, command can
             contain optional scheme-specific arguments.

             If the scheme succeeds, a value of 0 is returned.

          Return Values
             invoke returns -1 if the scheme aborts or cannot be executed;
             otherwise, it returns the exit value of the scheme, which is 0
             for success and non-zero for failure.

       REFERENCES
             getava(3I)



















                           Copyright 1994 Novell, Inc.               Page 1