요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
.. c:namespace:: DTV.dmx
4
.. _DMX_START:
6
=========
7
DMX_START
8
=========
10
Name
11
----
13
DMX_START
15
Synopsis
16
--------
18
.. c:macro:: DMX_START
20
``int ioctl(int fd, DMX_START)``
22
Arguments
23
---------
25
``fd``
26
File descriptor returned by :c:func:`open()`.
28
Description
29
-----------
31
This ioctl call is used to start the actual filtering operation defined
32
via the ioctl calls :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER`.
34
Return Value
35
------------
37
On success 0 is returned.
39
On error -1 is returned, and the ``errno`` variable is set
40
appropriately.
42
.. tabularcolumns:: |p{2.5cm}|p{15.0cm}|
44
.. flat-table::
45
:header-rows: 0
46
:stub-columns: 0
48
- .. row 1
50
- ``EINVAL``
52
- Invalid argument, i.e. no filtering parameters provided via the
53
:ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER` ioctls.
55
- .. row 2
57
- ``EBUSY``
59
- This error code indicates that there are conflicting requests.
60
There are active filters filtering data from another input source.
61
Make sure that these filters are stopped before starting this
62
filter.
64
The generic error codes are described at the
65
:ref:`Generic Error Codes <gen-errors>` chapter.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
이름과 호출 형식
1-20이 문서는 GFDL-1.1-no-invariants-or-later 라이선스와 `DTV.dmx` C namespace를 사용하며 `DMX_START` ioctl을 설명합니다.
호출 형식은 `int ioctl(int fd, DMX_START)`입니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.dmx
.. _DMX_START:
=========
DMX_START
=========
Name
----
DMX_START
Synopsis
--------
.. c:macro:: DMX_START
``int ioctl(int fd, DMX_START)``구성된 필터 시작
21-33`fd`는 `open()`이 반환한 file descriptor입니다.
이 ioctl은 `DMX_SET_FILTER` 또는 `DMX_SET_PES_FILTER`로 정의한 실제 필터링 동작을 시작합니다.
fd에 DMX_SET_FILTER 또는 DMX_SET_PES_FILTER 적용→필터 매개변수 검증→DMX_START 호출→실제 필터링 동작 시작
즉시 시작 플래그를 사용하지 않은 필터의 실행 순서입니다.
Arguments
---------
``fd``
File descriptor returned by :c:func:`open()`.
Description
-----------
This ioctl call is used to start the actual filtering operation defined
via the ioctl calls :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER`.
반환값과 오류
34-65성공하면 0을 반환하고, 오류가 발생하면 -1을 반환하며 `errno`를 적절히 설정합니다.
오류조건
EINVALDMX_SET_FILTER 또는 DMX_SET_PES_FILTER로 필터 매개변수를 제공하지 않음
EBUSY다른 input source의 데이터를 필터링하는 활성 필터가 있어 요청이 충돌함
구성 누락과 입력 소스 충돌을 구분합니다.
`EBUSY`인 경우 새 필터를 시작하기 전에 충돌하는 활성 필터를 중지해야 합니다.
그 밖의 공통 오류 코드는 `Generic Error Codes <gen-errors>` 장에서 설명합니다.
Return Value
------------
On success 0 is returned.
On error -1 is returned, and the ``errno`` variable is set
appropriately.
.. tabularcolumns:: |p{2.5cm}|p{15.0cm}|
.. flat-table::
:header-rows: 0
:stub-columns: 0
- .. row 1
- ``EINVAL``
- Invalid argument, i.e. no filtering parameters provided via the
:ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER` ioctls.
- .. row 2
- ``EBUSY``
- This error code indicates that there are conflicting requests.
There are active filters filtering data from another input source.
Make sure that these filters are stopped before starting this
filter.
The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter.
요약·해설
dmx-start.rst:1-65DMX_START 전에 section 또는 PES 필터 매개변수를 반드시 설정해야 합니다. 구성 누락은 EINVAL, 다른 입력 소스와의 충돌은 EBUSY입니다.