1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
3.. _CA_SEND_MSG:
4
5===========
6CA_SEND_MSG
7===========
8
9Name
10----
11
12CA_SEND_MSG
13
14
15Synopsis
16--------
17
18.. c:function:: int ioctl(fd, CA_SEND_MSG, struct ca_msg *msg)
19    :name: CA_SEND_MSG
20
21
22Arguments
23---------
24
25``fd``
26  File descriptor returned by a previous call to :c:func:`open() <cec-open>`.
27
28``msg``
29  Pointer to struct :c:type:`ca_msg`.
30
31
32Description
33-----------
34
35Sends a message via a CI CA module.
36
37.. note::
38
39   Please notice that, on most drivers, this is done by writing
40   to the /dev/adapter?/ca? device node.
41
42Return Value
43------------
44
45On success 0 is returned.
46
47On error -1 is returned, and the ``errno`` variable is set
48appropriately.
49
50Generic error codes are described at the
51:ref:`Generic Error Codes <gen-errors>` chapter.
52