satellite(3)

📦
version 1.32.0 · 2 versions
, in fedora 43

✨ satellite(3) ✨

okay bestie, pull up a chair, because we're talking about satellite — Satellite Equipment Control 💅 this is from the satellite(3) manual, and it's literally the whole DVB satellite side of libdvbv5. let's get into it 🛰️💖

🌸 NAME 🌸

satellite — Satellite Equipment Control ✨

🎀 SYNOPSIS 🎀

📁 Files

  • dvb-sat.h — provides interfaces to deal with DVB Satellite systems. no cap.

🏗️ Data Structures

  • struct dvb_sat_lnb — stores the information of a LNBf. (yes, the whole vibe of one LNBf lives in here 🫶)

🔢 Enumerations

  • enum dvb_sat_polarization — { POLARIZATION_OFF, POLARIZATION_H, POLARIZATION_V, POLARIZATION_L, POLARIZATION_R } — polarization types for Satellite systems. iconic.

⚙️ Functions

  • int dvb_sat_search_lnb (const char *name) — search for a LNBf entry
  • int dvb_print_lnb (int index) — prints the contents of a LNBf entry at STDOUT.
  • void dvb_print_all_lnb (void) — Prints all LNBf entries at STDOUT.
  • const struct dvb_sat_lnb * dvb_sat_get_lnb (int index) — gets a LNBf entry at its internal database
  • const char * dvb_sat_get_lnb_name (int index) — gets a LNBf entry at its internal database
  • int dvb_sat_set_parms (struct dvb_v5_fe_parms *parms) — sets the satellite parameters
  • int dvb_sat_real_freq (struct dvb_v5_fe_parms *p, int freq) — return the real satellite frequency

💜 Detailed Description 💜

like, it's a satellite thing. the vibes are immaculate and the details are all below 👇

🌈 Enumeration Type Documentation 🌈

🦋 enum dvb_sat_polarization

Polarization types for Satellite systems. bestie this is the whole menu of how your signal is oriented 📡

Parameters

  • POLARIZATION_OFF — Polarization disabled/unused. she's off duty 💀
  • POLARIZATION_H — Horizontal polarization
  • POLARIZATION_V — Vertical polarization
  • POLARIZATION_L — Left circular polarization (C-band)
  • POLARIZATION_R — Right circular polarization (C-band)

Enumerator

  • POLARIZATION_OFF
  • POLARIZATION_H
  • POLARIZATION_V
  • POLARIZATION_L
  • POLARIZATION_R
Definition at line 138 of file dvb-v5-std.h. ✨

🔥 Function Documentation 🔥

🌟 void dvb_print_all_lnb (void )

Prints all LNBf entries at STDOUT. This function doesn't return anything — like, nothing comes back, it just does the thing. Internally, it calls dvb_print_lnb() for all entries inside its LNBf database. so it's the "print everything" button, periodt 💅

🌟 int dvb_print_lnb (int index)

prints the contents of a LNBf entry at STDOUT.

Parameters

  • index — index for the entry

Returns

returns -1 if the index is out of range, zero otherwise.

🌟 const struct dvb_sat_lnb * dvb_sat_get_lnb (int index)

gets a LNBf entry at its internal database

Parameters

  • index — index for the entry.

Returns

returns NULL if not found, of a struct dvb_sat_lnb pointer otherwise.

NOTE: none of the strings are i18n translated. In order to get the translated name, you should use dvb_sat_get_lnb_name(). so if you want the translated version, go ask her sister function 🫶

🌟 const char * dvb_sat_get_lnb_name (int index)

gets a LNBf entry at its internal database

Parameters

  • index — index for the entry.

Returns

returns NULL if not found, of the name of a LNBf, translated to the user language, if translation is available. (only if translation is available bestie, don't come for me 😭)

🌟 int dvb_sat_real_freq (struct dvb_v5_fe_parms * p, int freq)

return the real satellite frequency

Parameters

  • p — struct dvb_v5_fe_parms pointer.
  • freq — the DTV frequency.

This function is called internally by the library to get the satellite frequency, considering the LO frequency.

Returns

frequency. that's it, that's the tea ☕

🌟 int dvb_sat_search_lnb (const char * name)

search for a LNBf entry

Parameters

  • name — name of the LNBf entry to seek.

On sucess, it returns a non-negative number with corresponds to the LNBf entry inside the LNBf structure at dvb-sat.c. (yes the original says "sucess", we don't gatekeep typos here, we honour them 🙈)

Returns

A -1 return code indicates that the LNBf was not found. 💀

🌟 int dvb_sat_set_parms (struct dvb_v5_fe_parms * parms)

sets the satellite parameters

Parameters

  • parms — struct dvb_v5_fe_parms pointer.

This function is called internally by the library to set the LNBf parameters, if the dvb_v5_fe_parms::lnb field is filled. so like, fill the field, get the parms, iykyk ✨

Returns

0 on success.

👑 Author 👑

Generated automatically by Doxygen for libdvbv5 from the source code. (not a human, just a robot doing her little thing, and honestly? she ate 🤖💅)

and that's the whole page bestie!! this little icon comes to you from libdvbv5, Version 1.32.0 — stay polarized, stay slay, and don't forget to NULL-check 🎀🦋💖

📦 where this page comes from