.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "GFARM_INITIALIZE" "3" "26 June 2010" "Gfarm" ""

.SH NAME
gfarm_initialize \- Gfarm ライブラリを初期化する
.SH SYNOPSIS
.sp
\fB#include <gfarm/gfarm.h>
.sp
gfarm_error_t gfarm_initialize (int * \fIargcp\fB, char *** \fIargvp\fB);
\fR
.SH "DESCRIPTION"
.PP
Gfarm ライブラリを初期化します。
Gfarm ライブラリ API を利用する前に必ず呼ぶ必要があります。
引数には、プログラムの main 関数の
\fIargc\fR
引数へのポインタと、
\fIargv\fR
引数へのポインタを渡します。
.SH "RETURN VALUES"
.TP
\fBGFARM_ERR_NO_ERROR\fR
正常終了を示します。
.TP
\fBGFARM_ERR_NO_MEMORY\fR
メモリ不足のため処理を中止しました。
.TP
\fBGFARM_ERR_UNKNOWN_HOST\fR
指定されたメタデータサーバのアドレス解決ができません。
.TP
\fBGFARM_ERR_NETWORK_IS_UNREACHABLE\fR
メタデータサーバに到達できません。
.TP
\fBGFARM_ERR_OPERATION_TIMED_OUT\fR
メタデータサーバへの接続がタイムアウトをおこしました。
.TP
\fBGFARM_ERR_PROTOCOL\fR
メタデータサーバとの通信にプロトコルエラーが発生しました。
.TP
\fBGFARM_ERR_BROKEN_PIPE\fR
メタデータサーバとの通信が切断しました。
.TP
\fBGFARM_ERR_PERMISSION_DENIED\fR
メタデータサーバへの認証に失敗しました。
.TP
\fBGFARM_ERR_PROTOCOL_NOT_SUPPORTED\fR
指定された認証プロトコルはサポートしていません。
.TP
\fBGFARM_ERR_AUTHENTICATION\fR
メタデータサーバに対する認証に失敗しました。
.TP
\fBGFARM_ERR_NO_MEMORY\fR
メモリ不足のため処理を中止しました。
.TP
\fBその他\fR
上記以外のエラーが生じたことを示します。
\fBgfarm_error_string\fR(3)
によりエラーの原因を文字列に変換することができます。
.SH "SEE ALSO"
.PP
\fBgfarm_terminate\fR(3)