dvb_table(3)

📦
version 1.32.0 · 2 versions
, in fedora 43

🌸 NAME 🌸

dvb_table — Digital TV table parsing. Yes bestie, this is the one. It's dvb_table(3) from the Library Functions Manual, and it's a whole universe of headers, structs, macros and typedefs for pulling apart MPEG-TS and ATSC tables. Buckle up. 💅

✨ SYNOPSIS ✨

🎀 Files 🎀

Okay so these are all the headers in the group, and each one does a thing. Slay.

  • descriptors.h — the way you handle MPEG-TS descriptors found on Digital TV streams.
  • header.h — gives you the MPEG TS table headers.
  • atsc_header.h — some common ATSC stuff lives here.
  • atsc_eit.h — the table parser for the ATSC EIT (Event Information Table).
  • cat.h — the table parser for the CAT (Conditional Access Table).
  • eit.h — the table parser for the DVB EIT (Event Information Table).
  • mgt.h — the table parser for the ATSC MGT (Master Guide Table).
  • nit.h — the descriptors for the NIT MPEG-TS table.
  • pat.h — the descriptors for the PAT MPEG-TS table.
  • pmt.h — the descriptors for the PMT MPEG-TS table.
  • sdt.h — the descriptors for the SDT MPEG-TS table.
  • vct.h — the descriptors for TVCT and CVCT tables.
  • mpeg_es.h — the table parser for the MPEG-TS Elementary Stream.
  • mpeg_pes.h — the table parser for the MPEG-PES Elementary Stream.
  • mpeg_ts.h — the table parser for the MPEG-PES Elementary Stream. (Yes, it says MPEG-PES again. That's what the page says, so that's what you get. 🙈)

🦋 Data Structures 🦋

The little guys. The building blocks. The main characters of the whole operation.

  • struct dvb_desc — a linked list holding all the descriptors found on an MPEG-TS table.
  • struct dvb_descriptor — holds the parser information for the MPEG-TS parser code.
  • struct dvb_ts_packet_header — the header of an MPEG-TS transport packet.
  • struct dvb_table_header — the header of an MPEG-TS table.
  • struct atsc_table_eit_event — ATSC EIT event table.
  • union atsc_table_eit_desc_length — ATSC EIT descriptor length.
  • struct atsc_table_eit — ATSC EIT table.
  • struct dvb_table_eit_event — DVB EIT event table.
  • struct dvb_table_eit — DVB EIT table.
  • struct atsc_table_mgt_table — ATSC tables description at MGT table.
  • struct atsc_table_mgt — ATSC MGT table.
  • union dvb_table_nit_transport_header — MPEG-TS NIT transport header.
  • struct dvb_table_nit_transport — MPEG-TS NIT transport table.
  • struct dvb_table_nit — MPEG-TS NIT table.
  • struct dvb_table_pat_program — MPEG-TS PAT program table.
  • struct dvb_table_pat — MPEG-TS PAT table.
  • struct dvb_table_pmt_stream — MPEG-TS PMT stream table.
  • struct dvb_table_pmt — MPEG-TS PMT table.
  • struct dvb_table_sdt_service — MPEG-TS SDT service table.
  • struct dvb_table_sdt — MPEG-TS SDT table.
  • struct atsc_table_vct_channel — ATSC VCT channel table (covers both CVCT and TVCT).
  • struct atsc_table_vct — ATSC VCT table (covers both CVCT and TVCT).
  • union atsc_table_vct_descriptor_length — ATSC VCT descriptor length.
  • struct dvb_mpeg_es_seq_start — MPEG ES Sequence header.
  • struct dvb_mpeg_es_pic_start — MPEG ES Picture start header.
  • struct ts_t — MPEG PES timestamp structure, used for dts and pts.
  • struct dvb_mpeg_pes_optional — MPEG PES optional header.
  • struct dvb_mpeg_pes — MPEG PES data structure.
  • struct dvb_mpeg_ts_adaption — MPEG TS header adaption field.
  • struct dvb_mpeg_ts — MPEG TS header.

👑 Macros 👑

The preprocessor girlies. Every single one, no skipping, that's the rule. 💜

  • #define DVB_MAX_PAYLOAD_PACKET_SIZE — Maximum size of a table session to be parsed.
  • #define DVB_CRC_SIZE — number of bytes for the descriptor's CRC check.
  • #define ATSC_BASE_PID — ATSC PID for the Program and System Information Protocol.
  • #define ATSC_TABLE_EIT — ATSC EIT table ID.
  • #define atsc_eit_event_foreach(_event, _eit) — Macro used to find event on an ATSC EIT table.
  • #define DVB_TABLE_CAT — ATSC CAT table ID.
  • #define DVB_TABLE_CAT_PID — ATSC PID table ID.
  • #define DVB_TABLE_EIT — DVB EIT table ID for the actual TS.
  • #define DVB_TABLE_EIT_OTHER — DVB EIT table ID for other TS.
  • #define DVB_TABLE_EIT_PID — DVB EIT Program ID.
  • #define DVB_TABLE_EIT_SCHEDULE — Start table ID for the DVB EIT schedule data on the actual TS. The range has 0x0f elements (0x50 to 0x5F).
  • #define DVB_TABLE_EIT_SCHEDULE_OTHER — Start table ID for the DVB EIT schedule data on other TS. The range has 0x0f elements (0x60 to 0x6F).
  • #define dvb_eit_event_foreach(_event, _eit) — Macro used to find event on a DVB EIT table.
  • #define ATSC_TABLE_MGT — ATSC MGT table ID.
  • #define DVB_TABLE_NIT — NIT table ID.
  • #define DVB_TABLE_NIT2 — NIT table ID (alternative table ID).
  • #define DVB_TABLE_NIT_PID — NIT Program ID.
  • #define dvb_nit_transport_foreach(_tran, _nit) — Macro used to find a transport inside a NIT table.
  • #define DVB_TABLE_PAT — PAT table ID.
  • #define DVB_TABLE_PAT_PID — PAT Program ID.
  • #define dvb_pat_program_foreach(_pgm, _pat) — Macro used to find programs on a PAT table.
  • #define DVB_TABLE_PMT — PMT table ID.
  • #define dvb_pmt_stream_foreach(_stream, _pmt) — Macro used to find streams on a PMT table.
  • #define DVB_TABLE_SDT — SDT table ID.
  • #define DVB_TABLE_SDT2 — SDT table ID (alternative table ID).
  • #define DVB_TABLE_SDT_PID — SDT Program ID.
  • #define dvb_sdt_service_foreach(_service, _sdt) — Macro used to find services on a SDT table.
  • #define ATSC_TABLE_TVCT — TVCT table ID.
  • #define ATSC_TABLE_CVCT — CVCT table ID.
  • #define ATSC_TABLE_VCT_PID — Program ID with the VCT tables on it.
  • #define atsc_vct_channel_foreach(_channel, _vct) — Macro used to find channels on a VCT table.
  • #define DVB_MPEG_ES_PIC_START — Picture Start.
  • #define DVB_MPEG_ES_USER_DATA — User Data.
  • #define DVB_MPEG_ES_SEQ_START — Sequence Start.
  • #define DVB_MPEG_ES_SEQ_EXT — Extension.
  • #define DVB_MPEG_ES_GOP — Group Of Pictures.
  • #define DVB_MPEG_ES_SLICES — Slices.
  • #define DVB_MPEG_PES — MPEG Packetized Elementary Stream magic.
  • #define DVB_MPEG_PES_AUDIO — PES Audio.
  • #define DVB_MPEG_PES_VIDEO — PES Video.
  • #define DVB_MPEG_STREAM_MAP — PES Stream map.
  • #define DVB_MPEG_STREAM_PADDING — PES padding.
  • #define DVB_MPEG_STREAM_PRIVATE_2 — PES private.
  • #define DVB_MPEG_STREAM_ECM — PES ECM Stream.
  • #define DVB_MPEG_STREAM_EMM — PES EMM Stream.
  • #define DVB_MPEG_STREAM_DIRECTORY — PES Stream directory.
  • #define DVB_MPEG_STREAM_DSMCC — PES DSMCC.
  • #define DVB_MPEG_STREAM_H222E — PES H.222.1 type E.
  • #define DVB_MPEG_TS — MPEG Transport Stream magic.
  • #define DVB_MPEG_TS_PACKET_SIZE — Size of an MPEG packet.

🌈 Typedefs 🌈

