ffprobe: add pixel format flags output
[ffmpeg.git] / ffprobe.c
1 /*
2  * Copyright (c) 2007-2010 Stefano Sabatini
3  *
4  * This file is part of FFmpeg.
5  *
6  * FFmpeg is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * FFmpeg is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with FFmpeg; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20
21 /**
22  * @file
23  * simple media prober based on the FFmpeg libraries
24  */
25
26 #include "config.h"
27 #include "libavutil/ffversion.h"
28
29 #include <string.h>
30
31 #include "libavformat/avformat.h"
32 #include "libavcodec/avcodec.h"
33 #include "libavutil/avassert.h"
34 #include "libavutil/avstring.h"
35 #include "libavutil/bprint.h"
36 #include "libavutil/hash.h"
37 #include "libavutil/opt.h"
38 #include "libavutil/pixdesc.h"
39 #include "libavutil/dict.h"
40 #include "libavutil/libm.h"
41 #include "libavutil/parseutils.h"
42 #include "libavutil/timecode.h"
43 #include "libavutil/timestamp.h"
44 #include "libavdevice/avdevice.h"
45 #include "libswscale/swscale.h"
46 #include "libswresample/swresample.h"
47 #include "libpostproc/postprocess.h"
48 #include "cmdutils.h"
49
50 const char program_name[] = "ffprobe";
51 const int program_birth_year = 2007;
52
53 static int do_bitexact = 0;
54 static int do_count_frames = 0;
55 static int do_count_packets = 0;
56 static int do_read_frames  = 0;
57 static int do_read_packets = 0;
58 static int do_show_chapters = 0;
59 static int do_show_error   = 0;
60 static int do_show_format  = 0;
61 static int do_show_frames  = 0;
62 static int do_show_packets = 0;
63 static int do_show_programs = 0;
64 static int do_show_streams = 0;
65 static int do_show_stream_disposition = 0;
66 static int do_show_data    = 0;
67 static int do_show_program_version  = 0;
68 static int do_show_library_versions = 0;
69 static int do_show_pixel_formats = 0;
70 static int do_show_pixel_format_flags = 0;
71
72 static int do_show_chapter_tags = 0;
73 static int do_show_format_tags = 0;
74 static int do_show_frame_tags = 0;
75 static int do_show_program_tags = 0;
76 static int do_show_stream_tags = 0;
77
78 static int show_value_unit              = 0;
79 static int use_value_prefix             = 0;
80 static int use_byte_value_binary_prefix = 0;
81 static int use_value_sexagesimal_format = 0;
82 static int show_private_data            = 1;
83
84 static char *print_format;
85 static char *stream_specifier;
86 static char *show_data_hash;
87
88 typedef struct {
89     int id;             ///< identifier
90     int64_t start, end; ///< start, end in second/AV_TIME_BASE units
91     int has_start, has_end;
92     int start_is_offset, end_is_offset;
93     int duration_frames;
94 } ReadInterval;
95
96 static ReadInterval *read_intervals;
97 static int read_intervals_nb = 0;
98
99 /* section structure definition */
100
101 #define SECTION_MAX_NB_CHILDREN 10
102
103 struct section {
104     int id;             ///< unique id identifying a section
105     const char *name;
106
107 #define SECTION_FLAG_IS_WRAPPER      1 ///< the section only contains other sections, but has no data at its own level
108 #define SECTION_FLAG_IS_ARRAY        2 ///< the section contains an array of elements of the same type
109 #define SECTION_FLAG_HAS_VARIABLE_FIELDS 4 ///< the section may contain a variable number of fields with variable keys.
110                                            ///  For these sections the element_name field is mandatory.
111     int flags;
112     int children_ids[SECTION_MAX_NB_CHILDREN+1]; ///< list of children section IDS, terminated by -1
113     const char *element_name; ///< name of the contained element, if provided
114     const char *unique_name;  ///< unique section name, in case the name is ambiguous
115     AVDictionary *entries_to_show;
116     int show_all_entries;
117 };
118
119 typedef enum {
120     SECTION_ID_NONE = -1,
121     SECTION_ID_CHAPTER,
122     SECTION_ID_CHAPTER_TAGS,
123     SECTION_ID_CHAPTERS,
124     SECTION_ID_ERROR,
125     SECTION_ID_FORMAT,
126     SECTION_ID_FORMAT_TAGS,
127     SECTION_ID_FRAME,
128     SECTION_ID_FRAMES,
129     SECTION_ID_FRAME_TAGS,
130     SECTION_ID_FRAME_SIDE_DATA_LIST,
131     SECTION_ID_FRAME_SIDE_DATA,
132     SECTION_ID_LIBRARY_VERSION,
133     SECTION_ID_LIBRARY_VERSIONS,
134     SECTION_ID_PACKET,
135     SECTION_ID_PACKETS,
136     SECTION_ID_PACKETS_AND_FRAMES,
137     SECTION_ID_PIXEL_FORMAT,
138     SECTION_ID_PIXEL_FORMAT_FLAGS,
139     SECTION_ID_PIXEL_FORMATS,
140     SECTION_ID_PROGRAM_STREAM_DISPOSITION,
141     SECTION_ID_PROGRAM_STREAM_TAGS,
142     SECTION_ID_PROGRAM,
143     SECTION_ID_PROGRAM_STREAMS,
144     SECTION_ID_PROGRAM_STREAM,
145     SECTION_ID_PROGRAM_TAGS,
146     SECTION_ID_PROGRAM_VERSION,
147     SECTION_ID_PROGRAMS,
148     SECTION_ID_ROOT,
149     SECTION_ID_STREAM,
150     SECTION_ID_STREAM_DISPOSITION,
151     SECTION_ID_STREAMS,
152     SECTION_ID_STREAM_TAGS,
153     SECTION_ID_SUBTITLE,
154 } SectionID;
155
156 static struct section sections[] = {
157     [SECTION_ID_CHAPTERS] =           { SECTION_ID_CHAPTERS, "chapters", SECTION_FLAG_IS_ARRAY, { SECTION_ID_CHAPTER, -1 } },
158     [SECTION_ID_CHAPTER] =            { SECTION_ID_CHAPTER, "chapter", 0, { SECTION_ID_CHAPTER_TAGS, -1 } },
159     [SECTION_ID_CHAPTER_TAGS] =       { SECTION_ID_CHAPTER_TAGS, "tags", SECTION_FLAG_HAS_VARIABLE_FIELDS, { -1 }, .element_name = "tag", .unique_name = "chapter_tags" },
160     [SECTION_ID_ERROR] =              { SECTION_ID_ERROR, "error", 0, { -1 } },
161     [SECTION_ID_FORMAT] =             { SECTION_ID_FORMAT, "format", 0, { SECTION_ID_FORMAT_TAGS, -1 } },
162     [SECTION_ID_FORMAT_TAGS] =        { SECTION_ID_FORMAT_TAGS, "tags", SECTION_FLAG_HAS_VARIABLE_FIELDS, { -1 }, .element_name = "tag", .unique_name = "format_tags" },
163     [SECTION_ID_FRAMES] =             { SECTION_ID_FRAMES, "frames", SECTION_FLAG_IS_ARRAY, { SECTION_ID_FRAME, SECTION_ID_SUBTITLE, -1 } },
164     [SECTION_ID_FRAME] =              { SECTION_ID_FRAME, "frame", 0, { SECTION_ID_FRAME_TAGS, SECTION_ID_FRAME_SIDE_DATA_LIST, -1 } },
165     [SECTION_ID_FRAME_TAGS] =         { SECTION_ID_FRAME_TAGS, "tags", SECTION_FLAG_HAS_VARIABLE_FIELDS, { -1 }, .element_name = "tag", .unique_name = "frame_tags" },
166     [SECTION_ID_FRAME_SIDE_DATA_LIST] ={ SECTION_ID_FRAME_SIDE_DATA_LIST, "side_data_list", SECTION_FLAG_IS_ARRAY, { SECTION_ID_FRAME_SIDE_DATA, -1 } },
167     [SECTION_ID_FRAME_SIDE_DATA] =     { SECTION_ID_FRAME_SIDE_DATA, "side_data", 0, { -1 } },
168     [SECTION_ID_LIBRARY_VERSIONS] =   { SECTION_ID_LIBRARY_VERSIONS, "library_versions", SECTION_FLAG_IS_ARRAY, { SECTION_ID_LIBRARY_VERSION, -1 } },
169     [SECTION_ID_LIBRARY_VERSION] =    { SECTION_ID_LIBRARY_VERSION, "library_version", 0, { -1 } },
170     [SECTION_ID_PACKETS] =            { SECTION_ID_PACKETS, "packets", SECTION_FLAG_IS_ARRAY, { SECTION_ID_PACKET, -1} },
171     [SECTION_ID_PACKETS_AND_FRAMES] = { SECTION_ID_PACKETS_AND_FRAMES, "packets_and_frames", SECTION_FLAG_IS_ARRAY, { SECTION_ID_PACKET, -1} },
172     [SECTION_ID_PACKET] =             { SECTION_ID_PACKET, "packet", 0, { -1 } },
173     [SECTION_ID_PIXEL_FORMATS] =      { SECTION_ID_PIXEL_FORMATS, "pixel_formats", SECTION_FLAG_IS_ARRAY, { SECTION_ID_PIXEL_FORMAT, -1 } },
174     [SECTION_ID_PIXEL_FORMAT] =       { SECTION_ID_PIXEL_FORMAT, "pixel_format", 0, { SECTION_ID_PIXEL_FORMAT_FLAGS, -1 } },
175     [SECTION_ID_PIXEL_FORMAT_FLAGS] = { SECTION_ID_PIXEL_FORMAT_FLAGS, "flags", 0, { -1 }, .unique_name = "pixel_format_flags" },
176     [SECTION_ID_PROGRAM_STREAM_DISPOSITION] = { SECTION_ID_PROGRAM_STREAM_DISPOSITION, "disposition", 0, { -1 }, .unique_name = "program_stream_disposition" },
177     [SECTION_ID_PROGRAM_STREAM_TAGS] =        { SECTION_ID_PROGRAM_STREAM_TAGS, "tags", SECTION_FLAG_HAS_VARIABLE_FIELDS, { -1 }, .element_name = "tag", .unique_name = "program_stream_tags" },
178     [SECTION_ID_PROGRAM] =                    { SECTION_ID_PROGRAM, "program", 0, { SECTION_ID_PROGRAM_TAGS, SECTION_ID_PROGRAM_STREAMS, -1 } },
179     [SECTION_ID_PROGRAM_STREAMS] =            { SECTION_ID_PROGRAM_STREAMS, "streams", SECTION_FLAG_IS_ARRAY, { SECTION_ID_PROGRAM_STREAM, -1 }, .unique_name = "program_streams" },
180     [SECTION_ID_PROGRAM_STREAM] =             { SECTION_ID_PROGRAM_STREAM, "stream", 0, { SECTION_ID_PROGRAM_STREAM_DISPOSITION, SECTION_ID_PROGRAM_STREAM_TAGS, -1 }, .unique_name = "program_stream" },
181     [SECTION_ID_PROGRAM_TAGS] =               { SECTION_ID_PROGRAM_TAGS, "tags", SECTION_FLAG_HAS_VARIABLE_FIELDS, { -1 }, .element_name = "tag", .unique_name = "program_tags" },
182     [SECTION_ID_PROGRAM_VERSION] =    { SECTION_ID_PROGRAM_VERSION, "program_version", 0, { -1 } },
183     [SECTION_ID_PROGRAMS] =                   { SECTION_ID_PROGRAMS, "programs", SECTION_FLAG_IS_ARRAY, { SECTION_ID_PROGRAM, -1 } },
184     [SECTION_ID_ROOT] =               { SECTION_ID_ROOT, "root", SECTION_FLAG_IS_WRAPPER,
185                                         { SECTION_ID_CHAPTERS, SECTION_ID_FORMAT, SECTION_ID_FRAMES, SECTION_ID_PROGRAMS, SECTION_ID_STREAMS,
186                                           SECTION_ID_PACKETS, SECTION_ID_ERROR, SECTION_ID_PROGRAM_VERSION, SECTION_ID_LIBRARY_VERSIONS,
187                                           SECTION_ID_PIXEL_FORMATS, -1} },
188     [SECTION_ID_STREAMS] =            { SECTION_ID_STREAMS, "streams", SECTION_FLAG_IS_ARRAY, { SECTION_ID_STREAM, -1 } },
189     [SECTION_ID_STREAM] =             { SECTION_ID_STREAM, "stream", 0, { SECTION_ID_STREAM_DISPOSITION, SECTION_ID_STREAM_TAGS, -1 } },
190     [SECTION_ID_STREAM_DISPOSITION] = { SECTION_ID_STREAM_DISPOSITION, "disposition", 0, { -1 }, .unique_name = "stream_disposition" },
191     [SECTION_ID_STREAM_TAGS] =        { SECTION_ID_STREAM_TAGS, "tags", SECTION_FLAG_HAS_VARIABLE_FIELDS, { -1 }, .element_name = "tag", .unique_name = "stream_tags" },
192     [SECTION_ID_SUBTITLE] =           { SECTION_ID_SUBTITLE, "subtitle", 0, { -1 } },
193 };
194
195 static const OptionDef *options;
196
197 /* FFprobe context */
198 static const char *input_filename;
199 static AVInputFormat *iformat = NULL;
200
201 static struct AVHashContext *hash;
202
203 static const char *const binary_unit_prefixes [] = { "", "Ki", "Mi", "Gi", "Ti", "Pi" };
204 static const char *const decimal_unit_prefixes[] = { "", "K" , "M" , "G" , "T" , "P"  };
205
206 static const char unit_second_str[]         = "s"    ;
207 static const char unit_hertz_str[]          = "Hz"   ;
208 static const char unit_byte_str[]           = "byte" ;
209 static const char unit_bit_per_second_str[] = "bit/s";
210
211 static int nb_streams;
212 static uint64_t *nb_streams_packets;
213 static uint64_t *nb_streams_frames;
214 static int *selected_streams;
215
216 static void ffprobe_cleanup(int ret)
217 {
218     int i;
219     for (i = 0; i < FF_ARRAY_ELEMS(sections); i++)
220         av_dict_free(&(sections[i].entries_to_show));
221 }
222
223 struct unit_value {
224     union { double d; long long int i; } val;
225     const char *unit;
226 };
227
228 static char *value_string(char *buf, int buf_size, struct unit_value uv)
229 {
230     double vald;
231     long long int vali;
232     int show_float = 0;
233
234     if (uv.unit == unit_second_str) {
235         vald = uv.val.d;
236         show_float = 1;
237     } else {
238         vald = vali = uv.val.i;
239     }
240
241     if (uv.unit == unit_second_str && use_value_sexagesimal_format) {
242         double secs;
243         int hours, mins;
244         secs  = vald;
245         mins  = (int)secs / 60;
246         secs  = secs - mins * 60;
247         hours = mins / 60;
248         mins %= 60;
249         snprintf(buf, buf_size, "%d:%02d:%09.6f", hours, mins, secs);
250     } else {
251         const char *prefix_string = "";
252
253         if (use_value_prefix && vald > 1) {
254             long long int index;
255
256             if (uv.unit == unit_byte_str && use_byte_value_binary_prefix) {
257                 index = (long long int) (log2(vald)) / 10;
258                 index = av_clip(index, 0, FF_ARRAY_ELEMS(binary_unit_prefixes) - 1);
259                 vald /= exp2(index * 10);
260                 prefix_string = binary_unit_prefixes[index];
261             } else {
262                 index = (long long int) (log10(vald)) / 3;
263                 index = av_clip(index, 0, FF_ARRAY_ELEMS(decimal_unit_prefixes) - 1);
264                 vald /= pow(10, index * 3);
265                 prefix_string = decimal_unit_prefixes[index];
266             }
267             vali = vald;
268         }
269
270         if (show_float || (use_value_prefix && vald != (long long int)vald))
271             snprintf(buf, buf_size, "%f", vald);
272         else
273             snprintf(buf, buf_size, "%lld", vali);
274         av_strlcatf(buf, buf_size, "%s%s%s", *prefix_string || show_value_unit ? " " : "",
275                  prefix_string, show_value_unit ? uv.unit : "");
276     }
277
278     return buf;
279 }
280
281 /* WRITERS API */
282
283 typedef struct WriterContext WriterContext;
284
285 #define WRITER_FLAG_DISPLAY_OPTIONAL_FIELDS 1
286 #define WRITER_FLAG_PUT_PACKETS_AND_FRAMES_IN_SAME_CHAPTER 2
287
288 typedef enum {
289     WRITER_STRING_VALIDATION_FAIL,
290     WRITER_STRING_VALIDATION_REPLACE,
291     WRITER_STRING_VALIDATION_IGNORE,
292     WRITER_STRING_VALIDATION_NB
293 } StringValidation;
294
295 typedef struct Writer {
296     const AVClass *priv_class;      ///< private class of the writer, if any
297     int priv_size;                  ///< private size for the writer context
298     const char *name;
299
300     int  (*init)  (WriterContext *wctx);
301     void (*uninit)(WriterContext *wctx);
302
303     void (*print_section_header)(WriterContext *wctx);
304     void (*print_section_footer)(WriterContext *wctx);
305     void (*print_integer)       (WriterContext *wctx, const char *, long long int);
306     void (*print_rational)      (WriterContext *wctx, AVRational *q, char *sep);
307     void (*print_string)        (WriterContext *wctx, const char *, const char *);
308     int flags;                  ///< a combination or WRITER_FLAG_*
309 } Writer;
310
311 #define SECTION_MAX_NB_LEVELS 10
312
313 struct WriterContext {
314     const AVClass *class;           ///< class of the writer
315     const Writer *writer;           ///< the Writer of which this is an instance
316     char *name;                     ///< name of this writer instance
317     void *priv;                     ///< private data for use by the filter
318
319     const struct section *sections; ///< array containing all sections
320     int nb_sections;                ///< number of sections
321
322     int level;                      ///< current level, starting from 0
323
324     /** number of the item printed in the given section, starting from 0 */
325     unsigned int nb_item[SECTION_MAX_NB_LEVELS];
326
327     /** section per each level */
328     const struct section *section[SECTION_MAX_NB_LEVELS];
329     AVBPrint section_pbuf[SECTION_MAX_NB_LEVELS]; ///< generic print buffer dedicated to each section,
330                                                   ///  used by various writers
331
332     unsigned int nb_section_packet; ///< number of the packet section in case we are in "packets_and_frames" section
333     unsigned int nb_section_frame;  ///< number of the frame  section in case we are in "packets_and_frames" section
334     unsigned int nb_section_packet_frame; ///< nb_section_packet or nb_section_frame according if is_packets_and_frames
335
336     StringValidation string_validation;
337     char *string_validation_replacement;
338     unsigned int string_validation_utf8_flags;
339 };
340
341 static const char *writer_get_name(void *p)
342 {
343     WriterContext *wctx = p;
344     return wctx->writer->name;
345 }
346
347 #define OFFSET(x) offsetof(WriterContext, x)
348
349 static const AVOption writer_options[] = {
350     { "string_validation", "set string validation mode",
351       OFFSET(string_validation), AV_OPT_TYPE_INT, {.i64=WRITER_STRING_VALIDATION_REPLACE}, 0, WRITER_STRING_VALIDATION_NB-1, .unit = "sv" },
352     { "sv", "set string validation mode",
353       OFFSET(string_validation), AV_OPT_TYPE_INT, {.i64=WRITER_STRING_VALIDATION_REPLACE}, 0, WRITER_STRING_VALIDATION_NB-1, .unit = "sv" },
354     { "ignore",  NULL, 0, AV_OPT_TYPE_CONST, {.i64 = WRITER_STRING_VALIDATION_IGNORE},  .unit = "sv" },
355     { "replace", NULL, 0, AV_OPT_TYPE_CONST, {.i64 = WRITER_STRING_VALIDATION_REPLACE}, .unit = "sv" },
356     { "fail",    NULL, 0, AV_OPT_TYPE_CONST, {.i64 = WRITER_STRING_VALIDATION_FAIL},    .unit = "sv" },
357     { "string_validation_replacement", "set string validation replacement string", OFFSET(string_validation_replacement), AV_OPT_TYPE_STRING, {.str=""}},
358     { "svr", "set string validation replacement string", OFFSET(string_validation_replacement), AV_OPT_TYPE_STRING, {.str="\xEF\xBF\xBD"}},
359     { NULL }
360 };
361
362 static void *writer_child_next(void *obj, void *prev)
363 {
364     WriterContext *ctx = obj;
365     if (!prev && ctx->writer && ctx->writer->priv_class && ctx->priv)
366         return ctx->priv;
367     return NULL;
368 }
369
370 static const AVClass writer_class = {
371     .class_name = "Writer",
372     .item_name  = writer_get_name,
373     .option     = writer_options,
374     .version    = LIBAVUTIL_VERSION_INT,
375     .child_next = writer_child_next,
376 };
377
378 static void writer_close(WriterContext **wctx)
379 {
380     int i;
381
382     if (!*wctx)
383         return;
384
385     if ((*wctx)->writer->uninit)
386         (*wctx)->writer->uninit(*wctx);
387     for (i = 0; i < SECTION_MAX_NB_LEVELS; i++)
388         av_bprint_finalize(&(*wctx)->section_pbuf[i], NULL);
389     if ((*wctx)->writer->priv_class)
390         av_opt_free((*wctx)->priv);
391     av_freep(&((*wctx)->priv));
392     av_opt_free(*wctx);
393     av_freep(wctx);
394 }
395
396 static void bprint_bytes(AVBPrint *bp, const uint8_t *ubuf, size_t ubuf_size)
397 {
398     int i;
399     av_bprintf(bp, "0X");
400     for (i = 0; i < ubuf_size; i++)
401         av_bprintf(bp, "%02X", ubuf[i]);
402 }
403
404
405 static int writer_open(WriterContext **wctx, const Writer *writer, const char *args,
406                        const struct section *sections, int nb_sections)
407 {
408     int i, ret = 0;
409
410     if (!(*wctx = av_mallocz(sizeof(WriterContext)))) {
411         ret = AVERROR(ENOMEM);
412         goto fail;
413     }
414
415     if (!((*wctx)->priv = av_mallocz(writer->priv_size))) {
416         ret = AVERROR(ENOMEM);
417         goto fail;
418     }
419
420     (*wctx)->class = &writer_class;
421     (*wctx)->writer = writer;
422     (*wctx)->level = -1;
423     (*wctx)->sections = sections;
424     (*wctx)->nb_sections = nb_sections;
425
426     av_opt_set_defaults(*wctx);
427
428     if (writer->priv_class) {
429         void *priv_ctx = (*wctx)->priv;
430         *((const AVClass **)priv_ctx) = writer->priv_class;
431         av_opt_set_defaults(priv_ctx);
432     }
433
434     /* convert options to dictionary */
435     if (args) {
436         AVDictionary *opts = NULL;
437         AVDictionaryEntry *opt = NULL;
438
439         if ((ret = av_dict_parse_string(&opts, args, "=", ":", 0)) < 0) {
440             av_log(*wctx, AV_LOG_ERROR, "Failed to parse option string '%s' provided to writer context\n", args);
441             av_dict_free(&opts);
442             goto fail;
443         }
444
445         while ((opt = av_dict_get(opts, "", opt, AV_DICT_IGNORE_SUFFIX))) {
446             if ((ret = av_opt_set(*wctx, opt->key, opt->value, AV_OPT_SEARCH_CHILDREN)) < 0) {
447                 av_log(*wctx, AV_LOG_ERROR, "Failed to set option '%s' with value '%s' provided to writer context\n",
448                        opt->key, opt->value);
449                 av_dict_free(&opts);
450                 goto fail;
451             }
452         }
453
454         av_dict_free(&opts);
455     }
456
457     /* validate replace string */
458     {
459         const uint8_t *p = (*wctx)->string_validation_replacement;
460         const uint8_t *endp = p + strlen(p);
461         while (*p) {
462             const uint8_t *p0 = p;
463             int32_t code;
464             ret = av_utf8_decode(&code, &p, endp, (*wctx)->string_validation_utf8_flags);
465             if (ret < 0) {
466                 AVBPrint bp;
467                 av_bprint_init(&bp, 0, AV_BPRINT_SIZE_AUTOMATIC);
468                 bprint_bytes(&bp, p0, p-p0),
469                     av_log(wctx, AV_LOG_ERROR,
470                            "Invalid UTF8 sequence %s found in string validation replace '%s'\n",
471                            bp.str, (*wctx)->string_validation_replacement);
472                 return ret;
473             }
474         }
475     }
476
477     for (i = 0; i < SECTION_MAX_NB_LEVELS; i++)
478         av_bprint_init(&(*wctx)->section_pbuf[i], 1, AV_BPRINT_SIZE_UNLIMITED);
479
480     if ((*wctx)->writer->init)
481         ret = (*wctx)->writer->init(*wctx);
482     if (ret < 0)
483         goto fail;
484
485     return 0;
486
487 fail:
488     writer_close(wctx);
489     return ret;
490 }
491
492 static inline void writer_print_section_header(WriterContext *wctx,
493                                                int section_id)
494 {
495     int parent_section_id;
496     wctx->level++;
497     av_assert0(wctx->level < SECTION_MAX_NB_LEVELS);
498     parent_section_id = wctx->level ?
499         (wctx->section[wctx->level-1])->id : SECTION_ID_NONE;
500
501     wctx->nb_item[wctx->level] = 0;
502     wctx->section[wctx->level] = &wctx->sections[section_id];
503
504     if (section_id == SECTION_ID_PACKETS_AND_FRAMES) {
505         wctx->nb_section_packet = wctx->nb_section_frame =
506         wctx->nb_section_packet_frame = 0;
507     } else if (parent_section_id == SECTION_ID_PACKETS_AND_FRAMES) {
508         wctx->nb_section_packet_frame = section_id == SECTION_ID_PACKET ?
509             wctx->nb_section_packet : wctx->nb_section_frame;
510     }
511
512     if (wctx->writer->print_section_header)
513         wctx->writer->print_section_header(wctx);
514 }
515
516 static inline void writer_print_section_footer(WriterContext *wctx)
517 {
518     int section_id = wctx->section[wctx->level]->id;
519     int parent_section_id = wctx->level ?
520         wctx->section[wctx->level-1]->id : SECTION_ID_NONE;
521
522     if (parent_section_id != SECTION_ID_NONE)
523         wctx->nb_item[wctx->level-1]++;
524     if (parent_section_id == SECTION_ID_PACKETS_AND_FRAMES) {
525         if (section_id == SECTION_ID_PACKET) wctx->nb_section_packet++;
526         else                                     wctx->nb_section_frame++;
527     }
528     if (wctx->writer->print_section_footer)
529         wctx->writer->print_section_footer(wctx);
530     wctx->level--;
531 }
532
533 static inline void writer_print_integer(WriterContext *wctx,
534                                         const char *key, long long int val)
535 {
536     const struct section *section = wctx->section[wctx->level];
537
538     if (section->show_all_entries || av_dict_get(section->entries_to_show, key, NULL, 0)) {
539         wctx->writer->print_integer(wctx, key, val);
540         wctx->nb_item[wctx->level]++;
541     }
542 }
543
544 static inline int validate_string(WriterContext *wctx, char **dstp, const char *src)
545 {
546     const uint8_t *p, *endp;
547     AVBPrint dstbuf;
548     int invalid_chars_nb = 0, ret = 0;
549
550     av_bprint_init(&dstbuf, 0, AV_BPRINT_SIZE_UNLIMITED);
551
552     endp = src + strlen(src);
553     for (p = (uint8_t *)src; *p;) {
554         uint32_t code;
555         int invalid = 0;
556         const uint8_t *p0 = p;
557
558         if (av_utf8_decode(&code, &p, endp, wctx->string_validation_utf8_flags) < 0) {
559             AVBPrint bp;
560             av_bprint_init(&bp, 0, AV_BPRINT_SIZE_AUTOMATIC);
561             bprint_bytes(&bp, p0, p-p0);
562             av_log(wctx, AV_LOG_DEBUG,
563                    "Invalid UTF-8 sequence %s found in string '%s'\n", bp.str, src);
564             invalid = 1;
565         }
566
567         if (invalid) {
568             invalid_chars_nb++;
569
570             switch (wctx->string_validation) {
571             case WRITER_STRING_VALIDATION_FAIL:
572                 av_log(wctx, AV_LOG_ERROR,
573                        "Invalid UTF-8 sequence found in string '%s'\n", src);
574                 ret = AVERROR_INVALIDDATA;
575                 goto end;
576                 break;
577
578             case WRITER_STRING_VALIDATION_REPLACE:
579                 av_bprintf(&dstbuf, "%s", wctx->string_validation_replacement);
580                 break;
581             }
582         }
583
584         if (!invalid || wctx->string_validation == WRITER_STRING_VALIDATION_IGNORE)
585             av_bprint_append_data(&dstbuf, p0, p-p0);
586     }
587
588     if (invalid_chars_nb && wctx->string_validation == WRITER_STRING_VALIDATION_REPLACE) {
589         av_log(wctx, AV_LOG_WARNING,
590                "%d invalid UTF-8 sequence(s) found in string '%s', replaced with '%s'\n",
591                invalid_chars_nb, src, wctx->string_validation_replacement);
592     }
593
594 end:
595     av_bprint_finalize(&dstbuf, dstp);
596     return ret;
597 }
598
599 #define PRINT_STRING_OPT      1
600 #define PRINT_STRING_VALIDATE 2
601
602 static inline int writer_print_string(WriterContext *wctx,
603                                       const char *key, const char *val, int flags)
604 {
605     const struct section *section = wctx->section[wctx->level];
606     int ret = 0;
607
608     if ((flags & PRINT_STRING_OPT)
609         && !(wctx->writer->flags & WRITER_FLAG_DISPLAY_OPTIONAL_FIELDS))
610         return 0;
611
612     if (section->show_all_entries || av_dict_get(section->entries_to_show, key, NULL, 0)) {
613         if (flags & PRINT_STRING_VALIDATE) {
614             char *key1 = NULL, *val1 = NULL;
615             ret = validate_string(wctx, &key1, key);
616             if (ret < 0) goto end;
617             ret = validate_string(wctx, &val1, val);
618             if (ret < 0) goto end;
619             wctx->writer->print_string(wctx, key1, val1);
620         end:
621             if (ret < 0) {
622                 av_log(wctx, AV_LOG_ERROR,
623                        "Invalid key=value string combination %s=%s in section %s\n",
624                        key, val, section->unique_name);
625             }
626             av_free(key1);
627             av_free(val1);
628         } else {
629             wctx->writer->print_string(wctx, key, val);
630         }
631
632         wctx->nb_item[wctx->level]++;
633     }
634
635     return ret;
636 }
637
638 static inline void writer_print_rational(WriterContext *wctx,
639                                          const char *key, AVRational q, char sep)
640 {
641     AVBPrint buf;
642     av_bprint_init(&buf, 0, AV_BPRINT_SIZE_AUTOMATIC);
643     av_bprintf(&buf, "%d%c%d", q.num, sep, q.den);
644     writer_print_string(wctx, key, buf.str, 0);
645 }
646
647 static void writer_print_time(WriterContext *wctx, const char *key,
648                               int64_t ts, const AVRational *time_base, int is_duration)
649 {
650     char buf[128];
651
652     if ((!is_duration && ts == AV_NOPTS_VALUE) || (is_duration && ts == 0)) {
653         writer_print_string(wctx, key, "N/A", PRINT_STRING_OPT);
654     } else {
655         double d = ts * av_q2d(*time_base);
656         struct unit_value uv;
657         uv.val.d = d;
658         uv.unit = unit_second_str;
659         value_string(buf, sizeof(buf), uv);
660         writer_print_string(wctx, key, buf, 0);
661     }
662 }
663
664 static void writer_print_ts(WriterContext *wctx, const char *key, int64_t ts, int is_duration)
665 {
666     if ((!is_duration && ts == AV_NOPTS_VALUE) || (is_duration && ts == 0)) {
667         writer_print_string(wctx, key, "N/A", PRINT_STRING_OPT);
668     } else {
669         writer_print_integer(wctx, key, ts);
670     }
671 }
672
673 static void writer_print_data(WriterContext *wctx, const char *name,
674                               uint8_t *data, int size)
675 {
676     AVBPrint bp;
677     int offset = 0, l, i;
678
679     av_bprint_init(&bp, 0, AV_BPRINT_SIZE_UNLIMITED);
680     av_bprintf(&bp, "\n");
681     while (size) {
682         av_bprintf(&bp, "%08x: ", offset);
683         l = FFMIN(size, 16);
684         for (i = 0; i < l; i++) {
685             av_bprintf(&bp, "%02x", data[i]);
686             if (i & 1)
687                 av_bprintf(&bp, " ");
688         }
689         av_bprint_chars(&bp, ' ', 41 - 2 * i - i / 2);
690         for (i = 0; i < l; i++)
691             av_bprint_chars(&bp, data[i] - 32U < 95 ? data[i] : '.', 1);
692         av_bprintf(&bp, "\n");
693         offset += l;
694         data   += l;
695         size   -= l;
696     }
697     writer_print_string(wctx, name, bp.str, 0);
698     av_bprint_finalize(&bp, NULL);
699 }
700
701 static void writer_print_data_hash(WriterContext *wctx, const char *name,
702                                    uint8_t *data, int size)
703 {
704     char *p, buf[AV_HASH_MAX_SIZE * 2 + 64] = { 0 };
705
706     if (!hash)
707         return;
708     av_hash_init(hash);
709     av_hash_update(hash, data, size);
710     snprintf(buf, sizeof(buf), "%s:", av_hash_get_name(hash));
711     p = buf + strlen(buf);
712     av_hash_final_hex(hash, p, buf + sizeof(buf) - p);
713     writer_print_string(wctx, name, buf, 0);
714 }
715
716 #define MAX_REGISTERED_WRITERS_NB 64
717
718 static const Writer *registered_writers[MAX_REGISTERED_WRITERS_NB + 1];
719
720 static int writer_register(const Writer *writer)
721 {
722     static int next_registered_writer_idx = 0;
723
724     if (next_registered_writer_idx == MAX_REGISTERED_WRITERS_NB)
725         return AVERROR(ENOMEM);
726
727     registered_writers[next_registered_writer_idx++] = writer;
728     return 0;
729 }
730
731 static const Writer *writer_get_by_name(const char *name)
732 {
733     int i;
734
735     for (i = 0; registered_writers[i]; i++)
736         if (!strcmp(registered_writers[i]->name, name))
737             return registered_writers[i];
738
739     return NULL;
740 }
741
742
743 /* WRITERS */
744
745 #define DEFINE_WRITER_CLASS(name)                   \
746 static const char *name##_get_name(void *ctx)       \
747 {                                                   \
748     return #name ;                                  \
749 }                                                   \
750 static const AVClass name##_class = {               \
751     .class_name = #name,                            \
752     .item_name  = name##_get_name,                  \
753     .option     = name##_options                    \
754 }
755
756 /* Default output */
757
758 typedef struct DefaultContext {
759     const AVClass *class;
760     int nokey;
761     int noprint_wrappers;
762     int nested_section[SECTION_MAX_NB_LEVELS];
763 } DefaultContext;
764
765 #undef OFFSET
766 #define OFFSET(x) offsetof(DefaultContext, x)
767
768 static const AVOption default_options[] = {
769     { "noprint_wrappers", "do not print headers and footers", OFFSET(noprint_wrappers), AV_OPT_TYPE_INT, {.i64=0}, 0, 1 },
770     { "nw",               "do not print headers and footers", OFFSET(noprint_wrappers), AV_OPT_TYPE_INT, {.i64=0}, 0, 1 },
771     { "nokey",          "force no key printing",     OFFSET(nokey),          AV_OPT_TYPE_INT, {.i64=0}, 0, 1 },
772     { "nk",             "force no key printing",     OFFSET(nokey),          AV_OPT_TYPE_INT, {.i64=0}, 0, 1 },
773     {NULL},
774 };
775
776 DEFINE_WRITER_CLASS(default);
777
778 /* lame uppercasing routine, assumes the string is lower case ASCII */
779 static inline char *upcase_string(char *dst, size_t dst_size, const char *src)
780 {
781     int i;
782     for (i = 0; src[i] && i < dst_size-1; i++)
783         dst[i] = av_toupper(src[i]);
784     dst[i] = 0;
785     return dst;
786 }
787
788 static void default_print_section_header(WriterContext *wctx)
789 {
790     DefaultContext *def = wctx->priv;
791     char buf[32];
792     const struct section *section = wctx->section[wctx->level];
793     const struct section *parent_section = wctx->level ?
794         wctx->section[wctx->level-1] : NULL;
795
796     av_bprint_clear(&wctx->section_pbuf[wctx->level]);
797     if (parent_section &&
798         !(parent_section->flags & (SECTION_FLAG_IS_WRAPPER|SECTION_FLAG_IS_ARRAY))) {
799         def->nested_section[wctx->level] = 1;
800         av_bprintf(&wctx->section_pbuf[wctx->level], "%s%s:",
801                    wctx->section_pbuf[wctx->level-1].str,
802                    upcase_string(buf, sizeof(buf),
803                                  av_x_if_null(section->element_name, section->name)));
804     }
805
806     if (def->noprint_wrappers || def->nested_section[wctx->level])
807         return;
808
809     if (!(section->flags & (SECTION_FLAG_IS_WRAPPER|SECTION_FLAG_IS_ARRAY)))
810         printf("[%s]\n", upcase_string(buf, sizeof(buf), section->name));
811 }
812
813 static void default_print_section_footer(WriterContext *wctx)
814 {
815     DefaultContext *def = wctx->priv;
816     const struct section *section = wctx->section[wctx->level];
817     char buf[32];
818
819     if (def->noprint_wrappers || def->nested_section[wctx->level])
820         return;
821
822     if (!(section->flags & (SECTION_FLAG_IS_WRAPPER|SECTION_FLAG_IS_ARRAY)))
823         printf("[/%s]\n", upcase_string(buf, sizeof(buf), section->name));
824 }
825
826 static void default_print_str(WriterContext *wctx, const char *key, const char *value)
827 {
828     DefaultContext *def = wctx->priv;
829
830     if (!def->nokey)
831         printf("%s%s=", wctx->section_pbuf[wctx->level].str, key);
832     printf("%s\n", value);
833 }
834
835 static void default_print_int(WriterContext *wctx, const char *key, long long int value)
836 {
837     DefaultContext *def = wctx->priv;
838
839     if (!def->nokey)
840         printf("%s%s=", wctx->section_pbuf[wctx->level].str, key);
841     printf("%lld\n", value);
842 }
843
844 static const Writer default_writer = {
845     .name                  = "default",
846     .priv_size             = sizeof(DefaultContext),
847     .print_section_header  = default_print_section_header,
848     .print_section_footer  = default_print_section_footer,
849     .print_integer         = default_print_int,
850     .print_string          = default_print_str,
851     .flags = WRITER_FLAG_DISPLAY_OPTIONAL_FIELDS,
852     .priv_class            = &default_class,
853 };
854
855 /* Compact output */
856
857 /**
858  * Apply C-language-like string escaping.
859  */
860 static const char *c_escape_str(AVBPrint *dst, const char *src, const char sep, void *log_ctx)
861 {
862     const char *p;
863
864     for (p = src; *p; p++) {
865         switch (*p) {
866         case '\b': av_bprintf(dst, "%s", "\\b");  break;
867         case '\f': av_bprintf(dst, "%s", "\\f");  break;
868         case '\n': av_bprintf(dst, "%s", "\\n");  break;
869         case '\r': av_bprintf(dst, "%s", "\\r");  break;
870         case '\\': av_bprintf(dst, "%s", "\\\\"); break;
871         default:
872             if (*p == sep)
873                 av_bprint_chars(dst, '\\', 1);
874             av_bprint_chars(dst, *p, 1);
875         }
876     }
877     return dst->str;
878 }
879
880 /**
881  * Quote fields containing special characters, check RFC4180.
882  */
883 static const char *csv_escape_str(AVBPrint *dst, const char *src, const char sep, void *log_ctx)
884 {
885     char meta_chars[] = { sep, '"', '\n', '\r', '\0' };
886     int needs_quoting = !!src[strcspn(src, meta_chars)];
887
888     if (needs_quoting)
889         av_bprint_chars(dst, '"', 1);
890
891     for (; *src; src++) {
892         if (*src == '"')
893             av_bprint_chars(dst, '"', 1);
894         av_bprint_chars(dst, *src, 1);
895     }
896     if (needs_quoting)
897         av_bprint_chars(dst, '"', 1);
898     return dst->str;
899 }
900
901 static const char *none_escape_str(AVBPrint *dst, const char *src, const char sep, void *log_ctx)
902 {
903     return src;
904 }
905
906 typedef struct CompactContext {
907     const AVClass *class;
908     char *item_sep_str;
909     char item_sep;
910     int nokey;
911     int print_section;
912     char *escape_mode_str;
913     const char * (*escape_str)(AVBPrint *dst, const char *src, const char sep, void *log_ctx);
914     int nested_section[SECTION_MAX_NB_LEVELS];
915     int has_nested_elems[SECTION_MAX_NB_LEVELS];
916     int terminate_line[SECTION_MAX_NB_LEVELS];
917 } CompactContext;
918
919 #undef OFFSET
920 #define OFFSET(x) offsetof(CompactContext, x)
921
922 static const AVOption compact_options[]= {
923     {"item_sep", "set item separator",    OFFSET(item_sep_str),    AV_OPT_TYPE_STRING, {.str="|"},  CHAR_MIN, CHAR_MAX },
924     {"s",        "set item separator",    OFFSET(item_sep_str),    AV_OPT_TYPE_STRING, {.str="|"},  CHAR_MIN, CHAR_MAX },
925     {"nokey",    "force no key printing", OFFSET(nokey),           AV_OPT_TYPE_INT,    {.i64=0},    0,        1        },
926     {"nk",       "force no key printing", OFFSET(nokey),           AV_OPT_TYPE_INT,    {.i64=0},    0,        1        },
927     {"escape",   "set escape mode",       OFFSET(escape_mode_str), AV_OPT_TYPE_STRING, {.str="c"},  CHAR_MIN, CHAR_MAX },
928     {"e",        "set escape mode",       OFFSET(escape_mode_str), AV_OPT_TYPE_STRING, {.str="c"},  CHAR_MIN, CHAR_MAX },
929     {"print_section", "print section name", OFFSET(print_section), AV_OPT_TYPE_INT,    {.i64=1},    0,        1        },
930     {"p",             "print section name", OFFSET(print_section), AV_OPT_TYPE_INT,    {.i64=1},    0,        1        },
931     {NULL},
932 };
933
934 DEFINE_WRITER_CLASS(compact);
935
936 static av_cold int compact_init(WriterContext *wctx)
937 {
938     CompactContext *compact = wctx->priv;
939
940     if (strlen(compact->item_sep_str) != 1) {
941         av_log(wctx, AV_LOG_ERROR, "Item separator '%s' specified, but must contain a single character\n",
942                compact->item_sep_str);
943         return AVERROR(EINVAL);
944     }
945     compact->item_sep = compact->item_sep_str[0];
946
947     if      (!strcmp(compact->escape_mode_str, "none")) compact->escape_str = none_escape_str;
948     else if (!strcmp(compact->escape_mode_str, "c"   )) compact->escape_str = c_escape_str;
949     else if (!strcmp(compact->escape_mode_str, "csv" )) compact->escape_str = csv_escape_str;
950     else {
951         av_log(wctx, AV_LOG_ERROR, "Unknown escape mode '%s'\n", compact->escape_mode_str);
952         return AVERROR(EINVAL);
953     }
954
955     return 0;
956 }
957
958 static void compact_print_section_header(WriterContext *wctx)
959 {
960     CompactContext *compact = wctx->priv;
961     const struct section *section = wctx->section[wctx->level];
962     const struct section *parent_section = wctx->level ?
963         wctx->section[wctx->level-1] : NULL;
964     compact->terminate_line[wctx->level] = 1;
965     compact->has_nested_elems[wctx->level] = 0;
966
967     av_bprint_clear(&wctx->section_pbuf[wctx->level]);
968     if (!(section->flags & SECTION_FLAG_IS_ARRAY) && parent_section &&
969         !(parent_section->flags & (SECTION_FLAG_IS_WRAPPER|SECTION_FLAG_IS_ARRAY))) {
970         compact->nested_section[wctx->level] = 1;
971         compact->has_nested_elems[wctx->level-1] = 1;
972         av_bprintf(&wctx->section_pbuf[wctx->level], "%s%s:",
973                    wctx->section_pbuf[wctx->level-1].str,
974                    (char *)av_x_if_null(section->element_name, section->name));
975         wctx->nb_item[wctx->level] = wctx->nb_item[wctx->level-1];
976     } else {
977         if (parent_section && compact->has_nested_elems[wctx->level-1] &&
978             (section->flags & SECTION_FLAG_IS_ARRAY)) {
979             compact->terminate_line[wctx->level-1] = 0;
980             printf("\n");
981         }
982         if (compact->print_section &&
983             !(section->flags & (SECTION_FLAG_IS_WRAPPER|SECTION_FLAG_IS_ARRAY)))
984             printf("%s%c", section->name, compact->item_sep);
985     }
986 }
987
988 static void compact_print_section_footer(WriterContext *wctx)
989 {
990     CompactContext *compact = wctx->priv;
991
992     if (!compact->nested_section[wctx->level] &&
993         compact->terminate_line[wctx->level] &&
994         !(wctx->section[wctx->level]->flags & (SECTION_FLAG_IS_WRAPPER|SECTION_FLAG_IS_ARRAY)))
995         printf("\n");
996 }
997
998 static void compact_print_str(WriterContext *wctx, const char *key, const char *value)
999 {
1000     CompactContext *compact = wctx->priv;
1001     AVBPrint buf;
1002
1003     if (wctx->nb_item[wctx->level]) printf("%c", compact->item_sep);
1004     if (!compact->nokey)
1005         printf("%s%s=", wctx->section_pbuf[wctx->level].str, key);
1006     av_bprint_init(&buf, 1, AV_BPRINT_SIZE_UNLIMITED);
1007     printf("%s", compact->escape_str(&buf, value, compact->item_sep, wctx));
1008     av_bprint_finalize(&buf, NULL);
1009 }
1010
1011 static void compact_print_int(WriterContext *wctx, const char *key, long long int value)
1012 {
1013     CompactContext *compact = wctx->priv;
1014
1015     if (wctx->nb_item[wctx->level]) printf("%c", compact->item_sep);
1016     if (!compact->nokey)
1017         printf("%s%s=", wctx->section_pbuf[wctx->level].str, key);
1018     printf("%lld", value);
1019 }
1020
1021 static const Writer compact_writer = {
1022     .name                 = "compact",
1023     .priv_size            = sizeof(CompactContext),
1024     .init                 = compact_init,
1025     .print_section_header = compact_print_section_header,
1026     .print_section_footer = compact_print_section_footer,
1027     .print_integer        = compact_print_int,
1028     .print_string         = compact_print_str,
1029     .flags = WRITER_FLAG_DISPLAY_OPTIONAL_FIELDS,
1030     .priv_class           = &compact_class,
1031 };
1032
1033 /* CSV output */
1034
1035 #undef OFFSET
1036 #define OFFSET(x) offsetof(CompactContext, x)
1037
1038 static const AVOption csv_options[] = {
1039     {"item_sep", "set item separator",    OFFSET(item_sep_str),    AV_OPT_TYPE_STRING, {.str=","},  CHAR_MIN, CHAR_MAX },
1040     {"s",        "set item separator",    OFFSET(item_sep_str),    AV_OPT_TYPE_STRING, {.str=","},  CHAR_MIN, CHAR_MAX },
1041     {"nokey",    "force no key printing", OFFSET(nokey),           AV_OPT_TYPE_INT,    {.i64=1},    0,        1        },
1042     {"nk",       "force no key printing", OFFSET(nokey),           AV_OPT_TYPE_INT,    {.i64=1},    0,        1        },
1043     {"escape",   "set escape mode",       OFFSET(escape_mode_str), AV_OPT_TYPE_STRING, {.str="csv"}, CHAR_MIN, CHAR_MAX },
1044     {"e",        "set escape mode",       OFFSET(escape_mode_str), AV_OPT_TYPE_STRING, {.str="csv"}, CHAR_MIN, CHAR_MAX },
1045     {"print_section", "print section name", OFFSET(print_section), AV_OPT_TYPE_INT,    {.i64=1},    0,        1        },
1046     {"p",             "print section name", OFFSET(print_section), AV_OPT_TYPE_INT,    {.i64=1},    0,        1        },
1047     {NULL},
1048 };
1049
1050 DEFINE_WRITER_CLASS(csv);
1051
1052 static const Writer csv_writer = {
1053     .name                 = "csv",
1054     .priv_size            = sizeof(CompactContext),
1055     .init                 = compact_init,
1056     .print_section_header = compact_print_section_header,
1057     .print_section_footer = compact_print_section_footer,
1058     .print_integer        = compact_print_int,
1059     .print_string         = compact_print_str,
1060     .flags = WRITER_FLAG_DISPLAY_OPTIONAL_FIELDS,
1061     .priv_class           = &csv_class,
1062 };
1063
1064 /* Flat output */
1065
1066 typedef struct FlatContext {
1067     const AVClass *class;
1068     const char *sep_str;
1069     char sep;
1070     int hierarchical;
1071 } FlatContext;
1072
1073 #undef OFFSET
1074 #define OFFSET(x) offsetof(FlatContext, x)
1075
1076 static const AVOption flat_options[]= {
1077     {"sep_char", "set separator",    OFFSET(sep_str),    AV_OPT_TYPE_STRING, {.str="."},  CHAR_MIN, CHAR_MAX },
1078     {"s",        "set separator",    OFFSET(sep_str),    AV_OPT_TYPE_STRING, {.str="."},  CHAR_MIN, CHAR_MAX },
1079     {"hierarchical", "specify if the section specification should be hierarchical", OFFSET(hierarchical), AV_OPT_TYPE_INT, {.i64=1}, 0, 1 },
1080     {"h",           "specify if the section specification should be hierarchical", OFFSET(hierarchical), AV_OPT_TYPE_INT, {.i64=1}, 0, 1 },
1081     {NULL},
1082 };
1083
1084 DEFINE_WRITER_CLASS(flat);
1085
1086 static av_cold int flat_init(WriterContext *wctx)
1087 {
1088     FlatContext *flat = wctx->priv;
1089
1090     if (strlen(flat->sep_str) != 1) {
1091         av_log(wctx, AV_LOG_ERROR, "Item separator '%s' specified, but must contain a single character\n",
1092                flat->sep_str);
1093         return AVERROR(EINVAL);
1094     }
1095     flat->sep = flat->sep_str[0];
1096
1097     return 0;
1098 }
1099
1100 static const char *flat_escape_key_str(AVBPrint *dst, const char *src, const char sep)
1101 {
1102     const char *p;
1103
1104     for (p = src; *p; p++) {
1105         if (!((*p >= '0' && *p <= '9') ||
1106               (*p >= 'a' && *p <= 'z') ||
1107               (*p >= 'A' && *p <= 'Z')))
1108             av_bprint_chars(dst, '_', 1);
1109         else
1110             av_bprint_chars(dst, *p, 1);
1111     }
1112     return dst->str;
1113 }
1114
1115 static const char *flat_escape_value_str(AVBPrint *dst, const char *src)
1116 {
1117     const char *p;
1118
1119     for (p = src; *p; p++) {
1120         switch (*p) {
1121         case '\n': av_bprintf(dst, "%s", "\\n");  break;
1122         case '\r': av_bprintf(dst, "%s", "\\r");  break;
1123         case '\\': av_bprintf(dst, "%s", "\\\\"); break;
1124         case '"':  av_bprintf(dst, "%s", "\\\""); break;
1125         case '`':  av_bprintf(dst, "%s", "\\`");  break;
1126         case '$':  av_bprintf(dst, "%s", "\\$");  break;
1127         default:   av_bprint_chars(dst, *p, 1);   break;
1128         }
1129     }
1130     return dst->str;
1131 }
1132
1133 static void flat_print_section_header(WriterContext *wctx)
1134 {
1135     FlatContext *flat = wctx->priv;
1136     AVBPrint *buf = &wctx->section_pbuf[wctx->level];
1137     const struct section *section = wctx->section[wctx->level];
1138     const struct section *parent_section = wctx->level ?
1139         wctx->section[wctx->level-1] : NULL;
1140
1141     /* build section header */
1142     av_bprint_clear(buf);
1143     if (!parent_section)
1144         return;
1145     av_bprintf(buf, "%s", wctx->section_pbuf[wctx->level-1].str);
1146
1147     if (flat->hierarchical ||
1148         !(section->flags & (SECTION_FLAG_IS_ARRAY|SECTION_FLAG_IS_WRAPPER))) {
1149         av_bprintf(buf, "%s%s", wctx->section[wctx->level]->name, flat->sep_str);
1150
1151         if (parent_section->flags & SECTION_FLAG_IS_ARRAY) {
1152             int n = parent_section->id == SECTION_ID_PACKETS_AND_FRAMES ?
1153                 wctx->nb_section_packet_frame : wctx->nb_item[wctx->level-1];
1154             av_bprintf(buf, "%d%s", n, flat->sep_str);
1155         }
1156     }
1157 }
1158
1159 static void flat_print_int(WriterContext *wctx, const char *key, long long int value)
1160 {
1161     printf("%s%s=%lld\n", wctx->section_pbuf[wctx->level].str, key, value);
1162 }
1163
1164 static void flat_print_str(WriterContext *wctx, const char *key, const char *value)
1165 {
1166     FlatContext *flat = wctx->priv;
1167     AVBPrint buf;
1168
1169     printf("%s", wctx->section_pbuf[wctx->level].str);
1170     av_bprint_init(&buf, 1, AV_BPRINT_SIZE_UNLIMITED);
1171     printf("%s=", flat_escape_key_str(&buf, key, flat->sep));
1172     av_bprint_clear(&buf);
1173     printf("\"%s\"\n", flat_escape_value_str(&buf, value));
1174     av_bprint_finalize(&buf, NULL);
1175 }
1176
1177 static const Writer flat_writer = {
1178     .name                  = "flat",
1179     .priv_size             = sizeof(FlatContext),
1180     .init                  = flat_init,
1181     .print_section_header  = flat_print_section_header,
1182     .print_integer         = flat_print_int,
1183     .print_string          = flat_print_str,
1184     .flags = WRITER_FLAG_DISPLAY_OPTIONAL_FIELDS|WRITER_FLAG_PUT_PACKETS_AND_FRAMES_IN_SAME_CHAPTER,
1185     .priv_class            = &flat_class,
1186 };
1187
1188 /* INI format output */
1189
1190 typedef struct {
1191     const AVClass *class;
1192     int hierarchical;
1193 } INIContext;
1194
1195 #undef OFFSET
1196 #define OFFSET(x) offsetof(INIContext, x)
1197
1198 static const AVOption ini_options[] = {
1199     {"hierarchical", "specify if the section specification should be hierarchical", OFFSET(hierarchical), AV_OPT_TYPE_INT, {.i64=1}, 0, 1 },
1200     {"h",           "specify if the section specification should be hierarchical", OFFSET(hierarchical), AV_OPT_TYPE_INT, {.i64=1}, 0, 1 },
1201     {NULL},
1202 };
1203
1204 DEFINE_WRITER_CLASS(ini);
1205
1206 static char *ini_escape_str(AVBPrint *dst, const char *src)
1207 {
1208     int i = 0;
1209     char c = 0;
1210
1211     while (c = src[i++]) {
1212         switch (c) {
1213         case '\b': av_bprintf(dst, "%s", "\\b"); break;
1214         case '\f': av_bprintf(dst, "%s", "\\f"); break;
1215         case '\n': av_bprintf(dst, "%s", "\\n"); break;
1216         case '\r': av_bprintf(dst, "%s", "\\r"); break;
1217         case '\t': av_bprintf(dst, "%s", "\\t"); break;
1218         case '\\':
1219         case '#' :
1220         case '=' :
1221         case ':' : av_bprint_chars(dst, '\\', 1);
1222         default:
1223             if ((unsigned char)c < 32)
1224                 av_bprintf(dst, "\\x00%02x", c & 0xff);
1225             else
1226                 av_bprint_chars(dst, c, 1);
1227             break;
1228         }
1229     }
1230     return dst->str;
1231 }
1232
1233 static void ini_print_section_header(WriterContext *wctx)
1234 {
1235     INIContext *ini = wctx->priv;
1236     AVBPrint *buf = &wctx->section_pbuf[wctx->level];
1237     const struct section *section = wctx->section[wctx->level];
1238     const struct section *parent_section = wctx->level ?
1239         wctx->section[wctx->level-1] : NULL;
1240
1241     av_bprint_clear(buf);
1242     if (!parent_section) {
1243         printf("# ffprobe output\n\n");
1244         return;
1245     }
1246
1247     if (wctx->nb_item[wctx->level-1])
1248         printf("\n");
1249
1250     av_bprintf(buf, "%s", wctx->section_pbuf[wctx->level-1].str);
1251     if (ini->hierarchical ||
1252         !(section->flags & (SECTION_FLAG_IS_ARRAY|SECTION_FLAG_IS_WRAPPER))) {
1253         av_bprintf(buf, "%s%s", buf->str[0] ? "." : "", wctx->section[wctx->level]->name);
1254
1255         if (parent_section->flags & SECTION_FLAG_IS_ARRAY) {
1256             int n = parent_section->id == SECTION_ID_PACKETS_AND_FRAMES ?
1257                 wctx->nb_section_packet_frame : wctx->nb_item[wctx->level-1];
1258             av_bprintf(buf, ".%d", n);
1259         }
1260     }
1261
1262     if (!(section->flags & (SECTION_FLAG_IS_ARRAY|SECTION_FLAG_IS_WRAPPER)))
1263         printf("[%s]\n", buf->str);
1264 }
1265
1266 static void ini_print_str(WriterContext *wctx, const char *key, const char *value)
1267 {
1268     AVBPrint buf;
1269
1270     av_bprint_init(&buf, 1, AV_BPRINT_SIZE_UNLIMITED);
1271     printf("%s=", ini_escape_str(&buf, key));
1272     av_bprint_clear(&buf);
1273     printf("%s\n", ini_escape_str(&buf, value));
1274     av_bprint_finalize(&buf, NULL);
1275 }
1276
1277 static void ini_print_int(WriterContext *wctx, const char *key, long long int value)
1278 {
1279     printf("%s=%lld\n", key, value);
1280 }
1281
1282 static const Writer ini_writer = {
1283     .name                  = "ini",
1284     .priv_size             = sizeof(INIContext),
1285     .print_section_header  = ini_print_section_header,
1286     .print_integer         = ini_print_int,
1287     .print_string          = ini_print_str,
1288     .flags = WRITER_FLAG_DISPLAY_OPTIONAL_FIELDS|WRITER_FLAG_PUT_PACKETS_AND_FRAMES_IN_SAME_CHAPTER,
1289     .priv_class            = &ini_class,
1290 };
1291
1292 /* JSON output */
1293
1294 typedef struct {
1295     const AVClass *class;
1296     int indent_level;
1297     int compact;
1298     const char *item_sep, *item_start_end;
1299 } JSONContext;
1300
1301 #undef OFFSET
1302 #define OFFSET(x) offsetof(JSONContext, x)
1303
1304 static const AVOption json_options[]= {
1305     { "compact", "enable compact output", OFFSET(compact), AV_OPT_TYPE_INT, {.i64=0}, 0, 1 },
1306     { "c",       "enable compact output", OFFSET(compact), AV_OPT_TYPE_INT, {.i64=0}, 0, 1 },
1307     { NULL }
1308 };
1309
1310 DEFINE_WRITER_CLASS(json);
1311
1312 static av_cold int json_init(WriterContext *wctx)
1313 {
1314     JSONContext *json = wctx->priv;
1315
1316     json->item_sep       = json->compact ? ", " : ",\n";
1317     json->item_start_end = json->compact ? " "  : "\n";
1318
1319     return 0;
1320 }
1321
1322 static const char *json_escape_str(AVBPrint *dst, const char *src, void *log_ctx)
1323 {
1324     static const char json_escape[] = {'"', '\\', '\b', '\f', '\n', '\r', '\t', 0};
1325     static const char json_subst[]  = {'"', '\\',  'b',  'f',  'n',  'r',  't', 0};
1326     const char *p;
1327
1328     for (p = src; *p; p++) {
1329         char *s = strchr(json_escape, *p);
1330         if (s) {
1331             av_bprint_chars(dst, '\\', 1);
1332             av_bprint_chars(dst, json_subst[s - json_escape], 1);
1333         } else if ((unsigned char)*p < 32) {
1334             av_bprintf(dst, "\\u00%02x", *p & 0xff);
1335         } else {
1336             av_bprint_chars(dst, *p, 1);
1337         }
1338     }
1339     return dst->str;
1340 }
1341
1342 #define JSON_INDENT() printf("%*c", json->indent_level * 4, ' ')
1343
1344 static void json_print_section_header(WriterContext *wctx)
1345 {
1346     JSONContext *json = wctx->priv;
1347     AVBPrint buf;
1348     const struct section *section = wctx->section[wctx->level];
1349     const struct section *parent_section = wctx->level ?
1350         wctx->section[wctx->level-1] : NULL;
1351
1352     if (wctx->level && wctx->nb_item[wctx->level-1])
1353         printf(",\n");
1354
1355     if (section->flags & SECTION_FLAG_IS_WRAPPER) {
1356         printf("{\n");
1357         json->indent_level++;
1358     } else {
1359         av_bprint_init(&buf, 1, AV_BPRINT_SIZE_UNLIMITED);
1360         json_escape_str(&buf, section->name, wctx);
1361         JSON_INDENT();
1362
1363         json->indent_level++;
1364         if (section->flags & SECTION_FLAG_IS_ARRAY) {
1365             printf("\"%s\": [\n", buf.str);
1366         } else if (parent_section && !(parent_section->flags & SECTION_FLAG_IS_ARRAY)) {
1367             printf("\"%s\": {%s", buf.str, json->item_start_end);
1368         } else {
1369             printf("{%s", json->item_start_end);
1370
1371             /* this is required so the parser can distinguish between packets and frames */
1372             if (parent_section && parent_section->id == SECTION_ID_PACKETS_AND_FRAMES) {
1373                 if (!json->compact)
1374                     JSON_INDENT();
1375                 printf("\"type\": \"%s\"%s", section->name, json->item_sep);
1376             }
1377         }
1378         av_bprint_finalize(&buf, NULL);
1379     }
1380 }
1381
1382 static void json_print_section_footer(WriterContext *wctx)
1383 {
1384     JSONContext *json = wctx->priv;
1385     const struct section *section = wctx->section[wctx->level];
1386
1387     if (wctx->level == 0) {
1388         json->indent_level--;
1389         printf("\n}\n");
1390     } else if (section->flags & SECTION_FLAG_IS_ARRAY) {
1391         printf("\n");
1392         json->indent_level--;
1393         JSON_INDENT();
1394         printf("]");
1395     } else {
1396         printf("%s", json->item_start_end);
1397         json->indent_level--;
1398         if (!json->compact)
1399             JSON_INDENT();
1400         printf("}");
1401     }
1402 }
1403
1404 static inline void json_print_item_str(WriterContext *wctx,
1405                                        const char *key, const char *value)
1406 {
1407     AVBPrint buf;
1408
1409     av_bprint_init(&buf, 1, AV_BPRINT_SIZE_UNLIMITED);
1410     printf("\"%s\":", json_escape_str(&buf, key,   wctx));
1411     av_bprint_clear(&buf);
1412     printf(" \"%s\"", json_escape_str(&buf, value, wctx));
1413     av_bprint_finalize(&buf, NULL);
1414 }
1415
1416 static void json_print_str(WriterContext *wctx, const char *key, const char *value)
1417 {
1418     JSONContext *json = wctx->priv;
1419
1420     if (wctx->nb_item[wctx->level])
1421         printf("%s", json->item_sep);
1422     if (!json->compact)
1423         JSON_INDENT();
1424     json_print_item_str(wctx, key, value);
1425 }
1426
1427 static void json_print_int(WriterContext *wctx, const char *key, long long int value)
1428 {
1429     JSONContext *json = wctx->priv;
1430     AVBPrint buf;
1431
1432     if (wctx->nb_item[wctx->level])
1433         printf("%s", json->item_sep);
1434     if (!json->compact)
1435         JSON_INDENT();
1436
1437     av_bprint_init(&buf, 1, AV_BPRINT_SIZE_UNLIMITED);
1438     printf("\"%s\": %lld", json_escape_str(&buf, key, wctx), value);
1439     av_bprint_finalize(&buf, NULL);
1440 }
1441
1442 static const Writer json_writer = {
1443     .name                 = "json",
1444     .priv_size            = sizeof(JSONContext),
1445     .init                 = json_init,
1446     .print_section_header = json_print_section_header,
1447     .print_section_footer = json_print_section_footer,
1448     .print_integer        = json_print_int,
1449     .print_string         = json_print_str,
1450     .flags = WRITER_FLAG_PUT_PACKETS_AND_FRAMES_IN_SAME_CHAPTER,
1451     .priv_class           = &json_class,
1452 };
1453
1454 /* XML output */
1455
1456 typedef struct {
1457     const AVClass *class;
1458     int within_tag;
1459     int indent_level;
1460     int fully_qualified;
1461     int xsd_strict;
1462 } XMLContext;
1463
1464 #undef OFFSET
1465 #define OFFSET(x) offsetof(XMLContext, x)
1466
1467 static const AVOption xml_options[] = {
1468     {"fully_qualified", "specify if the output should be fully qualified", OFFSET(fully_qualified), AV_OPT_TYPE_INT, {.i64=0},  0, 1 },
1469     {"q",               "specify if the output should be fully qualified", OFFSET(fully_qualified), AV_OPT_TYPE_INT, {.i64=0},  0, 1 },
1470     {"xsd_strict",      "ensure that the output is XSD compliant",         OFFSET(xsd_strict),      AV_OPT_TYPE_INT, {.i64=0},  0, 1 },
1471     {"x",               "ensure that the output is XSD compliant",         OFFSET(xsd_strict),      AV_OPT_TYPE_INT, {.i64=0},  0, 1 },
1472     {NULL},
1473 };
1474
1475 DEFINE_WRITER_CLASS(xml);
1476
1477 static av_cold int xml_init(WriterContext *wctx)
1478 {
1479     XMLContext *xml = wctx->priv;
1480
1481     if (xml->xsd_strict) {
1482         xml->fully_qualified = 1;
1483 #define CHECK_COMPLIANCE(opt, opt_name)                                 \
1484         if (opt) {                                                      \
1485             av_log(wctx, AV_LOG_ERROR,                                  \
1486                    "XSD-compliant output selected but option '%s' was selected, XML output may be non-compliant.\n" \
1487                    "You need to disable such option with '-no%s'\n", opt_name, opt_name); \
1488             return AVERROR(EINVAL);                                     \
1489         }
1490         CHECK_COMPLIANCE(show_private_data, "private");
1491         CHECK_COMPLIANCE(show_value_unit,   "unit");
1492         CHECK_COMPLIANCE(use_value_prefix,  "prefix");
1493
1494         if (do_show_frames && do_show_packets) {
1495             av_log(wctx, AV_LOG_ERROR,
1496                    "Interleaved frames and packets are not allowed in XSD. "
1497                    "Select only one between the -show_frames and the -show_packets options.\n");
1498             return AVERROR(EINVAL);
1499         }
1500     }
1501
1502     return 0;
1503 }
1504
1505 static const char *xml_escape_str(AVBPrint *dst, const char *src, void *log_ctx)
1506 {
1507     const char *p;
1508
1509     for (p = src; *p; p++) {
1510         switch (*p) {
1511         case '&' : av_bprintf(dst, "%s", "&amp;");  break;
1512         case '<' : av_bprintf(dst, "%s", "&lt;");   break;
1513         case '>' : av_bprintf(dst, "%s", "&gt;");   break;
1514         case '"' : av_bprintf(dst, "%s", "&quot;"); break;
1515         case '\'': av_bprintf(dst, "%s", "&apos;"); break;
1516         default: av_bprint_chars(dst, *p, 1);
1517         }
1518     }
1519
1520     return dst->str;
1521 }
1522
1523 #define XML_INDENT() printf("%*c", xml->indent_level * 4, ' ')
1524
1525 static void xml_print_section_header(WriterContext *wctx)
1526 {
1527     XMLContext *xml = wctx->priv;
1528     const struct section *section = wctx->section[wctx->level];
1529     const struct section *parent_section = wctx->level ?
1530         wctx->section[wctx->level-1] : NULL;
1531
1532     if (wctx->level == 0) {
1533         const char *qual = " xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' "
1534             "xmlns:ffprobe='http://www.ffmpeg.org/schema/ffprobe' "
1535             "xsi:schemaLocation='http://www.ffmpeg.org/schema/ffprobe ffprobe.xsd'";
1536
1537         printf("<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n");
1538         printf("<%sffprobe%s>\n",
1539                xml->fully_qualified ? "ffprobe:" : "",
1540                xml->fully_qualified ? qual : "");
1541         return;
1542     }
1543
1544     if (xml->within_tag) {
1545         xml->within_tag = 0;
1546         printf(">\n");
1547     }
1548     if (section->flags & SECTION_FLAG_HAS_VARIABLE_FIELDS) {
1549         xml->indent_level++;
1550     } else {
1551         if (parent_section && (parent_section->flags & SECTION_FLAG_IS_WRAPPER) &&
1552             wctx->level && wctx->nb_item[wctx->level-1])
1553             printf("\n");
1554         xml->indent_level++;
1555
1556         if (section->flags & SECTION_FLAG_IS_ARRAY) {
1557             XML_INDENT(); printf("<%s>\n", section->name);
1558         } else {
1559             XML_INDENT(); printf("<%s ", section->name);
1560             xml->within_tag = 1;
1561         }
1562     }
1563 }
1564
1565 static void xml_print_section_footer(WriterContext *wctx)
1566 {
1567     XMLContext *xml = wctx->priv;
1568     const struct section *section = wctx->section[wctx->level];
1569
1570     if (wctx->level == 0) {
1571         printf("</%sffprobe>\n", xml->fully_qualified ? "ffprobe:" : "");
1572     } else if (xml->within_tag) {
1573         xml->within_tag = 0;
1574         printf("/>\n");
1575         xml->indent_level--;
1576     } else if (section->flags & SECTION_FLAG_HAS_VARIABLE_FIELDS) {
1577         xml->indent_level--;
1578     } else {
1579         XML_INDENT(); printf("</%s>\n", section->name);
1580         xml->indent_level--;
1581     }
1582 }
1583
1584 static void xml_print_str(WriterContext *wctx, const char *key, const char *value)
1585 {
1586     AVBPrint buf;
1587     XMLContext *xml = wctx->priv;
1588     const struct section *section = wctx->section[wctx->level];
1589
1590     av_bprint_init(&buf, 1, AV_BPRINT_SIZE_UNLIMITED);
1591
1592     if (section->flags & SECTION_FLAG_HAS_VARIABLE_FIELDS) {
1593         XML_INDENT();
1594         printf("<%s key=\"%s\"",
1595                section->element_name, xml_escape_str(&buf, key, wctx));
1596         av_bprint_clear(&buf);
1597         printf(" value=\"%s\"/>\n", xml_escape_str(&buf, value, wctx));
1598     } else {
1599         if (wctx->nb_item[wctx->level])
1600             printf(" ");
1601         printf("%s=\"%s\"", key, xml_escape_str(&buf, value, wctx));
1602     }
1603
1604     av_bprint_finalize(&buf, NULL);
1605 }
1606
1607 static void xml_print_int(WriterContext *wctx, const char *key, long long int value)
1608 {
1609     if (wctx->nb_item[wctx->level])
1610         printf(" ");
1611     printf("%s=\"%lld\"", key, value);
1612 }
1613
1614 static Writer xml_writer = {
1615     .name                 = "xml",
1616     .priv_size            = sizeof(XMLContext),
1617     .init                 = xml_init,
1618     .print_section_header = xml_print_section_header,
1619     .print_section_footer = xml_print_section_footer,
1620     .print_integer        = xml_print_int,
1621     .print_string         = xml_print_str,
1622     .flags = WRITER_FLAG_PUT_PACKETS_AND_FRAMES_IN_SAME_CHAPTER,
1623     .priv_class           = &xml_class,
1624 };
1625
1626 static void writer_register_all(void)
1627 {
1628     static int initialized;
1629
1630     if (initialized)
1631         return;
1632     initialized = 1;
1633
1634     writer_register(&default_writer);
1635     writer_register(&compact_writer);
1636     writer_register(&csv_writer);
1637     writer_register(&flat_writer);
1638     writer_register(&ini_writer);
1639     writer_register(&json_writer);
1640     writer_register(&xml_writer);
1641 }
1642
1643 #define print_fmt(k, f, ...) do {              \
1644     av_bprint_clear(&pbuf);                    \
1645     av_bprintf(&pbuf, f, __VA_ARGS__);         \
1646     writer_print_string(w, k, pbuf.str, 0);    \
1647 } while (0)
1648
1649 #define print_int(k, v)         writer_print_integer(w, k, v)
1650 #define print_q(k, v, s)        writer_print_rational(w, k, v, s)
1651 #define print_str(k, v)         writer_print_string(w, k, v, 0)
1652 #define print_str_opt(k, v)     writer_print_string(w, k, v, PRINT_STRING_OPT)
1653 #define print_str_validate(k, v) writer_print_string(w, k, v, PRINT_STRING_VALIDATE)
1654 #define print_time(k, v, tb)    writer_print_time(w, k, v, tb, 0)
1655 #define print_ts(k, v)          writer_print_ts(w, k, v, 0)
1656 #define print_duration_time(k, v, tb) writer_print_time(w, k, v, tb, 1)
1657 #define print_duration_ts(k, v)       writer_print_ts(w, k, v, 1)
1658 #define print_val(k, v, u) do {                                     \
1659     struct unit_value uv;                                           \
1660     uv.val.i = v;                                                   \
1661     uv.unit = u;                                                    \
1662     writer_print_string(w, k, value_string(val_str, sizeof(val_str), uv), 0); \
1663 } while (0)
1664
1665 #define print_section_header(s) writer_print_section_header(w, s)
1666 #define print_section_footer(s) writer_print_section_footer(w, s)
1667
1668 #define REALLOCZ_ARRAY_STREAM(ptr, cur_n, new_n)                        \
1669 {                                                                       \
1670     ret = av_reallocp_array(&(ptr), (new_n), sizeof(*(ptr)));           \
1671     if (ret < 0)                                                        \
1672         goto end;                                                       \
1673     memset( (ptr) + (cur_n), 0, ((new_n) - (cur_n)) * sizeof(*(ptr)) ); \
1674 }
1675
1676 static inline int show_tags(WriterContext *w, AVDictionary *tags, int section_id)
1677 {
1678     AVDictionaryEntry *tag = NULL;
1679     int ret = 0;
1680
1681     if (!tags)
1682         return 0;
1683     writer_print_section_header(w, section_id);
1684
1685     while ((tag = av_dict_get(tags, "", tag, AV_DICT_IGNORE_SUFFIX))) {
1686         if ((ret = print_str_validate(tag->key, tag->value)) < 0)
1687             break;
1688     }
1689     writer_print_section_footer(w);
1690
1691     return ret;
1692 }
1693
1694 static void show_packet(WriterContext *w, AVFormatContext *fmt_ctx, AVPacket *pkt, int packet_idx)
1695 {
1696     char val_str[128];
1697     AVStream *st = fmt_ctx->streams[pkt->stream_index];
1698     AVBPrint pbuf;
1699     const char *s;
1700
1701     av_bprint_init(&pbuf, 1, AV_BPRINT_SIZE_UNLIMITED);
1702
1703     writer_print_section_header(w, SECTION_ID_PACKET);
1704
1705     s = av_get_media_type_string(st->codec->codec_type);
1706     if (s) print_str    ("codec_type", s);
1707     else   print_str_opt("codec_type", "unknown");
1708     print_int("stream_index",     pkt->stream_index);
1709     print_ts  ("pts",             pkt->pts);
1710     print_time("pts_time",        pkt->pts, &st->time_base);
1711     print_ts  ("dts",             pkt->dts);
1712     print_time("dts_time",        pkt->dts, &st->time_base);
1713     print_duration_ts("duration",        pkt->duration);
1714     print_duration_time("duration_time", pkt->duration, &st->time_base);
1715     print_duration_ts("convergence_duration", pkt->convergence_duration);
1716     print_duration_time("convergence_duration_time", pkt->convergence_duration, &st->time_base);
1717     print_val("size",             pkt->size, unit_byte_str);
1718     if (pkt->pos != -1) print_fmt    ("pos", "%"PRId64, pkt->pos);
1719     else                print_str_opt("pos", "N/A");
1720     print_fmt("flags", "%c",      pkt->flags & AV_PKT_FLAG_KEY ? 'K' : '_');
1721     if (do_show_data)
1722         writer_print_data(w, "data", pkt->data, pkt->size);
1723     writer_print_data_hash(w, "data_hash", pkt->data, pkt->size);
1724     writer_print_section_footer(w);
1725
1726     av_bprint_finalize(&pbuf, NULL);
1727     fflush(stdout);
1728 }
1729
1730 static void show_subtitle(WriterContext *w, AVSubtitle *sub, AVStream *stream,
1731                           AVFormatContext *fmt_ctx)
1732 {
1733     AVBPrint pbuf;
1734
1735     av_bprint_init(&pbuf, 1, AV_BPRINT_SIZE_UNLIMITED);
1736
1737     writer_print_section_header(w, SECTION_ID_SUBTITLE);
1738
1739     print_str ("media_type",         "subtitle");
1740     print_ts  ("pts",                 sub->pts);
1741     print_time("pts_time",            sub->pts, &AV_TIME_BASE_Q);
1742     print_int ("format",              sub->format);
1743     print_int ("start_display_time",  sub->start_display_time);
1744     print_int ("end_display_time",    sub->end_display_time);
1745     print_int ("num_rects",           sub->num_rects);
1746
1747     writer_print_section_footer(w);
1748
1749     av_bprint_finalize(&pbuf, NULL);
1750     fflush(stdout);
1751 }
1752
1753 static void show_frame(WriterContext *w, AVFrame *frame, AVStream *stream,
1754                        AVFormatContext *fmt_ctx)
1755 {
1756     AVBPrint pbuf;
1757     const char *s;
1758     int i;
1759
1760     av_bprint_init(&pbuf, 1, AV_BPRINT_SIZE_UNLIMITED);
1761
1762     writer_print_section_header(w, SECTION_ID_FRAME);
1763
1764     s = av_get_media_type_string(stream->codec->codec_type);
1765     if (s) print_str    ("media_type", s);
1766     else   print_str_opt("media_type", "unknown");
1767     print_int("key_frame",              frame->key_frame);
1768     print_ts  ("pkt_pts",               frame->pkt_pts);
1769     print_time("pkt_pts_time",          frame->pkt_pts, &stream->time_base);
1770     print_ts  ("pkt_dts",               frame->pkt_dts);
1771     print_time("pkt_dts_time",          frame->pkt_dts, &stream->time_base);
1772     print_ts  ("best_effort_timestamp", av_frame_get_best_effort_timestamp(frame));
1773     print_time("best_effort_timestamp_time", av_frame_get_best_effort_timestamp(frame), &stream->time_base);
1774     print_duration_ts  ("pkt_duration",      av_frame_get_pkt_duration(frame));
1775     print_duration_time("pkt_duration_time", av_frame_get_pkt_duration(frame), &stream->time_base);
1776     if (av_frame_get_pkt_pos (frame) != -1) print_fmt    ("pkt_pos", "%"PRId64, av_frame_get_pkt_pos(frame));
1777     else                      print_str_opt("pkt_pos", "N/A");
1778     if (av_frame_get_pkt_size(frame) != -1) print_fmt    ("pkt_size", "%d", av_frame_get_pkt_size(frame));
1779     else                       print_str_opt("pkt_size", "N/A");
1780
1781     switch (stream->codec->codec_type) {
1782         AVRational sar;
1783
1784     case AVMEDIA_TYPE_VIDEO:
1785         print_int("width",                  frame->width);
1786         print_int("height",                 frame->height);
1787         s = av_get_pix_fmt_name(frame->format);
1788         if (s) print_str    ("pix_fmt", s);
1789         else   print_str_opt("pix_fmt", "unknown");
1790         sar = av_guess_sample_aspect_ratio(fmt_ctx, stream, frame);
1791         if (sar.num) {
1792             print_q("sample_aspect_ratio", sar, ':');
1793         } else {
1794             print_str_opt("sample_aspect_ratio", "N/A");
1795         }
1796         print_fmt("pict_type",              "%c", av_get_picture_type_char(frame->pict_type));
1797         print_int("coded_picture_number",   frame->coded_picture_number);
1798         print_int("display_picture_number", frame->display_picture_number);
1799         print_int("interlaced_frame",       frame->interlaced_frame);
1800         print_int("top_field_first",        frame->top_field_first);
1801         print_int("repeat_pict",            frame->repeat_pict);
1802         break;
1803
1804     case AVMEDIA_TYPE_AUDIO:
1805         s = av_get_sample_fmt_name(frame->format);
1806         if (s) print_str    ("sample_fmt", s);
1807         else   print_str_opt("sample_fmt", "unknown");
1808         print_int("nb_samples",         frame->nb_samples);
1809         print_int("channels", av_frame_get_channels(frame));
1810         if (av_frame_get_channel_layout(frame)) {
1811             av_bprint_clear(&pbuf);
1812             av_bprint_channel_layout(&pbuf, av_frame_get_channels(frame),
1813                                      av_frame_get_channel_layout(frame));
1814             print_str    ("channel_layout", pbuf.str);
1815         } else
1816             print_str_opt("channel_layout", "unknown");
1817         break;
1818     }
1819     if (do_show_frame_tags)
1820         show_tags(w, av_frame_get_metadata(frame), SECTION_ID_FRAME_TAGS);
1821     if (frame->nb_side_data) {
1822         writer_print_section_header(w, SECTION_ID_FRAME_SIDE_DATA_LIST);
1823         for (i = 0; i < frame->nb_side_data; i++) {
1824             AVFrameSideData *sd = frame->side_data[i];
1825             const char *name;
1826
1827             writer_print_section_header(w, SECTION_ID_FRAME_SIDE_DATA);
1828             name = av_frame_side_data_name(sd->type);
1829             print_str("side_data_type", name ? name : "unknown");
1830             print_int("side_data_size", sd->size);
1831             writer_print_section_footer(w);
1832         }
1833         writer_print_section_footer(w);
1834     }
1835
1836     writer_print_section_footer(w);
1837
1838     av_bprint_finalize(&pbuf, NULL);
1839     fflush(stdout);
1840 }
1841
1842 static av_always_inline int process_frame(WriterContext *w,
1843                                           AVFormatContext *fmt_ctx,
1844                                           AVFrame *frame, AVPacket *pkt)
1845 {
1846     AVCodecContext *dec_ctx = fmt_ctx->streams[pkt->stream_index]->codec;
1847     AVSubtitle sub;
1848     int ret = 0, got_frame = 0;
1849
1850     if (dec_ctx->codec) {
1851         switch (dec_ctx->codec_type) {
1852         case AVMEDIA_TYPE_VIDEO:
1853             ret = avcodec_decode_video2(dec_ctx, frame, &got_frame, pkt);
1854             break;
1855
1856         case AVMEDIA_TYPE_AUDIO:
1857             ret = avcodec_decode_audio4(dec_ctx, frame, &got_frame, pkt);
1858             break;
1859
1860         case AVMEDIA_TYPE_SUBTITLE:
1861             ret = avcodec_decode_subtitle2(dec_ctx, &sub, &got_frame, pkt);
1862             break;
1863         }
1864     }
1865
1866     if (ret < 0)
1867         return ret;
1868     ret = FFMIN(ret, pkt->size); /* guard against bogus return values */
1869     pkt->data += ret;
1870     pkt->size -= ret;
1871     if (got_frame) {
1872         int is_sub = (dec_ctx->codec_type == AVMEDIA_TYPE_SUBTITLE);
1873         nb_streams_frames[pkt->stream_index]++;
1874         if (do_show_frames)
1875             if (is_sub)
1876                 show_subtitle(w, &sub, fmt_ctx->streams[pkt->stream_index], fmt_ctx);
1877             else
1878                 show_frame(w, frame, fmt_ctx->streams[pkt->stream_index], fmt_ctx);
1879         if (is_sub)
1880             avsubtitle_free(&sub);
1881     }
1882     return got_frame;
1883 }
1884
1885 static void log_read_interval(const ReadInterval *interval, void *log_ctx, int log_level)
1886 {
1887     av_log(log_ctx, log_level, "id:%d", interval->id);
1888
1889     if (interval->has_start) {
1890         av_log(log_ctx, log_level, " start:%s%s", interval->start_is_offset ? "+" : "",
1891                av_ts2timestr(interval->start, &AV_TIME_BASE_Q));
1892     } else {
1893         av_log(log_ctx, log_level, " start:N/A");
1894     }
1895
1896     if (interval->has_end) {
1897         av_log(log_ctx, log_level, " end:%s", interval->end_is_offset ? "+" : "");
1898         if (interval->duration_frames)
1899             av_log(log_ctx, log_level, "#%"PRId64, interval->end);
1900         else
1901             av_log(log_ctx, log_level, "%s", av_ts2timestr(interval->end, &AV_TIME_BASE_Q));
1902     } else {
1903         av_log(log_ctx, log_level, " end:N/A");
1904     }
1905
1906     av_log(log_ctx, log_level, "\n");
1907 }
1908
1909 static int read_interval_packets(WriterContext *w, AVFormatContext *fmt_ctx,
1910                                  const ReadInterval *interval, int64_t *cur_ts)
1911 {
1912     AVPacket pkt, pkt1;
1913     AVFrame *frame = NULL;
1914     int ret = 0, i = 0, frame_count = 0;
1915     int64_t start = -INT64_MAX, end = interval->end;
1916     int has_start = 0, has_end = interval->has_end && !interval->end_is_offset;
1917
1918     av_init_packet(&pkt);
1919
1920     av_log(NULL, AV_LOG_VERBOSE, "Processing read interval ");
1921     log_read_interval(interval, NULL, AV_LOG_VERBOSE);
1922
1923     if (interval->has_start) {
1924         int64_t target;
1925         if (interval->start_is_offset) {
1926             if (*cur_ts == AV_NOPTS_VALUE) {
1927                 av_log(NULL, AV_LOG_ERROR,
1928                        "Could not seek to relative position since current "
1929                        "timestamp is not defined\n");
1930                 ret = AVERROR(EINVAL);
1931                 goto end;
1932             }
1933             target = *cur_ts + interval->start;
1934         } else {
1935             target = interval->start;
1936         }
1937
1938         av_log(NULL, AV_LOG_VERBOSE, "Seeking to read interval start point %s\n",
1939                av_ts2timestr(target, &AV_TIME_BASE_Q));
1940         if ((ret = avformat_seek_file(fmt_ctx, -1, -INT64_MAX, target, INT64_MAX, 0)) < 0) {
1941             av_log(NULL, AV_LOG_ERROR, "Could not seek to position %"PRId64": %s\n",
1942                    interval->start, av_err2str(ret));
1943             goto end;
1944         }
1945     }
1946
1947     frame = av_frame_alloc();
1948     if (!frame) {
1949         ret = AVERROR(ENOMEM);
1950         goto end;
1951     }
1952     while (!av_read_frame(fmt_ctx, &pkt)) {
1953         if (fmt_ctx->nb_streams > nb_streams) {
1954             REALLOCZ_ARRAY_STREAM(nb_streams_frames,  nb_streams, fmt_ctx->nb_streams);
1955             REALLOCZ_ARRAY_STREAM(nb_streams_packets, nb_streams, fmt_ctx->nb_streams);
1956             REALLOCZ_ARRAY_STREAM(selected_streams,   nb_streams, fmt_ctx->nb_streams);
1957             nb_streams = fmt_ctx->nb_streams;
1958         }
1959         if (selected_streams[pkt.stream_index]) {
1960             AVRational tb = fmt_ctx->streams[pkt.stream_index]->time_base;
1961
1962             if (pkt.pts != AV_NOPTS_VALUE)
1963                 *cur_ts = av_rescale_q(pkt.pts, tb, AV_TIME_BASE_Q);
1964
1965             if (!has_start && *cur_ts != AV_NOPTS_VALUE) {
1966                 start = *cur_ts;
1967                 has_start = 1;
1968             }
1969
1970             if (has_start && !has_end && interval->end_is_offset) {
1971                 end = start + interval->end;
1972                 has_end = 1;
1973             }
1974
1975             if (interval->end_is_offset && interval->duration_frames) {
1976                 if (frame_count >= interval->end)
1977                     break;
1978             } else if (has_end && *cur_ts != AV_NOPTS_VALUE && *cur_ts >= end) {
1979                 break;
1980             }
1981
1982             frame_count++;
1983             if (do_read_packets) {
1984                 if (do_show_packets)
1985                     show_packet(w, fmt_ctx, &pkt, i++);
1986                 nb_streams_packets[pkt.stream_index]++;
1987             }
1988             if (do_read_frames) {
1989                 pkt1 = pkt;
1990                 while (pkt1.size && process_frame(w, fmt_ctx, frame, &pkt1) > 0);
1991             }
1992         }
1993         av_free_packet(&pkt);
1994     }
1995     av_init_packet(&pkt);
1996     pkt.data = NULL;
1997     pkt.size = 0;
1998     //Flush remaining frames that are cached in the decoder
1999     for (i = 0; i < fmt_ctx->nb_streams; i++) {
2000         pkt.stream_index = i;
2001         if (do_read_frames)
2002             while (process_frame(w, fmt_ctx, frame, &pkt) > 0);
2003     }
2004
2005 end:
2006     av_frame_free(&frame);
2007     if (ret < 0) {
2008         av_log(NULL, AV_LOG_ERROR, "Could not read packets in interval ");
2009         log_read_interval(interval, NULL, AV_LOG_ERROR);
2010     }
2011     return ret;
2012 }
2013
2014 static int read_packets(WriterContext *w, AVFormatContext *fmt_ctx)
2015 {
2016     int i, ret = 0;
2017     int64_t cur_ts = fmt_ctx->start_time;
2018
2019     if (read_intervals_nb == 0) {
2020         ReadInterval interval = (ReadInterval) { .has_start = 0, .has_end = 0 };
2021         ret = read_interval_packets(w, fmt_ctx, &interval, &cur_ts);
2022     } else {
2023         for (i = 0; i < read_intervals_nb; i++) {
2024             ret = read_interval_packets(w, fmt_ctx, &read_intervals[i], &cur_ts);
2025             if (ret < 0)
2026                 break;
2027         }
2028     }
2029
2030     return ret;
2031 }
2032
2033 static int show_stream(WriterContext *w, AVFormatContext *fmt_ctx, int stream_idx, int in_program)
2034 {
2035     AVStream *stream = fmt_ctx->streams[stream_idx];
2036     AVCodecContext *dec_ctx;
2037     const AVCodec *dec;
2038     char val_str[128];
2039     const char *s;
2040     AVRational sar, dar;
2041     AVBPrint pbuf;
2042     const AVCodecDescriptor *cd;
2043     int ret = 0;
2044
2045     av_bprint_init(&pbuf, 1, AV_BPRINT_SIZE_UNLIMITED);
2046
2047     writer_print_section_header(w, in_program ? SECTION_ID_PROGRAM_STREAM : SECTION_ID_STREAM);
2048
2049     print_int("index", stream->index);
2050
2051     if ((dec_ctx = stream->codec)) {
2052         const char *profile = NULL;
2053         dec = dec_ctx->codec;
2054         if (dec) {
2055             print_str("codec_name", dec->name);
2056             if (!do_bitexact) {
2057                 if (dec->long_name) print_str    ("codec_long_name", dec->long_name);
2058                 else                print_str_opt("codec_long_name", "unknown");
2059             }
2060         } else if ((cd = avcodec_descriptor_get(stream->codec->codec_id))) {
2061             print_str_opt("codec_name", cd->name);
2062             if (!do_bitexact) {
2063                 print_str_opt("codec_long_name",
2064                               cd->long_name ? cd->long_name : "unknown");
2065             }
2066         } else {
2067             print_str_opt("codec_name", "unknown");
2068             if (!do_bitexact) {
2069                 print_str_opt("codec_long_name", "unknown");
2070             }
2071         }
2072
2073         if (dec && (profile = av_get_profile_name(dec, dec_ctx->profile)))
2074             print_str("profile", profile);
2075         else
2076             print_str_opt("profile", "unknown");
2077
2078         s = av_get_media_type_string(dec_ctx->codec_type);
2079         if (s) print_str    ("codec_type", s);
2080         else   print_str_opt("codec_type", "unknown");
2081         print_q("codec_time_base", dec_ctx->time_base, '/');
2082
2083         /* print AVI/FourCC tag */
2084         av_get_codec_tag_string(val_str, sizeof(val_str), dec_ctx->codec_tag);
2085         print_str("codec_tag_string",    val_str);
2086         print_fmt("codec_tag", "0x%04x", dec_ctx->codec_tag);
2087
2088         switch (dec_ctx->codec_type) {
2089         case AVMEDIA_TYPE_VIDEO:
2090             print_int("width",        dec_ctx->width);
2091             print_int("height",       dec_ctx->height);
2092             print_int("has_b_frames", dec_ctx->has_b_frames);
2093             sar = av_guess_sample_aspect_ratio(fmt_ctx, stream, NULL);
2094             if (sar.den) {
2095                 print_q("sample_aspect_ratio", sar, ':');
2096                 av_reduce(&dar.num, &dar.den,
2097                           dec_ctx->width  * sar.num,
2098                           dec_ctx->height * sar.den,
2099                           1024*1024);
2100                 print_q("display_aspect_ratio", dar, ':');
2101             } else {
2102                 print_str_opt("sample_aspect_ratio", "N/A");
2103                 print_str_opt("display_aspect_ratio", "N/A");
2104             }
2105             s = av_get_pix_fmt_name(dec_ctx->pix_fmt);
2106             if (s) print_str    ("pix_fmt", s);
2107             else   print_str_opt("pix_fmt", "unknown");
2108             print_int("level",   dec_ctx->level);
2109             if (dec_ctx->color_range != AVCOL_RANGE_UNSPECIFIED)
2110                 print_str    ("color_range", dec_ctx->color_range == AVCOL_RANGE_MPEG ? "tv": "pc");
2111             else
2112                 print_str_opt("color_range", "N/A");
2113             s = av_get_colorspace_name(dec_ctx->colorspace);
2114             if (s) print_str    ("color_space", s);
2115             else   print_str_opt("color_space", "unknown");
2116             if (dec_ctx->timecode_frame_start >= 0) {
2117                 char tcbuf[AV_TIMECODE_STR_SIZE];
2118                 av_timecode_make_mpeg_tc_string(tcbuf, dec_ctx->timecode_frame_start);
2119                 print_str("timecode", tcbuf);
2120             } else {
2121                 print_str_opt("timecode", "N/A");
2122             }
2123             break;
2124
2125         case AVMEDIA_TYPE_AUDIO:
2126             s = av_get_sample_fmt_name(dec_ctx->sample_fmt);
2127             if (s) print_str    ("sample_fmt", s);
2128             else   print_str_opt("sample_fmt", "unknown");
2129             print_val("sample_rate",     dec_ctx->sample_rate, unit_hertz_str);
2130             print_int("channels",        dec_ctx->channels);
2131
2132             if (dec_ctx->channel_layout) {
2133                 av_bprint_clear(&pbuf);
2134                 av_bprint_channel_layout(&pbuf, dec_ctx->channels, dec_ctx->channel_layout);
2135                 print_str    ("channel_layout", pbuf.str);
2136             } else {
2137                 print_str_opt("channel_layout", "unknown");
2138             }
2139
2140             print_int("bits_per_sample", av_get_bits_per_sample(dec_ctx->codec_id));
2141             break;
2142
2143         case AVMEDIA_TYPE_SUBTITLE:
2144             if (dec_ctx->width)
2145                 print_int("width",       dec_ctx->width);
2146             else
2147                 print_str_opt("width",   "N/A");
2148             if (dec_ctx->height)
2149                 print_int("height",      dec_ctx->height);
2150             else
2151                 print_str_opt("height",  "N/A");
2152             break;
2153         }
2154     } else {
2155         print_str_opt("codec_type", "unknown");
2156     }
2157     if (dec_ctx->codec && dec_ctx->codec->priv_class && show_private_data) {
2158         const AVOption *opt = NULL;
2159         while (opt = av_opt_next(dec_ctx->priv_data,opt)) {
2160             uint8_t *str;
2161             if (opt->flags) continue;
2162             if (av_opt_get(dec_ctx->priv_data, opt->name, 0, &str) >= 0) {
2163                 print_str(opt->name, str);
2164                 av_free(str);
2165             }
2166         }
2167     }
2168
2169     if (fmt_ctx->iformat->flags & AVFMT_SHOW_IDS) print_fmt    ("id", "0x%x", stream->id);
2170     else                                          print_str_opt("id", "N/A");
2171     print_q("r_frame_rate",   stream->r_frame_rate,   '/');
2172     print_q("avg_frame_rate", stream->avg_frame_rate, '/');
2173     print_q("time_base",      stream->time_base,      '/');
2174     print_ts  ("start_pts",   stream->start_time);
2175     print_time("start_time",  stream->start_time, &stream->time_base);
2176     print_ts  ("duration_ts", stream->duration);
2177     print_time("duration",    stream->duration, &stream->time_base);
2178     if (dec_ctx->bit_rate > 0) print_val    ("bit_rate", dec_ctx->bit_rate, unit_bit_per_second_str);
2179     else                       print_str_opt("bit_rate", "N/A");
2180     if (dec_ctx->rc_max_rate > 0) print_val ("max_bit_rate", dec_ctx->rc_max_rate, unit_bit_per_second_str);
2181     else                       print_str_opt("max_bit_rate", "N/A");
2182     if (dec_ctx->bits_per_raw_sample > 0) print_fmt("bits_per_raw_sample", "%d", dec_ctx->bits_per_raw_sample);
2183     else                       print_str_opt("bits_per_raw_sample", "N/A");
2184     if (stream->nb_frames) print_fmt    ("nb_frames", "%"PRId64, stream->nb_frames);
2185     else                   print_str_opt("nb_frames", "N/A");
2186     if (nb_streams_frames[stream_idx])  print_fmt    ("nb_read_frames", "%"PRIu64, nb_streams_frames[stream_idx]);
2187     else                                print_str_opt("nb_read_frames", "N/A");
2188     if (nb_streams_packets[stream_idx]) print_fmt    ("nb_read_packets", "%"PRIu64, nb_streams_packets[stream_idx]);
2189     else                                print_str_opt("nb_read_packets", "N/A");
2190     if (do_show_data)
2191         writer_print_data(w, "extradata", dec_ctx->extradata,
2192                                           dec_ctx->extradata_size);
2193     writer_print_data_hash(w, "extradata_hash", dec_ctx->extradata,
2194                                                 dec_ctx->extradata_size);
2195
2196     /* Print disposition information */
2197 #define PRINT_DISPOSITION(flagname, name) do {                                \
2198         print_int(name, !!(stream->disposition & AV_DISPOSITION_##flagname)); \
2199     } while (0)
2200
2201     if (do_show_stream_disposition) {
2202     writer_print_section_header(w, in_program ? SECTION_ID_PROGRAM_STREAM_DISPOSITION : SECTION_ID_STREAM_DISPOSITION);
2203     PRINT_DISPOSITION(DEFAULT,          "default");
2204     PRINT_DISPOSITION(DUB,              "dub");
2205     PRINT_DISPOSITION(ORIGINAL,         "original");
2206     PRINT_DISPOSITION(COMMENT,          "comment");
2207     PRINT_DISPOSITION(LYRICS,           "lyrics");
2208     PRINT_DISPOSITION(KARAOKE,          "karaoke");
2209     PRINT_DISPOSITION(FORCED,           "forced");
2210     PRINT_DISPOSITION(HEARING_IMPAIRED, "hearing_impaired");
2211     PRINT_DISPOSITION(VISUAL_IMPAIRED,  "visual_impaired");
2212     PRINT_DISPOSITION(CLEAN_EFFECTS,    "clean_effects");
2213     PRINT_DISPOSITION(ATTACHED_PIC,     "attached_pic");
2214     writer_print_section_footer(w);
2215     }
2216
2217     if (do_show_stream_tags)
2218         ret = show_tags(w, stream->metadata, in_program ? SECTION_ID_PROGRAM_STREAM_TAGS : SECTION_ID_STREAM_TAGS);
2219
2220     writer_print_section_footer(w);
2221     av_bprint_finalize(&pbuf, NULL);
2222     fflush(stdout);
2223
2224     return ret;
2225 }
2226
2227 static int show_streams(WriterContext *w, AVFormatContext *fmt_ctx)
2228 {
2229     int i, ret = 0;
2230
2231     writer_print_section_header(w, SECTION_ID_STREAMS);
2232     for (i = 0; i < fmt_ctx->nb_streams; i++)
2233         if (selected_streams[i]) {
2234             ret = show_stream(w, fmt_ctx, i, 0);
2235             if (ret < 0)
2236                 break;
2237         }
2238     writer_print_section_footer(w);
2239
2240     return ret;
2241 }
2242
2243 static int show_program(WriterContext *w, AVFormatContext *fmt_ctx, AVProgram *program)
2244 {
2245     int i, ret = 0;
2246
2247     writer_print_section_header(w, SECTION_ID_PROGRAM);
2248     print_int("program_id", program->id);
2249     print_int("program_num", program->program_num);
2250     print_int("nb_streams", program->nb_stream_indexes);
2251     print_int("pmt_pid", program->pmt_pid);
2252     print_int("pcr_pid", program->pcr_pid);
2253     print_ts("start_pts", program->start_time);
2254     print_time("start_time", program->start_time, &AV_TIME_BASE_Q);
2255     print_ts("end_pts", program->end_time);
2256     print_time("end_time", program->end_time, &AV_TIME_BASE_Q);
2257     if (do_show_program_tags)
2258         ret = show_tags(w, program->metadata, SECTION_ID_PROGRAM_TAGS);
2259     if (ret < 0)
2260         goto end;
2261
2262     writer_print_section_header(w, SECTION_ID_PROGRAM_STREAMS);
2263     for (i = 0; i < program->nb_stream_indexes; i++) {
2264         if (selected_streams[program->stream_index[i]]) {
2265             ret = show_stream(w, fmt_ctx, program->stream_index[i], 1);
2266             if (ret < 0)
2267                 break;
2268         }
2269     }
2270     writer_print_section_footer(w);
2271
2272 end:
2273     writer_print_section_footer(w);
2274     return ret;
2275 }
2276
2277 static int show_programs(WriterContext *w, AVFormatContext *fmt_ctx)
2278 {
2279     int i, ret = 0;
2280
2281     writer_print_section_header(w, SECTION_ID_PROGRAMS);
2282     for (i = 0; i < fmt_ctx->nb_programs; i++) {
2283         AVProgram *program = fmt_ctx->programs[i];
2284         if (!program)
2285             continue;
2286         ret = show_program(w, fmt_ctx, program);
2287         if (ret < 0)
2288             break;
2289     }
2290     writer_print_section_footer(w);
2291     return ret;
2292 }
2293
2294 static int show_chapters(WriterContext *w, AVFormatContext *fmt_ctx)
2295 {
2296     int i, ret = 0;
2297
2298     writer_print_section_header(w, SECTION_ID_CHAPTERS);
2299     for (i = 0; i < fmt_ctx->nb_chapters; i++) {
2300         AVChapter *chapter = fmt_ctx->chapters[i];
2301
2302         writer_print_section_header(w, SECTION_ID_CHAPTER);
2303         print_int("id", chapter->id);
2304         print_q  ("time_base", chapter->time_base, '/');
2305         print_int("start", chapter->start);
2306         print_time("start_time", chapter->start, &chapter->time_base);
2307         print_int("end", chapter->end);
2308         print_time("end_time", chapter->end, &chapter->time_base);
2309         if (do_show_chapter_tags)
2310             ret = show_tags(w, chapter->metadata, SECTION_ID_CHAPTER_TAGS);
2311         writer_print_section_footer(w);
2312     }
2313     writer_print_section_footer(w);
2314
2315     return ret;
2316 }
2317
2318 static int show_format(WriterContext *w, AVFormatContext *fmt_ctx)
2319 {
2320     char val_str[128];
2321     int64_t size = fmt_ctx->pb ? avio_size(fmt_ctx->pb) : -1;
2322     int ret = 0;
2323
2324     writer_print_section_header(w, SECTION_ID_FORMAT);
2325     print_str_validate("filename", fmt_ctx->filename);
2326     print_int("nb_streams",       fmt_ctx->nb_streams);
2327     print_int("nb_programs",      fmt_ctx->nb_programs);
2328     print_str("format_name",      fmt_ctx->iformat->name);
2329     if (!do_bitexact) {
2330         if (fmt_ctx->iformat->long_name) print_str    ("format_long_name", fmt_ctx->iformat->long_name);
2331         else                             print_str_opt("format_long_name", "unknown");
2332     }
2333     print_time("start_time",      fmt_ctx->start_time, &AV_TIME_BASE_Q);
2334     print_time("duration",        fmt_ctx->duration,   &AV_TIME_BASE_Q);
2335     if (size >= 0) print_val    ("size", size, unit_byte_str);
2336     else           print_str_opt("size", "N/A");
2337     if (fmt_ctx->bit_rate > 0) print_val    ("bit_rate", fmt_ctx->bit_rate, unit_bit_per_second_str);
2338     else                       print_str_opt("bit_rate", "N/A");
2339     print_int("probe_score", av_format_get_probe_score(fmt_ctx));
2340     if (do_show_format_tags)
2341         ret = show_tags(w, fmt_ctx->metadata, SECTION_ID_FORMAT_TAGS);
2342
2343     writer_print_section_footer(w);
2344     fflush(stdout);
2345     return ret;
2346 }
2347
2348 static void show_error(WriterContext *w, int err)
2349 {
2350     char errbuf[128];
2351     const char *errbuf_ptr = errbuf;
2352
2353     if (av_strerror(err, errbuf, sizeof(errbuf)) < 0)
2354         errbuf_ptr = strerror(AVUNERROR(err));
2355
2356     writer_print_section_header(w, SECTION_ID_ERROR);
2357     print_int("code", err);
2358     print_str("string", errbuf_ptr);
2359     writer_print_section_footer(w);
2360 }
2361
2362 static int open_input_file(AVFormatContext **fmt_ctx_ptr, const char *filename)
2363 {
2364     int err, i, orig_nb_streams;
2365     AVFormatContext *fmt_ctx = NULL;
2366     AVDictionaryEntry *t;
2367     AVDictionary **opts;
2368
2369     if ((err = avformat_open_input(&fmt_ctx, filename,
2370                                    iformat, &format_opts)) < 0) {
2371         print_error(filename, err);
2372         return err;
2373     }
2374     if ((t = av_dict_get(format_opts, "", NULL, AV_DICT_IGNORE_SUFFIX))) {
2375         av_log(NULL, AV_LOG_ERROR, "Option %s not found.\n", t->key);
2376         return AVERROR_OPTION_NOT_FOUND;
2377     }
2378
2379     /* fill the streams in the format context */
2380     opts = setup_find_stream_info_opts(fmt_ctx, codec_opts);
2381     orig_nb_streams = fmt_ctx->nb_streams;
2382
2383     if ((err = avformat_find_stream_info(fmt_ctx, opts)) < 0) {
2384         print_error(filename, err);
2385         return err;
2386     }
2387     for (i = 0; i < orig_nb_streams; i++)
2388         av_dict_free(&opts[i]);
2389     av_freep(&opts);
2390
2391     av_dump_format(fmt_ctx, 0, filename, 0);
2392
2393     /* bind a decoder to each input stream */
2394     for (i = 0; i < fmt_ctx->nb_streams; i++) {
2395         AVStream *stream = fmt_ctx->streams[i];
2396         AVCodec *codec;
2397
2398         if (stream->codec->codec_id == AV_CODEC_ID_PROBE) {
2399             av_log(NULL, AV_LOG_WARNING,
2400                    "Failed to probe codec for input stream %d\n",
2401                     stream->index);
2402         } else if (!(codec = avcodec_find_decoder(stream->codec->codec_id))) {
2403             av_log(NULL, AV_LOG_WARNING,
2404                     "Unsupported codec with id %d for input stream %d\n",
2405                     stream->codec->codec_id, stream->index);
2406         } else {
2407             AVDictionary *opts = filter_codec_opts(codec_opts, stream->codec->codec_id,
2408                                                    fmt_ctx, stream, codec);
2409             if (avcodec_open2(stream->codec, codec, &opts) < 0) {
2410                 av_log(NULL, AV_LOG_WARNING, "Could not open codec for input stream %d\n",
2411                        stream->index);
2412             }
2413             if ((t = av_dict_get(opts, "", NULL, AV_DICT_IGNORE_SUFFIX))) {
2414                 av_log(NULL, AV_LOG_ERROR, "Option %s for input stream %d not found\n",
2415                        t->key, stream->index);
2416                 return AVERROR_OPTION_NOT_FOUND;
2417             }
2418         }
2419     }
2420
2421     *fmt_ctx_ptr = fmt_ctx;
2422     return 0;
2423 }
2424
2425 static void close_input_file(AVFormatContext **ctx_ptr)
2426 {
2427     int i;
2428     AVFormatContext *fmt_ctx = *ctx_ptr;
2429
2430     /* close decoder for each stream */
2431     for (i = 0; i < fmt_ctx->nb_streams; i++)
2432         if (fmt_ctx->streams[i]->codec->codec_id != AV_CODEC_ID_NONE)
2433             avcodec_close(fmt_ctx->streams[i]->codec);
2434
2435     avformat_close_input(ctx_ptr);
2436 }
2437
2438 static int probe_file(WriterContext *wctx, const char *filename)
2439 {
2440     AVFormatContext *fmt_ctx;
2441     int ret, i;
2442     int section_id;
2443
2444     do_read_frames = do_show_frames || do_count_frames;
2445     do_read_packets = do_show_packets || do_count_packets;
2446
2447     ret = open_input_file(&fmt_ctx, filename);
2448     if (ret < 0)
2449         return ret;
2450
2451 #define CHECK_END if (ret < 0) goto end
2452
2453     nb_streams = fmt_ctx->nb_streams;
2454     REALLOCZ_ARRAY_STREAM(nb_streams_frames,0,fmt_ctx->nb_streams);
2455     REALLOCZ_ARRAY_STREAM(nb_streams_packets,0,fmt_ctx->nb_streams);
2456     REALLOCZ_ARRAY_STREAM(selected_streams,0,fmt_ctx->nb_streams);
2457
2458     for (i = 0; i < fmt_ctx->nb_streams; i++) {
2459         if (stream_specifier) {
2460             ret = avformat_match_stream_specifier(fmt_ctx,
2461                                                   fmt_ctx->streams[i],
2462                                                   stream_specifier);
2463             CHECK_END;
2464             else
2465                 selected_streams[i] = ret;
2466             ret = 0;
2467         } else {
2468             selected_streams[i] = 1;
2469         }
2470     }
2471
2472     if (do_read_frames || do_read_packets) {
2473         if (do_show_frames && do_show_packets &&
2474             wctx->writer->flags & WRITER_FLAG_PUT_PACKETS_AND_FRAMES_IN_SAME_CHAPTER)
2475             section_id = SECTION_ID_PACKETS_AND_FRAMES;
2476         else if (do_show_packets && !do_show_frames)
2477             section_id = SECTION_ID_PACKETS;
2478         else // (!do_show_packets && do_show_frames)
2479             section_id = SECTION_ID_FRAMES;
2480         if (do_show_frames || do_show_packets)
2481             writer_print_section_header(wctx, section_id);
2482         ret = read_packets(wctx, fmt_ctx);
2483         if (do_show_frames || do_show_packets)
2484             writer_print_section_footer(wctx);
2485         CHECK_END;
2486     }
2487
2488     if (do_show_programs) {
2489         ret = show_programs(wctx, fmt_ctx);
2490         CHECK_END;
2491     }
2492
2493     if (do_show_streams) {
2494         ret = show_streams(wctx, fmt_ctx);
2495         CHECK_END;
2496     }
2497     if (do_show_chapters) {
2498         ret = show_chapters(wctx, fmt_ctx);
2499         CHECK_END;
2500     }
2501     if (do_show_format) {
2502         ret = show_format(wctx, fmt_ctx);
2503         CHECK_END;
2504     }
2505
2506 end:
2507     close_input_file(&fmt_ctx);
2508     av_freep(&nb_streams_frames);
2509     av_freep(&nb_streams_packets);
2510     av_freep(&selected_streams);
2511
2512     return ret;
2513 }
2514
2515 static void show_usage(void)
2516 {
2517     av_log(NULL, AV_LOG_INFO, "Simple multimedia streams analyzer\n");
2518     av_log(NULL, AV_LOG_INFO, "usage: %s [OPTIONS] [INPUT_FILE]\n", program_name);
2519     av_log(NULL, AV_LOG_INFO, "\n");
2520 }
2521
2522 static void ffprobe_show_program_version(WriterContext *w)
2523 {
2524     AVBPrint pbuf;
2525     av_bprint_init(&pbuf, 1, AV_BPRINT_SIZE_UNLIMITED);
2526
2527     writer_print_section_header(w, SECTION_ID_PROGRAM_VERSION);
2528     print_str("version", FFMPEG_VERSION);
2529     print_fmt("copyright", "Copyright (c) %d-%d the FFmpeg developers",
2530               program_birth_year, CONFIG_THIS_YEAR);
2531     print_str("build_date", __DATE__);
2532     print_str("build_time", __TIME__);
2533     print_str("compiler_ident", CC_IDENT);
2534     print_str("configuration", FFMPEG_CONFIGURATION);
2535     writer_print_section_footer(w);
2536
2537     av_bprint_finalize(&pbuf, NULL);
2538 }
2539
2540 #define SHOW_LIB_VERSION(libname, LIBNAME)                              \
2541     do {                                                                \
2542         if (CONFIG_##LIBNAME) {                                         \
2543             unsigned int version = libname##_version();                 \
2544             writer_print_section_header(w, SECTION_ID_LIBRARY_VERSION); \
2545             print_str("name",    "lib" #libname);                       \
2546             print_int("major",   LIB##LIBNAME##_VERSION_MAJOR);         \
2547             print_int("minor",   LIB##LIBNAME##_VERSION_MINOR);         \
2548             print_int("micro",   LIB##LIBNAME##_VERSION_MICRO);         \
2549             print_int("version", version);                              \
2550             print_str("ident",   LIB##LIBNAME##_IDENT);                 \
2551             writer_print_section_footer(w);                             \
2552         }                                                               \
2553     } while (0)
2554
2555 static void ffprobe_show_library_versions(WriterContext *w)
2556 {
2557     writer_print_section_header(w, SECTION_ID_LIBRARY_VERSIONS);
2558     SHOW_LIB_VERSION(avutil,     AVUTIL);
2559     SHOW_LIB_VERSION(avcodec,    AVCODEC);
2560     SHOW_LIB_VERSION(avformat,   AVFORMAT);
2561     SHOW_LIB_VERSION(avdevice,   AVDEVICE);
2562     SHOW_LIB_VERSION(avfilter,   AVFILTER);
2563     SHOW_LIB_VERSION(swscale,    SWSCALE);
2564     SHOW_LIB_VERSION(swresample, SWRESAMPLE);
2565     SHOW_LIB_VERSION(postproc,   POSTPROC);
2566     writer_print_section_footer(w);
2567 }
2568
2569 #define PRINT_PIX_FMT_FLAG(flagname, name)                                \
2570     do {                                                                  \
2571         print_int(name, !!(pixdesc->flags & AV_PIX_FMT_FLAG_##flagname)); \
2572     } while (0)
2573
2574 static void ffprobe_show_pixel_formats(WriterContext *w)
2575 {
2576     const AVPixFmtDescriptor *pixdesc = NULL;
2577     int n;
2578
2579     writer_print_section_header(w, SECTION_ID_PIXEL_FORMATS);
2580     while (pixdesc = av_pix_fmt_desc_next(pixdesc)) {
2581         writer_print_section_header(w, SECTION_ID_PIXEL_FORMAT);
2582         print_str("name", pixdesc->name);
2583         print_int("nb_components", pixdesc->nb_components);
2584         n = av_get_bits_per_pixel(pixdesc);
2585         if (n) print_int    ("bits_per_pixel", n);
2586         else   print_str_opt("bits_per_pixel", "N/A");
2587         if (do_show_pixel_format_flags) {
2588             writer_print_section_header(w, SECTION_ID_PIXEL_FORMAT_FLAGS);
2589             PRINT_PIX_FMT_FLAG(BE,        "big_endian");
2590             PRINT_PIX_FMT_FLAG(PAL,       "palette");
2591             PRINT_PIX_FMT_FLAG(BITSTREAM, "bitstream");
2592             PRINT_PIX_FMT_FLAG(HWACCEL,   "hwaccel");
2593             PRINT_PIX_FMT_FLAG(PLANAR,    "planar");
2594             PRINT_PIX_FMT_FLAG(RGB,       "rgb");
2595             PRINT_PIX_FMT_FLAG(PSEUDOPAL, "pseudopal");
2596             PRINT_PIX_FMT_FLAG(ALPHA,     "alpha");
2597             writer_print_section_footer(w);
2598         }
2599         writer_print_section_footer(w);
2600     }
2601     writer_print_section_footer(w);
2602 }
2603
2604 static int opt_format(void *optctx, const char *opt, const char *arg)
2605 {
2606     iformat = av_find_input_format(arg);
2607     if (!iformat) {
2608         av_log(NULL, AV_LOG_ERROR, "Unknown input format: %s\n", arg);
2609         return AVERROR(EINVAL);
2610     }
2611     return 0;
2612 }
2613
2614 static inline void mark_section_show_entries(SectionID section_id,
2615                                              int show_all_entries, AVDictionary *entries)
2616 {
2617     struct section *section = &sections[section_id];
2618
2619     section->show_all_entries = show_all_entries;
2620     if (show_all_entries) {
2621         SectionID *id;
2622         for (id = section->children_ids; *id != -1; id++)
2623             mark_section_show_entries(*id, show_all_entries, entries);
2624     } else {
2625         av_dict_copy(&section->entries_to_show, entries, 0);
2626     }
2627 }
2628
2629 static int match_section(const char *section_name,
2630                          int show_all_entries, AVDictionary *entries)
2631 {
2632     int i, ret = 0;
2633
2634     for (i = 0; i < FF_ARRAY_ELEMS(sections); i++) {
2635         const struct section *section = &sections[i];
2636         if (!strcmp(section_name, section->name) ||
2637             (section->unique_name && !strcmp(section_name, section->unique_name))) {
2638             av_log(NULL, AV_LOG_DEBUG,
2639                    "'%s' matches section with unique name '%s'\n", section_name,
2640                    (char *)av_x_if_null(section->unique_name, section->name));
2641             ret++;
2642             mark_section_show_entries(section->id, show_all_entries, entries);
2643         }
2644     }
2645     return ret;
2646 }
2647
2648 static int opt_show_entries(void *optctx, const char *opt, const char *arg)
2649 {
2650     const char *p = arg;
2651     int ret = 0;
2652
2653     while (*p) {
2654         AVDictionary *entries = NULL;
2655         char *section_name = av_get_token(&p, "=:");
2656         int show_all_entries = 0;
2657
2658         if (!section_name) {
2659             av_log(NULL, AV_LOG_ERROR,
2660                    "Missing section name for option '%s'\n", opt);
2661             return AVERROR(EINVAL);
2662         }
2663
2664         if (*p == '=') {
2665             p++;
2666             while (*p && *p != ':') {
2667                 char *entry = av_get_token(&p, ",:");
2668                 if (!entry)
2669                     break;
2670                 av_log(NULL, AV_LOG_VERBOSE,
2671                        "Adding '%s' to the entries to show in section '%s'\n",
2672                        entry, section_name);
2673                 av_dict_set(&entries, entry, "", AV_DICT_DONT_STRDUP_KEY);
2674                 if (*p == ',')
2675                     p++;
2676             }
2677         } else {
2678             show_all_entries = 1;
2679         }
2680
2681         ret = match_section(section_name, show_all_entries, entries);
2682         if (ret == 0) {
2683             av_log(NULL, AV_LOG_ERROR, "No match for section '%s'\n", section_name);
2684             ret = AVERROR(EINVAL);
2685         }
2686         av_dict_free(&entries);
2687         av_free(section_name);
2688
2689         if (ret <= 0)
2690             break;
2691         if (*p)
2692             p++;
2693     }
2694
2695     return ret;
2696 }
2697
2698 static int opt_show_format_entry(void *optctx, const char *opt, const char *arg)
2699 {
2700     char *buf = av_asprintf("format=%s", arg);
2701     int ret;
2702
2703     av_log(NULL, AV_LOG_WARNING,
2704            "Option '%s' is deprecated, use '-show_entries format=%s' instead\n",
2705            opt, arg);
2706     ret = opt_show_entries(optctx, opt, buf);
2707     av_free(buf);
2708     return ret;
2709 }
2710
2711 static void opt_input_file(void *optctx, const char *arg)
2712 {
2713     if (input_filename) {
2714         av_log(NULL, AV_LOG_ERROR,
2715                 "Argument '%s' provided as input filename, but '%s' was already specified.\n",
2716                 arg, input_filename);
2717         exit_program(1);
2718     }
2719     if (!strcmp(arg, "-"))
2720         arg = "pipe:";
2721     input_filename = arg;
2722 }
2723
2724 static int opt_input_file_i(void *optctx, const char *opt, const char *arg)
2725 {
2726     opt_input_file(optctx, arg);
2727     return 0;
2728 }
2729
2730 void show_help_default(const char *opt, const char *arg)
2731 {
2732     av_log_set_callback(log_callback_help);
2733     show_usage();
2734     show_help_options(options, "Main options:", 0, 0, 0);
2735     printf("\n");
2736
2737     show_help_children(avformat_get_class(), AV_OPT_FLAG_DECODING_PARAM);
2738 }
2739
2740 /**
2741  * Parse interval specification, according to the format:
2742  * INTERVAL ::= [START|+START_OFFSET][%[END|+END_OFFSET]]
2743  * INTERVALS ::= INTERVAL[,INTERVALS]
2744 */
2745 static int parse_read_interval(const char *interval_spec,
2746                                ReadInterval *interval)
2747 {
2748     int ret = 0;
2749     char *next, *p, *spec = av_strdup(interval_spec);
2750     if (!spec)
2751         return AVERROR(ENOMEM);
2752
2753     if (!*spec) {
2754         av_log(NULL, AV_LOG_ERROR, "Invalid empty interval specification\n");
2755         ret = AVERROR(EINVAL);
2756         goto end;
2757     }
2758
2759     p = spec;
2760     next = strchr(spec, '%');
2761     if (next)
2762         *next++ = 0;
2763
2764     /* parse first part */
2765     if (*p) {
2766         interval->has_start = 1;
2767
2768         if (*p == '+') {
2769             interval->start_is_offset = 1;
2770             p++;
2771         } else {
2772             interval->start_is_offset = 0;
2773         }
2774
2775         ret = av_parse_time(&interval->start, p, 1);
2776         if (ret < 0) {
2777             av_log(NULL, AV_LOG_ERROR, "Invalid interval start specification '%s'\n", p);
2778             goto end;
2779         }
2780     } else {
2781         interval->has_start = 0;
2782     }
2783
2784     /* parse second part */
2785     p = next;
2786     if (p && *p) {
2787         int64_t us;
2788         interval->has_end = 1;
2789
2790         if (*p == '+') {
2791             interval->end_is_offset = 1;
2792             p++;
2793         } else {
2794             interval->end_is_offset = 0;
2795         }
2796
2797         if (interval->end_is_offset && *p == '#') {
2798             long long int lli;
2799             char *tail;
2800             interval->duration_frames = 1;
2801             p++;
2802             lli = strtoll(p, &tail, 10);
2803             if (*tail || lli < 0) {
2804                 av_log(NULL, AV_LOG_ERROR,
2805                        "Invalid or negative value '%s' for duration number of frames\n", p);
2806                 goto end;
2807             }
2808             interval->end = lli;
2809         } else {
2810             ret = av_parse_time(&us, p, 1);
2811             if (ret < 0) {
2812                 av_log(NULL, AV_LOG_ERROR, "Invalid interval end/duration specification '%s'\n", p);
2813                 goto end;
2814             }
2815             interval->end = us;
2816         }
2817     } else {
2818         interval->has_end = 0;
2819     }
2820
2821 end:
2822     av_free(spec);
2823     return ret;
2824 }
2825
2826 static int parse_read_intervals(const char *intervals_spec)
2827 {
2828     int ret, n, i;
2829     char *p, *spec = av_strdup(intervals_spec);
2830     if (!spec)
2831         return AVERROR(ENOMEM);
2832
2833     /* preparse specification, get number of intervals */
2834     for (n = 0, p = spec; *p; p++)
2835         if (*p == ',')
2836             n++;
2837     n++;
2838
2839     read_intervals = av_malloc_array(n, sizeof(*read_intervals));
2840     if (!read_intervals) {
2841         ret = AVERROR(ENOMEM);
2842         goto end;
2843     }
2844     read_intervals_nb = n;
2845
2846     /* parse intervals */
2847     p = spec;
2848     for (i = 0; p; i++) {
2849         char *next;
2850
2851         av_assert0(i < read_intervals_nb);
2852         next = strchr(p, ',');
2853         if (next)
2854             *next++ = 0;
2855
2856         read_intervals[i].id = i;
2857         ret = parse_read_interval(p, &read_intervals[i]);
2858         if (ret < 0) {
2859             av_log(NULL, AV_LOG_ERROR, "Error parsing read interval #%d '%s'\n",
2860                    i, p);
2861             goto end;
2862         }
2863         av_log(NULL, AV_LOG_VERBOSE, "Parsed log interval ");
2864         log_read_interval(&read_intervals[i], NULL, AV_LOG_VERBOSE);
2865         p = next;
2866     }
2867     av_assert0(i == read_intervals_nb);
2868
2869 end:
2870     av_free(spec);
2871     return ret;
2872 }
2873
2874 static int opt_read_intervals(void *optctx, const char *opt, const char *arg)
2875 {
2876     return parse_read_intervals(arg);
2877 }
2878
2879 static int opt_pretty(void *optctx, const char *opt, const char *arg)
2880 {
2881     show_value_unit              = 1;
2882     use_value_prefix             = 1;
2883     use_byte_value_binary_prefix = 1;
2884     use_value_sexagesimal_format = 1;
2885     return 0;
2886 }
2887
2888 static void print_section(SectionID id, int level)
2889 {
2890     const SectionID *pid;
2891     const struct section *section = &sections[id];
2892     printf("%c%c%c",
2893            section->flags & SECTION_FLAG_IS_WRAPPER           ? 'W' : '.',
2894            section->flags & SECTION_FLAG_IS_ARRAY             ? 'A' : '.',
2895            section->flags & SECTION_FLAG_HAS_VARIABLE_FIELDS  ? 'V' : '.');
2896     printf("%*c  %s", level * 4, ' ', section->name);
2897     if (section->unique_name)
2898         printf("/%s", section->unique_name);
2899     printf("\n");
2900
2901     for (pid = section->children_ids; *pid != -1; pid++)
2902         print_section(*pid, level+1);
2903 }
2904
2905 static int opt_sections(void *optctx, const char *opt, const char *arg)
2906 {
2907     printf("Sections:\n"
2908            "W.. = Section is a wrapper (contains other sections, no local entries)\n"
2909            ".A. = Section contains an array of elements of the same type\n"
2910            "..V = Section may contain a variable number of fields with variable keys\n"
2911            "FLAGS NAME/UNIQUE_NAME\n"
2912            "---\n");
2913     print_section(SECTION_ID_ROOT, 0);
2914     return 0;
2915 }
2916
2917 static int opt_show_versions(const char *opt, const char *arg)
2918 {
2919     mark_section_show_entries(SECTION_ID_PROGRAM_VERSION, 1, NULL);
2920     mark_section_show_entries(SECTION_ID_LIBRARY_VERSION, 1, NULL);
2921     return 0;
2922 }
2923
2924 #define DEFINE_OPT_SHOW_SECTION(section, target_section_id)             \
2925     static int opt_show_##section(const char *opt, const char *arg)     \
2926     {                                                                   \
2927         mark_section_show_entries(SECTION_ID_##target_section_id, 1, NULL); \
2928         return 0;                                                       \
2929     }
2930
2931 DEFINE_OPT_SHOW_SECTION(chapters,         CHAPTERS);
2932 DEFINE_OPT_SHOW_SECTION(error,            ERROR);
2933 DEFINE_OPT_SHOW_SECTION(format,           FORMAT);
2934 DEFINE_OPT_SHOW_SECTION(frames,           FRAMES);
2935 DEFINE_OPT_SHOW_SECTION(library_versions, LIBRARY_VERSIONS);
2936 DEFINE_OPT_SHOW_SECTION(packets,          PACKETS);
2937 DEFINE_OPT_SHOW_SECTION(pixel_formats,    PIXEL_FORMATS);
2938 DEFINE_OPT_SHOW_SECTION(program_version,  PROGRAM_VERSION);
2939 DEFINE_OPT_SHOW_SECTION(streams,          STREAMS);
2940 DEFINE_OPT_SHOW_SECTION(programs,         PROGRAMS);
2941
2942 static const OptionDef real_options[] = {
2943 #include "cmdutils_common_opts.h"
2944     { "f", HAS_ARG, {.func_arg = opt_format}, "force format", "format" },
2945     { "unit", OPT_BOOL, {&show_value_unit}, "show unit of the displayed values" },
2946     { "prefix", OPT_BOOL, {&use_value_prefix}, "use SI prefixes for the displayed values" },
2947     { "byte_binary_prefix", OPT_BOOL, {&use_byte_value_binary_prefix},
2948       "use binary prefixes for byte units" },
2949     { "sexagesimal", OPT_BOOL,  {&use_value_sexagesimal_format},
2950       "use sexagesimal format HOURS:MM:SS.MICROSECONDS for time units" },
2951     { "pretty", 0, {.func_arg = opt_pretty},
2952       "prettify the format of displayed values, make it more human readable" },
2953     { "print_format", OPT_STRING | HAS_ARG, {(void*)&print_format},
2954       "set the output printing format (available formats are: default, compact, csv, flat, ini, json, xml)", "format" },
2955     { "of", OPT_STRING | HAS_ARG, {(void*)&print_format}, "alias for -print_format", "format" },
2956     { "select_streams", OPT_STRING | HAS_ARG, {(void*)&stream_specifier}, "select the specified streams", "stream_specifier" },
2957     { "sections", OPT_EXIT, {.func_arg = opt_sections}, "print sections structure and section information, and exit" },
2958     { "show_data",    OPT_BOOL, {(void*)&do_show_data}, "show packets data" },
2959     { "show_data_hash", OPT_STRING | HAS_ARG, {(void*)&show_data_hash}, "show packets data hash" },
2960     { "show_error",   0, {(void*)&opt_show_error},  "show probing error" },
2961     { "show_format",  0, {(void*)&opt_show_format}, "show format/container info" },
2962     { "show_frames",  0, {(void*)&opt_show_frames}, "show frames info" },
2963     { "show_format_entry", HAS_ARG, {.func_arg = opt_show_format_entry},
2964       "show a particular entry from the format/container info", "entry" },
2965     { "show_entries", HAS_ARG, {.func_arg = opt_show_entries},
2966       "show a set of specified entries", "entry_list" },
2967     { "show_packets", 0, {(void*)&opt_show_packets}, "show packets info" },
2968     { "show_programs", 0, {(void*)&opt_show_programs}, "show programs info" },
2969     { "show_streams", 0, {(void*)&opt_show_streams}, "show streams info" },
2970     { "show_chapters", 0, {(void*)&opt_show_chapters}, "show chapters info" },
2971     { "count_frames", OPT_BOOL, {(void*)&do_count_frames}, "count the number of frames per stream" },
2972     { "count_packets", OPT_BOOL, {(void*)&do_count_packets}, "count the number of packets per stream" },
2973     { "show_program_version",  0, {(void*)&opt_show_program_version},  "show ffprobe version" },
2974     { "show_library_versions", 0, {(void*)&opt_show_library_versions}, "show library versions" },
2975     { "show_versions",         0, {(void*)&opt_show_versions}, "show program and library versions" },
2976     { "show_pixel_formats", 0, {(void*)&opt_show_pixel_formats}, "show pixel format descriptions" },
2977     { "show_private_data", OPT_BOOL, {(void*)&show_private_data}, "show private data" },
2978     { "private",           OPT_BOOL, {(void*)&show_private_data}, "same as show_private_data" },
2979     { "bitexact", OPT_BOOL, {&do_bitexact}, "force bitexact output" },
2980     { "read_intervals", HAS_ARG, {.func_arg = opt_read_intervals}, "set read intervals", "read_intervals" },
2981     { "default", HAS_ARG | OPT_AUDIO | OPT_VIDEO | OPT_EXPERT, {.func_arg = opt_default}, "generic catch all option", "" },
2982     { "i", HAS_ARG, {.func_arg = opt_input_file_i}, "read specified file", "input_file"},
2983     { NULL, },
2984 };
2985
2986 static inline int check_section_show_entries(int section_id)
2987 {
2988     int *id;
2989     struct section *section = &sections[section_id];
2990     if (sections[section_id].show_all_entries || sections[section_id].entries_to_show)
2991         return 1;
2992     for (id = section->children_ids; *id != -1; id++)
2993         if (check_section_show_entries(*id))
2994             return 1;
2995     return 0;
2996 }
2997
2998 #define SET_DO_SHOW(id, varname) do {                                   \
2999         if (check_section_show_entries(SECTION_ID_##id))                \
3000             do_show_##varname = 1;                                      \
3001     } while (0)
3002
3003 int main(int argc, char **argv)
3004 {
3005     const Writer *w;
3006     WriterContext *wctx;
3007     char *buf;
3008     char *w_name = NULL, *w_args = NULL;
3009     int ret, i;
3010
3011     av_log_set_flags(AV_LOG_SKIP_REPEATED);
3012     register_exit(ffprobe_cleanup);
3013
3014     options = real_options;
3015     parse_loglevel(argc, argv, options);
3016     av_register_all();
3017     avformat_network_init();
3018     init_opts();
3019 #if CONFIG_AVDEVICE
3020     avdevice_register_all();
3021 #endif
3022
3023     show_banner(argc, argv, options);
3024     parse_options(NULL, argc, argv, options, opt_input_file);
3025
3026     /* mark things to show, based on -show_entries */
3027     SET_DO_SHOW(CHAPTERS, chapters);
3028     SET_DO_SHOW(ERROR, error);
3029     SET_DO_SHOW(FORMAT, format);
3030     SET_DO_SHOW(FRAMES, frames);
3031     SET_DO_SHOW(LIBRARY_VERSIONS, library_versions);
3032     SET_DO_SHOW(PACKETS, packets);
3033     SET_DO_SHOW(PIXEL_FORMATS, pixel_formats);
3034     SET_DO_SHOW(PIXEL_FORMAT_FLAGS, pixel_format_flags);
3035     SET_DO_SHOW(PROGRAM_VERSION, program_version);
3036     SET_DO_SHOW(PROGRAMS, programs);
3037     SET_DO_SHOW(STREAMS, streams);
3038     SET_DO_SHOW(STREAM_DISPOSITION, stream_disposition);
3039     SET_DO_SHOW(PROGRAM_STREAM_DISPOSITION, stream_disposition);
3040
3041     SET_DO_SHOW(CHAPTER_TAGS, chapter_tags);
3042     SET_DO_SHOW(FORMAT_TAGS, format_tags);
3043     SET_DO_SHOW(FRAME_TAGS, frame_tags);
3044     SET_DO_SHOW(PROGRAM_TAGS, program_tags);
3045     SET_DO_SHOW(STREAM_TAGS, stream_tags);
3046
3047     if (do_bitexact && (do_show_program_version || do_show_library_versions)) {
3048         av_log(NULL, AV_LOG_ERROR,
3049                "-bitexact and -show_program_version or -show_library_versions "
3050                "options are incompatible\n");
3051         ret = AVERROR(EINVAL);
3052         goto end;
3053     }
3054
3055     writer_register_all();
3056
3057     if (!print_format)
3058         print_format = av_strdup("default");
3059     if (!print_format) {
3060         ret = AVERROR(ENOMEM);
3061         goto end;
3062     }
3063     w_name = av_strtok(print_format, "=", &buf);
3064     w_args = buf;
3065
3066     if (show_data_hash) {
3067         if ((ret = av_hash_alloc(&hash, show_data_hash)) < 0) {
3068             if (ret == AVERROR(EINVAL)) {
3069                 const char *n;
3070                 av_log(NULL, AV_LOG_ERROR,
3071                        "Unknown hash algorithm '%s'\nKnown algorithms:",
3072                        show_data_hash);
3073                 for (i = 0; (n = av_hash_names(i)); i++)
3074                     av_log(NULL, AV_LOG_ERROR, " %s", n);
3075                 av_log(NULL, AV_LOG_ERROR, "\n");
3076             }
3077             goto end;
3078         }
3079     }
3080
3081     w = writer_get_by_name(w_name);
3082     if (!w) {
3083         av_log(NULL, AV_LOG_ERROR, "Unknown output format with name '%s'\n", w_name);
3084         ret = AVERROR(EINVAL);
3085         goto end;
3086     }
3087
3088     if ((ret = writer_open(&wctx, w, w_args,
3089                            sections, FF_ARRAY_ELEMS(sections))) >= 0) {
3090         if (w == &xml_writer)
3091             wctx->string_validation_utf8_flags |= AV_UTF8_FLAG_EXCLUDE_XML_INVALID_CONTROL_CODES;
3092
3093         writer_print_section_header(wctx, SECTION_ID_ROOT);
3094
3095         if (do_show_program_version)
3096             ffprobe_show_program_version(wctx);
3097         if (do_show_library_versions)
3098             ffprobe_show_library_versions(wctx);
3099         if (do_show_pixel_formats)
3100             ffprobe_show_pixel_formats(wctx);
3101
3102         if (!input_filename &&
3103             ((do_show_format || do_show_programs || do_show_streams || do_show_chapters || do_show_packets || do_show_error) ||
3104              (!do_show_program_version && !do_show_library_versions && !do_show_pixel_formats))) {
3105             show_usage();
3106             av_log(NULL, AV_LOG_ERROR, "You have to specify one input file.\n");
3107             av_log(NULL, AV_LOG_ERROR, "Use -h to get full help or, even better, run 'man %s'.\n", program_name);
3108             ret = AVERROR(EINVAL);
3109         } else if (input_filename) {
3110             ret = probe_file(wctx, input_filename);
3111             if (ret < 0 && do_show_error)
3112                 show_error(wctx, ret);
3113         }
3114
3115         writer_print_section_footer(wctx);
3116         writer_close(&wctx);
3117     }
3118
3119 end:
3120     av_freep(&print_format);
3121     av_freep(&read_intervals);
3122     av_hash_freep(&hash);
3123
3124     uninit_opts();
3125     for (i = 0; i < FF_ARRAY_ELEMS(sections); i++)
3126         av_dict_free(&(sections[i].entries_to_show));
3127
3128     avformat_network_deinit();
3129
3130     return ret < 0;
3131 }