## Name

gfarm_initialize — Gfarm ライブラリを初期化する

## Synopsis

    #include <gfarm/gfarm.h>

`gfarm_error_t gfarm_initialize(` | argcp, |
| argvp`)`; |

`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)