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