From 9034551a3bbc76b79a152806c781b1b8e8ea3a9a Mon Sep 17 00:00:00 2001
From: rjkm <devnull@localhost>
Date: Sun, 16 Sep 2001 22:27:03 -0300
Subject: new API docs

---
 dvb-spec/dvbapi/ca.tex | 127 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 127 insertions(+)
 create mode 100644 dvb-spec/dvbapi/ca.tex

(limited to 'dvb-spec/dvbapi/ca.tex')

diff --git a/dvb-spec/dvbapi/ca.tex b/dvb-spec/dvbapi/ca.tex
new file mode 100644
index 000000000..eba512b1b
--- /dev/null
+++ b/dvb-spec/dvbapi/ca.tex
@@ -0,0 +1,127 @@
+\devsec{DVB CA Device}
+
+The DVB CA device controls the conditional access hardware.
+It can be accessed through \texttt{/dev/ost/ca}.
+
+
+\devsubsec{CA Data Types}
+
+\devsubsubsec{ca\_slot\_info\_t}
+\label{caslotinfo}
+
+\begin{verbatim}
+/* slot interface types and info */
+
+typedef struct ca_slot_info_s {
+        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_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;
+\end{verbatim}
+
+\devsubsubsec{ca\_descr\_info\_t}
+\label{cadescrinfo}
+
+\begin{verbatim}
+typedef struct ca_descr_info_s {
+        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;
+\end{verbatim}
+
+\devsubsubsec{ca\_cap\_t}
+\label{cacap}
+
+\begin{verbatim}
+typedef struct ca_cap_s {
+        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;
+\end{verbatim}
+
+
+\devsubsubsec{ca\_msg\_t}
+\label{camsg}
+
+\begin{verbatim}
+/* a message to/from a CI-CAM */
+typedef struct ca_msg_s {   
+        unsigned int index;         
+        unsigned int type;
+        unsigned int length;
+        unsigned char msg[256];
+} ca_msg_t;
+\end{verbatim}
+
+
+\devsubsubsec{ca\_descr\_t}
+\label{cadescr}
+
+\begin{verbatim}
+typedef struct ca_descr_s {
+        unsigned int index;    
+        unsigned int parity;
+        unsigned char cw[8];
+} ca_descr_t;
+\end{verbatim}
+
+\clearpage
+
+\devsubsec{CA Function Calls}
+
+\function{open()}{
+  int open(const char *deviceName, int flags);}{
+  This system call opens a named ca device (e.g. /dev/ost/ca) 
+  for subsequent use.
+  
+  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.
+  }{
+  const char *deviceName & Name of specific video device.\\
+  int flags & A bit-wise OR of the following flags:\\
+            & \hspace{1em} O\_RDONLY read-only access\\
+            & \hspace{1em} O\_RDWR read/write access\\
+            & \hspace{1em} O\_NONBLOCK open in non-blocking mode \\
+            & \hspace{1em} (blocking mode is the default)\\
+  }{
+  ENODEV    & Device driver not loaded/available.\\
+  EINTERNAL & Internal error.\\
+  EBUSY     & Device or resource busy.\\
+  EINVAL    & Invalid argument.\\
+}
+
+\function{close()}{
+  int close(int fd);}{
+  This system call closes a previously opened audio device.
+  }{
+  int fd & File descriptor returned by a previous call to open().\\
+  }{
+  EBADF & fd is not a valid open file descriptor.\\
+}
+
+%%% Local Variables: 
+%%% mode: latex
+%%% TeX-master: "dvbapi"
+%%% End: 
-- 
cgit v1.2.3


From ab85b007da42f42856a775d8cff97332093f5b34 Mon Sep 17 00:00:00 2001
From: holger <devnull@localhost>
Date: Thu, 10 Oct 2002 15:59:05 -0300
Subject: make room for the new HEAD trunk

---
 dvb-spec/dvbapi/ca.tex | 127 -------------------------------------------------
 1 file changed, 127 deletions(-)
 delete mode 100644 dvb-spec/dvbapi/ca.tex

(limited to 'dvb-spec/dvbapi/ca.tex')

diff --git a/dvb-spec/dvbapi/ca.tex b/dvb-spec/dvbapi/ca.tex
deleted file mode 100644
index eba512b1b..000000000
--- a/dvb-spec/dvbapi/ca.tex
+++ /dev/null
@@ -1,127 +0,0 @@
-\devsec{DVB CA Device}
-
-The DVB CA device controls the conditional access hardware.
-It can be accessed through \texttt{/dev/ost/ca}.
-
-
-\devsubsec{CA Data Types}
-
-\devsubsubsec{ca\_slot\_info\_t}
-\label{caslotinfo}
-
-\begin{verbatim}
-/* slot interface types and info */
-
-typedef struct ca_slot_info_s {
-        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_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;
-\end{verbatim}
-
-\devsubsubsec{ca\_descr\_info\_t}
-\label{cadescrinfo}
-
-\begin{verbatim}
-typedef struct ca_descr_info_s {
-        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;
-\end{verbatim}
-
-\devsubsubsec{ca\_cap\_t}
-\label{cacap}
-
-\begin{verbatim}
-typedef struct ca_cap_s {
-        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;
-\end{verbatim}
-
-
-\devsubsubsec{ca\_msg\_t}
-\label{camsg}
-
-\begin{verbatim}
-/* a message to/from a CI-CAM */
-typedef struct ca_msg_s {   
-        unsigned int index;         
-        unsigned int type;
-        unsigned int length;
-        unsigned char msg[256];
-} ca_msg_t;
-\end{verbatim}
-
-
-\devsubsubsec{ca\_descr\_t}
-\label{cadescr}
-
-\begin{verbatim}
-typedef struct ca_descr_s {
-        unsigned int index;    
-        unsigned int parity;
-        unsigned char cw[8];
-} ca_descr_t;
-\end{verbatim}
-
-\clearpage
-
-\devsubsec{CA Function Calls}
-
-\function{open()}{
-  int open(const char *deviceName, int flags);}{
-  This system call opens a named ca device (e.g. /dev/ost/ca) 
-  for subsequent use.
-  
-  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.
-  }{
-  const char *deviceName & Name of specific video device.\\
-  int flags & A bit-wise OR of the following flags:\\
-            & \hspace{1em} O\_RDONLY read-only access\\
-            & \hspace{1em} O\_RDWR read/write access\\
-            & \hspace{1em} O\_NONBLOCK open in non-blocking mode \\
-            & \hspace{1em} (blocking mode is the default)\\
-  }{
-  ENODEV    & Device driver not loaded/available.\\
-  EINTERNAL & Internal error.\\
-  EBUSY     & Device or resource busy.\\
-  EINVAL    & Invalid argument.\\
-}
-
-\function{close()}{
-  int close(int fd);}{
-  This system call closes a previously opened audio device.
-  }{
-  int fd & File descriptor returned by a previous call to open().\\
-  }{
-  EBADF & fd is not a valid open file descriptor.\\
-}
-
-%%% Local Variables: 
-%%% mode: latex
-%%% TeX-master: "dvbapi"
-%%% End: 
-- 
cgit v1.2.3


From 5a523e605b9b6d1ae50d0707c1874c5b7f0959cc Mon Sep 17 00:00:00 2001
From: holger <devnull@localhost>
Date: Thu, 10 Oct 2002 16:22:27 -0300
Subject: the new HEAD

---
 dvb-spec/dvbapi/ca.tex | 127 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 127 insertions(+)
 create mode 100644 dvb-spec/dvbapi/ca.tex

(limited to 'dvb-spec/dvbapi/ca.tex')

diff --git a/dvb-spec/dvbapi/ca.tex b/dvb-spec/dvbapi/ca.tex
new file mode 100644
index 000000000..eba512b1b
--- /dev/null
+++ b/dvb-spec/dvbapi/ca.tex
@@ -0,0 +1,127 @@
+\devsec{DVB CA Device}
+
+The DVB CA device controls the conditional access hardware.
+It can be accessed through \texttt{/dev/ost/ca}.
+
+
+\devsubsec{CA Data Types}
+
+\devsubsubsec{ca\_slot\_info\_t}
+\label{caslotinfo}
+
+\begin{verbatim}
+/* slot interface types and info */
+
+typedef struct ca_slot_info_s {
+        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_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;
+\end{verbatim}
+
+\devsubsubsec{ca\_descr\_info\_t}
+\label{cadescrinfo}
+
+\begin{verbatim}
+typedef struct ca_descr_info_s {
+        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;
+\end{verbatim}
+
+\devsubsubsec{ca\_cap\_t}
+\label{cacap}
+
+\begin{verbatim}
+typedef struct ca_cap_s {
+        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;
+\end{verbatim}
+
+
+\devsubsubsec{ca\_msg\_t}
+\label{camsg}
+
+\begin{verbatim}
+/* a message to/from a CI-CAM */
+typedef struct ca_msg_s {   
+        unsigned int index;         
+        unsigned int type;
+        unsigned int length;
+        unsigned char msg[256];
+} ca_msg_t;
+\end{verbatim}
+
+
+\devsubsubsec{ca\_descr\_t}
+\label{cadescr}
+
+\begin{verbatim}
+typedef struct ca_descr_s {
+        unsigned int index;    
+        unsigned int parity;
+        unsigned char cw[8];
+} ca_descr_t;
+\end{verbatim}
+
+\clearpage
+
+\devsubsec{CA Function Calls}
+
+\function{open()}{
+  int open(const char *deviceName, int flags);}{
+  This system call opens a named ca device (e.g. /dev/ost/ca) 
+  for subsequent use.
+  
+  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.
+  }{
+  const char *deviceName & Name of specific video device.\\
+  int flags & A bit-wise OR of the following flags:\\
+            & \hspace{1em} O\_RDONLY read-only access\\
+            & \hspace{1em} O\_RDWR read/write access\\
+            & \hspace{1em} O\_NONBLOCK open in non-blocking mode \\
+            & \hspace{1em} (blocking mode is the default)\\
+  }{
+  ENODEV    & Device driver not loaded/available.\\
+  EINTERNAL & Internal error.\\
+  EBUSY     & Device or resource busy.\\
+  EINVAL    & Invalid argument.\\
+}
+
+\function{close()}{
+  int close(int fd);}{
+  This system call closes a previously opened audio device.
+  }{
+  int fd & File descriptor returned by a previous call to open().\\
+  }{
+  EBADF & fd is not a valid open file descriptor.\\
+}
+
+%%% Local Variables: 
+%%% mode: latex
+%%% TeX-master: "dvbapi"
+%%% End: 
-- 
cgit v1.2.3


From 622f6e3335a0dd1a97cdaee9913c1f105f3e36fa Mon Sep 17 00:00:00 2001
From: js <devnull@localhost>
Date: Mon, 10 Feb 2003 10:18:16 -0200
Subject: - merged GNU FDL lincense from NEWSTRUCT branch - updated from
 DVB_API_VERSION 3 - various minor fixes/additions - bumped version number to
 1.0.0-pre1 to match wth upcoming   linuxtv-dvb driver release

---
 dvb-spec/dvbapi/ca.tex | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

(limited to 'dvb-spec/dvbapi/ca.tex')

diff --git a/dvb-spec/dvbapi/ca.tex b/dvb-spec/dvbapi/ca.tex
index eba512b1b..fe76da454 100644
--- a/dvb-spec/dvbapi/ca.tex
+++ b/dvb-spec/dvbapi/ca.tex
@@ -1,7 +1,9 @@
 \devsec{DVB CA Device}
 
 The DVB CA device controls the conditional access hardware.
-It can be accessed through \texttt{/dev/ost/ca}.
+It can be accessed through \texttt{/dev/dvb/adapter0/ca0}.
+Data types and and ioctl definitions can be accessed by including
+\texttt{linux/dvb/ca.h} in your application.
 
 
 \devsubsec{CA Data Types}
-- 
cgit v1.2.3

