Part II - Digital TV API | Linux 6.18.37

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

dvbapi.rst:1-113

Digital TV API는 유럽 DVB에서 출발해 모든 디지털 TV 표준으로 확장됐습니다. 문서는 혼동을 줄이기 위해 API와 하드웨어를 Digital TV라 부르고 DVB를 버전·자료형·장치 노드·유럽 표준에 한정합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기

1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later

2 .. include:: <isonum.txt>

4 .. _dvbapi:

6 ########################

7 Part II - Digital TV API

8 ########################

10 .. note::

12 This API is also known as Linux **DVB API**.

14 It it was originally written to support the European digital TV

15 standard (DVB), and later extended to support all digital TV standards.

17 In order to avoid confusion, within this document, it was opted to refer to

18 it, and to associated hardware as **Digital TV**.

20 The word **DVB** is reserved to be used for:

22 - the Digital TV API version

23 (e. g. DVB API version 3 or DVB API version 5);

24 - digital TV data types (enums, structs, defines, etc);

25 - digital TV device nodes (``/dev/dvb/...``);

26 - the European DVB standard.

28 **Version 5.10**

30 .. toctree::

31 :caption: Table of Contents

32 :maxdepth: 5

33 :numbered:

35 intro

36 frontend

37 demux

38 ca

39 net

40 legacy_dvb_apis

41 examples

42 headers

45 **********************

46 Revision and Copyright

47 **********************

49 Authors:

51 - J. K. Metzler, Ralph <[email protected]>

53 - Original author of the Digital TV API documentation.

55 - O. C. Metzler, Marcus <[email protected]>

57 - Original author of the Digital TV API documentation.

59 - Carvalho Chehab, Mauro <[email protected]>

61 - Ported document to Docbook XML, addition of DVBv5 API, documentation gaps fix.

63 **Copyright** |copy| 2002-2003 : Convergence GmbH

65 **Copyright** |copy| 2009-2017 : Mauro Carvalho Chehab

67 ****************

68 Revision History

69 ****************

71 :revision: 2.2.0 / 2017-09-01 (*mcc*)

73 Most gaps between the uAPI document and the Kernel implementation

74 got fixed for the non-legacy API.

76 :revision: 2.1.0 / 2015-05-29 (*mcc*)

78 DocBook improvements and cleanups, in order to document the system calls

79 on a more standard way and provide more description about the current

80 Digital TV API.

82 :revision: 2.0.4 / 2011-05-06 (*mcc*)

84 Add more information about DVBv5 API, better describing the frontend

85 GET/SET props ioctl's.

88 :revision: 2.0.3 / 2010-07-03 (*mcc*)

90 Add some frontend capabilities flags, present on kernel, but missing at

91 the specs.

94 :revision: 2.0.2 / 2009-10-25 (*mcc*)

96 documents FE_SET_FRONTEND_TUNE_MODE and

97 FE_DISHETWORK_SEND_LEGACY_CMD ioctls.

100 :revision: 2.0.1 / 2009-09-16 (*mcc*)

101

102 Added ISDB-T test originally written by Patrick Boettcher

103

104

105 :revision: 2.0.0 / 2009-09-06 (*mcc*)

106

107 Conversion from LaTex to DocBook XML. The contents is the same as the

108 original LaTex version.

109

110

111 :revision: 1.0.0 / 2003-07-24 (*rjkm*)

112

113 Initial revision on LaTEX.

114

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Digital TV와 DVB 명칭의 범위

1-27

이 문서는 GFDL-1.1-no-invariants-or-later 라이선스를 따르고 `isonum.txt`를 포함하며 `dvbapi` 참조 대상으로 Digital TV API 제2부를 구성합니다.

이 API는 Linux DVB API라고도 합니다. 처음에는 유럽 디지털 TV 표준인 DVB를 지원하려고 작성했지만 이후 모든 디지털 TV 표준을 지원하도록 확장되었습니다.

혼동을 피하기 위해 이 문서에서는 API와 관련 하드웨어를 `Digital TV`라고 부릅니다.

`DVB`라는 말은 Digital TV API 버전, enum·struct·define 같은 Digital TV 자료형, `/dev/dvb/...` 장치 노드, 유럽 DVB 표준을 가리킬 때에만 사용합니다.

문서에서 DVB를 사용하는 범위

항목설명

API 버전DVB API version 3 또는 version 5

자료형enum, struct, define 등

장치 노드/dev/dvb/...

표준유럽 DVB 표준

Digital TV라는 일반 명칭과 구분되는 네 경우입니다.

.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. include:: <isonum.txt>

.. _dvbapi:

########################
Part II - Digital TV API
########################

.. note::

   This API is also known as Linux **DVB API**.

   It it was originally written to support the European digital TV
   standard (DVB), and later extended to support all digital TV standards.

   In order to avoid confusion, within this document, it was opted to refer to
   it, and to associated hardware as **Digital TV**.

   The word **DVB** is reserved to be used for:

     - the Digital TV API version
       (e. g. DVB API version 3 or DVB API version 5);
     - digital TV data types (enums, structs, defines, etc);
     - digital TV device nodes (``/dev/dvb/...``);
     - the European DVB standard.

버전과 목차

28-43

이 문서가 표시하는 API 버전은 5.10입니다.

