git.sesse.net Git - vlc/blob - src/stream_output/stream_output.c

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