fts_ftp_open()JP1/FTPデーモンとのコネクション確立

形式

#include <apihead.h>
int fts_ftp_open(char *hostname)

機能

クライアント側のJP1/FTPデーモンとのコネクションを確立します。

引数

hostname

クライアント側のJP1/FTPデーモンが動作しているマシンのホスト名を指定します。NULLを指定した場合は,自ホスト名(OSのhostnameコマンドが返すホスト名:物理ホスト)が仮定されます。

FTPクライアントの自IPアドレス指定を有効にした場合,この引数での指定がFTPクライアントの自IPアドレスになります。NULLを指定した場合は,物理ホストのアドレスになります。

FTPクライアントの自IPアドレス指定を無効にした場合,FTPクライアントの自IPアドレスは,OSが自動的に割り当てるアドレスになります。FTPクライアントの自IPアドレス指定を有効にする方法については,「3.15 複数IPアドレス環境での使用」を参照してください。

注意事項

戻り値

ソケットハンドラ正常
INVALID_SOCKET異常

エラーを示す値は,fts_errnoにセットされます。エラー情報の戻り値を次の表に示します。また,下記以外のエラーの場合には,システム関数のエラー番号がセットされていますので,システム関数のエラー番号を参照してください。

拡張エラー情報の戻り値
(10進数)
説明リトライの可否
FTS_API_ERROR_UNDEFFTSHOST
(805306112)
指定したホスト名は/etc/hostsファイルで定義されていません。
FTS_API_ERROR_CONNREFUSED
(805306113)
接続要求が拒否されました。JP1/FTPデーモンが開始されていない場合があります。
FTS_API_ERROR_TIMEOUT
(805306114)
JP1/FTPデーモンへの接続要求がタイムアウトしました。JP1/FTPデーモンで接続処理に時間が掛かっているか,JP1/FTPデーモンが動作するマシンが停止している場合があります。
FTS_API_ERROR_UNREACH
(805306115)
JP1/FTPデーモンが動作するマシンへルーティングされていない場合があります。
FTS_API_ERROR_DISCONNECT
(805306116)
JP1/FTPデーモンとのコネクションが切断されました。伝送要求を再度登録したい場合は,ftp_ftp_open()から処理をし直す必要があります。
FTS_API_ERROR_MEMORY
(805306122)
メモリを確保できません。
FTS_API_ERROR_UNDEFFTSSERV
(805306123)
/etc/servicesファイルでJP1/FTPデーモンのClient (ftsc)の定義がされていません。
FTS_API_ERROR_MAXCONNECT
(805306126)
同時に接続(fts_ftp_open()を発行)できるAPIの数(最大同時伝送数)を超えました。ほかのAPIが接続を切断(fts_ftp_close()を発行)するまで接続できません。最大同時伝送数については,「6. コマンド」の「ftsutil-環境情報の変更・表示-」を参照してください。