libdvbv5  1.11.0
Library to work with Digital TV devices on Linux
Ancillary functions and macros

Files

file  dvb-log.h
 Provides interfaces to handle libdvbv5 log messages.
 
file  crc32.h
 Provides ancillary code to calculate DVB crc32 checksum.
 
file  countries.h
 Provides ancillary code to convert ISO 3166-1 country codes.
 

Macros

#define ARRAY_SIZE(x)
 Calculates the number of elements of an array. More...
 

Typedefs

typedef void(* dvb_logfunc )(int level, const char *fmt,...)
 typedef used by dvb_fe_open2 for the log function More...
 

Enumerations

enum  dvb_country_t {
  COUNTRY_UNKNOWN, AD, AE, AF,
  AG, AI, AL, AM,
  AO, AQ, AR, AS,
  AT, AU, AW, AX,
  AZ, BA, BB, BD,
  BE, BF, BG, BH,
  BI, BJ, BL, BM,
  BN, BO, BQ, BR,
  BS, BT, BV, BW,
  BY, BZ, CA, CC,
  CD, CF, CG, CH,
  CI, CK, CL, CM,
  CN, CO, CR, CU,
  CV, CW, CX, CY,
  CZ, DE, DJ, DK,
  DM, DO, DZ, EC,
  EE, EG, EH, ER,
  ES, ET, FI, FJ,
  FK, FM, FO, FR,
  GA, GB, GD, GE,
  GF, GG, GH, GI,
  GL, GM, GN, GP,
  GQ, GR, GS, GT,
  GU, GW, GY, HK,
  HM, HN, HR, HT,
  HU, ID, IE, IL,
  IM, IN, IO, IQ,
  IR, IS, IT, JE,
  JM, JO, JP, KE,
  KG, KH, KI, KM,
  KN, KP, KR, KW,
  KY, KZ, LA, LB,
  LC, LI, LK, LR,
  LS, LT, LU, LV,
  LY, MA, MC, MD,
  ME, MF, MG, MH,
  MK, ML, MM, MN,
  MO, MP, MQ, MR,
  MS, MT, MU, MV,
  MW, MX, MY, MZ,
  NA, NC, NE, NF,
  NG, NI, NL, NO,
  NP, NR, NU, NZ,
  OM, PA, PE, PF,
  PG, PH, PK, PL,
  PM, PN, PR, PS,
  PT, PW, PY, QA,
  RE, RO, RS, RU,
  RW, SA, SB, SC,
  SD, SE, SG, SH,
  SI, SJ, SK, SL,
  SM, SN, SO, SR,
  SS, ST, SV, SX,
  SY, SZ, TC, TD,
  TF, TG, TH, TJ,
  TK, TL, TM, TN,
  TO, TR, TT, TV,
  TW, TZ, UA, UG,
  UM, US, UY, UZ,
  VA, VC, VE, VG,
  VI, VN, VU, WF,
  WS, YE, YT, ZA,
  ZM, ZW
}
 ISO-3166-1 alpha-2 country code. More...
 

Functions

void dvb_default_log (int level, const char *fmt,...)
 This is the prototype of the internal log function that it is used, if the library client doesn't desire to override with something else. More...
 
void atsc_time (const uint32_t start_time, struct tm *tm)
 Converts an ATSC EIT formatted timestamp into struct tm. More...
 
uint32_t dvb_crc32 (uint8_t *data, size_t datalen, uint32_t crc)
 Calculates the crc-32 as defined at the MPEG-TS specs. More...
 
enum dvb_country_t dvb_country_a2_to_id (const char *name)
 Converts an Unix-like 2-letter Country code into enum dvb_country_t. More...
 
enum dvb_country_t dvb_country_a3_to_id (const char *name)
 Converts a 3-letter Country code as used by MPEG-TS tables into enum dvb_country_t. More...
 
const char * dvb_country_to_2letters (int id)
 Converts an enum dvb_country_t into Unix-like 2-letter Country code. More...
 
const char * dvb_country_to_3letters (int id)
 Converts an enum dvb_country_t into a 3-letter Country code as used by MPEG-TS tables. More...
 
const char * dvb_country_to_name (int id)
 Converts an enum dvb_country_t into a Country name as used by MPEG-TS tables. More...
 
enum dvb_country_t dvb_guess_user_country (void)
 Guess the country code from the Unix environment variables. More...
 

Detailed Description

Macro Definition Documentation

#define ARRAY_SIZE (   x)

Calculates the number of elements of an array.

Definition at line 64 of file dvb-fe.h.

Typedef Documentation

void(* dvb_logfunc)(int level, const char *fmt,...)

typedef used by dvb_fe_open2 for the log function

Definition at line 44 of file dvb-log.h.

Enumeration Type Documentation

ISO-3166-1 alpha-2 country code.

Enumerator
COUNTRY_UNKNOWN 

(Unknown Country)

AD 

Andorra.

AE 

United Arab Emirates.

AF 

Afghanistan.

AG 

Antigua and Barbuda.

