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