The function-prototype glow-ups. These are the shapes every callback has to match, so keep them exactly as written, fr fr. 🫶

  • typedef void(* dvb_table_init_func) (struct dvb_v5_fe_parms *parms, const uint8_t *buf, ssize_t buflen, void **table) — function prototype for a function that initializes the descriptors parsing on a table.
  • typedef int(* dvb_desc_init_func) (struct dvb_v5_fe_parms *parms, const uint8_t *buf, struct dvb_desc *desc) — function prototype for the descriptors parsing init code.
  • typedef void(* dvb_desc_print_func) (struct dvb_v5_fe_parms *parms, const struct dvb_desc *desc) — function prototype for the descriptors parsing print code.
  • typedef void(* dvb_desc_free_func) (struct dvb_desc *desc) — function prototype for the descriptors memory free code.
  • typedef void nit_handler_callback_t(struct dvb_table_nit *nit, struct dvb_desc *desc, void *priv) — typedef for a callback used when a NIT table entry is found.
  • typedef void nit_tran_handler_callback_t(struct dvb_table_nit *nit, struct dvb_table_nit_transport *tran, struct dvb_desc *desc, void *priv) — typedef for a callback used when a NIT transport table entry is found.
  • typedef int(* dvb_desc_ext_init_func) (struct dvb_v5_fe_parms *parms, const uint8_t *buf, struct dvb_extension_descriptor *ext, void *desc) — function prototype for the extended descriptors parsing init code.
  • typedef void(* dvb_desc_ext_print_func) (struct dvb_v5_fe_parms *parms, const struct dvb_extension_descriptor *ext, const void *desc) — function prototype for the extended descriptors parsing print code.
  • typedef void(* dvb_desc_ext_free_func) (const void *desc) — function prototype for the extended descriptors parsing free code.
Bestie this is only part one. There's more coming, so don't go anywhere. 🍓

✨ Enumerations ✨

okay bestie, this is where the named constants live. It’s giving alphabetized chaos but make it cute. These enums are the building blocks for descriptors and stream types, and you’re gonna want them memorized. No cap. 💅

🌸 enum descriptors 🌸

enum descriptors { video_stream_descriptor, audio_stream_descriptor,
    hierarchy_descriptor, registration_descriptor,
    ds_alignment_descriptor, target_background_grid_descriptor,
    video_window_descriptor, conditional_access_descriptor,
    iso639_language_descriptor, system_clock_descriptor,
    multiplex_buffer_utilization_descriptor, copyright_descriptor,
    maximum_bitrate_descriptor, private_data_indicator_descriptor,
    smoothing_buffer_descriptor, std_descriptor, ibp_descriptor,
    mpeg4_video_descriptor, mpeg4_audio_descriptor, iod_descriptor,
    sl_descriptor, fmc_descriptor, external_es_id_descriptor,
    muxcode_descriptor, fmxbuffersize_descriptor,
    multiplexbuffer_descriptor, content_labeling_descriptor,
    metadata_pointer_descriptor, metadata_descriptor,
    metadata_std_descriptor, AVC_video_descriptor, ipmp_descriptor,
    AVC_timing_and_HRD_descriptor, mpeg2_aac_audio_descriptor,
    flexmux_timing_descriptor, network_name_descriptor,
    service_list_descriptor, stuffing_descriptor,
    satellite_delivery_system_descriptor,
    cable_delivery_system_descriptor, VBI_data_descriptor,
    VBI_teletext_descriptor, bouquet_name_descriptor,
    service_descriptor, country_availability_descriptor,
    linkage_descriptor, NVOD_reference_descriptor,
    time_shifted_service_descriptor, short_event_descriptor,
    extended_event_descriptor, time_shifted_event_descriptor,
    component_descriptor, mosaic_descriptor,
    stream_identifier_descriptor, CA_identifier_descriptor,
    content_descriptor, parental_rating_descriptor, teletext_descriptor,
    telephone_descriptor, local_time_offset_descriptor,
    subtitling_descriptor, terrestrial_delivery_system_descriptor,
    multilingual_network_name_descriptor,
    multilingual_bouquet_name_descriptor,
    multilingual_service_name_descriptor,
    multilingual_component_descriptor,
    private_data_specifier_descriptor, service_move_descriptor,
    short_smoothing_buffer_descriptor, frequency_list_descriptor,
    partial_transport_stream_descriptor, data_broadcast_descriptor,
    scrambling_descriptor, data_broadcast_id_descriptor,
    transport_stream_descriptor, DSNG_descriptor, PDC_descriptor,
    AC_3_descriptor, ancillary_data_descriptor, cell_list_descriptor,
    cell_frequency_link_descriptor, announcement_support_descriptor,
    application_signalling_descriptor, adaptation_field_data_descriptor,
    service_identifier_descriptor, service_availability_descriptor,
    default_authority_descriptor, related_content_descriptor,
    TVA_id_descriptor, content_identifier_descriptor,
    time_slice_fec_identifier_descriptor,
    ECM_repetition_rate_descriptor,
    S2_satellite_delivery_system_descriptor, enhanced_AC_3_descriptor,
    DTS_descriptor, AAC_descriptor, XAIT_location_descriptor,
    FTA_content_management_descriptor, extension_descriptor,
    CUE_identifier_descriptor, extended_channel_name, service_location,
    component_name_descriptor, logical_channel_number_descriptor,
    carousel_id_descriptor, association_tag_descriptor,
    deferred_association_tags_descriptor,
    hierarchical_transmission_descriptor,
    digital_copy_control_descriptor, network_identifier_descriptor,
    partial_transport_stream_time_descriptor,
    audio_component_descriptor, hyperlink_descriptor,
    target_area_descriptor, data_contents_descriptor,
    video_decode_control_descriptor, download_content_descriptor,
    CA_EMM_TS_descriptor, CA_contract_information_descriptor,
    CA_service_descriptor, TS_Information_descriptor,
    extended_broadcaster_descriptor, logo_transmission_descriptor,
    basic_local_event_descriptor, reference_descriptor,
    node_relation_descriptor, short_node_information_descriptor,
    STC_reference_descriptor, series_descriptor, event_group_descriptor,
    SI_parameter_descriptor, broadcaster_Name_Descriptor,
    component_group_descriptor, SI_prime_TS_descriptor,
    board_information_descriptor, LDT_linkage_descriptor,
    connected_transmission_descriptor, content_availability_descriptor,
    service_group_descriptor, carousel_compatible_composite_descriptor,
    conditional_playback_descriptor, ISDBT_delivery_system_descriptor,
    partial_reception_descriptor, emergency_information_descriptor,
    data_component_descriptor, system_management_descriptor,
    atsc_stuffing_descriptor, atsc_ac3_audio_descriptor,
    atsc_caption_service_descriptor, atsc_content_advisory_descriptor,
    atsc_extended_channel_descriptor, atsc_service_location_descriptor,
    atsc_time_shifted_service_descriptor,
    atsc_component_name_descriptor,
    atsc_DCC_departing_request_descriptor,
    atsc_DCC_arriving_request_descriptor,
    atsc_redistribution_control_descriptor,
    atsc_ATSC_private_information_descriptor, atsc_genre_descriptor }

This one is literally the master list containing all descriptors used by Digital TV MPEG-TS. It’s long, it’s iconic, it ate. Every single descriptor name is in there, so if you’re looking for atsc_genre_descriptor or extended_channel_name, boom, it’s here. 🫶

🦋 enum dvb_streams 🦋

enum dvb_streams { stream_video, stream_video_h262, stream_audio,
    stream_audio_13818_3, stream_private_sections, stream_private_data,
    stream_mheg, stream_h222, stream_h222_1, stream_13818_6_A,
    stream_13818_6_B, stream_13818_6_C, stream_13818_6_D,
    stream_h222_aux, stream_audio_adts, stream_video_14496_2,
    stream_audio_latm, stream_14496_1_pes, stream_14496_1_iso,
    stream_download, stream_video_h264, stream_audio_14496_3,
    stream_video_hevc, stream_video_cavs, stream_video_moto,
    stream_audio_a52, stream_scte_27, stream_audio_sdds,
    stream_audio_dts_hdmv, stream_audio_e_ac3, stream_audio_dts,
    stream_audio_a52_vls, stream_spu_vls, stream_audio_sdds2 }

Add support for MPEG-TS Stream types. This enum is where you declare the stream types you’re rolling with. From stream_video to stream_audio_sdds2, it’s all here. Lowkey a whole mood. ✨

🎀 enum dvb_mpeg_es_frame_t 🎀

enum dvb_mpeg_es_frame_t { DVB_MPEG_ES_FRAME_UNKNOWN,
    DVB_MPEG_ES_FRAME_I, DVB_MPEG_ES_FRAME_P, DVB_MPEG_ES_FRAME_B,
    DVB_MPEG_ES_FRAME_D }

MPEG frame types, bestie. That’s it. The I, P, B, D squad plus DVB_MPEG_ES_FRAME_UNKNOWN for when you just don’t know. It’s giving mystery. 💀

🛠️ Functions 🛠️

okay bestie, this is the function roll call and it is long, but every single one is here, no skips, no shortcuts 💖

  • uint32_t dvb_bcd (uint32_t bcd) — takes a BCD value and converts it into the CPU's internal integer representation. it's giving translator energy 🦋
  • void dvb_hexdump (struct dvb_v5_fe_parms *parms, const char *prefix, const unsigned char *buf, int len) — dumps data into the logs in hexadecimal format. prefix is the lil label, buf is the data, len is how much. very "let me show you the receipts" 💅
  • int dvb_desc_parse (struct dvb_v5_fe_parms *parms, const uint8_t *buf, uint16_t buflen, struct dvb_desc **head_desc) — parses MPEG-TS descriptors 🎀
  • void dvb_desc_free (struct dvb_desc **list) — frees a dvb_desc linked list. clean up after yourself, queen 👑
  • void dvb_desc_print (struct dvb_v5_fe_parms *parms, struct dvb_desc *desc) — prints the contents of a struct dvb_desc linked list 🌸
  • void dvb_table_header_init (struct dvb_table_header *header) — initializes and parses MPEG-TS table header. it's the header, the main character, the opener ✨
  • void dvb_table_header_print (struct dvb_v5_fe_parms *parms, const struct dvb_table_header *header) — prints the content of the MPEG-TS table header 🫶

