DVB-FILE.H(3)

💖 dvb-file.h(3) — Library Functions Manual 💖

okay bestie, pull up a chair, we're reading the lib/include/libdvbv5/dvb-file.h page together and it's genuinely giving main character energy. this is a manual page from the Library Functions Manual, so you already know it's the good stuff. let's get into it 🦋

---

✨ NAME ✨

lib/include/libdvbv5/dvb-file.h — provides interfaces to deal with DVB channel and program files.

like. that's it. that's the whole vibe. it hands you the tools to read and write DVB channel + program files and it does it with grace 💅

---

✨ SYNOPSIS ✨

#include 'dvb-fe.h'

(yes, with the single quotes, that's literally how it's written, don't come for me)

🎀 Data Structures 🎀

• struct dvb_elementary_pid — associates an elementary stream type with its PID. iconic pairing, no notes.
• struct dvb_entry — represents one entry on a DTV file.
• struct dvb_file — describes an entire DVB file opened.
• struct dvb_parse_table — describes the fields to parse on a file.
• struct dvb_parse_struct — describes the format to parse an specific delivery system.
• struct dvb_parse_file — describes an entire file format.

🎀 Enumerations 🎀

• enum dvb_file_formats { FILE_UNKNOWN, FILE_ZAP, FILE_CHANNEL, FILE_DVBV5, FILE_VDR } — known file formats. that's the whole roster, bestie.

🎀 Functions 🎀

• static void dvb_file_free (struct dvb_file *dvb_file) — deallocates memory associated with a struct dvb_file. free your girl, she's done.
• struct dvb_file * dvb_read_file (const char *fname) — read a file at libdvbv5 format.
• int dvb_write_file (const char *fname, struct dvb_file *dvb_file) — write a file at libdvbv5 format.
• struct dvb_file * dvb_read_file_format (const char *fname, uint32_t delsys, enum dvb_file_formats format) — read a file on any format natively supported by the library.
• int dvb_write_file_format (const char *fname, struct dvb_file *dvb_file, uint32_t delsys, enum dvb_file_formats format) — write a file on any format natively supported by the library.
• int dvb_store_entry_prop (struct dvb_entry *entry, uint32_t cmd, uint32_t value) — stores a key/value pair on a DVB file entry.
• int dvb_retrieve_entry_prop (struct dvb_entry *entry, uint32_t cmd, uint32_t *value) — retrieves the value associated witha key on a DVB file entry. (yes, "witha". it's in the source. we love a typo that made it to prod 💀)
• int dvb_store_channel (struct dvb_file **dvb_file, struct dvb_v5_fe_parms *parms, struct dvb_v5_descriptors *dvb_desc, int get_detected, int get_nit) — stored a new scanned channel into a dvb_file struct.
• int dvb_parse_delsys (const char *name) — ancillary function that seeks for a delivery system.
• enum dvb_file_formats dvb_parse_format (const char *name) — ancillary function that parses the name of a file format.
• struct dvb_file * dvb_parse_format_oneline (const char *fname, uint32_t delsys, const struct dvb_parse_file *parse_file) — read and parses a one line file format.
• int dvb_write_format_oneline (const char *fname, struct dvb_file *dvb_file, uint32_t delsys, const struct dvb_parse_file *parse_file) — writes a file into an one line file format.
• int dvb_write_format_vdr (const char *fname, struct dvb_file *dvb_file) — writes a file into vdr format (compatible up to version 2.1).

🎀 Variables 🎀

• const struct dvb_parse_file channel_file_format — file format definitions for dvb-apps channel format.
• const struct dvb_parse_file channel_file_zap_format — file format definitions for dvb-apps zap format.

---

✨ Detailed Description ✨

provides interfaces to deal with DVB channel and program files. short, sweet, does exactly what it says on the tin ✨

🌸 Copyright 🌸

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

🌸 Author 🌸

Mauro Carvalho Chehab

---

so here's the tea, bestie: there are basically two types of files used for DVB:

• files that describe the physical channels (also called as transponders);
• files that describe the several programs found on a MPEG-TS (also called as zap files).

and the libdvbv5 library defines an unified type for both types. other applications generally use different formats. classic, honestly 🙈

the purpose of the functions and structures defined herein is to provide support to read and write to those different formats. that's the whole assignment. periodt.

🌸 Bug Report 🌸

please submit bug reports and patches to linux-media@vger.kernel.org — they're literally asking, don't be shy 🫶

🌸 Definition in file dvb-file.h. 🌸

---

✨ Author ✨

generated automatically by Doxygen for libdvbv5 from the source code. the robots did this one, we're just vibing with it 🤖💜

---

okay that's the whole page!! 🌈 everything accounted for, nothing skipped, no cap. this one came from libdvbv5 Version 1.32.0, living at lib/includ.../dvb-file.h(3), and it's giving exactly what it needed to give. go read your channel files, bestie, you've got this 💖🎀🦋