PrevUpHomeUCL Common Library ReferenceNext

NETUDP

Name

NETUDP -- A UDP interface for IPv4 and IPv6.

Synopsis

#include <net_udp.h>

                    socket_udp;
int                 udp_addr_valid                      (const char *addr);
socket_udp *        udp_init                            (const char *addr,
                                                         uint16_t rx_port,
                                                         uint16_t tx_port,
                                                         int ttl);
socket_udp *        udp_init_if                         (const char *addr,
                                                         const char *iface,
                                                         uint16_t rx_port,
                                                         uint16_t tx_port,
                                                         int ttl);
void                udp_exit                            (socket_udp *s);
int                 udp_send                            (socket_udp *s,
                                                         char *buffer,
                                                         int buflen);
int                 udp_recv                            (socket_udp *s,
                                                         char *buffer,
                                                         int buflen);
int                 udp_select                          (struct timeval *timeout);
void                udp_fd_zero                         (void);
void                udp_fd_set                          (socket_udp *s);
int                 udp_fd_isset                        (socket_udp *s);
const char *        udp_host_addr                       (socket_udp *s);
int                 udp_fd                              (socket_udp *s);

Description

These functions provide a unified interface for sending are receiving UDP datagrams over IPv4 and IPv6 networks.

For IPv6 addresses to work the common library must be built with IPv6 enabled. On UNIX, the configure script has an option --enable-ip-v6 for this purpose. On Win32, there is a project configuration to use the Microsoft IPv6 stack when installed.

Details

socket_udp

typedef struct _socket_udp socket_udp;

An opaque data structure containing information for a UDP session.

udp_addr_valid ()

int                 udp_addr_valid                      (const char *addr);

addr :

string representation of IPv4 or IPv6 network address.

Returns :

TRUE if addr is valid, FALSE otherwise.

udp_init ()

socket_udp *        udp_init                            (const char *addr,
                                                         uint16_t rx_port,
                                                         uint16_t tx_port,
                                                         int ttl);

Creates a session for sending and receiving UDP datagrams over IP networks.

addr :

character string containing an IPv4 or IPv6 network address.

rx_port :

receive port.

tx_port :

transmit port.

ttl :

time-to-live value for transmitted packets.

Returns :

a pointer to a valid socket_udp structure on success, NULL otherwise.

udp_init_if ()

socket_udp *        udp_init_if                         (const char *addr,
                                                         const char *iface,
                                                         uint16_t rx_port,
                                                         uint16_t tx_port,
                                                         int ttl);

Creates a session for sending and receiving UDP datagrams over IP networks. The session uses iface as the interface to send and receive datagrams on.

addr :

character string containing an IPv4 or IPv6 network address.

iface :

character string containing an interface name.

rx_port :

receive port.

tx_port :

transmit port.

ttl :

time-to-live value for transmitted packets.

Returns :

a pointer to a socket_udp structure on success, NULL otherwise.

udp_exit ()

void                udp_exit                            (socket_udp *s);

Closes UDP session.

s :

UDP session to be terminated.

udp_send ()

int                 udp_send                            (socket_udp *s,
                                                         char *buffer,
                                                         int buflen);

Transmits a UDP datagram containing data from buffer.

s :

UDP session.

buffer :

pointer to buffer to be transmitted.

buflen :

length of buffer.

Returns :

0 on success, -1 on failure.

udp_recv ()

int                 udp_recv                            (socket_udp *s,
                                                         char *buffer,
                                                         int buflen);

Reads from datagram queue associated with UDP session.

s :

UDP session.

buffer :

buffer to read data into.

buflen :

length of buffer.

Returns :

number of bytes read, returns 0 if no data is available.

udp_select ()

int                 udp_select                          (struct timeval *timeout);

Waits for data to arrive for UDP sessions.

timeout :

maximum period to wait for data to arrive.

Returns :

number of UDP sessions ready for reading.

udp_fd_zero ()

void                udp_fd_zero                         (void);

Clears file descriptor from set associated with UDP sessions (see select(2)).

udp_fd_set ()

void                udp_fd_set                          (socket_udp *s);

Adds file descriptor associated of s to set associated with UDP sessions.

s :

UDP session.

udp_fd_isset ()

int                 udp_fd_isset                        (socket_udp *s);

Checks if file descriptor associated with UDP session is ready for reading. This function should be called after udp_select().

s :

UDP session.

Returns :

non-zero if set, zero otherwise.

udp_host_addr ()

const char *        udp_host_addr                       (socket_udp *s);

s :

UDP session.

Returns :

character string containing network address associated with session s.

udp_fd ()

int                 udp_fd                              (socket_udp *s);

This function allows applications to apply their own socketopt()'s and ioctl()'s to the UDP session.

s :

UDP session.

Returns :

file descriptor of socket used by session s.

<<< MD5RTP >>>