1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
3.. _CA_SET_DESCR:
4
5============
6CA_SET_DESCR
7============
8
9Name
10----
11
12CA_SET_DESCR
13
14
15Synopsis
16--------
17
18.. c:function:: int ioctl(fd, CA_SET_DESCR, struct ca_descr *desc)
19    :name: CA_SET_DESCR
20
21
22Arguments
23---------
24
25``fd``
26  File descriptor returned by a previous call to :c:func:`open() <cec-open>`.
27
28``msg``
29  Pointer to struct :c:type:`ca_descr`.
30
31Description
32-----------
33
34CA_SET_DESCR is used for feeding descrambler CA slots with descrambling
35keys (referred as control words).
36
37Return Value
38------------
39
40On success 0 is returned.
41
42On error -1 is returned, and the ``errno`` variable is set
43appropriately.
44
45Generic error codes are described at the
46:ref:`Generic Error Codes <gen-errors>` chapter.
47