table of contents
GFARM_INITIALIZE(3) | Gfarm | GFARM_INITIALIZE(3) |
NAME¶
gfarm_initialize - initialize the Gfarm execution environment for clientSYNOPSIS¶
#include <gfarm/gfarm.h>
gfarm_error_t gfarm_initialize(int *argcp, char *** argvp);
DESCRIPTION¶
gfarm_initialize() initializes the Gfarm execution environment for client application. This function should be called before any Gfarm library API. argcp is a pointer to the number of arguments and argvp is a pointer to the argument vector.RETURN VALUES¶
GFARM_ERR_NO_ERRORThe function terminated successfully.
GFARM_ERR_NO_MEMORY
Insufficient memory was available.
GFARM_ERR_UNKNOWN_HOST
The metadata server cannot be resolved.
GFARM_ERR_NETWORK_IS_UNREACHABLE
Network is unrechable.
GFARM_ERR_OPERATION_TIMED_OUT
Connetion timeout occurs.
GFARM_ERR_PROTOCOL
Protocol error occurs.
GFARM_ERR_BROKEN_PIPE
Connection to the metadata server is broken.
GFARM_ERR_PERMISSION_DENIED
The requested access to the file is not allowed, or one
of the directories in gfarm_url did not allow search (execute)
permission. Or, the authentication to the metadata server fails.
GFARM_ERR_PROTOCOL_NOT_SUPPORTED
Specified authentication protocol is not supported.
GFARM_ERR_AUTHENTICATION
User authentication failed when connecting to the
metadata server.
Others
An error except the above occurred. The reason is shown
by its gfarm_error_string(3).
SEE ALSO¶
gfarm_terminate(3)26 Jun 2010 | Gfarm |