#include <tsTablesLogger.h>

Inheritance diagram for ts::TablesLogger:

[legend]

Collaboration diagram for ts::TablesLogger:

[legend]

Public Member Functions
	TablesLogger (TablesDisplay &display)
virtual	~TablesLogger () override
void	close ()
bool	completed () const
void	defineArgs (Args &args)
void	feedPacket (const TSPacket &pkt)
bool	hasErrors () const
bool	loadArgs (DuckContext &duck, Args &args)
bool	open ()
void	reportDemuxErrors (Report &report, int level=Severity::Info)
void	reportDemuxErrors (std::ostream &strm)
void	setSectionHandler (SectionHandlerInterface *h)
void	setTableHandler (TableHandlerInterface *h)

Static Public Member Functions
static bool	AnalyzeUDPMessage (const duck::Protocol &protocol, const uint8_t *data, size_t size, bool no_encapsulation, SectionPtrVector &sections, Time &timestamp)

Static Public Attributes
static constexpr size_t	DEFAULT_LOG_SIZE = 8

Protected Member Functions
virtual void	handleInvalidSection (SectionDemux &, const DemuxedData &, Section::Status) override
virtual void	handleSection (SectionDemux &, const Section &) override
virtual void	handleTable (SectionDemux &, const BinaryTable &) override

Detailed Description

This class logs sections and tables.

Constructor & Destructor Documentation

◆ TablesLogger()

ts::TablesLogger::TablesLogger ( TablesDisplay & display )

Constructor.

Parameters

[in,out] display Object to display tables and sections.

◆ ~TablesLogger()

virtual ts::TablesLogger::~TablesLogger ( )

overridevirtual

Destructor.

Member Function Documentation

◆ defineArgs()

void ts::TablesLogger::defineArgs ( Args & args )

Add command line option definitions in an Args.

Parameters

[in,out] args Command line arguments to update.

◆ loadArgs()

bool ts::TablesLogger::loadArgs	(	DuckContext &	duck,
		Args &	args )

Load arguments from command line. Args error indicator is set in case of incorrect arguments.

Parameters

[in,out]	duck	TSDuck execution context.
[in,out]	args	Command line arguments.

Returns: True on success, false on error in argument line.

◆ setTableHandler()

void ts::TablesLogger::setTableHandler ( TableHandlerInterface * h )

inline

Set a table handler which is called for each complete table in addition to logging. When the table handler or the section handler is not null, there is no default logging. To have the tables or sections displayed, you must explicitly specify --text-output -.

Parameters

[in] h The new table handler.

◆ setSectionHandler()

void ts::TablesLogger::setSectionHandler ( SectionHandlerInterface * h )

inline

Set a section handler which is called for each section in addition to logging. When the table handler or the section handler is not null, there is no default logging. To have the tables or sections displayed, you must explicitly specify --text-output -.

Parameters

[in] h The new handler.

◆ feedPacket()

void ts::TablesLogger::feedPacket ( const TSPacket & pkt )

The following method feeds the logger with a TS packet.

Parameters

[in] pkt A new transport stream packet.

◆ open()

bool ts::TablesLogger::open ( )

Open files, start operations. The options must have been loaded first.

Returns: True on success, false on error.

◆ close()

void ts::TablesLogger::close ( )

Close all operations, flush tables if required, close files and sockets. No longer accept packets. Automatically done in destructor.

◆ hasErrors()

bool ts::TablesLogger::hasErrors ( ) const

inline

Check if an error was found.

Returns: True when an error was found.

◆ completed()

bool ts::TablesLogger::completed ( ) const

inline

Check if the operation is complete.

Returns: True when the operation is complete (eg. max number of logged tables reached).

◆ reportDemuxErrors() [1/2]

void ts::TablesLogger::reportDemuxErrors ( std::ostream & strm )

Report the demux errors (if any).

Parameters

[in,out] strm Output text stream.

◆ reportDemuxErrors() [2/2]

void ts::TablesLogger::reportDemuxErrors	(	Report &	report,
		int	level = Severity::Info )

Report the demux errors (if any).

Parameters

[in,out]	report	Output Report object.
[in]	level	Severity level to report.

◆ AnalyzeUDPMessage()

bool ts::TablesLogger::AnalyzeUDPMessage	(	const duck::Protocol &	protocol,
		const uint8_t *	data,
		size_t	size,
		bool	no_encapsulation,
		SectionPtrVector &	sections,
		Time &	timestamp )

static

Static routine to analyze UDP messages as sent by the table logger (option –ip-udp).

Parameters

[in]	protocol	Instance of TLV protocol to analyze UDP message.
[in]	data	Address of UDP message.
[in]	size	Size in bytes of UDP message.
[in]	no_encapsulation	When true, the UDP message contains raw sections. When false, the UDP message contains a TLV structure.
[out]	sections	List of sections in the message.
[out]	timestamp	Time of the collection of the table. Available only in TLV message. Contains Time::Epoch if not available.

Returns: True on success, false on invalid message.

◆ handleTable()

virtual void ts::TablesLogger::handleTable	(	SectionDemux &	demux,
		const BinaryTable &	table )

overrideprotectedvirtual

This hook is invoked when a complete table is available. Tables with long sections are reported only when a new version is available.

Parameters

[in,out]	demux	A reference to the section demux.
[in]	table	A reference to the demultiplexed table.

Implements ts::TableHandlerInterface.

◆ handleSection()

virtual void ts::TablesLogger::handleSection	(	SectionDemux &	demux,
		const Section &	section )

overrideprotectedvirtual

This hook is invoked when a complete section is available.

Parameters

[in,out]	demux	The demux which sends the section.
[in]	section	The new section from the demux.

Implements ts::SectionHandlerInterface.

◆ handleInvalidSection()

virtual void ts::TablesLogger::handleInvalidSection	(	SectionDemux &	demux,
		const DemuxedData &	data,
		Section::Status	status )

overrideprotectedvirtual

This hook is invoked when an invalid section is detected.

Parameters

[in,out]	demux	The demux which sends the section.
[in]	data	The invalid section from the demux.
[in]	status	Reason for the section to be invalid.

Implements ts::InvalidSectionHandlerInterface.

Member Data Documentation

◆ DEFAULT_LOG_SIZE

size_t ts::TablesLogger::DEFAULT_LOG_SIZE = 8

staticconstexpr

Default table log size. With option --log, specify how many bytes are displayed at the beginning of the table payload (the header is not displayed). The default is 8 bytes.

The documentation for this class was generated from the following file:

tsTablesLogger.h

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ TablesLogger()

◆ ~TablesLogger()

Member Function Documentation

◆ defineArgs()

◆ loadArgs()

◆ setTableHandler()

◆ setSectionHandler()

◆ feedPacket()

◆ open()

◆ close()

◆ hasErrors()

◆ completed()

◆ reportDemuxErrors() [1/2]

◆ reportDemuxErrors() [2/2]

◆ AnalyzeUDPMessage()

◆ handleTable()

◆ handleSection()

◆ handleInvalidSection()

Member Data Documentation

◆ DEFAULT_LOG_SIZE