Coverage Report

Created: 2025-07-18 07:04

/src/vlc/modules/demux/mkv/Ebml_parser.cpp
Line
Count
Source (jump to first uncovered line)
1
2
/*****************************************************************************
3
 * EbmlParser for the matroska demuxer
4
 *****************************************************************************
5
 * Copyright (C) 2003-2004 VLC authors and VideoLAN
6
 *
7
 * Authors: Laurent Aimar <fenrir@via.ecp.fr>
8
 *          Steve Lhomme <steve.lhomme@free.fr>
9
 *
10
 * This program is free software; you can redistribute it and/or modify it
11
 * under the terms of the GNU Lesser General Public License as published by
12
 * the Free Software Foundation; either version 2.1 of the License, or
13
 * (at your option) any later version.
14
 *
15
 * This program is distributed in the hope that it will be useful,
16
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18
 * GNU Lesser General Public License for more details.
19
 *
20
 * You should have received a copy of the GNU Lesser General Public License
21
 * along with this program; if not, write to the Free Software Foundation,
22
 * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23
 *****************************************************************************/
24
25
#include "Ebml_parser.hpp"
26
#include "stream_io_callback.hpp"
27
28
namespace mkv {
29
30
/*****************************************************************************
31
 * Ebml Stream parser
32
 *****************************************************************************/
33
EbmlParser::EbmlParser( matroska_iostream_c *es, EbmlElement *el_start, demux_t *p_demux ) :
34
0
    p_demux( p_demux ),
35
0
    m_es( es ),
36
0
    mi_level( 1 ),
37
    m_got( NULL ),
38
0
    mi_user_level( 1 ),
39
0
    mb_keep( false ),
40
0
    mb_dummy( var_InheritBool( p_demux, "mkv-use-dummy" ) )
41
0
{
42
0
    memset( m_el, 0, sizeof( *m_el ) * M_EL_MAXSIZE);
43
0
    m_el[0] = el_start;
44
0
}
45
46
EbmlParser::~EbmlParser( void )
47
0
{
48
0
    if( !mi_level )
49
0
    {
50
0
        assert( !mb_keep );
51
0
        delete m_el[1];
52
0
        return;
53
0
    }
54
55
0
    for( int i = 1; i <= mi_level; i++ )
56
0
    {
57
0
        if( !mb_keep )
58
0
        {
59
0
            delete m_el[i];
60
0
        }
61
0
        mb_keep = false;
62
0
    }
63
0
}
64
65
void EbmlParser::reconstruct( matroska_iostream_c* es, EbmlElement* el_start, demux_t* p_demux )
66
0
{
67
0
    this->~EbmlParser();
68
69
0
    new( static_cast<void*>( this ) ) EbmlParser( es, el_start, p_demux );
70
0
}
71
72
void EbmlParser::Up( void )
73
0
{
74
0
    if( mi_user_level == mi_level && m_el[mi_level] )
75
0
    {
76
0
        msg_Warn( p_demux, "MKV/Ebml Parser: Up cannot escape itself" );
77
0
    }
78
79
0
    mi_user_level--;
80
0
}
81
82
void EbmlParser::Down( void )
83
0
{
84
0
    mi_user_level++;
85
0
    mi_level++;
86
0
}
87
88
void EbmlParser::Keep( void )
89
0
{
90
0
    mb_keep = true;
91
0
}
92
93
void EbmlParser::Unkeep()
94
0
{
95
0
    mb_keep = false;
96
0
}
97
98
int EbmlParser::GetLevel( void ) const
99
0
{
100
0
    return mi_user_level;
101
0
}
102
103
void EbmlParser::Reset( demux_t *p_demux )
104
0
{
105
0
    while ( mi_level > 0)
106
0
    {
107
0
        delete m_el[mi_level];
108
0
        m_el[mi_level] = NULL;
109
0
        mi_level--;
110
0
    }
111
0
    this->p_demux = p_demux;
112
0
    mi_user_level = mi_level = 1;
113
    // a little faster and cleaner
114
0
    m_es->I_O().setFilePointer( static_cast<EbmlMaster*>(m_el[0])->GetDataStart() );
115
0
}
116
117
118
static const EbmlSemanticContext & GetEbmlNoGlobal_Context();
119
static const EbmlSemanticContext EbmlNoGlobal_Context = EbmlSemanticContext(0, NULL, NULL, *GetEbmlNoGlobal_Context, NULL);
120
static const EbmlSemanticContext & GetEbmlNoGlobal_Context()
121
0
{
122
0
  return EbmlNoGlobal_Context;
123
0
}
124
125
// the Segment Context should not allow Void or CRC32 elements to avoid lookup false alarm
126
DEFINE_START_SEMANTIC(KaxSegmentVLC)
127
DEFINE_SEMANTIC_ITEM(true, true, EbmlHead)
128
DEFINE_SEMANTIC_ITEM(false, false, KaxSegment)
129
DEFINE_END_SEMANTIC(KaxSegmentVLC)
130
131
DEFINE_xxx_CONTEXT(KaxSegmentVLC,GetEbmlNoGlobal_Context)
132
133
134
EbmlElement *EbmlParser::Get( bool allow_overshoot )
135
0
{
136
0
    int i_ulev = 0;
137
0
    int n_call = 0;
138
0
    EbmlElement *p_prev = NULL;
139
0
    bool do_read = true;
140
141
0
    if( mi_user_level != mi_level )
142
0
    {
143
0
        return NULL;
144
0
    }
145
0
    if( m_got )
146
0
    {
147
0
        EbmlElement *ret = m_got;
148
0
        m_got = NULL;
149
150
0
        return ret;
151
0
    }
152
153
0
next:
154
0
    p_prev = m_el[mi_level];
155
0
    if( p_prev )
156
0
        p_prev->SkipData( *m_es, EBML_CONTEXT(p_prev) );
157
158
0
    uint64_t i_max_read;
159
0
    if (mi_level == 0)
160
0
        i_max_read = UINT64_MAX;
161
0
    else if (!m_el[mi_level-1]->IsFiniteSize())
162
0
        i_max_read = UINT64_MAX;
163
0
    else if (!p_prev)
164
0
    {
165
0
        i_max_read = m_el[mi_level-1]->GetSize();
166
0
        if (i_max_read == 0)
167
0
        {
168
            /* check if the parent still has data to read */
169
0
            if ( mi_level > 1 && m_el[mi_level-2]->IsFiniteSize() &&
170
0
                 m_el[mi_level-1]->GetEndPosition() < m_el[mi_level-2]->GetEndPosition() )
171
0
            {
172
0
                uint64_t top = m_el[mi_level-2]->GetEndPosition();
173
0
                uint64_t bom = m_el[mi_level-1]->GetEndPosition();
174
0
                i_max_read = top - bom;
175
0
            }
176
0
        }
177
0
    }
178
0
    else {
179
0
        size_t size_lvl = mi_level;
180
0
        while ( size_lvl && m_el[size_lvl-1]->IsFiniteSize() && m_el[size_lvl]->IsFiniteSize() &&
181
0
                m_el[size_lvl-1]->GetEndPosition() == m_el[size_lvl]->GetEndPosition() )
182
0
            size_lvl--;
183
0
        if (size_lvl == 0 && !allow_overshoot)
184
0
        {
185
0
            i_ulev = mi_level; // trick to go all the way up
186
0
            m_el[mi_level] = NULL;
187
0
            do_read = false;
188
0
        }
189
0
        else if (size_lvl == 0 || !m_el[size_lvl-1]->IsFiniteSize() || !m_el[size_lvl]->IsFiniteSize() )
190
0
            i_max_read = UINT64_MAX;
191
0
        else {
192
0
            uint64_t top = m_el[size_lvl-1]->GetEndPosition();
193
0
            uint64_t bom = m_el[mi_level]->GetEndPosition();
194
0
            i_max_read = top - bom;
195
0
        }
196
0
    }
197
198
0
    if (do_read)
199
0
    {
200
        // If the parent is a segment, use the segment context when creating children
201
        // (to prolong their lifetime), otherwise just continue as normal
202
0
        EbmlSemanticContext e_context =
203
0
                EBML_CTX_MASTER( EBML_CONTEXT(m_el[mi_level - 1]) ) == EBML_CTX_MASTER( Context_KaxSegmentVLC )
204
0
                ? Context_KaxSegmentVLC
205
0
                : EBML_CONTEXT(m_el[mi_level - 1]);
206
207
        /* Ignore unknown level 0 or 1 elements */
208
0
        m_el[mi_level] = unlikely(!i_max_read) ? NULL :
209
0
                         m_es->FindNextElement( e_context,
210
0
                                                i_ulev, i_max_read,
211
0
                                                (  mb_dummy | (mi_level > 1) ), 1 );
212
213
0
        if( m_el[mi_level] == NULL )
214
0
        {
215
0
            if ( i_max_read != UINT64_MAX && !m_es->I_O().IsEOF() )
216
0
            {
217
0
                msg_Dbg(p_demux, "found nothing, go up");
218
0
                i_ulev = 1;
219
0
            }
220
0
        }
221
0
    }
222
223
0
    if( i_ulev > 0 )
224
0
    {
225
0
        if( p_prev )
226
0
        {
227
0
            if( !mb_keep )
228
0
            {
229
0
                delete p_prev;
230
0
                p_prev = NULL;
231
0
            }
232
0
            mb_keep = false;
233
0
        }
234
0
        while( i_ulev > 0 )
235
0
        {
236
0
            if( mi_level == 1 )
237
0
            {
238
0
                mi_level = 0;
239
0
                return NULL;
240
0
            }
241
242
0
            delete m_el[mi_level - 1];
243
0
            m_got = m_el[mi_level -1] = m_el[mi_level];
244
0
            m_el[mi_level] = NULL;
245
246
0
            mi_level--;
247
0
            i_ulev--;
248
0
        }
249
0
        return NULL;
250
0
    }
251
0
    else if( m_el[mi_level] == NULL )
252
0
    {
253
0
        msg_Dbg( p_demux,"MKV/Ebml Parser: m_el[mi_level] == NULL" );
254
        /* go back to the end of the parent */
255
0
        if( p_prev )
256
0
            p_prev->SkipData( *m_es, EBML_CONTEXT(p_prev) );
257
0
    }
258
0
    else if( m_el[mi_level]->IsDummy() && !mb_dummy )
259
0
    {
260
0
        bool b_bad_position = false;
261
        /* We got a dummy element but don't want those...
262
         * perform a sanity check */
263
0
        if( !mi_level )
264
0
        {
265
0
            msg_Err(p_demux, "Got invalid lvl 0 element... Aborting");
266
0
            return NULL;
267
0
        }
268
269
0
        if( mi_level > 1 &&
270
0
            p_prev && p_prev->IsFiniteSize() &&
271
0
            p_prev->GetEndPosition() != m_el[mi_level]->GetElementPosition() )
272
0
        {
273
0
            msg_Err( p_demux, "Dummy Element at unexpected position... corrupted file?" );
274
0
            b_bad_position = true;
275
0
        }
276
277
0
        if( n_call < M_EL_MAXSIZE && !b_bad_position && m_el[mi_level]->IsFiniteSize() &&
278
0
            ( !m_el[mi_level-1]->IsFiniteSize() ||
279
0
              m_el[mi_level]->GetEndPosition() <= m_el[mi_level-1]->GetEndPosition() ) )
280
0
        {
281
            /* The element fits inside its upper element */
282
0
            msg_Warn( p_demux, "Dummy element found %" PRIu64 "... skipping it",
283
0
                      m_el[mi_level]->GetElementPosition() );
284
0
            if( p_prev )
285
0
            {
286
0
                if( !mb_keep )
287
0
                {
288
0
                    delete p_prev;
289
0
                    p_prev = NULL;
290
0
                }
291
0
                mb_keep = false;
292
0
            }
293
0
            n_call++;
294
0
            goto next;
295
0
        }
296
0
        else
297
0
        {
298
            /* Too large, misplaced or M_EL_MAXSIZE successive dummy elements */
299
0
            msg_Err( p_demux,
300
0
                     "Dummy element too large or misplaced at %" PRIu64 "... skipping to next upper element",
301
0
                     m_el[mi_level]->GetElementPosition() );
302
303
0
            if( mi_level >= 1 &&
304
0
                m_el[mi_level]->IsFiniteSize() && m_el[mi_level-1]->IsFiniteSize() &&
305
0
                m_el[mi_level]->GetElementPosition() >= m_el[mi_level-1]->GetEndPosition() )
306
0
            {
307
0
                msg_Err(p_demux, "This element is outside its known parent... upping level");
308
0
                delete m_el[mi_level - 1];
309
0
                m_got = m_el[mi_level -1] = m_el[mi_level];
310
0
                m_el[mi_level] = NULL;
311
312
0
                mi_level--;
313
0
                return NULL;
314
0
            }
315
316
0
            if( p_prev )
317
0
            {
318
0
                if( !mb_keep )
319
0
                {
320
0
                    delete p_prev;
321
0
                    p_prev = NULL;
322
0
                }
323
0
                mb_keep = false;
324
0
            }
325
0
            goto next;
326
0
        }
327
0
    }
328
329
0
    if( p_prev )
330
0
    {
331
0
        if( !mb_keep )
332
0
        {
333
0
            delete p_prev;
334
0
        }
335
0
        mb_keep = false;
336
0
    }
337
0
    return m_el[mi_level];
338
0
}
339
340
bool EbmlParser::IsTopPresent( EbmlElement *el ) const
341
0
{
342
0
    for( int i = 0; i < mi_level; i++ )
343
0
    {
344
0
        if( m_el[i] && m_el[i] == el )
345
0
            return true;
346
0
    }
347
0
    return false;
348
0
}
349
350
} // namespace