* Copyright (C) <2005,2009> Wim Taymans <wim.taymans@gmail.com>

#include <gst/gstconfig.h>

typedef struct _GstRTSPConnection GstRTSPConnection;

GstRTSPResult      gst_rtsp_connection_create        (const GstRTSPUrl *url, GstRTSPConnection **conn);

GstRTSPResult      gst_rtsp_connection_accept        (gint sock, GstRTSPConnection **conn);

/* HTTP proxy support */

GstRTSPResult      gst_rtsp_connection_set_proxy     (GstRTSPConnection *conn,

                                                      const gchar *host, guint port);

/* configure authentication data */

void               gst_rtsp_connection_set_auth_param    (GstRTSPConnection *conn,

		                                          const gchar * param,

							  const gchar *value);

void               gst_rtsp_connection_clear_auth_params (GstRTSPConnection *conn);

/* configure DSCP */

GstRTSPResult      gst_rtsp_connection_set_qos_dscp  (GstRTSPConnection *conn,

                                                      guint qos_dscp);

/* accessors */

GstRTSPUrl *       gst_rtsp_connection_get_url       (const GstRTSPConnection *conn);

const gchar *      gst_rtsp_connection_get_ip        (const GstRTSPConnection *conn);

void               gst_rtsp_connection_set_ip        (GstRTSPConnection *conn, const gchar *ip);

gint               gst_rtsp_connection_get_readfd    (const GstRTSPConnection *conn);

gint               gst_rtsp_connection_get_writefd   (const GstRTSPConnection *conn);

/* tunneling */

void               gst_rtsp_connection_set_tunneled  (GstRTSPConnection *conn, gboolean tunneled);

gboolean           gst_rtsp_connection_is_tunneled   (const GstRTSPConnection *conn);

const gchar *      gst_rtsp_connection_get_tunnelid  (const GstRTSPConnection *conn);

GstRTSPResult      gst_rtsp_connection_do_tunnel     (GstRTSPConnection *conn, GstRTSPConnection *conn2);

/* async IO */

/**

 * GstRTSPWatch:

 *

 * Opaque RTSP watch object that can be used for asynchronous RTSP

 * operations.

 */

typedef struct _GstRTSPWatch GstRTSPWatch;

/**

 * GstRTSPWatchFuncs:

 * @message_received: callback when a message was received

 * @message_sent: callback when a message was sent

 * @closed: callback when the connection is closed

 * @error: callback when an error occured

 * @tunnel_start: a client started a tunneled connection. The tunnelid of the

 *   connection must be saved.

 * @tunnel_complete: a client finished a tunneled connection. In this callback

 *   you usually pair the tunnelid of this connection with the saved one using

 *   gst_rtsp_connection_do_tunnel().

 *

 * Callback functions from a #GstRTSPWatch.

 *

 * Since: 0.10.23

 */

typedef struct {

  GstRTSPResult     (*message_received) (GstRTSPWatch *watch, GstRTSPMessage *message,

                                         gpointer user_data);

  GstRTSPResult     (*message_sent)     (GstRTSPWatch *watch, guint id,

                                         gpointer user_data);

  GstRTSPResult     (*closed)           (GstRTSPWatch *watch, gpointer user_data);

  GstRTSPResult     (*error)            (GstRTSPWatch *watch, GstRTSPResult result,

                                         gpointer user_data);

  GstRTSPStatusCode (*tunnel_start)     (GstRTSPWatch *watch, gpointer user_data);

  GstRTSPResult     (*tunnel_complete)  (GstRTSPWatch *watch, gpointer user_data);

  /*< private >*/

  gpointer _gst_reserved[GST_PADDING];

} GstRTSPWatchFuncs;

GstRTSPWatch *     gst_rtsp_watch_new                (GstRTSPConnection *conn,

                                                      GstRTSPWatchFuncs *funcs,

						      gpointer user_data,

						      GDestroyNotify notify);

void               gst_rtsp_watch_reset              (GstRTSPWatch *watch);

void               gst_rtsp_watch_unref              (GstRTSPWatch *watch);

guint              gst_rtsp_watch_attach             (GstRTSPWatch *watch,

                                                      GMainContext *context);

guint              gst_rtsp_watch_queue_data         (GstRTSPWatch * watch,

                                                      const guint8 * data,

                                                      guint size);

guint              gst_rtsp_watch_queue_message      (GstRTSPWatch *watch,

                                                      GstRTSPMessage *message);