VCEでは2通りの方法でエラーを判別します。 ひとつは、vce_get_last_error 関数によってエラー番号を取得する方法、もうひとつは、エラーログ(vce_errout)に出力されている文字列をもとに判別する方法です。本文書では、その両方について説明します。
以下にVCEのエラーコードを列挙します。
以下の説明では、 vce.h の内容を引用しています。
#define VCE_NOERROR (0)エラーなし#define VCE_EGENERIC (-1)一般エラー#define VCE_EFULL (-2)バッファが一杯になった#define VCE_EBUG (-3)VCE内部のバグである可能性が高い#define VCE_ERANGE (-5)引数が範囲外である#define VCE_EINVAL (-6)引数が不正である#define VCE_EMEM (-7)メモリが足りない#define VCE_ENOENT (-8)検索でマッチしない、ファイルが見つからない#define VCE_EIO (-9)ソケットまたはファイルのI/Oエラー#define VCE_ESOCKET (-10)socketシステムコールが失敗した#define VCE_EBIND (-11)bindシステムコールが失敗した#define VCE_EIPADDR ( -12)IPアドレスの指定が間違っている#define VCE_ELISTEN (-13)listen()システムコールが失敗した#define VCE_ECONFIG (-14)設定値が異常である#define VCE_EHOSTNAME (-15)ホスト名が解決できない#define VCE_EFCNTL (-16)fcntl が失敗した#define VCE_ECONNECT (-17)connectシステムコールが失敗した#define VCE_EBUFSMALL (-18)指定されたバッファが小さすぎる#define VCE_EPROTO (-19)プロトコルのバイト列がおかしい#define VCE_ENOTREADY (-20)暗号ネゴシエーションが完了していないのにアクセスした#define VCE_ENEGO (-21)暗号ネゴシエーションが失敗した#define VCE_EPROTO_INVAL (-22)プロトコルの引数がおかしい#define VCE_EPROTO_ODD (-23)プロトコルの入力レコードの長さが異常である#define VCE_EPROTO_TOOLONG (-24)プロトコルの入力データが長すぎる#define VCE_ENOCALLBACK (-25)コールバック関数が未定義である#define VCE_ESUPPORT (-26)現在はサポートされていない#define VCE_ECONNSERIAL (-28)conn_tのシリアル番号が異なるためI/O不能#define VCE_EVECNOTREADY (-29)パケットベクトライザが準備できていない。#define VCE_EALIGNMENT (-32)指定されたオブジェクトのアラインメントがおかしい#define VCE_EFORMAT (-33)文字列のフォーマットが異常である#define VCE_ESEARCH (-34)サーチエンジン内部エラー#define VCE_ECONTENTLEN (-35)プロトコルのレコードのデータ部の長さがおかしい#define VCE_ECONNINIT (-36)コネクション表が初期化されていない#define VCE_EACCEPT (-38 )acceptシステムコールが失敗した#define VCE_ESETSOCKOPT (-39)setsockoptシステムコールが失敗した#define VCE_EACCESSFILE (-40)ファイルにアクセスできない#define VCE_EWINSOCKINIT (-41)Winsock の初期化に失敗(win32のみ)#define VCE_EWBFULL (-44)書きこみバッファがいっぱいになっている#define VCE_ELONGINPUT (-45)入力バッファが長すぎる#define VCE_ETOOSHORT (-46)入力バッファ短すぎる#define VCE_EPROTO_BADLEN (-47)プロトコルの入力レコードの長さが異常(クラックのうたがいあり)#define VCE_EPROTO_RESULT (-48)プロトコルでサーバがエラーを返している#define VCE_EPROTO_SERVERINVAL (-49)サーバが異常な値を返してきた(クラックのうたがいあり)#define VCE_EPROTO_BADCOMMAND (-50)そのようなプロトコルコマンドはない#define VCE_EFOPEN_W (-51)書きこみのためにファイルを開けない#define VCE_ERENAME (-52)rename(2) システムコールが失敗した#define VCE_ENOTFOUND (-54)何かが見つからない#define VCE_ELENTOOLONG (-55)長さの指定が大きすぎ#define VCE_EDATASHORT (-56)データ部分が短かすぎる#define VCE_EOPENDIR (-57)ディレクトリを開くことができない#define VCE_EFSEEK (-58)ファイルをfseekできない#define VCE_EFWRITE (-59)データをファイルに書きこめない#define VCE_EFREAD (-60)データをファイルから読めない#define VCE_EMKDIR (-61)ディレクトリを作れなかった#define VCE_EALREADY (-62)同じ処理は2度できない。重複している。#define VCE_EFINALIZE (-63)VCEを解放するときのエラー。正しく解放されなかったため、メモリがリークしている可能性がある(VCEのバグか、使用方法の間違い)#define VCE_ECLOSED (-64)すでにコネクション等が閉じられているのにアクセスしようとした#define VCE_EGENCOMMAND (-65)genのプロトコル定義ファイルで定義されていない関数IDが呼び出された#define VCE_ENOCRYPTO (-66)そのようなブロック鍵暗号アルゴリズムは存在しない#define VCE_ETOOLONGNAME (-67)指定された名前は、長すぎる#define VCE_ESIZE (-68)指定されたサイズは異常#define VCE_EINIT (-78)VCE が初期化されていないのに VCE の関数を呼ぼうとした。#define VCE_EARRAY (-79)VCE が内部で必要としている配列エンジンが不足している。vce_initialize_limited 関数で max_array メンバを調整するとよい。
VCEがログに吐きだすメッセージには、Fatal,Warning,Bug,Note の4種類があります。
すべてのメッセージには番号が振られていて、Fatalは1000番台、Warning は4000番台、Bugは7000番台、Noteは10000番台がわりあてられています。 すべて、 vce.h でマクロとして定義されています。
スクリプト言語などをもちいてサーバログをパースして利用するときには、 "Fatal:1101"のような番号のみを手がかりとするように注意してください。
Fatalエラーメッセージは、主にアプリケーションがVCEの利用方法を間違っているか、 OSの設定が不足している(ポートの問題や、空きメモリ、パーミッションの問題など) が原因です。細かく原因を追及していくと解決できるはずです。
Fatal:1000 cannot initialize winsockWinsock を初期化できないFatal:1003 array table scarcity (init_array)配列表の残り数が不足している。 vce_init_array の回数が多すぎる。 配列リークしていないかチェックせよ。Fatal:1010 MALLOC fail (index=%d)MALLOC ( malloc のラッパ) が失敗してマスターバッファを確保できない。Fatal:1011 MALLOC fail (index=%d)MALLOC ( malloc のラッパ) が失敗してエントリリストを確保できない。Fatal:1012 MALLOC fail (index=%d)MALLOC ( malloc のラッパ) が失敗して使用リストを確保できない。Fatal:1020 array full in %s配列の空き要素がひとつもない。予期せずこれが出力されたときは vce_free_array_object し忘れを確認せよFatal:1050 odd buffer size: %dバッファサイズが、「割りきれない数」になっている。Fatal:1080 please set buffer with length of n*256 bytes.256の倍数以外の長さをもつバッファです。Fatal:1200 tcp: no more connections are availabeTCPのコネクションが、VCEの最大接続数制限にひっかかってそれ以上増やせない。Fatal:1202 tcp: bad encryption type specified:%dvce_tcpcontext_create の crypt 引数の値は0か1のみFatal:1203 need a parser when creating tcpcontextvce_tcpcontext_create するときには、すくなくてもパーサ関数は指定する必要がある。そうでないとソケットからの入力をどう処理すべきかが定義されないまま放置されることになる。Fatal:1204 socket() fail addr:%s port:%d os_errno:%ssocket() システムコールが失敗しているため、その状況をCライブラリのエラー番号で返すFatal:1205 gethostbyname() error: %sgethostbyname関数が失敗している。Cライブラリのエラー出力も表示します。Fatal:1206 gethostbyname() error: %sgethostbyname関数が失敗している。Cライブラリのエラー出力も表示します。Fatal:1207 bind() error. os_errno:%s addr:%s port:%dbind関数が失敗している。Fatal:1208 listen() error. os_errno:%s addr:%s port:%dlisten関数が失敗している。Fatal:1209 setsockopt() fail. os_errno:%ssetsockopt関数が失敗した。Fatal:1210 gethostbyname() error: %sgethostbyname関数が失敗している。Cライブラリのエラー出力も表示します。Fatal:1212 fcntl fail: %sfcntl 関数が失敗した。Fatal:1213 setsockopt() fail: %ssetsockopt関数が失敗した。Fatal:1256 pointer to tcpcontext is nulltcpcontext を指すポインタがNULLです。Sanityチェックにひっかかっている。Fatal:1260 win32 fatal: gethostbyname() error:%sWinsockにおいて、 gethostbyname が失敗した。Fatal:1265 Memory shortage when creating tcpcontext state buffervce_tcpcontext_create において、メモリが不足しているため、状態つきプロトコル用の状態管理メモリを確保できなかった。Fatal:1277 setsockopt(SO_REUSEADDR) fail:%sSO_REUSEADDR の設定に失敗した。
Warningメッセージは、とりあえずVCEは動作を続けられるが、今後他の資源の枯渇や処理性能の低下を招く可能性がある場合に出力されます。
Warning:4000 freeing null pointer in %sヌルポインタをfree しようとしている。Warning:4001 freeing an out-of-bound element in %s address:%p master-address:%p解放しようとしている要素は、配列のメモリ領域の外側に位置している。Warning:4002 freeing an oddly-aligned element in %s address:%p master-address:%p sizeof:%u解放しようとしている要素は、配列の要素でない別なバッファへのポインタです。Warning:4003 freeing an out-of-bound element in %s address:%p master-address:%p sizeof:%u解放しようとしている要素は、配列のメモリ領域の外側に位置している。Warning:4100 tcp: only %d connections are usableVCEのコネクション数制限にひっかかるため、表示の本数しか利用できません。Warning:4101 tcp: accept() error. os_errno:%s port:%daccept()エラー。Warning:4102 tcp: conn_alloc fail no more accept. max:%d port:%dVCEが管理できるコネクションの数の最大に達しているため、これ以上TCPコネクションを追加(accept)できない。Warning:4103 tcp: acceptwatcher fail fd:%dacceptwatcher として指定されている関数がエラーを返した。Warning:4104 select() returns %d: %sselect()が不正な値を返した。Warning:4105 connection timeout. fd:%d sec:%dコネクションが、クライアントの調子がわるいせいでタイムアウトしてしまった。タイムアウトの値は、vce_tcpcontext_create 関数の呼びだしの時点で指定されている。Warning:4215 winsock select() returns SOCKET_ERROR, and WSAGetLastError:%dWinsockにおいて select がエラーコードを返している。Warning:4214 re-freeing an element in %s address:%p同じ要素を2回解放しようとしている。アプリケーションが2回free_array_object を呼びだした可能性が高い。Warning:4225 vce_tcpcontext_create: reached max connection num %dtcpコンテキストに設定された最大接続数に到達してしまった。Warning:4300 vce_conn_io: conn does not have parser function. use vce_tcpcontext_set_conn_parserTCPコネクション conn が、パーサを持っていない。vce_tcpcontext_set_conn_parser を用いてパーサを設定しないとデータ入力に対する処理ができない。
Bugメッセージは、VCE自体のバグが疑われる内部エラーです。
Bug:7000 blank-list stack overflow: %s配列の空きリストの管理異常。Bug:7002 use flag is 0! in %s address:%pvce_show_array_usage 関数の配列 sanity チェック時のエラーBug:7003 usenum doesn't match in %s stack:%d link_inuse:%d使用中カウントの数が、スタックが実際に伸びている長さと異なる。Bug:7010 tcp: nobuf?TCP用の空きバッファが、空いてるはずが、不足している。Bug:7011 tcp: nomem?TCP用の空きメモリが、確保されてるはずが、不足している。Bug:7109 state buffer is full.(accept)コネクションは一杯でないのに、状態管理バッファだけ一杯になっている。あきらかに、VCEのバグです。Bug:7112 connect: statebuf shortagevce_tcpcontext_connect するときに、状態管理バッファだけ一杯になっている。これはVCEのバグです。
Noteメッセージは、VCEを verbose モードに設定したときだけ出力される。 VCE が Fatal や Warning のメッセージを出力しているときに、それらに対してデバッグしたいときや、VCE の動作を詳細にログしたいときに verbose モードに設定して Noteメッセージを出力させ、デバッグに役立てることができる。
Note:10001 NOOP PROTOCOL: %d bytes from conn_t. serial:%dNOOP プロトコルでデータを受信した。Note:10002 DUMP PROTOCOL: %d bytes from conn_t. serial:%dDUMP プロトコルでデータを受信した。Note:10200 new connection fd:%d I:%d sbuflen:%d新規コネクションをacceptしたNote:10201 non blocking connect().コネクションをnon blocking に設定したNote:10202 connect ok on %dconnect()が成功したNote:10220 malloc(%u) returns %pmalloc が値を返したNote:10221 free(%p)freeしたNote:10310 init_array OK index:%d bufmaster:%p size:%u num:%d name:%s配列を初期化した。Note:10320 conn_t detected EOF on fd %dTCPにおいて read が 0 を返したNote:10321 conn_t detected read error on fd %dTCPにおいて read が -1 を返したNote:10322 conn_t detected write error on fd %d (%s)TCPにおいて write が-1 を返した。errno の値を表示。Note:10323 conn_t detected encryption negotiation error on fd %d error code:%d暗号化セッションの初期化ネゴシエーションに失敗、セッション成立せずNote:10326 conn_t detected protocol error on fd %d error code: %dプロトコル関数(vce_protocol_parser_bin16など)がエラーコード(負)を返したNote:10342 allocated state buffer for conn.コネクションに対して状態管理バッファを割りあてた。Note:10345 vce_tcpcontext_create could allocate state buffer.vce_tcpcontext_create 関数は、無事に状態管理バッファをわりあてることができた。Note:10347 freed state buffer for conn状態管理バッファを解放できた。Note:10400: vce: finalizedVCEが正常に終了した。 vce_finalize 関数が成功すると出力される。