invoke(3iac)
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(3iac)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004