요약·해설과 원문, 전문 번역을 서로 분리했습니다. 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_READ_STATUS:
********************
ioctl FE_READ_STATUS
********************
Name
====
FE_READ_STATUS - Returns status information about the front-end. This call only requires - read-only access to the device
Synopsis
========
.. c:macro:: FE_READ_STATUS
``int ioctl(int fd, FE_READ_STATUS, unsigned int *status)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
``status``
pointer to a bitmask integer filled with the values defined by enum
:c:type:`fe_status`.
Description
===========
All Digital TV frontend devices support the ``FE_READ_STATUS`` ioctl. It is
used to check about the locking status of the frontend after being
tuned. The ioctl takes a pointer to an integer where the status will be
written.
.. note::
The size of status is actually sizeof(enum fe_status), with
varies according with the architecture. This needs to be fixed in the
future.
int fe_status
=============
The fe_status parameter is used to indicate the current state and/or
state changes of the frontend hardware. It is produced using the enum
:c:type:`fe_status` values on a bitmask
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 lock status 조회 선언
1-31`FE_READ_STATUS`는 frontend 상태 정보를 반환하며 장치에 대한 read-only 접근만 요구합니다.
호출 형식은 `int ioctl(int fd, FE_READ_STATUS, unsigned int *status)`입니다.
fe_status enum 값을 bitmask로 받을 정수 포인터입니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.fe
.. _FE_READ_STATUS:
********************
ioctl FE_READ_STATUS
********************
Name
====
FE_READ_STATUS - Returns status information about the front-end. This call only requires - read-only access to the device
Synopsis
========
.. c:macro:: FE_READ_STATUS
``int ioctl(int fd, FE_READ_STATUS, unsigned int *status)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
``status``
pointer to a bitmask integer filled with the values defined by enum
:c:type:`fe_status`.
Lock 상태 bitmask와 ABI 주의
32-62모든 Digital TV frontend 장치는 `FE_READ_STATUS`를 지원합니다. Tuning 이후 frontend의 lock 상태를 확인하며, ioctl은 status를 기록할 정수 포인터를 받습니다.
주의: status의 실제 크기는 `sizeof(enum fe_status)`이고 architecture에 따라 달라집니다. 원문은 이 문제를 향후 수정해야 한다고 명시합니다.
`fe_status` 매개변수는 frontend 하드웨어의 현재 상태 또는 상태 변화를 나타냅니다. `enum fe_status` 값을 bitmask로 조합해 생성합니다.
성공 시 0, 오류 시 -1을 반환하고 `errno`를 설정합니다. 일반 오류는 `Generic Error Codes <gen-errors>` 절을 따릅니다.
Tuning 이후 status bitmask를 해석하는 흐름입니다.
Description
===========
All Digital TV frontend devices support the ``FE_READ_STATUS`` ioctl. It is
used to check about the locking status of the frontend after being
tuned. The ioctl takes a pointer to an integer where the status will be
written.
.. note::
The size of status is actually sizeof(enum fe_status), with
varies according with the architecture. This needs to be fixed in the
future.
int fe_status
=============
The fe_status parameter is used to indicate the current state and/or
state changes of the frontend hardware. It is produced using the enum
:c:type:`fe_status` values on a bitmask
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-read-status.rst:1-62모든 frontend가 지원하는 lock 상태 조회 ioctl입니다. `sizeof(enum fe_status)`가 architecture에 따라 달라지는 ABI 주의가 있습니다.