요약·해설과 원문, 전문 번역을 서로 분리했습니다. 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_DISEQC_RECV_SLAVE_REPLY:
6
********************************
7
ioctl FE_DISEQC_RECV_SLAVE_REPLY
8
********************************
10
Name
11
====
13
FE_DISEQC_RECV_SLAVE_REPLY - Receives reply from a DiSEqC 2.0 command
15
Synopsis
16
========
18
.. c:macro:: FE_DISEQC_RECV_SLAVE_REPLY
20
``int ioctl(int fd, FE_DISEQC_RECV_SLAVE_REPLY, struct dvb_diseqc_slave_reply *argp)``
22
Arguments
23
=========
25
``fd``
26
File descriptor returned by :c:func:`open()`.
28
``argp``
29
pointer to struct :c:type:`dvb_diseqc_slave_reply`.
31
Description
32
===========
34
Receives reply from a DiSEqC 2.0 command.
36
The received message is stored at the buffer pointed by ``argp``.
38
Return Value
39
============
41
On success 0 is returned.
43
On error -1 is returned, and the ``errno`` variable is set
44
appropriately.
46
Generic error codes are described at the
47
:ref:`Generic Error Codes <gen-errors>` chapter.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
이름, 선언과 인수
1-30`FE_DISEQC_RECV_SLAVE_REPLY`는 DiSEqC 2.0 command에 대한 응답을 수신하는 ioctl입니다.
호출 형식은 `int ioctl(int fd, FE_DISEQC_RECV_SLAVE_REPLY, struct dvb_diseqc_slave_reply *argp)`입니다.
인수의미
fdopen()이 반환한 파일 descriptor
argpstruct dvb_diseqc_slave_reply를 가리키는 포인터
파일 descriptor와 응답 buffer 포인터입니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.fe
.. _FE_DISEQC_RECV_SLAVE_REPLY:
********************************
ioctl FE_DISEQC_RECV_SLAVE_REPLY
********************************
Name
====
FE_DISEQC_RECV_SLAVE_REPLY - Receives reply from a DiSEqC 2.0 command
Synopsis
========
.. c:macro:: FE_DISEQC_RECV_SLAVE_REPLY
``int ioctl(int fd, FE_DISEQC_RECV_SLAVE_REPLY, struct dvb_diseqc_slave_reply *argp)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
``argp``
pointer to struct :c:type:`dvb_diseqc_slave_reply`.
응답 저장과 반환값
31-47ioctl은 DiSEqC 2.0 command의 응답을 받고, 수신한 message를 `argp`가 가리키는 buffer에 저장합니다.
성공하면 0을 반환합니다. 오류가 발생하면 -1을 반환하고 `errno`를 적절히 설정합니다. 일반 오류 code는 `Generic Error Codes <gen-errors>` 절에 설명되어 있습니다.
read/write 가능한 frontend fd 준비→dvb_diseqc_slave_reply buffer 주소를 argp로 전달→FE_DISEQC_RECV_SLAVE_REPLY 호출→성공 시 argp buffer에서 응답 읽기→실패 시 -1과 errno 확인
호출에서 결과 확인까지의 데이터 흐름입니다.
Description
===========
Receives reply from a DiSEqC 2.0 command.
The received message is stored at the buffer pointed by ``argp``.
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-recv-slave-reply.rst:1-47DiSEqC 2.0 응답 수신용 ioctl입니다. `argp` buffer의 수명과 0/-1 반환 규약을 함께 확인해야 합니다.