xref: /linux/Documentation/userspace-api/media/dvb/ca-get-slot-info.rst (revision ae22a94997b8a03dcb3c922857c203246711f9d4)
1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2.. c:namespace:: DTV.ca
3
4.. _CA_GET_SLOT_INFO:
5
6================
7CA_GET_SLOT_INFO
8================
9
10Name
11----
12
13CA_GET_SLOT_INFO
14
15Synopsis
16--------
17
18.. c:macro:: CA_GET_SLOT_INFO
19
20``int ioctl(fd, CA_GET_SLOT_INFO, struct ca_slot_info *info)``
21
22Arguments
23---------
24
25``fd``
26  File descriptor returned by a previous call to :c:func:`open()`.
27
28``info``
29  Pointer to struct :c:type:`ca_slot_info`.
30
31Description
32-----------
33
34Returns information about a CA slot identified by
35:c:type:`ca_slot_info`.slot_num.
36
37Return Value
38------------
39
40On success 0 is returned, and :c:type:`ca_slot_info` is filled.
41
42On error -1 is returned, and the ``errno`` variable is set
43appropriately.
44
45.. tabularcolumns:: |p{2.5cm}|p{15.0cm}|
46
47.. flat-table::
48    :header-rows:  0
49    :stub-columns: 0
50    :widths: 1 16
51
52    -  -  ``ENODEV``
53       -  the slot is not available.
54
55The generic error codes are described at the
56:ref:`Generic Error Codes <gen-errors>` chapter.
57