18c2ecf20Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 28c2ecf20Sopenharmony_ci.. c:namespace:: DTV.ca 38c2ecf20Sopenharmony_ci 48c2ecf20Sopenharmony_ci.. _CA_GET_MSG: 58c2ecf20Sopenharmony_ci 68c2ecf20Sopenharmony_ci========== 78c2ecf20Sopenharmony_ciCA_GET_MSG 88c2ecf20Sopenharmony_ci========== 98c2ecf20Sopenharmony_ci 108c2ecf20Sopenharmony_ciName 118c2ecf20Sopenharmony_ci---- 128c2ecf20Sopenharmony_ci 138c2ecf20Sopenharmony_ciCA_GET_MSG 148c2ecf20Sopenharmony_ci 158c2ecf20Sopenharmony_ciSynopsis 168c2ecf20Sopenharmony_ci-------- 178c2ecf20Sopenharmony_ci 188c2ecf20Sopenharmony_ci.. c:macro:: CA_GET_MSG 198c2ecf20Sopenharmony_ci 208c2ecf20Sopenharmony_ci``int ioctl(fd, CA_GET_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_ciReceives 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 reading from 398c2ecf20Sopenharmony_ci 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