eCosPro® Reference Manual
Prev |  | Next

# tcp_connect()

## Name

tcp_connect() -- Open connection to remote host

## Synopsis

`err_t tcp_connect`(struct tcp_pcb *pcb, struct ip_addr *ipaddr, u16_t port, err_t (*connected) (void *arg, struct tcp_pcb *tpcb, err_t err));

## Description

Sets up pcb to connect to the remote host indicated by ipaddr on port port and sends the initial SYN segment which opens the connection.

The `tcp_connect()` function returns immediately; it does not wait for the connection to be properly set up. Instead, it will call the `connected()` function specified as the fourth argument when the connection is established. If the connection could not be properly established, either because the other host refused the connection or because the other host didn't answer, the `connected()` function will be called with its err argument set accordingly.

## Return value

The `tcp_connect()` function can return `ERR_MEM` if no memory is available for enqueueing the SYN segment. If the SYN indeed was enqueued successfully, the `tcp_connect()` function returns `ERR_OK`.

Prev | Home | Next
tcp_accept() | Up | Sending TCP data