Add handle-response signal for when we receive a GET_PARAMETER response
[platform/upstream/gstreamer.git] / gst / rtsp-server / rtsp-client.c
1 /* GStreamer
2  * Copyright (C) 2008 Wim Taymans <wim.taymans at gmail.com>
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Library General Public
6  * License as published by the Free Software Foundation; either
7  * version 2 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Library General Public License for more details.
13  *
14  * You should have received a copy of the GNU Library General Public
15  * License along with this library; if not, write to the
16  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
17  * Boston, MA 02110-1301, USA.
18  */
19 /**
20  * SECTION:rtsp-client
21  * @short_description: A client connection state
22  * @see_also: #GstRTSPServer, #GstRTSPThreadPool
23  *
24  * The client object handles the connection with a client for as long as a TCP
25  * connection is open.
26  *
27  * A #GstRTSPClient is created by #GstRTSPServer when a new connection is
28  * accepted and it inherits the #GstRTSPMountPoints, #GstRTSPSessionPool,
29  * #GstRTSPAuth and #GstRTSPThreadPool from the server.
30  *
31  * The client connection should be configured with the #GstRTSPConnection using
32  * gst_rtsp_client_set_connection() before it can be attached to a #GMainContext
33  * using gst_rtsp_client_attach(). From then on the client will handle requests
34  * on the connection.
35  *
36  * Use gst_rtsp_client_session_filter() to iterate or modify all the
37  * #GstRTSPSession objects managed by the client object.
38  *
39  * Last reviewed on 2013-07-11 (1.0.0)
40  */
41
42 #include <stdio.h>
43 #include <string.h>
44
45 #include "rtsp-client.h"
46 #include "rtsp-sdp.h"
47 #include "rtsp-params.h"
48
49 #define GST_RTSP_CLIENT_GET_PRIVATE(obj)  \
50    (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GST_TYPE_RTSP_CLIENT, GstRTSPClientPrivate))
51
52 /* locking order:
53  * send_lock, lock, tunnels_lock
54  */
55
56 struct _GstRTSPClientPrivate
57 {
58   GMutex lock;                  /* protects everything else */
59   GMutex send_lock;
60   GstRTSPConnection *connection;
61   GstRTSPWatch *watch;
62   guint close_seq;
63   gchar *server_ip;
64   gboolean is_ipv6;
65
66   GstRTSPClientSendFunc send_func;      /* protected by send_lock */
67   gpointer send_data;           /* protected by send_lock */
68   GDestroyNotify send_notify;   /* protected by send_lock */
69
70   GstRTSPSessionPool *session_pool;
71   GstRTSPMountPoints *mount_points;
72   GstRTSPAuth *auth;
73   GstRTSPThreadPool *thread_pool;
74
75   /* used to cache the media in the last requested DESCRIBE so that
76    * we can pick it up in the next SETUP immediately */
77   gchar *path;
78   GstRTSPMedia *media;
79
80   GList *transports;
81   GList *sessions;
82 };
83
84 static GMutex tunnels_lock;
85 static GHashTable *tunnels;     /* protected by tunnels_lock */
86
87 #define DEFAULT_SESSION_POOL            NULL
88 #define DEFAULT_MOUNT_POINTS            NULL
89
90 enum
91 {
92   PROP_0,
93   PROP_SESSION_POOL,
94   PROP_MOUNT_POINTS,
95   PROP_LAST
96 };
97
98 enum
99 {
100   SIGNAL_CLOSED,
101   SIGNAL_NEW_SESSION,
102   SIGNAL_OPTIONS_REQUEST,
103   SIGNAL_DESCRIBE_REQUEST,
104   SIGNAL_SETUP_REQUEST,
105   SIGNAL_PLAY_REQUEST,
106   SIGNAL_PAUSE_REQUEST,
107   SIGNAL_TEARDOWN_REQUEST,
108   SIGNAL_SET_PARAMETER_REQUEST,
109   SIGNAL_GET_PARAMETER_REQUEST,
110   SIGNAL_HANDLE_RESPONSE,
111   SIGNAL_LAST
112 };
113
114 GST_DEBUG_CATEGORY_STATIC (rtsp_client_debug);
115 #define GST_CAT_DEFAULT rtsp_client_debug
116
117 static guint gst_rtsp_client_signals[SIGNAL_LAST] = { 0 };
118
119 static void gst_rtsp_client_get_property (GObject * object, guint propid,
120     GValue * value, GParamSpec * pspec);
121 static void gst_rtsp_client_set_property (GObject * object, guint propid,
122     const GValue * value, GParamSpec * pspec);
123 static void gst_rtsp_client_finalize (GObject * obj);
124
125 static GstSDPMessage *create_sdp (GstRTSPClient * client, GstRTSPMedia * media);
126 static void client_session_finalized (GstRTSPClient * client,
127     GstRTSPSession * session);
128 static void unlink_session_transports (GstRTSPClient * client,
129     GstRTSPSession * session, GstRTSPSessionMedia * sessmedia);
130 static gboolean default_configure_client_transport (GstRTSPClient * client,
131     GstRTSPContext * ctx, GstRTSPTransport * ct);
132 static GstRTSPResult default_params_set (GstRTSPClient * client,
133     GstRTSPContext * ctx);
134 static GstRTSPResult default_params_get (GstRTSPClient * client,
135     GstRTSPContext * ctx);
136
137 G_DEFINE_TYPE (GstRTSPClient, gst_rtsp_client, G_TYPE_OBJECT);
138
139 static void
140 gst_rtsp_client_class_init (GstRTSPClientClass * klass)
141 {
142   GObjectClass *gobject_class;
143
144   g_type_class_add_private (klass, sizeof (GstRTSPClientPrivate));
145
146   gobject_class = G_OBJECT_CLASS (klass);
147
148   gobject_class->get_property = gst_rtsp_client_get_property;
149   gobject_class->set_property = gst_rtsp_client_set_property;
150   gobject_class->finalize = gst_rtsp_client_finalize;
151
152   klass->create_sdp = create_sdp;
153   klass->configure_client_transport = default_configure_client_transport;
154   klass->params_set = default_params_set;
155   klass->params_get = default_params_get;
156
157   g_object_class_install_property (gobject_class, PROP_SESSION_POOL,
158       g_param_spec_object ("session-pool", "Session Pool",
159           "The session pool to use for client session",
160           GST_TYPE_RTSP_SESSION_POOL,
161           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
162
163   g_object_class_install_property (gobject_class, PROP_MOUNT_POINTS,
164       g_param_spec_object ("mount-points", "Mount Points",
165           "The mount points to use for client session",
166           GST_TYPE_RTSP_MOUNT_POINTS,
167           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
168
169   gst_rtsp_client_signals[SIGNAL_CLOSED] =
170       g_signal_new ("closed", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
171       G_STRUCT_OFFSET (GstRTSPClientClass, closed), NULL, NULL,
172       g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0, G_TYPE_NONE);
173
174   gst_rtsp_client_signals[SIGNAL_NEW_SESSION] =
175       g_signal_new ("new-session", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
176       G_STRUCT_OFFSET (GstRTSPClientClass, new_session), NULL, NULL,
177       g_cclosure_marshal_VOID__OBJECT, G_TYPE_NONE, 1, GST_TYPE_RTSP_SESSION);
178
179   gst_rtsp_client_signals[SIGNAL_OPTIONS_REQUEST] =
180       g_signal_new ("options-request", G_TYPE_FROM_CLASS (klass),
181       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRTSPClientClass, options_request),
182       NULL, NULL, g_cclosure_marshal_VOID__POINTER, G_TYPE_NONE, 1,
183       G_TYPE_POINTER);
184
185   gst_rtsp_client_signals[SIGNAL_DESCRIBE_REQUEST] =
186       g_signal_new ("describe-request", G_TYPE_FROM_CLASS (klass),
187       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRTSPClientClass, describe_request),
188       NULL, NULL, g_cclosure_marshal_VOID__POINTER, G_TYPE_NONE, 1,
189       G_TYPE_POINTER);
190
191   gst_rtsp_client_signals[SIGNAL_SETUP_REQUEST] =
192       g_signal_new ("setup-request", G_TYPE_FROM_CLASS (klass),
193       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRTSPClientClass, setup_request),
194       NULL, NULL, g_cclosure_marshal_VOID__POINTER, G_TYPE_NONE, 1,
195       G_TYPE_POINTER);
196
197   gst_rtsp_client_signals[SIGNAL_PLAY_REQUEST] =
198       g_signal_new ("play-request", G_TYPE_FROM_CLASS (klass),
199       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRTSPClientClass, play_request),
200       NULL, NULL, g_cclosure_marshal_VOID__POINTER, G_TYPE_NONE, 1,
201       G_TYPE_POINTER);
202
203   gst_rtsp_client_signals[SIGNAL_PAUSE_REQUEST] =
204       g_signal_new ("pause-request", G_TYPE_FROM_CLASS (klass),
205       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRTSPClientClass, pause_request),
206       NULL, NULL, g_cclosure_marshal_VOID__POINTER, G_TYPE_NONE, 1,
207       G_TYPE_POINTER);
208
209   gst_rtsp_client_signals[SIGNAL_TEARDOWN_REQUEST] =
210       g_signal_new ("teardown-request", G_TYPE_FROM_CLASS (klass),
211       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRTSPClientClass, teardown_request),
212       NULL, NULL, g_cclosure_marshal_VOID__POINTER, G_TYPE_NONE, 1,
213       G_TYPE_POINTER);
214
215   gst_rtsp_client_signals[SIGNAL_SET_PARAMETER_REQUEST] =
216       g_signal_new ("set-parameter-request", G_TYPE_FROM_CLASS (klass),
217       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRTSPClientClass,
218           set_parameter_request), NULL, NULL, g_cclosure_marshal_VOID__POINTER,
219       G_TYPE_NONE, 1, G_TYPE_POINTER);
220
221   gst_rtsp_client_signals[SIGNAL_GET_PARAMETER_REQUEST] =
222       g_signal_new ("get-parameter-request", G_TYPE_FROM_CLASS (klass),
223       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRTSPClientClass,
224           get_parameter_request), NULL, NULL, g_cclosure_marshal_VOID__POINTER,
225       G_TYPE_NONE, 1, G_TYPE_POINTER);
226
227   gst_rtsp_client_signals[SIGNAL_HANDLE_RESPONSE] =
228       g_signal_new ("handle-response", G_TYPE_FROM_CLASS (klass),
229       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRTSPClientClass,
230           handle_response), NULL, NULL, g_cclosure_marshal_VOID__POINTER,
231       G_TYPE_NONE, 1, G_TYPE_POINTER);
232
233   tunnels =
234       g_hash_table_new_full (g_str_hash, g_str_equal, g_free, g_object_unref);
235   g_mutex_init (&tunnels_lock);
236
237   GST_DEBUG_CATEGORY_INIT (rtsp_client_debug, "rtspclient", 0, "GstRTSPClient");
238 }
239
240 static void
241 gst_rtsp_client_init (GstRTSPClient * client)
242 {
243   GstRTSPClientPrivate *priv = GST_RTSP_CLIENT_GET_PRIVATE (client);
244
245   client->priv = priv;
246
247   g_mutex_init (&priv->lock);
248   g_mutex_init (&priv->send_lock);
249   priv->close_seq = 0;
250 }
251
252 static GstRTSPFilterResult
253 filter_session (GstRTSPSession * sess, GstRTSPSessionMedia * sessmedia,
254     gpointer user_data)
255 {
256   GstRTSPClient *client = GST_RTSP_CLIENT (user_data);
257
258   gst_rtsp_session_media_set_state (sessmedia, GST_STATE_NULL);
259   unlink_session_transports (client, sess, sessmedia);
260
261   /* unmanage the media in the session */
262   return GST_RTSP_FILTER_REMOVE;
263 }
264
265 static void
266 client_unlink_session (GstRTSPClient * client, GstRTSPSession * session)
267 {
268   /* unlink all media managed in this session */
269   gst_rtsp_session_filter (session, filter_session, client);
270 }
271
272 static void
273 client_watch_session (GstRTSPClient * client, GstRTSPSession * session)
274 {
275   GstRTSPClientPrivate *priv = client->priv;
276   GList *walk;
277
278   for (walk = priv->sessions; walk; walk = g_list_next (walk)) {
279     GstRTSPSession *msession = (GstRTSPSession *) walk->data;
280
281     /* we already know about this session */
282     if (msession == session)
283       return;
284   }
285
286   GST_INFO ("watching session %p", session);
287
288   g_object_weak_ref (G_OBJECT (session), (GWeakNotify) client_session_finalized,
289       client);
290   priv->sessions = g_list_prepend (priv->sessions, session);
291 }
292
293 static void
294 client_unwatch_session (GstRTSPClient * client, GstRTSPSession * session)
295 {
296   GstRTSPClientPrivate *priv = client->priv;
297
298   GST_INFO ("unwatching session %p", session);
299
300   g_object_weak_unref (G_OBJECT (session),
301       (GWeakNotify) client_session_finalized, client);
302   priv->sessions = g_list_remove (priv->sessions, session);
303 }
304
305 static void
306 client_cleanup_session (GstRTSPClient * client, GstRTSPSession * session)
307 {
308   g_object_weak_unref (G_OBJECT (session),
309       (GWeakNotify) client_session_finalized, client);
310   client_unlink_session (client, session);
311 }
312
313 static void
314 client_cleanup_sessions (GstRTSPClient * client)
315 {
316   GstRTSPClientPrivate *priv = client->priv;
317   GList *sessions;
318
319   /* remove weak-ref from sessions */
320   for (sessions = priv->sessions; sessions; sessions = g_list_next (sessions)) {
321     client_cleanup_session (client, (GstRTSPSession *) sessions->data);
322   }
323   g_list_free (priv->sessions);
324   priv->sessions = NULL;
325 }
326
327 /* A client is finalized when the connection is broken */
328 static void
329 gst_rtsp_client_finalize (GObject * obj)
330 {
331   GstRTSPClient *client = GST_RTSP_CLIENT (obj);
332   GstRTSPClientPrivate *priv = client->priv;
333
334   GST_INFO ("finalize client %p", client);
335
336   gst_rtsp_client_set_send_func (client, NULL, NULL, NULL);
337
338   if (priv->watch)
339     g_source_destroy ((GSource *) priv->watch);
340
341   client_cleanup_sessions (client);
342
343   if (priv->connection)
344     gst_rtsp_connection_free (priv->connection);
345   if (priv->session_pool)
346     g_object_unref (priv->session_pool);
347   if (priv->mount_points)
348     g_object_unref (priv->mount_points);
349   if (priv->auth)
350     g_object_unref (priv->auth);
351
352   if (priv->path)
353     g_free (priv->path);
354   if (priv->media) {
355     gst_rtsp_media_unprepare (priv->media);
356     g_object_unref (priv->media);
357   }
358
359   g_free (priv->server_ip);
360   g_mutex_clear (&priv->lock);
361   g_mutex_clear (&priv->send_lock);
362
363   G_OBJECT_CLASS (gst_rtsp_client_parent_class)->finalize (obj);
364 }
365
366 static void
367 gst_rtsp_client_get_property (GObject * object, guint propid,
368     GValue * value, GParamSpec * pspec)
369 {
370   GstRTSPClient *client = GST_RTSP_CLIENT (object);
371
372   switch (propid) {
373     case PROP_SESSION_POOL:
374       g_value_take_object (value, gst_rtsp_client_get_session_pool (client));
375       break;
376     case PROP_MOUNT_POINTS:
377       g_value_take_object (value, gst_rtsp_client_get_mount_points (client));
378       break;
379     default:
380       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, propid, pspec);
381   }
382 }
383
384 static void
385 gst_rtsp_client_set_property (GObject * object, guint propid,
386     const GValue * value, GParamSpec * pspec)
387 {
388   GstRTSPClient *client = GST_RTSP_CLIENT (object);
389
390   switch (propid) {
391     case PROP_SESSION_POOL:
392       gst_rtsp_client_set_session_pool (client, g_value_get_object (value));
393       break;
394     case PROP_MOUNT_POINTS:
395       gst_rtsp_client_set_mount_points (client, g_value_get_object (value));
396       break;
397     default:
398       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, propid, pspec);
399   }
400 }
401
402 /**
403  * gst_rtsp_client_new:
404  *
405  * Create a new #GstRTSPClient instance.
406  *
407  * Returns: a new #GstRTSPClient
408  */
409 GstRTSPClient *
410 gst_rtsp_client_new (void)
411 {
412   GstRTSPClient *result;
413
414   result = g_object_new (GST_TYPE_RTSP_CLIENT, NULL);
415
416   return result;
417 }
418
419 static void
420 send_message (GstRTSPClient * client, GstRTSPSession * session,
421     GstRTSPMessage * message, gboolean close)
422 {
423   GstRTSPClientPrivate *priv = client->priv;
424
425   gst_rtsp_message_add_header (message, GST_RTSP_HDR_SERVER,
426       "GStreamer RTSP server");
427
428   /* remove any previous header */
429   gst_rtsp_message_remove_header (message, GST_RTSP_HDR_SESSION, -1);
430
431   /* add the new session header for new session ids */
432   if (session) {
433     gst_rtsp_message_take_header (message, GST_RTSP_HDR_SESSION,
434         gst_rtsp_session_get_header (session));
435   }
436
437   if (gst_debug_category_get_threshold (rtsp_client_debug) >= GST_LEVEL_LOG) {
438     gst_rtsp_message_dump (message);
439   }
440
441   if (close)
442     gst_rtsp_message_add_header (message, GST_RTSP_HDR_CONNECTION, "close");
443
444   g_mutex_lock (&priv->send_lock);
445   if (priv->send_func)
446     priv->send_func (client, message, close, priv->send_data);
447   g_mutex_unlock (&priv->send_lock);
448
449   gst_rtsp_message_unset (message);
450 }
451
452 static void
453 send_generic_response (GstRTSPClient * client, GstRTSPStatusCode code,
454     GstRTSPContext * ctx)
455 {
456   gst_rtsp_message_init_response (ctx->response, code,
457       gst_rtsp_status_as_text (code), ctx->request);
458
459   send_message (client, NULL, ctx->response, FALSE);
460 }
461
462 static gboolean
463 paths_are_equal (const gchar * path1, const gchar * path2, gint len2)
464 {
465   if (path1 == NULL || path2 == NULL)
466     return FALSE;
467
468   if (strlen (path1) != len2)
469     return FALSE;
470
471   if (strncmp (path1, path2, len2))
472     return FALSE;
473
474   return TRUE;
475 }
476
477 /* this function is called to initially find the media for the DESCRIBE request
478  * but is cached for when the same client (without breaking the connection) is
479  * doing a setup for the exact same url. */
480 static GstRTSPMedia *
481 find_media (GstRTSPClient * client, GstRTSPContext * ctx, gint * matched)
482 {
483   GstRTSPClientPrivate *priv = client->priv;
484   GstRTSPMediaFactory *factory;
485   GstRTSPMedia *media;
486   gchar *path;
487   gint path_len;
488
489   if (!priv->mount_points)
490     goto no_mount_points;
491
492   path = ctx->uri->abspath;
493
494   /* find the longest matching factory for the uri first */
495   if (!(factory = gst_rtsp_mount_points_match (priv->mount_points,
496               path, matched)))
497     goto no_factory;
498
499   ctx->factory = factory;
500
501   if (!gst_rtsp_auth_check (GST_RTSP_AUTH_CHECK_MEDIA_FACTORY_ACCESS))
502     goto no_factory_access;
503
504   if (!gst_rtsp_auth_check (GST_RTSP_AUTH_CHECK_MEDIA_FACTORY_CONSTRUCT))
505     goto not_authorized;
506
507   if (matched)
508     path_len = *matched;
509   else
510     path_len = strlen (path);
511
512   if (!paths_are_equal (priv->path, path, path_len)) {
513     GstRTSPThread *thread;
514
515     /* remove any previously cached values before we try to construct a new
516      * media for uri */
517     if (priv->path)
518       g_free (priv->path);
519     priv->path = NULL;
520     if (priv->media) {
521       gst_rtsp_media_unprepare (priv->media);
522       g_object_unref (priv->media);
523     }
524     priv->media = NULL;
525
526     /* prepare the media and add it to the pipeline */
527     if (!(media = gst_rtsp_media_factory_construct (factory, ctx->uri)))
528       goto no_media;
529
530     ctx->media = media;
531
532     thread = gst_rtsp_thread_pool_get_thread (priv->thread_pool,
533         GST_RTSP_THREAD_TYPE_MEDIA, ctx);
534     if (thread == NULL)
535       goto no_thread;
536
537     /* prepare the media */
538     if (!(gst_rtsp_media_prepare (media, thread)))
539       goto no_prepare;
540
541     /* now keep track of the uri and the media */
542     priv->path = g_strndup (path, path_len);
543     priv->media = media;
544   } else {
545     /* we have seen this path before, used cached media */
546     media = priv->media;
547     ctx->media = media;
548     GST_INFO ("reusing cached media %p for path %s", media, priv->path);
549   }
550
551   g_object_unref (factory);
552   ctx->factory = NULL;
553
554   if (media)
555     g_object_ref (media);
556
557   return media;
558
559   /* ERRORS */
560 no_mount_points:
561   {
562     GST_ERROR ("client %p: no mount points configured", client);
563     send_generic_response (client, GST_RTSP_STS_NOT_FOUND, ctx);
564     return NULL;
565   }
566 no_factory:
567   {
568     GST_ERROR ("client %p: no factory for uri %s", client, path);
569     send_generic_response (client, GST_RTSP_STS_NOT_FOUND, ctx);
570     return NULL;
571   }
572 no_factory_access:
573   {
574     GST_ERROR ("client %p: not authorized to see factory uri %s", client, path);
575     return NULL;
576   }
577 not_authorized:
578   {
579     GST_ERROR ("client %p: not authorized for factory uri %s", client, path);
580     return NULL;
581   }
582 no_media:
583   {
584     GST_ERROR ("client %p: can't create media", client);
585     send_generic_response (client, GST_RTSP_STS_SERVICE_UNAVAILABLE, ctx);
586     g_object_unref (factory);
587     ctx->factory = NULL;
588     return NULL;
589   }
590 no_thread:
591   {
592     GST_ERROR ("client %p: can't create thread", client);
593     send_generic_response (client, GST_RTSP_STS_SERVICE_UNAVAILABLE, ctx);
594     g_object_unref (media);
595     ctx->media = NULL;
596     g_object_unref (factory);
597     ctx->factory = NULL;
598     return NULL;
599   }
600 no_prepare:
601   {
602     GST_ERROR ("client %p: can't prepare media", client);
603     send_generic_response (client, GST_RTSP_STS_SERVICE_UNAVAILABLE, ctx);
604     g_object_unref (media);
605     ctx->media = NULL;
606     g_object_unref (factory);
607     ctx->factory = NULL;
608     return NULL;
609   }
610 }
611
612 static gboolean
613 do_send_data (GstBuffer * buffer, guint8 channel, GstRTSPClient * client)
614 {
615   GstRTSPClientPrivate *priv = client->priv;
616   GstRTSPMessage message = { 0 };
617   GstMapInfo map_info;
618   guint8 *data;
619   guint usize;
620
621   gst_rtsp_message_init_data (&message, channel);
622
623   /* FIXME, need some sort of iovec RTSPMessage here */
624   if (!gst_buffer_map (buffer, &map_info, GST_MAP_READ))
625     return FALSE;
626
627   gst_rtsp_message_take_body (&message, map_info.data, map_info.size);
628
629   g_mutex_lock (&priv->send_lock);
630   if (priv->send_func)
631     priv->send_func (client, &message, FALSE, priv->send_data);
632   g_mutex_unlock (&priv->send_lock);
633
634   gst_rtsp_message_steal_body (&message, &data, &usize);
635   gst_buffer_unmap (buffer, &map_info);
636
637   gst_rtsp_message_unset (&message);
638
639   return TRUE;
640 }
641
642 static void
643 link_transport (GstRTSPClient * client, GstRTSPSession * session,
644     GstRTSPStreamTransport * trans)
645 {
646   GstRTSPClientPrivate *priv = client->priv;
647
648   GST_DEBUG ("client %p: linking transport %p", client, trans);
649
650   gst_rtsp_stream_transport_set_callbacks (trans,
651       (GstRTSPSendFunc) do_send_data,
652       (GstRTSPSendFunc) do_send_data, client, NULL);
653
654   priv->transports = g_list_prepend (priv->transports, trans);
655
656   /* make sure our session can't expire */
657   gst_rtsp_session_prevent_expire (session);
658 }
659
660 static void
661 unlink_transport (GstRTSPClient * client, GstRTSPSession * session,
662     GstRTSPStreamTransport * trans)
663 {
664   GstRTSPClientPrivate *priv = client->priv;
665
666   GST_DEBUG ("client %p: unlinking transport %p", client, trans);
667
668   gst_rtsp_stream_transport_set_callbacks (trans, NULL, NULL, NULL, NULL);
669
670   priv->transports = g_list_remove (priv->transports, trans);
671
672   /* our session can now expire */
673   gst_rtsp_session_allow_expire (session);
674 }
675
676 static void
677 unlink_session_transports (GstRTSPClient * client, GstRTSPSession * session,
678     GstRTSPSessionMedia * sessmedia)
679 {
680   guint n_streams, i;
681
682   n_streams =
683       gst_rtsp_media_n_streams (gst_rtsp_session_media_get_media (sessmedia));
684   for (i = 0; i < n_streams; i++) {
685     GstRTSPStreamTransport *trans;
686     const GstRTSPTransport *tr;
687
688     /* get the transport, if there is no transport configured, skip this stream */
689     trans = gst_rtsp_session_media_get_transport (sessmedia, i);
690     if (trans == NULL)
691       continue;
692
693     tr = gst_rtsp_stream_transport_get_transport (trans);
694
695     if (tr->lower_transport == GST_RTSP_LOWER_TRANS_TCP) {
696       /* for TCP, unlink the stream from the TCP connection of the client */
697       unlink_transport (client, session, trans);
698     }
699   }
700 }
701
702 static void
703 close_connection (GstRTSPClient * client)
704 {
705   GstRTSPClientPrivate *priv = client->priv;
706   const gchar *tunnelid;
707
708   GST_DEBUG ("client %p: closing connection", client);
709
710   if ((tunnelid = gst_rtsp_connection_get_tunnelid (priv->connection))) {
711     g_mutex_lock (&tunnels_lock);
712     /* remove from tunnelids */
713     g_hash_table_remove (tunnels, tunnelid);
714     g_mutex_unlock (&tunnels_lock);
715   }
716
717   gst_rtsp_connection_close (priv->connection);
718 }
719
720 static gboolean
721 handle_teardown_request (GstRTSPClient * client, GstRTSPContext * ctx)
722 {
723   GstRTSPClientPrivate *priv = client->priv;
724   GstRTSPSession *session;
725   GstRTSPSessionMedia *sessmedia;
726   GstRTSPStatusCode code;
727   const gchar *path;
728   gint matched;
729
730   if (!ctx->session)
731     goto no_session;
732
733   session = ctx->session;
734
735   if (!ctx->uri)
736     goto no_uri;
737
738   path = ctx->uri->abspath;
739
740   /* get a handle to the configuration of the media in the session */
741   sessmedia = gst_rtsp_session_get_media (session, path, &matched);
742   if (!sessmedia)
743     goto not_found;
744
745   /* only aggregate control for now.. */
746   if (path[matched] != '\0')
747     goto no_aggregate;
748
749   ctx->sessmedia = sessmedia;
750
751   /* we emit the signal before closing the connection */
752   g_signal_emit (client, gst_rtsp_client_signals[SIGNAL_TEARDOWN_REQUEST],
753       0, ctx);
754
755   /* unlink the all TCP callbacks */
756   unlink_session_transports (client, session, sessmedia);
757
758   /* remove the session from the watched sessions */
759   client_unwatch_session (client, session);
760
761   gst_rtsp_session_media_set_state (sessmedia, GST_STATE_NULL);
762
763   /* unmanage the media in the session, returns false if all media session
764    * are torn down. */
765   if (!gst_rtsp_session_release_media (session, sessmedia)) {
766     /* remove the session */
767     gst_rtsp_session_pool_remove (priv->session_pool, session);
768   }
769   /* construct the response now */
770   code = GST_RTSP_STS_OK;
771   gst_rtsp_message_init_response (ctx->response, code,
772       gst_rtsp_status_as_text (code), ctx->request);
773
774   send_message (client, session, ctx->response, TRUE);
775
776   return TRUE;
777
778   /* ERRORS */
779 no_session:
780   {
781     GST_ERROR ("client %p: no session", client);
782     send_generic_response (client, GST_RTSP_STS_SESSION_NOT_FOUND, ctx);
783     return FALSE;
784   }
785 no_uri:
786   {
787     GST_ERROR ("client %p: no uri supplied", client);
788     send_generic_response (client, GST_RTSP_STS_BAD_REQUEST, ctx);
789     return FALSE;
790   }
791 not_found:
792   {
793     GST_ERROR ("client %p: no media for uri", client);
794     send_generic_response (client, GST_RTSP_STS_NOT_FOUND, ctx);
795     return FALSE;
796   }
797 no_aggregate:
798   {
799     GST_ERROR ("client %p: no aggregate path %s", client, path);
800     send_generic_response (client,
801         GST_RTSP_STS_ONLY_AGGREGATE_OPERATION_ALLOWED, ctx);
802     return FALSE;
803   }
804 }
805
806 static GstRTSPResult
807 default_params_set (GstRTSPClient * client, GstRTSPContext * ctx)
808 {
809   GstRTSPResult res;
810
811   res = gst_rtsp_params_set (client, ctx);
812
813   return res;
814 }
815
816 static GstRTSPResult
817 default_params_get (GstRTSPClient * client, GstRTSPContext * ctx)
818 {
819   GstRTSPResult res;
820
821   res = gst_rtsp_params_get (client, ctx);
822
823   return res;
824 }
825
826 static gboolean
827 handle_get_param_request (GstRTSPClient * client, GstRTSPContext * ctx)
828 {
829   GstRTSPResult res;
830   guint8 *data;
831   guint size;
832
833   res = gst_rtsp_message_get_body (ctx->request, &data, &size);
834   if (res != GST_RTSP_OK)
835     goto bad_request;
836
837   if (size == 0) {
838     /* no body, keep-alive request */
839     send_generic_response (client, GST_RTSP_STS_OK, ctx);
840   } else {
841     /* there is a body, handle the params */
842     res = GST_RTSP_CLIENT_GET_CLASS (client)->params_get (client, ctx);
843     if (res != GST_RTSP_OK)
844       goto bad_request;
845
846     send_message (client, ctx->session, ctx->response, FALSE);
847   }
848
849   g_signal_emit (client, gst_rtsp_client_signals[SIGNAL_GET_PARAMETER_REQUEST],
850       0, ctx);
851
852   return TRUE;
853
854   /* ERRORS */
855 bad_request:
856   {
857     GST_ERROR ("client %p: bad request", client);
858     send_generic_response (client, GST_RTSP_STS_BAD_REQUEST, ctx);
859     return FALSE;
860   }
861 }
862
863 static gboolean
864 handle_set_param_request (GstRTSPClient * client, GstRTSPContext * ctx)
865 {
866   GstRTSPResult res;
867   guint8 *data;
868   guint size;
869
870   res = gst_rtsp_message_get_body (ctx->request, &data, &size);
871   if (res != GST_RTSP_OK)
872     goto bad_request;
873
874   if (size == 0) {
875     /* no body, keep-alive request */
876     send_generic_response (client, GST_RTSP_STS_OK, ctx);
877   } else {
878     /* there is a body, handle the params */
879     res = GST_RTSP_CLIENT_GET_CLASS (client)->params_set (client, ctx);
880     if (res != GST_RTSP_OK)
881       goto bad_request;
882
883     send_message (client, ctx->session, ctx->response, FALSE);
884   }
885
886   g_signal_emit (client, gst_rtsp_client_signals[SIGNAL_SET_PARAMETER_REQUEST],
887       0, ctx);
888
889   return TRUE;
890
891   /* ERRORS */
892 bad_request:
893   {
894     GST_ERROR ("client %p: bad request", client);
895     send_generic_response (client, GST_RTSP_STS_BAD_REQUEST, ctx);
896     return FALSE;
897   }
898 }
899
900 static gboolean
901 handle_pause_request (GstRTSPClient * client, GstRTSPContext * ctx)
902 {
903   GstRTSPSession *session;
904   GstRTSPSessionMedia *sessmedia;
905   GstRTSPStatusCode code;
906   GstRTSPState rtspstate;
907   const gchar *path;
908   gint matched;
909
910   if (!(session = ctx->session))
911     goto no_session;
912
913   if (!ctx->uri)
914     goto no_uri;
915
916   path = ctx->uri->abspath;
917
918   /* get a handle to the configuration of the media in the session */
919   sessmedia = gst_rtsp_session_get_media (session, path, &matched);
920   if (!sessmedia)
921     goto not_found;
922
923   if (path[matched] != '\0')
924     goto no_aggregate;
925
926   ctx->sessmedia = sessmedia;
927
928   rtspstate = gst_rtsp_session_media_get_rtsp_state (sessmedia);
929   /* the session state must be playing or recording */
930   if (rtspstate != GST_RTSP_STATE_PLAYING &&
931       rtspstate != GST_RTSP_STATE_RECORDING)
932     goto invalid_state;
933
934   /* unlink the all TCP callbacks */
935   unlink_session_transports (client, session, sessmedia);
936
937   /* then pause sending */
938   gst_rtsp_session_media_set_state (sessmedia, GST_STATE_PAUSED);
939
940   /* construct the response now */
941   code = GST_RTSP_STS_OK;
942   gst_rtsp_message_init_response (ctx->response, code,
943       gst_rtsp_status_as_text (code), ctx->request);
944
945   send_message (client, session, ctx->response, FALSE);
946
947   /* the state is now READY */
948   gst_rtsp_session_media_set_rtsp_state (sessmedia, GST_RTSP_STATE_READY);
949
950   g_signal_emit (client, gst_rtsp_client_signals[SIGNAL_PAUSE_REQUEST], 0, ctx);
951
952   return TRUE;
953
954   /* ERRORS */
955 no_session:
956   {
957     GST_ERROR ("client %p: no seesion", client);
958     send_generic_response (client, GST_RTSP_STS_SESSION_NOT_FOUND, ctx);
959     return FALSE;
960   }
961 no_uri:
962   {
963     GST_ERROR ("client %p: no uri supplied", client);
964     send_generic_response (client, GST_RTSP_STS_BAD_REQUEST, ctx);
965     return FALSE;
966   }
967 not_found:
968   {
969     GST_ERROR ("client %p: no media for uri", client);
970     send_generic_response (client, GST_RTSP_STS_NOT_FOUND, ctx);
971     return FALSE;
972   }
973 no_aggregate:
974   {
975     GST_ERROR ("client %p: no aggregate path %s", client, path);
976     send_generic_response (client,
977         GST_RTSP_STS_ONLY_AGGREGATE_OPERATION_ALLOWED, ctx);
978     return FALSE;
979   }
980 invalid_state:
981   {
982     GST_ERROR ("client %p: not PLAYING or RECORDING", client);
983     send_generic_response (client, GST_RTSP_STS_METHOD_NOT_VALID_IN_THIS_STATE,
984         ctx);
985     return FALSE;
986   }
987 }
988
989 static gboolean
990 handle_play_request (GstRTSPClient * client, GstRTSPContext * ctx)
991 {
992   GstRTSPSession *session;
993   GstRTSPSessionMedia *sessmedia;
994   GstRTSPMedia *media;
995   GstRTSPStatusCode code;
996   GString *rtpinfo;
997   guint n_streams, i, infocount;
998   gchar *str;
999   GstRTSPTimeRange *range;
1000   GstRTSPResult res;
1001   GstRTSPState rtspstate;
1002   GstRTSPRangeUnit unit = GST_RTSP_RANGE_NPT;
1003   const gchar *path;
1004   gint matched;
1005
1006   if (!(session = ctx->session))
1007     goto no_session;
1008
1009   if (!ctx->uri)
1010     goto no_uri;
1011
1012   path = ctx->uri->abspath;
1013
1014   /* get a handle to the configuration of the media in the session */
1015   sessmedia = gst_rtsp_session_get_media (session, path, &matched);
1016   if (!sessmedia)
1017     goto not_found;
1018
1019   if (path[matched] != '\0')
1020     goto no_aggregate;
1021
1022   ctx->sessmedia = sessmedia;
1023   ctx->media = media = gst_rtsp_session_media_get_media (sessmedia);
1024
1025   /* the session state must be playing or ready */
1026   rtspstate = gst_rtsp_session_media_get_rtsp_state (sessmedia);
1027   if (rtspstate != GST_RTSP_STATE_PLAYING && rtspstate != GST_RTSP_STATE_READY)
1028     goto invalid_state;
1029
1030   /* parse the range header if we have one */
1031   res = gst_rtsp_message_get_header (ctx->request, GST_RTSP_HDR_RANGE, &str, 0);
1032   if (res == GST_RTSP_OK) {
1033     if (gst_rtsp_range_parse (str, &range) == GST_RTSP_OK) {
1034       /* we have a range, seek to the position */
1035       unit = range->unit;
1036       gst_rtsp_media_seek (media, range);
1037       gst_rtsp_range_free (range);
1038     }
1039   }
1040
1041   /* grab RTPInfo from the payloaders now */
1042   rtpinfo = g_string_new ("");
1043
1044   n_streams = gst_rtsp_media_n_streams (media);
1045   for (i = 0, infocount = 0; i < n_streams; i++) {
1046     GstRTSPStreamTransport *trans;
1047     GstRTSPStream *stream;
1048     const GstRTSPTransport *tr;
1049     gchar *uristr;
1050     guint rtptime, seq;
1051
1052     /* get the transport, if there is no transport configured, skip this stream */
1053     trans = gst_rtsp_session_media_get_transport (sessmedia, i);
1054     if (trans == NULL) {
1055       GST_INFO ("stream %d is not configured", i);
1056       continue;
1057     }
1058     tr = gst_rtsp_stream_transport_get_transport (trans);
1059
1060     if (tr->lower_transport == GST_RTSP_LOWER_TRANS_TCP) {
1061       /* for TCP, link the stream to the TCP connection of the client */
1062       link_transport (client, session, trans);
1063     }
1064
1065     stream = gst_rtsp_stream_transport_get_stream (trans);
1066     if (gst_rtsp_stream_get_rtpinfo (stream, &rtptime, &seq)) {
1067       if (infocount > 0)
1068         g_string_append (rtpinfo, ", ");
1069
1070       uristr = gst_rtsp_url_get_request_uri (ctx->uri);
1071       g_string_append_printf (rtpinfo, "url=%s/stream=%d;seq=%u;rtptime=%u",
1072           uristr, i, seq, rtptime);
1073       g_free (uristr);
1074
1075       infocount++;
1076     } else {
1077       GST_WARNING ("RTP-Info cannot be determined for stream %d", i);
1078     }
1079   }
1080
1081   /* construct the response now */
1082   code = GST_RTSP_STS_OK;
1083   gst_rtsp_message_init_response (ctx->response, code,
1084       gst_rtsp_status_as_text (code), ctx->request);
1085
1086   /* add the RTP-Info header */
1087   if (infocount > 0) {
1088     str = g_string_free (rtpinfo, FALSE);
1089     gst_rtsp_message_take_header (ctx->response, GST_RTSP_HDR_RTP_INFO, str);
1090   } else {
1091     g_string_free (rtpinfo, TRUE);
1092   }
1093
1094   /* add the range */
1095   str = gst_rtsp_media_get_range_string (media, TRUE, unit);
1096   if (str)
1097     gst_rtsp_message_take_header (ctx->response, GST_RTSP_HDR_RANGE, str);
1098
1099   send_message (client, session, ctx->response, FALSE);
1100
1101   /* start playing after sending the request */
1102   gst_rtsp_session_media_set_state (sessmedia, GST_STATE_PLAYING);
1103
1104   gst_rtsp_session_media_set_rtsp_state (sessmedia, GST_RTSP_STATE_PLAYING);
1105
1106   g_signal_emit (client, gst_rtsp_client_signals[SIGNAL_PLAY_REQUEST], 0, ctx);
1107
1108   return TRUE;
1109
1110   /* ERRORS */
1111 no_session:
1112   {
1113     GST_ERROR ("client %p: no session", client);
1114     send_generic_response (client, GST_RTSP_STS_SESSION_NOT_FOUND, ctx);
1115     return FALSE;
1116   }
1117 no_uri:
1118   {
1119     GST_ERROR ("client %p: no uri supplied", client);
1120     send_generic_response (client, GST_RTSP_STS_BAD_REQUEST, ctx);
1121     return FALSE;
1122   }
1123 not_found:
1124   {
1125     GST_ERROR ("client %p: media not found", client);
1126     send_generic_response (client, GST_RTSP_STS_NOT_FOUND, ctx);
1127     return FALSE;
1128   }
1129 no_aggregate:
1130   {
1131     GST_ERROR ("client %p: no aggregate path %s", client, path);
1132     send_generic_response (client,
1133         GST_RTSP_STS_ONLY_AGGREGATE_OPERATION_ALLOWED, ctx);
1134     return FALSE;
1135   }
1136 invalid_state:
1137   {
1138     GST_ERROR ("client %p: not PLAYING or READY", client);
1139     send_generic_response (client, GST_RTSP_STS_METHOD_NOT_VALID_IN_THIS_STATE,
1140         ctx);
1141     return FALSE;
1142   }
1143 }
1144
1145 static void
1146 do_keepalive (GstRTSPSession * session)
1147 {
1148   GST_INFO ("keep session %p alive", session);
1149   gst_rtsp_session_touch (session);
1150 }
1151
1152 /* parse @transport and return a valid transport in @tr. only transports
1153  * from @supported are returned. Returns FALSE if no valid transport
1154  * was found. */
1155 static gboolean
1156 parse_transport (const char *transport, GstRTSPLowerTrans supported,
1157     GstRTSPTransport * tr)
1158 {
1159   gint i;
1160   gboolean res;
1161   gchar **transports;
1162
1163   res = FALSE;
1164   gst_rtsp_transport_init (tr);
1165
1166   GST_DEBUG ("parsing transports %s", transport);
1167
1168   transports = g_strsplit (transport, ",", 0);
1169
1170   /* loop through the transports, try to parse */
1171   for (i = 0; transports[i]; i++) {
1172     res = gst_rtsp_transport_parse (transports[i], tr);
1173     if (res != GST_RTSP_OK) {
1174       /* no valid transport, search some more */
1175       GST_WARNING ("could not parse transport %s", transports[i]);
1176       goto next;
1177     }
1178
1179     /* we have a transport, see if it's RTP/AVP */
1180     if (tr->trans != GST_RTSP_TRANS_RTP || tr->profile != GST_RTSP_PROFILE_AVP) {
1181       GST_WARNING ("invalid transport %s", transports[i]);
1182       goto next;
1183     }
1184
1185     if (!(tr->lower_transport & supported)) {
1186       GST_WARNING ("unsupported transport %s", transports[i]);
1187       goto next;
1188     }
1189
1190     /* we have a valid transport */
1191     GST_INFO ("found valid transport %s", transports[i]);
1192     res = TRUE;
1193     break;
1194
1195   next:
1196     gst_rtsp_transport_init (tr);
1197   }
1198   g_strfreev (transports);
1199
1200   return res;
1201 }
1202
1203 static gboolean
1204 handle_blocksize (GstRTSPMedia * media, GstRTSPStream * stream,
1205     GstRTSPMessage * request)
1206 {
1207   gchar *blocksize_str;
1208   gboolean ret = TRUE;
1209
1210   if (gst_rtsp_message_get_header (request, GST_RTSP_HDR_BLOCKSIZE,
1211           &blocksize_str, 0) == GST_RTSP_OK) {
1212     guint64 blocksize;
1213     gchar *end;
1214
1215     blocksize = g_ascii_strtoull (blocksize_str, &end, 10);
1216     if (end == blocksize_str) {
1217       GST_ERROR ("failed to parse blocksize");
1218       ret = FALSE;
1219     } else {
1220       /* we don't want to change the mtu when this media
1221        * can be shared because it impacts other clients */
1222       if (gst_rtsp_media_is_shared (media))
1223         return TRUE;
1224
1225       if (blocksize > G_MAXUINT)
1226         blocksize = G_MAXUINT;
1227       gst_rtsp_stream_set_mtu (stream, blocksize);
1228     }
1229   }
1230   return ret;
1231 }
1232
1233 static gboolean
1234 default_configure_client_transport (GstRTSPClient * client,
1235     GstRTSPContext * ctx, GstRTSPTransport * ct)
1236 {
1237   GstRTSPClientPrivate *priv = client->priv;
1238
1239   /* we have a valid transport now, set the destination of the client. */
1240   if (ct->lower_transport == GST_RTSP_LOWER_TRANS_UDP_MCAST) {
1241     gboolean use_client_settings;
1242
1243     use_client_settings =
1244         gst_rtsp_auth_check (GST_RTSP_AUTH_CHECK_TRANSPORT_CLIENT_SETTINGS);
1245
1246     if (ct->destination && use_client_settings) {
1247       GstRTSPAddress *addr;
1248
1249       addr = gst_rtsp_stream_reserve_address (ctx->stream, ct->destination,
1250           ct->port.min, ct->port.max - ct->port.min + 1, ct->ttl);
1251
1252       if (addr == NULL)
1253         goto no_address;
1254
1255       gst_rtsp_address_free (addr);
1256     } else {
1257       GstRTSPAddress *addr;
1258       GSocketFamily family;
1259
1260       family = priv->is_ipv6 ? G_SOCKET_FAMILY_IPV6 : G_SOCKET_FAMILY_IPV4;
1261
1262       addr = gst_rtsp_stream_get_multicast_address (ctx->stream, family);
1263       if (addr == NULL)
1264         goto no_address;
1265
1266       g_free (ct->destination);
1267       ct->destination = g_strdup (addr->address);
1268       ct->port.min = addr->port;
1269       ct->port.max = addr->port + addr->n_ports - 1;
1270       ct->ttl = addr->ttl;
1271
1272       gst_rtsp_address_free (addr);
1273     }
1274   } else {
1275     GstRTSPUrl *url;
1276
1277     url = gst_rtsp_connection_get_url (priv->connection);
1278     g_free (ct->destination);
1279     ct->destination = g_strdup (url->host);
1280
1281     if (ct->lower_transport & GST_RTSP_LOWER_TRANS_TCP) {
1282       /* check if the client selected channels for TCP */
1283       if (ct->interleaved.min == -1 || ct->interleaved.max == -1) {
1284         gst_rtsp_session_media_alloc_channels (ctx->sessmedia,
1285             &ct->interleaved);
1286       }
1287     }
1288   }
1289   return TRUE;
1290
1291   /* ERRORS */
1292 no_address:
1293   {
1294     GST_ERROR_OBJECT (client, "failed to acquire address for stream");
1295     return FALSE;
1296   }
1297 }
1298
1299 static GstRTSPTransport *
1300 make_server_transport (GstRTSPClient * client, GstRTSPContext * ctx,
1301     GstRTSPTransport * ct)
1302 {
1303   GstRTSPTransport *st;
1304   GInetAddress *addr;
1305   GSocketFamily family;
1306
1307   /* prepare the server transport */
1308   gst_rtsp_transport_new (&st);
1309
1310   st->trans = ct->trans;
1311   st->profile = ct->profile;
1312   st->lower_transport = ct->lower_transport;
1313
1314   addr = g_inet_address_new_from_string (ct->destination);
1315
1316   if (!addr) {
1317     GST_ERROR ("failed to get inet addr from client destination");
1318     family = G_SOCKET_FAMILY_IPV4;
1319   } else {
1320     family = g_inet_address_get_family (addr);
1321     g_object_unref (addr);
1322     addr = NULL;
1323   }
1324
1325   switch (st->lower_transport) {
1326     case GST_RTSP_LOWER_TRANS_UDP:
1327       st->client_port = ct->client_port;
1328       gst_rtsp_stream_get_server_port (ctx->stream, &st->server_port, family);
1329       break;
1330     case GST_RTSP_LOWER_TRANS_UDP_MCAST:
1331       st->port = ct->port;
1332       st->destination = g_strdup (ct->destination);
1333       st->ttl = ct->ttl;
1334       break;
1335     case GST_RTSP_LOWER_TRANS_TCP:
1336       st->interleaved = ct->interleaved;
1337     default:
1338       break;
1339   }
1340
1341   gst_rtsp_stream_get_ssrc (ctx->stream, &st->ssrc);
1342
1343   return st;
1344 }
1345
1346 static gboolean
1347 handle_setup_request (GstRTSPClient * client, GstRTSPContext * ctx)
1348 {
1349   GstRTSPClientPrivate *priv = client->priv;
1350   GstRTSPResult res;
1351   GstRTSPUrl *uri;
1352   gchar *transport;
1353   GstRTSPTransport *ct, *st;
1354   GstRTSPLowerTrans supported;
1355   GstRTSPStatusCode code;
1356   GstRTSPSession *session;
1357   GstRTSPStreamTransport *trans;
1358   gchar *trans_str;
1359   GstRTSPSessionMedia *sessmedia;
1360   GstRTSPMedia *media;
1361   GstRTSPStream *stream;
1362   GstRTSPState rtspstate;
1363   GstRTSPClientClass *klass;
1364   gchar *path, *control;
1365   gint matched;
1366
1367   if (!ctx->uri)
1368     goto no_uri;
1369
1370   uri = ctx->uri;
1371   path = uri->abspath;
1372
1373   /* parse the transport */
1374   res =
1375       gst_rtsp_message_get_header (ctx->request, GST_RTSP_HDR_TRANSPORT,
1376       &transport, 0);
1377   if (res != GST_RTSP_OK)
1378     goto no_transport;
1379
1380   /* we create the session after parsing stuff so that we don't make
1381    * a session for malformed requests */
1382   if (priv->session_pool == NULL)
1383     goto no_pool;
1384
1385   session = ctx->session;
1386
1387   if (session) {
1388     g_object_ref (session);
1389     /* get a handle to the configuration of the media in the session, this can
1390      * return NULL if this is a new url to manage in this session. */
1391     sessmedia = gst_rtsp_session_get_media (session, path, &matched);
1392   } else {
1393     /* we need a new media configuration in this session */
1394     sessmedia = NULL;
1395   }
1396
1397   /* we have no session media, find one and manage it */
1398   if (sessmedia == NULL) {
1399     /* get a handle to the configuration of the media in the session */
1400     media = find_media (client, ctx, &matched);
1401   } else {
1402     if ((media = gst_rtsp_session_media_get_media (sessmedia)))
1403       g_object_ref (media);
1404   }
1405   /* no media, not found then */
1406   if (media == NULL)
1407     goto media_not_found;
1408
1409   /* path is what matched. We can modify the parsed uri in place */
1410   path[matched] = '\0';
1411   /* control is remainder */
1412   control = &path[matched + 1];
1413
1414   /* find the stream now using the control part */
1415   stream = gst_rtsp_media_find_stream (media, control);
1416   if (stream == NULL)
1417     goto stream_not_found;
1418
1419   /* now we have a uri identifying a valid media and stream */
1420   ctx->stream = stream;
1421   ctx->media = media;
1422
1423   if (session == NULL) {
1424     /* create a session if this fails we probably reached our session limit or
1425      * something. */
1426     if (!(session = gst_rtsp_session_pool_create (priv->session_pool)))
1427       goto service_unavailable;
1428
1429     /* make sure this client is closed when the session is closed */
1430     client_watch_session (client, session);
1431
1432     /* signal new session */
1433     g_signal_emit (client, gst_rtsp_client_signals[SIGNAL_NEW_SESSION], 0,
1434         session);
1435
1436     ctx->session = session;
1437   }
1438
1439   if (sessmedia == NULL) {
1440     /* manage the media in our session now, if not done already  */
1441     sessmedia = gst_rtsp_session_manage_media (session, path, media);
1442     /* if we stil have no media, error */
1443     if (sessmedia == NULL)
1444       goto sessmedia_unavailable;
1445   } else {
1446     g_object_unref (media);
1447   }
1448
1449   ctx->sessmedia = sessmedia;
1450
1451   /* set blocksize on this stream */
1452   if (!handle_blocksize (media, stream, ctx->request))
1453     goto invalid_blocksize;
1454
1455   gst_rtsp_transport_new (&ct);
1456
1457   /* our supported transports */
1458   supported = gst_rtsp_stream_get_protocols (stream);
1459
1460   /* parse and find a usable supported transport */
1461   if (!parse_transport (transport, supported, ct))
1462     goto unsupported_transports;
1463
1464   /* update the client transport */
1465   klass = GST_RTSP_CLIENT_GET_CLASS (client);
1466   if (!klass->configure_client_transport (client, ctx, ct))
1467     goto unsupported_client_transport;
1468
1469   /* set in the session media transport */
1470   trans = gst_rtsp_session_media_set_transport (sessmedia, stream, ct);
1471
1472   /* configure keepalive for this transport */
1473   gst_rtsp_stream_transport_set_keepalive (trans,
1474       (GstRTSPKeepAliveFunc) do_keepalive, session, NULL);
1475
1476   /* create and serialize the server transport */
1477   st = make_server_transport (client, ctx, ct);
1478   trans_str = gst_rtsp_transport_as_text (st);
1479   gst_rtsp_transport_free (st);
1480
1481   /* construct the response now */
1482   code = GST_RTSP_STS_OK;
1483   gst_rtsp_message_init_response (ctx->response, code,
1484       gst_rtsp_status_as_text (code), ctx->request);
1485
1486   gst_rtsp_message_add_header (ctx->response, GST_RTSP_HDR_TRANSPORT,
1487       trans_str);
1488   g_free (trans_str);
1489
1490   send_message (client, session, ctx->response, FALSE);
1491
1492   /* update the state */
1493   rtspstate = gst_rtsp_session_media_get_rtsp_state (sessmedia);
1494   switch (rtspstate) {
1495     case GST_RTSP_STATE_PLAYING:
1496     case GST_RTSP_STATE_RECORDING:
1497     case GST_RTSP_STATE_READY:
1498       /* no state change */
1499       break;
1500     default:
1501       gst_rtsp_session_media_set_rtsp_state (sessmedia, GST_RTSP_STATE_READY);
1502       break;
1503   }
1504   g_object_unref (session);
1505
1506   g_signal_emit (client, gst_rtsp_client_signals[SIGNAL_SETUP_REQUEST], 0, ctx);
1507
1508   return TRUE;
1509
1510   /* ERRORS */
1511 no_uri:
1512   {
1513     GST_ERROR ("client %p: no uri", client);
1514     send_generic_response (client, GST_RTSP_STS_BAD_REQUEST, ctx);
1515     return FALSE;
1516   }
1517 no_transport:
1518   {
1519     GST_ERROR ("client %p: no transport", client);
1520     send_generic_response (client, GST_RTSP_STS_UNSUPPORTED_TRANSPORT, ctx);
1521     return FALSE;
1522   }
1523 no_pool:
1524   {
1525     GST_ERROR ("client %p: no session pool configured", client);
1526     send_generic_response (client, GST_RTSP_STS_SESSION_NOT_FOUND, ctx);
1527     return FALSE;
1528   }
1529 media_not_found:
1530   {
1531     GST_ERROR ("client %p: media '%s' not found", client, path);
1532     send_generic_response (client, GST_RTSP_STS_NOT_FOUND, ctx);
1533     return FALSE;
1534   }
1535 stream_not_found:
1536   {
1537     GST_ERROR ("client %p: stream '%s' not found", client, control);
1538     send_generic_response (client, GST_RTSP_STS_NOT_FOUND, ctx);
1539     g_object_unref (media);
1540     return FALSE;
1541   }
1542 service_unavailable:
1543   {
1544     GST_ERROR ("client %p: can't create session", client);
1545     send_generic_response (client, GST_RTSP_STS_SERVICE_UNAVAILABLE, ctx);
1546     g_object_unref (media);
1547     return FALSE;
1548   }
1549 sessmedia_unavailable:
1550   {
1551     GST_ERROR ("client %p: can't create session media", client);
1552     send_generic_response (client, GST_RTSP_STS_SERVICE_UNAVAILABLE, ctx);
1553     g_object_unref (media);
1554     g_object_unref (session);
1555     return FALSE;
1556   }
1557 invalid_blocksize:
1558   {
1559     GST_ERROR ("client %p: invalid blocksize", client);
1560     send_generic_response (client, GST_RTSP_STS_BAD_REQUEST, ctx);
1561     g_object_unref (session);
1562     return FALSE;
1563   }
1564 unsupported_transports:
1565   {
1566     GST_ERROR ("client %p: unsupported transports", client);
1567     send_generic_response (client, GST_RTSP_STS_UNSUPPORTED_TRANSPORT, ctx);
1568     gst_rtsp_transport_free (ct);
1569     g_object_unref (session);
1570     return FALSE;
1571   }
1572 unsupported_client_transport:
1573   {
1574     GST_ERROR ("client %p: unsupported client transport", client);
1575     send_generic_response (client, GST_RTSP_STS_UNSUPPORTED_TRANSPORT, ctx);
1576     gst_rtsp_transport_free (ct);
1577     g_object_unref (session);
1578     return FALSE;
1579   }
1580 }
1581
1582 static GstSDPMessage *
1583 create_sdp (GstRTSPClient * client, GstRTSPMedia * media)
1584 {
1585   GstRTSPClientPrivate *priv = client->priv;
1586   GstSDPMessage *sdp;
1587   GstSDPInfo info;
1588   const gchar *proto;
1589
1590   gst_sdp_message_new (&sdp);
1591
1592   /* some standard things first */
1593   gst_sdp_message_set_version (sdp, "0");
1594
1595   if (priv->is_ipv6)
1596     proto = "IP6";
1597   else
1598     proto = "IP4";
1599
1600   gst_sdp_message_set_origin (sdp, "-", "1188340656180883", "1", "IN", proto,
1601       priv->server_ip);
1602
1603   gst_sdp_message_set_session_name (sdp, "Session streamed with GStreamer");
1604   gst_sdp_message_set_information (sdp, "rtsp-server");
1605   gst_sdp_message_add_time (sdp, "0", "0", NULL);
1606   gst_sdp_message_add_attribute (sdp, "tool", "GStreamer");
1607   gst_sdp_message_add_attribute (sdp, "type", "broadcast");
1608   gst_sdp_message_add_attribute (sdp, "control", "*");
1609
1610   info.is_ipv6 = priv->is_ipv6;
1611   info.server_ip = priv->server_ip;
1612
1613   /* create an SDP for the media object */
1614   if (!gst_rtsp_sdp_from_media (sdp, &info, media))
1615     goto no_sdp;
1616
1617   return sdp;
1618
1619   /* ERRORS */
1620 no_sdp:
1621   {
1622     GST_ERROR ("client %p: could not create SDP", client);
1623     gst_sdp_message_free (sdp);
1624     return NULL;
1625   }
1626 }
1627
1628 /* for the describe we must generate an SDP */
1629 static gboolean
1630 handle_describe_request (GstRTSPClient * client, GstRTSPContext * ctx)
1631 {
1632   GstRTSPResult res;
1633   GstSDPMessage *sdp;
1634   guint i, str_len;
1635   gchar *str, *content_base;
1636   GstRTSPMedia *media;
1637   GstRTSPClientClass *klass;
1638
1639   klass = GST_RTSP_CLIENT_GET_CLASS (client);
1640
1641   if (!ctx->uri)
1642     goto no_uri;
1643
1644   /* check what kind of format is accepted, we don't really do anything with it
1645    * and always return SDP for now. */
1646   for (i = 0; i++;) {
1647     gchar *accept;
1648
1649     res =
1650         gst_rtsp_message_get_header (ctx->request, GST_RTSP_HDR_ACCEPT,
1651         &accept, i);
1652     if (res == GST_RTSP_ENOTIMPL)
1653       break;
1654
1655     if (g_ascii_strcasecmp (accept, "application/sdp") == 0)
1656       break;
1657   }
1658
1659   /* find the media object for the uri */
1660   if (!(media = find_media (client, ctx, NULL)))
1661     goto no_media;
1662
1663   /* create an SDP for the media object on this client */
1664   if (!(sdp = klass->create_sdp (client, media)))
1665     goto no_sdp;
1666
1667   g_object_unref (media);
1668
1669   gst_rtsp_message_init_response (ctx->response, GST_RTSP_STS_OK,
1670       gst_rtsp_status_as_text (GST_RTSP_STS_OK), ctx->request);
1671
1672   gst_rtsp_message_add_header (ctx->response, GST_RTSP_HDR_CONTENT_TYPE,
1673       "application/sdp");
1674
1675   /* content base for some clients that might screw up creating the setup uri */
1676   str = gst_rtsp_url_get_request_uri (ctx->uri);
1677   str_len = strlen (str);
1678
1679   /* check for trailing '/' and append one */
1680   if (str[str_len - 1] != '/') {
1681     content_base = g_malloc (str_len + 2);
1682     memcpy (content_base, str, str_len);
1683     content_base[str_len] = '/';
1684     content_base[str_len + 1] = '\0';
1685     g_free (str);
1686   } else {
1687     content_base = str;
1688   }
1689
1690   GST_INFO ("adding content-base: %s", content_base);
1691
1692   gst_rtsp_message_add_header (ctx->response, GST_RTSP_HDR_CONTENT_BASE,
1693       content_base);
1694   g_free (content_base);
1695
1696   /* add SDP to the response body */
1697   str = gst_sdp_message_as_text (sdp);
1698   gst_rtsp_message_take_body (ctx->response, (guint8 *) str, strlen (str));
1699   gst_sdp_message_free (sdp);
1700
1701   send_message (client, ctx->session, ctx->response, FALSE);
1702
1703   g_signal_emit (client, gst_rtsp_client_signals[SIGNAL_DESCRIBE_REQUEST],
1704       0, ctx);
1705
1706   return TRUE;
1707
1708   /* ERRORS */
1709 no_uri:
1710   {
1711     GST_ERROR ("client %p: no uri", client);
1712     send_generic_response (client, GST_RTSP_STS_BAD_REQUEST, ctx);
1713     return FALSE;
1714   }
1715 no_media:
1716   {
1717     GST_ERROR ("client %p: no media", client);
1718     /* error reply is already sent */
1719     return FALSE;
1720   }
1721 no_sdp:
1722   {
1723     GST_ERROR ("client %p: can't create SDP", client);
1724     send_generic_response (client, GST_RTSP_STS_SERVICE_UNAVAILABLE, ctx);
1725     g_object_unref (media);
1726     return FALSE;
1727   }
1728 }
1729
1730 static gboolean
1731 handle_options_request (GstRTSPClient * client, GstRTSPContext * ctx)
1732 {
1733   GstRTSPMethod options;
1734   gchar *str;
1735
1736   options = GST_RTSP_DESCRIBE |
1737       GST_RTSP_OPTIONS |
1738       GST_RTSP_PAUSE |
1739       GST_RTSP_PLAY |
1740       GST_RTSP_SETUP |
1741       GST_RTSP_GET_PARAMETER | GST_RTSP_SET_PARAMETER | GST_RTSP_TEARDOWN;
1742
1743   str = gst_rtsp_options_as_text (options);
1744
1745   gst_rtsp_message_init_response (ctx->response, GST_RTSP_STS_OK,
1746       gst_rtsp_status_as_text (GST_RTSP_STS_OK), ctx->request);
1747
1748   gst_rtsp_message_add_header (ctx->response, GST_RTSP_HDR_PUBLIC, str);
1749   g_free (str);
1750
1751   send_message (client, ctx->session, ctx->response, FALSE);
1752
1753   g_signal_emit (client, gst_rtsp_client_signals[SIGNAL_OPTIONS_REQUEST],
1754       0, ctx);
1755
1756   return TRUE;
1757 }
1758
1759 /* remove duplicate and trailing '/' */
1760 static void
1761 sanitize_uri (GstRTSPUrl * uri)
1762 {
1763   gint i, len;
1764   gchar *s, *d;
1765   gboolean have_slash, prev_slash;
1766
1767   s = d = uri->abspath;
1768   len = strlen (uri->abspath);
1769
1770   prev_slash = FALSE;
1771
1772   for (i = 0; i < len; i++) {
1773     have_slash = s[i] == '/';
1774     *d = s[i];
1775     if (!have_slash || !prev_slash)
1776       d++;
1777     prev_slash = have_slash;
1778   }
1779   len = d - uri->abspath;
1780   /* don't remove the first slash if that's the only thing left */
1781   if (len > 1 && *(d - 1) == '/')
1782     d--;
1783   *d = '\0';
1784 }
1785
1786 static void
1787 client_session_finalized (GstRTSPClient * client, GstRTSPSession * session)
1788 {
1789   GstRTSPClientPrivate *priv = client->priv;
1790
1791   GST_INFO ("client %p: session %p finished", client, session);
1792
1793   /* unlink all media managed in this session */
1794   client_unlink_session (client, session);
1795
1796   /* remove the session */
1797   if (!(priv->sessions = g_list_remove (priv->sessions, session))) {
1798     GST_INFO ("client %p: all sessions finalized, close the connection",
1799         client);
1800     close_connection (client);
1801   }
1802 }
1803
1804 static void
1805 handle_request (GstRTSPClient * client, GstRTSPMessage * request)
1806 {
1807   GstRTSPClientPrivate *priv = client->priv;
1808   GstRTSPMethod method;
1809   const gchar *uristr;
1810   GstRTSPUrl *uri = NULL;
1811   GstRTSPVersion version;
1812   GstRTSPResult res;
1813   GstRTSPSession *session = NULL;
1814   GstRTSPContext sctx = { NULL }, *ctx;
1815   GstRTSPMessage response = { 0 };
1816   gchar *sessid;
1817
1818   if (!(ctx = gst_rtsp_context_get_current ())) {
1819     ctx = &sctx;
1820     ctx->auth = priv->auth;
1821     gst_rtsp_context_push_current (ctx);
1822   }
1823
1824   ctx->conn = priv->connection;
1825   ctx->client = client;
1826   ctx->request = request;
1827   ctx->response = &response;
1828
1829   if (gst_debug_category_get_threshold (rtsp_client_debug) >= GST_LEVEL_LOG) {
1830     gst_rtsp_message_dump (request);
1831   }
1832
1833   GST_INFO ("client %p: received a request", client);
1834
1835   gst_rtsp_message_parse_request (request, &method, &uristr, &version);
1836
1837   /* we can only handle 1.0 requests */
1838   if (version != GST_RTSP_VERSION_1_0)
1839     goto not_supported;
1840
1841   ctx->method = method;
1842
1843   /* we always try to parse the url first */
1844   if (strcmp (uristr, "*") == 0) {
1845     /* special case where we have * as uri, keep uri = NULL */
1846   } else if (gst_rtsp_url_parse (uristr, &uri) != GST_RTSP_OK)
1847     goto bad_request;
1848
1849   /* get the session if there is any */
1850   res = gst_rtsp_message_get_header (request, GST_RTSP_HDR_SESSION, &sessid, 0);
1851   if (res == GST_RTSP_OK) {
1852     if (priv->session_pool == NULL)
1853       goto no_pool;
1854
1855     /* we had a session in the request, find it again */
1856     if (!(session = gst_rtsp_session_pool_find (priv->session_pool, sessid)))
1857       goto session_not_found;
1858
1859     /* we add the session to the client list of watched sessions. When a session
1860      * disappears because it times out, we will be notified. If all sessions are
1861      * gone, we will close the connection */
1862     client_watch_session (client, session);
1863   }
1864
1865   /* sanitize the uri */
1866   if (uri)
1867     sanitize_uri (uri);
1868   ctx->uri = uri;
1869   ctx->session = session;
1870
1871   if (!gst_rtsp_auth_check (GST_RTSP_AUTH_CHECK_URL))
1872     goto not_authorized;
1873
1874   /* now see what is asked and dispatch to a dedicated handler */
1875   switch (method) {
1876     case GST_RTSP_OPTIONS:
1877       handle_options_request (client, ctx);
1878       break;
1879     case GST_RTSP_DESCRIBE:
1880       handle_describe_request (client, ctx);
1881       break;
1882     case GST_RTSP_SETUP:
1883       handle_setup_request (client, ctx);
1884       break;
1885     case GST_RTSP_PLAY:
1886       handle_play_request (client, ctx);
1887       break;
1888     case GST_RTSP_PAUSE:
1889       handle_pause_request (client, ctx);
1890       break;
1891     case GST_RTSP_TEARDOWN:
1892       handle_teardown_request (client, ctx);
1893       break;
1894     case GST_RTSP_SET_PARAMETER:
1895       handle_set_param_request (client, ctx);
1896       break;
1897     case GST_RTSP_GET_PARAMETER:
1898       handle_get_param_request (client, ctx);
1899       break;
1900     case GST_RTSP_ANNOUNCE:
1901     case GST_RTSP_RECORD:
1902     case GST_RTSP_REDIRECT:
1903       goto not_implemented;
1904     case GST_RTSP_INVALID:
1905     default:
1906       goto bad_request;
1907   }
1908
1909 done:
1910   if (ctx == &sctx)
1911     gst_rtsp_context_pop_current (ctx);
1912   if (session)
1913     g_object_unref (session);
1914   if (uri)
1915     gst_rtsp_url_free (uri);
1916   return;
1917
1918   /* ERRORS */
1919 not_supported:
1920   {
1921     GST_ERROR ("client %p: version %d not supported", client, version);
1922     send_generic_response (client, GST_RTSP_STS_RTSP_VERSION_NOT_SUPPORTED,
1923         ctx);
1924     goto done;
1925   }
1926 bad_request:
1927   {
1928     GST_ERROR ("client %p: bad request", client);
1929     send_generic_response (client, GST_RTSP_STS_BAD_REQUEST, ctx);
1930     goto done;
1931   }
1932 no_pool:
1933   {
1934     GST_ERROR ("client %p: no pool configured", client);
1935     send_generic_response (client, GST_RTSP_STS_SESSION_NOT_FOUND, ctx);
1936     goto done;
1937   }
1938 session_not_found:
1939   {
1940     GST_ERROR ("client %p: session not found", client);
1941     send_generic_response (client, GST_RTSP_STS_SESSION_NOT_FOUND, ctx);
1942     goto done;
1943   }
1944 not_authorized:
1945   {
1946     GST_ERROR ("client %p: not allowed", client);
1947     goto done;
1948   }
1949 not_implemented:
1950   {
1951     GST_ERROR ("client %p: method %d not implemented", client, method);
1952     send_generic_response (client, GST_RTSP_STS_NOT_IMPLEMENTED, ctx);
1953     goto done;
1954   }
1955 }
1956
1957
1958 static void
1959 handle_response (GstRTSPClient * client, GstRTSPMessage * response)
1960 {
1961   GstRTSPClientPrivate *priv = client->priv;
1962   GstRTSPResult res;
1963   GstRTSPSession *session = NULL;
1964   GstRTSPContext sctx = { NULL }, *ctx;
1965   gchar *sessid;
1966
1967   if (!(ctx = gst_rtsp_context_get_current ())) {
1968     ctx = &sctx;
1969     ctx->auth = priv->auth;
1970     gst_rtsp_context_push_current (ctx);
1971   }
1972
1973   ctx->conn = priv->connection;
1974   ctx->client = client;
1975   ctx->request = NULL;
1976   ctx->uri = NULL;
1977   ctx->method = GST_RTSP_INVALID;
1978   ctx->response = response;
1979
1980   if (gst_debug_category_get_threshold (rtsp_client_debug) >= GST_LEVEL_LOG) {
1981     gst_rtsp_message_dump (response);
1982   }
1983
1984   GST_INFO ("client %p: received a response", client);
1985
1986   /* get the session if there is any */
1987   res =
1988       gst_rtsp_message_get_header (response, GST_RTSP_HDR_SESSION, &sessid, 0);
1989   if (res == GST_RTSP_OK) {
1990     if (priv->session_pool == NULL)
1991       goto no_pool;
1992
1993     /* we had a session in the request, find it again */
1994     if (!(session = gst_rtsp_session_pool_find (priv->session_pool, sessid)))
1995       goto session_not_found;
1996
1997     /* we add the session to the client list of watched sessions. When a session
1998      * disappears because it times out, we will be notified. If all sessions are
1999      * gone, we will close the connection */
2000     client_watch_session (client, session);
2001   }
2002
2003   ctx->session = session;
2004
2005   if (!gst_rtsp_auth_check (GST_RTSP_AUTH_CHECK_URL))
2006     goto not_authorized;
2007
2008   g_signal_emit (client, gst_rtsp_client_signals[SIGNAL_HANDLE_RESPONSE],
2009       0, ctx);
2010
2011 done:
2012   if (ctx == &sctx)
2013     gst_rtsp_context_pop_current (ctx);
2014   if (session)
2015     g_object_unref (session);
2016   return;
2017
2018 no_pool:
2019   {
2020     GST_ERROR ("client %p: no pool configured", client);
2021     goto done;
2022   }
2023 session_not_found:
2024   {
2025     GST_ERROR ("client %p: session not found", client);
2026     goto done;
2027   }
2028 not_authorized:
2029   {
2030     GST_ERROR ("client %p: not allowed", client);
2031     goto done;
2032   }
2033 }
2034
2035 static void
2036 handle_data (GstRTSPClient * client, GstRTSPMessage * message)
2037 {
2038   GstRTSPClientPrivate *priv = client->priv;
2039   GstRTSPResult res;
2040   guint8 channel;
2041   GList *walk;
2042   guint8 *data;
2043   guint size;
2044   GstBuffer *buffer;
2045   gboolean handled;
2046
2047   /* find the stream for this message */
2048   res = gst_rtsp_message_parse_data (message, &channel);
2049   if (res != GST_RTSP_OK)
2050     return;
2051
2052   gst_rtsp_message_steal_body (message, &data, &size);
2053
2054   buffer = gst_buffer_new_wrapped (data, size);
2055
2056   handled = FALSE;
2057   for (walk = priv->transports; walk; walk = g_list_next (walk)) {
2058     GstRTSPStreamTransport *trans;
2059     GstRTSPStream *stream;
2060     const GstRTSPTransport *tr;
2061
2062     trans = walk->data;
2063
2064     tr = gst_rtsp_stream_transport_get_transport (trans);
2065     stream = gst_rtsp_stream_transport_get_stream (trans);
2066
2067     /* check for TCP transport */
2068     if (tr->lower_transport == GST_RTSP_LOWER_TRANS_TCP) {
2069       /* dispatch to the stream based on the channel number */
2070       if (tr->interleaved.min == channel) {
2071         gst_rtsp_stream_recv_rtp (stream, buffer);
2072         handled = TRUE;
2073         break;
2074       } else if (tr->interleaved.max == channel) {
2075         gst_rtsp_stream_recv_rtcp (stream, buffer);
2076         handled = TRUE;
2077         break;
2078       }
2079     }
2080   }
2081   if (!handled)
2082     gst_buffer_unref (buffer);
2083 }
2084
2085 /**
2086  * gst_rtsp_client_set_session_pool:
2087  * @client: a #GstRTSPClient
2088  * @pool: a #GstRTSPSessionPool
2089  *
2090  * Set @pool as the sessionpool for @client which it will use to find
2091  * or allocate sessions. the sessionpool is usually inherited from the server
2092  * that created the client but can be overridden later.
2093  */
2094 void
2095 gst_rtsp_client_set_session_pool (GstRTSPClient * client,
2096     GstRTSPSessionPool * pool)
2097 {
2098   GstRTSPSessionPool *old;
2099   GstRTSPClientPrivate *priv;
2100
2101   g_return_if_fail (GST_IS_RTSP_CLIENT (client));
2102
2103   priv = client->priv;
2104
2105   if (pool)
2106     g_object_ref (pool);
2107
2108   g_mutex_lock (&priv->lock);
2109   old = priv->session_pool;
2110   priv->session_pool = pool;
2111   g_mutex_unlock (&priv->lock);
2112
2113   if (old)
2114     g_object_unref (old);
2115 }
2116
2117 /**
2118  * gst_rtsp_client_get_session_pool:
2119  * @client: a #GstRTSPClient
2120  *
2121  * Get the #GstRTSPSessionPool object that @client uses to manage its sessions.
2122  *
2123  * Returns: (transfer full): a #GstRTSPSessionPool, unref after usage.
2124  */
2125 GstRTSPSessionPool *
2126 gst_rtsp_client_get_session_pool (GstRTSPClient * client)
2127 {
2128   GstRTSPClientPrivate *priv;
2129   GstRTSPSessionPool *result;
2130
2131   g_return_val_if_fail (GST_IS_RTSP_CLIENT (client), NULL);
2132
2133   priv = client->priv;
2134
2135   g_mutex_lock (&priv->lock);
2136   if ((result = priv->session_pool))
2137     g_object_ref (result);
2138   g_mutex_unlock (&priv->lock);
2139
2140   return result;
2141 }
2142
2143 /**
2144  * gst_rtsp_client_set_mount_points:
2145  * @client: a #GstRTSPClient
2146  * @mounts: a #GstRTSPMountPoints
2147  *
2148  * Set @mounts as the mount points for @client which it will use to map urls
2149  * to media streams. These mount points are usually inherited from the server that
2150  * created the client but can be overriden later.
2151  */
2152 void
2153 gst_rtsp_client_set_mount_points (GstRTSPClient * client,
2154     GstRTSPMountPoints * mounts)
2155 {
2156   GstRTSPClientPrivate *priv;
2157   GstRTSPMountPoints *old;
2158
2159   g_return_if_fail (GST_IS_RTSP_CLIENT (client));
2160
2161   priv = client->priv;
2162
2163   if (mounts)
2164     g_object_ref (mounts);
2165
2166   g_mutex_lock (&priv->lock);
2167   old = priv->mount_points;
2168   priv->mount_points = mounts;
2169   g_mutex_unlock (&priv->lock);
2170
2171   if (old)
2172     g_object_unref (old);
2173 }
2174
2175 /**
2176  * gst_rtsp_client_get_mount_points:
2177  * @client: a #GstRTSPClient
2178  *
2179  * Get the #GstRTSPMountPoints object that @client uses to manage its sessions.
2180  *
2181  * Returns: (transfer full): a #GstRTSPMountPoints, unref after usage.
2182  */
2183 GstRTSPMountPoints *
2184 gst_rtsp_client_get_mount_points (GstRTSPClient * client)
2185 {
2186   GstRTSPClientPrivate *priv;
2187   GstRTSPMountPoints *result;
2188
2189   g_return_val_if_fail (GST_IS_RTSP_CLIENT (client), NULL);
2190
2191   priv = client->priv;
2192
2193   g_mutex_lock (&priv->lock);
2194   if ((result = priv->mount_points))
2195     g_object_ref (result);
2196   g_mutex_unlock (&priv->lock);
2197
2198   return result;
2199 }
2200
2201 /**
2202  * gst_rtsp_client_set_auth:
2203  * @client: a #GstRTSPClient
2204  * @auth: a #GstRTSPAuth
2205  *
2206  * configure @auth to be used as the authentication manager of @client.
2207  */
2208 void
2209 gst_rtsp_client_set_auth (GstRTSPClient * client, GstRTSPAuth * auth)
2210 {
2211   GstRTSPClientPrivate *priv;
2212   GstRTSPAuth *old;
2213
2214   g_return_if_fail (GST_IS_RTSP_CLIENT (client));
2215
2216   priv = client->priv;
2217
2218   if (auth)
2219     g_object_ref (auth);
2220
2221   g_mutex_lock (&priv->lock);
2222   old = priv->auth;
2223   priv->auth = auth;
2224   g_mutex_unlock (&priv->lock);
2225
2226   if (old)
2227     g_object_unref (old);
2228 }
2229
2230
2231 /**
2232  * gst_rtsp_client_get_auth:
2233  * @client: a #GstRTSPClient
2234  *
2235  * Get the #GstRTSPAuth used as the authentication manager of @client.
2236  *
2237  * Returns: (transfer full): the #GstRTSPAuth of @client. g_object_unref() after
2238  * usage.
2239  */
2240 GstRTSPAuth *
2241 gst_rtsp_client_get_auth (GstRTSPClient * client)
2242 {
2243   GstRTSPClientPrivate *priv;
2244   GstRTSPAuth *result;
2245
2246   g_return_val_if_fail (GST_IS_RTSP_CLIENT (client), NULL);
2247
2248   priv = client->priv;
2249
2250   g_mutex_lock (&priv->lock);
2251   if ((result = priv->auth))
2252     g_object_ref (result);
2253   g_mutex_unlock (&priv->lock);
2254
2255   return result;
2256 }
2257
2258 /**
2259  * gst_rtsp_client_set_thread_pool:
2260  * @client: a #GstRTSPClient
2261  * @pool: a #GstRTSPThreadPool
2262  *
2263  * configure @pool to be used as the thread pool of @client.
2264  */
2265 void
2266 gst_rtsp_client_set_thread_pool (GstRTSPClient * client,
2267     GstRTSPThreadPool * pool)
2268 {
2269   GstRTSPClientPrivate *priv;
2270   GstRTSPThreadPool *old;
2271
2272   g_return_if_fail (GST_IS_RTSP_CLIENT (client));
2273
2274   priv = client->priv;
2275
2276   if (pool)
2277     g_object_ref (pool);
2278
2279   g_mutex_lock (&priv->lock);
2280   old = priv->thread_pool;
2281   priv->thread_pool = pool;
2282   g_mutex_unlock (&priv->lock);
2283
2284   if (old)
2285     g_object_unref (old);
2286 }
2287
2288 /**
2289  * gst_rtsp_client_get_thread_pool:
2290  * @client: a #GstRTSPClient
2291  *
2292  * Get the #GstRTSPThreadPool used as the thread pool of @client.
2293  *
2294  * Returns: (transfer full): the #GstRTSPThreadPool of @client. g_object_unref() after
2295  * usage.
2296  */
2297 GstRTSPThreadPool *
2298 gst_rtsp_client_get_thread_pool (GstRTSPClient * client)
2299 {
2300   GstRTSPClientPrivate *priv;
2301   GstRTSPThreadPool *result;
2302
2303   g_return_val_if_fail (GST_IS_RTSP_CLIENT (client), NULL);
2304
2305   priv = client->priv;
2306
2307   g_mutex_lock (&priv->lock);
2308   if ((result = priv->thread_pool))
2309     g_object_ref (result);
2310   g_mutex_unlock (&priv->lock);
2311
2312   return result;
2313 }
2314
2315 /**
2316  * gst_rtsp_client_set_connection:
2317  * @client: a #GstRTSPClient
2318  * @conn: (transfer full): a #GstRTSPConnection
2319  *
2320  * Set the #GstRTSPConnection of @client. This function takes ownership of
2321  * @conn.
2322  *
2323  * Returns: %TRUE on success.
2324  */
2325 gboolean
2326 gst_rtsp_client_set_connection (GstRTSPClient * client,
2327     GstRTSPConnection * conn)
2328 {
2329   GstRTSPClientPrivate *priv;
2330   GSocket *read_socket;
2331   GSocketAddress *address;
2332   GstRTSPUrl *url;
2333   GError *error = NULL;
2334
2335   g_return_val_if_fail (GST_IS_RTSP_CLIENT (client), FALSE);
2336   g_return_val_if_fail (conn != NULL, FALSE);
2337
2338   priv = client->priv;
2339
2340   read_socket = gst_rtsp_connection_get_read_socket (conn);
2341
2342   if (!(address = g_socket_get_local_address (read_socket, &error)))
2343     goto no_address;
2344
2345   g_free (priv->server_ip);
2346   /* keep the original ip that the client connected to */
2347   if (G_IS_INET_SOCKET_ADDRESS (address)) {
2348     GInetAddress *iaddr;
2349
2350     iaddr = g_inet_socket_address_get_address (G_INET_SOCKET_ADDRESS (address));
2351
2352     /* socket might be ipv6 but adress still ipv4 */
2353     priv->is_ipv6 = g_inet_address_get_family (iaddr) == G_SOCKET_FAMILY_IPV6;
2354     priv->server_ip = g_inet_address_to_string (iaddr);
2355     g_object_unref (address);
2356   } else {
2357     priv->is_ipv6 = g_socket_get_family (read_socket) == G_SOCKET_FAMILY_IPV6;
2358     priv->server_ip = g_strdup ("unknown");
2359   }
2360
2361   GST_INFO ("client %p connected to server ip %s, ipv6 = %d", client,
2362       priv->server_ip, priv->is_ipv6);
2363
2364   url = gst_rtsp_connection_get_url (conn);
2365   GST_INFO ("added new client %p ip %s:%d", client, url->host, url->port);
2366
2367   priv->connection = conn;
2368
2369   return TRUE;
2370
2371   /* ERRORS */
2372 no_address:
2373   {
2374     GST_ERROR ("could not get local address %s", error->message);
2375     g_error_free (error);
2376     return FALSE;
2377   }
2378 }
2379
2380 /**
2381  * gst_rtsp_client_get_connection:
2382  * @client: a #GstRTSPClient
2383  *
2384  * Get the #GstRTSPConnection of @client.
2385  *
2386  * Returns: (transfer none): the #GstRTSPConnection of @client.
2387  * The connection object returned remains valid until the client is freed.
2388  */
2389 GstRTSPConnection *
2390 gst_rtsp_client_get_connection (GstRTSPClient * client)
2391 {
2392   g_return_val_if_fail (GST_IS_RTSP_CLIENT (client), NULL);
2393
2394   return client->priv->connection;
2395 }
2396
2397 /**
2398  * gst_rtsp_client_set_send_func:
2399  * @client: a #GstRTSPClient
2400  * @func: a #GstRTSPClientSendFunc
2401  * @user_data: user data passed to @func
2402  * @notify: called when @user_data is no longer in use
2403  *
2404  * Set @func as the callback that will be called when a new message needs to be
2405  * sent to the client. @user_data is passed to @func and @notify is called when
2406  * @user_data is no longer in use.
2407  *
2408  * By default, the client will send the messages on the #GstRTSPConnection that
2409  * was configured with gst_rtsp_client_attach() was called.
2410  */
2411 void
2412 gst_rtsp_client_set_send_func (GstRTSPClient * client,
2413     GstRTSPClientSendFunc func, gpointer user_data, GDestroyNotify notify)
2414 {
2415   GstRTSPClientPrivate *priv;
2416   GDestroyNotify old_notify;
2417   gpointer old_data;
2418
2419   g_return_if_fail (GST_IS_RTSP_CLIENT (client));
2420
2421   priv = client->priv;
2422
2423   g_mutex_lock (&priv->send_lock);
2424   priv->send_func = func;
2425   old_notify = priv->send_notify;
2426   old_data = priv->send_data;
2427   priv->send_notify = notify;
2428   priv->send_data = user_data;
2429   g_mutex_unlock (&priv->send_lock);
2430
2431   if (old_notify)
2432     old_notify (old_data);
2433 }
2434
2435 /**
2436  * gst_rtsp_client_handle_message:
2437  * @client: a #GstRTSPClient
2438  * @message: an #GstRTSPMessage
2439  *
2440  * Let the client handle @message.
2441  *
2442  * Returns: a #GstRTSPResult.
2443  */
2444 GstRTSPResult
2445 gst_rtsp_client_handle_message (GstRTSPClient * client,
2446     GstRTSPMessage * message)
2447 {
2448   g_return_val_if_fail (GST_IS_RTSP_CLIENT (client), GST_RTSP_EINVAL);
2449   g_return_val_if_fail (message != NULL, GST_RTSP_EINVAL);
2450
2451   switch (message->type) {
2452     case GST_RTSP_MESSAGE_REQUEST:
2453       handle_request (client, message);
2454       break;
2455     case GST_RTSP_MESSAGE_RESPONSE:
2456       handle_response (client, message);
2457       break;
2458     case GST_RTSP_MESSAGE_DATA:
2459       handle_data (client, message);
2460       break;
2461     default:
2462       break;
2463   }
2464   return GST_RTSP_OK;
2465 }
2466
2467 /**
2468  * gst_rtsp_client_send_message:
2469  * @client: a #GstRTSPClient
2470  * @session: a #GstRTSPSession to send the message to or %NULL
2471  * @message: The #GstRTSPMessage to send
2472  *
2473  * Send a message message to the remote end. @message must be a
2474  * #GST_RTSP_MESSAGE_REQUEST or a #GST_RTSP_MESSAGE_RESPONSE.
2475  */
2476 GstRTSPResult
2477 gst_rtsp_client_send_message (GstRTSPClient * client, GstRTSPSession * session,
2478     GstRTSPMessage * message)
2479 {
2480   g_return_val_if_fail (GST_IS_RTSP_CLIENT (client), GST_RTSP_EINVAL);
2481   g_return_val_if_fail (message != NULL, GST_RTSP_EINVAL);
2482   g_return_val_if_fail (message->type == GST_RTSP_MESSAGE_REQUEST ||
2483       message->type == GST_RTSP_MESSAGE_RESPONSE, GST_RTSP_EINVAL);
2484
2485   send_message (client, session, message, FALSE);
2486
2487   return GST_RTSP_OK;
2488 }
2489
2490 static GstRTSPResult
2491 do_send_message (GstRTSPClient * client, GstRTSPMessage * message,
2492     gboolean close, gpointer user_data)
2493 {
2494   GstRTSPClientPrivate *priv = client->priv;
2495
2496   /* send the response and store the seq number so we can wait until it's
2497    * written to the client to close the connection */
2498   return gst_rtsp_watch_send_message (priv->watch, message, close ?
2499       &priv->close_seq : NULL);
2500 }
2501
2502 static GstRTSPResult
2503 message_received (GstRTSPWatch * watch, GstRTSPMessage * message,
2504     gpointer user_data)
2505 {
2506   return gst_rtsp_client_handle_message (GST_RTSP_CLIENT (user_data), message);
2507 }
2508
2509 static GstRTSPResult
2510 message_sent (GstRTSPWatch * watch, guint cseq, gpointer user_data)
2511 {
2512   GstRTSPClient *client = GST_RTSP_CLIENT (user_data);
2513   GstRTSPClientPrivate *priv = client->priv;
2514
2515   if (priv->close_seq && priv->close_seq == cseq) {
2516     priv->close_seq = 0;
2517     close_connection (client);
2518   }
2519
2520   return GST_RTSP_OK;
2521 }
2522
2523 static GstRTSPResult
2524 closed (GstRTSPWatch * watch, gpointer user_data)
2525 {
2526   GstRTSPClient *client = GST_RTSP_CLIENT (user_data);
2527   GstRTSPClientPrivate *priv = client->priv;
2528   const gchar *tunnelid;
2529
2530   GST_INFO ("client %p: connection closed", client);
2531
2532   if ((tunnelid = gst_rtsp_connection_get_tunnelid (priv->connection))) {
2533     g_mutex_lock (&tunnels_lock);
2534     /* remove from tunnelids */
2535     g_hash_table_remove (tunnels, tunnelid);
2536     g_mutex_unlock (&tunnels_lock);
2537   }
2538
2539   gst_rtsp_client_set_send_func (client, NULL, NULL, NULL);
2540
2541   return GST_RTSP_OK;
2542 }
2543
2544 static GstRTSPResult
2545 error (GstRTSPWatch * watch, GstRTSPResult result, gpointer user_data)
2546 {
2547   GstRTSPClient *client = GST_RTSP_CLIENT (user_data);
2548   gchar *str;
2549
2550   str = gst_rtsp_strresult (result);
2551   GST_INFO ("client %p: received an error %s", client, str);
2552   g_free (str);
2553
2554   return GST_RTSP_OK;
2555 }
2556
2557 static GstRTSPResult
2558 error_full (GstRTSPWatch * watch, GstRTSPResult result,
2559     GstRTSPMessage * message, guint id, gpointer user_data)
2560 {
2561   GstRTSPClient *client = GST_RTSP_CLIENT (user_data);
2562   gchar *str;
2563
2564   str = gst_rtsp_strresult (result);
2565   GST_INFO
2566       ("client %p: error when handling message %p with id %d: %s",
2567       client, message, id, str);
2568   g_free (str);
2569
2570   return GST_RTSP_OK;
2571 }
2572
2573 static gboolean
2574 remember_tunnel (GstRTSPClient * client)
2575 {
2576   GstRTSPClientPrivate *priv = client->priv;
2577   const gchar *tunnelid;
2578
2579   /* store client in the pending tunnels */
2580   tunnelid = gst_rtsp_connection_get_tunnelid (priv->connection);
2581   if (tunnelid == NULL)
2582     goto no_tunnelid;
2583
2584   GST_INFO ("client %p: inserting tunnel session %s", client, tunnelid);
2585
2586   /* we can't have two clients connecting with the same tunnelid */
2587   g_mutex_lock (&tunnels_lock);
2588   if (g_hash_table_lookup (tunnels, tunnelid))
2589     goto tunnel_existed;
2590
2591   g_hash_table_insert (tunnels, g_strdup (tunnelid), g_object_ref (client));
2592   g_mutex_unlock (&tunnels_lock);
2593
2594   return TRUE;
2595
2596   /* ERRORS */
2597 no_tunnelid:
2598   {
2599     GST_ERROR ("client %p: no tunnelid provided", client);
2600     return FALSE;
2601   }
2602 tunnel_existed:
2603   {
2604     g_mutex_unlock (&tunnels_lock);
2605     GST_ERROR ("client %p: tunnel session %s already existed", client,
2606         tunnelid);
2607     return FALSE;
2608   }
2609 }
2610
2611 static GstRTSPStatusCode
2612 tunnel_start (GstRTSPWatch * watch, gpointer user_data)
2613 {
2614   GstRTSPClient *client = GST_RTSP_CLIENT (user_data);
2615   GstRTSPClientPrivate *priv = client->priv;
2616
2617   GST_INFO ("client %p: tunnel start (connection %p)", client,
2618       priv->connection);
2619
2620   if (!remember_tunnel (client))
2621     goto tunnel_error;
2622
2623   return GST_RTSP_STS_OK;
2624
2625   /* ERRORS */
2626 tunnel_error:
2627   {
2628     GST_ERROR ("client %p: error starting tunnel", client);
2629     return GST_RTSP_STS_SERVICE_UNAVAILABLE;
2630   }
2631 }
2632
2633 static GstRTSPResult
2634 tunnel_lost (GstRTSPWatch * watch, gpointer user_data)
2635 {
2636   GstRTSPClient *client = GST_RTSP_CLIENT (user_data);
2637   GstRTSPClientPrivate *priv = client->priv;
2638
2639   GST_WARNING ("client %p: tunnel lost (connection %p)", client,
2640       priv->connection);
2641
2642   /* ignore error, it'll only be a problem when the client does a POST again */
2643   remember_tunnel (client);
2644
2645   return GST_RTSP_OK;
2646 }
2647
2648 static GstRTSPResult
2649 tunnel_complete (GstRTSPWatch * watch, gpointer user_data)
2650 {
2651   const gchar *tunnelid;
2652   GstRTSPClient *client = GST_RTSP_CLIENT (user_data);
2653   GstRTSPClientPrivate *priv = client->priv;
2654   GstRTSPClient *oclient;
2655   GstRTSPClientPrivate *opriv;
2656
2657   GST_INFO ("client %p: tunnel complete", client);
2658
2659   /* find previous tunnel */
2660   tunnelid = gst_rtsp_connection_get_tunnelid (priv->connection);
2661   if (tunnelid == NULL)
2662     goto no_tunnelid;
2663
2664   g_mutex_lock (&tunnels_lock);
2665   if (!(oclient = g_hash_table_lookup (tunnels, tunnelid)))
2666     goto no_tunnel;
2667
2668   /* remove the old client from the table. ref before because removing it will
2669    * remove the ref to it. */
2670   g_object_ref (oclient);
2671   g_hash_table_remove (tunnels, tunnelid);
2672
2673   opriv = oclient->priv;
2674
2675   if (opriv->watch == NULL)
2676     goto tunnel_closed;
2677   g_mutex_unlock (&tunnels_lock);
2678
2679   GST_INFO ("client %p: found tunnel %p (old %p, new %p)", client, oclient,
2680       opriv->connection, priv->connection);
2681
2682   /* merge the tunnels into the first client */
2683   gst_rtsp_connection_do_tunnel (opriv->connection, priv->connection);
2684   gst_rtsp_watch_reset (opriv->watch);
2685   g_object_unref (oclient);
2686
2687   return GST_RTSP_OK;
2688
2689   /* ERRORS */
2690 no_tunnelid:
2691   {
2692     GST_ERROR ("client %p: no tunnelid provided", client);
2693     return GST_RTSP_ERROR;
2694   }
2695 no_tunnel:
2696   {
2697     g_mutex_unlock (&tunnels_lock);
2698     GST_ERROR ("client %p: tunnel session %s not found", client, tunnelid);
2699     return GST_RTSP_ERROR;
2700   }
2701 tunnel_closed:
2702   {
2703     g_mutex_unlock (&tunnels_lock);
2704     GST_ERROR ("client %p: tunnel session %s was closed", client, tunnelid);
2705     g_object_unref (oclient);
2706     return GST_RTSP_ERROR;
2707   }
2708 }
2709
2710 static GstRTSPWatchFuncs watch_funcs = {
2711   message_received,
2712   message_sent,
2713   closed,
2714   error,
2715   tunnel_start,
2716   tunnel_complete,
2717   error_full,
2718   tunnel_lost
2719 };
2720
2721 static void
2722 client_watch_notify (GstRTSPClient * client)
2723 {
2724   GstRTSPClientPrivate *priv = client->priv;
2725
2726   GST_INFO ("client %p: watch destroyed", client);
2727   priv->watch = NULL;
2728   g_signal_emit (client, gst_rtsp_client_signals[SIGNAL_CLOSED], 0, NULL);
2729   g_object_unref (client);
2730 }
2731
2732 /**
2733  * gst_rtsp_client_attach:
2734  * @client: a #GstRTSPClient
2735  * @context: (allow-none): a #GMainContext
2736  *
2737  * Attaches @client to @context. When the mainloop for @context is run, the
2738  * client will be dispatched. When @context is NULL, the default context will be
2739  * used).
2740  *
2741  * This function should be called when the client properties and urls are fully
2742  * configured and the client is ready to start.
2743  *
2744  * Returns: the ID (greater than 0) for the source within the GMainContext.
2745  */
2746 guint
2747 gst_rtsp_client_attach (GstRTSPClient * client, GMainContext * context)
2748 {
2749   GstRTSPClientPrivate *priv;
2750   guint res;
2751
2752   g_return_val_if_fail (GST_IS_RTSP_CLIENT (client), 0);
2753   priv = client->priv;
2754   g_return_val_if_fail (priv->connection != NULL, 0);
2755   g_return_val_if_fail (priv->watch == NULL, 0);
2756
2757   /* create watch for the connection and attach */
2758   priv->watch = gst_rtsp_watch_new (priv->connection, &watch_funcs,
2759       g_object_ref (client), (GDestroyNotify) client_watch_notify);
2760   gst_rtsp_client_set_send_func (client, do_send_message, priv->watch,
2761       (GDestroyNotify) gst_rtsp_watch_unref);
2762
2763   /* FIXME make this configurable. We don't want to do this yet because it will
2764    * be superceeded by a cache object later */
2765   gst_rtsp_watch_set_send_backlog (priv->watch, 0, 100);
2766
2767   GST_INFO ("attaching to context %p", context);
2768   res = gst_rtsp_watch_attach (priv->watch, context);
2769
2770   return res;
2771 }
2772
2773 /**
2774  * gst_rtsp_client_session_filter:
2775  * @client: a #GstRTSPClient
2776  * @func: (scope call): a callback
2777  * @user_data: user data passed to @func
2778  *
2779  * Call @func for each session managed by @client. The result value of @func
2780  * determines what happens to the session. @func will be called with @client
2781  * locked so no further actions on @client can be performed from @func.
2782  *
2783  * If @func returns #GST_RTSP_FILTER_REMOVE, the session will be removed from
2784  * @client.
2785  *
2786  * If @func returns #GST_RTSP_FILTER_KEEP, the session will remain in @client.
2787  *
2788  * If @func returns #GST_RTSP_FILTER_REF, the session will remain in @client but
2789  * will also be added with an additional ref to the result #GList of this
2790  * function..
2791  *
2792  * Returns: (element-type GstRTSPSession) (transfer full): a #GList with all
2793  * sessions for which @func returned #GST_RTSP_FILTER_REF. After usage, each
2794  * element in the #GList should be unreffed before the list is freed.
2795  */
2796 GList *
2797 gst_rtsp_client_session_filter (GstRTSPClient * client,
2798     GstRTSPClientSessionFilterFunc func, gpointer user_data)
2799 {
2800   GstRTSPClientPrivate *priv;
2801   GList *result, *walk, *next;
2802
2803   g_return_val_if_fail (GST_IS_RTSP_CLIENT (client), NULL);
2804   g_return_val_if_fail (func != NULL, NULL);
2805
2806   priv = client->priv;
2807
2808   result = NULL;
2809
2810   g_mutex_lock (&priv->lock);
2811   for (walk = priv->sessions; walk; walk = next) {
2812     GstRTSPSession *sess = walk->data;
2813
2814     next = g_list_next (walk);
2815
2816     switch (func (client, sess, user_data)) {
2817       case GST_RTSP_FILTER_REMOVE:
2818         /* stop watching the session and pretent it went away */
2819         client_cleanup_session (client, sess);
2820         break;
2821       case GST_RTSP_FILTER_REF:
2822         result = g_list_prepend (result, g_object_ref (sess));
2823         break;
2824       case GST_RTSP_FILTER_KEEP:
2825       default:
2826         break;
2827     }
2828   }
2829   g_mutex_unlock (&priv->lock);
2830
2831   return result;
2832 }