NAME

SYNOPSIS

#include <libdill.h>
int udp_open(
    struct ipaddr* local,
    struct ipaddr* remote);

    

DESCRIPTION

This function creates an UDP socket.

local: IP address to be used to set source IP address in outgoing packets. Also, the socket will receive packets sent to this address. If port in the address is set to zero an ephemeral port will be chosen and filled into the local address.

remote: IP address used as default destination for outbound packets. It is used when destination address in udp_send function is set to NULL. It is also used by msend and mrecv functions which don't allow to specify the destination address explicitly. Furthermore, if remote address is set, all the packets arriving from different addresses will be silently dropped.

To close this socket use hclose function.

This function is not available if libdill is compiled with --disable-sockets option.

RETURN VALUE

ERRORS

•

EADDRINUSE: The local address is already in use.

•

EADDRNOTAVAIL: The specified address is not available from the local machine.

•

EINVAL: Invalid argument.

•

EMFILE: The maximum number of file descriptors in the process are already open.

•

ENFILE: The maximum number of file descriptors in the system are already open.

•

ENOMEM: Not enough memory.

EXAMPLE

struct ipaddr local;
ipaddr_local(&local, NULL, 5555, 0);
struct ipaddr remote;
ipaddr_remote(&remote, "server.example.org", 5555, 0, -1);
int s = udp_open(&local, &remote);
udp_send(s1, NULL, "ABC", 3);
char buf[2000];
ssize_t sz = udp_recv(s, NULL, buf, sizeof(buf), -1);
hclose(s);

    

SEE ALSO