media: ca docs: document CA_SET_DESCR ioctl and structs
authorMauro Carvalho Chehab <mchehab@s-opensource.com>
Mon, 4 Sep 2017 00:50:17 +0000 (20:50 -0400)
committerMauro Carvalho Chehab <mchehab@s-opensource.com>
Tue, 5 Sep 2017 10:23:07 +0000 (06:23 -0400)
The av7110 driver uses CA_SET_DESCR to store the descrambler
control words at the CA descrambler slots.

Document it.

Thanks-to: Honza Petrouš <jpetrous@gmail.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Documentation/media/uapi/dvb/ca-set-descr.rst
include/uapi/linux/dvb/ca.h

index 9c484317d55c170e1cdd29cb46cecd7f1c53c02b..a6c47205ffd859514c881a2b38ec69b3cec0d42b 100644 (file)
@@ -28,22 +28,11 @@ Arguments
 ``msg``
   Pointer to struct :c:type:`ca_descr`.
 
-.. c:type:: ca_descr
-
-.. code-block:: c
-
-    struct ca_descr {
-       unsigned int index;
-       unsigned int parity;
-       unsigned char cw[8];
-    };
-
-
 Description
 -----------
 
-.. note:: This ioctl is undocumented. Documentation is welcome.
-
+CA_SET_DESCR is used for feeding descrambler CA slots with descrambling
+keys (refered as control words).
 
 Return Value
 ------------
index 7ee641b4124cd17b445834b872a2a2437bc156fe..c36fdb8e27339950212c11b941919bb19badbf61 100644 (file)
@@ -109,9 +109,16 @@ struct ca_msg {
        unsigned char msg[256];
 };
 
+/**
+ * struct ca_descr - CA descrambler control words info
+ *
+ * @index: CA Descrambler slot
+ * @parity: control words parity, where 0 means even and 1 means odd
+ * @cw: CA Descrambler control words
+ */
 struct ca_descr {
        unsigned int index;
-       unsigned int parity;    /* 0 == even, 1 == odd */
+       unsigned int parity;
        unsigned char cw[8];
 };