okay now we're getting into the table init/free/print trios and there are so many, but they're all so iconic in their own way, let's go 💜

  • ssize_t atsc_table_eit_init (struct dvb_v5_fe_parms *parms, const uint8_t *buf, ssize_t buflen, struct atsc_table_eit **table) — initializes and parses ATSC EIT table 🔥
  • void atsc_table_eit_free (struct atsc_table_eit *table) — frees all data allocated by the ATSC EIT table parser. yes, all of it 🧚
  • void atsc_table_eit_print (struct dvb_v5_fe_parms *parms, struct atsc_table_eit *table) — prints the content of the ATSC EIT table 🌈
  • ssize_t dvb_table_eit_init (struct dvb_v5_fe_parms *parms, const uint8_t *buf, ssize_t buflen, struct dvb_table_eit **table) — initializes and parses EIT table. note: this one's the DVB flavor, not ATSC, keep them separate bestie 💖
  • void dvb_table_eit_free (struct dvb_table_eit *table) — frees all data allocated by the DVB EIT table parser 🎀
  • void dvb_table_eit_print (struct dvb_v5_fe_parms *parms, struct dvb_table_eit *table) — prints the content of the DVB EIT table ⭐
  • void dvb_time (const uint8_t data[5], struct tm *tm) — converts a DVB EIT formatted timestamp into struct tm. five bytes in, actual time out, we love a glow-up 💅
  • ssize_t atsc_table_mgt_init (struct dvb_v5_fe_parms *parms, const uint8_t *buf, ssize_t buflen, struct atsc_table_mgt **table) — initializes and parses MGT table 🌸
  • void atsc_table_mgt_free (struct atsc_table_mgt *table) — frees all data allocated by the MGT table parser 🦋
  • void atsc_table_mgt_print (struct dvb_v5_fe_parms *parms, struct atsc_table_mgt *table) — prints the content of the MGT table 💜
  • ssize_t dvb_table_nit_init (struct dvb_v5_fe_parms *parms, const uint8_t *buf, ssize_t buflen, struct dvb_table_nit **table) — initializes and parses NIT table 🔥
  • void dvb_table_nit_free (struct dvb_table_nit *table) — frees all data allocated by the NIT table parser 🧚
  • void dvb_table_nit_print (struct dvb_v5_fe_parms *parms, struct dvb_table_nit *table) — prints the content of the NIT table 🌈
  • void dvb_table_nit_descriptor_handler (struct dvb_v5_fe_parms *parms, struct dvb_table_nit *table, enum descriptors descriptor, nit_handler_callback_t *call_nit, nit_tran_handler_callback_t *call_tran, void *priv) — for each entry at NIT and NIT transport tables, call a callback. two callbacks, one priv pointer, no cap 🫶
  • ssize_t dvb_table_pat_init (struct dvb_v5_fe_parms *parms, const uint8_t *buf, ssize_t buflen, struct dvb_table_pat **table) — initializes and parses PAT table ✨
  • void dvb_table_pat_free (struct dvb_table_pat *table) — frees all data allocated by the PAT table parser 🎀
  • void dvb_table_pat_print (struct dvb_v5_fe_parms *parms, struct dvb_table_pat *table) — prints the content of the PAT table 🌸
  • ssize_t dvb_table_pmt_init (struct dvb_v5_fe_parms *parms, const uint8_t *buf, ssize_t buflen, struct dvb_table_pmt **table) — initializes and parses PMT table 🦋
  • void dvb_table_pmt_free (struct dvb_table_pmt *table) — frees all data allocated by the PMT table parser 💜
  • void dvb_table_pmt_print (struct dvb_v5_fe_parms *parms, const struct dvb_table_pmt *table) — prints the content of the PAT table. and yes bestie, the page literally says PAT here even though we're in PMT-land — I'm just repeating what it says, not my business to edit the lore 💀
  • ssize_t dvb_table_sdt_init (struct dvb_v5_fe_parms *parms, const uint8_t *buf, ssize_t buflen, struct dvb_table_sdt **table) — initializes and parses SDT table 🔥
  • void dvb_table_sdt_free (struct dvb_table_sdt *table) — frees all data allocated by the SDT table parser 🧚
  • void dvb_table_sdt_print (struct dvb_v5_fe_parms *parms, struct dvb_table_sdt *table) — prints the content of the SDT table 🌈
  • ssize_t atsc_table_vct_init (struct dvb_v5_fe_parms *parms, const uint8_t *buf, ssize_t buflen, struct atsc_table_vct **table) — initializes and parses VCT table ⭐
  • void atsc_table_vct_free (struct atsc_table_vct *table) — frees all data allocated by the VCT table parser 🫶
  • void atsc_table_vct_print (struct dvb_v5_fe_parms *parms, struct atsc_table_vct *table) — prints the content of the VCT table 💖

new category drop: MPEG elementary stream and PES/TS stuff, aka the deep lore of this page 🌸

  • int dvb_mpeg_es_seq_start_init (const uint8_t *buf, ssize_t buflen, struct dvb_mpeg_es_seq_start *seq_start) — initialize a struct dvb_mpeg_es_seq_start from buffer 🎀
  • void dvb_mpeg_es_seq_start_print (struct dvb_v5_fe_parms *parms, struct dvb_mpeg_es_seq_start *seq_start) — print details of struct dvb_mpeg_es_seq_start 💅
  • int dvb_mpeg_es_pic_start_init (const uint8_t *buf, ssize_t buflen, struct dvb_mpeg_es_pic_start *pic_start) — initialize a struct dvb_mpeg_es_pic_start from buffer 🦋
  • void dvb_mpeg_es_pic_start_print (struct dvb_v5_fe_parms *parms, struct dvb_mpeg_es_pic_start *pic_start) — print details of struct dvb_mpeg_es_pic_start 💜
  • ssize_t dvb_mpeg_pes_init (struct dvb_v5_fe_parms *parms, const uint8_t *buf, ssize_t buflen, uint8_t *table) — initialize a struct dvb_mpeg_pes from buffer 🔥
  • void dvb_mpeg_pes_free (struct dvb_mpeg_pes *pes) — deallocate memory associated with a struct dvb_mpeg_pes. give the memory back, bestie 🧚
  • void dvb_mpeg_pes_print (struct dvb_v5_fe_parms *parms, struct dvb_mpeg_pes *pes) — print details of struct dvb_mpeg_pes 🌈
  • ssize_t dvb_mpeg_ts_init (struct dvb_v5_fe_parms *parms, const uint8_t *buf, ssize_t buflen, uint8_t *table, ssize_t *table_length) — initialize a struct dvb_mpeg_ts from buffer. note it takes an extra table_length out-pointer, she's thorough ⭐
  • void dvb_mpeg_ts_free (struct dvb_mpeg_ts *ts) — deallocate memory associated with a struct dvb_mpeg_ts 🫶
  • void dvb_mpeg_ts_print (struct dvb_v5_fe_parms *parms, struct dvb_mpeg_ts *ts) — print details of struct dvb_mpeg_ts 💖

🌟 Variables 🌟

the global girlies, the exported constants, the whole vibe check 💅

  • const dvb_table_init_func dvb_table_initializers [256] — table with all possible descriptors. two hundred and fifty-six slots of pure possibility 👑
  • const struct dvb_descriptor dvb_descriptors [] — contains the parsers for the several descriptors 🎀
  • const char * pmt_stream_name [] — converts from enum dvb_streams into a string. enum in, words out, we love a translator 🌸
  • const char * dvb_mpeg_es_frame_names [5] — vector that translates from enum dvb_mpeg_es_frame_t to string. five whole names, exactly five, don't @ me 🦋

📖 Detailed Description 📖

(more coming, bestie — this is where it gets juicy) 💜

✨ Macro Definition Documentation ✨

okay bestie, it's macro o'clock and honestly? these #defines are the blueprint. every single one is listed below with the exact file and line number, because we keep receipts. no cap. 💅

  • #define ATSC_BASE_PID — ATSC PID for the Program and System Information Protocol.

Definition at line 44 of file atsc_header.h.

  • #define atsc_eit_event_foreach( _event, _eit) — Macro used to find event on an ATSC EIT table.

Parameters:

  • _event — event to seek
  • _eit — pointer to struct atsc_table_eit_event

Definition at line 160 of file atsc_eit.h.

  • #define ATSC_TABLE_CVCT — CVCT table ID.

Definition at line 60 of file vct.h.

  • #define ATSC_TABLE_EIT — ATSC EIT table ID.

Definition at line 53 of file atsc_eit.h.

  • #define ATSC_TABLE_MGT — ATSC MGT table ID.

Definition at line 51 of file mgt.h.

  • #define ATSC_TABLE_TVCT — TVCT table ID.

