요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. 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_READ_UNCORRECTED_BLOCKS:
6
**************************
7
FE_READ_UNCORRECTED_BLOCKS
8
**************************
10
Name
11
====
13
FE_READ_UNCORRECTED_BLOCKS
15
.. attention:: This ioctl is deprecated.
17
Synopsis
18
========
20
.. c:macro:: FE_READ_UNCORRECTED_BLOCKS
22
``int ioctl(int fd, FE_READ_UNCORRECTED_BLOCKS, uint32_t *ublocks)``
24
Arguments
25
=========
27
``fd``
28
File descriptor returned by :c:func:`open()`.
30
``ublocks``
31
The total number of uncorrected blocks seen by the driver so far.
33
Description
34
===========
36
This ioctl call returns the number of uncorrected blocks detected by the
37
device driver during its lifetime. For meaningful measurements, the
38
increment in block count during a specific time interval should be
39
calculated. For this command, read-only access to the device is
40
sufficient.
42
Return Value
43
============
45
On success 0 is returned.
47
On error -1 is returned, and the ``errno`` variable is set
48
appropriately.
50
Generic error codes are described at the
51
:ref:`Generic Error Codes <gen-errors>` chapter.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.
Deprecated uncorrected block 조회
1-32`FE_READ_UNCORRECTED_BLOCKS`는 deprecated 상태인 ioctl입니다. 호출 형식은 `int ioctl(int fd, FE_READ_UNCORRECTED_BLOCKS, uint32_t *ublocks)`입니다.
인수의미
fdopen()이 반환한 파일 descriptor
ublocks현재까지 driver가 본 uncorrected block 총수를 저장할 uint32_t 포인터
Driver가 관측한 누적 block 수를 받을 포인터입니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.fe
.. _FE_READ_UNCORRECTED_BLOCKS:
**************************
FE_READ_UNCORRECTED_BLOCKS
**************************
Name
====
FE_READ_UNCORRECTED_BLOCKS
.. attention:: This ioctl is deprecated.
Synopsis
========
.. c:macro:: FE_READ_UNCORRECTED_BLOCKS
``int ioctl(int fd, FE_READ_UNCORRECTED_BLOCKS, uint32_t *ublocks)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
``ublocks``
The total number of uncorrected blocks seen by the driver so far.
누적 counter와 구간 증가량
33-51Device driver의 전체 수명 동안 감지한 uncorrected block 수를 반환합니다. 의미 있는 측정을 하려면 특정 시간 구간의 block count 증가량을 계산해야 합니다.
장치에 대한 read-only 접근만으로 충분합니다. 성공하면 0을 반환합니다. 오류가 발생하면 -1을 반환하고 `errno`를 설정합니다.
일반 오류 code는 `Generic Error Codes <gen-errors>` 절에 설명되어 있습니다.
시작 시점의 ublocks 누적값 읽기→측정할 시간 간격 대기→종료 시점의 ublocks 누적값 읽기→두 값의 차이로 구간 uncorrected block 수 계산→Counter reset으로 해석하지 않도록 주의
누적 counter 두 값을 사용해 구간 증가량을 구합니다.
Description
===========
This ioctl call returns the number of uncorrected blocks detected by the
device driver during its lifetime. For meaningful measurements, the
increment in block count during a specific time interval should be
calculated. 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-uncorrected-blocks.rst:1-51Driver 수명 동안 누적된 counter이므로 품질 측정에는 일정 시간 간격의 증가량을 사용해야 합니다.