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