26 Jun 2010
gfarm_initialize 3 Gfarm
gfarm_initialize Gfarm ライブラリを初期化する

    #include <gfarm/gfarm.h>

`gfarm_error_t gfarm_initialize` int * argcp char *** argvp

## DESCRIPTION

Gfarm ライブラリを初期化します。 Gfarm ライブラリ API を利用する前に必ず呼ぶ必要があります。 引数には、プログラムの main 関数の argc 引数へのポインタと、 argv 引数へのポインタを渡します。

## RETURN VALUES

`GFARM_ERR_NO_ERROR`

  正常終了を示します。

`GFARM_ERR_NO_MEMORY`

  メモリ不足のため処理を中止しました。

`GFARM_ERR_UNKNOWN_HOST`

  指定されたメタデータサーバのアドレス解決ができません。

`GFARM_ERR_NETWORK_IS_UNREACHABLE`

  メタデータサーバに到達できません。

`GFARM_ERR_OPERATION_TIMED_OUT`

  メタデータサーバへの接続がタイムアウトをおこしました。

`GFARM_ERR_PROTOCOL`

  メタデータサーバとの通信にプロトコルエラーが発生しました。

`GFARM_ERR_BROKEN_PIPE`

  メタデータサーバとの通信が切断しました。

`GFARM_ERR_PERMISSION_DENIED`

  メタデータサーバへの認証に失敗しました。

`GFARM_ERR_PROTOCOL_NOT_SUPPORTED`

  指定された認証プロトコルはサポートしていません。

`GFARM_ERR_AUTHENTICATION`

  メタデータサーバに対する認証に失敗しました。

`GFARM_ERR_NO_MEMORY`

  メモリ不足のため処理を中止しました。

その他

  上記以外のエラーが生じたことを示します。 gfarm_error_string 3 によりエラーの原因を文字列に変換することができます。

## SEE ALSO

gfarm_terminate 3