fts_ftp_open_ex() - establish connection with the JP1/FTP daemon
- Organization of this page
Format
#include <apihead.h> int fts_ftp_open_ex( FTS_FTP_API_CONN_DATA *condata )
Function
This function establishes connection with the client's JP1/FTP daemon.
Arguments
condata
Specifies the address of the connection information structure. JP1/FTP connects to the JP1/FTP daemon according to the connection information.
Notes
-
Call this function before you call fts_ftp_syn_request_ex(), fts_ftp_asyn_request_ex(), and fts_ftp_close().
-
This function's return value is needed when you use other functions.
Return values
Socket handler |
Normal |
INVALID_SOCKET |
Abnormal |
A value indicating an error is set in fts_errno. The table below lists and describes the return values for error information. In the case of an error other than one listed below, the system function's error number is set. For details, see the displayed error number for the system function.
Return value of extended error information (decimal) |
Description |
Can be retried? |
---|---|---|
FTS_API_ERROR_UNDEFFTSHOST (805306112) |
The specified host name is not defined in the /etc/hosts file. |
No |
FTS_API_ERROR_CONNREFUSED (805306113) |
A connection request was rejected. The JP1/FTP daemon might not have been started. |
No |
FTS_API_ERROR_TIMEOUT (805306114) |
A connection request to the JP1/FTP daemon resulted in a timeout. The connection processing in the JP1/FTP daemon might be taking too long or the system on which the JP1/FTP daemon is supposed to be running might be down. |
Yes |
FTS_API_ERROR_UNREACH (805306115) |
Routing to the system on which the JP1/FTP daemon is running might have failed. |
No |
FTS_API_ERROR_DISCONNECT (805306116) |
A connection with the JP1/FTP daemon was released. If you want to register the transmission request again, you must start the processing over from fts_ftp_open_ex(). |
No |
FTS_API_ERROR_MEMORY (805306122) |
Memory allocation failed. |
No |
FTS_API_ERROR_UNDEFFTSSERV (805306123) |
The definition of Client (ftsc) for the JP1/FTP daemon is missing in the /etc/services file. |
No |
FTS_API_ERROR_MAXCONNECT (805306126) |
The maximum number of APIs that can be connected concurrently (maximum number of concurrent transmissions established through issuance of the fts_ftp_open_ex() function) has been reached. No more connections can be established until a connection is released by means of another API (through issuance of the fts_ftp_close() function). For details about the maximum number of concurrent transmissions, see ftsutil - changes and displays environment information in 6. Commands. |
Yes |
FTS_API_ERROR_LOGIC (805306128) |
A logical conflict error occurred in an API. |
No |