요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
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. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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를 우선해야 합니다.