요약·해설과 원문, 전문 번역을 서로 분리했습니다. 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.ca
4
.. _CA_GET_MSG:
6
==========
7
CA_GET_MSG
8
==========
10
Name
11
----
13
CA_GET_MSG
15
Synopsis
16
--------
18
.. c:macro:: CA_GET_MSG
20
``int ioctl(fd, CA_GET_MSG, struct ca_msg *msg)``
22
Arguments
23
---------
25
``fd``
26
File descriptor returned by a previous call to :c:func:`open()`.
28
``msg``
29
Pointer to struct :c:type:`ca_msg`.
31
Description
32
-----------
34
Receives a message via a CI CA module.
36
.. note::
38
Please notice that, on most drivers, this is done by reading from
39
the /dev/adapter?/ca? device node.
41
Return Value
42
------------
44
On success 0 is returned.
46
On error -1 is returned, and the ``errno`` variable is set
47
appropriately.
49
Generic error codes are described at the
50
:ref:`Generic Error Codes <gen-errors>` chapter.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
이름과 호출 원형
1-20이 문서는 GFDL-1.1-no-invariants-or-later 라이선스와 `DTV.ca` C namespace를 사용하며 `CA_GET_MSG` IOCTL을 설명합니다.
호출 원형은 `int ioctl(fd, CA_GET_MSG, struct ca_msg *msg)`입니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.ca
.. _CA_GET_MSG:
==========
CA_GET_MSG
==========
Name
----
CA_GET_MSG
Synopsis
--------
.. c:macro:: CA_GET_MSG
``int ioctl(fd, CA_GET_MSG, struct ca_msg *msg)``인자와 메시지 수신
21-40`fd`는 앞선 `open()` 호출이 반환한 file descriptor이고, `msg`는 `struct ca_msg`를 가리키는 포인터입니다.
이 IOCTL은 CI CA 모듈을 통해 메시지를 수신합니다.
주의: 대부분의 드라이버에서는 `/dev/adapter?/ca?` 장치 노드를 읽어서 이 작업을 수행합니다.
CI CA module에 메시지 도착→대부분의 드라이버에서 /dev/adapter?/ca? read→또는 CA_GET_MSG 호출→struct ca_msg에 메시지 수신
IOCTL 또는 일반적인 장치 노드 read 경로를 통해 메시지를 받습니다.
Arguments
---------
``fd``
File descriptor returned by a previous call to :c:func:`open()`.
``msg``
Pointer to struct :c:type:`ca_msg`.
Description
-----------
Receives a message via a CI CA module.
.. note::
Please notice that, on most drivers, this is done by reading from
the /dev/adapter?/ca? device node.
반환값
41-50성공하면 0을 반환합니다. 오류이면 -1을 반환하고 `errno`를 알맞게 설정합니다.
일반 오류 코드는 `Generic Error Codes <gen-errors>` 장에서 설명합니다.
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.
요약·해설
ca-get-msg.rst:1-50CA_GET_MSG는 CI CA 메시지를 받으며 대부분의 드라이버에서는 장치 노드를 read하는 경로를 사용합니다.