view libtest/tw5reader.h @ 585:3c6bf0d26ee7 default tip

TW-TS-005 reader: fix maximum line length bug TW-TS-005 section 4.1 states: The maximum allowed length of each line is 80 characters, not including the OS-specific newline encoding. The implementation of this line length limit in the TW-TS-005 hex file reader function in the present suite was wrong, such that lines of the full maximum length could not be read. Fix it. Note that this bug affects comment lines too, not just actual RTP payloads. Neither Annex A nor Annex B features an RTP payload format that goes to the maximum of 40 bytes, but if a comment line goes to the maximum allowed length of 80 characters not including the terminating newline, the bug will be triggered, necessitating the present fix.
author Mychaela Falconia <falcon@freecalypso.org>
date Tue, 25 Feb 2025 07:49:28 +0000
parents 4d2cccaeb4a7
children
line wrap: on
line source

/*
 * This header file defines the interface to our reader function for
 * hexadecimal RTP frame sequence files in TW-TS-005 format.
 *
 * twts005_read_frame() return values are:
 *  1 = successfully read valid frame
 *  0 = normal EOF
 * -1 = read line with invalid content
 * -2 = line too long or missing newline
 *
 * The reader function skips blank, whitespace-only and comment lines,
 * returning only actual frames.  lineno variable must be initialized to 0
 * by the application program, but not touched otherwise.  In case of an
 * error, this variable will hold the line number at which the error was
 * encountered.
 */

#define	TWTS005_MAX_FRAME	40

int twts005_read_frame(FILE *hexf, unsigned *lineno, uint8_t *frame,
			unsigned *lenp);