요약·해설과 원문, 전문 번역을 서로 분리했습니다. 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_READ_SIGNAL_STRENGTH:
6
***********************
7
FE_READ_SIGNAL_STRENGTH
8
***********************
10
Name
11
====
13
FE_READ_SIGNAL_STRENGTH
15
.. attention:: This ioctl is deprecated.
17
Synopsis
18
========
20
.. c:macro:: FE_READ_SIGNAL_STRENGTH
22
``int ioctl(int fd, FE_READ_SIGNAL_STRENGTH, uint16_t *strength)``
24
Arguments
25
=========
27
``fd``
28
File descriptor returned by :c:func:`open()`.
30
``strength``
31
The signal strength value is stored into \*strength.
33
Description
34
===========
36
This ioctl call returns the signal strength value for the signal
37
currently received by the front-end. For this command, read-only access
38
to the device is sufficient.
40
Return Value
41
============
43
On success 0 is returned.
45
On error -1 is returned, and the ``errno`` variable is set
46
appropriately.
48
Generic error codes are described at the
49
:ref:`Generic Error Codes <gen-errors>` chapter.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Deprecated 신호 세기 조회 선언
1-32`FE_READ_SIGNAL_STRENGTH`는 deprecated된 ioctl입니다. 호출 형식은 `int ioctl(int fd, FE_READ_SIGNAL_STRENGTH, uint16_t *strength)`입니다.
인수의미
fdopen()이 반환한 파일 descriptor
strengthsignal strength 값을 저장할 uint16_t 포인터
신호 세기를 16bit unsigned 값으로 받습니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.fe
.. _FE_READ_SIGNAL_STRENGTH:
***********************
FE_READ_SIGNAL_STRENGTH
***********************
Name
====
FE_READ_SIGNAL_STRENGTH
.. attention:: This ioctl is deprecated.
Synopsis
========
.. c:macro:: FE_READ_SIGNAL_STRENGTH
``int ioctl(int fd, FE_READ_SIGNAL_STRENGTH, uint16_t *strength)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
``strength``
The signal strength value is stored into \*strength.
현재 수신 신호의 strength
33-49Frontend가 현재 수신하는 signal의 strength 값을 `*strength`에 반환합니다. 이 command에는 read-only 접근이면 충분합니다.
성공 시 0, 오류 시 -1을 반환하고 `errno`를 설정합니다. 일반 오류는 `Generic Error Codes <gen-errors>` 절을 따릅니다.
원문은 값의 절대 단위나 scale을 명시하지 않으므로 `uint16_t`라는 저장 형식만 보존합니다.
Description
===========
This ioctl call returns the signal strength value for the signal
currently received by the front-end. 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.
Generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter.
요약·해설
fe-read-signal-strength.rst:1-49현재 신호 세기를 반환하는 legacy ioctl이며 절대 단위는 원문에 명시되지 않습니다.