git.sesse.net Git - vlc/blob - modules/stream_out/rtp.c

   1 /*****************************************************************************
   2  * rtp.c: rtp stream output module
   3  *****************************************************************************
   4  * Copyright (C) 2003-2004 the VideoLAN team
   5  * Copyright © 2007-2008 Rémi Denis-Courmont
   6  *
   7  * Authors: Laurent Aimar <fenrir@via.ecp.fr>
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  22  *****************************************************************************/
  23
  24 /*****************************************************************************
  25  * Preamble
  26  *****************************************************************************/
  27
  28 #ifdef HAVE_CONFIG_H
  29 # include "config.h"
  30 #endif
  31
  32 #include <vlc_common.h>
  33 #include <vlc_plugin.h>
  34 #include <vlc_sout.h>
  35 #include <vlc_block.h>
  36
  37 #include <vlc_httpd.h>
  38 #include <vlc_url.h>
  39 #include <vlc_network.h>
  40 #include <vlc_charset.h>
  41 #include <vlc_strings.h>
  42 #include <vlc_rand.h>
  43 #ifdef HAVE_SRTP
  44 # include <srtp.h>
  45 #endif
  46
  47 #include "rtp.h"
  48
  49 #ifdef HAVE_UNISTD_H
  50 #   include <sys/types.h>
  51 #   include <unistd.h>
  52 #   include <fcntl.h>
  53 #   include <sys/stat.h>
  54 #endif
  55 #ifdef HAVE_LINUX_DCCP_H
  56 #   include <linux/dccp.h>
  57 #endif
  58 #ifndef IPPROTO_DCCP
  59 # define IPPROTO_DCCP 33
  60 #endif
  61 #ifndef IPPROTO_UDPLITE
  62 # define IPPROTO_UDPLITE 136
  63 #endif
  64
  65 #include <errno.h>
  66
  67 #include <assert.h>
  68
  69 /*****************************************************************************
  70  * Module descriptor
  71  *****************************************************************************/
  72
  73 #define DEST_TEXT N_("Destination")
  74 #define DEST_LONGTEXT N_( \
  75     "This is the output URL that will be used." )
  76 #define SDP_TEXT N_("SDP")
  77 #define SDP_LONGTEXT N_( \
  78     "This allows you to specify how the SDP (Session Descriptor) for this RTP "\
  79     "session will be made available. You must use an url: http://location to " \
  80     "access the SDP via HTTP, rtsp://location for RTSP access, and sap:// " \
  81     "for the SDP to be announced via SAP." )
  82 #define SAP_TEXT N_("SAP announcing")
  83 #define SAP_LONGTEXT N_("Announce this session with SAP.")
  84 #define MUX_TEXT N_("Muxer")
  85 #define MUX_LONGTEXT N_( \
  86     "This allows you to specify the muxer used for the streaming output. " \
  87     "Default is to use no muxer (standard RTP stream)." )
  88
  89 #define NAME_TEXT N_("Session name")
  90 #define NAME_LONGTEXT N_( \
  91     "This is the name of the session that will be announced in the SDP " \
  92     "(Session Descriptor)." )
  93 #define DESC_TEXT N_("Session description")
  94 #define DESC_LONGTEXT N_( \
  95     "This allows you to give a short description with details about the stream, " \
  96     "that will be announced in the SDP (Session Descriptor)." )
  97 #define URL_TEXT N_("Session URL")
  98 #define URL_LONGTEXT N_( \
  99     "This allows you to give an URL with more details about the stream " \
 100     "(often the website of the streaming organization), that will " \
 101     "be announced in the SDP (Session Descriptor)." )
 102 #define EMAIL_TEXT N_("Session email")
 103 #define EMAIL_LONGTEXT N_( \
 104     "This allows you to give a contact mail address for the stream, that will " \
 105     "be announced in the SDP (Session Descriptor)." )
 106 #define PHONE_TEXT N_("Session phone number")
 107 #define PHONE_LONGTEXT N_( \
 108     "This allows you to give a contact telephone number for the stream, that will " \
 109     "be announced in the SDP (Session Descriptor)." )
 110
 111 #define PORT_TEXT N_("Port")
 112 #define PORT_LONGTEXT N_( \
 113     "This allows you to specify the base port for the RTP streaming." )
 114 #define PORT_AUDIO_TEXT N_("Audio port")
 115 #define PORT_AUDIO_LONGTEXT N_( \
 116     "This allows you to specify the default audio port for the RTP streaming." )
 117 #define PORT_VIDEO_TEXT N_("Video port")
 118 #define PORT_VIDEO_LONGTEXT N_( \
 119     "This allows you to specify the default video port for the RTP streaming." )
 120
 121 #define TTL_TEXT N_("Hop limit (TTL)")
 122 #define TTL_LONGTEXT N_( \
 123     "This is the hop limit (also known as \"Time-To-Live\" or TTL) of " \
 124     "the multicast packets sent by the stream output (-1 = use operating " \
 125     "system built-in default).")
 126
 127 #define RTCP_MUX_TEXT N_("RTP/RTCP multiplexing")
 128 #define RTCP_MUX_LONGTEXT N_( \
 129     "This sends and receives RTCP packet multiplexed over the same port " \
 130     "as RTP packets." )
 131
 132 #define PROTO_TEXT N_("Transport protocol")
 133 #define PROTO_LONGTEXT N_( \
 134     "This selects which transport protocol to use for RTP." )
 135
 136 #define SRTP_KEY_TEXT N_("SRTP key (hexadecimal)")
 137 #define SRTP_KEY_LONGTEXT N_( \
 138     "RTP packets will be integrity-protected and ciphered "\
 139     "with this Secure RTP master shared secret key.")
 140
 141 #define SRTP_SALT_TEXT N_("SRTP salt (hexadecimal)")
 142 #define SRTP_SALT_LONGTEXT N_( \
 143     "Secure RTP requires a (non-secret) master salt value.")
 144
 145 static const char *const ppsz_protos[] = {
 146     "dccp", "sctp", "tcp", "udp", "udplite",
 147 };
 148
 149 static const char *const ppsz_protocols[] = {
 150     "DCCP", "SCTP", "TCP", "UDP", "UDP-Lite",
 151 };
 152
 153 #define RFC3016_TEXT N_("MP4A LATM")
 154 #define RFC3016_LONGTEXT N_( \
 155     "This allows you to stream MPEG4 LATM audio streams (see RFC3016)." )
 156
 157 static int  Open ( vlc_object_t * );
 158 static void Close( vlc_object_t * );
 159
 160 #define SOUT_CFG_PREFIX "sout-rtp-"
 161 #define MAX_EMPTY_BLOCKS 200
 162
 163 vlc_module_begin ()
 164     set_shortname( N_("RTP"))
 165     set_description( N_("RTP stream output") )
 166     set_capability( "sout stream", 0 )
 167     add_shortcut( "rtp" )
 168     set_category( CAT_SOUT )
 169     set_subcategory( SUBCAT_SOUT_STREAM )
 170
 171     add_string( SOUT_CFG_PREFIX "dst", "", NULL, DEST_TEXT,
 172                 DEST_LONGTEXT, true )
 173     add_string( SOUT_CFG_PREFIX "sdp", "", NULL, SDP_TEXT,
 174                 SDP_LONGTEXT, true )
 175     add_string( SOUT_CFG_PREFIX "mux", "", NULL, MUX_TEXT,
 176                 MUX_LONGTEXT, true )
 177     add_bool( SOUT_CFG_PREFIX "sap", false, NULL, SAP_TEXT, SAP_LONGTEXT,
 178               true )
 179
 180     add_string( SOUT_CFG_PREFIX "name", "", NULL, NAME_TEXT,
 181                 NAME_LONGTEXT, true )
 182     add_string( SOUT_CFG_PREFIX "description", "", NULL, DESC_TEXT,
 183                 DESC_LONGTEXT, true )
 184     add_string( SOUT_CFG_PREFIX "url", "", NULL, URL_TEXT,
 185                 URL_LONGTEXT, true )
 186     add_string( SOUT_CFG_PREFIX "email", "", NULL, EMAIL_TEXT,
 187                 EMAIL_LONGTEXT, true )
 188     add_string( SOUT_CFG_PREFIX "phone", "", NULL, PHONE_TEXT,
 189                 PHONE_LONGTEXT, true )
 190
 191     add_string( SOUT_CFG_PREFIX "proto", "udp", NULL, PROTO_TEXT,
 192                 PROTO_LONGTEXT, false )
 193         change_string_list( ppsz_protos, ppsz_protocols, NULL )
 194     add_integer( SOUT_CFG_PREFIX "port", 5004, NULL, PORT_TEXT,
 195                  PORT_LONGTEXT, true )
 196     add_integer( SOUT_CFG_PREFIX "port-audio", 0, NULL, PORT_AUDIO_TEXT,
 197                  PORT_AUDIO_LONGTEXT, true )
 198     add_integer( SOUT_CFG_PREFIX "port-video", 0, NULL, PORT_VIDEO_TEXT,
 199                  PORT_VIDEO_LONGTEXT, true )
 200
 201     add_integer( SOUT_CFG_PREFIX "ttl", -1, NULL, TTL_TEXT,
 202                  TTL_LONGTEXT, true )
 203     add_bool( SOUT_CFG_PREFIX "rtcp-mux", false, NULL,
 204               RTCP_MUX_TEXT, RTCP_MUX_LONGTEXT, false )
 205
 206 #ifdef HAVE_SRTP
 207     add_string( SOUT_CFG_PREFIX "key", "", NULL,
 208                 SRTP_KEY_TEXT, SRTP_KEY_LONGTEXT, false )
 209     add_string( SOUT_CFG_PREFIX "salt", "", NULL,
 210                 SRTP_SALT_TEXT, SRTP_SALT_LONGTEXT, false )
 211 #endif
 212
 213     add_bool( SOUT_CFG_PREFIX "mp4a-latm", false, NULL, RFC3016_TEXT,
 214                  RFC3016_LONGTEXT, false )
 215
 216     set_callbacks( Open, Close )
 217 vlc_module_end ()
 218
 219 /*****************************************************************************
 220  * Exported prototypes
 221  *****************************************************************************/
 222 static const char *const ppsz_sout_options[] = {
 223     "dst", "name", "port", "port-audio", "port-video", "*sdp", "ttl", "mux",
 224     "sap", "description", "url", "email", "phone",
 225     "proto", "rtcp-mux", "key", "salt",
 226     "mp4a-latm", NULL
 227 };
 228
 229 static sout_stream_id_t *Add ( sout_stream_t *, es_format_t * );
 230 static int               Del ( sout_stream_t *, sout_stream_id_t * );
 231 static int               Send( sout_stream_t *, sout_stream_id_t *,
 232                                block_t* );
 233 static sout_stream_id_t *MuxAdd ( sout_stream_t *, es_format_t * );
 234 static int               MuxDel ( sout_stream_t *, sout_stream_id_t * );
 235 static int               MuxSend( sout_stream_t *, sout_stream_id_t *,
 236                                   block_t* );
 237
 238 static sout_access_out_t *GrabberCreate( sout_stream_t *p_sout );
 239 static void* ThreadSend( vlc_object_t *p_this );
 240 static void *rtp_listen_thread( void * );
 241
 242 static void SDPHandleUrl( sout_stream_t *, const char * );
 243
 244 static int SapSetup( sout_stream_t *p_stream );
 245 static int FileSetup( sout_stream_t *p_stream );
 246 static int HttpSetup( sout_stream_t *p_stream, const vlc_url_t * );
 247
 248 struct sout_stream_sys_t
 249 {
 250     /* SDP */
 251     char    *psz_sdp;
 252     vlc_mutex_t  lock_sdp;
 253
 254     /* SDP to disk */
 255     char *psz_sdp_file;
 256
 257     /* SDP via SAP */
 258     bool b_export_sap;
 259     session_descriptor_t *p_session;
 260
 261     /* SDP via HTTP */
 262     httpd_host_t *p_httpd_host;
 263     httpd_file_t *p_httpd_file;
 264
 265     /* RTSP */
 266     rtsp_stream_t *rtsp;
 267
 268     /* */
 269     char     *psz_destination;
 270     uint32_t  payload_bitmap;
 271     uint16_t  i_port;
 272     uint16_t  i_port_audio;
 273     uint16_t  i_port_video;
 274     uint8_t   proto;
 275     bool      rtcp_mux;
 276     int       i_ttl:9;
 277     bool      b_latm;
 278
 279     /* in case we do TS/PS over rtp */
 280     sout_mux_t        *p_mux;
 281     sout_access_out_t *p_grab;
 282     block_t           *packet;
 283
 284     /* */
 285     vlc_mutex_t      lock_es;
 286     int              i_es;
 287     sout_stream_id_t **es;
 288 };
 289
 290 typedef int (*pf_rtp_packetizer_t)( sout_stream_id_t *, block_t * );
 291
 292 typedef struct rtp_sink_t
 293 {
 294     int rtp_fd;
 295     rtcp_sender_t *rtcp;
 296 } rtp_sink_t;
 297
 298 struct sout_stream_id_t
 299 {
 300     VLC_COMMON_MEMBERS
 301
 302     sout_stream_t *p_stream;
 303     /* rtp field */
 304     uint32_t    i_timestamp;
 305     uint16_t    i_sequence;
 306     uint8_t     i_payload_type;
 307     uint8_t     ssrc[4];
 308
 309     /* for sdp */
 310     const char  *psz_enc;
 311     char        *psz_fmtp;
 312     int          i_clock_rate;
 313     int          i_port;
 314     int          i_cat;
 315     int          i_channels;
 316     int          i_bitrate;
 317
 318     /* Packetizer specific fields */
 319     int                 i_mtu;
 320 #ifdef HAVE_SRTP
 321     srtp_session_t     *srtp;
 322 #endif
 323     pf_rtp_packetizer_t pf_packetize;
 324
 325     /* Packets sinks */
 326     vlc_mutex_t       lock_sink;
 327     int               sinkc;
 328     rtp_sink_t       *sinkv;
 329     rtsp_stream_id_t *rtsp_id;
 330     struct {
 331         int          *fd;
 332         vlc_thread_t  thread;
 333     } listen;
 334
 335     block_fifo_t     *p_fifo;
 336     int64_t           i_caching;
 337 };
 338
 339 /*****************************************************************************
 340  * Open:
 341  *****************************************************************************/
 342 static int Open( vlc_object_t *p_this )
 343 {
 344     sout_stream_t       *p_stream = (sout_stream_t*)p_this;
 345     sout_instance_t     *p_sout = p_stream->p_sout;
 346     sout_stream_sys_t   *p_sys = NULL;
 347     config_chain_t      *p_cfg = NULL;
 348     char                *psz;
 349     bool          b_rtsp = false;
 350
 351     config_ChainParse( p_stream, SOUT_CFG_PREFIX,
 352                        ppsz_sout_options, p_stream->p_cfg );
 353
 354     p_sys = malloc( sizeof( sout_stream_sys_t ) );
 355     if( p_sys == NULL )
 356         return VLC_ENOMEM;
 357
 358     p_sys->psz_destination = var_GetNonEmptyString( p_stream, SOUT_CFG_PREFIX "dst" );
 359
 360     p_sys->i_port       = var_GetInteger( p_stream, SOUT_CFG_PREFIX "port" );
 361     p_sys->i_port_audio = var_GetInteger( p_stream, SOUT_CFG_PREFIX "port-audio" );
 362     p_sys->i_port_video = var_GetInteger( p_stream, SOUT_CFG_PREFIX "port-video" );
 363     p_sys->rtcp_mux     = var_GetBool( p_stream, SOUT_CFG_PREFIX "rtcp-mux" );
 364
 365     if( p_sys->i_port_audio && p_sys->i_port_video == p_sys->i_port_audio )
 366     {
 367         msg_Err( p_stream, "audio and video RTP port must be distinct" );
 368         free( p_sys->psz_destination );
 369         free( p_sys );
 370         return VLC_EGENERIC;
 371     }
 372
 373     for( p_cfg = p_stream->p_cfg; p_cfg != NULL; p_cfg = p_cfg->p_next )
 374     {
 375         if( !strcmp( p_cfg->psz_name, "sdp" )
 376          && ( p_cfg->psz_value != NULL )
 377          && !strncasecmp( p_cfg->psz_value, "rtsp:", 5 ) )
 378         {
 379             b_rtsp = true;
 380             break;
 381         }
 382     }
 383     if( !b_rtsp )
 384     {
 385         psz = var_GetNonEmptyString( p_stream, SOUT_CFG_PREFIX "sdp" );
 386         if( psz != NULL )
 387         {
 388             if( !strncasecmp( psz, "rtsp:", 5 ) )
 389                 b_rtsp = true;
 390             free( psz );
 391         }
 392     }
 393
 394     /* Transport protocol */
 395     p_sys->proto = IPPROTO_UDP;
 396     psz = var_GetNonEmptyString (p_stream, SOUT_CFG_PREFIX"proto");
 397
 398     if ((psz == NULL) || !strcasecmp (psz, "udp"))
 399         (void)0; /* default */
 400     else
 401     if (!strcasecmp (psz, "dccp"))
 402     {
 403         p_sys->proto = IPPROTO_DCCP;
 404         p_sys->rtcp_mux = true; /* Force RTP/RTCP mux */
 405     }
 406 #if 0
 407     else
 408     if (!strcasecmp (psz, "sctp"))
 409     {
 410         p_sys->proto = IPPROTO_TCP;
 411         p_sys->rtcp_mux = true; /* Force RTP/RTCP mux */
 412     }
 413 #endif
 414 #if 0
 415     else
 416     if (!strcasecmp (psz, "tcp"))
 417     {
 418         p_sys->proto = IPPROTO_TCP;
 419         p_sys->rtcp_mux = true; /* Force RTP/RTCP mux */
 420     }
 421 #endif
 422     else
 423     if (!strcasecmp (psz, "udplite") || !strcasecmp (psz, "udp-lite"))
 424         p_sys->proto = IPPROTO_UDPLITE;
 425     else
 426         msg_Warn (p_this, "unknown or unsupported transport protocol \"%s\"",
 427                   psz);
 428     free (psz);
 429     var_Create (p_this, "dccp-service", VLC_VAR_STRING);
 430
 431     if( ( p_sys->psz_destination == NULL ) && !b_rtsp )
 432     {
 433         msg_Err( p_stream, "missing destination and not in RTSP mode" );
 434         free( p_sys );
 435         return VLC_EGENERIC;
 436     }
 437
 438     p_sys->i_ttl = var_GetInteger( p_stream, SOUT_CFG_PREFIX "ttl" );
 439     if( p_sys->i_ttl == -1 )
 440     {
 441         /* Normally, we should let the default hop limit up to the core,
 442          * but we have to know it to build our SDP properly, which is why
 443          * we ask the core. FIXME: broken when neither sout-rtp-ttl nor
 444          * ttl are set. */
 445         p_sys->i_ttl = config_GetInt( p_stream, "ttl" );
 446     }
 447
 448     p_sys->b_latm = var_GetBool( p_stream, SOUT_CFG_PREFIX "mp4a-latm" );
 449
 450     p_sys->payload_bitmap = 0;
 451     p_sys->i_es = 0;
 452     p_sys->es   = NULL;
 453     p_sys->rtsp = NULL;
 454     p_sys->psz_sdp = NULL;
 455
 456     p_sys->b_export_sap = false;
 457     p_sys->p_session = NULL;
 458     p_sys->psz_sdp_file = NULL;
 459
 460     p_sys->p_httpd_host = NULL;
 461     p_sys->p_httpd_file = NULL;
 462
 463     p_stream->p_sys     = p_sys;
 464
 465     vlc_mutex_init( &p_sys->lock_sdp );
 466     vlc_mutex_init( &p_sys->lock_es );
 467
 468     psz = var_GetNonEmptyString( p_stream, SOUT_CFG_PREFIX "mux" );
 469     if( psz != NULL )
 470     {
 471         sout_stream_id_t *id;
 472
 473         /* Check muxer type */
 474         if( strncasecmp( psz, "ps", 2 )
 475          && strncasecmp( psz, "mpeg1", 5 )
 476          && strncasecmp( psz, "ts", 2 ) )
 477         {
 478             msg_Err( p_stream, "unsupported muxer type for RTP (only TS/PS)" );
 479             free( psz );
 480             vlc_mutex_destroy( &p_sys->lock_sdp );
 481             vlc_mutex_destroy( &p_sys->lock_es );
 482             free( p_sys->psz_destination );
 483             free( p_sys );
 484             return VLC_EGENERIC;
 485         }
 486
 487         p_sys->p_grab = GrabberCreate( p_stream );
 488         p_sys->p_mux = sout_MuxNew( p_sout, psz, p_sys->p_grab );
 489         free( psz );
 490
 491         if( p_sys->p_mux == NULL )
 492         {
 493             msg_Err( p_stream, "cannot create muxer" );
 494             sout_AccessOutDelete( p_sys->p_grab );
 495             vlc_mutex_destroy( &p_sys->lock_sdp );
 496             vlc_mutex_destroy( &p_sys->lock_es );
 497             free( p_sys->psz_destination );
 498             free( p_sys );
 499             return VLC_EGENERIC;
 500         }
 501
 502         id = Add( p_stream, NULL );
 503         if( id == NULL )
 504         {
 505             sout_MuxDelete( p_sys->p_mux );
 506             sout_AccessOutDelete( p_sys->p_grab );
 507             vlc_mutex_destroy( &p_sys->lock_sdp );
 508             vlc_mutex_destroy( &p_sys->lock_es );
 509             free( p_sys->psz_destination );
 510             free( p_sys );
 511             return VLC_EGENERIC;
 512         }
 513
 514         p_sys->packet = NULL;
 515
 516         p_stream->pf_add  = MuxAdd;
 517         p_stream->pf_del  = MuxDel;
 518         p_stream->pf_send = MuxSend;
 519     }
 520     else
 521     {
 522         p_sys->p_mux    = NULL;
 523         p_sys->p_grab   = NULL;
 524
 525         p_stream->pf_add    = Add;
 526         p_stream->pf_del    = Del;
 527         p_stream->pf_send   = Send;
 528     }
 529
 530     if( var_GetBool( p_stream, SOUT_CFG_PREFIX"sap" ) )
 531         SDPHandleUrl( p_stream, "sap" );
 532
 533     psz = var_GetNonEmptyString( p_stream, SOUT_CFG_PREFIX "sdp" );
 534     if( psz != NULL )
 535     {
 536         config_chain_t *p_cfg;
 537
 538         SDPHandleUrl( p_stream, psz );
 539
 540         for( p_cfg = p_stream->p_cfg; p_cfg != NULL; p_cfg = p_cfg->p_next )
 541         {
 542             if( !strcmp( p_cfg->psz_name, "sdp" ) )
 543             {
 544                 if( p_cfg->psz_value == NULL || *p_cfg->psz_value == '\0' )
 545                     continue;
 546
 547                 /* needed both :sout-rtp-sdp= and rtp{sdp=} can be used */
 548                 if( !strcmp( p_cfg->psz_value, psz ) )
 549                     continue;
 550
 551                 SDPHandleUrl( p_stream, p_cfg->psz_value );
 552             }
 553         }
 554         free( psz );
 555     }
 556
 557     /* update p_sout->i_out_pace_nocontrol */
 558     p_stream->p_sout->i_out_pace_nocontrol++;
 559
 560     return VLC_SUCCESS;
 561 }
 562
 563 /*****************************************************************************
 564  * Close:
 565  *****************************************************************************/
 566 static void Close( vlc_object_t * p_this )
 567 {
 568     sout_stream_t     *p_stream = (sout_stream_t*)p_this;
 569     sout_stream_sys_t *p_sys = p_stream->p_sys;
 570
 571     /* update p_sout->i_out_pace_nocontrol */
 572     p_stream->p_sout->i_out_pace_nocontrol--;
 573
 574     if( p_sys->p_mux )
 575     {
 576         assert( p_sys->i_es == 1 );
 577
 578         sout_MuxDelete( p_sys->p_mux );
 579         Del( p_stream, p_sys->es[0] );
 580         sout_AccessOutDelete( p_sys->p_grab );
 581
 582         if( p_sys->packet )
 583         {
 584             block_Release( p_sys->packet );
 585         }
 586         if( p_sys->b_export_sap )
 587         {
 588             p_sys->p_mux = NULL;
 589             SapSetup( p_stream );
 590         }
 591     }
 592
 593     if( p_sys->rtsp != NULL )
 594         RtspUnsetup( p_sys->rtsp );
 595
 596     vlc_mutex_destroy( &p_sys->lock_sdp );
 597     vlc_mutex_destroy( &p_sys->lock_es );
 598
 599     if( p_sys->p_httpd_file )
 600         httpd_FileDelete( p_sys->p_httpd_file );
 601
 602     if( p_sys->p_httpd_host )
 603         httpd_HostDelete( p_sys->p_httpd_host );
 604
 605     free( p_sys->psz_sdp );
 606
 607     if( p_sys->psz_sdp_file != NULL )
 608     {
 609 #ifdef HAVE_UNISTD_H
 610         unlink( p_sys->psz_sdp_file );
 611 #endif
 612         free( p_sys->psz_sdp_file );
 613     }
 614     free( p_sys->psz_destination );
 615     free( p_sys );
 616 }
 617
 618 /*****************************************************************************
 619  * SDPHandleUrl:
 620  *****************************************************************************/
 621 static void SDPHandleUrl( sout_stream_t *p_stream, const char *psz_url )
 622 {
 623     sout_stream_sys_t *p_sys = p_stream->p_sys;
 624     vlc_url_t url;
 625
 626     vlc_UrlParse( &url, psz_url, 0 );
 627     if( url.psz_protocol && !strcasecmp( url.psz_protocol, "http" ) )
 628     {
 629         if( p_sys->p_httpd_file )
 630         {
 631             msg_Err( p_stream, "you can use sdp=http:// only once" );
 632             goto out;
 633         }
 634
 635         if( HttpSetup( p_stream, &url ) )
 636         {
 637             msg_Err( p_stream, "cannot export SDP as HTTP" );
 638         }
 639     }
 640     else if( url.psz_protocol && !strcasecmp( url.psz_protocol, "rtsp" ) )
 641     {
 642         if( p_sys->rtsp != NULL )
 643         {
 644             msg_Err( p_stream, "you can use sdp=rtsp:// only once" );
 645             goto out;
 646         }
 647
 648         /* FIXME test if destination is multicast or no destination at all */
 649         p_sys->rtsp = RtspSetup( p_stream, &url );
 650         if( p_sys->rtsp == NULL )
 651             msg_Err( p_stream, "cannot export SDP as RTSP" );
 652         else
 653         if( p_sys->p_mux != NULL )
 654         {
 655             sout_stream_id_t *id = p_sys->es[0];
 656             id->rtsp_id = RtspAddId( p_sys->rtsp, id, 0, GetDWBE( id->ssrc ),
 657                                      p_sys->psz_destination, p_sys->i_ttl,
 658                                      id->i_port, id->i_port + 1 );
 659         }
 660     }
 661     else if( ( url.psz_protocol && !strcasecmp( url.psz_protocol, "sap" ) ) ||
 662              ( url.psz_host && !strcasecmp( url.psz_host, "sap" ) ) )
 663     {
 664         p_sys->b_export_sap = true;
 665         SapSetup( p_stream );
 666     }
 667     else if( url.psz_protocol && !strcasecmp( url.psz_protocol, "file" ) )
 668     {
 669         if( p_sys->psz_sdp_file != NULL )
 670         {
 671             msg_Err( p_stream, "you can use sdp=file:// only once" );
 672             goto out;
 673         }
 674         psz_url = &psz_url[5];
 675         if( psz_url[0] == '/' && psz_url[1] == '/' )
 676             psz_url += 2;
 677         p_sys->psz_sdp_file = strdup( psz_url );
 678         if( p_sys->psz_sdp_file == NULL )
 679             goto out;
 680         decode_URI( p_sys->psz_sdp_file ); /* FIXME? */
 681         FileSetup( p_stream );
 682     }
 683     else
 684     {
 685         msg_Warn( p_stream, "unknown protocol for SDP (%s)",
 686                   url.psz_protocol );
 687     }
 688
 689 out:
 690     vlc_UrlClean( &url );
 691 }
 692
 693 /*****************************************************************************
 694  * SDPGenerate
 695  *****************************************************************************/
 696 /*static*/
 697 char *SDPGenerate( const sout_stream_t *p_stream, const char *rtsp_url )
 698 {
 699     const sout_stream_sys_t *p_sys = p_stream->p_sys;
 700     char *psz_sdp;
 701     struct sockaddr_storage dst;
 702     socklen_t dstlen;
 703     int i;
 704     /*
 705      * When we have a fixed destination (typically when we do multicast),
 706      * we need to put the actual port numbers in the SDP.
 707      * When there is no fixed destination, we only support RTSP unicast
 708      * on-demand setup, so we should rather let the clients decide which ports
 709      * to use.
 710      * When there is both a fixed destination and RTSP unicast, we need to
 711      * put port numbers used by the fixed destination, otherwise the SDP would
 712      * become totally incorrect for multicast use. It should be noted that
 713      * port numbers from SDP with RTSP are only "recommendation" from the
 714      * server to the clients (per RFC2326), so only broken clients will fail
 715      * to handle this properly. There is no solution but to use two differents
 716      * output chain with two different RTSP URLs if you need to handle this
 717      * scenario.
 718      */
 719     int inclport;
 720
 721     if( p_sys->psz_destination != NULL )
 722     {
 723         inclport = 1;
 724
 725         /* Oh boy, this is really ugly! (+ race condition on lock_es) */
 726         dstlen = sizeof( dst );
 727         if( p_sys->es[0]->listen.fd != NULL )
 728             getsockname( p_sys->es[0]->listen.fd[0],
 729                          (struct sockaddr *)&dst, &dstlen );
 730         else
 731             getpeername( p_sys->es[0]->sinkv[0].rtp_fd,
 732                          (struct sockaddr *)&dst, &dstlen );
 733     }
 734     else
 735     {
 736         inclport = 0;
 737
 738         /* Dummy destination address for RTSP */
 739         memset (&dst, 0, sizeof( struct sockaddr_in ) );
 740         dst.ss_family = AF_INET;
 741 #ifdef HAVE_SA_LEN
 742         dst.ss_len =
 743 #endif
 744         dstlen = sizeof( struct sockaddr_in );
 745     }
 746
 747     psz_sdp = vlc_sdp_Start( VLC_OBJECT( p_stream ), SOUT_CFG_PREFIX,
 748                              NULL, 0, (struct sockaddr *)&dst, dstlen );
 749     if( psz_sdp == NULL )
 750         return NULL;
 751
 752     /* TODO: a=source-filter */
 753     if( p_sys->rtcp_mux )
 754         sdp_AddAttribute( &psz_sdp, "rtcp-mux", NULL );
 755
 756     if( rtsp_url != NULL )
 757         sdp_AddAttribute ( &psz_sdp, "control", "%s", rtsp_url );
 758
 759     /* FIXME: locking?! */
 760     for( i = 0; i < p_sys->i_es; i++ )
 761     {
 762         sout_stream_id_t *id = p_sys->es[i];
 763         const char *mime_major; /* major MIME type */
 764         const char *proto = "RTP/AVP"; /* protocol */
 765
 766         switch( id->i_cat )
 767         {
 768             case VIDEO_ES:
 769                 mime_major = "video";
 770                 break;
 771             case AUDIO_ES:
 772                 mime_major = "audio";
 773                 break;
 774             case SPU_ES:
 775                 mime_major = "text";
 776                 break;
 777             default:
 778                 continue;
 779         }
 780
 781         if( rtsp_url == NULL )
 782         {
 783             switch( p_sys->proto )
 784             {
 785                 case IPPROTO_UDP:
 786                     break;
 787                 case IPPROTO_TCP:
 788                     proto = "TCP/RTP/AVP";
 789                     break;
 790                 case IPPROTO_DCCP:
 791                     proto = "DCCP/RTP/AVP";
 792                     break;
 793                 case IPPROTO_UDPLITE:
 794                     continue;
 795             }
 796         }
 797
 798         sdp_AddMedia( &psz_sdp, mime_major, proto, inclport * id->i_port,
 799                       id->i_payload_type, false, id->i_bitrate,
 800                       id->psz_enc, id->i_clock_rate, id->i_channels,
 801                       id->psz_fmtp);
 802
 803         if( !p_sys->rtcp_mux && (id->i_port & 1) ) /* cf RFC4566 §5.14 */
 804             sdp_AddAttribute ( &psz_sdp, "rtcp", "%u", id->i_port + 1 );
 805
 806         if( rtsp_url != NULL )
 807         {
 808             assert( strlen( rtsp_url ) > 0 );
 809             bool addslash = ( rtsp_url[strlen( rtsp_url ) - 1] != '/' );
 810             sdp_AddAttribute ( &psz_sdp, "control",
 811                                addslash ? "%s/trackID=%u" : "%strackID=%u",
 812                                rtsp_url, i );
 813         }
 814         else
 815         {
 816             if( id->listen.fd != NULL )
 817                 sdp_AddAttribute( &psz_sdp, "setup", "passive" );
 818             if( p_sys->proto == IPPROTO_DCCP )
 819                 sdp_AddAttribute( &psz_sdp, "dccp-service-code",
 820                                   "SC:RTP%c", toupper( mime_major[0] ) );
 821         }
 822     }
 823
 824     return psz_sdp;
 825 }
 826
 827 /*****************************************************************************
 828  * RTP mux
 829  *****************************************************************************/
 830
 831 static void sprintf_hexa( char *s, uint8_t *p_data, int i_data )
 832 {
 833     static const char hex[16] = "0123456789abcdef";
 834     int i;
 835
 836     for( i = 0; i < i_data; i++ )
 837     {
 838         s[2*i+0] = hex[(p_data[i]>>4)&0xf];
 839         s[2*i+1] = hex[(p_data[i]   )&0xf];
 840     }
 841     s[2*i_data] = '\0';
 842 }
 843
 844 /**
 845  * Shrink the MTU down to a fixed packetization time (for audio).
 846  */
 847 static void
 848 rtp_set_ptime (sout_stream_id_t *id, unsigned ptime_ms, size_t bytes)
 849 {
 850     /* Samples per second */
 851     size_t spl = (id->i_clock_rate - 1) * ptime_ms / 1000 + 1;
 852     bytes *= id->i_channels;
 853     spl *= bytes;
 854
 855     if (spl < rtp_mtu (id)) /* MTU is big enough for ptime */
 856         id->i_mtu = 12 + spl;
 857     else /* MTU is too small for ptime, align to a sample boundary */
 858         id->i_mtu = 12 + (((id->i_mtu - 12) / bytes) * bytes);
 859 }
 860
 861 /** Add an ES as a new RTP stream */
 862 static sout_stream_id_t *Add( sout_stream_t *p_stream, es_format_t *p_fmt )
 863 {
 864     /* NOTE: As a special case, if we use a non-RTP
 865      * mux (TS/PS), then p_fmt is NULL. */
 866     sout_stream_sys_t *p_sys = p_stream->p_sys;
 867     sout_stream_id_t  *id;
 868     char              *psz_sdp;
 869
 870     if (0xffffffff == p_sys->payload_bitmap)
 871     {
 872         msg_Err (p_stream, "too many RTP elementary streams");
 873         return NULL;
 874     }
 875
 876     /* Choose the port */
 877     uint16_t i_port = 0;
 878     if( p_fmt == NULL )
 879         ;
 880     else
 881     if( p_fmt->i_cat == AUDIO_ES && p_sys->i_port_audio > 0 )
 882         i_port = p_sys->i_port_audio;
 883     else
 884     if( p_fmt->i_cat == VIDEO_ES && p_sys->i_port_video > 0 )
 885         i_port = p_sys->i_port_video;
 886
 887     /* We do not need the ES lock (p_sys->lock_es) here, because this is the
 888      * only one thread that can *modify* the ES table. The ES lock protects
 889      * the other threads from our modifications (TAB_APPEND, TAB_REMOVE). */
 890     for (int i = 0; i_port && (i < p_sys->i_es); i++)
 891          if (i_port == p_sys->es[i]->i_port)
 892              i_port = 0; /* Port already in use! */
 893     for (uint16_t p = p_sys->i_port; i_port == 0; p += 2)
 894     {
 895         if (p == 0)
 896         {
 897             msg_Err (p_stream, "too many RTP elementary streams");
 898             return NULL;
 899         }
 900         i_port = p;
 901         for (int i = 0; i_port && (i < p_sys->i_es); i++)
 902              if (p == p_sys->es[i]->i_port)
 903                  i_port = 0;
 904     }
 905
 906     id = vlc_object_create( p_stream, sizeof( sout_stream_id_t ) );
 907     if( id == NULL )
 908         return NULL;
 909     vlc_object_attach( id, p_stream );
 910
 911     id->p_stream   = p_stream;
 912
 913     id->i_timestamp = 0; /* It will be filled when the first packet is sent */
 914
 915     /* Look for free dymanic payload type */
 916     id->i_payload_type = 96;
 917     while (p_sys->payload_bitmap & (1 << (id->i_payload_type - 96)))
 918         id->i_payload_type++;
 919     assert (id->i_payload_type < 128);
 920
 921     vlc_rand_bytes (&id->i_sequence, sizeof (id->i_sequence));
 922     vlc_rand_bytes (id->ssrc, sizeof (id->ssrc));
 923
 924     id->psz_enc    = NULL;
 925     id->psz_fmtp   = NULL;
 926     id->i_clock_rate = 90000; /* most common case for video */
 927     id->i_channels = 0;
 928     id->i_port     = i_port;
 929     if( p_fmt != NULL )
 930     {
 931         id->i_cat  = p_fmt->i_cat;
 932         if( p_fmt->i_cat == AUDIO_ES )
 933         {
 934             id->i_clock_rate = p_fmt->audio.i_rate;
 935             id->i_channels = p_fmt->audio.i_channels;
 936         }
 937         id->i_bitrate = p_fmt->i_bitrate/1000; /* Stream bitrate in kbps */
 938     }
 939     else
 940     {
 941         id->i_cat  = VIDEO_ES;
 942         id->i_bitrate = 0;
 943     }
 944
 945     id->i_mtu = config_GetInt( p_stream, "mtu" );
 946     if( id->i_mtu <= 12 + 16 )
 947         id->i_mtu = 576 - 20 - 8; /* pessimistic */
 948     msg_Dbg( p_stream, "maximum RTP packet size: %d bytes", id->i_mtu );
 949
 950     id->pf_packetize = NULL;
 951
 952 #ifdef HAVE_SRTP
 953     id->srtp = NULL;
 954
 955     char *key = var_CreateGetNonEmptyString (p_stream, SOUT_CFG_PREFIX"key");
 956     if (key)
 957     {
 958         id->srtp = srtp_create (SRTP_ENCR_AES_CM, SRTP_AUTH_HMAC_SHA1, 10,
 959                                    SRTP_PRF_AES_CM, SRTP_RCC_MODE1);
 960         if (id->srtp == NULL)
 961         {
 962             free (key);
 963             goto error;
 964         }
 965
 966         char *salt = var_CreateGetNonEmptyString (p_stream, SOUT_CFG_PREFIX"salt");
 967         errno = srtp_setkeystring (id->srtp, key, salt ? salt : "");
 968         free (salt);
 969         free (key);
 970         if (errno)
 971         {
 972             msg_Err (p_stream, "bad SRTP key/salt combination (%m)");
 973             goto error;
 974         }
 975         id->i_sequence = 0; /* FIXME: awful hack for libvlc_srtp */
 976     }
 977 #endif
 978
 979     vlc_mutex_init( &id->lock_sink );
 980     id->sinkc = 0;
 981     id->sinkv = NULL;
 982     id->rtsp_id = NULL;
 983     id->p_fifo = NULL;
 984     id->listen.fd = NULL;
 985
 986     id->i_caching =
 987         (int64_t)1000 * var_GetInteger( p_stream, SOUT_CFG_PREFIX "caching");
 988
 989     if( p_sys->psz_destination != NULL )
 990         switch( p_sys->proto )
 991         {
 992             case IPPROTO_DCCP:
 993             {
 994                 const char *code;
 995                 switch (id->i_cat)
 996                 {
 997                     case VIDEO_ES: code = "RTPV";     break;
 998                     case AUDIO_ES: code = "RTPARTPV"; break;
 999                     case SPU_ES:   code = "RTPTRTPV"; break;
1000                     default:       code = "RTPORTPV"; break;
1001                 }
1002                 var_SetString (p_stream, "dccp-service", code);
1003             }   /* fall through */
1004             case IPPROTO_TCP:
1005                 id->listen.fd = net_Listen( VLC_OBJECT(p_stream),
1006                                             p_sys->psz_destination, i_port,
1007                                             p_sys->proto );
1008                 if( id->listen.fd == NULL )
1009                 {
1010                     msg_Err( p_stream, "passive COMEDIA RTP socket failed" );
1011                     goto error;
1012                 }
1013                 if( vlc_clone( &id->listen.thread, rtp_listen_thread, id,
1014                                VLC_THREAD_PRIORITY_LOW ) )
1015                 {
1016                     net_ListenClose( id->listen.fd );
1017                     id->listen.fd = NULL;
1018                     goto error;
1019                 }
1020                 break;
1021
1022             default:
1023             {
1024                 int ttl = (p_sys->i_ttl >= 0) ? p_sys->i_ttl : -1;
1025                 int fd = net_ConnectDgram( p_stream, p_sys->psz_destination,
1026                                            i_port, ttl, p_sys->proto );
1027                 if( fd == -1 )
1028                 {
1029                     msg_Err( p_stream, "cannot create RTP socket" );
1030                     goto error;
1031                 }
1032                 rtp_add_sink( id, fd, p_sys->rtcp_mux );
1033             }
1034         }
1035
1036     if( p_fmt == NULL )
1037     {
1038         char *psz = var_GetNonEmptyString( p_stream, SOUT_CFG_PREFIX "mux" );
1039
1040         if( psz == NULL ) /* Uho! */
1041             ;
1042         else
1043         if( strncmp( psz, "ts", 2 ) == 0 )
1044         {
1045             id->i_payload_type = 33;
1046             id->psz_enc = "MP2T";
1047         }
1048         else
1049         {
1050             id->psz_enc = "MP2P";
1051         }
1052         free( psz );
1053     }
1054     else
1055     switch( p_fmt->i_codec )
1056     {
1057         case VLC_CODEC_MULAW:
1058             if( p_fmt->audio.i_channels == 1 && p_fmt->audio.i_rate == 8000 )
1059                 id->i_payload_type = 0;
1060             id->psz_enc = "PCMU";
1061             id->pf_packetize = rtp_packetize_split;
1062             rtp_set_ptime (id, 20, 1);
1063             break;
1064         case VLC_CODEC_ALAW:
1065             if( p_fmt->audio.i_channels == 1 && p_fmt->audio.i_rate == 8000 )
1066                 id->i_payload_type = 8;
1067             id->psz_enc = "PCMA";
1068             id->pf_packetize = rtp_packetize_split;
1069             rtp_set_ptime (id, 20, 1);
1070             break;
1071         case VLC_CODEC_S16B:
1072         case VLC_CODEC_S16L:
1073             if( p_fmt->audio.i_channels == 1 && p_fmt->audio.i_rate == 44100 )
1074             {
1075                 id->i_payload_type = 11;
1076             }
1077             else if( p_fmt->audio.i_channels == 2 &&
1078                      p_fmt->audio.i_rate == 44100 )
1079             {
1080                 id->i_payload_type = 10;
1081             }
1082             id->psz_enc = "L16";
1083             if( p_fmt->i_codec == VLC_CODEC_S16B )
1084                 id->pf_packetize = rtp_packetize_split;
1085             else
1086                 id->pf_packetize = rtp_packetize_swab;
1087             rtp_set_ptime (id, 20, 2);
1088             break;
1089         case VLC_CODEC_U8:
1090             id->psz_enc = "L8";
1091             id->pf_packetize = rtp_packetize_split;
1092             rtp_set_ptime (id, 20, 1);
1093             break;
1094         case VLC_CODEC_MPGA:
1095             id->i_payload_type = 14;
1096             id->psz_enc = "MPA";
1097             id->i_clock_rate = 90000; /* not 44100 */
1098             id->pf_packetize = rtp_packetize_mpa;
1099             break;
1100         case VLC_CODEC_MPGV:
1101             id->i_payload_type = 32;
1102             id->psz_enc = "MPV";
1103             id->pf_packetize = rtp_packetize_mpv;
1104             break;
1105         case VLC_CODEC_ADPCM_G726:
1106             switch( p_fmt->i_bitrate / 1000 )
1107             {
1108             case 16:
1109                 id->psz_enc = "G726-16";
1110                 id->pf_packetize = rtp_packetize_g726_16;
1111                 break;
1112             case 24:
1113                 id->psz_enc = "G726-24";
1114                 id->pf_packetize = rtp_packetize_g726_24;
1115                 break;
1116             case 32:
1117                 id->psz_enc = "G726-32";
1118                 id->pf_packetize = rtp_packetize_g726_32;
1119                 break;
1120             case 40:
1121                 id->psz_enc = "G726-40";
1122                 id->pf_packetize = rtp_packetize_g726_40;
1123                 break;
1124             default:
1125                 msg_Err( p_stream, "cannot add this stream (unsupported "
1126                          "G.726 bit rate: %u)", p_fmt->i_bitrate );
1127                 goto error;
1128             }
1129             break;
1130         case VLC_CODEC_A52:
1131             id->psz_enc = "ac3";
1132             id->pf_packetize = rtp_packetize_ac3;
1133             break;
1134         case VLC_CODEC_H263:
1135             id->psz_enc = "H263-1998";
1136             id->pf_packetize = rtp_packetize_h263;
1137             break;
1138         case VLC_CODEC_H264:
1139             id->psz_enc = "H264";
1140             id->pf_packetize = rtp_packetize_h264;
1141             id->psz_fmtp = NULL;
1142
1143             if( p_fmt->i_extra > 0 )
1144             {
1145                 uint8_t *p_buffer = p_fmt->p_extra;
1146                 int     i_buffer = p_fmt->i_extra;
1147                 char    *p_64_sps = NULL;
1148                 char    *p_64_pps = NULL;
1149                 char    hexa[6+1];
1150
1151                 while( i_buffer > 4 &&
1152                        p_buffer[0] == 0 && p_buffer[1] == 0 &&
1153                        p_buffer[2] == 0 && p_buffer[3] == 1 )
1154                 {
1155                     const int i_nal_type = p_buffer[4]&0x1f;
1156                     int i_offset;
1157                     int i_size      = 0;
1158
1159                     msg_Dbg( p_stream, "we found a startcode for NAL with TYPE:%d", i_nal_type );
1160
1161                     i_size = i_buffer;
1162                     for( i_offset = 4; i_offset+3 < i_buffer ; i_offset++)
1163                     {
1164                         if( !memcmp (p_buffer + i_offset, "\x00\x00\x00\x01", 4 ) )
1165                         {
1166                             /* we found another startcode */
1167                             i_size = i_offset;
1168                             break;
1169                         }
1170                     }
1171                     if( i_nal_type == 7 )
1172                     {
1173                         p_64_sps = vlc_b64_encode_binary( &p_buffer[4], i_size - 4 );
1174                         sprintf_hexa( hexa, &p_buffer[5], 3 );
1175                     }
1176                     else if( i_nal_type == 8 )
1177                     {
1178                         p_64_pps = vlc_b64_encode_binary( &p_buffer[4], i_size - 4 );
1179                     }
1180                     i_buffer -= i_size;
1181                     p_buffer += i_size;
1182                 }
1183                 /* */
1184                 if( p_64_sps && p_64_pps &&
1185                     ( asprintf( &id->psz_fmtp,
1186                                 "packetization-mode=1;profile-level-id=%s;"
1187                                 "sprop-parameter-sets=%s,%s;", hexa, p_64_sps,
1188                                 p_64_pps ) == -1 ) )
1189                     id->psz_fmtp = NULL;
1190                 free( p_64_sps );
1191                 free( p_64_pps );
1192             }
1193             if( !id->psz_fmtp )
1194                 id->psz_fmtp = strdup( "packetization-mode=1" );
1195             break;
1196
1197         case VLC_CODEC_MP4V:
1198         {
1199             char hexa[2*p_fmt->i_extra +1];
1200
1201             id->psz_enc = "MP4V-ES";
1202             id->pf_packetize = rtp_packetize_split;
1203             if( p_fmt->i_extra > 0 )
1204             {
1205                 sprintf_hexa( hexa, p_fmt->p_extra, p_fmt->i_extra );
1206                 if( asprintf( &id->psz_fmtp,
1207                               "profile-level-id=3; config=%s;", hexa ) == -1 )
1208                     id->psz_fmtp = NULL;
1209             }
1210             break;
1211         }
1212         case VLC_CODEC_MP4A:
1213         {
1214             if(!p_sys->b_latm)
1215             {
1216                 char hexa[2*p_fmt->i_extra +1];
1217
1218                 id->psz_enc = "mpeg4-generic";
1219                 id->pf_packetize = rtp_packetize_mp4a;
1220                 sprintf_hexa( hexa, p_fmt->p_extra, p_fmt->i_extra );
1221                 if( asprintf( &id->psz_fmtp,
1222                               "streamtype=5; profile-level-id=15; "
1223                               "mode=AAC-hbr; config=%s; SizeLength=13; "
1224                               "IndexLength=3; IndexDeltaLength=3; Profile=1;",
1225                               hexa ) == -1 )
1226                     id->psz_fmtp = NULL;
1227             }
1228             else
1229             {
1230                 char hexa[13];
1231                 int i;
1232                 unsigned char config[6];
1233                 unsigned int aacsrates[15] = {
1234                     96000, 88200, 64000, 48000, 44100, 32000, 24000, 22050,
1235                     16000, 12000, 11025, 8000, 7350, 0, 0 };
1236
1237                 for( i = 0; i < 15; i++ )
1238                     if( p_fmt->audio.i_rate == aacsrates[i] )
1239                         break;
1240
1241                 config[0]=0x40;
1242                 config[1]=0;
1243                 config[2]=0x20|i;
1244                 config[3]=p_fmt->audio.i_channels<<4;
1245                 config[4]=0x3f;
1246                 config[5]=0xc0;
1247
1248                 id->psz_enc = "MP4A-LATM";
1249                 id->pf_packetize = rtp_packetize_mp4a_latm;
1250                 sprintf_hexa( hexa, config, 6 );
1251                 if( asprintf( &id->psz_fmtp, "profile-level-id=15; "
1252                               "object=2; cpresent=0; config=%s", hexa ) == -1 )
1253                     id->psz_fmtp = NULL;
1254             }
1255             break;
1256         }
1257         case VLC_CODEC_AMR_NB:
1258             id->psz_enc = "AMR";
1259             id->psz_fmtp = strdup( "octet-align=1" );
1260             id->pf_packetize = rtp_packetize_amr;
1261             break;
1262         case VLC_CODEC_AMR_WB:
1263             id->psz_enc = "AMR-WB";
1264             id->psz_fmtp = strdup( "octet-align=1" );
1265             id->pf_packetize = rtp_packetize_amr;
1266             break;
1267         case VLC_CODEC_SPEEX:
1268             id->psz_enc = "SPEEX";
1269             id->pf_packetize = rtp_packetize_spx;
1270             break;
1271         case VLC_CODEC_ITU_T140:
1272             id->psz_enc = "t140" ;
1273             id->i_clock_rate = 1000;
1274             id->pf_packetize = rtp_packetize_t140;
1275             break;
1276
1277         default:
1278             msg_Err( p_stream, "cannot add this stream (unsupported "
1279                      "codec: %4.4s)", (char*)&p_fmt->i_codec );
1280             goto error;
1281     }
1282     if (id->i_payload_type >= 96)
1283         /* Mark dynamic payload type in use */
1284         p_sys->payload_bitmap |= 1 << (id->i_payload_type - 96);
1285
1286 #if 0 /* No payload formats sets this at the moment */
1287     int cscov = -1;
1288     if( cscov != -1 )
1289         cscov += 8 /* UDP */ + 12 /* RTP */;
1290     if( id->sinkc > 0 )
1291         net_SetCSCov( id->sinkv[0].rtp_fd, cscov, -1 );
1292 #endif
1293
1294     if( p_sys->rtsp != NULL )
1295         id->rtsp_id = RtspAddId( p_sys->rtsp, id, p_sys->i_es,
1296                                  GetDWBE( id->ssrc ),
1297                                  p_sys->psz_destination,
1298                                  p_sys->i_ttl, id->i_port, id->i_port + 1 );
1299
1300     id->p_fifo = block_FifoNew();
1301     if( vlc_thread_create( id, "RTP send thread", ThreadSend,
1302                            VLC_THREAD_PRIORITY_HIGHEST ) )
1303         goto error;
1304
1305     /* Update p_sys context */
1306     vlc_mutex_lock( &p_sys->lock_es );
1307     TAB_APPEND( p_sys->i_es, p_sys->es, id );
1308     vlc_mutex_unlock( &p_sys->lock_es );
1309
1310     psz_sdp = SDPGenerate( p_stream, NULL );
1311
1312     vlc_mutex_lock( &p_sys->lock_sdp );
1313     free( p_sys->psz_sdp );
1314     p_sys->psz_sdp = psz_sdp;
1315     vlc_mutex_unlock( &p_sys->lock_sdp );
1316
1317     msg_Dbg( p_stream, "sdp=\n%s", p_sys->psz_sdp );
1318
1319     /* Update SDP (sap/file) */
1320     if( p_sys->b_export_sap ) SapSetup( p_stream );
1321     if( p_sys->psz_sdp_file != NULL ) FileSetup( p_stream );
1322
1323     return id;
1324
1325 error:
1326     Del( p_stream, id );
1327     return NULL;
1328 }
1329
1330 static int Del( sout_stream_t *p_stream, sout_stream_id_t *id )
1331 {
1332     sout_stream_sys_t *p_sys = p_stream->p_sys;
1333
1334     if( id->p_fifo != NULL )
1335     {
1336         vlc_object_kill( id );
1337         vlc_thread_join( id );
1338         block_FifoRelease( id->p_fifo );
1339     }
1340
1341     vlc_mutex_lock( &p_sys->lock_es );
1342     TAB_REMOVE( p_sys->i_es, p_sys->es, id );
1343     vlc_mutex_unlock( &p_sys->lock_es );
1344
1345     /* Release dynamic payload type */
1346     if (id->i_payload_type >= 96)
1347         p_sys->payload_bitmap &= ~(1 << (id->i_payload_type - 96));
1348
1349     free( id->psz_fmtp );
1350
1351     if( id->rtsp_id )
1352         RtspDelId( p_sys->rtsp, id->rtsp_id );
1353     if( id->sinkc > 0 )
1354         rtp_del_sink( id, id->sinkv[0].rtp_fd ); /* sink for explicit dst= */
1355     if( id->listen.fd != NULL )
1356     {
1357         vlc_cancel( id->listen.thread );
1358         vlc_join( id->listen.thread, NULL );
1359         net_ListenClose( id->listen.fd );
1360     }
1361 #ifdef HAVE_SRTP
1362     if( id->srtp != NULL )
1363         srtp_destroy( id->srtp );
1364 #endif
1365
1366     vlc_mutex_destroy( &id->lock_sink );
1367
1368     /* Update SDP (sap/file) */
1369     if( p_sys->b_export_sap && !p_sys->p_mux ) SapSetup( p_stream );
1370     if( p_sys->psz_sdp_file != NULL ) FileSetup( p_stream );
1371
1372     vlc_object_detach( id );
1373     vlc_object_release( id );
1374     return VLC_SUCCESS;
1375 }
1376
1377 static int Send( sout_stream_t *p_stream, sout_stream_id_t *id,
1378                  block_t *p_buffer )
1379 {
1380     block_t *p_next;
1381
1382     assert( p_stream->p_sys->p_mux == NULL );
1383     (void)p_stream;
1384
1385     while( p_buffer != NULL )
1386     {
1387         p_next = p_buffer->p_next;
1388         if( id->pf_packetize( id, p_buffer ) )
1389             break;
1390
1391         block_Release( p_buffer );
1392         p_buffer = p_next;
1393     }
1394     return VLC_SUCCESS;
1395 }
1396
1397 /****************************************************************************
1398  * SAP:
1399  ****************************************************************************/
1400 static int SapSetup( sout_stream_t *p_stream )
1401 {
1402     sout_stream_sys_t *p_sys = p_stream->p_sys;
1403     sout_instance_t   *p_sout = p_stream->p_sout;
1404
1405     /* Remove the previous session */
1406     if( p_sys->p_session != NULL)
1407     {
1408         sout_AnnounceUnRegister( p_sout, p_sys->p_session);
1409         p_sys->p_session = NULL;
1410     }
1411
1412     if( ( p_sys->i_es > 0 || p_sys->p_mux ) && p_sys->psz_sdp && *p_sys->psz_sdp )
1413     {
1414         announce_method_t *p_method = sout_SAPMethod();
1415         p_sys->p_session = sout_AnnounceRegisterSDP( p_sout,
1416                                                      p_sys->psz_sdp,
1417                                                      p_sys->psz_destination,
1418                                                      p_method );
1419         sout_MethodRelease( p_method );
1420     }
1421
1422     return VLC_SUCCESS;
1423 }
1424
1425 /****************************************************************************
1426 * File:
1427 ****************************************************************************/
1428 static int FileSetup( sout_stream_t *p_stream )
1429 {
1430     sout_stream_sys_t *p_sys = p_stream->p_sys;
1431     FILE            *f;
1432
1433     if( p_sys->psz_sdp == NULL )
1434         return VLC_EGENERIC; /* too early */
1435
1436     if( ( f = utf8_fopen( p_sys->psz_sdp_file, "wt" ) ) == NULL )
1437     {
1438         msg_Err( p_stream, "cannot open file '%s' (%m)",
1439                  p_sys->psz_sdp_file );
1440         return VLC_EGENERIC;
1441     }
1442
1443     fputs( p_sys->psz_sdp, f );
1444     fclose( f );
1445
1446     return VLC_SUCCESS;
1447 }
1448
1449 /****************************************************************************
1450  * HTTP:
1451  ****************************************************************************/
1452 static int  HttpCallback( httpd_file_sys_t *p_args,
1453                           httpd_file_t *, uint8_t *p_request,
1454                           uint8_t **pp_data, int *pi_data );
1455
1456 static int HttpSetup( sout_stream_t *p_stream, const vlc_url_t *url)
1457 {
1458     sout_stream_sys_t *p_sys = p_stream->p_sys;
1459
1460     p_sys->p_httpd_host = httpd_HostNew( VLC_OBJECT(p_stream), url->psz_host,
1461                                          url->i_port > 0 ? url->i_port : 80 );
1462     if( p_sys->p_httpd_host )
1463     {
1464         p_sys->p_httpd_file = httpd_FileNew( p_sys->p_httpd_host,
1465                                              url->psz_path ? url->psz_path : "/",
1466                                              "application/sdp",
1467                                              NULL, NULL, NULL,
1468                                              HttpCallback, (void*)p_sys );
1469     }
1470     if( p_sys->p_httpd_file == NULL )
1471     {
1472         return VLC_EGENERIC;
1473     }
1474     return VLC_SUCCESS;
1475 }
1476
1477 static int  HttpCallback( httpd_file_sys_t *p_args,
1478                           httpd_file_t *f, uint8_t *p_request,
1479                           uint8_t **pp_data, int *pi_data )
1480 {
1481     VLC_UNUSED(f); VLC_UNUSED(p_request);
1482     sout_stream_sys_t *p_sys = (sout_stream_sys_t*)p_args;
1483
1484     vlc_mutex_lock( &p_sys->lock_sdp );
1485     if( p_sys->psz_sdp && *p_sys->psz_sdp )
1486     {
1487         *pi_data = strlen( p_sys->psz_sdp );
1488         *pp_data = malloc( *pi_data );
1489         memcpy( *pp_data, p_sys->psz_sdp, *pi_data );
1490     }
1491     else
1492     {
1493         *pp_data = NULL;
1494         *pi_data = 0;
1495     }
1496     vlc_mutex_unlock( &p_sys->lock_sdp );
1497
1498     return VLC_SUCCESS;
1499 }
1500
1501 /****************************************************************************
1502  * RTP send
1503  ****************************************************************************/
1504 static void* ThreadSend( vlc_object_t *p_this )
1505 {
1506 #ifdef WIN32
1507 # define ECONNREFUSED WSAECONNREFUSED
1508 # define ENOPROTOOPT  WSAENOPROTOOPT
1509 # define EHOSTUNREACH WSAEHOSTUNREACH
1510 # define ENETUNREACH  WSAENETUNREACH
1511 # define ENETDOWN     WSAENETDOWN
1512 # define ENOBUFS      WSAENOBUFS
1513 # define EAGAIN       WSAEWOULDBLOCK
1514 # define EWOULDBLOCK  WSAEWOULDBLOCK
1515 #endif
1516     sout_stream_id_t *id = (sout_stream_id_t *)p_this;
1517     unsigned i_caching = id->i_caching;
1518
1519     for (;;)
1520     {
1521         block_t *out = block_FifoGet( id->p_fifo );
1522         block_cleanup_push (out);
1523
1524 #ifdef HAVE_SRTP
1525         if( id->srtp )
1526         {   /* FIXME: this is awfully inefficient */
1527             size_t len = out->i_buffer;
1528             out = block_Realloc( out, 0, len + 10 );
1529             out->i_buffer = len;
1530
1531             int canc = vlc_savecancel ();
1532             int val = srtp_send( id->srtp, out->p_buffer, &len, len + 10 );
1533             vlc_restorecancel (canc);
1534             if( val )
1535             {
1536                 errno = val;
1537                 msg_Dbg( id, "SRTP sending error: %m" );
1538                 block_Release( out );
1539                 out = NULL;
1540             }
1541             else
1542                 out->i_buffer = len;
1543         }
1544         if (out)
1545 #endif
1546             mwait (out->i_dts + i_caching);
1547         vlc_cleanup_pop ();
1548         if (out == NULL)
1549             continue;
1550
1551         ssize_t len = out->i_buffer;
1552         int canc = vlc_savecancel ();
1553
1554         vlc_mutex_lock( &id->lock_sink );
1555         unsigned deadc = 0; /* How many dead sockets? */
1556         int deadv[id->sinkc]; /* Dead sockets list */
1557
1558         for( int i = 0; i < id->sinkc; i++ )
1559         {
1560 #ifdef HAVE_SRTP
1561             if( !id->srtp ) /* FIXME: SRTCP support */
1562 #endif
1563                 SendRTCP( id->sinkv[i].rtcp, out );
1564
1565             if( send( id->sinkv[i].rtp_fd, out->p_buffer, len, 0 ) >= 0 )
1566                 continue;
1567             switch( net_errno )
1568             {
1569                 /* Soft errors (e.g. ICMP): */
1570                 case ECONNREFUSED: /* Port unreachable */
1571                 case ENOPROTOOPT:
1572 #ifdef EPROTO
1573                 case EPROTO:       /* Protocol unreachable */
1574 #endif
1575                 case EHOSTUNREACH: /* Host unreachable */
1576                 case ENETUNREACH:  /* Network unreachable */
1577                 case ENETDOWN:     /* Entire network down */
1578                     send( id->sinkv[i].rtp_fd, out->p_buffer, len, 0 );
1579                 /* Transient congestion: */
1580                 case ENOMEM: /* out of socket buffers */
1581                 case ENOBUFS:
1582                 case EAGAIN:
1583 #if (EAGAIN != EWOULDBLOCK)
1584                 case EWOULDBLOCK:
1585 #endif
1586                     continue;
1587             }
1588
1589             deadv[deadc++] = id->sinkv[i].rtp_fd;
1590         }
1591         vlc_mutex_unlock( &id->lock_sink );
1592         block_Release( out );
1593
1594         for( unsigned i = 0; i < deadc; i++ )
1595         {
1596             msg_Dbg( id, "removing socket %d", deadv[i] );
1597             rtp_del_sink( id, deadv[i] );
1598         }
1599         vlc_restorecancel (canc);
1600     }
1601     return NULL;
1602 }
1603
1604
1605 /* This thread dequeues incoming connections (DCCP streaming) */
1606 static void *rtp_listen_thread( void *data )
1607 {
1608     sout_stream_id_t *id = data;
1609
1610     assert( id->listen.fd != NULL );
1611
1612     for( ;; )
1613     {
1614         int fd = net_Accept( id, id->listen.fd );
1615         if( fd == -1 )
1616             continue;
1617         int canc = vlc_savecancel( );
1618         rtp_add_sink( id, fd, true );
1619         vlc_restorecancel( canc );
1620     }
1621
1622     assert( 0 );
1623 }
1624
1625
1626 int rtp_add_sink( sout_stream_id_t *id, int fd, bool rtcp_mux )
1627 {
1628     rtp_sink_t sink = { fd, NULL };
1629     sink.rtcp = OpenRTCP( VLC_OBJECT( id->p_stream ), fd, IPPROTO_UDP,
1630                           rtcp_mux );
1631     if( sink.rtcp == NULL )
1632         msg_Err( id, "RTCP failed!" );
1633
1634     vlc_mutex_lock( &id->lock_sink );
1635     INSERT_ELEM( id->sinkv, id->sinkc, id->sinkc, sink );
1636     vlc_mutex_unlock( &id->lock_sink );
1637     return VLC_SUCCESS;
1638 }
1639
1640 void rtp_del_sink( sout_stream_id_t *id, int fd )
1641 {
1642     rtp_sink_t sink = { fd, NULL };
1643
1644     /* NOTE: must be safe to use if fd is not included */
1645     vlc_mutex_lock( &id->lock_sink );
1646     for( int i = 0; i < id->sinkc; i++ )
1647     {
1648         if (id->sinkv[i].rtp_fd == fd)
1649         {
1650             sink = id->sinkv[i];
1651             REMOVE_ELEM( id->sinkv, id->sinkc, i );
1652             break;
1653         }
1654     }
1655     vlc_mutex_unlock( &id->lock_sink );
1656
1657     CloseRTCP( sink.rtcp );
1658     net_Close( sink.rtp_fd );
1659 }
1660
1661 uint16_t rtp_get_seq( const sout_stream_id_t *id )
1662 {
1663     /* This will return values for the next packet.
1664      * Accounting for caching would not be totally trivial. */
1665     return id->i_sequence;
1666 }
1667
1668 uint32_t rtp_get_ts( const sout_stream_id_t *id )
1669 {
1670     /* ... and this will return the value for the last packet.
1671      * Lame, but close enough. */
1672     return id->i_timestamp;
1673 }
1674
1675 /* FIXME: this is pretty bad - if we remove and then insert an ES
1676  * the number will get unsynched from inside RTSP */
1677 unsigned rtp_get_num( const sout_stream_id_t *id )
1678 {
1679     sout_stream_sys_t *p_sys = id->p_stream->p_sys;
1680     int i;
1681
1682     vlc_mutex_lock( &p_sys->lock_es );
1683     for( i = 0; i < p_sys->i_es; i++ )
1684     {
1685         if( id == p_sys->es[i] )
1686             break;
1687     }
1688     vlc_mutex_unlock( &p_sys->lock_es );
1689
1690     return i;
1691 }
1692
1693
1694 void rtp_packetize_common( sout_stream_id_t *id, block_t *out,
1695                            int b_marker, int64_t i_pts )
1696 {
1697     uint32_t i_timestamp = i_pts * (int64_t)id->i_clock_rate / CLOCK_FREQ;
1698
1699     out->p_buffer[0] = 0x80;
1700     out->p_buffer[1] = (b_marker?0x80:0x00)|id->i_payload_type;
1701     out->p_buffer[2] = ( id->i_sequence >> 8)&0xff;
1702     out->p_buffer[3] = ( id->i_sequence     )&0xff;
1703     out->p_buffer[4] = ( i_timestamp >> 24 )&0xff;
1704     out->p_buffer[5] = ( i_timestamp >> 16 )&0xff;
1705     out->p_buffer[6] = ( i_timestamp >>  8 )&0xff;
1706     out->p_buffer[7] = ( i_timestamp       )&0xff;
1707
1708     memcpy( out->p_buffer + 8, id->ssrc, 4 );
1709
1710     out->i_buffer = 12;
1711     id->i_timestamp = i_timestamp;
1712     id->i_sequence++;
1713 }
1714
1715 void rtp_packetize_send( sout_stream_id_t *id, block_t *out )
1716 {
1717     block_FifoPut( id->p_fifo, out );
1718 }
1719
1720 /**
1721  * @return configured max RTP payload size (including payload type-specific
1722  * headers, excluding RTP and transport headers)
1723  */
1724 size_t rtp_mtu (const sout_stream_id_t *id)
1725 {
1726     return id->i_mtu - 12;
1727 }
1728
1729 /*****************************************************************************
1730  * Non-RTP mux
1731  *****************************************************************************/
1732
1733 /** Add an ES to a non-RTP muxed stream */
1734 static sout_stream_id_t *MuxAdd( sout_stream_t *p_stream, es_format_t *p_fmt )
1735 {
1736     sout_input_t      *p_input;
1737     sout_mux_t *p_mux = p_stream->p_sys->p_mux;
1738     assert( p_mux != NULL );
1739
1740     p_input = sout_MuxAddStream( p_mux, p_fmt );
1741     if( p_input == NULL )
1742     {
1743         msg_Err( p_stream, "cannot add this stream to the muxer" );
1744         return NULL;
1745     }
1746
1747     return (sout_stream_id_t *)p_input;
1748 }
1749
1750
1751 static int MuxSend( sout_stream_t *p_stream, sout_stream_id_t *id,
1752                     block_t *p_buffer )
1753 {
1754     sout_mux_t *p_mux = p_stream->p_sys->p_mux;
1755     assert( p_mux != NULL );
1756
1757     sout_MuxSendBuffer( p_mux, (sout_input_t *)id, p_buffer );
1758     return VLC_SUCCESS;
1759 }
1760
1761
1762 /** Remove an ES from a non-RTP muxed stream */
1763 static int MuxDel( sout_stream_t *p_stream, sout_stream_id_t *id )
1764 {
1765     sout_mux_t *p_mux = p_stream->p_sys->p_mux;
1766     assert( p_mux != NULL );
1767
1768     sout_MuxDeleteStream( p_mux, (sout_input_t *)id );
1769     return VLC_SUCCESS;
1770 }
1771
1772
1773 static ssize_t AccessOutGrabberWriteBuffer( sout_stream_t *p_stream,
1774                                             const block_t *p_buffer )
1775 {
1776     sout_stream_sys_t *p_sys = p_stream->p_sys;
1777     sout_stream_id_t *id = p_sys->es[0];
1778
1779     int64_t  i_dts = p_buffer->i_dts;
1780
1781     uint8_t         *p_data = p_buffer->p_buffer;
1782     size_t          i_data  = p_buffer->i_buffer;
1783     size_t          i_max   = id->i_mtu - 12;
1784
1785     size_t i_packet = ( p_buffer->i_buffer + i_max - 1 ) / i_max;
1786
1787     while( i_data > 0 )
1788     {
1789         size_t i_size;
1790
1791         /* output complete packet */
1792         if( p_sys->packet &&
1793             p_sys->packet->i_buffer + i_data > i_max )
1794         {
1795             rtp_packetize_send( id, p_sys->packet );
1796             p_sys->packet = NULL;
1797         }
1798
1799         if( p_sys->packet == NULL )
1800         {
1801             /* allocate a new packet */
1802             p_sys->packet = block_New( p_stream, id->i_mtu );
1803             rtp_packetize_common( id, p_sys->packet, 1, i_dts );
1804             p_sys->packet->i_dts = i_dts;
1805             p_sys->packet->i_length = p_buffer->i_length / i_packet;
1806             i_dts += p_sys->packet->i_length;
1807         }
1808
1809         i_size = __MIN( i_data,
1810                         (unsigned)(id->i_mtu - p_sys->packet->i_buffer) );
1811
1812         memcpy( &p_sys->packet->p_buffer[p_sys->packet->i_buffer],
1813                 p_data, i_size );
1814
1815         p_sys->packet->i_buffer += i_size;
1816         p_data += i_size;
1817         i_data -= i_size;
1818     }
1819
1820     return VLC_SUCCESS;
1821 }
1822
1823
1824 static ssize_t AccessOutGrabberWrite( sout_access_out_t *p_access,
1825                                       block_t *p_buffer )
1826 {
1827     sout_stream_t *p_stream = (sout_stream_t*)p_access->p_sys;
1828
1829     while( p_buffer )
1830     {
1831         block_t *p_next;
1832
1833         AccessOutGrabberWriteBuffer( p_stream, p_buffer );
1834
1835         p_next = p_buffer->p_next;
1836         block_Release( p_buffer );
1837         p_buffer = p_next;
1838     }
1839
1840     return VLC_SUCCESS;
1841 }
1842
1843
1844 static sout_access_out_t *GrabberCreate( sout_stream_t *p_stream )
1845 {
1846     sout_access_out_t *p_grab;
1847
1848     p_grab = vlc_object_create( p_stream->p_sout, sizeof( *p_grab ) );
1849     if( p_grab == NULL )
1850         return NULL;
1851
1852     p_grab->p_module    = NULL;
1853     p_grab->psz_access  = strdup( "grab" );
1854     p_grab->p_cfg       = NULL;
1855     p_grab->psz_path    = strdup( "" );
1856     p_grab->p_sys       = (sout_access_out_sys_t *)p_stream;
1857     p_grab->pf_seek     = NULL;
1858     p_grab->pf_write    = AccessOutGrabberWrite;
1859     vlc_object_attach( p_grab, p_stream );
1860     return p_grab;
1861 }