요약·해설과 원문, 전문 번역을 서로 분리했습니다. 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_GET_FRONTEND:
6
***************
7
FE_GET_FRONTEND
8
***************
10
Name
11
====
13
FE_GET_FRONTEND
15
.. attention:: This ioctl is deprecated.
17
Synopsis
18
========
20
.. c:macro:: FE_GET_FRONTEND
22
``int ioctl(int fd, FE_GET_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 queries the currently effective frontend parameters. For
37
this command, read-only access to the device is sufficient.
39
Return Value
40
============
42
On success 0 is returned.
44
On error -1 is returned, and the ``errno`` variable is set
45
appropriately.
47
.. flat-table::
48
:header-rows: 0
49
:stub-columns: 0
51
- .. row 1
53
- ``EINVAL``
55
- Maximum supported symbol rate reached.
57
Generic error codes are described at the
58
:ref:`Generic Error Codes <gen-errors>` chapter.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Deprecated frontend 매개변수 조회
1-32`FE_GET_FRONTEND`는 deprecated된 ioctl입니다. 호출 형식은 `int ioctl(int fd, FE_GET_FRONTEND, struct dvb_frontend_parameters *p)`입니다.
인수의미
fdopen()이 반환한 파일 descriptor
ptuning operation 매개변수를 받을 dvb_frontend_parameters 포인터
현재 적용된 tuning 매개변수를 받을 구조체입니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.fe
.. _FE_GET_FRONTEND:
***************
FE_GET_FRONTEND
***************
Name
====
FE_GET_FRONTEND
.. attention:: This ioctl is deprecated.
Synopsis
========
.. c:macro:: FE_GET_FRONTEND
``int ioctl(int fd, FE_GET_FRONTEND, struct dvb_frontend_parameters *p)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
``p``
Points to parameters for tuning operation.
현재 유효한 tuning 값과 오류
33-58이 ioctl은 현재 실제로 적용 중인 frontend 매개변수를 조회합니다. 장치에 대한 read-only 접근만으로 충분합니다.
성공하면 0을 반환하고, 오류가 발생하면 -1을 반환하면서 `errno`를 설정합니다.
오류조건
EINVAL지원 가능한 최대 symbol rate에 도달함
원문 flat-table에 정의된 오류입니다.
일반 오류 code는 `Generic Error Codes <gen-errors>` 절에 설명되어 있습니다.
Description
===========
This ioctl call queries the currently effective frontend parameters. For
this command, read-only access to the device is sufficient.
Return Value
============
On success 0 is returned.
On error -1 is returned, and the ``errno`` variable is set
appropriately.
.. flat-table::
:header-rows: 0
:stub-columns: 0
- .. row 1
- ``EINVAL``
- Maximum supported symbol rate reached.
Generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter.
요약·해설
fe-get-frontend.rst:1-58현재 유효한 legacy tuning parameter를 read-only로 가져오지만 deprecated되었으므로 property API를 우선해야 합니다.