Definition at line 59 of file vct.h.

  • #define ATSC_TABLE_VCT_PID — Program ID with the VCT tables on it.

Definition at line 61 of file vct.h.

  • #define atsc_vct_channel_foreach( _channel, _vct) — Macro used to find channels on a VCT table.

Parameters:

  • _channel — channel to seek
  • _vct — pointer to struct atsc_table_vct_channel

Definition at line 202 of file vct.h.

  • #define DVB_CRC_SIZE — number of bytes for the descriptor's CRC check

Definition at line 61 of file descriptors.h.

  • #define dvb_eit_event_foreach( _event, _eit) — Macro used to find event on a DVB EIT table.

Parameters:

  • _event — event to seek
  • _eit — pointer to struct dvb_table_eit_event

Definition at line 162 of file eit.h.

  • #define DVB_MAX_PAYLOAD_PACKET_SIZE — Maximum size of a table session to be parsed.

Definition at line 55 of file descriptors.h.

  • #define DVB_MPEG_ES_GOP — Group Of Pictures.

Definition at line 67 of file mpeg_es.h.

  • #define DVB_MPEG_ES_PIC_START — Picture Start.

Definition at line 63 of file mpeg_es.h.

  • #define DVB_MPEG_ES_SEQ_EXT — Extension.

Definition at line 66 of file mpeg_es.h.

  • #define DVB_MPEG_ES_SEQ_START — Sequence Start.

Definition at line 65 of file mpeg_es.h.

  • #define DVB_MPEG_ES_SLICES — Slices.

Definition at line 68 of file mpeg_es.h.

  • #define DVB_MPEG_ES_USER_DATA — User Data.

Definition at line 64 of file mpeg_es.h.

  • #define DVB_MPEG_PES — MPEG Packetized Elementary Stream magic.

Definition at line 80 of file mpeg_pes.h.

  • #define DVB_MPEG_PES_AUDIO — PES Audio.

Definition at line 82 of file mpeg_pes.h.

  • #define DVB_MPEG_PES_VIDEO — PES Video.

Definition at line 83 of file mpeg_pes.h.

  • #define DVB_MPEG_STREAM_DIRECTORY — PES Stream directory.

Definition at line 90 of file mpeg_pes.h.

  • #define DVB_MPEG_STREAM_DSMCC — PES DSMCC.

Definition at line 91 of file mpeg_pes.h.

  • #define DVB_MPEG_STREAM_ECM — PES ECM Stream.

Definition at line 88 of file mpeg_pes.h.

  • #define DVB_MPEG_STREAM_EMM — PES EMM Stream.

Definition at line 89 of file mpeg_pes.h.

  • #define DVB_MPEG_STREAM_H222E — PES H.222.1 type E.

Definition at line 92 of file mpeg_pes.h.

  • #define DVB_MPEG_STREAM_MAP — PES Stream map.

Definition at line 85 of file mpeg_pes.h.

  • #define DVB_MPEG_STREAM_PADDING — PES padding.

Definition at line 86 of file mpeg_pes.h.

  • #define DVB_MPEG_STREAM_PRIVATE_2 — PES private.

Definition at line 87 of file mpeg_pes.h.

  • #define DVB_MPEG_TS — MPEG Transport Stream magic.

Definition at line 50 of file mpeg_ts.h.

  • #define DVB_MPEG_TS_PACKET_SIZE — Size of an MPEG packet.

Definition at line 51 of file mpeg_ts.h.

  • #define dvb_nit_transport_foreach( _tran, _nit) — Macro used to find a transport inside a NIT table.

Parameters:

  • _tran — transport to seek
  • _nit — pointer to struct dvb_table_nit_transport

Definition at line 189 of file nit.h.

  • #define dvb_pat_program_foreach( _pgm, _pat) — Macro used to find programs on a PAT table.

Parameters:

  • _pgm — program to seek
  • _pat — pointer to struct dvb_table_pat_program

Definition at line 121 of file pat.h.

  • #define dvb_pmt_stream_foreach( _stream, _pmt) — Macro used to find streams on a PMT table.

Parameters:

  • _stream — stream to seek
  • _pmt — pointer to struct dvb_table_pmt_stream

Definition at line 243 of file pmt.h.

  • #define dvb_sdt_service_foreach( _service, _sdt) — Macro used to find services on a SDT table.

Parameters:

  • _service — service to seek
  • _sdt — pointer to struct dvb_table_sdt_service

Definition at line 137 of file sdt.h.

  • #define DVB_TABLE_CAT — ATSC CAT table ID.

Definition at line 47 of file cat.h.

  • #define DVB_TABLE_CAT_PID — ATSC PID table ID.

Definition at line 48 of file cat.h.

  • #define DVB_TABLE_EIT — DVB EIT table ID for the actual TS.

Definition at line 68 of file eit.h.

  • #define DVB_TABLE_EIT_OTHER — DVB EIT table ID for other TS.

Definition at line 69 of file eit.h.

  • #define DVB_TABLE_EIT_PID — DVB EIT Program ID.

Definition at line 70 of file eit.h.

  • #define DVB_TABLE_EIT_SCHEDULE — Start table ID for the DVB EIT schedule data on the actual TS. The range has 0x0f elements (0x50 to 0x5F).

Definition at line 72 of file eit.h.

  • #define DVB_TABLE_EIT_SCHEDULE_OTHER — Start table ID for the DVB EIT schedule data on other TS. The range has 0x0f elements (0x60 to 0x6F).

Definition at line 73 of file eit.h.

  • #define DVB_TABLE_NIT — NIT table ID.

Definition at line 61 of file nit.h.

  • #define DVB_TABLE_NIT2 — NIT table ID (alternative table ID)

Definition at line 62 of file nit.h.

  • #define DVB_TABLE_NIT_PID — NIT Program ID.

Definition at line 63 of file nit.h.

  • #define DVB_TABLE_PAT — PAT table ID.

Definition at line 55 of file pat.h.

  • #define DVB_TABLE_PAT_PID — PAT Program ID.

Definition at line 56 of file pat.h.

  • #define DVB_TABLE_PMT — PMT table ID.

Definition at line 52 of file pmt.h.

  • #define DVB_TABLE_SDT — SDT table ID.

Definition at line 58 of file sdt.h.

  • #define DVB_TABLE_SDT2 — SDT table ID (alternative table ID)

Definition at line 59 of file sdt.h.

  • #define DVB_TABLE_SDT_PID — SDT Program ID.

Definition at line 60 of file sdt.h.

🫶 Typedef Documentation 🫶

bestie, these are the function-pointer typedefs, and they're giving plug-and-play parser energy. obsessed. 🦋

  • typedef void(* dvb_desc_ext_free_func) (const void *desc) — Function prototype for the extended descriptors parsing free code.

Parameters:

  • desc — struct dvb_desc pointer

Definition at line 156 of file desc_extension.h.

  • typedef int(* dvb_desc_ext_init_func) (struct dvb_v5_fe_parms *parms, const uint8_t *buf, struct dvb_extension_descriptor *ext, void *desc) — Function prototype for the extended descriptors parsing init code.

Parameters:

  • parms — Struct dvb_v5_fe_parms pointer
  • buf — buffer with the content of the descriptor
  • ext — struct dvb_extension_descriptor pointer
  • desc — struct dvb_desc pointer

Definition at line 135 of file desc_extension.h.

  • typedef void(* dvb_desc_ext_print_func) (struct dvb_v5_fe_parms *parms, const struct dvb_extension_descriptor *ext, const void *desc) — Function prototype for the extended descriptors parsing print code.

Parameters:

  • parms — Struct dvb_v5_fe_parms pointer
  • ext — struct dvb_extension_descriptor pointer
  • desc — struct dvb_desc pointer

Definition at line 147 of file desc_extension.h.

  • typedef void(* dvb_desc_free_func) (struct dvb_desc *desc) — Function prototype for the descriptors memory free code.

Parameters:

  • desc — pointer to struct dvb_desc pointer to be freed

Definition at line 234 of file descriptors.h.

  • typedef int(* dvb_desc_init_func) (struct dvb_v5_fe_parms *parms, const uint8_t *buf, struct dvb_desc *desc) — Function prototype for the descriptors parsing init code.

Parameters:

  • parms — Struct dvb_v5_fe_parms pointer
  • buf — buffer with the content of the descriptor
  • desc — struct dvb_desc pointer

Definition at line 215 of file descriptors.h.

  • typedef void(* dvb_desc_print_func) (struct dvb_v5_fe_parms *parms, const struct dvb_desc *desc) — Function prototype for the descriptors parsing print code.

Parameters:

  • parms — Struct dvb_v5_fe_parms pointer
  • desc — struct dvb_desc pointer

Definition at line 225 of file descriptors.h.

  • typedef void(* dvb_table_init_func) (struct dvb_v5_fe_parms *parms, const uint8_t *buf, ssize_t buflen, void **table) — Function prototype for a function that initializes the descriptors parsing on a table.

Parameters:

  • parms — Struct dvb_v5_fe_parms pointer
  • buf — Buffer with data to be parsed
  • buflen — Size of the buffer to be parsed
  • table — pointer to a place where the allocated memory with the table structure will be stored.

