GST_RTSP_ADDRESS_POOL_ANY_IPV4

#define GST_RTSP_ADDRESS_POOL_ANY_IPV4  "0.0.0.0"

Used with gst_rtsp_address_pool_add_range() to bind to all IPv4 addresses

GST_RTSP_ADDRESS_POOL_ANY_IPV6

#define GST_RTSP_ADDRESS_POOL_ANY_IPV6  "::"

Used with gst_rtsp_address_pool_add_range() to bind to all IPv6 addresses

struct GstRTSPAddress

struct GstRTSPAddress {
  GstRTSPAddressPool *pool;

  gchar *address;
  guint16 port;
  gint n_ports;
  guint8 ttl;
};

An address

enum GstRTSPAddressFlags

typedef enum {
  GST_RTSP_ADDRESS_FLAG_NONE      = 0,
  GST_RTSP_ADDRESS_FLAG_IPV4      = (1 << 0),
  GST_RTSP_ADDRESS_FLAG_IPV6      = (1 << 1),
  GST_RTSP_ADDRESS_FLAG_EVEN_PORT = (1 << 2),
  GST_RTSP_ADDRESS_FLAG_MULTICAST = (1 << 3),
  GST_RTSP_ADDRESS_FLAG_UNICAST   = (1 << 4),
} GstRTSPAddressFlags;

Flags used to control allocation of addresses

gst_rtsp_address_copy ()

GstRTSPAddress *    gst_rtsp_address_copy               (GstRTSPAddress *addr);

Make a copy of addr.

gst_rtsp_address_free ()

void                gst_rtsp_address_free               (GstRTSPAddress *addr);

Free addr and releasing it back into the pool when owned by a pool.

struct GstRTSPAddressPool

struct GstRTSPAddressPool;

An address pool, all member are private

struct GstRTSPAddressPoolClass

struct GstRTSPAddressPoolClass {
  GObjectClass  parent_class;
};

Opaque Address pool class.

enum GstRTSPAddressPoolResult

typedef enum {
  GST_RTSP_ADDRESS_POOL_OK         =  0,
  /* errors */
  GST_RTSP_ADDRESS_POOL_EINVAL     = -1,
  GST_RTSP_ADDRESS_POOL_ERESERVED  = -2,
  GST_RTSP_ADDRESS_POOL_ERANGE     = -3,

  GST_RTSP_ADDRESS_POOL_ELAST      = -4,
} GstRTSPAddressPoolResult;

Result codes from RTSP address pool functions.

gst_rtsp_address_pool_new ()

GstRTSPAddressPool * gst_rtsp_address_pool_new          (void);

Make a new GstRTSPAddressPool.

gst_rtsp_address_pool_clear ()

void                gst_rtsp_address_pool_clear         (GstRTSPAddressPool *pool);

Clear all addresses in pool. There should be no outstanding allocations.

gst_rtsp_address_pool_dump ()

void                gst_rtsp_address_pool_dump          (GstRTSPAddressPool *pool);

Dump the free and allocated addresses to stdout.

gst_rtsp_address_pool_add_range ()

gboolean            gst_rtsp_address_pool_add_range     (GstRTSPAddressPool *pool,
                                                         const gchar *min_address,
                                                         const gchar *max_address,
                                                         guint16 min_port,
                                                         guint16 max_port,
                                                         guint8 ttl);

Adds the addresses from min_addess to max_address (inclusive) to pool. The valid port range for the addresses will be from min_port to max_port inclusive.

When ttl is 0, min_address and max_address should be unicast addresses. min_address and max_address can be set to GST_RTSP_ADDRESS_POOL_ANY_IPV4 or GST_RTSP_ADDRESS_POOL_ANY_IPV6 to bind to all available IPv4 or IPv6 addresses.

When ttl > 0, min_address and max_address should be multicast addresses.

gst_rtsp_address_pool_has_unicast_addresses ()

gboolean            gst_rtsp_address_pool_has_unicast_addresses
                                                        (GstRTSPAddressPool *pool);

Used to know if the pool includes any unicast addresses.

gst_rtsp_address_pool_acquire_address ()

GstRTSPAddress *    gst_rtsp_address_pool_acquire_address
                                                        (GstRTSPAddressPool *pool,
                                                         GstRTSPAddressFlags flags,
                                                         gint n_ports);

Take an address and ports from pool. flags can be used to control the allocation. n_ports consecutive ports will be allocated of which the first one can be found in port.

gst_rtsp_address_pool_reserve_address ()

GstRTSPAddressPoolResult gst_rtsp_address_pool_reserve_address
                                                        (GstRTSPAddressPool *pool,
                                                         const gchar *ip_address,
                                                         guint port,
                                                         guint n_ports,
                                                         guint ttl,
                                                         GstRTSPAddress **address);

Take a specific address and ports from pool. n_ports consecutive ports will be allocated of which the first one can be found in port.

If ttl is 0, address should be a unicast address. If ttl > 0, address should be a valid multicast address.