Documentation/userspace-api/media/dvb/fe-read-ber.rst GitHub 원문 ↗

Linux 6.18.37 · Userspace API / Media / DVB / Frontend

FE_READ_BER

Deprecated 상태이며 uint32_t bit error rate를 조회하는 ioctl입니다.

Source pathDocumentation/userspace-api/media/dvb/fe-read-ber.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약·해설

fe-read-ber.rst:1-49

현재 수신·복조 신호의 BER을 반환하는 legacy ioctl이며 원문은 단위나 scale을 정의하지 않습니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2 .. c:namespace:: DTV.fe
3
4 .. _FE_READ_BER:
5
6 ***********
7 FE_READ_BER
8 ***********
9
10 Name
11 ====
12
13 FE_READ_BER
14
15 .. attention:: This ioctl is deprecated.
16
17 Synopsis
18 ========
19
20 .. c:macro:: FE_READ_BER
21
22 ``int ioctl(int fd, FE_READ_BER, uint32_t *ber)``
23
24 Arguments
25 =========
26
27 ``fd``
28 File descriptor returned by :c:func:`open()`.
29
30 ``ber``
31 The bit error rate is stored into \*ber.
32
33 Description
34 ===========
35
36 This ioctl call returns the bit error rate for the signal currently
37 received/demodulated by the front-end. For this command, read-only
38 access to the device is sufficient.
39
40 Return Value
41 ============
42
43 On success 0 is returned.
44
45 On error -1 is returned, and the ``errno`` variable is set
46 appropriately.
47
48 Generic error codes are described at the
49 :ref:`Generic Error Codes <gen-errors>` chapter.
50

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

Deprecated BER 조회 선언

1-32

`FE_READ_BER`는 deprecated 상태인 ioctl입니다. 호출 형식은 `int ioctl(int fd, FE_READ_BER, uint32_t *ber)`입니다.

FE_READ_BER 인수
인수의미
fdopen()이 반환한 파일 descriptor
berbit error rate를 저장할 uint32_t 포인터

Bit error rate를 32bit unsigned 값으로 받습니다.

.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.fe

.. _FE_READ_BER:

***********
FE_READ_BER
***********

Name
====

FE_READ_BER

.. attention:: This ioctl is deprecated.

Synopsis
========

.. c:macro:: FE_READ_BER

``int ioctl(int fd, FE_READ_BER, uint32_t *ber)``

Arguments
=========

``fd``
    File descriptor returned by :c:func:`open()`.

``ber``
    The bit error rate is stored into \*ber.

현재 수신 신호의 bit error rate

33-49

현재 frontend가 수신하고 복조하는 signal의 bit error rate를 `*ber`에 반환합니다. 장치에 대한 read-only 접근만으로 충분합니다.

성공하면 0을 반환합니다. 오류가 발생하면 -1을 반환하고 `errno`를 설정합니다. 일반 오류는 `Generic Error Codes <gen-errors>` 절을 따릅니다.

원문은 BER 값의 단위나 scale을 추가로 정의하지 않으므로 이 페이지에서도 임의의 정규화 의미를 부여하지 않습니다.

Description
===========

This ioctl call returns the bit error rate for the signal currently
received/demodulated 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.