1 /*****************************************************************************
2 * stream_output.c : stream output module
3 *****************************************************************************
4 * Copyright (C) 2002-2007 the VideoLAN team
7 * Authors: Christophe Massiot <massiot@via.ecp.fr>
8 * Laurent Aimar <fenrir@via.ecp.fr>
9 * Eric Petit <titer@videolan.org>
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.
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.
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 *****************************************************************************/
26 /*****************************************************************************
28 *****************************************************************************/
34 #include <vlc_common.h>
36 #include <stdlib.h> /* free() */
37 #include <stdio.h> /* sprintf() */
42 #include "stream_output.h"
46 #include "input/input_internal.h"
49 /*****************************************************************************
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 * );
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 );
73 /*****************************************************************************
74 * sout_NewInstance: creates a new stream output instance
75 *****************************************************************************/
76 sout_instance_t *__sout_NewInstance( vlc_object_t *p_parent, char * psz_dest )
78 static const char typename[] = "stream output";
79 sout_instance_t *p_sout;
81 /* *** Allocate descriptor *** */
82 p_sout = vlc_custom_create( p_parent, sizeof( *p_sout ),
83 VLC_OBJECT_GENERIC, typename );
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;
93 vlc_mutex_init( &p_sout->lock );
94 if( psz_dest && psz_dest[0] == '#' )
96 p_sout->psz_chain = strdup( &psz_dest[1] );
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 );
103 p_sout->p_stream = NULL;
105 /* attach it for inherit */
106 vlc_object_attach( p_sout, p_parent );
109 var_Create( p_sout, "sout-mux-caching", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT );
112 p_sout->p_stream = sout_StreamNew( p_sout, p_sout->psz_chain );
113 if( p_sout->p_stream == NULL )
115 msg_Err( p_sout, "stream chain failed for `%s'", p_sout->psz_chain );
117 FREENULL( p_sout->psz_sout );
118 FREENULL( p_sout->psz_chain );
120 vlc_object_detach( p_sout );
121 vlc_object_release( p_sout );
128 /*****************************************************************************
129 * sout_DeleteInstance: delete a previously allocated instance
130 *****************************************************************************/
131 void sout_DeleteInstance( sout_instance_t * p_sout )
133 /* remove the stream out chain */
134 sout_StreamDelete( p_sout->p_stream );
136 /* *** free all string *** */
137 FREENULL( p_sout->psz_sout );
138 FREENULL( p_sout->psz_chain );
143 vlc_meta_Delete( p_sout->p_meta );
146 vlc_mutex_destroy( &p_sout->lock );
148 /* *** free structure *** */
149 vlc_object_release( p_sout );
152 /*****************************************************************************
154 *****************************************************************************/
155 void sout_UpdateStatistic( sout_instance_t *p_sout, sout_statistic_t i_type, int i_delta )
157 input_thread_t *p_input;
158 int i_bytes; /* That's pretty stupid to define it as an integer, it will overflow
161 if( !libvlc_stats (p_sout) )
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 )
172 #define I(c) stats_UpdateInteger( p_input, p_input->p->counters.c, i_delta, NULL )
173 case SOUT_STATISTIC_DECODED_VIDEO:
176 case SOUT_STATISTIC_DECODED_AUDIO:
179 case SOUT_STATISTIC_DECODED_SUBTITLE:
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 );
190 case SOUT_STATISTIC_SENT_PACKET:
191 I(p_sout_sent_packets);
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 );
200 msg_Err( p_sout, "Invalid statistic type %d (internal error)", i_type );
203 vlc_object_release( p_input );
205 /*****************************************************************************
207 *****************************************************************************/
208 sout_packetizer_input_t *sout_InputNew( sout_instance_t *p_sout,
211 sout_packetizer_input_t *p_input;
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;
219 msg_Dbg( p_sout, "adding a new sout input (sout_input:%p)", p_input );
221 if( p_fmt->i_codec == VLC_FOURCC( 'n', 'u', 'l', 'l' ) )
223 vlc_object_release( p_sout );
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 );
232 if( p_input->id == NULL )
241 /*****************************************************************************
243 *****************************************************************************/
244 int sout_InputDelete( sout_packetizer_input_t *p_input )
246 sout_instance_t *p_sout = p_input->p_sout;
248 msg_Dbg( p_sout, "removing a sout input (sout_input:%p)", p_input );
250 if( p_input->p_fmt->i_codec != VLC_FOURCC( 'n', 'u', 'l', 'l' ) )
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 );
259 return( VLC_SUCCESS);
262 /*****************************************************************************
264 *****************************************************************************/
265 int sout_InputSendBuffer( sout_packetizer_input_t *p_input,
268 sout_instance_t *p_sout = p_input->p_sout;
271 if( p_input->p_fmt->i_codec == VLC_FOURCC( 'n', 'u', 'l', 'l' ) )
273 block_Release( p_buffer );
276 if( p_buffer->i_dts <= 0 )
278 msg_Warn( p_sout, "trying to send non-dated packet to stream output!");
279 block_Release( p_buffer );
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 );
291 /*****************************************************************************
292 * sout_AccessOutNew: allocate a new access out
293 *****************************************************************************/
294 sout_access_out_t *sout_AccessOutNew( sout_instance_t *p_sout,
295 const char *psz_access, const char *psz_name )
297 sout_access_out_t *p_access;
300 if( !( p_access = vlc_object_create( p_sout,
301 sizeof( sout_access_out_t ) ) ) )
304 psz_next = config_ChainCreate( &p_access->psz_access, &p_access->p_cfg,
307 p_access->psz_path = strdup( psz_name ? psz_name : "" );
308 p_access->p_sout = p_sout;
309 p_access->p_sys = NULL;
310 p_access->pf_seek = NULL;
311 p_access->pf_read = NULL;
312 p_access->pf_write = NULL;
313 p_access->pf_control = NULL;
314 p_access->p_module = NULL;
316 p_access->i_writes = 0;
317 p_access->i_sent_bytes = 0;
319 vlc_object_attach( p_access, p_sout );
322 module_Need( p_access, "sout access", p_access->psz_access, true );
324 if( !p_access->p_module )
326 free( p_access->psz_access );
327 free( p_access->psz_path );
328 vlc_object_detach( p_access );
329 vlc_object_release( p_access );
335 /*****************************************************************************
336 * sout_AccessDelete: delete an access out
337 *****************************************************************************/
338 void sout_AccessOutDelete( sout_access_out_t *p_access )
340 vlc_object_detach( p_access );
341 if( p_access->p_module )
343 module_Unneed( p_access, p_access->p_module );
345 free( p_access->psz_access );
347 config_ChainDestroy( p_access->p_cfg );
349 free( p_access->psz_path );
351 vlc_object_release( p_access );
354 /*****************************************************************************
356 *****************************************************************************/
357 int sout_AccessOutSeek( sout_access_out_t *p_access, off_t i_pos )
359 return p_access->pf_seek( p_access, i_pos );
362 /*****************************************************************************
364 *****************************************************************************/
365 ssize_t sout_AccessOutRead( sout_access_out_t *p_access, block_t *p_buffer )
367 return( p_access->pf_read ?
368 p_access->pf_read( p_access, p_buffer ) : VLC_EGENERIC );
371 /*****************************************************************************
373 *****************************************************************************/
374 ssize_t sout_AccessOutWrite( sout_access_out_t *p_access, block_t *p_buffer )
376 const unsigned i_packets_gather = 30;
377 p_access->i_writes++;
378 p_access->i_sent_bytes += p_buffer->i_buffer;
379 if( (p_access->i_writes % i_packets_gather) == 0 )
381 sout_UpdateStatistic( p_access->p_sout, SOUT_STATISTIC_SENT_PACKET, i_packets_gather );
382 sout_UpdateStatistic( p_access->p_sout, SOUT_STATISTIC_SENT_BYTE, p_access->i_sent_bytes );
383 p_access->i_sent_bytes = 0;
385 return p_access->pf_write( p_access, p_buffer );
389 * sout_AccessOutControl
391 int sout_AccessOutControl (sout_access_out_t *access, int query, va_list args)
393 return (access->pf_control) ? access->pf_control (access, query, args)
397 /*****************************************************************************
398 * sout_MuxNew: create a new mux
399 *****************************************************************************/
400 sout_mux_t * sout_MuxNew( sout_instance_t *p_sout, char *psz_mux,
401 sout_access_out_t *p_access )
406 p_mux = vlc_object_create( p_sout, sizeof( sout_mux_t ) );
410 p_mux->p_sout = p_sout;
411 psz_next = config_ChainCreate( &p_mux->psz_mux, &p_mux->p_cfg, psz_mux );
414 p_mux->p_access = p_access;
415 p_mux->pf_control = NULL;
416 p_mux->pf_addstream = NULL;
417 p_mux->pf_delstream = NULL;
418 p_mux->pf_mux = NULL;
419 p_mux->i_nb_inputs = 0;
420 p_mux->pp_inputs = NULL;
423 p_mux->p_module = NULL;
425 p_mux->b_add_stream_any_time = false;
426 p_mux->b_waiting_stream = true;
427 p_mux->i_add_stream_start = -1;
429 vlc_object_attach( p_mux, p_sout );
432 module_Need( p_mux, "sout mux", p_mux->psz_mux, true );
434 if( p_mux->p_module == NULL )
436 FREENULL( p_mux->psz_mux );
438 vlc_object_detach( p_mux );
439 vlc_object_release( p_mux );
443 /* *** probe mux capacity *** */
444 if( p_mux->pf_control )
446 int b_answer = false;
448 if( sout_MuxControl( p_mux, MUX_CAN_ADD_STREAM_WHILE_MUXING,
456 msg_Dbg( p_sout, "muxer support adding stream at any time" );
457 p_mux->b_add_stream_any_time = true;
458 p_mux->b_waiting_stream = false;
460 /* If we control the output pace then it's better to wait before
461 * starting muxing (generates better streams/files). */
462 if( !p_sout->i_out_pace_nocontrol )
466 else if( sout_MuxControl( p_mux, MUX_GET_ADD_STREAM_WAIT,
474 msg_Dbg( p_sout, "muxer prefers to wait for all ES before "
476 p_mux->b_waiting_stream = true;
484 /*****************************************************************************
486 *****************************************************************************/
487 void sout_MuxDelete( sout_mux_t *p_mux )
489 vlc_object_detach( p_mux );
490 if( p_mux->p_module )
492 module_Unneed( p_mux, p_mux->p_module );
494 free( p_mux->psz_mux );
496 config_ChainDestroy( p_mux->p_cfg );
498 vlc_object_release( p_mux );
501 /*****************************************************************************
503 *****************************************************************************/
504 sout_input_t *sout_MuxAddStream( sout_mux_t *p_mux, es_format_t *p_fmt )
506 sout_input_t *p_input;
508 if( !p_mux->b_add_stream_any_time && !p_mux->b_waiting_stream )
510 msg_Err( p_mux, "cannot add a new stream (unsupported while muxing "
511 "to this format). You can try increasing sout-mux-caching value" );
515 msg_Dbg( p_mux, "adding a new input" );
517 /* create a new sout input */
518 p_input = malloc( sizeof( sout_input_t ) );
521 p_input->p_sout = p_mux->p_sout;
522 p_input->p_fmt = p_fmt;
523 p_input->p_fifo = block_FifoNew();
524 p_input->p_sys = NULL;
526 TAB_APPEND( p_mux->i_nb_inputs, p_mux->pp_inputs, p_input );
527 if( p_mux->pf_addstream( p_mux, p_input ) < 0 )
529 msg_Err( p_mux, "cannot add this stream" );
530 TAB_REMOVE( p_mux->i_nb_inputs, p_mux->pp_inputs, p_input );
531 block_FifoRelease( p_input->p_fifo );
539 /*****************************************************************************
540 * sout_MuxDeleteStream:
541 *****************************************************************************/
542 void sout_MuxDeleteStream( sout_mux_t *p_mux, sout_input_t *p_input )
546 if( p_mux->b_waiting_stream
547 && block_FifoCount( p_input->p_fifo ) > 0 )
549 /* We stop waiting, and call the muxer for taking care of the data
550 * before we remove this es */
551 p_mux->b_waiting_stream = false;
552 p_mux->pf_mux( p_mux );
555 TAB_FIND( p_mux->i_nb_inputs, p_mux->pp_inputs, p_input, i_index );
558 if( p_mux->pf_delstream( p_mux, p_input ) < 0 )
560 msg_Err( p_mux, "cannot delete this stream from mux" );
563 /* remove the entry */
564 TAB_REMOVE( p_mux->i_nb_inputs, p_mux->pp_inputs, p_input );
566 if( p_mux->i_nb_inputs == 0 )
568 msg_Warn( p_mux, "no more input streams for this mux" );
571 block_FifoRelease( p_input->p_fifo );
576 /*****************************************************************************
577 * sout_MuxSendBuffer:
578 *****************************************************************************/
579 void sout_MuxSendBuffer( sout_mux_t *p_mux, sout_input_t *p_input,
582 block_FifoPut( p_input->p_fifo, p_buffer );
584 if( p_mux->p_sout->i_out_pace_nocontrol )
586 mtime_t current_date = mdate();
587 if ( current_date > p_buffer->i_dts )
588 msg_Warn( p_mux, "late buffer for mux input (%"PRId64")",
589 current_date - p_buffer->i_dts );
592 if( p_mux->b_waiting_stream )
594 const int64_t i_caching = var_GetInteger( p_mux->p_sout, "sout-mux-caching" ) * INT64_C(1000);
596 if( p_mux->i_add_stream_start < 0 )
597 p_mux->i_add_stream_start = p_buffer->i_dts;
599 /* Wait until we have enought data before muxing */
600 if( p_mux->i_add_stream_start < 0 ||
601 p_buffer->i_dts < p_mux->i_add_stream_start + i_caching )
603 p_mux->b_waiting_stream = false;
605 p_mux->pf_mux( p_mux );
608 /*****************************************************************************
610 *****************************************************************************/
611 static int mrl_Parse( mrl_t *p_mrl, const char *psz_mrl )
613 char * psz_dup = strdup( psz_mrl );
614 char * psz_parser = psz_dup;
615 const char * psz_access;
616 const char * psz_way;
619 /* *** first parse psz_dest */
620 while( *psz_parser && *psz_parser != ':' )
622 if( *psz_parser == '{' )
624 while( *psz_parser && *psz_parser != '}' )
638 #if defined( WIN32 ) || defined( UNDER_CE )
639 if( psz_parser - psz_dup == 1 )
641 /* msg_Warn( p_sout, "drive letter %c: found in source string",
649 psz_access = psz_way = "";
654 *psz_parser++ = '\0';
656 /* let's skip '//' */
657 if( psz_parser[0] == '/' && psz_parser[1] == '/' )
662 psz_name = psz_parser ;
664 /* Come back to parse the access and mux plug-ins */
665 psz_parser = psz_dup;
672 else if( *psz_parser == '/' )
680 psz_access = psz_parser;
682 while( *psz_parser && *psz_parser != '/' )
684 if( *psz_parser == '{' )
686 while( *psz_parser && *psz_parser != '}' )
701 if( *psz_parser == '/' )
703 *psz_parser++ = '\0';
714 psz_way = psz_parser;
718 p_mrl->psz_access = strdup( psz_access );
719 p_mrl->psz_way = strdup( psz_way );
720 p_mrl->psz_name = strdup( psz_name );
723 return( VLC_SUCCESS );
727 /* mrl_Clean: clean p_mrl after a call to mrl_Parse */
728 static void mrl_Clean( mrl_t *p_mrl )
730 FREENULL( p_mrl->psz_access );
731 FREENULL( p_mrl->psz_way );
732 FREENULL( p_mrl->psz_name );
736 /****************************************************************************
737 ****************************************************************************
741 ****************************************************************************
742 ****************************************************************************/
744 /* create a complete chain */
746 module{option=*:option=*}[:module{option=*:...}]
750 * parse module{options=str, option="str "}:
751 * return a pointer on the rest
752 * XXX: psz_chain is modified
756 * XXX name and p_cfg are used (-> do NOT free them)
758 sout_stream_t *sout_StreamNew( sout_instance_t *p_sout, char *psz_chain )
760 sout_stream_t *p_stream;
764 msg_Err( p_sout, "invalid chain" );
768 p_stream = vlc_object_create( p_sout, sizeof( sout_stream_t ) );
773 p_stream->p_sout = p_sout;
774 p_stream->p_sys = NULL;
777 config_ChainCreate( &p_stream->psz_name, &p_stream->p_cfg, psz_chain);
779 msg_Dbg( p_sout, "stream=`%s'", p_stream->psz_name );
781 vlc_object_attach( p_stream, p_sout );
784 module_Need( p_stream, "sout stream", p_stream->psz_name, true );
786 if( !p_stream->p_module )
788 sout_StreamDelete( p_stream );
795 void sout_StreamDelete( sout_stream_t *p_stream )
797 msg_Dbg( p_stream, "destroying chain... (name=%s)", p_stream->psz_name );
799 vlc_object_detach( p_stream );
800 if( p_stream->p_module ) module_Unneed( p_stream, p_stream->p_module );
802 FREENULL( p_stream->psz_name );
803 FREENULL( p_stream->psz_next );
805 config_ChainDestroy( p_stream->p_cfg );
807 msg_Dbg( p_stream, "destroying chain done" );
808 vlc_object_release( p_stream );
811 static char *_sout_stream_url_to_chain( vlc_object_t *p_this,
812 const char *psz_url )
816 const char *fmt = "standard{mux=\"%s\",access=\"%s\",dst=\"%s\"}";
817 static const char rtpfmt[] = "rtp{mux=\"%s\",proto=\"%s\",dst=\"%s\"}";
819 mrl_Parse( &mrl, psz_url );
821 /* Check if the URLs goes #rtp - otherwise we'll use #standard */
822 if (strcmp (mrl.psz_access, "rtp") == 0)
824 /* For historical reasons, rtp:// means RTP over UDP */
825 strcpy (mrl.psz_access, "udp");
830 static const char list[] = "dccp\0sctp\0tcp\0udplite\0";
831 for (const char *a = list; *a; a += strlen (a) + 1)
832 if (strcmp (a, mrl.psz_access) == 0)
839 /* Convert the URL to a basic sout chain */
840 if (asprintf (&psz_chain, fmt,
841 mrl.psz_way, mrl.psz_access, mrl.psz_name) == -1)
844 /* Duplicate and wrap if sout-display is on */
845 if (psz_chain && (config_GetInt( p_this, "sout-display" ) > 0))
848 if (asprintf (&tmp, "duplicate{dst=display,dst=%s}", tmp) == -1)