18c2ecf20Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
28c2ecf20Sopenharmony_ci.. c:namespace:: DTV.ca
38c2ecf20Sopenharmony_ci
48c2ecf20Sopenharmony_ci.. _CA_SEND_MSG:
58c2ecf20Sopenharmony_ci
68c2ecf20Sopenharmony_ci===========
78c2ecf20Sopenharmony_ciCA_SEND_MSG
88c2ecf20Sopenharmony_ci===========
98c2ecf20Sopenharmony_ci
108c2ecf20Sopenharmony_ciName
118c2ecf20Sopenharmony_ci----
128c2ecf20Sopenharmony_ci
138c2ecf20Sopenharmony_ciCA_SEND_MSG
148c2ecf20Sopenharmony_ci
158c2ecf20Sopenharmony_ciSynopsis
168c2ecf20Sopenharmony_ci--------
178c2ecf20Sopenharmony_ci
188c2ecf20Sopenharmony_ci.. c:macro:: CA_SEND_MSG
198c2ecf20Sopenharmony_ci
208c2ecf20Sopenharmony_ci``int ioctl(fd, CA_SEND_MSG, struct ca_msg *msg)``
218c2ecf20Sopenharmony_ci
228c2ecf20Sopenharmony_ciArguments
238c2ecf20Sopenharmony_ci---------
248c2ecf20Sopenharmony_ci
258c2ecf20Sopenharmony_ci``fd``
268c2ecf20Sopenharmony_ci  File descriptor returned by a previous call to :c:func:`open()`.
278c2ecf20Sopenharmony_ci
288c2ecf20Sopenharmony_ci``msg``
298c2ecf20Sopenharmony_ci  Pointer to struct :c:type:`ca_msg`.
308c2ecf20Sopenharmony_ci
318c2ecf20Sopenharmony_ciDescription
328c2ecf20Sopenharmony_ci-----------
338c2ecf20Sopenharmony_ci
348c2ecf20Sopenharmony_ciSends a message via a CI CA module.
358c2ecf20Sopenharmony_ci
368c2ecf20Sopenharmony_ci.. note::
378c2ecf20Sopenharmony_ci
388c2ecf20Sopenharmony_ci   Please notice that, on most drivers, this is done by writing
398c2ecf20Sopenharmony_ci   to the /dev/adapter?/ca? device node.
408c2ecf20Sopenharmony_ci
418c2ecf20Sopenharmony_ciReturn Value
428c2ecf20Sopenharmony_ci------------
438c2ecf20Sopenharmony_ci
448c2ecf20Sopenharmony_ciOn success 0 is returned.
458c2ecf20Sopenharmony_ci
468c2ecf20Sopenharmony_ciOn error -1 is returned, and the ``errno`` variable is set
478c2ecf20Sopenharmony_ciappropriately.
488c2ecf20Sopenharmony_ci
498c2ecf20Sopenharmony_ciGeneric error codes are described at the
508c2ecf20Sopenharmony_ci:ref:`Generic Error Codes <gen-errors>` chapter.
51