요약·해설과 원문, 전문 번역을 서로 분리했습니다. 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.fe
4
.. _FE_SET_FRONTEND:
6
***************
7
FE_SET_FRONTEND
8
***************
10
.. attention:: This ioctl is deprecated.
12
Name
13
====
15
FE_SET_FRONTEND
17
Synopsis
18
========
20
.. c:macro:: FE_SET_FRONTEND
22
``int ioctl(int fd, FE_SET_FRONTEND, struct dvb_frontend_parameters *p)``
24
Arguments
25
=========
27
``fd``
28
File descriptor returned by :c:func:`open()`.
30
``p``
31
Points to parameters for tuning operation.
33
Description
34
===========
36
This ioctl call starts a tuning operation using specified parameters.
37
The result of this call will be successful if the parameters were valid
38
and the tuning could be initiated. The result of the tuning operation in
39
itself, however, will arrive asynchronously as an event (see
40
documentation for :ref:`FE_GET_EVENT` and
41
FrontendEvent.) If a new :ref:`FE_SET_FRONTEND`
42
operation is initiated before the previous one was completed, the
43
previous operation will be aborted in favor of the new one. This command
44
requires read/write access to the device.
46
Return Value
47
============
49
On success 0 is returned.
51
On error -1 is returned, and the ``errno`` variable is set
52
appropriately.
54
.. tabularcolumns:: |p{2.5cm}|p{15.0cm}|
56
.. flat-table::
57
:header-rows: 0
58
:stub-columns: 0
59
:widths: 1 16
61
- .. row 1
63
- ``EINVAL``
65
- Maximum supported symbol rate reached.
67
Generic error codes are described at the
68
:ref:`Generic Error Codes <gen-errors>` chapter.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Deprecated tuning ioctl 선언
1-32`FE_SET_FRONTEND`는 deprecated된 tuning ioctl입니다. 호출 형식은 `int ioctl(int fd, FE_SET_FRONTEND, struct dvb_frontend_parameters *p)`입니다.
인수의미
fdopen()이 반환한 파일 descriptor
ptuning operation용 dvb_frontend_parameters 포인터
Legacy tuning 매개변수 구조체를 전달합니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.fe
.. _FE_SET_FRONTEND:
***************
FE_SET_FRONTEND
***************
.. attention:: This ioctl is deprecated.
Name
====
FE_SET_FRONTEND
Synopsis
========
.. c:macro:: FE_SET_FRONTEND
``int ioctl(int fd, FE_SET_FRONTEND, struct dvb_frontend_parameters *p)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
``p``
Points to parameters for tuning operation.
비동기 tuning과 교체 동작
33-68지정한 매개변수로 tuning operation을 시작합니다. 매개변수가 유효하고 tuning을 시작할 수 있으면 이 호출 자체는 성공합니다.
실제 tuning 결과는 비동기 event로 도착하며 `FE_GET_EVENT`와 `FrontendEvent` 문서를 참조해야 합니다.
이전 `FE_SET_FRONTEND`가 끝나기 전에 새 operation을 시작하면 이전 operation을 중단하고 새 요청을 우선합니다. 장치에 대한 read/write 접근이 필요합니다.
성공 시 0, 오류 시 -1을 반환하고 `errno`를 설정합니다.
오류조건
EINVAL지원 가능한 최대 symbol rate에 도달함
원문 flat-table의 오류 조건입니다.
dvb_frontend_parameters 구성→FE_SET_FRONTEND로 tuning 시작→호출 성공은 요청 시작만 의미→실제 결과를 frontend event로 비동기 수신→새 SET 요청은 진행 중인 이전 요청 중단
호출 성공과 실제 lock 성공은 서로 다른 시점입니다.
그 밖의 일반 오류는 `Generic Error Codes <gen-errors>` 절에 설명되어 있습니다.
Description
===========
This ioctl call starts a tuning operation using specified parameters.
The result of this call will be successful if the parameters were valid
and the tuning could be initiated. The result of the tuning operation in
itself, however, will arrive asynchronously as an event (see
documentation for :ref:`FE_GET_EVENT` and
FrontendEvent.) If a new :ref:`FE_SET_FRONTEND`
operation is initiated before the previous one was completed, the
previous operation will be aborted in favor of the new one. This command
requires read/write access to the device.
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
:widths: 1 16
- .. row 1
- ``EINVAL``
- Maximum supported symbol rate reached.
Generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter.
요약·해설
fe-set-frontend.rst:1-68호출 성공은 tuning 시작만 뜻하고 실제 결과는 비동기 event로 도착합니다. 신규 요청은 진행 중인 이전 요청을 중단합니다.