Definition at line 79 of file descriptors.h.

  • typedef void nit_handler_callback_t(struct dvb_table_nit *nit, struct dvb_desc *desc, void *priv) — typedef for a callback used when a NIT table entry is found

Parameters:

  • nit — a struct dvb_table_nit pointer
  • desc — a struct dvb_desc pointer
  • priv — an opaque optional pointer

Definition at line 164 of file nit.h.

  • typedef void nit_tran_handler_callback_t(struct dvb_table_nit *nit, struct dvb_table_nit_transport *tran, struct dvb_desc *desc, void *priv) — typedef for a callback used when a NIT transport table entry is found

Parameters:

  • nit — a struct dvb_table_nit pointer
  • tran — a struct dvb_table_nit_transport pointer
  • desc — a struct dvb_desc pointer
  • priv — an opaque optional pointer

Definition at line 177 of file nit.h.

👑 Enumeration Type Documentation 👑

  • enum descriptors — List containing all descriptors used by Digital TV MPEG-TS.

Enumerator:

  • video_stream_descriptor — video_stream descriptor - ISO/IEC 13818-1
  • audio_stream_descriptor — audio_stream descriptor - ISO/IEC 13818-1
  • hierarchy_descriptor — hierarchy descriptor - ISO/IEC 13818-1
  • registration_descriptor — registration descriptor - ISO/IEC 13818-1
  • ds_alignment_descriptor — ds_alignment descriptor - ISO/IEC 13818-1
  • target_background_grid_descriptor — target_background_grid descriptor - ISO/IEC 13818-1
  • video_window_descriptor — video_window descriptor - ISO/IEC 13818-1
  • conditional_access_descriptor — conditional_access descriptor - ISO/IEC 13818-1
  • iso639_language_descriptor — iso639_language descriptor - ISO/IEC 13818-1
  • system_clock_descriptor — system_clock descriptor - ISO/IEC 13818-1
  • multiplex_buffer_utilization_descriptor — multiplex_buffer_utilization descriptor - ISO/IEC 13818-1
  • copyright_descriptor — copyright descriptor - ISO/IEC 13818-1
  • maximum_bitrate_descriptor — maximum_bitrate descriptor - ISO/IEC 13818-1
  • private_data_indicator_descriptor — private_data_indicator descriptor - ISO/IEC 13818-1
  • smoothing_buffer_descriptor — smoothing_buffer descriptor - ISO/IEC 13818-1
  • std_descriptor — std descriptor - ISO/IEC 13818-1
  • ibp_descriptor — ibp descriptor - ISO/IEC 13818-1

Okay so we're deep in the descriptor roll call now, and bestie, this list is long — but every single one of these is a member of dvb_table and they all deserve their moment. Grouped by which standard they crawled out of. No skipping, no summarising, we're doing all of them 💅

The ISO/IEC 13818-1 girlies ✨

  • mpeg4_video_descriptor — the mpeg4_video descriptor, straight from ISO/IEC 13818-1 🎀
  • mpeg4_audio_descriptor — the mpeg4_audio descriptor, also ISO/IEC 13818-1 🌸
  • iod_descriptor — the iod descriptor, ISO/IEC 13818-1 🦋
  • sl_descriptor — the sl descriptor, ISO/IEC 13818-1 ✨
  • fmc_descriptor — the fmc descriptor, ISO/IEC 13818-1 💖
  • external_es_id_descriptor — the external_es_id descriptor, ISO/IEC 13818-1 🫶
  • muxcode_descriptor — the muxcode descriptor, ISO/IEC 13818-1 🌈
  • fmxbuffersize_descriptor — the fmxbuffersize descriptor, ISO/IEC 13818-1 🎀
  • multiplexbuffer_descriptor — the multiplexbuffer descriptor, ISO/IEC 13818-1 💜
  • content_labeling_descriptor — the content_labeling descriptor, ISO/IEC 13818-1 👑
  • metadata_pointer_descriptor — the metadata_pointer descriptor, ISO/IEC 13818-1 ⭐
  • metadata_descriptor — the metadata descriptor, ISO/IEC 13818-1 🍓
  • metadata_std_descriptor — the metadata_std descriptor, ISO/IEC 13818-1 🧚
  • AVC_video_descriptor — the AVC_video descriptor, ISO/IEC 13818-1 💅
  • ipmp_descriptor — the ipmp descriptor, ISO/IEC 13818-1 🌸
  • AVC_timing_and_HRD_descriptor — the AVC_timing_and_HRD descriptor, ISO/IEC 13818-1 🔥
  • mpeg2_aac_audio_descriptor — the mpeg2_aac_audio descriptor, ISO/IEC 13818-1 🎀
  • flexmux_timing_descriptor — the flexmux_timing descriptor, ISO/IEC 13818-1 ✨

The ETSI EN 300 468 V1.11.1 (2010-04) squad — and yes, the version stamp is doing the most, we respect it 😭

  • network_name_descriptor — the network_name descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • service_list_descriptor — the service_list descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • stuffing_descriptor — the stuffing descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • satellite_delivery_system_descriptor — the satellite_delivery_system descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • cable_delivery_system_descriptor — the cable_delivery_system descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • VBI_data_descriptor — the VBI_data descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • VBI_teletext_descriptor — the VBI_teletext descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • bouquet_name_descriptor — the bouquet_name descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • service_descriptor — the service descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • country_availability_descriptor — the country_availability descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • linkage_descriptor — the linkage descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • NVOD_reference_descriptor — the NVOD_reference descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • time_shifted_service_descriptor — the time_shifted_service descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • short_event_descriptor — the short_event descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • extended_event_descriptor — the extended_event descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • time_shifted_event_descriptor — the time_shifted_event descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • component_descriptor — the component descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • mosaic_descriptor — the mosaic descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • stream_identifier_descriptor — the stream_identifier descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • CA_identifier_descriptor — the CA_identifier descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • content_descriptor — the content descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • parental_rating_descriptor — the parental_rating descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • teletext_descriptor — the teletext descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • telephone_descriptor — the telephone descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • local_time_offset_descriptor — the local_time_offset descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • subtitling_descriptor — the subtitling descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • terrestrial_delivery_system_descriptor — the terrestrial_delivery_system descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • multilingual_network_name_descriptor — the multilingual_network_name descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • multilingual_bouquet_name_descriptor — the multilingual_bouquet_name descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • multilingual_service_name_descriptor — the multilingual_service_name descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • multilingual_component_descriptor — the multilingual_component descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • private_data_specifier_descriptor — the private_data_specifier descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • service_move_descriptor — the service_move descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • short_smoothing_buffer_descriptor — the short_smoothing_buffer descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • frequency_list_descriptor — the frequency_list descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • partial_transport_stream_descriptor — the partial_transport_stream descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • data_broadcast_descriptor — the data_broadcast descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • scrambling_descriptor — the scrambling descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • data_broadcast_id_descriptor — the data_broadcast_id descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • transport_stream_descriptor — the transport_stream descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • DSNG_descriptor — the DSNG descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • PDC_descriptor — the PDC descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • AC_3_descriptor — the AC_3 descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • ancillary_data_descriptor — the ancillary_data descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • cell_list_descriptor — the cell_list descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • cell_frequency_link_descriptor — the cell_frequency_link descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • announcement_support_descriptor — the announcement_support descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • application_signalling_descriptor — the application_signalling descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • adaptation_field_data_descriptor — the adaptation_field_data descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • service_identifier_descriptor — the service_identifier descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • service_availability_descriptor — the service_availability descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • default_authority_descriptor — the default_authority descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • related_content_descriptor — the related_content descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • TVA_id_descriptor — the TVA_id descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • content_identifier_descriptor — the content_identifier descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • time_slice_fec_identifier_descriptor — the time_slice_fec_identifier descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • ECM_repetition_rate_descriptor — the ECM_repetition_rate descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • S2_satellite_delivery_system_descriptor — the S2_satellite_delivery_system descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • enhanced_AC_3_descriptor — the enhanced_AC_3 descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • DTS_descriptor — the DTS descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • AAC_descriptor — the AAC descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • XAIT_location_descriptor — the XAIT_location descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • FTA_content_management_descriptor — the FTA_content_management descriptor, ETSI EN 300 468 V1.11.1 (2010-04)
  • extension_descriptor — the extension descriptor, ETSI EN 300 468 V1.11.1 (2010-04)

The SCTE 35 2004 crew 🛰️

