요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
.. c:namespace:: RC
.. _lirc_set_rec_timeout:
.. _lirc_get_rec_timeout:
***************************************************
ioctl LIRC_GET_REC_TIMEOUT and LIRC_SET_REC_TIMEOUT
***************************************************
Name
====
LIRC_GET_REC_TIMEOUT/LIRC_SET_REC_TIMEOUT - Get/set the integer value for IR inactivity timeout.
Synopsis
========
.. c:macro:: LIRC_GET_REC_TIMEOUT
``int ioctl(int fd, LIRC_GET_REC_TIMEOUT, __u32 *timeout)``
.. c:macro:: LIRC_SET_REC_TIMEOUT
``int ioctl(int fd, LIRC_SET_REC_TIMEOUT, __u32 *timeout)``
Arguments
=========
``fd``
File descriptor returned by open().
``timeout``
Timeout, in microseconds.
Description
===========
Get and set the integer value for IR inactivity timeout.
If supported by the hardware, setting it to 0 disables all hardware timeouts
and data should be reported as soon as possible. If the exact value
cannot be set, then the next possible value _greater_ than the
given value should be set.
.. note::
The range of supported timeout is given by :ref:`LIRC_GET_MIN_TIMEOUT`.
Return Value
============
On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
이름, 선언과 인자
1-35`LIRC_GET_REC_TIMEOUT`은 현재 IR inactivity timeout을 읽고 `LIRC_SET_REC_TIMEOUT`은 값을 설정합니다. 단위는 microsecond입니다.
int ioctl(int fd, LIRC_GET_REC_TIMEOUT, __u32 *timeout);
int ioctl(int fd, LIRC_SET_REC_TIMEOUT, __u32 *timeout);조회와 설정 모두 같은 u32 pointer를 사용합니다.
.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
.. c:namespace:: RC
.. _lirc_set_rec_timeout:
.. _lirc_get_rec_timeout:
***************************************************
ioctl LIRC_GET_REC_TIMEOUT and LIRC_SET_REC_TIMEOUT
***************************************************
Name
====
LIRC_GET_REC_TIMEOUT/LIRC_SET_REC_TIMEOUT - Get/set the integer value for IR inactivity timeout.
Synopsis
========
.. c:macro:: LIRC_GET_REC_TIMEOUT
``int ioctl(int fd, LIRC_GET_REC_TIMEOUT, __u32 *timeout)``
.. c:macro:: LIRC_SET_REC_TIMEOUT
``int ioctl(int fd, LIRC_SET_REC_TIMEOUT, __u32 *timeout)``
Arguments
=========
``fd``
File descriptor returned by open().
``timeout``
Timeout, in microseconds.
0의 의미와 값 반올림
36-49Hardware가 지원하면 timeout을 0으로 설정해 모든 hardware timeout을 끄고 data를 가능한 한 빨리 보고하게 할 수 있습니다.
요청한 값을 정확히 설정할 수 없으면 driver는 요청값보다 큰 값 중 다음으로 가능한 값을 선택해야 합니다. 더 작은 값으로 내리면 application이 기대한 inactivity 기간보다 일찍 frame을 끝낼 수 있기 때문입니다.
지원 범위는 `LIRC_GET_MIN_TIMEOUT`과 `LIRC_GET_MAX_TIMEOUT`으로 확인합니다. 고정 timeout 장치에서는 설정이 불가능할 수 있습니다.
지원 범위를 확인하고 driver가 선택한 실제 값을 다시 읽습니다.
Description
===========
Get and set the integer value for IR inactivity timeout.
If supported by the hardware, setting it to 0 disables all hardware timeouts
and data should be reported as soon as possible. If the exact value
cannot be set, then the next possible value _greater_ than the
given value should be set.
.. note::
The range of supported timeout is given by :ref:`LIRC_GET_MIN_TIMEOUT`.
반환값
50-55성공하면 0, 오류이면 -1을 반환하고 `errno`를 설정합니다. 공통 오류는 Generic Error Codes 절에 정의됩니다.
Return Value
============
On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter.
요약·해설
lirc-set-rec-timeout.rst:1-55지원 시 0은 hardware timeout 비활성화입니다. 정확한 값이 불가능하면 driver는 요청값보다 큰 다음 지원 값을 선택해야 합니다.