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.
GFARM_ERR_NO_ERRORThe function terminated successfully.
GFARM_ERR_NO_MEMORYInsufficient memory was available.
GFARM_ERR_UNKNOWN_HOSTThe metadata server cannot be resolved.
GFARM_ERR_NETWORK_IS_UNREACHABLENetwork is unrechable.
GFARM_ERR_OPERATION_TIMED_OUTConnetion timeout occurs.
GFARM_ERR_PROTOCOLProtocol error occurs.
GFARM_ERR_BROKEN_PIPEConnection to the metadata server is broken.
GFARM_ERR_PERMISSION_DENIEDThe 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_SUPPORTEDSpecified authentication protocol is not supported.
GFARM_ERR_AUTHENTICATIONUser authentication failed when connecting to the metadata server.
An error except the above occurred. The reason is shown by its gfarm_error_string(3).