AI 

Anguilla.

AL 

Albania.

AM 

Armenia.

AO 

Angola.

AQ 

Antarctica.

AR 

Argentina.

AS 

American Samoa.

AT 

Austria.

AU 

Australia.

AW 

Aruba.

AX 

Aland Islands.

AZ 

Azerbaijan.

BA 

Bosnia and Herzegovina.

BB 

Barbados.

BD 

Bangladesh.

BE 

Belgium.

BF 

Burkina Faso.

BG 

Bulgaria.

BH 

Bahrain.

BI 

Burundi.

BJ 

Benin.

BL 

Saint Barthelemy.

BM 

Bermuda.

BN 

Brunei Darussalam.

BO 

Plurinational State of Bolivia.

BQ 

Bonaire, Saint Eustatius and Saba.

BR 

Brazil.

BS 

Bahamas.

BT 

Bhutan.

BV 

Bouvet Island.

BW 

Botswana.

BY 

Belarus.

BZ 

Belize.

CA 

Canada.

CC 

Cocos (Keeling) Islands.

CD 

The Democratic Republic of the Congo.

CF 

Central African Republic.

CG 

Congo.

CH 

Switzerland.

CI 

Cote d'Ivoire.

CK 

Cook Islands.

CL 

Chile.

CM 

Cameroon.

CN 

China.

CO 

Colombia.

CR 

Costa Rica.

CU 

Cuba.

CV 

Cape Verde.

CW 

Curacao.

CX 

Christmas Island.

CY 

Cyprus.

CZ 

Czech Republic.

DE 

Germany.

DJ 

Djibouti.

DK 

Denmark.

DM 

Dominica.

DO 

Dominican Republic.

DZ 

Algeria.

EC 

Ecuador.

EE 

Estonia.

EG 

Egypt.

EH 

Western Sahara.

ER 

Eritrea.

ES 

Spain.

ET 

Ethiopia.

FI 

Finland.

FJ 

Fiji.

FK 

Falkland Islands (Malvinas)

FM 

Federated States of Micronesia.

FO 

Faroe Islands.

FR 

France.

GA 

Gabon.

GB 

United Kingdom.

GD 

Grenada.

GE 

Georgia.

GF 

French Guiana.

GG 

Guernsey.

GH 

Ghana.

GI 

Gibraltar.

GL 

Greenland.

GM 

Gambia.

GN 

Guinea.

GP 

Guadeloupe.

GQ 

Equatorial Guinea.

GR 

Greece.

GS 

South Georgia and the South Sandwich Islands.

GT 

Guatemala.

GU 

Guam.

GW 

Guinea-Bissau.

GY 

Guyana.

HK 

Hong Kong.

HM 

Heard Island and McDonald Islands.

HN 

Honduras.

HR 

Croatia.

HT 

Haiti.

HU 

Hungary.

ID 

Indonesia.

IE 

Ireland.

IL 

Israel.

IM 

Isle of Man.

IN 

India.

IO 

British Indian Ocean Territory.

IQ 

Iraq.

IR 

Islamic Republic of Iran.

IS 

Iceland.

IT 

Italy.

JE 

Jersey.

JM 

Jamaica.

JO 

Jordan.

JP 

Japan.

KE 

Kenya.

KG 

Kyrgyzstan.

KH 

Cambodia.

KI 

Kiribati.

KM 

Comoros.

KN 

Saint Kitts and Nevis.

KP 

Democratic People's Republic of Korea.

KR 

Republic of Korea.

KW 

Kuwait.

KY 

Cayman Islands.

KZ 

Kazakhstan.

LA 

Lao People's Democratic Republic.

LB 

Lebanon.

LC 

Saint Lucia.

LI 

Liechtenstein.

LK 

Sri Lanka.

LR 

Liberia.

LS 

Lesotho.

LT 

Lithuania.

LU 

Luxembourg.

LV 

Latvia.

LY 

Libyan Arab Jamahiriya.

MA 

Morocco.

MC 

Monaco.

MD 

Republic of Moldova.

ME 

Montenegro.

MF 

Saint Martin (French part)

MG 

Madagascar.

MH 

Marshall Islands.

MK 

The Former Yugoslav Republic of Macedonia.

ML 

Mali.

MM 

Myanmar.

MN 

Mongolia.

MO 

Macao.

MP 

Northern Mariana Islands.

MQ 

Martinique.

MR 

Mauritania.

MS 

Montserrat.

MT 

Malta.

MU 

Mauritius.

MV 

Maldives.

MW 

Malawi.

MX 

Mexico.

MY 

Malaysia.

MZ 

Mozambique.

NA 

Namibia.

NC 

New Caledonia.

NE 

Niger.

NF 

Norfolk Island.

NG 

Nigeria.

NI 

Nicaragua.

NL 

Netherlands.

NO 

Norway.

NP 

Nepal.

NR 

Nauru.

NU 

Niue.

NZ 

New Zealand.

OM 

Oman.

PA 

Panama.

PE 

Peru.

