- document DMX_GET_STC

- bump version to 1.0.0

2 files changed, 32 insertions, 2 deletions

diff --git a/dvb-spec/dvbapi/demux.tex b/dvb-spec/dvbapi/demux.tex
index dd032f58d..882463090 100644
--- a/dvb-spec/dvbapi/demux.tex
+++ b/dvb-spec/dvbapi/demux.tex
@@ -139,6 +139,17 @@ struct dmx_event
 };
 \end{verbatim}
 
+\devsubsubsec{struct dmx\_stc}
+\label{dmxstc}
+
+\begin{verbatim}
+struct dmx_stc {
+        unsigned int num;       /* input : which STC? 0..N */
+        unsigned int base;      /* output: divisor for stc to get 90 kHz clock */
+        uint64_t stc;           /* output: stc in 'base'*90 kHz units */
+};
+\end{verbatim}
+
 \clearpage
 
 \devsubsec{Demux Function Calls}
@@ -367,7 +378,7 @@ struct dmx_event
 \ifunction{DMX\_GET\_EVENT}{
   int ioctl( int fd, int request = DMX\_GET\_EVENT, struct dmx\_event *ev);
   }{
-  This  ioctl call returns an event if available. If an event is not 
+  This ioctl call returns an event if available. If an event is not 
   available, the behavior depends on whether the device is in blocking or 
   non-blocking mode.  In the latter case, the call fails immediately with
   errno set to EWOULDBLOCK. In the former case, the call blocks until an
@@ -387,6 +398,25 @@ struct dmx_event
   EWOULDBLOCK & There is no event pending, and the device is in non-blocking mode.\\
 }
 
+\ifunction{DMX\_GET\_STC}{
+  int ioctl( int fd, int request = DMX\_GET\_STC, struct dmx\_stc *stc);
+  }{
+  This ioctl call returns the current value of the system time counter
+  (which is driven by a PES filter of type DMX\_PES\_PCR). Some hardware
+  supports more than one STC, so you must specify which one by setting
+  the num field of stc before the ioctl (range 0...n). The result is returned in form
+  of a ratio with a 64 bit numerator and a 32 bit denominator, so the
+  real 90kHz STC value is \begin{ttfamily}stc->stc / stc->base\end{ttfamily}.
+  }{
+  int fd & File descriptor returned by a previous call to open().\\
+  int request & Equals DMX\_GET\_STC for this command.\\
+  struct dmx\_stc *stc & Pointer to the location where the stc is to be stored.\\
+  }{
+  EBADF  & fd is not a valid file descriptor.\\
+  EFAULT & stc points to an invalid address.\\
+  EINVAL & Invalid stc number.\\
+}
+
 %%% Local Variables: 
 %%% mode: latex
 %%% TeX-master: "dvbapi"
diff --git a/dvb-spec/dvbapi/title.tex b/dvb-spec/dvbapi/title.tex
index 29aca30d6..857492b7e 100644
--- a/dvb-spec/dvbapi/title.tex
+++ b/dvb-spec/dvbapi/title.tex
@@ -10,7 +10,7 @@
   and Dr. Marcus O.C. Metzler\\
   \texttt{<mocm@metzlerbros.de>}\\
 }
-\date{02/10/2003\\V 1.0.0-pre1}
+\date{24/07/2003\\V 1.0.0}
 
 \maketitle