The ABNT NBR 15603-1 2007 babes 🇧🇷

  • carousel_id_descriptor — the carousel_id descriptor, ABNT NBR 15603-1 2007
  • association_tag_descriptor — the association_tag descriptor, ABNT NBR 15603-1 2007
  • deferred_association_tags_descriptor — the deferred_association_tags descriptor, ABNT NBR 15603-1 2007
  • hierarchical_transmission_descriptor — the hierarchical_transmission descriptor, ABNT NBR 15603-1 2007
  • digital_copy_control_descriptor — the digital_copy_control descriptor, ABNT NBR 15603-1 2007
  • network_identifier_descriptor — the network_identifier descriptor, ABNT NBR 15603-1 2007
  • partial_transport_stream_time_descriptor — the partial_transport_stream_time descriptor, ABNT NBR 15603-1 2007
  • audio_component_descriptor — the audio_component descriptor, ABNT NBR 15603-1 2007
  • hyperlink_descriptor — the hyperlink descriptor, ABNT NBR 15603-1 2007
  • target_area_descriptor — the target_area descriptor, ABNT NBR 15603-1 2007
  • data_contents_descriptor — the data_contents descriptor, ABNT NBR 15603-1 2007
  • video_decode_control_descriptor — the video_decode_control descriptor, ABNT NBR 15603-1 2007
  • download_content_descriptor — the download_content descriptor, ABNT NBR 15603-1 2007
  • CA_EMM_TS_descriptor — the CA_EMM_TS descriptor, ABNT NBR 15603-1 2007
  • CA_contract_information_descriptor — the CA_contract_information descriptor, ABNT NBR 15603-1 2007
  • CA_service_descriptor — the CA_service descriptor, ABNT NBR 15603-1 2007
  • TS_Information_descriptor — the transport_stream_information descriptor, ABNT NBR 15603-1 2007 — yes bestie, the name and the blurb don't match, that's just how she is, don't @ me 🙈
  • extended_broadcaster_descriptor — the extended_broadcaster descriptor, ABNT NBR 15603-1 2007
  • logo_transmission_descriptor — the logo_transmission descriptor, ABNT NBR 15603-1 2007
  • basic_local_event_descriptor — the basic_local_event descriptor, ABNT NBR 15603-1 2007
  • reference_descriptor — the reference descriptor, ABNT NBR 15603-1 2007
  • node_relation_descriptor — the node_relation descriptor, ABNT NBR 15603-1 2007
  • short_node_information_descriptor — short_node_information descriptor - ABNT NBR 15603-1 2007
  • STC_reference_descriptor — STC_reference descriptor - ABNT NBR 15603-1 2007.
  • series_descriptor — series descriptor - ABNT NBR 15603-1 2007
  • event_group_descriptor — event_group descriptor - ABNT NBR 15603-1 2007
  • SI_parameter_descriptor — SI_parameter descriptor - ABNT NBR 15603-1 2007.
  • broadcaster_Name_Descriptor — broadcaster_Name descriptor - ABNT NBR 15603-1 2007
  • component_group_descriptor — component_group descriptor - ABNT NBR 15603-1 2007
  • SI_prime_TS_descriptor — SI_prime_transport_stream descriptor - ABNT NBR 15603-1 2007.
  • board_information_descriptor — board_information descriptor - ABNT NBR 15603-1 2007
  • LDT_linkage_descriptor — LDT_linkage descriptor - ABNT NBR 15603-1 2007.
  • connected_transmission_descriptor — connected_transmission descriptor - ABNT NBR 15603-1 2007
  • content_availability_descriptor — content_availability descriptor - ABNT NBR 15603-1 2007
  • service_group_descriptor — service_group descriptor - ABNT NBR 15603-1 2007
  • carousel_compatible_composite_descriptor — carousel_compatible_composite descriptor - ABNT NBR 15603-1 2007
  • conditional_playback_descriptor — conditional_playback descriptor - ABNT NBR 15603-1 2007
  • ISDBT_delivery_system_descriptor — ISDBT terrestrial_delivery_system descriptor - ABNT NBR 15603-1 2007.
  • partial_reception_descriptor — partial_reception descriptor - ABNT NBR 15603-1 2007
  • emergency_information_descriptor — emergency_information descriptor - ABNT NBR 15603-1 2007
  • data_component_descriptor — data_component descriptor - ABNT NBR 15603-1 2007
  • system_management_descriptor — system_management descriptor - ABNT NBR 15603-1 2007
  • atsc_stuffing_descriptor — atsc_stuffing descriptor - ATSC A/65:2009
  • atsc_ac3_audio_descriptor — atsc_ac3_audio descriptor - ATSC A/65:2009
  • atsc_caption_service_descriptor — atsc_caption_service descriptor - ATSC A/65:2009
  • atsc_content_advisory_descriptor — atsc_content_advisory descriptor - ATSC A/65:2009
  • atsc_extended_channel_descriptor — atsc_extended_channel descriptor - ATSC A/65:2009
  • atsc_service_location_descriptor — atsc_service_location descriptor - ATSC A/65:2009
  • atsc_time_shifted_service_descriptor — atsc_time_shifted_service descriptor - ATSC A/65:2009
  • atsc_component_name_descriptor — atsc_component_name descriptor - ATSC A/65:2009
  • atsc_DCC_departing_request_descriptor — atsc_DCC_departing_request descriptor - ATSC A/65:2009
  • atsc_DCC_arriving_request_descriptor — atsc_DCC_arriving_request descriptor - ATSC A/65:2009
  • atsc_redistribution_control_descriptor — atsc_redistribution_control descriptor - ATSC A/65:2009
  • atsc_ATSC_private_information_descriptor — atsc_ATSC_private_information descriptor - ATSC A/65:2009
  • atsc_genre_descriptor — atsc_genre descriptor - ATSC A/65:2009

Defined at line 592 of descriptors.h. 📍

enum dvb_mpeg_es_frame_t

okay so these are the MPEG frame types bestie, the little building blocks of a video stream 💅

