blob: 54e5dc78a2dc434116d87cc6ab8e2b540c8ec6bd [file] [log] [blame]
Mauro Carvalho Chehab47d23e32016-07-05 10:37:31 -03001.. -*- coding: utf-8; mode: rst -*-
2
3.. _CA_GET_SLOT_INFO:
4
Mauro Carvalho Chehab586027c2016-07-05 07:58:48 -03005================
Mauro Carvalho Chehab47d23e32016-07-05 10:37:31 -03006CA_GET_SLOT_INFO
7================
8
Mauro Carvalho Chehab15e7d612016-07-05 15:14:35 -03009Name
Mauro Carvalho Chehab586027c2016-07-05 07:58:48 -030010----
Mauro Carvalho Chehab47d23e32016-07-05 10:37:31 -030011
Mauro Carvalho Chehab586027c2016-07-05 07:58:48 -030012CA_GET_SLOT_INFO
Mauro Carvalho Chehab47d23e32016-07-05 10:37:31 -030013
Mauro Carvalho Chehab15e7d612016-07-05 15:14:35 -030014
15Synopsis
Mauro Carvalho Chehab47d23e32016-07-05 10:37:31 -030016--------
17
Mauro Carvalho Chehab189d7242016-08-31 15:59:14 -030018.. c:function:: int ioctl(fd, CA_GET_SLOT_INFO, struct ca_slot_info *info)
Mauro Carvalho Chehabcf8076c2016-08-19 16:56:15 -030019 :name: CA_GET_SLOT_INFO
Mauro Carvalho Chehab47d23e32016-07-05 10:37:31 -030020
Mauro Carvalho Chehab47d23e32016-07-05 10:37:31 -030021
Mauro Carvalho Chehab15e7d612016-07-05 15:14:35 -030022Arguments
Mauro Carvalho Chehab586027c2016-07-05 07:58:48 -030023---------
Mauro Carvalho Chehab47d23e32016-07-05 10:37:31 -030024
Mauro Carvalho Chehabcf8076c2016-08-19 16:56:15 -030025``fd``
26 File descriptor returned by a previous call to :c:func:`open() <cec-open>`.
Mauro Carvalho Chehab47d23e32016-07-05 10:37:31 -030027
Mauro Carvalho Chehabcf8076c2016-08-19 16:56:15 -030028``info``
Mauro Carvalho Chehab63eb58b2016-08-31 14:15:56 -030029 Pointer to struct c:type:`ca_slot_info`.
30
31.. _ca_slot_info_type:
32
33.. flat-table:: ca_slot_info types
34 :header-rows: 1
35 :stub-columns: 0
36
37 -
38 - type
39 - name
40 - description
41 -
42 - CA_CI
43 - 1
44 - CI high level interface
45
46 -
47 - CA_CI_LINK
48 - 2
49 - CI link layer level interface
50
51 -
52 - CA_CI_PHYS
53 - 4
54 - CI physical layer level interface
55
56 -
57 - CA_DESCR
58 - 8
59 - built-in descrambler
60
61 -
62 - CA_SC
63 - 128
64 - simple smart card interface
65
66.. _ca_slot_info_flag:
67
68.. flat-table:: ca_slot_info flags
69 :header-rows: 1
70 :stub-columns: 0
71
72 -
73 - type
74 - name
75 - description
76
77 -
78 - CA_CI_MODULE_PRESENT
79 - 1
80 - module (or card) inserted
81
82 -
83 - CA_CI_MODULE_READY
84 - 2
85 -
86
87.. c:type:: ca_slot_info
88
89.. flat-table:: struct ca_slot_info
90 :header-rows: 1
91 :stub-columns: 0
92
93 -
94 - type
95 - name
96 - description
97
98 -
99 - int
100 - num
101 - slot number
102
103 -
104 - int
105 - type
106 - CA interface this slot supports, as defined at :ref:`ca_slot_info_type`.
107
108 -
109 - unsigned int
110 - flags
111 - flags as defined at :ref:`ca_slot_info_flag`.
Mauro Carvalho Chehab47d23e32016-07-05 10:37:31 -0300112
113
Mauro Carvalho Chehab15e7d612016-07-05 15:14:35 -0300114Description
Mauro Carvalho Chehab586027c2016-07-05 07:58:48 -0300115-----------
116
Mauro Carvalho Chehabcf8076c2016-08-19 16:56:15 -0300117.. note:: This ioctl is undocumented. Documentation is welcome.
Mauro Carvalho Chehab586027c2016-07-05 07:58:48 -0300118
119
Mauro Carvalho Chehab15e7d612016-07-05 15:14:35 -0300120Return Value
Mauro Carvalho Chehab47d23e32016-07-05 10:37:31 -0300121------------
122
123On success 0 is returned, on error -1 and the ``errno`` variable is set
124appropriately. The generic error codes are described at the
125:ref:`Generic Error Codes <gen-errors>` chapter.