3 * Copyright (c) 2012 Nicolas George
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public License
9 * as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public License
18 * along with FFmpeg; if not, write to the Free Software * Foundation, Inc.,
19 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
23 #include "libavutil/avutil.h"
24 #include "libavutil/avstring.h"
25 #include "libavutil/opt.h"
28 #include "avio_internal.h"
29 #include "tee_common.h"
32 ON_SLAVE_FAILURE_ABORT = 1,
33 ON_SLAVE_FAILURE_IGNORE = 2
36 #define DEFAULT_SLAVE_FAILURE_POLICY ON_SLAVE_FAILURE_ABORT
40 AVBSFContext **bsfs; ///< bitstream filters per stream
42 SlaveFailurePolicy on_fail;
44 AVDictionary *fifo_options;
46 /** map from input to output streams indexes,
47 * disabled output streams are set to -1 */
52 typedef struct TeeContext {
58 AVDictionary *fifo_options;
59 char *fifo_options_str;
62 static const char *const slave_delim = "|";
63 static const char *const slave_bsfs_spec_sep = "/";
64 static const char *const slave_select_sep = ",";
66 #define OFFSET(x) offsetof(TeeContext, x)
67 static const AVOption options[] = {
68 {"use_fifo", "Use fifo pseudo-muxer to separate actual muxers from encoder",
69 OFFSET(use_fifo), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, AV_OPT_FLAG_ENCODING_PARAM},
70 {"fifo_options", "fifo pseudo-muxer options", OFFSET(fifo_options_str),
71 AV_OPT_TYPE_STRING, {.str = NULL}, 0, 0, AV_OPT_FLAG_ENCODING_PARAM},
75 static const AVClass tee_muxer_class = {
76 .class_name = "Tee muxer",
77 .item_name = av_default_item_name,
79 .version = LIBAVUTIL_VERSION_INT,
82 static inline int parse_slave_failure_policy_option(const char *opt, TeeSlave *tee_slave)
85 tee_slave->on_fail = DEFAULT_SLAVE_FAILURE_POLICY;
87 } else if (!av_strcasecmp("abort", opt)) {
88 tee_slave->on_fail = ON_SLAVE_FAILURE_ABORT;
90 } else if (!av_strcasecmp("ignore", opt)) {
91 tee_slave->on_fail = ON_SLAVE_FAILURE_IGNORE;
94 /* Set failure behaviour to abort, so invalid option error will not be ignored */
95 tee_slave->on_fail = ON_SLAVE_FAILURE_ABORT;
96 return AVERROR(EINVAL);
99 static int parse_slave_fifo_options(const char *use_fifo,
100 const char *fifo_options, TeeSlave *tee_slave)
105 /*TODO - change this to use proper function for parsing boolean
106 * options when there is one */
107 if (av_match_name(use_fifo, "true,y,yes,enable,enabled,on,1")) {
108 tee_slave->use_fifo = 1;
109 } else if (av_match_name(use_fifo, "false,n,no,disable,disabled,off,0")) {
110 tee_slave->use_fifo = 0;
112 return AVERROR(EINVAL);
117 ret = av_dict_parse_string(&tee_slave->fifo_options, fifo_options, "=", ":", 0);
122 static int close_slave(TeeSlave *tee_slave)
124 AVFormatContext *avf;
128 avf = tee_slave->avf;
132 if (tee_slave->header_written)
133 ret = av_write_trailer(avf);
135 if (tee_slave->bsfs) {
136 for (i = 0; i < avf->nb_streams; ++i)
137 av_bsf_free(&tee_slave->bsfs[i]);
139 av_freep(&tee_slave->stream_map);
140 av_freep(&tee_slave->bsfs);
142 ff_format_io_close(avf, &avf->pb);
143 avformat_free_context(avf);
144 tee_slave->avf = NULL;
148 static void close_slaves(AVFormatContext *avf)
150 TeeContext *tee = avf->priv_data;
153 for (i = 0; i < tee->nb_slaves; i++) {
154 close_slave(&tee->slaves[i]);
156 av_freep(&tee->slaves);
159 static int open_slave(AVFormatContext *avf, char *slave, TeeSlave *tee_slave)
162 AVDictionary *options = NULL, *bsf_options = NULL;
163 AVDictionaryEntry *entry;
165 char *format = NULL, *select = NULL, *on_fail = NULL;
166 char *use_fifo = NULL, *fifo_options_str = NULL;
167 AVFormatContext *avf2 = NULL;
171 char *subselect = NULL, *next_subselect = NULL, *first_subselect = NULL, *tmp_select = NULL;
173 if ((ret = ff_tee_parse_slave_options(avf, slave, &options, &filename)) < 0)
176 #define STEAL_OPTION(option, field) do { \
177 if ((entry = av_dict_get(options, option, NULL, 0))) { \
178 field = entry->value; \
179 entry->value = NULL; /* prevent it from being freed */ \
180 av_dict_set(&options, option, NULL, 0); \
184 STEAL_OPTION("f", format);
185 STEAL_OPTION("select", select);
186 STEAL_OPTION("onfail", on_fail);
187 STEAL_OPTION("use_fifo", use_fifo);
188 STEAL_OPTION("fifo_options", fifo_options_str);
190 while ((entry = av_dict_get(options, "bsfs", entry, AV_DICT_IGNORE_SUFFIX))) {
191 /* trim out strlen("bsfs") characters from key */
192 av_dict_set(&bsf_options, entry->key + 4, entry->value, 0);
193 av_dict_set(&options, entry->key, NULL, 0);
196 ret = parse_slave_failure_policy_option(on_fail, tee_slave);
198 av_log(avf, AV_LOG_ERROR,
199 "Invalid onfail option value, valid options are 'abort' and 'ignore'\n");
203 ret = parse_slave_fifo_options(use_fifo, fifo_options_str, tee_slave);
205 av_log(avf, AV_LOG_ERROR, "Error parsing fifo options: %s\n", av_err2str(ret));
209 if (tee_slave->use_fifo) {
212 char *format_options_str = NULL;
213 ret = av_dict_get_string(options, &format_options_str, '=', ':');
217 ret = av_dict_set(&tee_slave->fifo_options, "format_opts", format_options_str,
218 AV_DICT_DONT_STRDUP_VAL);
224 ret = av_dict_set(&tee_slave->fifo_options, "fifo_format", format,
225 AV_DICT_DONT_STRDUP_VAL);
231 av_dict_free(&options);
232 options = tee_slave->fifo_options;
234 ret = avformat_alloc_output_context2(&avf2, NULL,
235 tee_slave->use_fifo ? "fifo" :format, filename);
238 tee_slave->avf = avf2;
239 av_dict_copy(&avf2->metadata, avf->metadata, 0);
240 avf2->opaque = avf->opaque;
241 avf2->io_open = avf->io_open;
242 avf2->io_close = avf->io_close;
243 avf2->interrupt_callback = avf->interrupt_callback;
244 avf2->flags = avf->flags;
245 avf2->strict_std_compliance = avf->strict_std_compliance;
247 tee_slave->stream_map = av_calloc(avf->nb_streams, sizeof(*tee_slave->stream_map));
248 if (!tee_slave->stream_map) {
249 ret = AVERROR(ENOMEM);
254 for (i = 0; i < avf->nb_streams; i++) {
255 st = avf->streams[i];
257 tmp_select = av_strdup(select); // av_strtok is destructive so we regenerate it in each loop
259 ret = AVERROR(ENOMEM);
263 first_subselect = tmp_select;
264 next_subselect = NULL;
265 while (subselect = av_strtok(first_subselect, slave_select_sep, &next_subselect)) {
266 first_subselect = NULL;
268 ret = avformat_match_stream_specifier(avf, avf->streams[i], subselect);
270 av_log(avf, AV_LOG_ERROR,
271 "Invalid stream specifier '%s' for output '%s'\n",
276 fullret = 1; // match
280 av_freep(&tmp_select);
282 if (fullret == 0) { /* no match */
283 tee_slave->stream_map[i] = -1;
287 tee_slave->stream_map[i] = stream_count++;
289 if (!(st2 = avformat_new_stream(avf2, NULL))) {
290 ret = AVERROR(ENOMEM);
294 ret = ff_stream_encode_params_copy(st2, st);
299 ret = ff_format_output_open(avf2, filename, NULL);
301 av_log(avf, AV_LOG_ERROR, "Slave '%s': error opening: %s\n", slave,
306 if ((ret = avformat_write_header(avf2, &options)) < 0) {
307 av_log(avf, AV_LOG_ERROR, "Slave '%s': error writing header: %s\n",
308 slave, av_err2str(ret));
311 tee_slave->header_written = 1;
313 tee_slave->bsfs = av_calloc(avf2->nb_streams, sizeof(*tee_slave->bsfs));
314 if (!tee_slave->bsfs) {
315 ret = AVERROR(ENOMEM);
320 while (entry = av_dict_get(bsf_options, "", NULL, AV_DICT_IGNORE_SUFFIX)) {
321 const char *spec = entry->key;
323 if (strspn(spec, slave_bsfs_spec_sep) != 1) {
324 av_log(avf, AV_LOG_ERROR,
325 "Specifier separator in '%s' is '%c', but only characters '%s' "
326 "are allowed\n", entry->key, *spec, slave_bsfs_spec_sep);
327 ret = AVERROR(EINVAL);
330 spec++; /* consume separator */
333 for (i = 0; i < avf2->nb_streams; i++) {
334 ret = avformat_match_stream_specifier(avf2, avf2->streams[i], spec);
336 av_log(avf, AV_LOG_ERROR,
337 "Invalid stream specifier '%s' in bsfs option '%s' for slave "
338 "output '%s'\n", spec, entry->key, filename);
343 av_log(avf, AV_LOG_DEBUG, "spec:%s bsfs:%s matches stream %d of slave "
344 "output '%s'\n", spec, entry->value, i, filename);
345 if (tee_slave->bsfs[i]) {
346 av_log(avf, AV_LOG_WARNING,
347 "Duplicate bsfs specification associated to stream %d of slave "
348 "output '%s', filters will be ignored\n", i, filename);
351 ret = av_bsf_list_parse_str(entry->value, &tee_slave->bsfs[i]);
353 av_log(avf, AV_LOG_ERROR,
354 "Error parsing bitstream filter sequence '%s' associated to "
355 "stream %d of slave output '%s'\n", entry->value, i, filename);
361 av_dict_set(&bsf_options, entry->key, NULL, 0);
364 for (i = 0; i < avf->nb_streams; i++){
365 int target_stream = tee_slave->stream_map[i];
366 if (target_stream < 0)
369 if (!tee_slave->bsfs[target_stream]) {
370 /* Add pass-through bitstream filter */
371 ret = av_bsf_get_null_filter(&tee_slave->bsfs[target_stream]);
373 av_log(avf, AV_LOG_ERROR,
374 "Failed to create pass-through bitstream filter: %s\n",
380 tee_slave->bsfs[target_stream]->time_base_in = avf->streams[i]->time_base;
381 ret = avcodec_parameters_copy(tee_slave->bsfs[target_stream]->par_in,
382 avf->streams[i]->codecpar);
386 ret = av_bsf_init(tee_slave->bsfs[target_stream]);
388 av_log(avf, AV_LOG_ERROR,
389 "Failed to initialize bitstream filter(s): %s\n",
397 while ((entry = av_dict_get(options, "", entry, AV_DICT_IGNORE_SUFFIX)))
398 av_log(avf2, AV_LOG_ERROR, "Unknown option '%s'\n", entry->key);
399 ret = AVERROR_OPTION_NOT_FOUND;
407 av_dict_free(&options);
408 av_dict_free(&bsf_options);
409 av_freep(&tmp_select);
413 static void log_slave(TeeSlave *slave, void *log_ctx, int log_level)
416 av_log(log_ctx, log_level, "filename:'%s' format:%s\n",
417 slave->avf->url, slave->avf->oformat->name);
418 for (i = 0; i < slave->avf->nb_streams; i++) {
419 AVStream *st = slave->avf->streams[i];
420 AVBSFContext *bsf = slave->bsfs[i];
421 const char *bsf_name;
423 av_log(log_ctx, log_level, " stream:%d codec:%s type:%s",
424 i, avcodec_get_name(st->codecpar->codec_id),
425 av_get_media_type_string(st->codecpar->codec_type));
427 bsf_name = bsf->filter->priv_class ?
428 bsf->filter->priv_class->item_name(bsf) : bsf->filter->name;
429 av_log(log_ctx, log_level, " bsfs: %s\n", bsf_name);
433 static int tee_process_slave_failure(AVFormatContext *avf, unsigned slave_idx, int err_n)
435 TeeContext *tee = avf->priv_data;
436 TeeSlave *tee_slave = &tee->slaves[slave_idx];
440 close_slave(tee_slave);
442 if (!tee->nb_alive) {
443 av_log(avf, AV_LOG_ERROR, "All tee outputs failed.\n");
445 } else if (tee_slave->on_fail == ON_SLAVE_FAILURE_ABORT) {
446 av_log(avf, AV_LOG_ERROR, "Slave muxer #%u failed, aborting.\n", slave_idx);
449 av_log(avf, AV_LOG_ERROR, "Slave muxer #%u failed: %s, continuing with %u/%u slaves.\n",
450 slave_idx, av_err2str(err_n), tee->nb_alive, tee->nb_slaves);
455 static int tee_write_header(AVFormatContext *avf)
457 TeeContext *tee = avf->priv_data;
458 unsigned nb_slaves = 0, i;
459 const char *filename = avf->url;
460 char **slaves = NULL;
464 char *slave = av_get_token(&filename, slave_delim);
466 ret = AVERROR(ENOMEM);
469 ret = av_dynarray_add_nofree(&slaves, &nb_slaves, slave);
474 if (strspn(filename, slave_delim))
478 if (tee->fifo_options_str) {
479 ret = av_dict_parse_string(&tee->fifo_options, tee->fifo_options_str, "=", ":", 0);
484 if (!(tee->slaves = av_mallocz_array(nb_slaves, sizeof(*tee->slaves)))) {
485 ret = AVERROR(ENOMEM);
488 tee->nb_slaves = tee->nb_alive = nb_slaves;
490 for (i = 0; i < nb_slaves; i++) {
492 tee->slaves[i].use_fifo = tee->use_fifo;
493 ret = av_dict_copy(&tee->slaves[i].fifo_options, tee->fifo_options, 0);
497 if ((ret = open_slave(avf, slaves[i], &tee->slaves[i])) < 0) {
498 ret = tee_process_slave_failure(avf, i, ret);
502 log_slave(&tee->slaves[i], avf, AV_LOG_VERBOSE);
504 av_freep(&slaves[i]);
507 for (i = 0; i < avf->nb_streams; i++) {
509 for (j = 0; j < tee->nb_slaves; j++)
510 if (tee->slaves[j].avf)
511 mapped += tee->slaves[j].stream_map[i] >= 0;
513 av_log(avf, AV_LOG_WARNING, "Input stream #%d is not mapped "
514 "to any slave.\n", i);
520 for (i = 0; i < nb_slaves; i++)
521 av_freep(&slaves[i]);
527 static int tee_write_trailer(AVFormatContext *avf)
529 TeeContext *tee = avf->priv_data;
530 int ret_all = 0, ret;
533 for (i = 0; i < tee->nb_slaves; i++) {
534 if ((ret = close_slave(&tee->slaves[i])) < 0) {
535 ret = tee_process_slave_failure(avf, i, ret);
536 if (!ret_all && ret < 0)
540 av_freep(&tee->slaves);
544 static int tee_write_packet(AVFormatContext *avf, AVPacket *pkt)
546 TeeContext *tee = avf->priv_data;
547 AVFormatContext *avf2;
550 int ret_all = 0, ret;
554 for (i = 0; i < tee->nb_slaves; i++) {
555 if (!(avf2 = tee->slaves[i].avf))
558 /* Flush slave if pkt is NULL*/
560 ret = av_interleaved_write_frame(avf2, NULL);
562 ret = tee_process_slave_failure(avf, i, ret);
563 if (!ret_all && ret < 0)
569 s = pkt->stream_index;
570 s2 = tee->slaves[i].stream_map[s];
574 memset(&pkt2, 0, sizeof(AVPacket));
575 if ((ret = av_packet_ref(&pkt2, pkt)) < 0)
580 bsfs = tee->slaves[i].bsfs[s2];
581 pkt2.stream_index = s2;
583 ret = av_bsf_send_packet(bsfs, &pkt2);
585 av_log(avf, AV_LOG_ERROR, "Error while sending packet to bitstream filter: %s\n",
587 ret = tee_process_slave_failure(avf, i, ret);
588 if (!ret_all && ret < 0)
593 ret = av_bsf_receive_packet(bsfs, &pkt2);
594 if (ret == AVERROR(EAGAIN)) {
597 } else if (ret < 0) {
601 av_packet_rescale_ts(&pkt2, bsfs->time_base_out,
602 avf2->streams[s2]->time_base);
603 ret = av_interleaved_write_frame(avf2, &pkt2);
609 ret = tee_process_slave_failure(avf, i, ret);
610 if (!ret_all && ret < 0)
617 AVOutputFormat ff_tee_muxer = {
619 .long_name = NULL_IF_CONFIG_SMALL("Multiple muxer tee"),
620 .priv_data_size = sizeof(TeeContext),
621 .write_header = tee_write_header,
622 .write_trailer = tee_write_trailer,
623 .write_packet = tee_write_packet,
624 .priv_class = &tee_muxer_class,
625 .flags = AVFMT_NOFILE | AVFMT_ALLOW_FLUSH,