libdill: Structured Concurrency for C

NAME

tcp_connect - create a connection to remote TCP endpoint

SYNOPSIS

#include <libdill.h>

int tcp_connect(const struct ipaddr *addr, int64_t deadline);

DESCRIPTION

TCP protocol is a bytestream protocol (i.e. data can be sent via bsend() and received via brecv()) for transporting data among machines.

Creates a connection to a peer specified by addr argument.

deadline is a point in time when the operation should time out. Use the now() function to get your current point in time. 0 means immediate timeout, i.e., perform the operation if possible or return without blocking if not. -1 means no deadline, i.e., the call will block forever if the operation cannot be performed.

The socket can be cleanly shut down using tcp_close() function.

RETURN VALUE

Newly created socket handle. On error, it returns -1 and sets errno to one of the values below.

ERRORS

EXAMPLE

int s = tcp_connect(&addr, -1);