요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.fe
.. _FE_GET_INFO:
*****************
ioctl FE_GET_INFO
*****************
Name
====
FE_GET_INFO - Query Digital TV frontend capabilities and returns information
about the - front-end. This call only requires read-only access to the device.
Synopsis
========
.. c:macro:: FE_GET_INFO
``int ioctl(int fd, FE_GET_INFO, struct dvb_frontend_info *argp)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
``argp``
pointer to struct :c:type:`dvb_frontend_info`
Description
===========
All Digital TV frontend devices support the :ref:`FE_GET_INFO` ioctl. It is
used to identify kernel devices compatible with this specification and to
obtain information about driver and hardware capabilities. The ioctl
takes a pointer to dvb_frontend_info which is filled by the driver.
When the driver is not compatible with this specification the ioctl
returns an error.
frontend capabilities
=====================
Capabilities describe what a frontend can do. Some capabilities are
supported only on some specific frontend types.
The frontend capabilities are described at :c:type:`fe_caps`.
Return Value
============
On success 0 is returned.
On error -1 is returned, and the ``errno`` variable is set
appropriately.
Generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Frontend 정보 조회 선언과 인수
1-31`FE_GET_INFO`는 Digital TV frontend capability와 frontend 정보를 조회하며 장치에 대한 read-only 접근만 요구합니다.
호출 형식은 `int ioctl(int fd, FE_GET_INFO, struct dvb_frontend_info *argp)`입니다.
Driver가 채울 정보 구조체를 포인터로 전달합니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.fe
.. _FE_GET_INFO:
*****************
ioctl FE_GET_INFO
*****************
Name
====
FE_GET_INFO - Query Digital TV frontend capabilities and returns information
about the - front-end. This call only requires read-only access to the device.
Synopsis
========
.. c:macro:: FE_GET_INFO
``int ioctl(int fd, FE_GET_INFO, struct dvb_frontend_info *argp)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
``argp``
pointer to struct :c:type:`dvb_frontend_info`
호환성 식별과 fe_caps
32-59모든 Digital TV frontend 장치는 `FE_GET_INFO`를 지원합니다. 이 ioctl은 해당 kernel 장치가 이 명세와 호환되는지 식별하고 driver 및 하드웨어 capability 정보를 얻는 데 사용합니다.
호출자는 `dvb_frontend_info` 포인터를 전달하고 driver가 구조체를 채웁니다. Driver가 이 명세와 호환되지 않으면 ioctl이 오류를 반환합니다.
Capability는 frontend가 수행할 수 있는 기능을 나타냅니다. 일부 capability는 특정 frontend 형식에서만 지원되며 값은 `fe_caps`에 정의되어 있습니다.
성공 시 0, 오류 시 -1을 반환하고 `errno`를 설정합니다. 일반 오류는 `Generic Error Codes <gen-errors>` 절을 따릅니다.
호환 장치 식별과 capability 수집 절차입니다.
Description
===========
All Digital TV frontend devices support the :ref:`FE_GET_INFO` ioctl. It is
used to identify kernel devices compatible with this specification and to
obtain information about driver and hardware capabilities. The ioctl
takes a pointer to dvb_frontend_info which is filled by the driver.
When the driver is not compatible with this specification the ioctl
returns an error.
frontend capabilities
=====================
Capabilities describe what a frontend can do. Some capabilities are
supported only on some specific frontend types.
The frontend capabilities are described at :c:type:`fe_caps`.
Return Value
============
On success 0 is returned.
On error -1 is returned, and the ``errno`` variable is set
appropriately.
Generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter.
요약·해설
fe-get-info.rst:1-59모든 Digital TV frontend가 지원하는 장치 식별·capability 조회 ioctl입니다.