Enumerator

  • DVB_MPEG_ES_FRAME_UNKNOWN — Unknown frame. (mystery frame, we don't know her 🙈)
  • DVB_MPEG_ES_FRAME_I — I frame. 👑
  • DVB_MPEG_ES_FRAME_P — P frame. ✨
  • DVB_MPEG_ES_FRAME_B — B frame. 💖
  • DVB_MPEG_ES_FRAME_D — D frame. 🦋

Defined at line 165 of mpeg_es.h.

enum dvb_streams

this one adds support for MPEG-TS Stream types 🌈

Enumerator

  • stream_video — ISO/IEC 11172 Video.
  • stream_video_h262 — ITU-T Rec. H.262 | ISO/IEC 13818-2 Video or ISO/IEC 11172-2 constrained parameter video stream
  • stream_audio — ISO/IEC 11172 Audio.
  • stream_audio_13818_3 — ISO/IEC 13818-3 Audio.
  • stream_private_sections — ITU-T Rec. H.222.0 | ISO/IEC 13818-1 private_sections
  • stream_private_data — ITU-T Rec. H.222.0 | ISO/IEC 13818-1 PES packets containing private data
  • stream_mheg — ISO/IEC 13522 MHEG.
  • stream_h222 — ITU-T Rec. H.222.0 | ISO/IEC 13818-1 Annex A DSM-CC
  • stream_h222_1 — ITU-T Rec. H.222.1
  • stream_13818_6_A — ISO/IEC 13818-6 type A.
  • stream_13818_6_B — ISO/IEC 13818-6 type B.
  • stream_13818_6_C — ISO/IEC 13818-6 type C.
  • stream_13818_6_D — ISO/IEC 13818-6 type D.
  • stream_h222_aux — ITU-T Rec. H.222.0 | ISO/IEC 13818-1 auxiliary
  • stream_audio_adts — ISO/IEC 13818-7 Audio with ADTS transport syntax.
  • stream_video_14496_2 — ISO/IEC 14496-2 Visual.
  • stream_audio_latm — ISO/IEC 14496-3 Audio with the LATM transport syntax as defined in ISO/IEC 14496-3 / AMD 1.
  • stream_14496_1_pes — ISO/IEC 14496-1 SL-packetized stream or FlexMux stream carried in PES packets.
  • stream_14496_1_iso — ISO/IEC 14496-1 SL-packetized stream or FlexMux stream carried in ISO/IEC14496_sections.
  • stream_download — ISO/IEC 13818-6 Synchronized Download Protocol.
  • stream_video_h264
  • stream_audio_14496_3
  • stream_video_hevc
  • stream_video_cavs
  • stream_video_moto
  • stream_audio_a52
  • stream_scte_27
  • stream_audio_sdds
  • stream_audio_dts_hdmv
  • stream_audio_e_ac3
  • stream_audio_dts
  • stream_audio_a52_vls
  • stream_spu_vls
  • stream_audio_sdds2

Defined at line 100 of pmt.h.

🛠️ Function Documentation 🛠️

okay bestie this is the part where we meet the actual functions, the girlies doing the work 💅

void atsc_table_eit_free (struct atsc_table_eit * table)

Frees all data allocated by the ATSC EIT table parser. 🧹

Parameters

  • table — pointer to struct atsc_table_eit to be freed

ssize_t atsc_table_eit_init (struct dvb_v5_fe_parms * parms, const uint8_t * buf, ssize_t buflen, struct atsc_table_eit ** table)

Initializes and parses ATSC EIT table. ✨

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • buf — buffer containing the EIT raw data
  • buflen — length of the buffer
  • table — pointer to struct atsc_table_eit to be allocated and filled

This function allocates an ATSC EIT table and fills the fields inside the struct. It also makes sure that all fields will follow the CPU endianness. Due to that, the content of the buffer may change.

heads up: your buffer is not safe from edits here, it may get changed 💀

Returns

On success, it returns the size of the allocated struct. A negative value indicates an error.

void atsc_table_eit_print (struct dvb_v5_fe_parms * parms, struct atsc_table_eit * table)

Prints the content of the ATSC EIT table. 🖨️

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • table — pointer to struct atsc_table_eit

void atsc_table_mgt_free (struct atsc_table_mgt * table)

Frees all data allocated by the MGT table parser. 🧹

Parameters

  • table — pointer to struct atsc_table_mgt to be freed

ssize_t atsc_table_mgt_init (struct dvb_v5_fe_parms * parms, const uint8_t * buf, ssize_t buflen, struct atsc_table_mgt ** table)

Initializes and parses MGT table. ✨

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • buf — buffer containing the MGT raw data
  • buflen — length of the buffer
  • table — pointer to struct atsc_table_mgt to be allocated and filled

This function allocates an ATSC MGT table and fills the fields inside the struct. It also makes sure that all fields will follow the CPU endianness. Due to that, the content of the buffer may change.

same deal, buffer can get modified, no cap 🫶

Returns

On success, it returns the size of the allocated struct. A negative value indicates an error.

void atsc_table_mgt_print (struct dvb_v5_fe_parms * parms, struct atsc_table_mgt * table)

Prints the content of the MGT table. 🖨️

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • table — pointer to struct atsc_table_mgt

void atsc_table_vct_free (struct atsc_table_vct * table)

Frees all data allocated by the VCT table parser. 🧹

Parameters

  • table — pointer to struct atsc_table_vct to be freed

ssize_t atsc_table_vct_init (struct dvb_v5_fe_parms * parms, const uint8_t * buf, ssize_t buflen, struct atsc_table_vct ** table)

Initializes and parses VCT table. ✨

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • buf — buffer containing the VCT raw data
  • buflen — length of the buffer
  • table — pointer to struct atsc_table_vct to be allocated and filled

This function allocates an ATSC VCT table and fills the fields inside the struct. It also makes sure that all fields will follow the CPU endianness. Due to that, the content of the buffer may change.

yup, buffer may change here too, it's giving "read the docs before you freak out" 😭

Returns

On success, it returns the size of the allocated struct. A negative value indicates an error.

void atsc_table_vct_print (struct dvb_v5_fe_parms * parms, struct atsc_table_vct * table)

Prints the content of the VCT table. 🖨️

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • table — pointer to struct atsc_table_vct

uint32_t dvb_bcd (uint32_t bcd)

Converts from BCD to CPU integer internal representation. 🔢

Parameters

  • bcd — value in BCD encoding

void dvb_desc_free (struct dvb_desc ** list)

frees a dvb_desc linked list 🧹

Parameters

  • list — struct dvb_desc pointer.

int dvb_desc_parse (struct dvb_v5_fe_parms * parms, const uint8_t * buf, uint16_t buflen, struct dvb_desc ** head_desc)

parse MPEG-TS descriptors 🔍

Parameters

  • parms — Struct dvb_v5_fe_parms pointer
  • buf — Buffer with data to be parsed
  • buflen — Size of the buffer to be parsed
  • head_desc — pointer to the place to store the parsed data

This function takes a buf as argument and parses it to find the MPEG-TS descriptors inside it, creating a linked list.

On success, head_desc will be allocated and filled with a linked list with the descriptors found inside the buffer.

This function is used by the several MPEG-TS table handlers to parse the entire table that got read by dvb_read_sessions and other similar functions.

Returns

Returns 0 on success, a negative value otherwise.

void dvb_desc_print (struct dvb_v5_fe_parms * parms, struct dvb_desc * desc)

prints the contents of a struct dvb_desc linked list 🖨️

Parameters

  • parms — Struct dvb_v5_fe_parms pointer
  • desc — struct dvb_desc pointer.

void dvb_hexdump (struct dvb_v5_fe_parms * parms, const char * prefix, const unsigned char * buf, int len)

dumps data into the logs in hexadecimal format 🔥

Parameters

  • parms — Struct dvb_v5_fe_parms pointer
  • prefix — String to be printed before the dvb_hexdump
  • buf — Buffer to hex dump
  • len — Number of bytes to show

💖 int dvb_mpeg_es_pic_start_init(const uint8_t * buf, ssize_t buflen, struct dvb_mpeg_es_pic_start * pic_start) 💖

okay so this one builds you a struct dvb_mpeg_es_pic_start out of a buffer, no cap ✨

Parameters

  • buf — Buffer
  • buflen — Length of buffer
  • pic_start — Pointer to allocated structdvb_mpeg_es_pic_start

Returns

If buflen too small, return -1, 0 otherwise. 💅

So like — this function copies the length of struct dvb_mpeg_es_pic_start to pic_start and fixes endianness. And seq_start has to be allocated with malloc.

🌸 void dvb_mpeg_es_pic_start_print(struct dvb_v5_fe_parms * parms, struct dvb_mpeg_es_pic_start * pic_start) 🌸

Prints out all the deets of a struct dvb_mpeg_es_pic_start. it's giving show-and-tell 🎀

Parameters

  • parms — struct dvb_v5_fe_parms for log functions
  • pic_start — Pointer to struct dvb_mpeg_es_pic_start to print

This function prints the fields of struct dvb_mpeg_es_pic_start.

🦋 int dvb_mpeg_es_seq_start_init(const uint8_t * buf, ssize_t buflen, struct dvb_mpeg_es_seq_start * seq_start) 🦋

Initialize a struct dvb_mpeg_es_seq_start from buffer. main character behavior fr fr 👑

Parameters

  • buf — Buffer
  • buflen — Length of buffer
  • seq_start — Pointer to allocated struct dvb_mpeg_es_seq_start

Returns

If buflen too small, return -1, 0 otherwise. ✨

This function copies the length of struct dvb_mpeg_es_seq_start to seq_start and fixes endianness. seq_start has to be allocated with malloc.

🫶 void dvb_mpeg_es_seq_start_print(struct dvb_v5_fe_parms * parms, struct dvb_mpeg_es_seq_start * seq_start) 🫶

Print details of struct dvb_mpeg_es_seq_start. bestie it literally just tells you everything 🥰

Parameters

  • parms — struct dvb_v5_fe_parms for log functions
  • seq_start — Pointer to struct dvb_mpeg_es_seq_start to print

This function prints the fields of struct dvb_mpeg_es_seq_start.

💀 void dvb_mpeg_pes_free(struct dvb_mpeg_pes * pes) 💀

Deallocate memory associated with a struct dvb_mpeg_pes. cleanup era 🧹

Parameters

  • pes — struct dvb_mpeg_pes to be deallocated

If the pointer pes was allocated dynamically, this function can be used to free the memory.

🌈 ssize_t dvb_mpeg_pes_init(struct dvb_v5_fe_parms * parms, const uint8_t * buf, ssize_t buflen, uint8_t * table) 🌈

Initialize a struct dvb_mpeg_pes from buffer. so slay ✨

Parameters

  • parms — struct dvb_v5_fe_parms for log functions
  • buf — Buffer
  • buflen — Length of buffer
  • table — Pointer to allocated struct dvb_mpeg_pes

Returns

Length of data in table

This function copies the length of struct dvb_mpeg_pes to table and fixes endianness. The pointer table has to be allocated on stack or dynamically. 👀

🎀 void dvb_mpeg_pes_print(struct dvb_v5_fe_parms * parms, struct dvb_mpeg_pes * pes) 🎀

Print details of struct dvb_mpeg_pes. reading it for filth (the good kind) 💅

Parameters

  • parms — struct dvb_v5_fe_parms for log functions
  • pes — Pointer to struct dvb_mpeg_pes to print

This function prints the fields of struct dvb_mpeg_pes.

⭐ void dvb_mpeg_ts_free(struct dvb_mpeg_ts * ts) ⭐

Deallocate memory associated with a struct dvb_mpeg_ts. release it, let it go 🦋

Parameters

  • ts — struct dvb_mpeg_ts to be deallocated

If ts was allocated dynamically, this function can be used to free the memory.

🔥 ssize_t dvb_mpeg_ts_init(struct dvb_v5_fe_parms * parms, const uint8_t * buf, ssize_t buflen, uint8_t * table, ssize_t * table_length) 🔥

Initialize a struct dvb_mpeg_ts from buffer. iconic 🎬

Parameters

  • parms — struct dvb_v5_fe_parms for log functions
  • buf — Buffer
  • buflen — Length of buffer
  • table — Pointer to allocated struct dvb_mpeg_ts
  • table_length — Pointer to size_t where length will be written to

Returns

Length of data in table

This function copies the length of struct dvb_mpeg_ts to table and fixes endianness. The pointer table has to be allocated on stack or dynamically.

💜 void dvb_mpeg_ts_print(struct dvb_v5_fe_parms * parms, struct dvb_mpeg_ts * ts) 💜

Print details of struct dvb_mpeg_ts. bestie get a snack, it's a whole read 🍓

Parameters

  • parms — struct dvb_v5_fe_parms for log functions
  • ts — Pointer to struct dvb_mpeg_ts to print

This function prints the fields of struct dvb_mpeg_ts.

🌸 void dvb_table_eit_free(struct dvb_table_eit * table) 🌸

Frees all data allocated by the DVB EIT table parser. bye bye, love u, delete my number 👋

Parameters

  • table — pointer to struct dvb_table_eit to be freed

✨ ssize_t dvb_table_eit_init(struct dvb_v5_fe_parms * parms, const uint8_t * buf, ssize_t buflen, struct dvb_table_eit ** table) ✨

Initializes and parses EIT table. the way that it eats every time 😭

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • buf — buffer containing the EIT raw data
  • buflen — length of the buffer
  • table — pointer to struct dvb_table_eit to be allocated and filled

This function allocates an EIT table and fills the fields inside the struct. It also makes sure that all fields will follow the CPU endianness. Due to that, the content of the buffer may change. 🚨

Returns

On success, it returns the size of the allocated struct. A negative value indicates an error.

🦋 void dvb_table_eit_print(struct dvb_v5_fe_parms * parms, struct dvb_table_eit * table) 🦋

Prints the content of the DVB EIT table. tea time ☕

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • table — pointer to struct dvb_table_eit

💫 void dvb_table_header_init(struct dvb_table_header * header) 💫

Initializes and parses MPEG-TS table header. where it all begins, lowkey 🎀

Parameters

  • header — pointer to struct dvb_table_header to be parsed

🌈 void dvb_table_header_print(struct dvb_v5_fe_parms * parms, const struct dvb_table_header * header) 🌈

Prints the content of the MPEG-TS table header.

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • header — pointer to struct dvb_table_header to be printed

👑 void dvb_table_nit_descriptor_handler(struct dvb_v5_fe_parms * parms, struct dvb_table_nit * table, enum descriptors descriptor, nit_handler_callback_t * call_nit, nit_tran_handler_callback_t * call_tran, void * priv) 👑

For each entry at NIT and NIT transport tables, call a callback. this is the group-chat notification of the DVB world fr fr 🔔

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • table — pointer to struct dvb_table_nit
  • descriptor — indicates the NIT table descriptor to seek
  • call_nit — a nit_handler_callback_t function to be called when a new entry at the NIT table is found (or NULL).
  • call_tran — a nit_tran_handler_callback_t function to be called when a new entry at the NIT transport table is found (or NULL).
  • priv — an opaque pointer to be optionally used by the callbacks. The function won't touch on it, just use as an argument for the callback functions.

When parsing a NIT entry, we need to call some code to properly handle when a given descriptor in the table is found. This is used, for example, to create newer transponders to seek during scan.

For example, to seek for the CATV delivery system descriptor and call a function that would add a new transponder to a scan procedure:

dvb_table_nit_descriptor_handler(
                &parms->p, dvb_scan_handler->nit,
                cable_delivery_system_descriptor,
                NULL, add_update_nit_dvbc, &tr);

🧚 void dvb_table_nit_free(struct dvb_table_nit * table) 🧚

Frees all data allocated by the NIT table parser.

Parameters

  • table — pointer to struct dvb_table_nit to be freed

⭐ ssize_t dvb_table_nit_init(struct dvb_v5_fe_parms * parms, const uint8_t * buf, ssize_t buflen, struct dvb_table_nit ** table) ⭐

Initializes and parses NIT table. obsessed actually 💖

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • buf — buffer containing the NIT raw data
  • buflen — length of the buffer
  • table — pointer to struct dvb_table_nit to be allocated and filled

This function allocates a NIT table and fills the fields inside the struct. It also makes sure that all fields will follow the CPU endianness. Due to that, the content of the buffer may change. 🚨

Returns

On success, it returns the size of the allocated struct. A negative value indicates an error.

🌸 void dvb_table_nit_print(struct dvb_v5_fe_parms * parms, struct dvb_table_nit * table) 🌸

Prints the content of the NIT table. no thoughts, just vibes and output ✨

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • table — pointer to struct dvb_table_nit

💅 void dvb_table_pat_free(struct dvb_table_pat * table) 💅

Frees all data allocated by the PAT table parser. decluttering, we love to see it 🧹

Parameters

  • table — pointer to struct dvb_table_pat to be freed

🎀 ssize_t dvb_table_pat_init(struct dvb_v5_fe_parms * parms, const uint8_t * buf, ssize_t buflen, struct dvb_table_pat ** table) 🎀

Initializes and parses PAT table.

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • buf — buffer containing the PAT raw data
  • buflen — length of the buffer
  • table — pointer to struct dvb_table_pat to be allocated and filled

This function allocates a PAT table and fills the fields inside the struct. It also makes sure that all fields will follow the CPU endianness. Due to that, the content of the buffer may change. 🚨

Returns

On success, it returns the size of the allocated struct. A negative value indicates an error.

🦋 void dvb_table_pat_print(struct dvb_v5_fe_parms * parms, struct dvb_table_pat * table) 🦋

Prints the content of the PAT table.

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • table — pointer to struct dvb_table_pat

💜 void dvb_table_pmt_free(struct dvb_table_pmt * table) 💜

Frees all data allocated by the PMT table parser. and that's on memory hygiene 💅

Parameters

  • table — pointer to struct dvb_table_pmt to be freed

🔥 ssize_t dvb_table_pmt_init(struct dvb_v5_fe_parms * parms, const uint8_t * buf, ssize_t buflen, struct dvb_table_pmt ** table) 🔥

Initializes and parses PMT table. it's giving efficiency 🌈

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • buf — buffer containing the PMT raw data
  • buflen — length of the buffer
  • table — pointer to struct dvb_table_pmt to be allocated and filled

This function allocates a PMT table and fills the fields inside the struct. It also makes sure that all fields will follow the CPU endianness. Due to that, the content of the buffer may change. 🚨

Returns

On success, it returns the size of the allocated struct. A negative value indicates an error.

🌟 void dvb_table_pmt_print(struct dvb_v5_fe_parms * parms, const struct dvb_table_pmt * table) 🌟

Prints the content of the PAT table. (yes bestie, the doc really does say PAT here — we're just reporting the lore exactly as it was handed down 🙈)

Parameters

  • parms — struct dvb_v5_fe_parms pointer to the opened device
  • table — pointer to struct dvb_table_pmt

🧚 void dvb_table_sdt_free(struct dvb_table_sdt * table) 🧚

Frees all data allocated by the SDT table parser.

Parameters

  • table — pointer to struct dvb_table_sdt to be freed

✨ ssize_t dvb_table_sdt_init(struct dvb_v5_fe_parms * parms, const uint8_t * buf, ssize_t buflen, struct dvb_table_sdt ** table) ✨

Initializes and parses SDT table.

  • parms — a struct dvb_v5_fe_parms pointer, aka the opened device you're working with 🫶
  • buf — the buffer holding all that raw SDT data
  • buflen — the length of said buffer, bestie
  • table — a pointer to the struct dvb_table_sdt that's about to get allocated and filled in

So what's this one doing? It allocates a whole SDT table and fills up all the fields inside the struct. And then — the iconic part — it makes sure every single field follows the CPU endianness. Which means, and I need you to hear me on this: the content of the buffer may change 😭 not a drill, don't go reusing that buffer and expecting it to be untouched.

Returns

On success it hands you the size of the allocated struct. A negative value means it went wrong. No cap 💀

void dvb_table_sdt_print (struct dvb_v5_fe_parms * parms, struct dvb_table_sdt * table)

Prints out everything inside the SDT table. Just, like, dumps the whole vibe onto your screen ✨

Parameters

  • parms — a struct dvb_v5_fe_parms pointer to the opened device
  • table — pointer to struct dvb_table_sdt

void dvb_time (const uint8_t data[5], struct tm * tm)

Takes a DVB EIT formatted timestamp and converts it into a struct tm. Time travel but make it C 🕰️

Parameters

  • data — the event, in DVB EIT time format
  • tm — pointer to the struct tm where the converted timestamp gets stored

💾 VARIABLE DOCUMENTATION 💾

const struct dvb_descriptor dvb_descriptors[] [extern]

Holds the parsers for all the several descriptors. Like a little toolbox of descriptor-handling besties 🧰

const char* dvb_mpeg_es_frame_names[5] [extern]

A vector that translates from enum dvb_mpeg_es_frame_t to a string. enum in, string out, slay 💅

const dvb_table_init_func dvb_table_initializers[256] [extern]

A table containing all the possible descriptors. All 256 of them, no skips, no shortcuts 🌈

const char* pmt_stream_name[] [extern]

Converts from enum dvb_streams into a string. Same energy as the frame names, different enum 🌸

👑 AUTHOR 👑

Generated automatically by Doxygen for libdvbv5 from the source code. Not me writing a cute little bio for myself, the robots did it 🤖✨

okay so that's literally the whole page, bestie — every single flag, field, struct and signature accounted for, periodt 💖

And that's a wrap on dvb_table(3) from libdvbv5, Version 1.32.0 🎀 — you made it to the very end, main character energy fr fr 👑🦋 thank you for reading all eight parts, ily, go touch some grass and then come back and read your manpages again 💜

📦 where this page comes from