<title>DVB CA Device</title> <para>The DVB CA device controls the conditional access hardware. It can be accessed through <emphasis role="tt">/dev/dvb/adapter0/ca0</emphasis>. Data types and and ioctl definitions can be accessed by including <emphasis role="tt">linux/dvb/ca.h</emphasis> in your application. </para> <section id="ca_data_types"> <title>CA Data Types</title> <section id="ca-slot-info"> <title>ca_slot_info_t</title> <programlisting> typedef struct ca_slot_info { int num; /⋆ slot number ⋆/ int type; /⋆ CA interface this slot supports ⋆/ #define CA_CI 1 /⋆ CI high level interface ⋆/ #define CA_CI_LINK 2 /⋆ CI link layer level interface ⋆/ #define CA_CI_PHYS 4 /⋆ CI physical layer level interface ⋆/ #define CA_DESCR 8 /⋆ built-in descrambler ⋆/ #define CA_SC 128 /⋆ simple smart card interface ⋆/ unsigned int flags; #define CA_CI_MODULE_PRESENT 1 /⋆ module (or card) inserted ⋆/ #define CA_CI_MODULE_READY 2 } ca_slot_info_t; </programlisting> </section> <section id="ca-descr-info"> <title>ca_descr_info_t</title> <programlisting> typedef struct ca_descr_info { unsigned int num; /⋆ number of available descramblers (keys) ⋆/ unsigned int type; /⋆ type of supported scrambling system ⋆/ #define CA_ECD 1 #define CA_NDS 2 #define CA_DSS 4 } ca_descr_info_t; </programlisting> </section> <section id="ca-caps"> <title>ca_caps_t</title> <programlisting> typedef struct ca_caps { unsigned int slot_num; /⋆ total number of CA card and module slots ⋆/ unsigned int slot_type; /⋆ OR of all supported types ⋆/ unsigned int descr_num; /⋆ total number of descrambler slots (keys) ⋆/ unsigned int descr_type;/⋆ OR of all supported types ⋆/ } ca_cap_t; </programlisting> </section> <section id="ca-msg"> <title>ca_msg_t</title> <programlisting> /⋆ a message to/from a CI-CAM ⋆/ typedef struct ca_msg { unsigned int index; unsigned int type; unsigned int length; unsigned char msg[256]; } ca_msg_t; </programlisting> </section> <section id="ca-descr"> <title>ca_descr_t</title> <programlisting> typedef struct ca_descr { unsigned int index; unsigned int parity; unsigned char cw[8]; } ca_descr_t; </programlisting> </section> <section id="ca-pid"> <title>ca-pid</title> <programlisting> typedef struct ca_pid { unsigned int pid; int index; /⋆ -1 == disable⋆/ } ca_pid_t; </programlisting> </section></section> <section id="ca_function_calls"> <title>CA Function Calls</title> <section id="ca_fopen"> <title>open()</title> <para>DESCRIPTION </para> <informaltable><tgroup cols="1"><tbody><row><entry align="char"> <para>This system call opens a named ca device (e.g. /dev/ost/ca) for subsequent use.</para> <para>When an open() call has succeeded, the device will be ready for use. The significance of blocking or non-blocking mode is described in the documentation for functions where there is a difference. It does not affect the semantics of the open() call itself. A device opened in blocking mode can later be put into non-blocking mode (and vice versa) using the F_SETFL command of the fcntl system call. This is a standard system call, documented in the Linux manual page for fcntl. Only one user can open the CA Device in O_RDWR mode. All other attempts to open the device in this mode will fail, and an error code will be returned.</para> </entry> </row></tbody></tgroup></informaltable> <para>SYNOPSIS </para> <informaltable><tgroup cols="1"><tbody><row><entry align="char"> <para>int open(const char ⋆deviceName, int flags);</para> </entry> </row></tbody></tgroup></informaltable> <para>PARAMETERS </para> <informaltable><tgroup cols="2"><tbody><row><entry align="char"> <para>const char *deviceName</para> </entry><entry align="char"> <para>Name of specific video device.</para> </entry> </row><row><entry align="char"> <para>int flags</para> </entry><entry align="char"> <para>A bit-wise OR of the following flags:</para> </entry> </row><row><entry align="char"> </entry><entry align="char"> <para>O_RDONLY read-only access</para> </entry> </row><row><entry align="char"> </entry><entry align="char"> <para>O_RDWR read/write access</para> </entry> </row><row><entry align="char"> </entry><entry align="char"> <para>O_NONBLOCK open in non-blocking mode</para> </entry> </row><row><entry align="char"> </entry><entry align="char"> <para>(blocking mode is the default)</para> </entry> </row></tbody></tgroup></informaltable> <para>RETURN VALUE</para> <informaltable><tgroup cols="2"><tbody><row><entry align="char"> <para>ENODEV</para> </entry><entry align="char"> <para>Device driver not loaded/available.</para> </entry> </row><row><entry align="char"> <para>EINTERNAL</para> </entry><entry align="char"> <para>Internal error.</para> </entry> </row><row><entry align="char"> <para>EBUSY</para> </entry><entry align="char"> <para>Device or resource busy.</para> </entry> </row><row><entry align="char"> <para>EINVAL</para> </entry><entry align="char"> <para>Invalid argument.</para> </entry> </row></tbody></tgroup></informaltable> </section> <section id="ca_fclose"> <title>close()</title> <para>DESCRIPTION </para> <informaltable><tgroup cols="1"><tbody><row><entry align="char"> <para>This system call closes a previously opened audio device.</para> </entry> </row></tbody></tgroup></informaltable> <para>SYNOPSIS </para> <informaltable><tgroup cols="1"><tbody><row><entry align="char"> <para>int close(int fd);</para> </entry> </row></tbody></tgroup></informaltable> <para>PARAMETERS </para> <informaltable><tgroup cols="2"><tbody><row><entry align="char"> <para>int fd</para> </entry><entry align="char"> <para>File descriptor returned by a previous call to open().</para> </entry> </row></tbody></tgroup></informaltable> <para>RETURN VALUE</para> <informaltable><tgroup cols="2"><tbody><row><entry align="char"> <para>EBADF</para> </entry><entry align="char"> <para>fd is not a valid open file descriptor.</para> </entry> </row></tbody></tgroup></informaltable> </section> </section>