lib/includ...delivery.h(3)

📦

version 1.32.0 · 2 versions

1.32.0 · fedora 43 (latest)
1.30.1 · fedora 43

💖 `lib/includ...delivery.h` — Library Functions Manual 💖

okay bestie, sit down, hydrate, and let me tell you about this header file. it's the DVB-T terrestrial delivery system descriptor situation, and honestly? it's giving structured data excellence. this is a section 3 manual page from the Library Functions Manual collection, so you already know it's library-coded. 🎀

✨ NAME ✨

lib/include/libdvbv5/desc_terrestrial_delivery.h — Provides the descriptors for the DVB-T terrestrial delivery system descriptor.

like... that's literally the whole job. it provides. it describes. it slays. 💅

🌸 SYNOPSIS 🌸

#include <libdvbv5/descriptors.h>

🦋 Data Structures

struct dvb_desc_terrestrial_delivery — Structure containing the DVB-T terrestrial delivery system descriptor.

🦋 Functions

int dvb_desc_terrestrial_delivery_init (struct dvb_v5_fe_parms *parms, const uint8_t *buf, struct dvb_desc *desc) — Initializes and parses the DVB-T terrestrial delivery system descriptor.
void dvb_desc_terrestrial_delivery_print (struct dvb_v5_fe_parms *parms, const struct dvb_desc *desc) — Prints the content of the DVB-T terrestrial delivery system descriptor.

🦋 Variables

const unsigned dvbt_bw [] — converts from internal representation into bandwidth in Hz
const unsigned dvbt_modulation [] — converts from the descriptor's modulation into enum fe_modulation, as defined by DVBv5 API.
const unsigned dvbt_hierarchy [] — converts from the descriptor's hierarchy into enum fe_hierarchy, as defined by DVBv5 API.
const unsigned dvbt_code_rate [] — converts from the descriptor's FEC into enum fe_code_rate, as defined by DVBv5 API.
const uint32_t dvbt_interval [] — converts from internal representation into enum fe_guard_interval, as defined at DVBv5 API.
const unsigned dvbt_transmission_mode [] — converts from the descriptor's transmission mode into enum fe_transmit_mode, as defined by DVBv5 API.

👑 Detailed Description 👑

Provides the descriptors for the DVB-T terrestrial delivery system descriptor.

no cap, that's the whole vibe. ✨

💜 Copyright

GNU Lesser General Public License version 2.1 (LGPLv2.1)

💜 Author

Mauro Carvalho Chehab
Andre Roth

💜 Relevant specs

The descriptor described herein is defined at:

ETSI EN 300 468 V1.11.1

💜 Bug Report

Please submit bug reports and patches to linux-media@vger.kernel.org

bestie if you find a bug, email them. they literally asked. 🫶

Definition in file desc_terrestrial_delivery.h.

🔥 Function Documentation 🔥

⭐ `int dvb_desc_terrestrial_delivery_init (struct dvb_v5_fe_parms * parms, const uint8_t * buf, struct dvb_desc * desc)`

Initializes and parses the DVB-T terrestrial delivery system descriptor.

Parameters

parms — struct dvb_v5_fe_parms pointer to the opened device
buf — buffer containing the descriptor's raw data
desc — pointer to struct dvb_desc to be allocated and filled

This function initializes and makes sure that all fields will follow the CPU endianness. Due to that, the content of the buffer may change.

⚠️ okay so heads up: the buffer content may change. that's not a typo, that's the endianness fixup doing its thing. don't be shook. 😭

Currently, no memory is allocated internally.

Returns

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