요약·해설과 원문, 전문 번역을 서로 분리했습니다. 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_DISEQC_RESET_OVERLOAD:
******************************
ioctl FE_DISEQC_RESET_OVERLOAD
******************************
Name
====
FE_DISEQC_RESET_OVERLOAD - Restores the power to the antenna subsystem, if it was powered off due - to power overload.
Synopsis
========
.. c:macro:: FE_DISEQC_RESET_OVERLOAD
``int ioctl(int fd, FE_DISEQC_RESET_OVERLOAD, NULL)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
Description
===========
If the bus has been automatically powered off due to power overload,
this ioctl call restores the power to the bus. The call requires
read/write access to the device. This call has no effect if the device
is manually powered off. Not all Digital TV adapters support this ioctl.
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은 원문 표기를 유지합니다.
과부하 복구 ioctl 선언
1-27`FE_DISEQC_RESET_OVERLOAD`는 전력 과부하 때문에 antenna subsystem의 전원이 꺼졌을 때 전원을 복구하는 ioctl입니다.
호출 형식은 `int ioctl(int fd, FE_DISEQC_RESET_OVERLOAD, NULL)`이며 `fd`는 `open()`이 반환한 파일 descriptor입니다.
세 번째 인수로 별도 데이터 구조체를 전달하지 않고 `NULL`을 사용합니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.fe
.. _FE_DISEQC_RESET_OVERLOAD:
******************************
ioctl FE_DISEQC_RESET_OVERLOAD
******************************
Name
====
FE_DISEQC_RESET_OVERLOAD - Restores the power to the antenna subsystem, if it was powered off due - to power overload.
Synopsis
========
.. c:macro:: FE_DISEQC_RESET_OVERLOAD
``int ioctl(int fd, FE_DISEQC_RESET_OVERLOAD, NULL)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
자동 차단된 bus 전원 복구
28-45전력 과부하로 bus 전원이 자동 차단된 경우 이 호출이 bus 전원을 복구합니다. 장치에 대한 read/write 접근 권한이 필요합니다.
장치 전원을 수동으로 끈 경우에는 효과가 없습니다. 모든 Digital TV adapter가 이 ioctl을 지원하는 것은 아닙니다.
성공 시 0, 오류 시 -1을 반환하고 `errno`를 설정합니다. 일반 오류 code는 `Generic Error Codes <gen-errors>` 절을 따릅니다.
자동 과부하 차단인지 확인한 뒤 지원 장치에서만 복구합니다.
Description
===========
If the bus has been automatically powered off due to power overload,
this ioctl call restores the power to the bus. The call requires
read/write access to the device. This call has no effect if the device
is manually powered off. Not all Digital TV adapters support this ioctl.
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-diseqc-reset-overload.rst:1-45자동 과부하 차단만 복구하며 수동 전원 차단에는 효과가 없습니다. adapter 지원 여부와 read/write 권한을 먼저 확인해야 합니다.