]> git.sesse.net Git - vlc/blob - src/stream_output/stream_output.c
SAP announce: rewrite, use one thread per SAP group (fixes #1839)
[vlc] / src / stream_output / stream_output.c
1 /*****************************************************************************
2  * stream_output.c : stream output module
3  *****************************************************************************
4  * Copyright (C) 2002-2007 the VideoLAN team
5  * $Id$
6  *
7  * Authors: Christophe Massiot <massiot@via.ecp.fr>
8  *          Laurent Aimar <fenrir@via.ecp.fr>
9  *          Eric Petit <titer@videolan.org>
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
22  * along with this program; if not, write to the Free Software
23  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
24  *****************************************************************************/
25
26 /*****************************************************************************
27  * Preamble
28  *****************************************************************************/
29
30 #ifdef HAVE_CONFIG_H
31 # include "config.h"
32 #endif
33
34 #include <vlc_common.h>
35
36 #include <stdlib.h>                                                /* free() */
37 #include <stdio.h>                                              /* sprintf() */
38 #include <string.h>
39
40 #include <vlc_sout.h>
41
42 #include "stream_output.h"
43
44 #include <vlc_meta.h>
45
46 #include "input/input_internal.h"
47
48 #undef DEBUG_BUFFER
49 /*****************************************************************************
50  * Local prototypes
51  *****************************************************************************/
52 #define sout_stream_url_to_chain( p, s ) \
53     _sout_stream_url_to_chain( VLC_OBJECT(p), s )
54 static char *_sout_stream_url_to_chain( vlc_object_t *, const char * );
55
56 /*
57  * Generic MRL parser
58  *
59  */
60
61 typedef struct
62 {
63     char *psz_access;
64     char *psz_way;
65     char *psz_name;
66 } mrl_t;
67
68 /* mrl_Parse: parse psz_mrl and fill p_mrl */
69 static int  mrl_Parse( mrl_t *p_mrl, const char *psz_mrl );
70 /* mrl_Clean: clean p_mrl  after a call to mrl_Parse */
71 static void mrl_Clean( mrl_t *p_mrl );
72
73 /*****************************************************************************
74  * sout_NewInstance: creates a new stream output instance
75  *****************************************************************************/
76 sout_instance_t *__sout_NewInstance( vlc_object_t *p_parent, const char *psz_dest )
77 {
78     static const char typename[] = "stream output";
79     sout_instance_t *p_sout;
80
81     /* *** Allocate descriptor *** */
82     p_sout = vlc_custom_create( p_parent, sizeof( *p_sout ),
83                                 VLC_OBJECT_GENERIC, typename );
84     if( p_sout == NULL )
85         return NULL;
86
87     /* *** init descriptor *** */
88     p_sout->psz_sout    = strdup( psz_dest );
89     p_sout->p_meta      = NULL;
90     p_sout->i_out_pace_nocontrol = 0;
91     p_sout->p_sys       = NULL;
92
93     vlc_mutex_init( &p_sout->lock );
94     if( psz_dest && psz_dest[0] == '#' )
95     {
96         p_sout->psz_chain = strdup( &psz_dest[1] );
97     }
98     else
99     {
100         p_sout->psz_chain = sout_stream_url_to_chain( p_sout, psz_dest );
101         msg_Dbg( p_sout, "using sout chain=`%s'", p_sout->psz_chain );
102     }
103     p_sout->p_stream = NULL;
104
105     /* attach it for inherit */
106     vlc_object_attach( p_sout, p_parent );
107
108     /* */
109     var_Create( p_sout, "sout-mux-caching", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT );
110
111     /* */
112     p_sout->p_stream = sout_StreamNew( p_sout, p_sout->psz_chain );
113     if( p_sout->p_stream == NULL )
114     {
115         msg_Err( p_sout, "stream chain failed for `%s'", p_sout->psz_chain );
116
117         FREENULL( p_sout->psz_sout );
118         FREENULL( p_sout->psz_chain );
119
120         vlc_object_detach( p_sout );
121         vlc_object_release( p_sout );
122         return NULL;
123     }
124
125     return p_sout;
126 }
127
128 /*****************************************************************************
129  * sout_DeleteInstance: delete a previously allocated instance
130  *****************************************************************************/
131 void sout_DeleteInstance( sout_instance_t * p_sout )
132 {
133     /* remove the stream out chain */
134     sout_StreamDelete( p_sout->p_stream );
135
136     /* *** free all string *** */
137     FREENULL( p_sout->psz_sout );
138     FREENULL( p_sout->psz_chain );
139
140     /* delete meta */
141     if( p_sout->p_meta )
142     {
143         vlc_meta_Delete( p_sout->p_meta );
144     }
145
146     vlc_mutex_destroy( &p_sout->lock );
147
148     /* *** free structure *** */
149     vlc_object_release( p_sout );
150 }
151
152 /*****************************************************************************
153  * 
154  *****************************************************************************/
155 void sout_UpdateStatistic( sout_instance_t *p_sout, sout_statistic_t i_type, int i_delta )
156 {
157     input_thread_t *p_input;
158     int i_bytes; /* That's pretty stupid to define it as an integer, it will overflow
159                     really fast ... */
160
161     if( !libvlc_stats (p_sout) )
162         return;
163
164     /* FIXME that's ugly
165      * TODO add a private (ie not VLC_EXPORTed) input_UpdateStatistic for that */
166     p_input = vlc_object_find( p_sout, VLC_OBJECT_INPUT, FIND_PARENT );
167     if( !p_input || p_input->i_state == INIT_S || p_input->i_state == ERROR_S )
168         return;
169
170     switch( i_type )
171     {
172 #define I(c) stats_UpdateInteger( p_input, p_input->p->counters.c, i_delta, NULL )
173     case SOUT_STATISTIC_DECODED_VIDEO:
174         I(p_decoded_video);
175         break;
176     case SOUT_STATISTIC_DECODED_AUDIO:
177         I(p_decoded_audio);
178         break;
179     case SOUT_STATISTIC_DECODED_SUBTITLE:
180         I(p_decoded_sub);
181         break;
182 #if 0
183     case SOUT_STATISTIC_ENCODED_VIDEO:
184     case SOUT_STATISTIC_ENCODED_AUDIO:
185     case SOUT_STATISTIC_ENCODED_SUBTITLE:
186         msg_Warn( p_sout, "Not yet supported statistic type %d", i_type );
187         break;
188 #endif
189
190     case SOUT_STATISTIC_SENT_PACKET:
191         I(p_sout_sent_packets);
192         break;
193 #undef I
194     case SOUT_STATISTIC_SENT_BYTE:
195         if( !stats_UpdateInteger( p_input, p_input->p->counters.p_sout_sent_bytes, i_delta, &i_bytes ) )
196             stats_UpdateFloat( p_input, p_input->p->counters.p_sout_send_bitrate, i_bytes, NULL );
197         break;
198
199     default:
200         msg_Err( p_sout, "Invalid statistic type %d (internal error)", i_type );
201         break;
202     }
203     vlc_object_release( p_input );
204 }
205 /*****************************************************************************
206  * Packetizer/Input
207  *****************************************************************************/
208 sout_packetizer_input_t *sout_InputNew( sout_instance_t *p_sout,
209                                         es_format_t *p_fmt )
210 {
211     sout_packetizer_input_t *p_input;
212
213     /* *** create a packetizer input *** */
214     p_input         = malloc( sizeof( sout_packetizer_input_t ) );
215     if( !p_input )  return NULL;
216     p_input->p_sout = p_sout;
217     p_input->p_fmt  = p_fmt;
218
219     msg_Dbg( p_sout, "adding a new sout input (sout_input:%p)", p_input );
220
221     if( p_fmt->i_codec == VLC_FOURCC( 'n', 'u', 'l', 'l' ) )
222     {
223         vlc_object_release( p_sout );
224         return p_input;
225     }
226
227     /* *** add it to the stream chain */
228     vlc_mutex_lock( &p_sout->lock );
229     p_input->id = p_sout->p_stream->pf_add( p_sout->p_stream, p_fmt );
230     vlc_mutex_unlock( &p_sout->lock );
231
232     if( p_input->id == NULL )
233     {
234         free( p_input );
235         return NULL;
236     }
237
238     return( p_input );
239 }
240
241 /*****************************************************************************
242  *
243  *****************************************************************************/
244 int sout_InputDelete( sout_packetizer_input_t *p_input )
245 {
246     sout_instance_t     *p_sout = p_input->p_sout;
247
248     msg_Dbg( p_sout, "removing a sout input (sout_input:%p)", p_input );
249
250     if( p_input->p_fmt->i_codec != VLC_FOURCC( 'n', 'u', 'l', 'l' ) )
251     {
252         vlc_mutex_lock( &p_sout->lock );
253         p_sout->p_stream->pf_del( p_sout->p_stream, p_input->id );
254         vlc_mutex_unlock( &p_sout->lock );
255     }
256
257     free( p_input );
258
259     return( VLC_SUCCESS);
260 }
261
262 /*****************************************************************************
263  *
264  *****************************************************************************/
265 int sout_InputSendBuffer( sout_packetizer_input_t *p_input,
266                           block_t *p_buffer )
267 {
268     sout_instance_t     *p_sout = p_input->p_sout;
269     int                 i_ret;
270
271     if( p_input->p_fmt->i_codec == VLC_FOURCC( 'n', 'u', 'l', 'l' ) )
272     {
273         block_Release( p_buffer );
274         return VLC_SUCCESS;
275     }
276     if( p_buffer->i_dts <= 0 )
277     {
278         msg_Warn( p_sout, "trying to send non-dated packet to stream output!");
279         block_Release( p_buffer );
280         return VLC_SUCCESS;
281     }
282
283     vlc_mutex_lock( &p_sout->lock );
284     i_ret = p_sout->p_stream->pf_send( p_sout->p_stream,
285                                        p_input->id, p_buffer );
286     vlc_mutex_unlock( &p_sout->lock );
287
288     return i_ret;
289 }
290
291 #undef sout_AccessOutNew
292 /*****************************************************************************
293  * sout_AccessOutNew: allocate a new access out
294  *****************************************************************************/
295 sout_access_out_t *sout_AccessOutNew( vlc_object_t *p_sout,
296                                       const char *psz_access, const char *psz_name )
297 {
298     static const char typename[] = "access out";
299     sout_access_out_t *p_access;
300     char              *psz_next;
301
302     p_access = vlc_custom_create( p_sout, sizeof( *p_access ),
303                                   VLC_OBJECT_GENERIC, typename );
304     if( !p_access )
305         return NULL;
306
307     psz_next = config_ChainCreate( &p_access->psz_access, &p_access->p_cfg,
308                                    psz_access );
309     free( psz_next );
310     p_access->psz_path   = strdup( psz_name ? psz_name : "" );
311     p_access->p_sys      = NULL;
312     p_access->pf_seek    = NULL;
313     p_access->pf_read    = NULL;
314     p_access->pf_write   = NULL;
315     p_access->pf_control = NULL;
316     p_access->p_module   = NULL;
317
318     p_access->i_writes = 0;
319     p_access->i_sent_bytes = 0;
320
321     vlc_object_attach( p_access, p_sout );
322
323     p_access->p_module   =
324         module_Need( p_access, "sout access", p_access->psz_access, true );
325
326     if( !p_access->p_module )
327     {
328         free( p_access->psz_access );
329         free( p_access->psz_path );
330         vlc_object_detach( p_access );
331         vlc_object_release( p_access );
332         return( NULL );
333     }
334
335     return p_access;
336 }
337 /*****************************************************************************
338  * sout_AccessDelete: delete an access out
339  *****************************************************************************/
340 void sout_AccessOutDelete( sout_access_out_t *p_access )
341 {
342     vlc_object_detach( p_access );
343     if( p_access->p_module )
344     {
345         module_Unneed( p_access, p_access->p_module );
346     }
347     free( p_access->psz_access );
348
349     config_ChainDestroy( p_access->p_cfg );
350
351     free( p_access->psz_path );
352
353     vlc_object_release( p_access );
354 }
355
356 /*****************************************************************************
357  * sout_AccessSeek:
358  *****************************************************************************/
359 int sout_AccessOutSeek( sout_access_out_t *p_access, off_t i_pos )
360 {
361     return p_access->pf_seek( p_access, i_pos );
362 }
363
364 /*****************************************************************************
365  * sout_AccessRead:
366  *****************************************************************************/
367 ssize_t sout_AccessOutRead( sout_access_out_t *p_access, block_t *p_buffer )
368 {
369     return( p_access->pf_read ?
370             p_access->pf_read( p_access, p_buffer ) : VLC_EGENERIC );
371 }
372
373 /*****************************************************************************
374  * sout_AccessWrite:
375  *****************************************************************************/
376 ssize_t sout_AccessOutWrite( sout_access_out_t *p_access, block_t *p_buffer )
377 {
378 #if 0
379     const unsigned i_packets_gather = 30;
380     p_access->i_writes++;
381     p_access->i_sent_bytes += p_buffer->i_buffer;
382     if( (p_access->i_writes % i_packets_gather) == 0 )
383     {
384         sout_UpdateStatistic( p_access->p_sout, SOUT_STATISTIC_SENT_PACKET, i_packets_gather );
385         sout_UpdateStatistic( p_access->p_sout, SOUT_STATISTIC_SENT_BYTE, p_access->i_sent_bytes );
386         p_access->i_sent_bytes = 0;
387     }
388 #endif
389     return p_access->pf_write( p_access, p_buffer );
390 }
391
392 /**
393  * sout_AccessOutControl
394  */
395 int sout_AccessOutControl (sout_access_out_t *access, int query, ...)
396 {
397     va_list ap;
398     int ret;
399
400     va_start (ap, query);
401     if (access->pf_control)
402         ret = access->pf_control (access, query, ap);
403     else
404         ret = VLC_EGENERIC;
405     va_end (ap);
406     return ret;
407 }
408
409 /*****************************************************************************
410  * sout_MuxNew: create a new mux
411  *****************************************************************************/
412 sout_mux_t * sout_MuxNew( sout_instance_t *p_sout, char *psz_mux,
413                           sout_access_out_t *p_access )
414 {
415     static const char typename[] = "mux";
416     sout_mux_t *p_mux;
417     char       *psz_next;
418
419     p_mux = vlc_custom_create( p_sout, sizeof( *p_mux ), VLC_OBJECT_GENERIC,
420                                typename);
421     if( p_mux == NULL )
422         return NULL;
423
424     p_mux->p_sout = p_sout;
425     psz_next = config_ChainCreate( &p_mux->psz_mux, &p_mux->p_cfg, psz_mux );
426     free( psz_next );
427
428     p_mux->p_access     = p_access;
429     p_mux->pf_control   = NULL;
430     p_mux->pf_addstream = NULL;
431     p_mux->pf_delstream = NULL;
432     p_mux->pf_mux       = NULL;
433     p_mux->i_nb_inputs  = 0;
434     p_mux->pp_inputs    = NULL;
435
436     p_mux->p_sys        = NULL;
437     p_mux->p_module     = NULL;
438
439     p_mux->b_add_stream_any_time = false;
440     p_mux->b_waiting_stream = true;
441     p_mux->i_add_stream_start = -1;
442
443     vlc_object_attach( p_mux, p_sout );
444
445     p_mux->p_module =
446         module_Need( p_mux, "sout mux", p_mux->psz_mux, true );
447
448     if( p_mux->p_module == NULL )
449     {
450         FREENULL( p_mux->psz_mux );
451
452         vlc_object_detach( p_mux );
453         vlc_object_release( p_mux );
454         return NULL;
455     }
456
457     /* *** probe mux capacity *** */
458     if( p_mux->pf_control )
459     {
460         int b_answer = false;
461
462         if( sout_MuxControl( p_mux, MUX_CAN_ADD_STREAM_WHILE_MUXING,
463                              &b_answer ) )
464         {
465             b_answer = false;
466         }
467
468         if( b_answer )
469         {
470             msg_Dbg( p_sout, "muxer support adding stream at any time" );
471             p_mux->b_add_stream_any_time = true;
472             p_mux->b_waiting_stream = false;
473
474             /* If we control the output pace then it's better to wait before
475              * starting muxing (generates better streams/files). */
476             if( !p_sout->i_out_pace_nocontrol )
477             {
478                 b_answer = true;
479             }
480             else if( sout_MuxControl( p_mux, MUX_GET_ADD_STREAM_WAIT,
481                                       &b_answer ) )
482             {
483                 b_answer = false;
484             }
485
486             if( b_answer )
487             {
488                 msg_Dbg( p_sout, "muxer prefers to wait for all ES before "
489                          "starting to mux" );
490                 p_mux->b_waiting_stream = true;
491             }
492         }
493     }
494
495     return p_mux;
496 }
497
498 /*****************************************************************************
499  * sout_MuxDelete:
500  *****************************************************************************/
501 void sout_MuxDelete( sout_mux_t *p_mux )
502 {
503     vlc_object_detach( p_mux );
504     if( p_mux->p_module )
505     {
506         module_Unneed( p_mux, p_mux->p_module );
507     }
508     free( p_mux->psz_mux );
509
510     config_ChainDestroy( p_mux->p_cfg );
511
512     vlc_object_release( p_mux );
513 }
514
515 /*****************************************************************************
516  * sout_MuxAddStream:
517  *****************************************************************************/
518 sout_input_t *sout_MuxAddStream( sout_mux_t *p_mux, es_format_t *p_fmt )
519 {
520     sout_input_t *p_input;
521
522     if( !p_mux->b_add_stream_any_time && !p_mux->b_waiting_stream )
523     {
524         msg_Err( p_mux, "cannot add a new stream (unsupported while muxing "
525                         "to this format). You can try increasing sout-mux-caching value" );
526         return NULL;
527     }
528
529     msg_Dbg( p_mux, "adding a new input" );
530
531     /* create a new sout input */
532     p_input = malloc( sizeof( sout_input_t ) );
533     if( !p_input )
534         return NULL;
535     p_input->p_sout = p_mux->p_sout;
536     p_input->p_fmt  = p_fmt;
537     p_input->p_fifo = block_FifoNew();
538     p_input->p_sys  = NULL;
539
540     TAB_APPEND( p_mux->i_nb_inputs, p_mux->pp_inputs, p_input );
541     if( p_mux->pf_addstream( p_mux, p_input ) < 0 )
542     {
543         msg_Err( p_mux, "cannot add this stream" );
544         TAB_REMOVE( p_mux->i_nb_inputs, p_mux->pp_inputs, p_input );
545         block_FifoRelease( p_input->p_fifo );
546         free( p_input );
547         return NULL;
548     }
549
550     return p_input;
551 }
552
553 /*****************************************************************************
554  * sout_MuxDeleteStream:
555  *****************************************************************************/
556 void sout_MuxDeleteStream( sout_mux_t *p_mux, sout_input_t *p_input )
557 {
558     int i_index;
559
560     if( p_mux->b_waiting_stream
561      && block_FifoCount( p_input->p_fifo ) > 0 )
562     {
563         /* We stop waiting, and call the muxer for taking care of the data
564          * before we remove this es */
565         p_mux->b_waiting_stream = false;
566         p_mux->pf_mux( p_mux );
567     }
568
569     TAB_FIND( p_mux->i_nb_inputs, p_mux->pp_inputs, p_input, i_index );
570     if( i_index >= 0 )
571     {
572         if( p_mux->pf_delstream( p_mux, p_input ) < 0 )
573         {
574             msg_Err( p_mux, "cannot delete this stream from mux" );
575         }
576
577         /* remove the entry */
578         TAB_REMOVE( p_mux->i_nb_inputs, p_mux->pp_inputs, p_input );
579
580         if( p_mux->i_nb_inputs == 0 )
581         {
582             msg_Warn( p_mux, "no more input streams for this mux" );
583         }
584
585         block_FifoRelease( p_input->p_fifo );
586         free( p_input );
587     }
588 }
589
590 /*****************************************************************************
591  * sout_MuxSendBuffer:
592  *****************************************************************************/
593 void sout_MuxSendBuffer( sout_mux_t *p_mux, sout_input_t *p_input,
594                          block_t *p_buffer )
595 {
596     block_FifoPut( p_input->p_fifo, p_buffer );
597
598     if( p_mux->p_sout->i_out_pace_nocontrol )
599     {
600         mtime_t current_date = mdate();
601         if ( current_date > p_buffer->i_dts )
602             msg_Warn( p_mux, "late buffer for mux input (%"PRId64")",
603                       current_date - p_buffer->i_dts );
604     }
605
606     if( p_mux->b_waiting_stream )
607     {
608         const int64_t i_caching = var_GetInteger( p_mux->p_sout, "sout-mux-caching" ) * INT64_C(1000);
609
610         if( p_mux->i_add_stream_start < 0 )
611             p_mux->i_add_stream_start = p_buffer->i_dts;
612
613         /* Wait until we have enought data before muxing */
614         if( p_mux->i_add_stream_start < 0 ||
615             p_buffer->i_dts < p_mux->i_add_stream_start + i_caching )
616             return;
617         p_mux->b_waiting_stream = false;
618     }
619     p_mux->pf_mux( p_mux );
620 }
621
622 /*****************************************************************************
623  *
624  *****************************************************************************/
625 static int mrl_Parse( mrl_t *p_mrl, const char *psz_mrl )
626 {
627     char * psz_dup = strdup( psz_mrl );
628     char * psz_parser = psz_dup;
629     const char * psz_access;
630     const char * psz_way;
631     char * psz_name;
632
633     /* *** first parse psz_dest */
634     while( *psz_parser && *psz_parser != ':' )
635     {
636         if( *psz_parser == '{' )
637         {
638             while( *psz_parser && *psz_parser != '}' )
639             {
640                 psz_parser++;
641             }
642             if( *psz_parser )
643             {
644                 psz_parser++;
645             }
646         }
647         else
648         {
649             psz_parser++;
650         }
651     }
652 #if defined( WIN32 ) || defined( UNDER_CE )
653     if( psz_parser - psz_dup == 1 )
654     {
655         /* msg_Warn( p_sout, "drive letter %c: found in source string",
656                           *psz_dup ) ; */
657         psz_parser = "";
658     }
659 #endif
660
661     if( !*psz_parser )
662     {
663         psz_access = psz_way = "";
664         psz_name = psz_dup;
665     }
666     else
667     {
668         *psz_parser++ = '\0';
669
670         /* let's skip '//' */
671         if( psz_parser[0] == '/' && psz_parser[1] == '/' )
672         {
673             psz_parser += 2 ;
674         }
675
676         psz_name = psz_parser ;
677
678         /* Come back to parse the access and mux plug-ins */
679         psz_parser = psz_dup;
680
681         if( !*psz_parser )
682         {
683             /* No access */
684             psz_access = "";
685         }
686         else if( *psz_parser == '/' )
687         {
688             /* No access */
689             psz_access = "";
690             psz_parser++;
691         }
692         else
693         {
694             psz_access = psz_parser;
695
696             while( *psz_parser && *psz_parser != '/' )
697             {
698                 if( *psz_parser == '{' )
699                 {
700                     while( *psz_parser && *psz_parser != '}' )
701                     {
702                         psz_parser++;
703                     }
704                     if( *psz_parser )
705                     {
706                         psz_parser++;
707                     }
708                 }
709                 else
710                 {
711                     psz_parser++;
712                 }
713             }
714
715             if( *psz_parser == '/' )
716             {
717                 *psz_parser++ = '\0';
718             }
719         }
720
721         if( !*psz_parser )
722         {
723             /* No mux */
724             psz_way = "";
725         }
726         else
727         {
728             psz_way = psz_parser;
729         }
730     }
731
732     p_mrl->psz_access = strdup( psz_access );
733     p_mrl->psz_way    = strdup( psz_way );
734     p_mrl->psz_name   = strdup( psz_name );
735
736     free( psz_dup );
737     return( VLC_SUCCESS );
738 }
739
740
741 /* mrl_Clean: clean p_mrl  after a call to mrl_Parse */
742 static void mrl_Clean( mrl_t *p_mrl )
743 {
744     FREENULL( p_mrl->psz_access );
745     FREENULL( p_mrl->psz_way );
746     FREENULL( p_mrl->psz_name );
747 }
748
749
750 /****************************************************************************
751  ****************************************************************************
752  **
753  **
754  **
755  ****************************************************************************
756  ****************************************************************************/
757
758 /* create a complete chain */
759 /* chain format:
760     module{option=*:option=*}[:module{option=*:...}]
761  */
762
763 /*
764  * parse module{options=str, option="str "}:
765  *  return a pointer on the rest
766  *  XXX: psz_chain is modified
767  */
768
769 /*
770  * XXX name and p_cfg are used (-> do NOT free them)
771  */
772 sout_stream_t *sout_StreamNew( sout_instance_t *p_sout, char *psz_chain )
773 {
774     static const char typename[] = "stream out";
775     sout_stream_t *p_stream;
776
777     if( !psz_chain )
778     {
779         msg_Err( p_sout, "invalid chain" );
780         return NULL;
781     }
782
783     p_stream = vlc_custom_create( p_sout, sizeof( *p_stream ),
784                                   VLC_OBJECT_GENERIC, typename );
785     if( !p_stream )
786         return NULL;
787
788     p_stream->p_sout   = p_sout;
789     p_stream->p_sys    = NULL;
790
791     p_stream->psz_next =
792         config_ChainCreate( &p_stream->psz_name, &p_stream->p_cfg, psz_chain);
793
794     msg_Dbg( p_sout, "stream=`%s'", p_stream->psz_name );
795
796     vlc_object_attach( p_stream, p_sout );
797
798     p_stream->p_module =
799         module_Need( p_stream, "sout stream", p_stream->psz_name, true );
800
801     if( !p_stream->p_module )
802     {
803         sout_StreamDelete( p_stream );
804         return NULL;
805     }
806
807     return p_stream;
808 }
809
810 void sout_StreamDelete( sout_stream_t *p_stream )
811 {
812     msg_Dbg( p_stream, "destroying chain... (name=%s)", p_stream->psz_name );
813
814     vlc_object_detach( p_stream );
815     if( p_stream->p_module ) module_Unneed( p_stream, p_stream->p_module );
816
817     FREENULL( p_stream->psz_name );
818     FREENULL( p_stream->psz_next );
819
820     config_ChainDestroy( p_stream->p_cfg );
821
822     msg_Dbg( p_stream, "destroying chain done" );
823     vlc_object_release( p_stream );
824 }
825
826 static char *_sout_stream_url_to_chain( vlc_object_t *p_this,
827                                         const char *psz_url )
828 {
829     mrl_t       mrl;
830     char        *psz_chain;
831
832     mrl_Parse( &mrl, psz_url );
833
834     /* Check if the URLs goes to #rtp - otherwise we'll use #standard */
835     static const char rtplist[] = "dccp\0sctp\0tcp\0udplite\0";
836     for (const char *a = rtplist; *a; a += strlen (a) + 1)
837         if (strcmp (a, mrl.psz_access) == 0)
838             goto rtp;
839
840     if (strcmp (mrl.psz_access, "rtp") == 0)
841     {
842         char *port;
843         /* For historical reasons, rtp:// means RTP over UDP */
844         strcpy (mrl.psz_access, "udp");
845 rtp:
846         if (mrl.psz_name[0] == '[')
847         {
848             port = strstr (mrl.psz_name, "]:");
849             if (port != NULL)
850                 port++;
851         }
852         else
853             port = strchr (mrl.psz_name, ':');
854         if (port != NULL)
855             *port++ = '\0'; /* erase ':' */
856
857         if (asprintf (&psz_chain,
858                       "rtp{mux=\"%s\",proto=\"%s\",dst=\"%s%s%s\"}",
859                       mrl.psz_way, mrl.psz_access, mrl.psz_name,
860                       port ? "\",port=\"" : "", port ? port : "") == -1)
861             psz_chain = NULL;
862     }
863     else
864     {
865         /* Convert the URL to a basic standard sout chain */
866         if (asprintf (&psz_chain,
867                       "standard{mux=\"%s\",access=\"%s\",dst=\"%s\"}",
868                       mrl.psz_way, mrl.psz_access, mrl.psz_name) == -1)
869             psz_chain = NULL;
870     }
871
872     /* Duplicate and wrap if sout-display is on */
873     if (psz_chain && (config_GetInt( p_this, "sout-display" ) > 0))
874     {
875         char *tmp;
876         if (asprintf (&tmp, "duplicate{dst=display,dst=%s}", tmp) == -1)
877             tmp = NULL;
878         free (psz_chain);
879         psz_chain = tmp;
880     }
881
882     mrl_Clean( &mrl );
883     return psz_chain;
884 }