mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-11-06 09:29:42 +00:00
Code Issues 1 Projects Releases Wiki Activity
gstreamer/subprojects/gst-rtsp-server/gst/rtsp-server/rtsp-address-pool.h

206 lines
6.8 KiB
C
Raw Normal View History

address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
/* GStreamer
* Copyright (C) 2012 Wim Taymans <wim.taymans at gmail.com>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef __GST_RTSP_ADDRESS_POOL_H__
#define __GST_RTSP_ADDRESS_POOL_H__
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
#include <gst/gst.h>
#include "rtsp-server-prelude.h"
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
G_BEGIN_DECLS
#define GST_TYPE_RTSP_ADDRESS_POOL (gst_rtsp_address_pool_get_type ())
#define GST_IS_RTSP_ADDRESS_POOL(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_RTSP_ADDRESS_POOL))
#define GST_IS_RTSP_ADDRESS_POOL_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_RTSP_ADDRESS_POOL))
#define GST_RTSP_ADDRESS_POOL_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GST_TYPE_RTSP_ADDRESS_POOL, GstRTSPAddressPoolClass))
#define GST_RTSP_ADDRESS_POOL(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_RTSP_ADDRESS_POOL, GstRTSPAddressPool))
#define GST_RTSP_ADDRESS_POOL_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_RTSP_ADDRESS_POOL, GstRTSPAddressPoolClass))
#define GST_RTSP_ADDRESS_POOL_CAST(obj) ((GstRTSPAddressPool*)(obj))
#define GST_RTSP_ADDRESS_POOL_CLASS_CAST(klass) ((GstRTSPAddressPoolClass*)(klass))
addresspool: return reason of failure Let gst_rtsp_address_pool_reserve_address() return the reason why the address could not be reserved. Fixes https://bugzilla.gnome.org/show_bug.cgi?id=708229
2013-09-24 15:30:18 +00:00
/**
* GstRTSPAddressPoolResult:
* @GST_RTSP_ADDRESS_POOL_OK: no error
* @GST_RTSP_ADDRESS_POOL_EINVAL:invalid arguments were provided to a function
* @GST_RTSP_ADDRESS_POOL_ERESERVED: the addres has already been reserved
* @GST_RTSP_ADDRESS_POOL_ERANGE: the address is not in the pool
* @GST_RTSP_ADDRESS_POOL_ELAST: last error
*
* Result codes from RTSP address pool functions.
*/
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;
rtsp: make address-pool return an address object Return a boxed GstRTSPAddress from the GstRTSPAddressPool. This allows us to store more info in the structure and allows us to more easily return the address to the right pool when no longer needed. Pass the address to the StreamTransport so that we can return it to the pool when the stream transport is freed or changed.
2012-11-15 12:25:14 +00:00
typedef struct _GstRTSPAddress GstRTSPAddress;
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
typedef struct _GstRTSPAddressPool GstRTSPAddressPool;
typedef struct _GstRTSPAddressPoolClass GstRTSPAddressPoolClass;
typedef struct _GstRTSPAddressPoolPrivate GstRTSPAddressPoolPrivate;
docs: update docs
2013-07-11 10:18:26 +00:00
/**
* GstRTSPAddress:
* @pool: the #GstRTSPAddressPool owner of this address
* @address: the address
* @port: the port number
* @n_ports: number of ports
* @ttl: TTL or 0 for unicast addresses
*
* An address
*/
rtsp: make address-pool return an address object Return a boxed GstRTSPAddress from the GstRTSPAddressPool. This allows us to store more info in the structure and allows us to more easily return the address to the right pool when no longer needed. Pass the address to the StreamTransport so that we can return it to the pool when the stream transport is freed or changed.
2012-11-15 12:25:14 +00:00
struct _GstRTSPAddress {
GstRTSPAddressPool *pool;
gchar *address;
guint16 port;
gint n_ports;
guint8 ttl;
docs: update docs
2013-07-11 10:18:26 +00:00
/*<private >*/
rtsp: make address-pool return an address object Return a boxed GstRTSPAddress from the GstRTSPAddressPool. This allows us to store more info in the structure and allows us to more easily return the address to the right pool when no longer needed. Pass the address to the StreamTransport so that we can return it to the pool when the stream transport is freed or changed.
2012-11-15 12:25:14 +00:00
gpointer priv;
};
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp: make address-pool return an address object Return a boxed GstRTSPAddress from the GstRTSPAddressPool. This allows us to store more info in the structure and allows us to more easily return the address to the right pool when no longer needed. Pass the address to the StreamTransport so that we can return it to the pool when the stream transport is freed or changed.
2012-11-15 12:25:14 +00:00
GType gst_rtsp_address_get_type (void);
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp: make address-pool return an address object Return a boxed GstRTSPAddress from the GstRTSPAddressPool. This allows us to store more info in the structure and allows us to more easily return the address to the right pool when no longer needed. Pass the address to the StreamTransport so that we can return it to the pool when the stream transport is freed or changed.
2012-11-15 12:25:14 +00:00
GstRTSPAddress * gst_rtsp_address_copy (GstRTSPAddress *addr);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp: make address-pool return an address object Return a boxed GstRTSPAddress from the GstRTSPAddressPool. This allows us to store more info in the structure and allows us to more easily return the address to the right pool when no longer needed. Pass the address to the StreamTransport so that we can return it to the pool when the stream transport is freed or changed.
2012-11-15 12:25:14 +00:00
void gst_rtsp_address_free (GstRTSPAddress *addr);
docs: update docs
2013-07-11 10:18:26 +00:00
/**
* GstRTSPAddressFlags:
* @GST_RTSP_ADDRESS_FLAG_NONE: no flags
* @GST_RTSP_ADDRESS_FLAG_IPV4: an IPv4 address
* @GST_RTSP_ADDRESS_FLAG_IPV6: and IPv6 address
* @GST_RTSP_ADDRESS_FLAG_EVEN_PORT: address with an even port
* @GST_RTSP_ADDRESS_FLAG_MULTICAST: a multicast address
* @GST_RTSP_ADDRESS_FLAG_UNICAST: a unicast address
*
* Flags used to control allocation of addresses
*/
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
typedef enum {
GST_RTSP_ADDRESS_FLAG_NONE = 0,
GST_RTSP_ADDRESS_FLAG_IPV4 = (1 << 0),
GST_RTSP_ADDRESS_FLAG_IPV6 = (1 << 1),
address-pool: Add unicast addresses
2013-02-19 21:34:16 +00:00
GST_RTSP_ADDRESS_FLAG_EVEN_PORT = (1 << 2),
GST_RTSP_ADDRESS_FLAG_MULTICAST = (1 << 3),
GST_RTSP_ADDRESS_FLAG_UNICAST = (1 << 4),
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
} GstRTSPAddressFlags;
address-pool: Add unicast addresses
2013-02-19 21:34:16 +00:00
/**
* GST_RTSP_ADDRESS_POOL_ANY_IPV4:
*
docs: small fixes
2013-07-16 10:36:56 +00:00
* Used with gst_rtsp_address_pool_add_range() to bind to all
address-pool: Add unicast addresses
2013-02-19 21:34:16 +00:00
* IPv4 addresses
*/
docs: update docs
2013-07-11 10:18:26 +00:00
#define GST_RTSP_ADDRESS_POOL_ANY_IPV4 "0.0.0.0"
address-pool: Add unicast addresses
2013-02-19 21:34:16 +00:00
/**
* GST_RTSP_ADDRESS_POOL_ANY_IPV6:
*
docs: small fixes
2013-07-16 10:36:56 +00:00
* Used with gst_rtsp_address_pool_add_range() to bind to all
address-pool: Add unicast addresses
2013-02-19 21:34:16 +00:00
* IPv6 addresses
*/
#define GST_RTSP_ADDRESS_POOL_ANY_IPV6 "::"
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
/**
* GstRTSPAddressPool:
* @parent: the parent GObject
*
docs: update docs
2013-07-11 10:18:26 +00:00
* An address pool, all member are private
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
*/
struct _GstRTSPAddressPool {
GObject parent;
docs: update docs
2013-07-11 10:18:26 +00:00
/*< private >*/
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
GstRTSPAddressPoolPrivate *priv;
rtsp-server: add padding to many public structures Not mini objects though, since they are not subclassable anyway, nor kept on the stack or inlined in a structure.
2013-12-12 00:36:07 +00:00
gpointer _gst_reserved[GST_PADDING];
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
};
docs: update docs
2013-07-11 10:18:26 +00:00
/**
* GstRTSPAddressPoolClass:
*
* Opaque Address pool class.
*/
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
struct _GstRTSPAddressPoolClass {
GObjectClass parent_class;
rtsp-server: add padding to many public structures Not mini objects though, since they are not subclassable anyway, nor kept on the stack or inlined in a structure.
2013-12-12 00:36:07 +00:00
/*< private >*/
gpointer _gst_reserved[GST_PADDING];
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
};
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
GType gst_rtsp_address_pool_get_type (void);
/* create a new address pool */
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
GstRTSPAddressPool * gst_rtsp_address_pool_new (void);
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
address-pool: add clear method
2012-11-14 15:17:33 +00:00
void gst_rtsp_address_pool_clear (GstRTSPAddressPool * pool);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
void gst_rtsp_address_pool_dump (GstRTSPAddressPool * pool);
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
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);
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp: make address-pool return an address object Return a boxed GstRTSPAddress from the GstRTSPAddressPool. This allows us to store more info in the structure and allows us to more easily return the address to the right pool when no longer needed. Pass the address to the StreamTransport so that we can return it to the pool when the stream transport is freed or changed.
2012-11-15 12:25:14 +00:00
GstRTSPAddress * gst_rtsp_address_pool_acquire_address (GstRTSPAddressPool * pool,
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
GstRTSPAddressFlags flags,
rtsp: make address-pool return an address object Return a boxed GstRTSPAddress from the GstRTSPAddressPool. This allows us to store more info in the structure and allows us to more easily return the address to the right pool when no longer needed. Pass the address to the StreamTransport so that we can return it to the pool when the stream transport is freed or changed.
2012-11-15 12:25:14 +00:00
gint n_ports);
address-pool: Add API to request a specific address from the pool Also add relevant unit tests.
2013-02-13 23:01:43 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
addresspool: return reason of failure Let gst_rtsp_address_pool_reserve_address() return the reason why the address could not be reserved. Fixes https://bugzilla.gnome.org/show_bug.cgi?id=708229
2013-09-24 15:30:18 +00:00
GstRTSPAddressPoolResult gst_rtsp_address_pool_reserve_address (GstRTSPAddressPool * pool,
const gchar *ip_address,
address-pool: Add API to request a specific address from the pool Also add relevant unit tests.
2013-02-13 23:01:43 +00:00
guint port,
guint n_ports,
addresspool: return reason of failure Let gst_rtsp_address_pool_reserve_address() return the reason why the address could not be reserved. Fixes https://bugzilla.gnome.org/show_bug.cgi?id=708229
2013-09-24 15:30:18 +00:00
guint ttl,
GstRTSPAddress ** address);
address-pool: Add API to request a specific address from the pool Also add relevant unit tests.
2013-02-13 23:01:43 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
address-pool: Add unicast addresses
2013-02-19 21:34:16 +00:00
gboolean gst_rtsp_address_pool_has_unicast_addresses (GstRTSPAddressPool * pool);
address-pool: Add API to request a specific address from the pool Also add relevant unit tests.
2013-02-13 23:01:43 +00:00
rtsp-server: Add g_autoptr() support to all types https://bugzilla.gnome.org/show_bug.cgi?id=754464
2015-11-10 19:17:18 +00:00
#ifdef G_DEFINE_AUTOPTR_CLEANUP_FUNC
G_DEFINE_AUTOPTR_CLEANUP_FUNC(GstRTSPAddress, gst_rtsp_address_free)
#endif
#ifdef G_DEFINE_AUTOPTR_CLEANUP_FUNC
G_DEFINE_AUTOPTR_CLEANUP_FUNC(GstRTSPAddressPool, gst_object_unref)
#endif
address-pool: add object to manage multicast addresses Make an object that can manage a rage of multicast addresses and ports.
2012-11-14 14:49:06 +00:00
G_END_DECLS
#endif /* __GST_RTSP_ADDRESS_POOL_H__ */
Reference in a new issue Copy permalink