PF 

French Polynesia.

PG 

Papua New Guinea.

PH 

Philippines.

PK 

Pakistan.

PL 

Poland.

PM 

Saint Pierre and Miquelon.

PN 

Pitcairn.

PR 

Puerto Rico.

PS 

Occupied Palestinian Territory.

PT 

Portugal.

PW 

Palau.

PY 

Paraguay.

QA 

Qatar.

RE 

Reunion.

RO 

Romania.

RS 

Serbia.

RU 

Russian Federation.

RW 

Rwanda.

SA 

Saudi Arabia.

SB 

Solomon Islands.

SC 

Seychelles.

SD 

Sudan.

SE 

Sweden.

SG 

Singapore.

SH 

Saint Helena, Ascension and Tristan da Cunha.

SI 

Slovenia.

SJ 

Svalbard and Jan Mayen.

SK 

Slovakia.

SL 

Sierra Leone.

SM 

San Marino.

SN 

Senegal.

SO 

Somalia.

SR 

Suriname.

SS 

South Sudan.

ST 

Sao Tome and Principe.

SV 

El Salvador.

SX 

Sint Maarten (Dutch part)

SY 

Syrian Arab Republic.

SZ 

Swaziland.

TC 

Turks and Caicos Islands.

TD 

Chad.

TF 

French Southern Territories.

TG 

Togo.

TH 

Thailand.

TJ 

Tajikistan.

TK 

Tokelau.

TL 

Timor-Leste.

TM 

Turkmenistan.

TN 

Tunisia.

TO 

Tonga.

TR 

Turkey.

TT 

Trinidad and Tobago.

TV 

Tuvalu.

TW 

Taiwan, Province of China.

TZ 

United Republic of Tanzania.

UA 

Ukraine.

UG 

Uganda.

UM 

United States Minor Outlying Islands.

US 

United States.

UY 

Uruguay.

UZ 

Uzbekistan.

VA 

Holy See (Vatican City State)

VC 

Saint Vincent and The Grenadines.

VE 

Bolivarian Republic of Venezuela.

VG 

British Virgin Islands.

VI 

U.S.

Virgin Islands

VN 

Viet Nam.

VU 

Vanuatu.

WF 

Wallis and Futuna.

WS 

Samoa.

YE 

Yemen.

YT 

Mayotte.

ZA 

South Africa.

ZM 

Zambia.

ZW 

Zimbabwe.

Definition at line 544 of file countries.h.

Function Documentation

void atsc_time ( const uint32_t  start_time,
struct tm *  tm 
)

Converts an ATSC EIT formatted timestamp into struct tm.

Parameters
start_timeevent on ATSC EIT time format
tmpointer to struct tm where the converted timestamp will be stored.
enum dvb_country_t dvb_country_a2_to_id ( const char *  name)

Converts an Unix-like 2-letter Country code into enum dvb_country_t.

Parameters
nametwo-letter Country code.
Returns
It returns the corresponding enum dvb_country_t ID. If not found, returns COUNTRY_UNKNOWN.
enum dvb_country_t dvb_country_a3_to_id ( const char *  name)

Converts a 3-letter Country code as used by MPEG-TS tables into enum dvb_country_t.

Parameters
namethree-letter Country code.
Returns
It returns the corresponding enum dvb_country_t ID. If not found, returns COUNTRY_UNKNOWN.
const char* dvb_country_to_2letters ( int  id)

Converts an enum dvb_country_t into Unix-like 2-letter Country code.

Parameters
idenum dvb_country_t ID.
Returns
It returns the 2-letter country code string that corresponts to the Country. If not found, returns NULL.
const char* dvb_country_to_3letters ( int  id)

Converts an enum dvb_country_t into a 3-letter Country code as used by MPEG-TS tables.

Parameters
idenum dvb_country_t ID.
Returns
It returns the 3-letter country code string that corresponts to the Country. If not found, returns NULL.
const char* dvb_country_to_name ( int  id)

Converts an enum dvb_country_t into a Country name as used by MPEG-TS tables.

Parameters
idenum dvb_country_t ID.
Returns
It returns a string with the Country name that corresponts to the country. If not found, returns NULL.
uint32_t dvb_crc32 ( uint8_t *  data,
size_t  datalen,
uint32_t  crc 
)

Calculates the crc-32 as defined at the MPEG-TS specs.

Parameters
dataPointer to the buffer to be checked
datalenLength of the buffer
crcInitial value for the crc checksum. To calculate the checksum of the entire packet at once, use 0xFFFFFFFF
void dvb_default_log ( int  level,
const char *  fmt,
  ... 
)

This is the prototype of the internal log function that it is used, if the library client doesn't desire to override with something else.

Parameters
levellevel of the message, as defined at syslog.h
fmtformat string (same as format string on sprintf)
enum dvb_country_t dvb_guess_user_country ( void  )

Guess the country code from the Unix environment variables.

Returns
It returns the corresponding enum dvb_country_t ID. If not found, returns COUNTRY_UNKNOWN.