번호가 붙는 목차의 최대 깊이는 5이며 다음 하위 문서를 포함합니다.

Digital TV API 목차

항목설명

intro소개

frontendFrontend 장치

demuxDemux 장치

caConditional Access 장치

netDigital TV 네트워크 인터페이스

legacy_dvb_apis레거시 DVB API

examples예제

headers헤더 참조

toctree에 선언된 문서 순서입니다.

**Version 5.10**

.. toctree::
    :caption: Table of Contents
    :maxdepth: 5
    :numbered:

    intro
    frontend
    demux
    ca
    net
    legacy_dvb_apis
    examples
    headers

저자와 저작권

44-66

J. K. Metzler, Ralph와 O. C. Metzler, Marcus는 Digital TV API 문서의 원저자입니다. 원문의 이름과 이메일 주소는 그대로 보존합니다.

Carvalho Chehab, Mauro는 문서를 DocBook XML로 옮기고 DVBv5 API를 추가했으며 문서 공백을 보완했습니다.

Digital TV API 문서 기여

저자기여

J. K. Metzler, RalphDigital TV API 문서 원저자

O. C. Metzler, MarcusDigital TV API 문서 원저자

Carvalho Chehab, MauroDocBook XML 이식, DVBv5 API 추가, 문서 공백 보완

원문에 기록된 저자별 역할입니다.


**********************
Revision and Copyright
**********************

Authors:

- J. K. Metzler, Ralph <[email protected]>

 - Original author of the Digital TV API documentation.

- O. C. Metzler, Marcus <[email protected]>

 - Original author of the Digital TV API documentation.

- Carvalho Chehab, Mauro <[email protected]>

 - Ported document to Docbook XML, addition of DVBv5 API, documentation gaps fix.

**Copyright** |copy| 2002-2003 : Convergence GmbH

**Copyright** |copy| 2009-2017 : Mauro Carvalho Chehab

개정 이력 2.2.0부터 2.0.4까지

67-85

2.2.0(2017-09-01)은 non-legacy API에서 uAPI 문서와 커널 구현 사이의 대부분의 차이를 수정했습니다.

2.1.0(2015-05-29)은 시스템 호출을 더 표준적인 방식으로 문서화하고 당시 Digital TV API 설명을 확충하기 위해 DocBook을 개선하고 정리했습니다.

2.0.4(2011-05-06)는 DVBv5 API와 frontend GET/SET property ioctl 설명을 보강했습니다.

최근 개정

버전변경 내용

2.2.0 / 2017-09-01non-legacy uAPI 문서와 커널 구현의 차이 수정

2.1.0 / 2015-05-29DocBook 개선 및 시스템 호출·현행 API 설명 보강

2.0.4 / 2011-05-06DVBv5와 frontend GET/SET props 설명 추가

버전별 핵심 변경입니다.

****************
Revision History
****************

:revision: 2.2.0 / 2017-09-01 (*mcc*)

Most gaps between the uAPI document and the Kernel implementation
got fixed for the non-legacy API.

:revision: 2.1.0 / 2015-05-29 (*mcc*)

DocBook improvements and cleanups, in order to document the system calls
on a more standard way and provide more description about the current
Digital TV API.

:revision: 2.0.4 / 2011-05-06 (*mcc*)

Add more information about DVBv5 API, better describing the frontend
GET/SET props ioctl's.

개정 이력 2.0.3부터 1.0.0까지

86-113

2.0.3(2010-07-03)은 커널에는 있으나 명세에 빠졌던 frontend capability flag를 추가했습니다.

2.0.2(2009-10-25)는 `FE_SET_FRONTEND_TUNE_MODE`와 `FE_DISHETWORK_SEND_LEGACY_CMD` ioctl을 문서화했습니다. 원문의 symbol 철자는 그대로 보존합니다.

2.0.1(2009-09-16)은 Patrick Boettcher가 처음 작성한 ISDB-T 테스트를 추가했습니다.

2.0.0(2009-09-06)은 LaTeX 문서를 같은 내용의 DocBook XML로 변환했습니다.

1.0.0(2003-07-24)은 LaTeX로 작성한 최초 개정입니다.

초기 개정

버전변경 내용

2.0.3 / 2010-07-03누락된 frontend capability flag 추가

2.0.2 / 2009-10-25두 legacy ioctl 문서화

2.0.1 / 2009-09-16ISDB-T 테스트 추가

2.0.0 / 2009-09-06LaTeX에서 DocBook XML로 변환

1.0.0 / 2003-07-24최초 LaTeX 개정

2.0.3 이전의 변경 이력입니다.



:revision: 2.0.3 / 2010-07-03 (*mcc*)

Add some frontend capabilities flags, present on kernel, but missing at
the specs.


:revision: 2.0.2 / 2009-10-25 (*mcc*)

documents FE_SET_FRONTEND_TUNE_MODE and
FE_DISHETWORK_SEND_LEGACY_CMD ioctls.


:revision: 2.0.1 / 2009-09-16 (*mcc*)

Added ISDB-T test originally written by Patrick Boettcher


:revision: 2.0.0 / 2009-09-06 (*mcc*)

Conversion from LaTex to DocBook XML. The contents is the same as the
original LaTex version.


:revision: 1.0.0 / 2003-07-24 (*rjkm*)

Initial revision on LaTEX.