mirror of
https://github.com/torvalds/linux.git
synced 2024-12-13 14:43:03 +00:00
7e6854a9bf
Usually, CA messages are sent/received via reading/writing at the CA device node. However, two drivers (dst_ca and firedtv-ci) also implement it via ioctls. Apparently, on both cases, the net result is the same. Anyway, let's document it. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
53 lines
779 B
ReStructuredText
53 lines
779 B
ReStructuredText
.. -*- coding: utf-8; mode: rst -*-
|
|
|
|
.. _CA_GET_MSG:
|
|
|
|
==========
|
|
CA_GET_MSG
|
|
==========
|
|
|
|
Name
|
|
----
|
|
|
|
CA_GET_MSG
|
|
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
.. c:function:: int ioctl(fd, CA_GET_MSG, struct ca_msg *msg)
|
|
:name: CA_GET_MSG
|
|
|
|
|
|
Arguments
|
|
---------
|
|
|
|
``fd``
|
|
File descriptor returned by a previous call to :c:func:`open() <dvb-ca-open>`.
|
|
|
|
``msg``
|
|
Pointer to struct :c:type:`ca_msg`.
|
|
|
|
Description
|
|
-----------
|
|
|
|
Receives a message via a CI CA module.
|
|
|
|
.. note::
|
|
|
|
Please notice that, on most drivers, this is done by reading from
|
|
the /dev/adapter?/ca? device node.
|
|
|
|
|
|
Return Value
|
|
------------
|
|
|
|
|
|
On success 0 is returned.
|
|
|
|
On error -1 is returned, and the ``errno`` variable is set
|
|
appropriately.
|
|
|
|
Generic error codes are described at the
|
|
:ref:`Generic Error Codes <gen-errors>` chapter.
|