invoke(IAC)

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 pathname. If it is a tag, a full pathname 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: 0 for success and non-zero for failure.

References

getava(IAC)