]> git.sesse.net Git - vlc/blob - modules/demux/live555.cpp
live555: handle buffer resize error cases
[vlc] / modules / demux / live555.cpp
1 /*****************************************************************************
2  * live555.cpp : LIVE555 Streaming Media support.
3  *****************************************************************************
4  * Copyright (C) 2003-2007 the VideoLAN team
5  * $Id$
6  *
7  * Authors: Laurent Aimar <fenrir@via.ecp.fr>
8  *          Derk-Jan Hartman <hartman at videolan. org>
9  *          Derk-Jan Hartman <djhartman at m2x .dot. nl> for M2X
10  *
11  * This program is free software; you can redistribute it and/or modify
12  * it under the terms of the GNU General Public License as published by
13  * the Free Software Foundation; either version 2 of the License, or
14  * (at your option) any later version.
15  *
16  * This program is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19  * GNU General Public License for more details.
20  *
21  * You should have received a copy of the GNU General Public License along
22  * with this program; if not, write to the Free Software Foundation, Inc.,
23  * 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
24  *****************************************************************************/
25
26 /*****************************************************************************
27  * Preamble
28  *****************************************************************************/
29
30 /* For inttypes.h
31  * Note: config.h may include inttypes.h, so make sure we define this option
32  * early enough. */
33 #define __STDC_CONSTANT_MACROS 1
34
35 #ifdef HAVE_CONFIG_H
36 # include "config.h"
37 #endif
38
39 #include <inttypes.h>
40
41 #include <vlc_common.h>
42 #include <vlc_plugin.h>
43 #include <vlc_input.h>
44 #include <vlc_demux.h>
45 #include <vlc_dialog.h>
46 #include <vlc_network.h>
47 #include <vlc_url.h>
48 #include <vlc_strings.h>
49
50 #include <iostream>
51 #include <limits.h>
52 #include <assert.h>
53
54
55 #if defined( WIN32 )
56 #   include <winsock2.h>
57 #endif
58
59 #include "UsageEnvironment.hh"
60 #include "BasicUsageEnvironment.hh"
61 #include "GroupsockHelper.hh"
62 #include "liveMedia.hh"
63
64 extern "C" {
65 #include "../access/mms/asf.h"  /* Who said ugly ? */
66 }
67
68 using namespace std;
69
70 /*****************************************************************************
71  * Module descriptor
72  *****************************************************************************/
73 static int  Open ( vlc_object_t * );
74 static void Close( vlc_object_t * );
75
76 #define CACHING_TEXT N_("Caching value (ms)")
77 #define CACHING_LONGTEXT N_( \
78     "Allows you to modify the default caching value for RTSP streams. This " \
79     "value should be set in millisecond units." )
80
81 #define KASENNA_TEXT N_( "Kasenna RTSP dialect")
82 #define KASENNA_LONGTEXT N_( "Kasenna servers use an old and nonstandard " \
83     "dialect of RTSP. With this parameter VLC will try this dialect, but "\
84     "then it cannot connect to normal RTSP servers." )
85
86 #define USER_TEXT N_("RTSP user name")
87 #define USER_LONGTEXT N_("Sets the username for the connection, " \
88     "if no username or password are set in the url.")
89 #define PASS_TEXT N_("RTSP password")
90 #define PASS_LONGTEXT N_("Sets the password for the connection, " \
91     "if no username or password are set in the url.")
92
93 vlc_module_begin ()
94     set_description( N_("RTP/RTSP/SDP demuxer (using Live555)" ) )
95     set_capability( "demux", 50 )
96     set_shortname( "RTP/RTSP")
97     set_callbacks( Open, Close )
98     add_shortcut( "live" )
99     add_shortcut( "livedotcom" )
100     set_category( CAT_INPUT )
101     set_subcategory( SUBCAT_INPUT_DEMUX )
102
103     add_submodule ()
104         set_description( N_("RTSP/RTP access and demux") )
105         add_shortcut( "rtsp" )
106         add_shortcut( "sdp" )
107         add_shortcut( "live" )
108         add_shortcut( "livedotcom" )
109         set_capability( "access_demux", 0 )
110         set_callbacks( Open, Close )
111         add_bool( "rtsp-tcp", 0, NULL,
112                   N_("Use RTP over RTSP (TCP)"),
113                   N_("Use RTP over RTSP (TCP)"), true )
114             change_safe()
115         add_integer( "rtp-client-port", -1, NULL,
116                   N_("Client port"),
117                   N_("Port to use for the RTP source of the session"), true )
118         add_bool( "rtsp-mcast", false, NULL,
119                   N_("Force multicast RTP via RTSP"),
120                   N_("Force multicast RTP via RTSP"), true )
121             change_safe()
122         add_bool( "rtsp-http", 0, NULL,
123                   N_("Tunnel RTSP and RTP over HTTP"),
124                   N_("Tunnel RTSP and RTP over HTTP"), true )
125             change_safe()
126         add_integer( "rtsp-http-port", 80, NULL,
127                   N_("HTTP tunnel port"),
128                   N_("Port to use for tunneling the RTSP/RTP over HTTP."),
129                   true )
130         add_integer("rtsp-caching", 4 * DEFAULT_PTS_DELAY / 1000, NULL,
131                     CACHING_TEXT, CACHING_LONGTEXT, true )
132             change_safe()
133         add_bool(   "rtsp-kasenna", false, NULL, KASENNA_TEXT,
134                     KASENNA_LONGTEXT, true )
135         add_string( "rtsp-user", NULL, NULL, USER_TEXT,
136                     USER_LONGTEXT, true )
137         add_string( "rtsp-pwd", NULL, NULL, PASS_TEXT,
138                     PASS_LONGTEXT, true )
139 vlc_module_end ()
140
141
142 /*****************************************************************************
143  * Local prototypes
144  *****************************************************************************/
145
146 typedef struct
147 {
148     demux_t         *p_demux;
149     MediaSubsession *sub;
150
151     es_format_t     fmt;
152     es_out_id_t     *p_es;
153
154     bool            b_muxed;
155     bool            b_quicktime;
156     bool            b_asf;
157     stream_t        *p_out_muxed;    /* for muxed stream */
158
159     uint8_t         *p_buffer;
160     unsigned int    i_buffer;
161
162     bool            b_rtcp_sync;
163     char            waiting;
164     int64_t         i_pts;
165     float           i_npt;
166
167 } live_track_t;
168
169 struct timeout_thread_t
170 {
171     demux_sys_t  *p_sys;
172     vlc_thread_t handle;
173     bool         b_handle_keep_alive;
174 };
175
176 struct demux_sys_t
177 {
178     char            *p_sdp;    /* XXX mallocated */
179     char            *psz_path; /* URL-encoded path */
180     vlc_url_t       url;
181
182     MediaSession     *ms;
183     TaskScheduler    *scheduler;
184     UsageEnvironment *env ;
185     RTSPClient       *rtsp;
186
187     /* */
188     int              i_track;
189     live_track_t     **track;   /* XXX mallocated */
190
191     /* Weird formats */
192     asf_header_t     asfh;
193     stream_t         *p_out_asf;
194     bool             b_real;
195
196     /* */
197     int64_t          i_pcr; /* The clock */
198     float            i_npt;
199     float            i_npt_length;
200     float            i_npt_start;
201
202     /* timeout thread information */
203     int              i_timeout;     /* session timeout value in seconds */
204     bool             b_timeout_call;/* mark to send an RTSP call to prevent server timeout */
205     timeout_thread_t *p_timeout;    /* the actual thread that makes sure we don't timeout */
206
207     /* */
208     bool             b_force_mcast;
209     bool             b_multicast;   /* if one of the tracks is multicasted */
210     bool             b_no_data;     /* if we never received any data */
211     int              i_no_data_ti;  /* consecutive number of TaskInterrupt */
212
213     char             event;
214
215     bool             b_get_param;   /* Does the server support GET_PARAMETER */
216 };
217
218 static int Demux  ( demux_t * );
219 static int Control( demux_t *, int, va_list );
220
221 static int Connect      ( demux_t * );
222 static int SessionsSetup( demux_t * );
223 static int Play         ( demux_t *);
224 static int ParseASF     ( demux_t * );
225 static int RollOverTcp  ( demux_t * );
226
227 static void StreamRead  ( void *, unsigned int, unsigned int,
228                           struct timeval, unsigned int );
229 static void StreamClose ( void * );
230 static void TaskInterrupt( void * );
231
232 static void* TimeoutPrevention( void * );
233
234 static unsigned char* parseH264ConfigStr( char const* configStr,
235                                           unsigned int& configSize );
236
237 /*****************************************************************************
238  * DemuxOpen:
239  *****************************************************************************/
240 static int  Open ( vlc_object_t *p_this )
241 {
242     demux_t     *p_demux = (demux_t*)p_this;
243     demux_sys_t *p_sys = NULL;
244
245     int i, i_return;
246     int i_error = VLC_EGENERIC;
247
248     if( p_demux->s )
249     {
250         /* See if it looks like a SDP
251            v, o, s fields are mandatory and in this order */
252         const uint8_t *p_peek;
253         if( stream_Peek( p_demux->s, &p_peek, 7 ) < 7 ) return VLC_EGENERIC;
254
255         if( memcmp( p_peek, "v=0\r\n", 5 ) &&
256             memcmp( p_peek, "v=0\n", 4 ) &&
257             ( p_peek[0] < 'a' || p_peek[0] > 'z' || p_peek[1] != '=' ) )
258         {
259             return VLC_EGENERIC;
260         }
261     }
262     else
263     {
264         var_Create( p_demux, "rtsp-caching", VLC_VAR_INTEGER|VLC_VAR_DOINHERIT );
265     }
266
267     p_demux->pf_demux  = Demux;
268     p_demux->pf_control= Control;
269     p_demux->p_sys     = p_sys = (demux_sys_t*)malloc( sizeof( demux_sys_t ) );
270     if( !p_sys ) return VLC_ENOMEM;
271
272     p_sys->p_sdp = NULL;
273     p_sys->scheduler = NULL;
274     p_sys->env = NULL;
275     p_sys->ms = NULL;
276     p_sys->rtsp = NULL;
277     p_sys->i_track = 0;
278     p_sys->track   = NULL;
279     p_sys->i_pcr = 0;
280     p_sys->i_npt = 0.;
281     p_sys->i_npt_start = 0.;
282     p_sys->i_npt_length = 0.;
283     p_sys->p_out_asf = NULL;
284     p_sys->b_no_data = true;
285     p_sys->i_no_data_ti = 0;
286     p_sys->p_timeout = NULL;
287     p_sys->i_timeout = 0;
288     p_sys->b_timeout_call = false;
289     p_sys->b_multicast = false;
290     p_sys->b_real = false;
291     p_sys->psz_path = strdup( p_demux->psz_path );
292     p_sys->b_force_mcast = var_CreateGetBool( p_demux, "rtsp-mcast" );
293     p_sys->b_get_param = false;
294
295     /* parse URL for rtsp://[user:[passwd]@]serverip:port/options */
296     vlc_UrlParse( &p_sys->url, p_sys->psz_path, 0 );
297
298     if( ( p_sys->scheduler = BasicTaskScheduler::createNew() ) == NULL )
299     {
300         msg_Err( p_demux, "BasicTaskScheduler::createNew failed" );
301         goto error;
302     }
303     if( !( p_sys->env = BasicUsageEnvironment::createNew(*p_sys->scheduler) ) )
304     {
305         msg_Err( p_demux, "BasicUsageEnvironment::createNew failed" );
306         goto error;
307     }
308
309     if( strcasecmp( p_demux->psz_access, "sdp" ) )
310     {
311         char *p = p_sys->psz_path;
312         while( (p = strchr( p, ' ' )) != NULL ) *p = '+';
313     }
314
315     if( p_demux->s != NULL )
316     {
317         /* Gather the complete sdp file */
318         int     i_sdp       = 0;
319         int     i_sdp_max   = 1000;
320         uint8_t *p_sdp      = (uint8_t*) malloc( i_sdp_max );
321
322         if( !p_sdp )
323         {
324             i_error = VLC_ENOMEM;
325             goto error;
326         }
327
328         for( ;; )
329         {
330             int i_read = stream_Read( p_demux->s, &p_sdp[i_sdp],
331                                       i_sdp_max - i_sdp - 1 );
332
333             if( !vlc_object_alive (p_demux) || p_demux->b_error )
334             {
335                 free( p_sdp );
336                 goto error;
337             }
338
339             if( i_read < 0 )
340             {
341                 msg_Err( p_demux, "failed to read SDP" );
342                 free( p_sdp );
343                 goto error;
344             }
345
346             i_sdp += i_read;
347
348             if( i_read < i_sdp_max - i_sdp - 1 )
349             {
350                 p_sdp[i_sdp] = '\0';
351                 break;
352             }
353
354             i_sdp_max += 1000;
355             p_sdp = (uint8_t*)realloc( p_sdp, i_sdp_max );
356         }
357         p_sys->p_sdp = (char*)p_sdp;
358     }
359     else if( ( p_demux->s == NULL ) &&
360              !strcasecmp( p_demux->psz_access, "sdp" ) )
361     {
362         /* sdp:// link from SAP */
363         p_sys->p_sdp = strdup( p_sys->psz_path );
364     }
365     else if( ( i_return = Connect( p_demux ) ) != VLC_SUCCESS )
366     {
367         msg_Err( p_demux, "Failed to connect with rtsp://%s", p_sys->psz_path );
368         goto error;
369     }
370
371     if( p_sys->p_sdp == NULL )
372     {
373         msg_Err( p_demux, "Failed to retrieve the RTSP Session Description" );
374         i_error = VLC_ENOMEM;
375         goto error;
376     }
377
378     if( ( i_return = SessionsSetup( p_demux ) ) != VLC_SUCCESS )
379     {
380         msg_Err( p_demux, "Nothing to play for rtsp://%s", p_sys->psz_path );
381         goto error;
382     }
383
384     if( p_sys->b_real ) goto error;
385
386     if( ( i_return = Play( p_demux ) ) != VLC_SUCCESS )
387         goto error;
388
389     if( p_sys->p_out_asf && ParseASF( p_demux ) )
390     {
391         msg_Err( p_demux, "cannot find a usable asf header" );
392         /* TODO Clean tracks */
393         goto error;
394     }
395
396     if( p_sys->i_track <= 0 )
397         goto error;
398
399     return VLC_SUCCESS;
400
401 error:
402     for( i = 0; i < p_sys->i_track; i++ )
403     {
404         live_track_t *tk = p_sys->track[i];
405
406         if( tk->b_muxed ) stream_Delete( tk->p_out_muxed );
407         es_format_Clean( &tk->fmt );
408         free( tk->p_buffer );
409         free( tk );
410     }
411
412     if( p_sys->i_track ) free( p_sys->track );
413     if( p_sys->p_out_asf ) stream_Delete( p_sys->p_out_asf );
414     if( p_sys->rtsp && p_sys->ms ) p_sys->rtsp->teardownMediaSession( *p_sys->ms );
415     if( p_sys->p_timeout )
416     {
417         vlc_cancel( p_sys->p_timeout->handle );
418         vlc_join( p_sys->p_timeout->handle, NULL );
419         free( p_sys->p_timeout );
420     }
421     if( p_sys->ms ) Medium::close( p_sys->ms );
422     if( p_sys->rtsp ) RTSPClient::close( p_sys->rtsp );
423     if( p_sys->env ) p_sys->env->reclaim();
424     delete p_sys->scheduler;
425     free( p_sys->p_sdp );
426     free( p_sys->psz_path );
427
428     vlc_UrlClean( &p_sys->url );
429
430     free( p_sys );
431     return i_error;
432 }
433
434 /*****************************************************************************
435  * DemuxClose:
436  *****************************************************************************/
437 static void Close( vlc_object_t *p_this )
438 {
439     demux_t *p_demux = (demux_t*)p_this;
440     demux_sys_t *p_sys = p_demux->p_sys;
441     int i;
442
443     for( i = 0; i < p_sys->i_track; i++ )
444     {
445         live_track_t *tk = p_sys->track[i];
446
447         if( tk->b_muxed ) stream_Delete( tk->p_out_muxed );
448         es_format_Clean( &tk->fmt );
449         free( tk->p_buffer );
450         free( tk );
451     }
452
453     if( p_sys->i_track ) free( p_sys->track );
454     if( p_sys->p_out_asf ) stream_Delete( p_sys->p_out_asf );
455     if( p_sys->rtsp && p_sys->ms ) p_sys->rtsp->teardownMediaSession( *p_sys->ms );
456     if( p_sys->p_timeout )
457     {
458         vlc_cancel( p_sys->p_timeout->handle );
459         vlc_join( p_sys->p_timeout->handle, NULL );
460         free( p_sys->p_timeout );
461     }
462     if( p_sys->ms ) Medium::close( p_sys->ms );
463     if( p_sys->rtsp ) RTSPClient::close( p_sys->rtsp );
464     if( p_sys->env ) p_sys->env->reclaim();
465     delete p_sys->scheduler;
466     free( p_sys->p_sdp );
467     free( p_sys->psz_path );
468
469     vlc_UrlClean( &p_sys->url );
470
471     free( p_sys );
472 }
473
474 /*****************************************************************************
475  * Connect: connects to the RTSP server to setup the session DESCRIBE
476  *****************************************************************************/
477 static int Connect( demux_t *p_demux )
478 {
479     demux_sys_t *p_sys = p_demux->p_sys;
480     Authenticator authenticator;
481     bool b_firstpass  = true;
482     char *psz_user    = NULL;
483     char *psz_pwd     = NULL;
484     char *psz_url     = NULL;
485     char *psz_options = NULL;
486     char *p_sdp       = NULL;
487     int  i_http_port  = 0;
488     int  i_ret        = VLC_SUCCESS;
489
490     if( p_sys->url.i_port == 0 ) p_sys->url.i_port = 554;
491     if( p_sys->url.psz_username || p_sys->url.psz_password )
492     {
493         int err;
494         err = asprintf( &psz_url, "rtsp://%s:%d%s", p_sys->url.psz_host,
495                         p_sys->url.i_port, p_sys->url.psz_path );
496         if( err == -1 ) return VLC_ENOMEM;
497
498         psz_user = strdup( p_sys->url.psz_username );
499         psz_pwd  = strdup( p_sys->url.psz_password );
500     }
501     else
502     {
503         int err;
504         err = asprintf( &psz_url, "rtsp://%s", p_sys->psz_path );
505         if( err == -1 ) return VLC_ENOMEM;
506
507         psz_user = var_CreateGetString( p_demux, "rtsp-user" );
508         psz_pwd  = var_CreateGetString( p_demux, "rtsp-pwd" );
509     }
510
511 createnew:
512     if( !vlc_object_alive (p_demux) || p_demux->b_error )
513     {
514         free( psz_user );
515         free( psz_pwd );
516         free( psz_url );
517         return VLC_EGENERIC;
518     }
519
520     if( var_CreateGetBool( p_demux, "rtsp-http" ) )
521         i_http_port = var_CreateGetInteger( p_demux, "rtsp-http-port" );
522
523     if( ( p_sys->rtsp = RTSPClient::createNew( *p_sys->env,
524           var_CreateGetInteger( p_demux, "verbose" ) > 1,
525           "VLC media player", i_http_port ) ) == NULL )
526     {
527         msg_Err( p_demux, "RTSPClient::createNew failed (%s)",
528                  p_sys->env->getResultMsg() );
529         free( psz_user );
530         free( psz_pwd );
531         free( psz_url );
532         return VLC_EGENERIC;
533     }
534
535     /* Kasenna enables KeepAlive by analysing the User-Agent string.
536      * Appending _KA to the string should be enough to enable this feature,
537      * however, there is a bug where the _KA doesn't get parsed from the
538      * default User-Agent as created by VLC/Live555 code. This is probably due
539      * to spaces in the string or the string being too long. Here we override
540      * the default string with a more compact version.
541      */
542     if( var_CreateGetBool( p_demux, "rtsp-kasenna" ))
543     {
544         p_sys->rtsp->setUserAgentString( "VLC_MEDIA_PLAYER_KA" );
545     }
546
547 describe:
548     authenticator.setUsernameAndPassword( (const char*)psz_user,
549                                           (const char*)psz_pwd );
550
551     /* */
552     const int i_timeout = var_CreateGetInteger(p_demux, "ipv4-timeout") / 1000;
553
554 #if LIVEMEDIA_LIBRARY_VERSION_INT >= 1223337600
555     psz_options = p_sys->rtsp->sendOptionsCmd( psz_url, psz_user, psz_pwd,
556                                                &authenticator, i_timeout );
557 #else
558     psz_options = p_sys->rtsp->sendOptionsCmd( psz_url, psz_user, psz_pwd,
559                                                &authenticator );
560 #endif
561     if( psz_options == NULL && authenticator.realm() != NULL )
562     {
563         // try again, with the realm set this time
564 #if LIVEMEDIA_LIBRARY_VERSION_INT >= 1223337600
565         psz_options = p_sys->rtsp->sendOptionsCmd( psz_url, psz_user, psz_pwd,
566                                                &authenticator, i_timeout );
567 #else
568         psz_options = p_sys->rtsp->sendOptionsCmd( psz_url, psz_user, psz_pwd,
569                                                &authenticator );
570 #endif
571     }
572     if( psz_options )
573         p_sys->b_get_param = strstr( psz_options, "GET_PARAMETER" ) ? true : false ;
574     delete [] psz_options;
575
576 #if LIVEMEDIA_LIBRARY_VERSION_INT >= 1223337600
577     p_sdp = p_sys->rtsp->describeWithPassword( psz_url, (const char*)psz_user, (const char*)psz_pwd,
578                                           var_GetBool( p_demux, "rtsp-kasenna" ), i_timeout );
579 #else
580     p_sdp = p_sys->rtsp->describeWithPassword( psz_url, (const char*)psz_user, (const char*)psz_pwd,
581                                           var_GetBool( p_demux, "rtsp-kasenna" ) );
582 #endif
583
584     if( p_sdp == NULL )
585     {
586         /* failure occurred */
587         int i_code = 0;
588         const char *psz_error = p_sys->env->getResultMsg();
589
590         if( var_GetBool( p_demux, "rtsp-http" ) )
591             sscanf( psz_error, "%*s %*s HTTP GET %*s HTTP/%*u.%*u %3u %*s",
592                     &i_code );
593         else
594         {
595             const char *psz_tmp = strstr( psz_error, "RTSP" );
596             if( psz_tmp )
597                 sscanf( psz_tmp, "RTSP/%*s%3u", &i_code );
598             else
599                 i_code = 0;
600         }
601         msg_Dbg( p_demux, "DESCRIBE failed with %d: %s", i_code, psz_error );
602
603         if( b_firstpass )
604         {   /* describeURL always returns an "RTSP/1.0 401 Unauthorized" the
605              * first time. This is a workaround to avoid asking for a
606              * user/passwd the first time the code passess here. */
607             i_code = 0;
608             b_firstpass = false;
609         }
610
611         if( i_code == 401 )
612         {
613             msg_Dbg( p_demux, "authentication failed" );
614
615             free( psz_user );
616             free( psz_pwd );
617             dialog_Login( p_demux, &psz_user, &psz_pwd,
618                           _("RTSP authentication"),
619                         _("Please enter a valid login name and a password.") );
620             if( psz_user != NULL && psz_pwd != NULL )
621             {
622                 msg_Dbg( p_demux, "retrying with user=%s, pwd=%s",
623                          psz_user, psz_pwd );
624                 goto describe;
625             }
626         }
627         else if( (i_code != 0) && !var_GetBool( p_demux, "rtsp-http" ) )
628         {
629             /* Perhaps a firewall is being annoying. Try HTTP tunneling mode */
630             vlc_value_t val;
631             val.b_bool = true;
632             msg_Dbg( p_demux, "we will now try HTTP tunneling mode" );
633             var_Set( p_demux, "rtsp-http", val );
634             if( p_sys->rtsp ) RTSPClient::close( p_sys->rtsp );
635             p_sys->rtsp = NULL;
636             goto createnew;
637         }
638         else
639         {
640             msg_Dbg( p_demux, "connection timeout" );
641             if( p_sys->rtsp ) RTSPClient::close( p_sys->rtsp );
642             p_sys->rtsp = NULL;
643         }
644         i_ret = VLC_EGENERIC;
645     }
646
647     /* malloc-ated copy */
648     free( psz_url );
649     free( psz_user );
650     free( psz_pwd );
651
652     free( p_sys->p_sdp );
653     p_sys->p_sdp = NULL;
654     if( p_sdp ) p_sys->p_sdp = strdup( (char*)p_sdp );
655     delete[] p_sdp;
656
657     return i_ret;
658 }
659
660 /*****************************************************************************
661  * SessionsSetup: prepares the subsessions and does the SETUP
662  *****************************************************************************/
663 static int SessionsSetup( demux_t *p_demux )
664 {
665     demux_sys_t             *p_sys  = p_demux->p_sys;
666     MediaSubsessionIterator *iter   = NULL;
667     MediaSubsession         *sub    = NULL;
668
669     bool           b_rtsp_tcp = false;
670     int            i_client_port;
671     int            i_return = VLC_SUCCESS;
672     unsigned int   i_buffer = 0;
673     unsigned const thresh = 200000; /* RTP reorder threshold .2 second (default .1) */
674
675     b_rtsp_tcp    = var_CreateGetBool( p_demux, "rtsp-tcp" ) ||
676                     var_GetBool( p_demux, "rtsp-http" );
677     i_client_port = var_CreateGetInteger( p_demux, "rtp-client-port" );
678
679     /* Create the session from the SDP */
680     if( !( p_sys->ms = MediaSession::createNew( *p_sys->env, p_sys->p_sdp ) ) )
681     {
682         msg_Err( p_demux, "Could not create the RTSP Session: %s",
683             p_sys->env->getResultMsg() );
684         return VLC_EGENERIC;
685     }
686
687     /* Initialise each media subsession */
688     iter = new MediaSubsessionIterator( *p_sys->ms );
689     while( ( sub = iter->next() ) != NULL )
690     {
691         Boolean bInit;
692         live_track_t *tk;
693
694         if( !vlc_object_alive (p_demux) || p_demux->b_error )
695         {
696             delete iter;
697             return VLC_EGENERIC;
698         }
699
700         /* Value taken from mplayer */
701         if( !strcmp( sub->mediumName(), "audio" ) )
702             i_buffer = 100000;
703         else if( !strcmp( sub->mediumName(), "video" ) )
704             i_buffer = 2000000;
705         else continue;
706
707         if( i_client_port != -1 )
708         {
709             sub->setClientPortNum( i_client_port );
710             i_client_port += 2;
711         }
712
713         if( strcasestr( sub->codecName(), "REAL" ) )
714         {
715             msg_Info( p_demux, "real codec detected, using real-RTSP instead" );
716             p_sys->b_real = true; /* This is a problem, we'll handle it later */
717             continue;
718         }
719
720         if( !strcmp( sub->codecName(), "X-ASF-PF" ) )
721             bInit = sub->initiate( 4 ); /* Constant ? */
722         else
723             bInit = sub->initiate();
724
725         if( !bInit )
726         {
727             msg_Warn( p_demux, "RTP subsession '%s/%s' failed (%s)",
728                       sub->mediumName(), sub->codecName(),
729                       p_sys->env->getResultMsg() );
730         }
731         else
732         {
733             if( sub->rtpSource() != NULL )
734             {
735                 int fd = sub->rtpSource()->RTPgs()->socketNum();
736
737                 /* Increase the buffer size */
738                 if( i_buffer > 0 )
739                     increaseReceiveBufferTo( *p_sys->env, fd, i_buffer );
740
741                 /* Increase the RTP reorder timebuffer just a bit */
742                 sub->rtpSource()->setPacketReorderingThresholdTime(thresh);
743             }
744             msg_Dbg( p_demux, "RTP subsession '%s/%s'", sub->mediumName(),
745                      sub->codecName() );
746
747             /* Issue the SETUP */
748             if( p_sys->rtsp )
749             {
750                 if( !p_sys->rtsp->setupMediaSubsession( *sub, False,
751                                            b_rtsp_tcp ? True : False,
752                                            ( p_sys->b_force_mcast && !b_rtsp_tcp ) ? True : False ) )
753                 {
754                     /* if we get an unsupported transport error, toggle TCP use and try again */
755                     if( !strstr(p_sys->env->getResultMsg(), "461 Unsupported Transport")
756                      || !p_sys->rtsp->setupMediaSubsession( *sub, False,
757                                            b_rtsp_tcp ? False : True,
758                                            False ) )
759                     {
760                         msg_Err( p_demux, "SETUP of'%s/%s' failed %s", sub->mediumName(),
761                                  sub->codecName(), p_sys->env->getResultMsg() );
762                         continue;
763                     }
764                 }
765             }
766
767             /* Check if we will receive data from this subsession for this track */
768             if( sub->readSource() == NULL ) continue;
769             if( !p_sys->b_multicast )
770             {
771                 /* Check, because we need diff. rollover behaviour for multicast */
772                 p_sys->b_multicast = IsMulticastAddress( sub->connectionEndpointAddress() );
773             }
774
775             tk = (live_track_t*)malloc( sizeof( live_track_t ) );
776             if( !tk )
777             {
778                 delete iter;
779                 return VLC_ENOMEM;
780             }
781             tk->p_demux     = p_demux;
782             tk->sub         = sub;
783             tk->p_es        = NULL;
784             tk->b_quicktime = false;
785             tk->b_asf       = false;
786             tk->b_muxed     = false;
787             tk->p_out_muxed = NULL;
788             tk->waiting     = 0;
789             tk->b_rtcp_sync = false;
790             tk->i_pts       = 0;
791             tk->i_npt       = 0.;
792             tk->i_buffer    = 65536;
793             tk->p_buffer    = (uint8_t *)malloc( 65536 );
794             if( !tk->p_buffer )
795             {
796                 free( tk );
797                 delete iter;
798                 return VLC_ENOMEM;
799             }
800
801             /* Value taken from mplayer */
802             if( !strcmp( sub->mediumName(), "audio" ) )
803             {
804                 es_format_Init( &tk->fmt, AUDIO_ES, VLC_FOURCC('u','n','d','f') );
805                 tk->fmt.audio.i_channels = sub->numChannels();
806                 tk->fmt.audio.i_rate = sub->rtpTimestampFrequency();
807
808                 if( !strcmp( sub->codecName(), "MPA" ) ||
809                     !strcmp( sub->codecName(), "MPA-ROBUST" ) ||
810                     !strcmp( sub->codecName(), "X-MP3-DRAFT-00" ) )
811                 {
812                     tk->fmt.i_codec = VLC_CODEC_MPGA;
813                     tk->fmt.audio.i_rate = 0;
814                 }
815                 else if( !strcmp( sub->codecName(), "AC3" ) )
816                 {
817                     tk->fmt.i_codec = VLC_CODEC_A52;
818                     tk->fmt.audio.i_rate = 0;
819                 }
820                 else if( !strcmp( sub->codecName(), "L16" ) )
821                 {
822                     tk->fmt.i_codec = VLC_FOURCC( 't', 'w', 'o', 's' );
823                     tk->fmt.audio.i_bitspersample = 16;
824                 }
825                 else if( !strcmp( sub->codecName(), "L8" ) )
826                 {
827                     tk->fmt.i_codec = VLC_FOURCC( 'a', 'r', 'a', 'w' );
828                     tk->fmt.audio.i_bitspersample = 8;
829                 }
830                 else if( !strcmp( sub->codecName(), "PCMU" ) )
831                 {
832                     tk->fmt.i_codec = VLC_CODEC_MULAW;
833                 }
834                 else if( !strcmp( sub->codecName(), "PCMA" ) )
835                 {
836                     tk->fmt.i_codec = VLC_CODEC_ALAW;
837                 }
838                 else if( !strncmp( sub->codecName(), "G726", 4 ) )
839                 {
840                     tk->fmt.i_codec = VLC_CODEC_ADPCM_G726;
841                     tk->fmt.audio.i_rate = 8000;
842                     tk->fmt.audio.i_channels = 1;
843                     if( !strcmp( sub->codecName()+5, "40" ) )
844                         tk->fmt.i_bitrate = 40000;
845                     else if( !strcmp( sub->codecName()+5, "32" ) )
846                         tk->fmt.i_bitrate = 32000;
847                     else if( !strcmp( sub->codecName()+5, "24" ) )
848                         tk->fmt.i_bitrate = 24000;
849                     else if( !strcmp( sub->codecName()+5, "16" ) )
850                         tk->fmt.i_bitrate = 16000;
851                 }
852                 else if( !strcmp( sub->codecName(), "AMR" ) )
853                 {
854                     tk->fmt.i_codec = VLC_CODEC_AMR_NB;
855                 }
856                 else if( !strcmp( sub->codecName(), "AMR-WB" ) )
857                 {
858                     tk->fmt.i_codec = VLC_CODEC_AMR_WB;
859                 }
860                 else if( !strcmp( sub->codecName(), "MP4A-LATM" ) )
861                 {
862                     unsigned int i_extra;
863                     uint8_t      *p_extra;
864
865                     tk->fmt.i_codec = VLC_CODEC_MP4A;
866
867                     if( ( p_extra = parseStreamMuxConfigStr( sub->fmtp_config(),
868                                                              i_extra ) ) )
869                     {
870                         tk->fmt.i_extra = i_extra;
871                         tk->fmt.p_extra = malloc( i_extra );
872                         memcpy( tk->fmt.p_extra, p_extra, i_extra );
873                         delete[] p_extra;
874                     }
875                     /* Because the "faad" decoder does not handle the LATM data length field
876                        at the start of each returned LATM frame, tell the RTP source to omit it. */
877                     ((MPEG4LATMAudioRTPSource*)sub->rtpSource())->omitLATMDataLengthField();
878                 }
879                 else if( !strcmp( sub->codecName(), "MPEG4-GENERIC" ) )
880                 {
881                     unsigned int i_extra;
882                     uint8_t      *p_extra;
883
884                     tk->fmt.i_codec = VLC_CODEC_MP4A;
885
886                     if( ( p_extra = parseGeneralConfigStr( sub->fmtp_config(),
887                                                            i_extra ) ) )
888                     {
889                         tk->fmt.i_extra = i_extra;
890                         tk->fmt.p_extra = malloc( i_extra );
891                         memcpy( tk->fmt.p_extra, p_extra, i_extra );
892                         delete[] p_extra;
893                     }
894                 }
895                 else if( !strcmp( sub->codecName(), "X-ASF-PF" ) )
896                 {
897                     tk->b_asf = true;
898                     if( p_sys->p_out_asf == NULL )
899                         p_sys->p_out_asf = stream_DemuxNew( p_demux, "asf",
900                                                             p_demux->out );
901                 }
902                 else if( !strcmp( sub->codecName(), "X-QT" ) ||
903                          !strcmp( sub->codecName(), "X-QUICKTIME" ) )
904                 {
905                     tk->b_quicktime = true;
906                 }
907                 else if( !strcmp( sub->codecName(), "SPEEX" ) )
908                 {
909                     tk->fmt.i_codec = VLC_FOURCC( 's', 'p', 'x', 'r' );
910                     if ( sub->rtpTimestampFrequency() )
911                         tk->fmt.audio.i_rate = sub->rtpTimestampFrequency();
912                     else
913                     {
914                         msg_Warn( p_demux,"Using 8kHz as default sample rate." );
915                         tk->fmt.audio.i_rate = 8000;
916                     }
917                 }
918             }
919             else if( !strcmp( sub->mediumName(), "video" ) )
920             {
921                 es_format_Init( &tk->fmt, VIDEO_ES, VLC_FOURCC('u','n','d','f') );
922                 if( !strcmp( sub->codecName(), "MPV" ) )
923                 {
924                     tk->fmt.i_codec = VLC_CODEC_MPGV;
925                 }
926                 else if( !strcmp( sub->codecName(), "H263" ) ||
927                          !strcmp( sub->codecName(), "H263-1998" ) ||
928                          !strcmp( sub->codecName(), "H263-2000" ) )
929                 {
930                     tk->fmt.i_codec = VLC_CODEC_H263;
931                 }
932                 else if( !strcmp( sub->codecName(), "H261" ) )
933                 {
934                     tk->fmt.i_codec = VLC_CODEC_H261;
935                 }
936                 else if( !strcmp( sub->codecName(), "H264" ) )
937                 {
938                     unsigned int i_extra = 0;
939                     uint8_t      *p_extra = NULL;
940
941                     tk->fmt.i_codec = VLC_CODEC_H264;
942                     tk->fmt.b_packetized = false;
943
944                     if((p_extra=parseH264ConfigStr( sub->fmtp_spropparametersets(),
945                                                     i_extra ) ) )
946                     {
947                         tk->fmt.i_extra = i_extra;
948                         tk->fmt.p_extra = malloc( i_extra );
949                         memcpy( tk->fmt.p_extra, p_extra, i_extra );
950
951                         delete[] p_extra;
952                     }
953                 }
954                 else if( !strcmp( sub->codecName(), "JPEG" ) )
955                 {
956                     tk->fmt.i_codec = VLC_CODEC_MJPG;
957                 }
958                 else if( !strcmp( sub->codecName(), "MP4V-ES" ) )
959                 {
960                     unsigned int i_extra;
961                     uint8_t      *p_extra;
962
963                     tk->fmt.i_codec = VLC_CODEC_MP4V;
964
965                     if( ( p_extra = parseGeneralConfigStr( sub->fmtp_config(),
966                                                            i_extra ) ) )
967                     {
968                         tk->fmt.i_extra = i_extra;
969                         tk->fmt.p_extra = malloc( i_extra );
970                         memcpy( tk->fmt.p_extra, p_extra, i_extra );
971                         delete[] p_extra;
972                     }
973                 }
974                 else if( !strcmp( sub->codecName(), "X-QT" ) ||
975                          !strcmp( sub->codecName(), "X-QUICKTIME" ) ||
976                          !strcmp( sub->codecName(), "X-QDM" ) ||
977                          !strcmp( sub->codecName(), "X-SV3V-ES" )  ||
978                          !strcmp( sub->codecName(), "X-SORENSONVIDEO" ) )
979                 {
980                     tk->b_quicktime = true;
981                 }
982                 else if( !strcmp( sub->codecName(), "MP2T" ) )
983                 {
984                     tk->b_muxed = true;
985                     tk->p_out_muxed = stream_DemuxNew( p_demux, "ts", p_demux->out );
986                 }
987                 else if( !strcmp( sub->codecName(), "MP2P" ) ||
988                          !strcmp( sub->codecName(), "MP1S" ) )
989                 {
990                     tk->b_muxed = true;
991                     tk->p_out_muxed = stream_DemuxNew( p_demux, "ps",
992                                                        p_demux->out );
993                 }
994                 else if( !strcmp( sub->codecName(), "X-ASF-PF" ) )
995                 {
996                     tk->b_asf = true;
997                     if( p_sys->p_out_asf == NULL )
998                         p_sys->p_out_asf = stream_DemuxNew( p_demux, "asf",
999                                                             p_demux->out );;
1000                 }
1001             }
1002
1003             if( !tk->b_quicktime && !tk->b_muxed && !tk->b_asf )
1004             {
1005                 tk->p_es = es_out_Add( p_demux->out, &tk->fmt );
1006             }
1007
1008             if( sub->rtcpInstance() != NULL )
1009             {
1010                 sub->rtcpInstance()->setByeHandler( StreamClose, tk );
1011             }
1012
1013             if( tk->p_es || tk->b_quicktime || tk->b_muxed || tk->b_asf )
1014             {
1015                 /* Append */
1016                 p_sys->track = (live_track_t**)realloc( p_sys->track, sizeof( live_track_t ) * ( p_sys->i_track + 1 ) );
1017                 p_sys->track[p_sys->i_track++] = tk;
1018             }
1019             else
1020             {
1021                 /* BUG ??? */
1022                 msg_Err( p_demux, "unusable RTSP track. this should not happen" );
1023                 es_format_Clean( &tk->fmt );
1024                 free( tk );
1025             }
1026         }
1027     }
1028     delete iter;
1029     if( p_sys->i_track <= 0 ) i_return = VLC_EGENERIC;
1030
1031     /* Retrieve the starttime if possible */
1032     p_sys->i_npt_start = p_sys->ms->playStartTime();
1033
1034     /* Retrieve the duration if possible */
1035     p_sys->i_npt_length = p_sys->ms->playEndTime();
1036
1037     /* */
1038     msg_Dbg( p_demux, "setup start: %f stop:%f", p_sys->i_npt_start, p_sys->i_npt_length );
1039
1040     /* */
1041     p_sys->b_no_data = true;
1042     p_sys->i_no_data_ti = 0;
1043
1044     return i_return;
1045 }
1046
1047 /*****************************************************************************
1048  * Play: starts the actual playback of the stream
1049  *****************************************************************************/
1050 static int Play( demux_t *p_demux )
1051 {
1052     demux_sys_t *p_sys = p_demux->p_sys;
1053
1054     if( p_sys->rtsp )
1055     {
1056         /* The PLAY */
1057         if( !p_sys->rtsp->playMediaSession( *p_sys->ms, p_sys->i_npt_start, -1, 1 ) )
1058         {
1059             msg_Err( p_demux, "RTSP PLAY failed %s", p_sys->env->getResultMsg() );
1060             return VLC_EGENERIC;
1061         }
1062
1063         /* Retrieve the timeout value and set up a timeout prevention thread */
1064         p_sys->i_timeout = p_sys->rtsp->sessionTimeoutParameter();
1065         if( p_sys->i_timeout <= 0 )
1066             p_sys->i_timeout = 60; /* default value from RFC2326 */
1067
1068         /* start timeout-thread only if GET_PARAMETER is supported by the server */
1069         if( !p_sys->p_timeout && p_sys->b_get_param )
1070         {
1071             msg_Dbg( p_demux, "We have a timeout of %d seconds",  p_sys->i_timeout );
1072             p_sys->p_timeout = (timeout_thread_t *)malloc( sizeof(timeout_thread_t) );
1073             if( p_sys->p_timeout )
1074             {
1075                 memset( p_sys->p_timeout, 0, sizeof(timeout_thread_t) );
1076                 p_sys->p_timeout->p_sys = p_demux->p_sys; /* lol, object recursion :D */
1077                 if( vlc_clone( &p_sys->p_timeout->handle,  TimeoutPrevention,
1078                                p_sys->p_timeout, VLC_THREAD_PRIORITY_LOW ) )
1079                 {
1080                     msg_Err( p_demux, "cannot spawn liveMedia timeout thread" );
1081                     free( p_sys->p_timeout );
1082                     p_sys->p_timeout = NULL;
1083                 }
1084                 else
1085                     msg_Dbg( p_demux, "spawned timeout thread" );
1086             }
1087             else
1088                 msg_Err( p_demux, "cannot spawn liveMedia timeout thread" );
1089         }
1090     }
1091     p_sys->i_pcr = 0;
1092
1093     /* Retrieve the starttime if possible */
1094     p_sys->i_npt_start = p_sys->ms->playStartTime();
1095     p_sys->i_npt_length = p_sys->ms->playEndTime();
1096
1097     msg_Dbg( p_demux, "play start: %f stop:%f", p_sys->i_npt_start, p_sys->i_npt_length );
1098     return VLC_SUCCESS;
1099 }
1100
1101
1102 /*****************************************************************************
1103  * Demux:
1104  *****************************************************************************/
1105 static int Demux( demux_t *p_demux )
1106 {
1107     demux_sys_t    *p_sys = p_demux->p_sys;
1108     TaskToken      task;
1109
1110     bool            b_send_pcr = true;
1111     int64_t         i_pcr = 0;
1112     int             i;
1113
1114     /* Check if we need to send the server a Keep-A-Live signal */
1115     if( p_sys->b_timeout_call && p_sys->rtsp && p_sys->ms )
1116     {
1117         char *psz_bye = NULL;
1118         p_sys->rtsp->getMediaSessionParameter( *p_sys->ms, NULL, psz_bye );
1119         p_sys->b_timeout_call = false;
1120     }
1121
1122     for( i = 0; i < p_sys->i_track; i++ )
1123     {
1124         live_track_t *tk = p_sys->track[i];
1125
1126         if( tk->b_asf || tk->b_muxed )
1127             b_send_pcr = false;
1128 #if 0
1129         if( i_pcr == 0 )
1130         {
1131             i_pcr = tk->i_pts;
1132         }
1133         else if( tk->i_pts != 0 && i_pcr > tk->i_pts )
1134         {
1135             i_pcr = tk->i_pts ;
1136         }
1137 #endif
1138     }
1139     if( p_sys->i_pcr > 0 )
1140     {
1141         if( b_send_pcr )
1142             es_out_Control( p_demux->out, ES_OUT_SET_PCR, p_sys->i_pcr );
1143     }
1144
1145     /* First warn we want to read data */
1146     p_sys->event = 0;
1147     for( i = 0; i < p_sys->i_track; i++ )
1148     {
1149         live_track_t *tk = p_sys->track[i];
1150
1151         if( tk->waiting == 0 )
1152         {
1153             tk->waiting = 1;
1154             tk->sub->readSource()->getNextFrame( tk->p_buffer, tk->i_buffer,
1155                                           StreamRead, tk, StreamClose, tk );
1156         }
1157     }
1158     /* Create a task that will be called if we wait more than 300ms */
1159     task = p_sys->scheduler->scheduleDelayedTask( 300000, TaskInterrupt, p_demux );
1160
1161     /* Do the read */
1162     p_sys->scheduler->doEventLoop( &p_sys->event );
1163
1164     /* remove the task */
1165     p_sys->scheduler->unscheduleDelayedTask( task );
1166
1167     /* Check for gap in pts value */
1168     for( i = 0; i < p_sys->i_track; i++ )
1169     {
1170         live_track_t *tk = p_sys->track[i];
1171
1172         if( !tk->b_muxed && !tk->b_rtcp_sync &&
1173             tk->sub->rtpSource() && tk->sub->rtpSource()->hasBeenSynchronizedUsingRTCP() )
1174         {
1175             msg_Dbg( p_demux, "tk->rtpSource->hasBeenSynchronizedUsingRTCP()" );
1176
1177             es_out_Control( p_demux->out, ES_OUT_RESET_PCR );
1178             tk->b_rtcp_sync = true;
1179             /* reset PCR */
1180             tk->i_pts = 0;
1181             tk->i_npt = 0.;
1182             p_sys->i_pcr = 0;
1183             p_sys->i_npt = 0.;
1184             i_pcr = 0;
1185         }
1186     }
1187
1188     if( p_sys->b_multicast && p_sys->b_no_data &&
1189         ( p_sys->i_no_data_ti > 120 ) )
1190     {
1191         /* FIXME Make this configurable
1192         msg_Err( p_demux, "no multicast data received in 36s, aborting" );
1193         return 0;
1194         */
1195     }
1196     else if( !p_sys->b_multicast && p_sys->b_no_data &&
1197              ( p_sys->i_no_data_ti > 34 ) )
1198     {
1199         bool b_rtsp_tcp = var_GetBool( p_demux, "rtsp-tcp" ) ||
1200                                 var_GetBool( p_demux, "rtsp-http" );
1201
1202         if( !b_rtsp_tcp && p_sys->rtsp && p_sys->ms )
1203         {
1204             msg_Warn( p_demux, "no data received in 10s. Switching to TCP" );
1205             if( RollOverTcp( p_demux ) )
1206             {
1207                 msg_Err( p_demux, "TCP rollover failed, aborting" );
1208                 return 0;
1209             }
1210             return 1;
1211         }
1212         msg_Err( p_demux, "no data received in 10s, aborting" );
1213         return 0;
1214     }
1215     else if( !p_sys->b_multicast && p_sys->i_no_data_ti > 34 )
1216     {
1217         /* EOF ? */
1218         msg_Warn( p_demux, "no data received in 10s, eof ?" );
1219         return 0;
1220     }
1221     return p_demux->b_error ? 0 : 1;
1222 }
1223
1224 /*****************************************************************************
1225  * Control:
1226  *****************************************************************************/
1227 static int Control( demux_t *p_demux, int i_query, va_list args )
1228 {
1229     demux_sys_t *p_sys = p_demux->p_sys;
1230     int64_t *pi64, i64;
1231     double  *pf, f;
1232     bool *pb, *pb2, b_bool;
1233     int *pi_int;
1234
1235     switch( i_query )
1236     {
1237         case DEMUX_GET_TIME:
1238             pi64 = (int64_t*)va_arg( args, int64_t * );
1239             if( p_sys->i_npt > 0 )
1240             {
1241                 *pi64 = (int64_t)(p_sys->i_npt * 1000000.);
1242                 return VLC_SUCCESS;
1243             }
1244             return VLC_EGENERIC;
1245
1246         case DEMUX_GET_LENGTH:
1247             pi64 = (int64_t*)va_arg( args, int64_t * );
1248             if( p_sys->i_npt_length > 0 )
1249             {
1250                 *pi64 = (int64_t)((double)p_sys->i_npt_length * 1000000.0);
1251                 return VLC_SUCCESS;
1252             }
1253             return VLC_EGENERIC;
1254
1255         case DEMUX_GET_POSITION:
1256             pf = (double*)va_arg( args, double* );
1257             if( (p_sys->i_npt_length > 0) && (p_sys->i_npt > 0) )
1258             {
1259                 *pf = ( (double)p_sys->i_npt / (double)p_sys->i_npt_length );
1260                 return VLC_SUCCESS;
1261             }
1262             return VLC_EGENERIC;
1263
1264         case DEMUX_SET_POSITION:
1265         case DEMUX_SET_TIME:
1266             if( p_sys->rtsp && (p_sys->i_npt_length > 0) )
1267             {
1268                 int i;
1269                 float time;
1270
1271                 if( (i_query == DEMUX_SET_TIME) && (p_sys->i_npt > 0) )
1272                 {
1273                     i64 = (int64_t)va_arg( args, int64_t );
1274                     time = (float)((double)i64 / (double)1000000.0); /* in second */
1275                 }
1276                 else if( i_query == DEMUX_SET_TIME )
1277                     return VLC_EGENERIC;
1278                 else
1279                 {
1280                     f = (double)va_arg( args, double );
1281                     time = f * (double)p_sys->i_npt_length;   /* in second */
1282                 }
1283
1284                 if( !p_sys->rtsp->playMediaSession( *p_sys->ms, time, -1, 1 ) )
1285                 {
1286                     msg_Err( p_demux, "PLAY failed %s",
1287                         p_sys->env->getResultMsg() );
1288                     return VLC_EGENERIC;
1289                 }
1290                 p_sys->i_pcr = 0;
1291
1292                 /* Retrieve RTP-Info values */
1293                 for( i = 0; i < p_sys->i_track; i++ )
1294                 {
1295                     p_sys->track[i]->b_rtcp_sync = false;
1296                     p_sys->track[i]->i_pts = 0;
1297                 }
1298
1299                 /* Retrieve the starttime if possible */
1300                 p_sys->i_npt = p_sys->i_npt_start = p_sys->ms->playStartTime();
1301
1302                 /* Retrieve the duration if possible */
1303                 p_sys->i_npt_length = p_sys->ms->playEndTime();
1304
1305                 msg_Dbg( p_demux, "seek start: %f stop:%f", p_sys->i_npt_start, p_sys->i_npt_length );
1306                 return VLC_SUCCESS;
1307             }
1308             return VLC_EGENERIC;
1309
1310         /* Special for access_demux */
1311         case DEMUX_CAN_PAUSE:
1312         case DEMUX_CAN_SEEK:
1313             pb = (bool*)va_arg( args, bool * );
1314             if( p_sys->rtsp && p_sys->i_npt_length > 0 )
1315                 /* Not always true, but will be handled in SET_PAUSE_STATE */
1316                 *pb = true;
1317             else
1318                 *pb = false;
1319             return VLC_SUCCESS;
1320
1321         case DEMUX_CAN_CONTROL_PACE:
1322             pb = (bool*)va_arg( args, bool * );
1323
1324 #if 1       /* Disable for now until we have a clock synchro algo
1325              * which works with something else than MPEG over UDP */
1326             *pb = false;
1327 #else
1328             *pb = true;
1329 #endif
1330             return VLC_SUCCESS;
1331
1332         case DEMUX_CAN_CONTROL_RATE:
1333             pb = (bool*)va_arg( args, bool * );
1334             pb2 = (bool*)va_arg( args, bool * );
1335
1336             *pb = (p_sys->rtsp != NULL) &&
1337                     (p_sys->i_npt_length > 0) &&
1338                     !var_GetBool( p_demux, "rtsp-kasenna" );
1339             *pb2 = false;
1340             return VLC_SUCCESS;
1341
1342         case DEMUX_SET_RATE:
1343         {
1344             double f_scale, f_old_scale;
1345
1346             if( !p_sys->rtsp || (p_sys->i_npt_length <= 0) ||
1347                 var_GetBool( p_demux, "rtsp-kasenna" ) )
1348                 return VLC_EGENERIC;
1349
1350             /* According to RFC 2326 p56 chapter 12.35 a RTSP server that
1351              * supports Scale:
1352              *
1353              * "[...] should try to approximate the viewing rate, but
1354              *  may restrict the range of scale values that it supports.
1355              *  The response MUST contain the actual scale value chosen
1356              *  by the server."
1357              *
1358              * Scale = 1 indicates normal play
1359              * Scale > 1 indicates fast forward
1360              * Scale < 1 && Scale > 0 indicates slow motion
1361              * Scale < 0 value indicates rewind
1362              */
1363
1364             pi_int = (int*)va_arg( args, int * );
1365             f_scale = (double)INPUT_RATE_DEFAULT / (*pi_int);
1366             f_old_scale = p_sys->ms->scale();
1367
1368             /* Passing -1 for the start and end time will mean liveMedia won't
1369              * create a Range: section for the RTSP message. The server should
1370              * pick up from the current position */
1371             if( !p_sys->rtsp->playMediaSession( *p_sys->ms, -1, -1, f_scale ) )
1372             {
1373                 msg_Err( p_demux, "PLAY with Scale %0.2f failed %s", f_scale,
1374                         p_sys->env->getResultMsg() );
1375                 return VLC_EGENERIC;
1376             }
1377
1378             if( p_sys->ms->scale() == f_old_scale )
1379             {
1380                 msg_Err( p_demux, "no scale change using old Scale %0.2f",
1381                           p_sys->ms->scale() );
1382                 return VLC_EGENERIC;
1383             }
1384
1385             /* ReSync the stream */
1386             p_sys->i_npt_start = 0;
1387             p_sys->i_pcr = 0;
1388             p_sys->i_npt = 0.0;
1389
1390             *pi_int = (int)( INPUT_RATE_DEFAULT / p_sys->ms->scale() );
1391             msg_Dbg( p_demux, "PLAY with new Scale %0.2f (%d)", p_sys->ms->scale(), (*pi_int) );
1392             return VLC_SUCCESS;
1393         }
1394
1395         case DEMUX_SET_PAUSE_STATE:
1396         {
1397             int i;
1398
1399             b_bool = (bool)va_arg( args, int );
1400             if( p_sys->rtsp == NULL )
1401                 return VLC_EGENERIC;
1402
1403             /* FIXME */
1404             if( ( b_bool && !p_sys->rtsp->pauseMediaSession( *p_sys->ms ) ) ||
1405                     ( !b_bool && !p_sys->rtsp->playMediaSession( *p_sys->ms,
1406                        -1 ) ) )
1407             {
1408                     msg_Err( p_demux, "PLAY or PAUSE failed %s", p_sys->env->getResultMsg() );
1409                     return VLC_EGENERIC;
1410             }
1411
1412             /* When we Pause, we'll need the TimeoutPrevention thread to
1413              * handle sending the "Keep Alive" message to the server.
1414              * Unfortunately Live555 isn't thread safe and so can't
1415              * do this normally while the main Demux thread is handling
1416              * a live stream. We end up with the Timeout thread blocking
1417              * waiting for a response from the server. So when we PAUSE
1418              * we set a flag that the TimeoutPrevention function will check
1419              * and if it's set, it will trigger the GET_PARAMETER message */
1420             if( b_bool && p_sys->p_timeout != NULL )
1421                 p_sys->p_timeout->b_handle_keep_alive = true;
1422             else if( !b_bool && p_sys->p_timeout != NULL )
1423                 p_sys->p_timeout->b_handle_keep_alive = false;
1424
1425             for( i = 0; !b_bool && i < p_sys->i_track; i++ )
1426             {
1427                 live_track_t *tk = p_sys->track[i];
1428                 tk->b_rtcp_sync = false;
1429                 tk->i_pts = 0;
1430                 p_sys->i_pcr = 0;
1431                 es_out_Control( p_demux->out, ES_OUT_RESET_PCR );
1432             }
1433
1434             /* Retrieve the starttime if possible */
1435             p_sys->i_npt_start = p_sys->ms->playStartTime();
1436
1437             /* Retrieve the duration if possible */
1438             p_sys->i_npt_length = p_sys->ms->playEndTime();
1439
1440             msg_Dbg( p_demux, "pause start: %f stop:%f", p_sys->i_npt_start, p_sys->i_npt_length );
1441             return VLC_SUCCESS;
1442         }
1443         case DEMUX_GET_TITLE_INFO:
1444         case DEMUX_SET_TITLE:
1445         case DEMUX_SET_SEEKPOINT:
1446             return VLC_EGENERIC;
1447
1448         case DEMUX_GET_PTS_DELAY:
1449             pi64 = (int64_t*)va_arg( args, int64_t * );
1450             *pi64 = (int64_t)var_GetInteger( p_demux, "rtsp-caching" ) * 1000;
1451             return VLC_SUCCESS;
1452
1453         default:
1454             return VLC_EGENERIC;
1455     }
1456 }
1457
1458 /*****************************************************************************
1459  * RollOverTcp: reopen the rtsp into TCP mode
1460  * XXX: ugly, a lot of code are duplicated from Open()
1461  * This should REALLY be fixed
1462  *****************************************************************************/
1463 static int RollOverTcp( demux_t *p_demux )
1464 {
1465     demux_sys_t *p_sys = p_demux->p_sys;
1466     int i, i_return;
1467
1468     var_SetBool( p_demux, "rtsp-tcp", true );
1469
1470     /* We close the old RTSP session */
1471     for( i = 0; i < p_sys->i_track; i++ )
1472     {
1473         live_track_t *tk = p_sys->track[i];
1474
1475         if( tk->b_muxed ) stream_Delete( tk->p_out_muxed );
1476         if( tk->p_es ) es_out_Del( p_demux->out, tk->p_es );
1477         es_format_Clean( &tk->fmt );
1478         free( tk->p_buffer );
1479         free( tk );
1480     }
1481     if( p_sys->i_track ) free( p_sys->track );
1482     if( p_sys->p_out_asf ) stream_Delete( p_sys->p_out_asf );
1483
1484     p_sys->rtsp->teardownMediaSession( *p_sys->ms );
1485     Medium::close( p_sys->ms );
1486     RTSPClient::close( p_sys->rtsp );
1487
1488     p_sys->ms = NULL;
1489     p_sys->rtsp = NULL;
1490     p_sys->track = NULL;
1491     p_sys->i_track = 0;
1492     p_sys->b_no_data = true;
1493     p_sys->i_no_data_ti = 0;
1494
1495     /* Reopen rtsp client */
1496     if( ( i_return = Connect( p_demux ) ) != VLC_SUCCESS )
1497     {
1498         msg_Err( p_demux, "Failed to connect with rtsp://%s",
1499                  p_sys->psz_path );
1500         goto error;
1501     }
1502
1503     if( p_sys->p_sdp == NULL )
1504     {
1505         msg_Err( p_demux, "Failed to retrieve the RTSP Session Description" );
1506         goto error;
1507     }
1508
1509     if( ( i_return = SessionsSetup( p_demux ) ) != VLC_SUCCESS )
1510     {
1511         msg_Err( p_demux, "Nothing to play for rtsp://%s", p_sys->psz_path );
1512         goto error;
1513     }
1514
1515     if( ( i_return = Play( p_demux ) ) != VLC_SUCCESS )
1516         goto error;
1517
1518     return VLC_SUCCESS;
1519
1520 error:
1521     return VLC_EGENERIC;
1522 }
1523
1524
1525 /*****************************************************************************
1526  *
1527  *****************************************************************************/
1528 static void StreamRead( void *p_private, unsigned int i_size,
1529                         unsigned int i_truncated_bytes, struct timeval pts,
1530                         unsigned int duration )
1531 {
1532     live_track_t   *tk = (live_track_t*)p_private;
1533     demux_t        *p_demux = tk->p_demux;
1534     demux_sys_t    *p_sys = p_demux->p_sys;
1535     block_t        *p_block;
1536
1537     //msg_Dbg( p_demux, "pts: %d", pts.tv_sec );
1538
1539     int64_t i_pts = (int64_t)pts.tv_sec * INT64_C(1000000) +
1540         (int64_t)pts.tv_usec;
1541
1542     /* XXX Beurk beurk beurk Avoid having negative value XXX */
1543     i_pts &= INT64_C(0x00ffffffffffffff);
1544
1545     /* Retrieve NPT for this pts */
1546     tk->i_npt = tk->sub->getNormalPlayTime(pts);
1547
1548     if( tk->b_quicktime && tk->p_es == NULL )
1549     {
1550         QuickTimeGenericRTPSource *qtRTPSource =
1551             (QuickTimeGenericRTPSource*)tk->sub->rtpSource();
1552         QuickTimeGenericRTPSource::QTState &qtState = qtRTPSource->qtState;
1553         uint8_t *sdAtom = (uint8_t*)&qtState.sdAtom[4];
1554
1555         if( tk->fmt.i_cat == VIDEO_ES ) {
1556             if( qtState.sdAtomSize < 16 + 32 )
1557             {
1558                 /* invalid */
1559                 p_sys->event = 0xff;
1560                 tk->waiting = 0;
1561                 return;
1562             }
1563             tk->fmt.i_codec = VLC_FOURCC(sdAtom[0],sdAtom[1],sdAtom[2],sdAtom[3]);
1564             tk->fmt.video.i_width  = (sdAtom[28] << 8) | sdAtom[29];
1565             tk->fmt.video.i_height = (sdAtom[30] << 8) | sdAtom[31];
1566
1567             if( tk->fmt.i_codec == VLC_FOURCC('a', 'v', 'c', '1') )
1568             {
1569                 uint8_t *pos = (uint8_t*)qtRTPSource->qtState.sdAtom + 86;
1570                 uint8_t *endpos = (uint8_t*)qtRTPSource->qtState.sdAtom
1571                                   + qtRTPSource->qtState.sdAtomSize;
1572                 while (pos+8 < endpos) {
1573                     unsigned int atomLength = pos[0]<<24 | pos[1]<<16 | pos[2]<<8 | pos[3];
1574                     if( atomLength == 0 || atomLength > (unsigned int)(endpos-pos)) break;
1575                     if( memcmp(pos+4, "avcC", 4) == 0 &&
1576                         atomLength > 8 &&
1577                         atomLength <= INT_MAX )
1578                     {
1579                         tk->fmt.i_extra = atomLength-8;
1580                         tk->fmt.p_extra = malloc( tk->fmt.i_extra );
1581                         memcpy(tk->fmt.p_extra, pos+8, atomLength-8);
1582                         break;
1583                     }
1584                     pos += atomLength;
1585                 }
1586             }
1587             else
1588             {
1589                 tk->fmt.i_extra        = qtState.sdAtomSize - 16;
1590                 tk->fmt.p_extra        = malloc( tk->fmt.i_extra );
1591                 memcpy( tk->fmt.p_extra, &sdAtom[12], tk->fmt.i_extra );
1592             }
1593         }
1594         else {
1595             if( qtState.sdAtomSize < 4 )
1596             {
1597                 /* invalid */
1598                 p_sys->event = 0xff;
1599                 tk->waiting = 0;
1600                 return;
1601             }
1602             tk->fmt.i_codec = VLC_FOURCC(sdAtom[0],sdAtom[1],sdAtom[2],sdAtom[3]);
1603         }
1604         tk->p_es = es_out_Add( p_demux->out, &tk->fmt );
1605     }
1606
1607 #if 0
1608     fprintf( stderr, "StreamRead size=%d pts=%lld\n",
1609              i_size,
1610              pts.tv_sec * 1000000LL + pts.tv_usec );
1611 #endif
1612
1613     /* grow buffer if it looks like buffer is too small, but don't eat
1614      * up all the memory on strange streams */
1615     if( i_truncated_bytes > 0 && tk->i_buffer < 2000000 )
1616     {
1617         void *p_tmp;
1618         msg_Dbg( p_demux, "lost %d bytes", i_truncated_bytes );
1619         msg_Dbg( p_demux, "increasing buffer size to %d", tk->i_buffer * 2 );
1620         p_tmp = realloc( tk->p_buffer, tk->i_buffer * 2 );
1621         if( p_tmp == NULL )
1622         {
1623             msg_Warn( p_demux, "realloc failed" );
1624         }
1625         else
1626         {
1627             tk->p_buffer = (uint8_t*)p_tmp;
1628             tk->i_buffer *= 2;
1629         }
1630     }
1631
1632     assert( i_size <= tk->i_buffer );
1633
1634     if( tk->fmt.i_codec == VLC_CODEC_AMR_NB ||
1635         tk->fmt.i_codec == VLC_CODEC_AMR_WB )
1636     {
1637         AMRAudioSource *amrSource = (AMRAudioSource*)tk->sub->readSource();
1638
1639         p_block = block_New( p_demux, i_size + 1 );
1640         p_block->p_buffer[0] = amrSource->lastFrameHeader();
1641         memcpy( p_block->p_buffer + 1, tk->p_buffer, i_size );
1642     }
1643     else if( tk->fmt.i_codec == VLC_CODEC_H261 )
1644     {
1645         H261VideoRTPSource *h261Source = (H261VideoRTPSource*)tk->sub->rtpSource();
1646         uint32_t header = h261Source->lastSpecialHeader();
1647         p_block = block_New( p_demux, i_size + 4 );
1648         memcpy( p_block->p_buffer, &header, 4 );
1649         memcpy( p_block->p_buffer + 4, tk->p_buffer, i_size );
1650
1651         if( tk->sub->rtpSource()->curPacketMarkerBit() )
1652             p_block->i_flags |= BLOCK_FLAG_END_OF_FRAME;
1653     }
1654     else if( tk->fmt.i_codec == VLC_CODEC_H264 )
1655     {
1656         if( (tk->p_buffer[0] & 0x1f) >= 24 )
1657             msg_Warn( p_demux, "unsupported NAL type for H264" );
1658
1659         /* Normal NAL type */
1660         p_block = block_New( p_demux, i_size + 4 );
1661         p_block->p_buffer[0] = 0x00;
1662         p_block->p_buffer[1] = 0x00;
1663         p_block->p_buffer[2] = 0x00;
1664         p_block->p_buffer[3] = 0x01;
1665         memcpy( &p_block->p_buffer[4], tk->p_buffer, i_size );
1666     }
1667     else if( tk->b_asf )
1668     {
1669         int i_copy = __MIN( p_sys->asfh.i_min_data_packet_size, (int)i_size );
1670         p_block = block_New( p_demux, p_sys->asfh.i_min_data_packet_size );
1671
1672         memcpy( p_block->p_buffer, tk->p_buffer, i_copy );
1673     }
1674     else
1675     {
1676         p_block = block_New( p_demux, i_size );
1677         memcpy( p_block->p_buffer, tk->p_buffer, i_size );
1678     }
1679
1680     if( p_sys->i_pcr < i_pts )
1681     {
1682         p_sys->i_pcr = i_pts;
1683     }
1684
1685     if( (i_pts != tk->i_pts) && (!tk->b_muxed) )
1686     {
1687         p_block->i_pts = i_pts;
1688     }
1689
1690     /* Update our global npt value */
1691     if( tk->i_npt > 0 && tk->i_npt > p_sys->i_npt && tk->i_npt < p_sys->i_npt_length)
1692         p_sys->i_npt = tk->i_npt;
1693
1694     if( !tk->b_muxed )
1695     {
1696         /*FIXME: for h264 you should check that packetization-mode=1 in sdp-file */
1697         p_block->i_dts = ( tk->fmt.i_codec == VLC_CODEC_MPGV ) ? 0 : i_pts;
1698     }
1699
1700     if( tk->b_muxed )
1701     {
1702         stream_DemuxSend( tk->p_out_muxed, p_block );
1703     }
1704     else if( tk->b_asf )
1705     {
1706         stream_DemuxSend( p_sys->p_out_asf, p_block );
1707     }
1708     else
1709     {
1710         es_out_Send( p_demux->out, tk->p_es, p_block );
1711     }
1712
1713     /* warn that's ok */
1714     p_sys->event = 0xff;
1715
1716     /* we have read data */
1717     tk->waiting = 0;
1718     p_demux->p_sys->b_no_data = false;
1719     p_demux->p_sys->i_no_data_ti = 0;
1720
1721     if( i_pts > 0 && !tk->b_muxed )
1722     {
1723         tk->i_pts = i_pts;
1724     }
1725 }
1726
1727 /*****************************************************************************
1728  *
1729  *****************************************************************************/
1730 static void StreamClose( void *p_private )
1731 {
1732     live_track_t   *tk = (live_track_t*)p_private;
1733     demux_t        *p_demux = tk->p_demux;
1734     demux_sys_t    *p_sys = p_demux->p_sys;
1735
1736     msg_Dbg( p_demux, "StreamClose" );
1737
1738     p_sys->event = 0xff;
1739     p_demux->b_error = true;
1740 }
1741
1742
1743 /*****************************************************************************
1744  *
1745  *****************************************************************************/
1746 static void TaskInterrupt( void *p_private )
1747 {
1748     demux_t *p_demux = (demux_t*)p_private;
1749
1750     p_demux->p_sys->i_no_data_ti++;
1751
1752     /* Avoid lock */
1753     p_demux->p_sys->event = 0xff;
1754 }
1755
1756 /*****************************************************************************
1757  *
1758  *****************************************************************************/
1759 static void* TimeoutPrevention( void *p_data )
1760 {
1761     timeout_thread_t *p_timeout = (timeout_thread_t *)p_data;
1762
1763     for( ;; )
1764     {
1765         /* Voodoo (= no) thread safety here! *Ahem* */
1766         if( p_timeout->b_handle_keep_alive )
1767         {
1768             char *psz_bye = NULL;
1769             int canc = vlc_savecancel ();
1770
1771             p_timeout->p_sys->rtsp->getMediaSessionParameter( *p_timeout->p_sys->ms, NULL, psz_bye );
1772             vlc_restorecancel (canc);
1773         }
1774         p_timeout->p_sys->b_timeout_call = !p_timeout->b_handle_keep_alive;
1775
1776         msleep (((int64_t)p_timeout->p_sys->i_timeout - 2) * CLOCK_FREQ);
1777     }
1778     assert(0); /* dead code */
1779 }
1780
1781 /*****************************************************************************
1782  *
1783  *****************************************************************************/
1784 static int ParseASF( demux_t *p_demux )
1785 {
1786     demux_sys_t    *p_sys = p_demux->p_sys;
1787
1788     const char *psz_marker = "a=pgmpu:data:application/vnd.ms.wms-hdr.asfv1;base64,";
1789     char *psz_asf = strcasestr( p_sys->p_sdp, psz_marker );
1790     char *psz_end;
1791     block_t *p_header;
1792
1793     /* Parse the asf header */
1794     if( psz_asf == NULL )
1795         return VLC_EGENERIC;
1796
1797     psz_asf += strlen( psz_marker );
1798     psz_asf = strdup( psz_asf );    /* Duplicate it */
1799     psz_end = strchr( psz_asf, '\n' );
1800
1801     while( psz_end > psz_asf && ( *psz_end == '\n' || *psz_end == '\r' ) )
1802         *psz_end-- = '\0';
1803
1804     if( psz_asf >= psz_end )
1805     {
1806         free( psz_asf );
1807         return VLC_EGENERIC;
1808     }
1809
1810     /* Always smaller */
1811     p_header = block_New( p_demux, psz_end - psz_asf );
1812     p_header->i_buffer = vlc_b64_decode_binary_to_buffer( p_header->p_buffer,
1813                                                p_header->i_buffer, psz_asf );
1814     //msg_Dbg( p_demux, "Size=%d Hdrb64=%s", p_header->i_buffer, psz_asf );
1815     if( p_header->i_buffer <= 0 )
1816     {
1817         free( psz_asf );
1818         return VLC_EGENERIC;
1819     }
1820
1821     /* Parse it to get packet size */
1822     asf_HeaderParse( &p_sys->asfh, p_header->p_buffer, p_header->i_buffer );
1823
1824     /* Send it to demuxer */
1825     stream_DemuxSend( p_sys->p_out_asf, p_header );
1826
1827     free( psz_asf );
1828     return VLC_SUCCESS;
1829 }
1830
1831
1832 static unsigned char* parseH264ConfigStr( char const* configStr,
1833                                           unsigned int& configSize )
1834 {
1835     char *dup, *psz;
1836     size_t i_records = 1;
1837
1838     configSize = 0;
1839
1840     if( configStr == NULL || *configStr == '\0' )
1841         return NULL;
1842
1843     psz = dup = strdup( configStr );
1844
1845     /* Count the number of commas */
1846     for( psz = dup; *psz != '\0'; ++psz )
1847     {
1848         if( *psz == ',')
1849         {
1850             ++i_records;
1851             *psz = '\0';
1852         }
1853     }
1854
1855     size_t configMax = 5*strlen(dup);
1856     unsigned char *cfg = new unsigned char[configMax];
1857     psz = dup;
1858     for( size_t i = 0; i < i_records; ++i )
1859     {
1860         cfg[configSize++] = 0x00;
1861         cfg[configSize++] = 0x00;
1862         cfg[configSize++] = 0x00;
1863         cfg[configSize++] = 0x01;
1864
1865         configSize += vlc_b64_decode_binary_to_buffer( cfg+configSize,
1866                                           configMax-configSize, psz );
1867         psz += strlen(psz)+1;
1868     }
1869
1870     free( dup );
1871     return cfg;
1872 }