Command Details: Connect
Category
Extended
Details
Command Code: | 14h |
Valid for: | Instance |
Description
For SOCK-DGRAM-sockets, this command specifies the peer with which the socket is to be associated (to which datagrams are sent and the only address from which datagrams are received).
For SOCK_STREAM-sockets, this command attempts to establish a connection to a host.
SOCK_STREAM-sockets may connect successfully only once, while SOCK_DGRAM-sockets may use this service multiple times to change their association. SOCK-DGRAM-sockets may dissolve their association by connecting to IP address 0.0.0.0, port 0 (zero).
- NON-BLOCKING mode:
This command must be issued repeatedly (polled) until a connection is connected, rejected or timed out. The command will return error code 22 (EINPROGRESS) on poll requests while attempting to connect.
- BLOCKING mode:
This command will block until a connection has been established or the connection request is cancelled due to a timeout or a connection error.
Command Details
Field
Contents
CmdExt[0]
(reserved, set to zero)
CmdExt[1]
Data[0]
Host IP address byte 4
Data[1]
Host IP address byte 3
Data[2]
Host IP address byte 2
Data[3]
Host IP address byte 1
Data[4]
Host port number (low byte)
Data[5]
Host port number (high byte)
Response Details
(no data)