1 .. SPDX-License-Identifier: GFDL-1.1-no-invari 1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2 .. c:namespace:: DTV.ca 2 .. c:namespace:: DTV.ca
3 3
4 .. _CA_GET_MSG: 4 .. _CA_GET_MSG:
5 5
6 ========== 6 ==========
7 CA_GET_MSG 7 CA_GET_MSG
8 ========== 8 ==========
9 9
10 Name 10 Name
11 ---- 11 ----
12 12
13 CA_GET_MSG 13 CA_GET_MSG
14 14
15 Synopsis 15 Synopsis
16 -------- 16 --------
17 17
18 .. c:macro:: CA_GET_MSG 18 .. c:macro:: CA_GET_MSG
19 19
20 ``int ioctl(fd, CA_GET_MSG, struct ca_msg *msg 20 ``int ioctl(fd, CA_GET_MSG, struct ca_msg *msg)``
21 21
22 Arguments 22 Arguments
23 --------- 23 ---------
24 24
25 ``fd`` 25 ``fd``
26 File descriptor returned by a previous call 26 File descriptor returned by a previous call to :c:func:`open()`.
27 27
28 ``msg`` 28 ``msg``
29 Pointer to struct :c:type:`ca_msg`. 29 Pointer to struct :c:type:`ca_msg`.
30 30
31 Description 31 Description
32 ----------- 32 -----------
33 33
34 Receives a message via a CI CA module. 34 Receives a message via a CI CA module.
35 35
36 .. note:: 36 .. note::
37 37
38 Please notice that, on most drivers, this i 38 Please notice that, on most drivers, this is done by reading from
39 the /dev/adapter?/ca? device node. 39 the /dev/adapter?/ca? device node.
40 40
41 Return Value 41 Return Value
42 ------------ 42 ------------
43 43
44 On success 0 is returned. 44 On success 0 is returned.
45 45
46 On error -1 is returned, and the ``errno`` var 46 On error -1 is returned, and the ``errno`` variable is set
47 appropriately. 47 appropriately.
48 48
49 Generic error codes are described at the 49 Generic error codes are described at the
50 :ref:`Generic Error Codes <gen-errors>` chapte 50 :ref:`Generic Error Codes <gen-errors>` chapter.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.